Home Assistant PoE Plugin on exaviz encyclopedia

Installation

Mon, 01 Jan 0001 00:00:00 +0000

Prerequisites

Before installing the plugin, ensure you have the following:

Hardware

An Exaviz board with PoE support:
- Cruiser Carrier Board with built-in PoE ports, or
- Interceptor Carrier Board with one or two Interceptor PoE Boards
PoE hardware is powered and operational — verify with head -20 /dev/pse (Cruiser) or head -20 /proc/pse (Interceptor)

Software

Debian-based Linux (Raspberry Pi OS, Debian Trixie, Debian Bookworm, etc.)
Exaviz PoE packages installed from the Exaviz APT repository. Follow the instructions on that page to add the repository signing key and source, then install:

Configuration

Mon, 01 Jan 0001 00:00:00 +0000

Adding the Integration

After installing the plugin, add the integration to Home Assistant:

Go to Settings > Devices & Services
Click + Add Integration (bottom right)
Search for Exaviz
Select Exaviz PoE
The integration will automatically detect your board type and PoE hardware
Click Submit to complete setup

The integration requires no manual configuration. It automatically detects:

Board type (Cruiser or Interceptor)
Compute module (Raspberry Pi CM4, CM5, etc.)
PoE controller and available ports
Installed Exaviz packages and versions

Entities Created

The integration creates several entity types for monitoring and controlling your PoE ports. All entities are grouped under a single device named after your board (e.g., “Exaviz Cruiser” or “Exaviz Interceptor”).

Dashboard Cards

Mon, 01 Jan 0001 00:00:00 +0000

The Exaviz plugin includes two types of dashboard cards: a custom PoE Port Card for per-port monitoring and control, and a recommended Board Information Card using Home Assistant’s built-in entities card.

PoE Port Card

The custom Exaviz PoE card provides a visual overview of all PoE ports with real-time status, power consumption, and interactive controls.

Adding the Card

Navigate to your dashboard
Click the pencil icon (Edit Dashboard) in the top right
Click + Add Card
Search for Custom: Exaviz PoE Card (or use the YAML editor)
Add the following configuration:

Cruiser (built-in PoE ports):

Troubleshooting

Mon, 01 Jan 0001 00:00:00 +0000

This guide covers common issues with the Exaviz Home Assistant PoE Plugin and their solutions.

Installation Issues

Integration not appearing after HACS install

Symptoms: You installed the plugin via HACS but “Exaviz” doesn’t appear when searching for integrations in Settings > Devices & Services.

Solutions:

Restart Home Assistant – HACS installations require a full restart:
- Go to Settings > System > Restart
- Wait for Home Assistant to fully restart (this may take a few minutes)
Clear browser cache – Hard refresh your browser:

FAQ

Mon, 01 Jan 0001 00:00:00 +0000

General Questions

What boards are supported?

The plugin supports all Exaviz boards with PoE:

Board	PoE Source	Controller
Cruiser	Built-in PoE+ ports (4 or 8 depending on model)	TPS23861
Interceptor + PoE Board	Add-on via FFC cable (8 ports per board, up to 16)	IP808AR

The plugin auto-detects your board type at startup. No manual configuration is needed.

Does this work with both CM4 and CM5?

Yes. The plugin works with any compute module supported by your carrier board: