MQTT und Home Assistant

MQTT Home Assistant und Homematic

Aktueller Stand 16.10.2026

Verbindlich: main@8fb581b730f7a3833566c4bbb7c87875ad921e69; veröffentlicht bleibt v1.9.0. PR #74–#97 sind integriert. Deployment/Discovery, Imagebuilder, Pi-VPN und Syslog sind auf main, nicht mehr nur historische Vorschau. 26 reguläre Rollen einschließlich Deployment-VM; Provisioning ist optional zusätzlich.

Betreiberbestätigt: KDE-Boot, Rufe, SDS, Aufnahme/RF-Wiedergabe und WLAN am 13.10.; 28/28 Discovery-Agenten aktualisiert und keine ungeklärten Remote-Aufträge mehr am 15.10. Ein aktueller Backend-Gesamtrollout, NAS-Entlastung, SIP/Telegram, VPN-Wechsel und Dauerlauf bleiben separat offen. Vier alte Git-/Timeoutfehler bleiben Fehler.

Gesamtroadmap · Upstream-Vergleich · Roadmap und Releases. NETCORE-IAM-01 ist weiterhin Planung; AD-SSO-Pilot und Gruppenmapping sind konkretisiert, Produkt-/Betriebsentscheidung und Umsetzung offen.

Volle Outbox und Rückdruck

PR #83 repariert den Start bei voller Outbox. Der Betreiber bestätigt HTTP live, MQTT verbunden und später 4/4 gesunde Quellen mit steigenden PUBACKs; die Outbox blieb dabei knapp 20.000. Das belegt keinen nachhaltigen Rückstauabbau. PR #88 ergänzt sofortiges Worker-Wecken, begrenzte sortierte Dateigruppen und events_deferred bei Kapazitätsmangel. Der Testbroker-Durchsatz ist keine Leistungsprognose für den Diensthost.

Übernahme, Brokerdiagnose und Fachprüfung. Übernahme der Folgekorrektur, Abbau unter Zufluss und echte HA-Discovery bleiben offen. MQTT verbunden ist weder HA-Entität noch erfolgreiche SDS→Automation→Ack→SDS-Kette. Aktoren bleiben Default-Deny.

Historischer Seitenstand bis 07.10.2026

Die folgende frühere Fassung bleibt als datierte Historie erhalten. Frühere Dienstzahlen, Featurebranch-Aussagen, offene Tests und Prioritäten sind keine aktuelle Statusaussage; heutige Verfahren stehen oben beziehungsweise in den verlinkten kanonischen Docs.

MQTT, Home Assistant und Homematic

Im zentralen Aufbau sammelt IoT Gateway Ereignisse, veröffentlicht Zustände/Events per MQTT und erzeugt Home-Assistant-Discovery. Die reale Ausführung von HA-/Homematic-Aktionen ist in der Open-Lab-Vorlage standardmäßig gesperrt. Eine verbundene Broker-Session allein bestätigt keinen SDS-Datenweg.

Topic-Vertrag

Muster	Zweck
netcore/v1/events/<domain>/<action>	Ereignisse; nicht retained
netcore/v1/state/<subject-type>/<subject-id>	zuletzt bekannter Zustand; retained
netcore/v1/commands/#	eingehende Befehle, Ledger/Policy
netcore/v1/acks/<command-id>	Lebenszyklusquittungen
homeassistant/<component>/netcore_tetra/<object_id>/config	HA MQTT Discovery; retained
homeassistant/status	HA-Online-Meldung löst erneute Discovery aus
netcore/v1/integrations/homeassistant/state	HA-Zustandsimport nach NetCore
netcore/v1/integrations/homeassistant/command-egress	vorbereiteter, standardmäßig deaktivierter HA-Aktionsausgang

Vollständiger MQTT-Vertrag und HA-Adapter. Die tatsächliche HA-entity_id kann von HA vergeben werden; für Discovery ist unique_id stabiler.

SDS bis zur HA-Entität verfolgen

1. Funk: Eingehende SDS/U-STATUS mit Quelle, Ziel, Zeitpunkt und Inhalt im TBS-Log belegen. 4010001 ist im bestehenden TBS-Kontext eine System-ISSI; sie ist nicht automatisch ein MQTT-Ziel.
2. Routing: Prüfen, ob die Nachricht lokal verarbeitet oder an SDS Router/Backend exportiert wurde; Node Gateway und Service-Matrix müssen erreichbar sein.
3. IoT Gateway: Event-Quelle, Normalisierung, Outbox und Fehlerzähler prüfen. Eine HA-Discovery-Nachricht ist noch keine SDS-Nachricht.
4. Broker: Mit einem zugelassenen Testclient auf dem konkreten Topic abonnieren, z. B. mosquitto_sub -h <BROKER> -t 'netcore/v1/#' -v; Broker-ACL und tatsächlichen topic_prefix beachten.
5. Home Assistant: MQTT-Integration, Discovery-Entity, Sensor-/Automationstrigger und HA-Logs prüfen. Eine Automation verarbeitet nur das Topic/Payload, das sie tatsächlich abonniert.

Bei jedem Schritt dieselbe Test-Nachricht und Zeitreferenz benutzen. Wenn Schritt 1 funktioniert und am Broker nichts ankommt, liegt das Problem vor der HA-Automation. Wenn MQTT Daten zeigt, aber HA nichts, dort Topic, JSON-Schema, Trigger, Retained-Verhalten und Automation-Syntax prüfen. Troubleshooting

Befehle und Homematic

[commands] arbeitet mit default_deny = true, TTL, dedupliziertem Ledger und Acks. Die Beispiel-Policies erlauben nur virtuelle Laborgeräte. Für reale HA-Aktionen braucht es zusätzlich allow_command_egress = true, eine aktive eng gefasste Policy und eine bewusst begrenzte HA-Automation. Bei CCU/RaspberryMatic setzt direkte Schreibbarkeit zusätzlich eine passende Homematic-Konfiguration und pro Datenpunkt writable = true voraus; für Homematic IP Access Point ist die HA-Brücke der dokumentierte Weg.

Das Aktivieren eines HTTP-Managementports oder das Senden einer SDS an eine System-ISSI umgeht diese Grenzen nicht. Security-and-Operations