Dashboard Cards

Set up PoE monitoring and board information cards on your Home Assistant dashboard.

6 minute read

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

type: custom:exaviz-poe-card
poe_set: onboard

Interceptor (first add-on PoE board):

type: custom:exaviz-poe-card
poe_set: addon_0

Interceptor (second add-on PoE board, if installed):

type: custom:exaviz-poe-card
poe_set: addon_1

Cruiser with add-on PoE board:

type: custom:exaviz-poe-card
poe_set: addon_0

Auto-Detection

When adding the card from the UI card picker (not YAML mode), the card auto-detects available PoE sets and pre-fills poe_set for you. You only need to specify poe_set manually when editing YAML directly or when you have multiple PoE sets and want to choose a specific one.

The poe_set parameter tells the card which set of PoE ports to display. The card discovers all ports within the specified set automatically.

Valid `poe_set` Values

Value	Board	Description
`onboard`	Cruiser	Built-in PoE ports on the Cruiser carrier board
`addon_0`	Interceptor / Cruiser	First add-on PoE board (Interceptor carrier J9, or Cruiser add-on)
`addon_1`	Interceptor	Second add-on PoE board (Interceptor carrier J10)

Typical configurations:

Board Setup	Card(s) Needed
Cruiser (built-in only)	One card with `poe_set: onboard`
Cruiser + add-on board	Two cards: `onboard` and `addon_0`
Interceptor + one PoE board	One card with `poe_set: addon_0`
Interceptor + two PoE boards	Two cards: `addon_0` and `addon_1`

Card Features

Color-coded port indicators:
- Green – Port is active and delivering power to a connected device
- Gray – Port is enabled but empty (no device connected)
- Red – Port is in a fault state
- Dark/Off – Port is administratively disabled
Tooltip information: Hover over (or tap) a port to see:
- Port status (active, empty, disabled)
- Power consumption and allocated power (e.g., “5.2W / 15.4W”)
- Connected device manufacturer (if detected)
- SoC temperature
Port controls:
- Click a port to select it
- Click again to toggle power on/off
- Right-click (or long-press) to reset (power cycle) the port

Board Information Card

The Board Information card displays system details about your Exaviz board using Home Assistant’s built-in entities card type.

Cruiser Layout

Use this layout for Cruiser boards. All attributes are available on boards with ESP32 firmware.

type: entities
title: Board Information
icon: mdi:chip
entities:
  - entity: sensor.board_status
    name: Status
  - type: attribute
    entity: sensor.board_status
    attribute: board_model_esp32
    name: Exaviz Board
    icon: mdi:developer-board
  - type: attribute
    entity: sensor.board_status
    attribute: board_hw_version
    name: Board Revision
    icon: mdi:tag
  - type: attribute
    entity: sensor.board_status
    attribute: board_serial
    name: Serial Number
    icon: mdi:identifier
  - type: attribute
    entity: sensor.board_status
    attribute: esp32_firmware_version
    name: ESP32 Firmware
    icon: mdi:chip
  - type: attribute
    entity: sensor.board_status
    attribute: dkms_driver_version
    name: DKMS Driver
    icon: mdi:package-variant
  - type: attribute
    entity: sensor.board_status
    attribute: netplan_version
    name: Exaviz Netplan Version
    icon: mdi:ip-network-outline
  - type: attribute
    entity: sensor.board_status
    attribute: compute_module
    name: Compute Module
    icon: mdi:expansion-card
  - entity: sensor.board_temperature
    name: SoC Temperature
  - type: attribute
    entity: sensor.board_status
    attribute: os_version
    name: OS Version
    icon: mdi:linux
  - type: attribute
    entity: sensor.board_status
    attribute: kernel_version
    name: Kernel
    icon: mdi:memory
  - type: attribute
    entity: sensor.board_status
    attribute: poe_controller
    name: PoE Controller
    icon: mdi:flash
  - type: attribute
    entity: sensor.board_status
    attribute: total_poe_ports
    name: Total PoE Ports
    icon: mdi:ethernet
  - type: attribute
    entity: sensor.board_status
    attribute: total_enabled_ports
    name: Enabled Ports
    icon: mdi:lan-connect
  - type: attribute
    entity: sensor.board_status
    attribute: total_power_watts
    name: Total Power Draw
    icon: mdi:lightning-bolt

Interceptor Layout

Interceptor boards do not have an ESP32, so ESP32-specific rows (Board Revision, Serial Number, ESP32 Firmware) are omitted. The PoE Driver version is included instead.

type: entities
title: Board Information
icon: mdi:chip
entities:
  - entity: sensor.board_status
    name: Status
  - type: attribute
    entity: sensor.board_status
    attribute: board_model_esp32
    name: Exaviz Board
    icon: mdi:developer-board
  - type: attribute
    entity: sensor.board_status
    attribute: dkms_driver_version
    name: DKMS Driver
    icon: mdi:package-variant
  - type: attribute
    entity: sensor.board_status
    attribute: poe_driver_version
    name: PoE Driver
    icon: mdi:package-variant
  - type: attribute
    entity: sensor.board_status
    attribute: netplan_version
    name: Exaviz Netplan Version
    icon: mdi:ip-network-outline
  - type: attribute
    entity: sensor.board_status
    attribute: compute_module
    name: Compute Module
    icon: mdi:expansion-card
  - entity: sensor.board_temperature
    name: SoC Temperature
  - type: attribute
    entity: sensor.board_status
    attribute: os_version
    name: OS Version
    icon: mdi:linux
  - type: attribute
    entity: sensor.board_status
    attribute: kernel_version
    name: Kernel
    icon: mdi:memory
  - type: attribute
    entity: sensor.board_status
    attribute: poe_controller
    name: PoE Controller
    icon: mdi:flash
  - type: attribute
    entity: sensor.board_status
    attribute: total_poe_ports
    name: Total PoE Ports
    icon: mdi:ethernet
  - type: attribute
    entity: sensor.board_status
    attribute: total_enabled_ports
    name: Enabled Ports
    icon: mdi:lan-connect
  - type: attribute
    entity: sensor.board_status
    attribute: total_power_watts
    name: Total Power Draw
    icon: mdi:lightning-bolt

One YAML Works on Both

You can use the Cruiser YAML on an Interceptor board. Attributes that don’t apply (like ESP32 Firmware) will simply display a dash (–). However, the board-specific layouts above provide a cleaner experience.

Adding the Board Information Card

Navigate to your dashboard and click the pencil icon (Edit Dashboard)
Click + Add Card
Select Entities from the card picker, or open the YAML editor
Paste the appropriate YAML from above (Cruiser or Interceptor)
Click Save

Recommended Dashboard Layout

For the best experience, we recommend creating a dedicated Exaviz dashboard with two cards:

PoE Port Card – Visual port monitoring and control (top)
Board Information Card – System details and status (below)

Creating a Dedicated Dashboard

Go to Settings > Dashboards
Click + Add Dashboard
Enter a title (e.g., “Exaviz”) and select an icon (e.g., mdi:ethernet)
Click Create
Open the new dashboard and add the cards above

Attribute Reference

Board Information Attributes

Attribute	Cruiser	Interceptor	Description
`board_model_esp32`	Yes	Yes	Board name (Cruiser or Interceptor)
`board_hw_version`	Yes	–	Board hardware revision
`board_serial`	Yes	–	Board serial number
`esp32_firmware_version`	Yes	–	ESP32 firmware version
`compute_module`	Yes	Yes	Compute module (e.g., Raspberry Pi CM5)
`cm_model`	Yes	Yes	Full CM model number (e.g., CM4102000)
`total_ram_gb`	Yes	Yes	Total RAM tier (e.g., 2 GB, 4 GB)
`has_wifi`	Yes	Yes	WiFi/Bluetooth present (Yes/No)
`emmc_storage`	Yes	Yes	eMMC size or “None (Lite)”
`os_version`	Yes	Yes	Operating system version
`kernel_version`	Yes	Yes	Linux kernel version
`poe_controller`	Yes	Yes	PoE controller chip name
`dkms_driver_version`	Yes	–	DKMS kernel driver version
`poe_driver_version`	–	Yes	Kernel PoE driver version
`netplan_version`	Yes	Yes	Exaviz Netplan package version
`total_poe_ports`	Yes	Yes	Total detected PoE ports
`total_enabled_ports`	Yes	Yes	Number of enabled ports
`total_power_watts`	Yes	Yes	Total power draw in watts

Next Steps

Troubleshooting – If cards aren’t displaying correctly
FAQ – Common questions about dashboard setup

Last modified February 25, 2026