Release Notes
v0.9.0
This release adds full write capability to the card — you can now configure PoE settings per port and adjust the global budget directly from Lovelace, without leaving Home Assistant.
This is a pre-release. A 1.0 will follow after further testing.
PoE configuration per port
A Configure PoE button now appears in each expanded PoE port detail row. Clicking it opens an inline panel with two dropdowns:
- Priority — Low / Middle / High
- Power limit — Auto / Class 1 / Class 2 / Class 3 / Class 4 / Manual
Hit Apply to send the change to the switch via tplink_easy_smart.set_port_poe_settings, or Cancel to close without saving. The panel pre-fills with the port's current values.
Global PoE budget editor
A ✏️ icon next to the PoE budget bar opens an inline number input. Enter a new limit and hit Set to call tplink_easy_smart.set_general_poe_limit.
Optional: add max_poe_watts to your card config to set the switch's physical hardware maximum. The editor will show the cap and block Set with an inline error message if you try to exceed it:
type: custom:tplink-switch-card
entity_prefix: tp_link_switch
max_poe_watts: 150
Validation runs on Set click only — no re-render while typing.
Auto-read MAC address
The card no longer requires a mac_address config key. It reads the MAC automatically from sensor.*_network_info and uses it for all service calls. If you had mac_address in your config you can remove it.
Click to copy IP and MAC
Click the IP address or MAC tile in the overview to copy the value to clipboard. Works on both HTTPS and plain HTTP installs — falls back to execCommand when the modern clipboard API is unavailable.
Switch UI link
A link icon (↗) appears next to the IP address. Clicking it opens the switch's web UI in a new tab. The URL is derived automatically from the IP in network_info — nothing to configure.
Port detail improvements
- Configured speed — shows
speed_configattribute alongside actual link speed (e.g. "Configured: Auto") - Speed formatting — raw values like
1000MFare now shown as1G,2500Mas2.5G - Priority and power limit now shown as read-only in the detail row before opening the configure panel
PoE budget bar colors
The budget bar now changes color based on load:
- Blue — below 80%
- Amber — above 80%
- Red — above 95%
Performance
- Dirty-check on every
hassupdate — the card only re-renders when a watched entity actually changes state or a relevant attribute changes - Per-render entity cache (
_portEntitiesCache) avoids redundant entity lookups when multiple functions access the same port
Configuration changes
| Key | Change |
|---|---|
| mac_address | Removed — read automatically from network_info |
| switch_url | Removed — derived automatically from IP in network_info |
| max_poe_watts | New — optional hardware PoE cap for the budget editor |