Skip to main content

Software Setup

This page covers operating system compatibility, boot modes, storage options, and GPIO-controlled features for the IRIV SmartHub CM5.

Operating System Compatibility​

The IRIV SmartHub CM5 is based on the Raspberry Pi Compute Module 5 and ships with Raspberry Pi OS pre-installed.

OSStatus
Raspberry Pi OSSupported (pre-installed)

For other operating systems compatible with Raspberry Pi CM5, refer to the official Raspberry Pi documentation.

Boot Modes​

The IRIV SmartHub CM5 supports multiple boot configurations controlled by the internal Boot/Run switch and boot order settings.

Boot/Run Mode Switch​

PositionFunction
BootCM5 enters USB boot mode for OS programming via USB-C
RunNormal operation mode

Boot Sources​

SourceSupport
eMMCYes (default, pre-installed OS)
NVMe SSDYes (via M.2 Key-M socket, bootable)
USBNot specified in official manual
NetworkNot specified in official manual

Changing Boot Order​

To boot from NVMe SSD instead of eMMC, configure the boot order using the Raspberry Pi configuration tools. Refer to official Raspberry Pi CM5 documentation for boot order configuration.

Storage Options​

Built-in eMMC​

ParameterOptions
Capacity16GB / 32GB / 64GB (varies by SKU)
FunctionPrimary OS storage

M.2 NVMe SSD Expansion​

ParameterSpecification
InterfacePCIe Gen 2, 1-lane
Supported Form Factors2230, 2242
BootableYes
SATA SupportNo (M.2 SATA SSDs are not supported)

To install an NVMe SSD:

  1. Power off the device and disconnect all cables
  2. Remove the enclosure cover
  3. Insert the NVMe SSD into the M.2 Key-M socket
  4. Secure with the standoff screw (use 2230 or 2242 position as appropriate)
  5. Reassemble the enclosure

GPIO-Controlled Features​

Programmable LEDs​

Control the user LEDs by setting GPIO pins as outputs:

LEDGPIOActive State
LED0GPIO20HIGH = ON
LED1GPIO21HIGH = ON

Example using pinctrl (Raspberry Pi OS):

# Turn on LED0
pinctrl set 20 op dh

# Turn off LED0
pinctrl set 20 op dl

Active Buzzer​

ParameterValue
GPIOGPIO19
Active StateHIGH = Beep

Example:

# Activate buzzer
pinctrl set 19 op dh

# Deactivate buzzer
pinctrl set 19 op dl

User Button​

ParameterValue
GPIOGPIO4
Read StateLOW when pressed (typical)

The user button can be configured for various functions including safe shutdown. Implementation requires software configuration.

Mini PCIe Power and Reset Control​

FunctionGPIOUsage
PowerGPIO6HIGH = Power on, LOW = Power off
ResetGPIO5LOW = Reset (active low)

Use these GPIOs to control power cycling and reset of modules installed in the mini PCIe socket (e.g., 4G/LTE modules).

RTC Configuration​

The IRIV SmartHub CM5 includes a CR2032 coin cell holder for the built-in RTC on the CM5.

ParameterValue
Battery TypeCR2032
FunctionKeeps RTC running when system is powered off

The RTC is built into the CM5 module. Install a CR2032 battery to maintain time when the system is powered off.

Wireless Configuration​

WiFi​

WiFi is enabled by default. Configure using standard Raspberry Pi OS network tools:

# Scan for networks
nmcli device wifi list

# Connect to a network
nmcli device wifi connect "SSID" password "password"

Disabling Wireless​

To permanently disable WiFi or Bluetooth, solder the corresponding jumper pads on the internal board (labeled WL for WiFi, BT for Bluetooth).