Michael Sauer
2c77b2d325
Aufgebaut wie ha-ninlight: die Abbilder liegen unter ninstrip_firmware im Konfigurationsverzeichnis, Home Assistant liefert sie selbst unter einer einmaligen Adresse aus, und zwar genau die Bytes, die vorher geprueft wurden. Dazu firmware.py (Anhaenger, Versionsreihenfolge, WLAN-Pruefung, Katalog), http.py, urls.py und shared.py. Drei Unterschiede zu ninlight, alle aus der Firmware heraus: * Verglichen wird device_type - die Platine -, nicht product. Letzteres ist bei allen Platinen 'ninstrip'; die Abbilder unterscheiden sich aber hart, die K1Y invertiert das Datensignal und die KL-RGBC3 nicht. Firmware ohne dieses Feld bekommt gar kein Angebot. * Die WLAN-Pruefung sucht die SSID unverpackt: ein ESP32-Abbild ist nicht gzip-verpackt wie das des W600. An einem mit sdkconfig.local gebauten Abbild gegengeprueft - die SSID steht genau einmal NUL-gerahmt drin. * Der Fehlerschluessel heisst device_url_too_long statt lamp_url_too_long. Dazu das Testgeruest, das es hier bisher gar nicht gab: 204 Tests in tests_unit/ (ohne HA-Instanz) und tests/ (mit), Abdeckung 97 %, dazu scripts/check.sh als Ersatz fuer die fehlende CI. Die Nutzdaten in tests_unit/samples.py sind an der Stehlampe abgefragt. Beim Gegenpruefen per Mutation fiel auf, dass die Platinenpruefung unmittelbar vor dem Senden ungeprueft war - der Test dazu ist jetzt da und faellt, wenn man die Pruefung entfernt.
69 lines
2.3 KiB
Python
69 lines
2.3 KiB
Python
"""Diagnose-Binaersensoren eines ninstrip-Geraets: Zustand des sACN-Empfangs."""
|
|
|
|
from __future__ import annotations
|
|
|
|
from homeassistant.components.binary_sensor import BinarySensorEntity
|
|
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
|
|
|
|
PARALLEL_UPDATES = 0
|
|
|
|
|
|
async def async_setup_entry(
|
|
hass: HomeAssistant,
|
|
entry: NinstripConfigEntry,
|
|
async_add_entities: AddConfigEntryEntitiesCallback,
|
|
) -> None:
|
|
coordinator = entry.runtime_data
|
|
async_add_entities([NinstripSacnActive(coordinator), NinstripSacnMulticast(coordinator)])
|
|
|
|
|
|
class _NinstripSacnInfo(NinstripEntity, BinarySensorEntity):
|
|
"""Basis fuer die beiden Merker unter system/info -> sacn."""
|
|
|
|
_attr_entity_category = EntityCategory.DIAGNOSTIC
|
|
_field: str
|
|
|
|
@property
|
|
def available(self) -> bool:
|
|
return super().available and self.coordinator.data.sacn_info is not None
|
|
|
|
@property
|
|
def is_on(self) -> bool:
|
|
return bool((self.coordinator.data.sacn_info or {}).get(self._field))
|
|
|
|
|
|
class NinstripSacnActive(_NinstripSacnInfo):
|
|
"""An, solange ein Sender das Bild bestimmt - auch in der Haltephase."""
|
|
|
|
_attr_translation_key = "sacn_active"
|
|
_field = "active"
|
|
|
|
def __init__(self, coordinator: NinstripCoordinator) -> None:
|
|
super().__init__(coordinator, "sacn_active")
|
|
|
|
|
|
class NinstripSacnMulticast(_NinstripSacnInfo):
|
|
"""An, wenn der Beitritt zu allen Multicast-Gruppen gelang.
|
|
|
|
Standardmaessig aus, wie bei ha-ninlight: im Normalbetrieb steht er auf
|
|
"an" und verdient seinen Platz erst, wenn Multicast nicht ankommt. Bei
|
|
ninlight hat eine falsche Gruppenadresse zwei Abende Suche gekostet - hier
|
|
zeigt es sich.
|
|
|
|
Achtung: "an" heisst nur, dass das GERAET beigetreten ist. Ob das Netz
|
|
die Gruppe weiterreicht, steht auf einem anderen Blatt - ueber eine
|
|
VLAN-Grenze kommt Multicast ohne Multicast-Router nie an.
|
|
"""
|
|
|
|
_attr_translation_key = "sacn_multicast"
|
|
_attr_entity_registry_enabled_default = False
|
|
_field = "multicast"
|
|
|
|
def __init__(self, coordinator: NinstripCoordinator) -> None:
|
|
super().__init__(coordinator, "sacn_multicast")
|