Skip to content

Releases: johro897/tplink-switch-card

Almost there...

Choose a tag to compare

@johro897 johro897 released this 14 May 07:38
e9113cb

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_config attribute alongside actual link speed (e.g. "Configured: Auto")
  • Speed formatting — raw values like 1000MF are now shown as 1G, 2500M as 2.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 hass update — 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

First release

Choose a tag to compare

@johro897 johro897 released this 10 May 19:07
1fbbd10
Update README.md

Added a first screenshot for Hacs sake