Integrationen

KNX einrichten

KNX über Home Assistant/ioBroker oder per lokaler IP-Bridge überwachen.

Voraussetzungen

• KNX/IP-Interface oder Router im lokalen Netz
• Dokumentierte Gruppenadressen und Datenpunkttypen
• HomePulse-KNX-Integration und API-Key

Schritt für Schritt

1. Wähle in ETS nur Kommunikationsobjekte, die Systemgesundheit abbilden.
2. Lege je Gruppenadresse einen pseudonymen externalId-Wert an.
3. Nutze den Home-Assistant-/ioBroker-Connector oder die lokale xknx-Bridge.
4. Sende jede Minute einen Bridge-Heartbeat und bei Änderungen einen Snapshot.
5. Trenne Bus-Fehler, Gateway-Fehler und fachliche Zustände in der Diagnose.

Beispielkonfiguration

# /etc/homepulse-knx.env (chmod 600)
HOMEPULSE_URL=https://www.homepulse.at
HOMEPULSE_SITE_ID=DEINE-STANDORT-GUID
HOMEPULSE_API_KEY=hp_live_DEIN_KEY
KNX_GATEWAY=192.168.1.20

# Mapping (Beispiel, projektbezogen anpassen)
items:
  - group_address: "0/0/1"
    external_id: "knx.gateway.bus_alive"
    name: "KNX Buskoppler"
    dpt: "1.001"
    kind: "service"
    critical: true
  - group_address: "2/1/15"
    external_id: "knx.heating.flow_temperature"
    name: "Heizkreis Vorlauf"
    dpt: "9.001"
    kind: "sensor"

Testschritt

Zuerst POST /api/ingest/knx/verify aufrufen. Danach eine bekannte Gruppenadresse lesen und Snapshot/letzten Kontakt vergleichen.

Erwartetes Ergebnis

Gateway-Heartbeat ist gesund; jede konfigurierte Gruppenadresse erscheint mit Zeitstempel und verständlichem Namen.

Empfohlenes Mapping

Fehlerbehebung

• Keine Busverbindung: Individualadresse, Tunneling-Slot und Routing/Multicast prüfen.
• Wert unplausibel: DPT und Byte-Reihenfolge mit ETS-Dokumentation abgleichen.
• Stale-Zustand: Lese-Flag und zyklisches Senden des Kommunikationsobjekts prüfen.

Sicherheitshinweise

• KNX/IP niemals direkt aus dem Internet erreichbar machen.
• Gruppenadressen verraten Gebäudestruktur – nur notwendige Objekte und Pseudonyme senden.
• Direkt-Bridge als eigener unprivilegierter Dienst; Secrets-Datei chmod 600.