System Software

Exaviz provides custom operating system images with pre-installed drivers for all supported compute modules. These images are based on Debian/Raspberry Pi OS and include everything needed to use your Exaviz hardware.

Available OS Images

Included Drivers

All Exaviz OS images include:

• RTL8367RB - 4-port Gigabit Ethernet switch driver
• JMB585 - 5-port SATA controller driver (Interceptor)
• IP808AR - PoE controller driver (for PoE expansion boards)
• RTL8365MB - PoE switch driver (Cruiser)

Version Requirements

Debian Package Repository

For users running standard Raspberry Pi OS or Ubuntu, Exaviz provides a Debian package repository with software packages for hardware support.

Available Packages

Adding the Repository

# Download and install the Exaviz signing key
curl -fsSL https://apt.exaviz.com/exaviz-repo-key.asc | sudo gpg --dearmor -o /usr/share/keyrings/exaviz-archive-keyring.gpg

# Detect distribution and add the repository
DISTRO=$(lsb_release -cs 2>/dev/null || (grep VERSION_CODENAME /etc/os-release 2>/dev/null | cut -d= -f2) || echo "trixie")
echo "deb [arch=arm64 signed-by=/usr/share/keyrings/exaviz-archive-keyring.gpg] https://apt.exaviz.com ${DISTRO} main" | sudo tee /etc/apt/sources.list.d/exaviz.list

# Update package lists
sudo apt update

The script automatically detects your distribution:

• Raspberry Pi OS Trixie → uses trixie
• Debian 13 (Trixie) → uses trixie
• Debian 12 (Bookworm) → uses bookworm (deprecated)
• Ubuntu 25.10 (Questing) → uses questing

Installing Packages

Minimum installation (drivers only):

sudo apt install exaviz-dkms

Recommended installation (drivers + network configuration):

sudo apt install exaviz-dkms exaviz-netplan

Interceptor boards (adds PoE driver):

sudo apt install exaviz-dkms exaviz-pse-dkms exaviz-netplan

Full installation (all packages):

sudo apt install exaviz-dkms exaviz-pse-dkms exaviz-netplan exaviz-poe-tool

After installation, reboot to load the kernel modules:

sudo reboot

Package Details

exaviz-dkms

The core driver package provides:

• PoE switch drivers (RTL8365MB for Cruiser, RTL8367RB for Interceptor)
• DSA (Distributed Switch Architecture) framework support
• Device tree overlays for CM4/CM5
• WAN port LED configuration (RTL8156)

exaviz-pse-dkms

IP808AR Power Sourcing Equipment (PSE) kernel module:

• Required for Interceptor boards with PoE expansion
• Required for Cruiser boards using the Interceptor PoE Add-on Board
• Provides /proc/pse interface for PoE port monitoring and control
• Supports up to 8 PoE ports per IP808AR device

exaviz-netplan

Network configuration package that:

• Configures the WAN/uplink port for DHCP client (Interceptor: wan)
• Sets up switch and PoE port interfaces
• Optionally configures dnsmasq as DHCP server for connected devices

On Interceptor, the wan port is the uplink (DHCP client) and lan0-lan2 plus any PoE ports are available as DHCP servers. On Cruiser, the switch and PoE ports are configured by exaviz-netplan; eth1 (2.5GbE WAN) requires manual configuration.

During installation, you can select which ports should run a DHCP server for connected devices (cameras, etc.).

exaviz-poe-tool

A GTK3 graphical application for:

• Real-time PoE port status monitoring
• Viewing power consumption per port
• Resetting individual ports
• Temperature and voltage monitoring

Quick Links

• Downloads - Get the latest OS images
• Installation - How to flash images to your device

Last modified February 25, 2026