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.
60 lines
2.2 KiB
Python
60 lines
2.2 KiB
Python
"""Konstanten der ninstrip-Integration. Bewusst frei von Home-Assistant-Importen."""
|
|
|
|
from __future__ import annotations
|
|
|
|
from datetime import timedelta
|
|
from typing import Final
|
|
|
|
DOMAIN: Final = "ninstrip"
|
|
|
|
# Oeffentliches Werks-Token der Firmware (NL_DEFAULT_TOKEN), dasselbe wie bei
|
|
# ninlight. Ein Geraet im Auslieferungszustand und nach jedem Werksreset
|
|
# antwortet damit - deshalb belegt der Einrichtungsdialog es vor.
|
|
DEFAULT_TOKEN: Final = "aabbccddeeff0011223344"
|
|
|
|
CONF_SCAN_INTERVAL: Final = "scan_interval"
|
|
# Nur noetig, wenn die Geraete die interne Adresse von Home Assistant nicht
|
|
# ueber schlichtes http erreichen.
|
|
CONF_DEVICE_BASE_URL: Final = "device_base_url"
|
|
|
|
DEFAULT_PORT: Final = 3333
|
|
DEFAULT_SCAN_INTERVAL: Final = 30
|
|
MIN_SCAN_INTERVAL: Final = 10
|
|
MAX_SCAN_INTERVAL: Final = 300
|
|
|
|
# So viele aufeinanderfolgende Fehlversuche werden geschluckt, bevor das
|
|
# Geraet als nicht verfuegbar gilt. Ein kurzer Aussetzer im WLAN soll nicht
|
|
# sofort alle Entitaeten ausgrauen.
|
|
MAX_POLL_FAILURES: Final = 3
|
|
|
|
# Laengster Uebergang, den die Firmware annimmt (nl_api_device.c:
|
|
# "transition ausserhalb 0..60000 ms").
|
|
MAX_TRANSITION_MS: Final = 60_000
|
|
# Die drei Millisekunden-Felder in device/state, mit den Grenzen der Firmware.
|
|
MAX_FADE_MS: Final = 10_000
|
|
|
|
# Die Firmware erlaubt hoechstens 16 Segmente (nl_segments.h) und 512 Pixel.
|
|
MAX_SEGMENTS: Final = 16
|
|
MAX_PIXELS: Final = 512
|
|
# Acht Szenenplaetze (nl_presets.h).
|
|
MAX_PRESETS: Final = 8
|
|
|
|
# --- Firmware-Aktualisierung -----------------------------------------
|
|
|
|
# Ordner unterhalb des HA-Konfigurationsverzeichnisses, in dem die Abbilder
|
|
# liegen (tools/release_images.sh der Firmware legt sie dort ab).
|
|
FIRMWARE_DIR_NAME: Final = "ninstrip_firmware"
|
|
CATALOG_SCAN_INTERVAL: Final = timedelta(minutes=5)
|
|
SIGNAL_CATALOG_UPDATED: Final = f"{DOMAIN}_catalog_updated"
|
|
|
|
FIRMWARE_URL_PREFIX: Final = "/api/ninstrip/firmware/"
|
|
# len(secrets.token_urlsafe(32))
|
|
FIRMWARE_KEY_LENGTH: Final = 43
|
|
# Laengere fw_update-Adressen weist das Geraet ab (nl_api_system.c: url[256]).
|
|
MAX_DEVICE_URL_LENGTH: Final = 255
|
|
|
|
OTA_POLL_INTERVAL_S: Final = 5.0
|
|
# Der ESP32 laedt rund 1 MB und startet danach neu; ein totes Gegenueber kann
|
|
# aber minutenlang im TCP haengen. Grosszuegig wie bei ninlight.
|
|
OTA_TIMEOUT_S: Final = 12 * 60.0
|