Skip to content

feat: USB actuator gateway with Home Assistant MQTT discovery - #16

Draft
volschin wants to merge 1 commit into
RFD-FHEM:feat/sensor-decodingfrom
volschin:feat/homeassistant-usb-gateway
Draft

volschin wants to merge 1 commit into
RFD-FHEM:feat/sensor-decodingfrom
volschin:feat/homeassistant-usb-gateway

Conversation

@volschin

@volschin volschin commented Nov 17, 2026 •

Copy link
Copy Markdown

Dieser PR ergänzt einen eigenständig nutzbaren USB-zu-MQTT-Gateway für Home Assistant: IT-v3-Geräte werden als Switches, A-OK AC114-01B als Cover aus echten empfangenen Telegrammen gelernt und per MQTT Discovery angelegt.

Basis und Architektur

Aufbauend auf #15, aktuell d7820836633111ae3c1bf332fcc5b8a6498029f3. Deshalb ist das Ziel vorerst feat/sensor-decoding: Der Diff enthält nur diese Ergänzungen und dupliziert nicht die Änderungen aus #15. Nach dessen Integration kann der PR auf main umgestellt werden. #14 wurde ebenfalls geprüft; dessen abweichendes FHEM-Ausgabemodell wird nicht übernommen.

Die native Decoder-Registry und SensorEvent aus ADR-006 werden wiederverwendet. Protokollinterpretation liegt unter decoders/custom/, der Home-Assistant-Formatter unter output/ ist rein funktional, und die MQTT-Laufzeit wird separat mit python -m signalduino.homeassistant gewählt. Das bestehende Raw/FHEM-Hauptprogramm bleibt verfügbar. Proposal und vorgeschlagenes ADR-008 sind zur Architekturabstimmung enthalten; Architecture-Owner-Review ist ausdrücklich offen.

Enthalten

  • Vollständiger asynchroner USB-Transport, Paket-Unterverzeichnisse/JSON-Daten, Verarbeitung aller Parser-Ergebnisse und Ressourcenfreigabe bei abgebrochener Initialisierung.
  • IT-v3/protocol 17 und A-OK/protocol 56: validierte Adressen/Kanäle/Prüfsummen, stabile IDs und native begrenzte SR-Sendekodierung.
  • Automatisches Lernen ohne Geräteliste/FHEM-Abhängigkeit, retained Discovery und minimale Routing-Deskriptoren, Wiederherstellung und HA-Birth-Rediscovery.
  • Abweisung gespeicherter und live-retained Befehle; ungültige Geräte-/Befehlsdaten werden verworfen. Deskriptor-JSON ist auf 512 Bytes begrenzt; ein Regressionstest weist nach, dass verschachtelte Eingaben nachfolgendes Lernen nicht beenden.
  • MQTT5-PUBACK-Fehler, Disconnect-with-Will, Firmware-Heartbeat, Reconnect, Docker-Health und Prometheus-Metriken.
  • Optionaler nicht privilegierter Alpine-Container mit festgelegten Abhängigkeiten sowie isolierte Container-/Mosquitto-CI.

Es handelt sich um Einweg-Funkprotokolle. Empfangene Aktionen und native optimistische HA-Zustände sind keine gemessene Position oder physische Bestätigung. Prozentposition, Fahrzeit und Rückmeldung werden nicht erfunden. Andere SD_UT-Modelle/IT v1 werden nicht als unterstützt beworben.

Verifikation

  • Vollständige Suite im dokumentierten Projekt-Devcontainer: 415 passed, zusätzlich 14 Subtests; neue Komponenten 84,48 % Coverage einschließlich Branches.
  • Installiertes Alpine-Image, UID/GID 1000, read-only und ohne Capabilities: 25 Gateway-Tests bestanden, einschließlich echtem isoliertem Mosquitto und Pseudo-Terminal-Serial.
  • Scoped Black, Ruff und mypy für die neuen Module bestanden. Unabhängiger Review; beide gefundenen Punkte (verschachteltes JSON und Dokumentation optimistischer HA-Zustände) wurden mit Regression bzw. Klarstellung erledigt.
  • Die zugrunde liegende Implementierung hat mit einem echten Radino/CC1101 und SIGNALduino 4.0.0 durch A-OK-Funkempfang in Home Assistant 2026.11.2 automatisch ein Gerät/Cover angelegt. Empfangener Zustand sowie Verfügbarkeit und stabile IDs nach Stop/Restart wurden geprüft.
  • Auch der hier gebaute Upstream-Port wurde am echten USB-Stick und Broker gestartet: Heartbeat, Wiederherstellung des bereits gelernten Geräts und unveränderte HA-IDs waren erfolgreich. Das wird nicht als neuer RF-Empfang durch diesen Build ausgegeben.
  • Physischer IT-Empfang und Produktions-Aktorbefehle wurden nicht getestet; IT-Decoder, Encoder und Discovery-Konfiguration haben automatisierte Tests.

Es werden keine umgebungsspezifischen Cluster-Manifeste, produktiven Brokerdaten oder Zugangsdaten eingebracht. Dieser PR veröffentlicht kein Container-Image und ändert keine Firmware.

GitHub-CI-Status am eingereichten Head: Workflow-Lauf mit action_required; die Ausführung des Fork-Beitrags wartet auf Maintainer-Freigabe. Die oben genannten lokalen Prüfungen wurden bereits vollständig ausgeführt.

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant