20 lines
1.6 KiB
Markdown
20 lines
1.6 KiB
Markdown
# Connectoren ontwikkelen
|
|
|
|
Alle hardware- en netwerkbronnen implementeren de connectorcontracten onder lumaops/backend/src/lumaops_backend/connectors. De rest van backend en frontend werkt alleen met genormaliseerde Device, DeviceState, Capabilities en ConnectorHealth-objecten.
|
|
|
|
Een connector levert minimaal id, kind, configuratieschema, start/stop, discovery, inventory, state lezen/schrijven, connectietest, health en identify. Fouten worden vertaald naar stabiele LumaOps-foutcategorieën. Secrets worden via SecretStore versleuteld en verschijnen nooit in configschema, logs of responses.
|
|
|
|
Ontwikkelvolgorde:
|
|
|
|
1. Voeg modellen en adapter toe zonder merkcode in de UI.
|
|
2. Normaliseer stabiele identiteit met bron, vendor/model, serienummer, locatie of netwerkidentiteit; gebruik nooit alleen een lijstindex.
|
|
3. Declareer capabilities conservatief en stuur geen niet-ondersteunde velden.
|
|
4. Voeg timeouts, begrensde reconnect-backoff, rate limiting en health toe.
|
|
5. Schrijf contracttests, parserfixtures en fouttests.
|
|
6. Registreer de connector in ConnectorRegistry en toon hem automatisch via /api/v1/connectors.
|
|
|
|
OpenRGB is de referentie-implementatie. De packetcodec is geïsoleerd in connectors/openrgb/protocol.py en de async I/O in adapter.py. Een nieuwe connector mag die binaire details niet naar services lekken.
|
|
|
|
WLED en Home Assistant zijn de eerste geplande uitbreidingen. Detecteer dubbele eigenaars voor WLED via DDP/E1.31 en laat owner één van openrgb, native, home_assistant of unmanaged zijn. MQTT, ESPHome, HTTP en remote agents passen in hetzelfde contract.
|
|
|