IOT-GATE-IMX8PV2: Debian Linux: iotg-config Configuration Tool

From Compulab Mediawiki
Revision as of 17:38, 12 November 2026 by Igor (talk | contribs) (Created page with "= Overview = This article provides instructions for ''iotg-config'' configuration tool. It is a command-line interactive tool for managing IOT-GATE-IMX8PV2 peripherals and ind...")
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to: navigation, search

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

Admolition note.png 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

Navigation

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>                    │
│                                                                    │
└────────────────────────────────────────────────────────────────────┘