Michael Sauer
9eb7adcdd7
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.
101 lines
3.6 KiB
Python
101 lines
3.6 KiB
Python
"""Die ninstrip-Integration."""
|
|
|
|
from __future__ import annotations
|
|
|
|
from homeassistant.const import CONF_HOST, CONF_TOKEN, Platform
|
|
from homeassistant.core import HomeAssistant, callback
|
|
from homeassistant.helpers import config_validation as cv
|
|
from homeassistant.helpers import issue_registry as ir
|
|
from homeassistant.helpers.aiohttp_client import async_get_clientsession
|
|
from homeassistant.helpers.typing import ConfigType
|
|
|
|
from .api import NinstripClient
|
|
from .const import DEFAULT_PORT, DEFAULT_TOKEN, DOMAIN
|
|
from .coordinator import NinstripConfigEntry, NinstripCoordinator
|
|
from .shared import async_get_shared, async_start_catalog, async_stop_catalog
|
|
|
|
CONFIG_SCHEMA = cv.config_entry_only_config_schema(DOMAIN)
|
|
|
|
PLATFORMS: list[Platform] = [
|
|
Platform.LIGHT,
|
|
Platform.SELECT,
|
|
Platform.SENSOR,
|
|
Platform.BUTTON,
|
|
Platform.SWITCH,
|
|
Platform.NUMBER,
|
|
Platform.BINARY_SENSOR,
|
|
Platform.UPDATE,
|
|
]
|
|
|
|
|
|
async def async_setup(hass: HomeAssistant, config: ConfigType) -> bool:
|
|
"""Die Ausgabe fuer die Abbilder haengt an http und wird einmal angemeldet."""
|
|
async_get_shared(hass)
|
|
return True
|
|
|
|
|
|
async def async_setup_entry(hass: HomeAssistant, entry: NinstripConfigEntry) -> bool:
|
|
"""Einen Strip einrichten."""
|
|
client = NinstripClient(
|
|
async_get_clientsession(hass),
|
|
entry.data[CONF_HOST],
|
|
entry.data[CONF_TOKEN],
|
|
port=entry.data.get("port", DEFAULT_PORT),
|
|
)
|
|
coordinator = NinstripCoordinator(hass, entry, client)
|
|
await coordinator.async_config_entry_first_refresh()
|
|
|
|
entry.runtime_data = coordinator
|
|
_async_werks_token_hinweis(hass, entry)
|
|
await async_start_catalog(hass, async_get_shared(hass))
|
|
await hass.config_entries.async_forward_entry_setups(entry, PLATFORMS)
|
|
return True
|
|
|
|
|
|
async def async_unload_entry(hass: HomeAssistant, entry: NinstripConfigEntry) -> bool:
|
|
entladen = await hass.config_entries.async_unload_platforms(entry, PLATFORMS)
|
|
# Der Katalog gehoert allen Eintraegen gemeinsam; er laeuft weiter,
|
|
# solange noch einer da ist.
|
|
if entladen and not [
|
|
anderer
|
|
for anderer in hass.config_entries.async_loaded_entries(DOMAIN)
|
|
if anderer.entry_id != entry.entry_id
|
|
]:
|
|
async_stop_catalog(async_get_shared(hass))
|
|
return entladen
|
|
|
|
|
|
async def async_remove_entry(hass: HomeAssistant, entry: NinstripConfigEntry) -> None:
|
|
ir.async_delete_issue(hass, DOMAIN, f"wifi_guard_{entry.entry_id}")
|
|
ir.async_delete_issue(hass, DOMAIN, f"default_token_{entry.entry_id}")
|
|
|
|
|
|
@callback
|
|
def _async_werks_token_hinweis(hass: HomeAssistant, entry: NinstripConfigEntry) -> None:
|
|
"""Weist darauf hin, dass ein Geraet noch auf dem oeffentlichen Token steht.
|
|
|
|
Das Werks-Token steht im Repo. Wer es kennt und im selben Netz ist, kann
|
|
das Geraet umkonfigurieren, neu starten, flashen und zuruecksetzen. Wie in
|
|
ha-ninlight.
|
|
"""
|
|
issue_id = f"default_token_{entry.entry_id}"
|
|
if entry.data[CONF_TOKEN] == DEFAULT_TOKEN:
|
|
ir.async_create_issue(
|
|
hass,
|
|
DOMAIN,
|
|
issue_id,
|
|
is_fixable=False,
|
|
severity=ir.IssueSeverity.WARNING,
|
|
translation_key="default_token",
|
|
translation_placeholders={"name": entry.title},
|
|
)
|
|
else:
|
|
ir.async_delete_issue(hass, DOMAIN, issue_id)
|
|
|
|
|
|
# Kein add_update_listener zum Neuladen: der Einstellungsdialog ist ein
|
|
# OptionsFlowWithReload und laedt selbst neu. Beides zusammen weist Home
|
|
# Assistant seit 2026.x rundheraus ab ("Config entry update listeners should
|
|
# not be used with OptionsFlowWithReload") - gemerkt am 22.09.2026, als sich
|
|
# in ha-dev keine einzige Einstellung speichern liess.
|