Exaviz PoE Plugin for Home Assistant

Monitor and control Power over Ethernet ports on Exaviz hardware platforms.

A zero-configuration Home Assistant custom integration for managing PoE ports on Exaviz Interceptor and Cruiser carrier boards. Runs directly on the board -- no external servers required.

Click any port tile to see detailed information:

Features

• Zero Configuration -- Automatically detects board type and all PoE systems
• Real-time Monitoring -- Port status, power consumption, connected devices
• PoE Port Control -- Enable/disable individual PoE ports
• Device Discovery -- Identifies connected devices by IP, MAC, and manufacturer
• Modern Dashboard -- Lovelace card with dark/light theme support
• Multi-language -- 10 languages included (EN, DE, ES, FR, IT, JA, KO, NL, PT-BR, ZH)

Supported Hardware

Board	Onboard PoE	Add-on PoE	Max Ports
Cruiser (CM5)	4 or 8 ports @ 1GbE	1 add-on board (8 ports)	16
Interceptor (CM4/CM5)	None	Up to 2 add-on boards (8 ports each)	16

Requirements

• Exaviz Cruiser or Interceptor board with PoE support
• Debian-based Linux (Bookworm or Trixie) -- e.g., Raspberry Pi OS via Imager
• exaviz-dkms package installed (kernel modules, device tree overlays)
• exaviz-netplan package installed (per-port network configuration)
• exaviz-poe-tool package installed (PoE monitoring utility)
• Home Assistant 2024.12+ (Docker Container recommended)
• HACS (Home Assistant Community Store)

Note: The exaviz-dkms, exaviz-netplan, and exaviz-poe-tool packages are required on all board types (Cruiser and Interceptor). Install them from the Exaviz apt repository.

The deprecated pre-built Exaviz OS images are not supported by this plugin. Use a standard Debian-based OS with the Exaviz packages instead.

Quick Start

0. Install Exaviz packages on the host OS

# Add the Exaviz apt repository (one-time setup)
curl -fsSL https://apt.exaviz.com/KEY.gpg \
  | sudo gpg --dearmor -o /usr/share/keyrings/exaviz-archive-keyring.gpg
DISTRO=$(lsb_release -cs 2>/dev/null || grep VERSION_CODENAME /etc/os-release | cut -d= -f2)
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

# Install required packages
sudo apt update
sudo apt install exaviz-dkms exaviz-netplan exaviz-poe-tool

# Reboot to load kernel modules and device tree overlays
sudo reboot

1. Install via HACS

1. Open HACS in Home Assistant
2. Search for "Exaviz"
3. Click on Exaviz PoE Plugin and click Download
4. Restart Home Assistant

Tip: If you need a version that isn't in the default HACS store (e.g., a pre-release or development branch), you can add this repository as a Custom repository instead: https://github.com/exavizco/ha-poe-plugin

2. Add the Integration

1. Go to Settings > Devices & Services
2. Click + Add Integration
3. Search for "Exaviz"
4. The integration auto-detects your board and PoE systems -- no configuration needed

3. Add the Dashboard Card

1. Edit a dashboard and click + Add Card
2. Search for "Exaviz PoE"
3. The card auto-detects your PoE configuration and displays ports for the selected set
4. For boards with multiple PoE sets (e.g., Cruiser onboard + add-on, or dual Interceptor), add one card per set

Documentation

Full documentation is available at exa-pedia.com:

• Installation Guide
• Configuration
• Dashboard Setup
• Troubleshooting
• FAQ

Development

Project Structure

custom_components/exaviz/    # Home Assistant integration (Python)
lovelace-cards/              # Frontend Lovelace card (TypeScript)
tests/                       # Test suite

Running Tests

pip install -e ".[dev]"
pytest tests/ -v

Building Frontend

cd lovelace-cards
npm ci
npm run build

Links

• Website: www.exaviz.com
• Documentation: www.exa-pedia.com
• Support: support@exaviz.com

License

MIT License - see LICENSE for details.

Copyright (c) 2026 Axzez LLC (aka Exaviz)