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).