feat: sACN-Einstellungen und -Status als Entitaeten

Die Firmware kann seit dieser Woche sACN/E1.31. Einstellen liess sich das nur
per REST - jetzt steht es in Home Assistant: Schalter fuer den Empfang, Zahlen
fuer Universe und Startslot, Auswahlen fuer das Verhalten nach dem Timeout und
die Slotbelegung, dazu zwei Diagnose-Binaersensoren.

Die sACN-Einstellungen liegen hinter system/settings, nicht in device/state -
der Koordinator liest sie deshalb jetzt mit, eine dritte Anfrage je Zyklus. Der
Schreibweg liest die Einstellungen danach frisch zurueck statt den gesetzten
Wert anzunehmen: die Lampe validiert selbst (die Startslot-Grenze haengt an der
Slotbelegung), und eine Entitaet, die das Gewuenschte statt des Gespeicherten
zeigt, luegt in genau dem Moment, in dem es darauf ankommt.

Aeltere Firmware antwortet ohne den sacn-Block. Die Entitaeten entstehen
trotzdem und melden sich als nicht verfuegbar - so werden sie nach einem Update
der Lampe beim naechsten Poll von selbst lebendig, ohne Neuladen.

Die Obergrenze des Startslots kommt aus dem "slots"-Feld der Lampe, nicht aus
einer festen 512: sie haengt an Board UND Slotbelegung, und eine feste Grenze
wuerde Werte anbieten, die die Lampe dann ablehnt.

Der Multicast-Sensor ist ab Werk deaktiviert wie die uebrigen Diagnosewerte. Er
meldet im Normalbetrieb schlicht "beigetreten" - aber eine falsche
Gruppenadresse hat zwei Abende gekostet, und genau dort waere sie aufgefallen.

test_update.py misst seine Zusage jetzt um den Rescan herum statt nach dem
Install: dort pollt der Koordinator ohnehin wieder und liest seitdem auch die
Einstellungen mit.
This commit is contained in:
Michael Sauer
2026-09-21 23:35:54 +02:00
parent 5781e723ab
commit ac60428fdb
15 changed files with 791 additions and 85 deletions
+38 -3
View File
@@ -30,10 +30,25 @@ type NinlightConfigEntry = ConfigEntry[NinlightCoordinator]
@dataclass(frozen=True, slots=True)
class NinlightData:
"""Last known lamp state and system info."""
"""Last known lamp state, system info and settings."""
state: dict[str, Any]
info: dict[str, Any]
# Only the settings the lamp exposes; a lamp on firmware without sACN carries no
# "sacn" block here, and the entities that need it report themselves unavailable.
settings: dict[str, Any]
@property
def sacn(self) -> dict[str, Any] | None:
"""The lamp's sACN settings, or None on firmware that predates the feature."""
block = self.settings.get("sacn")
return block if isinstance(block, dict) else None
@property
def sacn_info(self) -> dict[str, Any] | None:
"""The sACN status from system/info, or None on firmware without it."""
block = self.info.get("sacn")
return block if isinstance(block, dict) else None
class NinlightCoordinator(DataUpdateCoordinator[NinlightData]):
@@ -68,6 +83,9 @@ class NinlightCoordinator(DataUpdateCoordinator[NinlightData]):
async with self.lock:
state = await self.client.get_state()
info = await self.client.get_info()
# The sACN settings live behind system/settings, not device/state - so the
# config entities for them need this third request per cycle.
settings = await self.client.get_settings()
except NinlightAuthError as err:
raise ConfigEntryAuthFailed(f"{self.client.host}: token rejected") from err
except NinlightError as err:
@@ -83,7 +101,7 @@ class NinlightCoordinator(DataUpdateCoordinator[NinlightData]):
return self.data
raise UpdateFailed(f"{self.client.host}: {err}") from err
self._consecutive_poll_failures = 0
return NinlightData(state, info)
return NinlightData(state, info, settings)
async def async_call[T](self, action: Callable[[NinlightClient], Awaitable[T]]) -> T:
"""Run one request under the lock and translate lamp errors for the UI."""
@@ -110,8 +128,25 @@ class NinlightCoordinator(DataUpdateCoordinator[NinlightData]):
translation_domain=DOMAIN, translation_key="cannot_connect"
) from err
async def async_set_sacn(self, **fields: Any) -> None:
"""Write sACN settings and adopt the lamp's own answer.
The lamp returns only {"ok": true}, so the settings are read back instead of
guessed: it clamps and validates on its own (the start_slot limit depends on the
slot layout, for one), and an entity that shows what was asked for rather than what
was stored would lie the moment the two differ.
"""
async def write_and_read(client: NinlightClient) -> dict[str, Any]:
await client.set_sacn(**fields)
return await client.get_settings()
settings = await self.async_call(write_and_read)
self._consecutive_poll_failures = 0
self.async_set_updated_data(NinlightData(self.data.state, self.data.info, settings))
async def async_set_state(self, **fields: Any) -> None:
"""Write and adopt the lamp's complete answer directly - no debounced refresh."""
state = await self.async_call(lambda client: client.set_state(**fields))
self._consecutive_poll_failures = 0
self.async_set_updated_data(NinlightData(state, self.data.info))
self.async_set_updated_data(NinlightData(state, self.data.info, self.data.settings))