IOT-GATE-IMX8PV2: Debian Linux: iotg-config Configuration Tool
Contents
Overview
This article provides instructions for iotg-config configuration tool. It is a command-line interactive tool for managing IOT-GATE-IMX8PV2 peripherals and industrial I/O interfaces.
Running the Utility
| IOT-GATE-IMX8PV2 configuration settings generated by iotg-config are stored in local configuration files and the U-Boot environment. A reboot is required for the changes to take effect. |
Run the iotg-config utility with root privileges:
compulab@iot-gate-imx8pv2:~$ sudo /opt/cl-iotg/shell/iotg-config
Use the Up and Down arrow keys to move through menu options, Enter to move in and Esc to move out.
Use Space to select/deselect configuration option.
Use Tab to jump between menu body and control buttons (e.g. Select, Back etc.)
Main Menu
Main menu provides access to main options:
┌───────────────────┤ IOT-GATE-IMX8PV2 Configuration Tool ├────────────────────┐ │ │ │ 1 Industrial I/O Stack Industrial I/O Stack options │ │ 2 Peripherals Peripheral devices options │ │ 3 Save Changes and Exit Apply changes and exit │ │ 4 Discard Changes and Exit Exit discarding changes │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ <Ok> <Cancel> │ │ │ └──────────────────────────────────────────────────────────────────────────────┘
Industrial I/O Stack Options
┌───────────────────────┤ Industrial I/O Stack Options ├───────────────────────┐ │ │ │ I1 Show Show Industrial I/O Stack Configuration │ │ I2 Configure Configure Industrial I/O Stack │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ <Select> <Back> │ │ │ └──────────────────────────────────────────────────────────────────────────────┘
Configure Industrial I/O Slots
┌───────────────────────┤ Industrial I/O Slots Options ├───────────────────────┐ │ │ │ C1 Slot A Configure Industrial I/O interface for slot A │ │ C2 Slot B Configure Industrial I/O interface for slot B │ │ C3 Slot C Configure Industrial I/O interface for slot C │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ <Select> <Back> │ │ │ └──────────────────────────────────────────────────────────────────────────────┘
For industrial slots A and B it is possible to choose one of following configuration option:
- CAN - configure as CAN FD interface
- RS485 - configure as RS-485 interface (half-duplex)
- IDLE - disable all interfaces (default)
┌──────────────────────────┤ Industrial I/O Slot A ├───────────────────────────┐ │ │ │ (*) CAN CAN FD interface │ │ ( ) RS485 RS-485 interface (half-duplex) │ │ ( ) IDLE No interface is enabled │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ <Ok> <Cancel> │ │ │ └──────────────────────────────────────────────────────────────────────────────┘
For industrial slot C the only configuration option is:
- DIO - configure Digital I/O interface 4x Digital Signals (inputs or outputs)
┌──────────────────────────┤ Industrial I/O Slot C ├───────────────────────────┐ │ │ │ (*) DIO 4x Digital Signals (inputs or outputs) │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ <Ok> <Cancel> │ │ │ └──────────────────────────────────────────────────────────────────────────────┘
- Each one of four Digital Signals 0 to 3 can be individually configured as either input or output
┌────────────────────────┤ Digital I/O (DIO) Options ├─────────────────────────┐ │ │ │ P0 D0 Configure Digital Signal 0 │ │ P1 D1 Configure Digital Signal 1 │ │ P2 D2 Configure Digital Signal 2 │ │ P3 D3 Configure Digital Signal 3 │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ <Select> <Back> │ │ │ └──────────────────────────────────────────────────────────────────────────────┘
┌─────────────────────────────┤ Digital Signal 2 ├─────────────────────────────┐ │ │ │ ( ) Input Read-only access enabled │ │ (*) Output Write-only access enabled │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ <Ok> <Cancel> │ │ │ └──────────────────────────────────────────────────────────────────────────────┘
User defined configuration can be shown in a corresponding menu.
Show Industrial I/O Modules
┌─────────────────┤ Show Industrial I/O Stack Configuration ├──────────────────┐ │ │ │ S1 Show User Configured Show user defined configuration │ │ S2 Show Current Configuration Show currently run configuration │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ <Select> <Back> │ │ │ └──────────────────────────────────────────────────────────────────────────────┘
User defined configuration
This option displays user defined configuration for industrial I/O slots
┌────────────┤ Industrial I/O Stack: user configuration ├────────────┐ │ │ │ Slot A: [CAN] - CAN FD interface │ │ │ │ │ │ Slot B: [RS485] - RS-485 interface (half-duplex) │ │ │ │ │ │ Slot C: [DIO] - 4x Digital Signals (inputs or outputs) │ │ │ │ IN OUT │ │ D0 [*][ ] │ │ D1 [ ][*] │ │ D2 [ ][*] │ │ D3 [*][ ] │ │ │ │ │ │ <Ok> │ │ │ └────────────────────────────────────────────────────────────────────┘
Running configuration
This option displays running configuration of the Industrial I/O Stack
┌──────────┤ Industrial I/O Stack: running configuration ├───────────┐ │ │ │ Slot A: [IDLE] - No interface is enabled │ │ │ │ │ │ Slot B: [IDLE] - No interface is enabled │ │ │ │ │ │ Slot C: [DIO] - 4x Digital Signals (inputs or outputs) │ │ │ │ IN OUT │ │ D0 [*][ ] │ │ D1 [*][ ] │ │ D2 [*][ ] │ │ D3 [*][ ] │ │ │ │ │ │ <Ok> │ │ │ └────────────────────────────────────────────────────────────────────┘
Peripherals Options
┌───────────────────────────┤ Peripherals Options ├────────────────────────────┐ │ │ │ G1 Show Show Peripherals Configuration │ │ G2 Configure Configure Peripherals │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ <Select> <Back> │ │ │ └──────────────────────────────────────────────────────────────────────────────┘
Configure Peripherals
┌──────────────────────────┤ Configure Peripherals ├───────────────────────────┐ │ │ │ C1 PCIe Configure PCI Express Devices │ │ C2 Wireless Configure Alternative Wireless Devices │ │ C3 Misc Configure Miscellaneous Devices │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ <Select> <Back> │ │ │ └──────────────────────────────────────────────────────────────────────────────┘
Configure PCI Express Devices
For PCI Express Bus it is possible to choose one of following configuration option:
- WIFI - enable Intel WiFi 6 AX210 module (default)
- NVME - enable NVMe secondary storage device
┌──────────────────────┤ Configure PCI Express Devices ├───────────────────────┐ │ │ │ ( ) WIFI WiFi Interface (PCIe) │ │ (*) NVME NVME Storage / HAILO AI │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ <Ok> <Cancel> │ │ │ └──────────────────────────────────────────────────────────────────────────────┘
Configure Alternative Wireless Devices
IOT-GATE-IOTG8PV2 features an optional WiFi/BT module interfaced via SDIO/UARD which can be enabled/disabled via this menu.
┌──────────────────┤ Configure Alternative Wireless Devices ├──────────────────┐ │ │ │ [ ] WIFI-SDIO Enable/Disable WiFi Interface (SDIO) │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ <Ok> <Cancel> │ │ │ └──────────────────────────────────────────────────────────────────────────────┘
Configure Misc Peripherals
IOT-GATE-IOTG8PV2 features CMD button which can be enabled/disabled via this menu.
┌────────────────────────┤ Configure Misc Peripherals ├────────────────────────┐ │ │ │ [*] CMD Enable/Disable CMD Button │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ <Ok> <Cancel> │ │ │ └──────────────────────────────────────────────────────────────────────────────┘
Show Peripherals Configuration
┌──────────────────────┤ Show Peripherals Configuration ├──────────────────────┐ │ │ │ P1 Show User Configured Show user defined configuration │ │ P2 Show Current Configuration Show currently run configuration │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ <Select> <Back> │ │ │ └──────────────────────────────────────────────────────────────────────────────┘
User defined configuration
┌────────────────┤ Peripherals: user configuration ├─────────────────┐ │ │ │ PCI Express: │ │ WiFi Interface (PCIe): [OFF] - Disabled │ │ NVME Storage / HAILO AI: [ON] - Enabled │ │ │ │ Alternative Wireless Connectivity: │ │ WiFi Interface (SDIO): [OFF] - Disabled │ │ │ │ Miscellaneous: │ │ CMD Button: [ON] - Enabled │ │ │ │ │ │ │ │ │ │ │ │ │ │ <Ok> │ │ │ └────────────────────────────────────────────────────────────────────┘
Running configuration
┌───────────────┤ Peripherals: running configuration ├───────────────┐ │ │ │ PCI Express: │ │ WiFi Interface (PCIe): [ON] - Enabled │ │ NVME Storage / HAILO AI: [OFF] - Disabled │ │ │ │ Alternative Wireless Connectivity: │ │ WiFi Interface (SDIO): [OFF] - Disabled │ │ │ │ Miscellaneous: │ │ CMD Button: [OFF] - Disabled │ │ │ │ │ │ │ │ │ │ │ │ │ │ <Ok> │ │ │ └────────────────────────────────────────────────────────────────────┘
Save Changes
It's strongly recommended to review user defined configuration for Gateway Peripherals and Industrial I/O Stack before applying a new configuration.
┌──────────────────────────────────────────────────────────┐ │ │ │ Would you like to apply changes and exit? │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ <Save & Exit> <Back> │ │ │ └──────────────────────────────────────────────────────────┘
Please note, all changes require a reboot to take effect.
┌────────────────────────────────────────────────────────────────────┐ │ │ │ NOTE: ANY CHANGES WILL TAKE EFFECT ONLY AFTER REBOOT. │ │ │ │ Would you like to reboot now? │ │ │ │ │ │ <Yes> <No> │ │ │ └────────────────────────────────────────────────────────────────────┘