feat: sACN-Einstellungen und -Status als Entitaeten

Die Firmware kann sACN/E1.31 - jetzt auch in Home Assistant, aufgebaut wie in
ha-ninlight: Schalter fuer den Empfang, Zahlen fuer Universe und Startslot,
Auswahl fuer das Verhalten nach Stromende, zwei Diagnose-Binaersensoren.

Die Einstellungen liegen hinter system/settings, der Koordinator liest sie
deshalb mit - eine vierte Anfrage je Zyklus. Nach dem Schreiben wird
zurueckgelesen statt angenommen, wie in ha-ninlight.

Zwei Unterschiede zu ninlight:
- Kein Layout-Feld: ninstrip nutzt fest drei Kanaele je Pixel.
- Der Startslot gilt in JEDEM belegten Universe. Die Obergrenze ist deshalb
  513 minus Kanaele je Pixel, also 510 - ein festes 512 boete Werte an, bei
  denen kein einziges Pixel mehr ins Universe passt.

Aeltere Firmware ohne sacn-Block: die Entitaeten entstehen trotzdem und
melden sich nicht verfuegbar, bis ein Update kommt.

In ha-dev an der Stehlampe geprueft: Universe, Startslot, on_timeout und der
Schalter kommen jeweils auf dem Geraet an; der Aktiv-Sensor steht waehrend
eines Stroms auf an, danach auf aus. 511 als Startslot weist Home Assistant
selbst ab ("outside valid range 1 - 510"). Einstellungen der Lampe danach
zurueckgestellt.
This commit is contained in:
ninharp
2026-09-22 18:09:40 +02:00
parent 8c9a9210d9
commit d0a9487805
12 changed files with 418 additions and 5 deletions
+33 -2
View File
@@ -3,23 +3,30 @@
from __future__ import annotations
from homeassistant.components.select import SelectEntity
from homeassistant.const import EntityCategory
from homeassistant.core import HomeAssistant
from homeassistant.helpers.entity_platform import AddConfigEntryEntitiesCallback
from .coordinator import NinstripConfigEntry, NinstripCoordinator
from .entity import NinstripEntity
from .entity import NinstripEntity, NinstripSacnEntity
# Wird angezeigt, wenn keine Szene aufgeschaltet ist oder jemand die Segmente
# seit dem Aufschalten veraendert hat.
NONE_OPTION = "—"
# Was das Geraet 2,5 s nach dem letzten sACN-Paket tut. Werte wie ha-ninlight.
ON_TIMEOUT_OPTIONS = ["release", "hold"]
async def async_setup_entry(
hass: HomeAssistant,
entry: NinstripConfigEntry,
async_add_entities: AddConfigEntryEntitiesCallback,
) -> None:
async_add_entities([NinstripPresetSelect(entry.runtime_data)])
coordinator = entry.runtime_data
async_add_entities(
[NinstripPresetSelect(coordinator), NinstripSacnOnTimeoutSelect(coordinator)]
)
class NinstripPresetSelect(NinstripEntity, SelectEntity):
@@ -65,3 +72,27 @@ class NinstripPresetSelect(NinstripEntity, SelectEntity):
await self.coordinator.async_call(lambda c: c.apply_preset(index))
await self.coordinator.async_after_change()
return
class NinstripSacnOnTimeoutSelect(NinstripSacnEntity, SelectEntity):
"""Was nach dem Ende eines sACN-Stroms passiert.
release: zurueck zum vorherigen Bild. hold: das letzte Bild bleibt stehen,
bis ein Bedienbefehl kommt - jede Aenderung ueber Home Assistant holt die
Kontrolle zurueck.
"""
_attr_entity_category = EntityCategory.CONFIG
_attr_translation_key = "sacn_on_timeout"
_attr_options = ON_TIMEOUT_OPTIONS
def __init__(self, coordinator: NinstripCoordinator) -> None:
super().__init__(coordinator, "sacn_on_timeout")
@property
def current_option(self) -> str | None:
value = self.sacn.get("on_timeout")
return value if value in ON_TIMEOUT_OPTIONS else None
async def async_select_option(self, option: str) -> None:
await self.coordinator.async_set_sacn(on_timeout=option)