Files
Michael Sauer 9eb7adcdd7 feat: nachgezogen, was ha-ninlight laengst hat
Michaels Befund: die Integration ist nicht dasselbe wie die von ninlight.
Verglichen und die Luecken geschlossen - alle Felder gibt es in der
Firmware schon, sie waren nur nicht bedienbar:

* number: fade_in, fade_out, transition_default in Millisekunden, mit den
  Grenzen der Firmware (10 s, 10 s, 60 s).
* select: Einschaltverhalten (last, on, off).
* switch: bei Aenderung einschalten.
* light: Uebergangszeit beim Ein- und Ausschalten. HA rechnet in Sekunden,
  das Geraet in Millisekunden; laengeres als 60 s wird gekappt, sonst
  wiese das Geraet die ganze Anfrage mit 400 ab. Ohne Angabe wird kein
  Feld geschickt, sonst ueberschriebe jeder Schaltbefehl die Vorgabe.
* sensor: letzter Update-Fehler und Startzeit (Zeitstempel statt einer
  Laufzeit, die jede Abfrage weiterlaeuft), beide ab Werk aus.
* diagnostics.py: Diagnosedaten zum Herunterladen, ohne Token, Adressen,
  MAC und SSID.
* config_flow: Neu-Konfigurieren von Adresse und Token, mit Gegenprobe der
  MAC - ein Tippfehler in der Adresse soll nicht still den falschen
  Eintrag umbiegen.
* Hinweis in den Reparaturen, wenn ein Geraet noch auf dem oeffentlichen
  Werks-Token steht.

Nicht uebernommen: die Auswahl sacn_layout. ninstrip ist immer rgb, ein
Strip hat keinen Masterkanal - eine Auswahl mit einer Option waere nur
Zierde.

241 Tests, 97 %. Die Kappung der Uebergangszeit per Mutation gegengeprueft.
2026-09-23 00:35:12 +02:00

71 lines
2.3 KiB
Python

"""Schalter eines ninstrip-Geraets: Aufwecken bei Aenderung und sACN."""
from __future__ import annotations
from typing import Any
from homeassistant.components.switch import SwitchEntity
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, NinstripSacnEntity
PARALLEL_UPDATES = 0
async def async_setup_entry(
hass: HomeAssistant,
entry: NinstripConfigEntry,
async_add_entities: AddConfigEntryEntitiesCallback,
) -> None:
async_add_entities(
[NinstripWakeSwitch(entry.runtime_data), NinstripSacnSwitch(entry.runtime_data)]
)
class NinstripWakeSwitch(NinstripEntity, SwitchEntity):
"""Schaltet den Strip ein, sobald Farbe, Farbtemperatur oder Helligkeit
geaendert werden - statt die Aenderung nur zu merken."""
_attr_entity_category = EntityCategory.CONFIG
_attr_translation_key = "wake_on_change"
def __init__(self, coordinator: NinstripCoordinator) -> None:
super().__init__(coordinator, "wake_on_change")
@property
def is_on(self) -> bool:
return bool(self.coordinator.data.state.get("wake_on_change"))
async def async_turn_on(self, **kwargs: Any) -> None:
await self.coordinator.async_set_state(wake_on_change=True)
async def async_turn_off(self, **kwargs: Any) -> None:
await self.coordinator.async_set_state(wake_on_change=False)
class NinstripSacnSwitch(NinstripSacnEntity, SwitchEntity):
"""Ob das Geraet ueberhaupt auf sACN/E1.31 hoert.
Abschalten holt dem Strom auch die Kontrolle ab - bei on_timeout "hold"
bliebe sonst das letzte Bild stehen. Die Firmware erledigt das selbst.
"""
_attr_entity_category = EntityCategory.CONFIG
_attr_translation_key = "sacn_enabled"
def __init__(self, coordinator: NinstripCoordinator) -> None:
super().__init__(coordinator, "sacn_enabled")
@property
def is_on(self) -> bool:
return bool(self.sacn.get("enabled"))
async def async_turn_on(self, **kwargs: Any) -> None:
await self.coordinator.async_set_sacn(enabled=True)
async def async_turn_off(self, **kwargs: Any) -> None:
await self.coordinator.async_set_sacn(enabled=False)