KNX für Home Assistant (eingebaute Integration)

Überblick

KNX ist eine in Home Assistant integrierte Integration, die sich über IP mit einem KNX-Bus verbindet und lokal arbeitet. Sie unterstützt Tunneling- und Routing-Verbindungen, einschließlich KNX IP Secure und Data Secure mit einer aus ETS exportierten Keyring-Datei. Sie stellt Entitätenplattformen wie Lichter, Klima, Abdeckungen, Sensoren, Schalter, Ventilatoren, Wetter und einige weitere bereit. Aktionen können Daten an den Bus senden, Gruppenadressen lesen, Werte für den Bus bereitstellen, Adressen für die Auslösung von Ereignissen registrieren und die Integration neu laden. Diagnosesensoren melden den Verbindungsstatus, den Verbindungstyp, die individuelle Adresse und den Telegrammverkehr, und ein Geräteauslöser für Telegramme kann Automationen starten. Die Optionen betreffen die Ratenbegrenzung, das Verhalten beim Lesen von Zuständen und die Speicherung des Telegrammverlaufs, auch mit einem PostgreSQL-Backend, und die Einrichtung erfolgt in der Benutzeroberfläche.

Zusammenfassung des Quellcodes von Home Assistant, automatisch erstellt und übersetzt. Stimmt etwas nicht? Melde dich

Unterstützt

Funktioniert lokal Spricht mit deinen Geräten in deinem eigenen Netzwerk. Keine Cloud des Herstellers dazwischen.
Einrichtung in der Benutzeroberfläche Füge sie unter Einstellungen > Geräte & Dienste hinzu. Kein Download nötig.
Geräteauslöser Die Geräte können Automationen direkt starten.
Einstellungen später ändern Die Verbindungseinstellungen lassen sich ändern, ohne die Integration zu entfernen.
Qualitätsstufe Platin Die eigene Bewertung von Home Assistant für Code und Einrichtung der Integration.
Mit Home Assistant aktualisiert Kommt mit jeder Version von Home Assistant und wird mit ihr aktualisiert.

Stellt bereit

Lichter
Klima
Ventilatoren
Abdeckungen
Schalter
Sensoren
Wetter

Einrichtung

Sie wird unter Einstellungen > Geräte & Dienste über „Integration hinzufügen“ eingerichtet.

KNX-Verbindung

KNX-VerbindungstypBitte wähle die Verbindungsart aus, die du für deine KNX-Verbindung verwenden möchtest.

Tunnelendpunkt

Wähle den für die Verbindung verwendeten Tunnelendpunkt aus.Automatisch sucht beim Verbinden einen freien Tunnelendpunkt für dich aus. Wenn du dir unsicher bist, ist das die beste Option.

Wird auch bei „Tunnelendpunkt“ abgefragt.

Tunnel-Einstellungen

HostIP-Adresse oder Hostname des KNX/IP-Tunneling-Geräts.
Lokale IP-SchnittstelleLokale IP oder Schnittstellenname, der für die Verbindung von Home Assistant verwendet wird. Lasse das Feld leer, um die automatische Erkennung zu verwenden.
PortVon der KNX/IP-Tunneling-Schnittstelle verwendeter Port.
Route back / NAT-ModusAktiviere diese Option, wenn sich dein KNXnet/IP-Tunnelserver hinter NAT befindet. Gilt nur für UDP-Verbindungen.
KNX-Tunneling-TypWähle den Tunneltyp deiner KNX-Tunnel-Schnittstelle. Ältere Schnittstellen unterstützen möglicherweise nur UDP.

Routing

Physikalische AdresseKNX-Adresse, die von Home Assistant verwendet werden soll, z. B. 0.0.4.
Lokale IP-SchnittstelleLokale IP oder Schnittstellenname, der für die Verbindung von Home Assistant verwendet wird. Lasse das Feld leer, um die automatische Erkennung zu verwenden.
Multicast-GruppeVon deiner Installation verwendete Multicast-Gruppe. Standard ist 224.0.23.12
Multicast-PortVon deiner Installation verwendeter Multicast-Port. Standard ist 3671
KNX IP-Secure-RoutingWähle aus, ob deine Installation verschlüsselte Kommunikation gemäß dem KNX IP-Secure-Standard verwendet. Diese Einstellung erfordert kompatible Geräte und eine entsprechende Konfiguration. Im nächsten Schritt wirst du nach Zugangsdaten gefragt.

KNX-Schlüsselbund importieren

Schlüsselbund-DateiWähle eine .knxkeys-Datei aus. Diese kann aus ETS exportiert werden.
Schlüsselbund-PasswortDas Passwort zum Öffnen der .knxkeys-Datei wurde beim Export festgelegt.

Secure Routing

Backbone-SchlüsselKann im „Sicherheits“-Bericht deines ETS-Projekts angezeigt werden. Beispiel: 00112233445566778899AABBCCDDEEFF
Netzwerklatenz-ToleranzSollte der Backbone-Konfiguration deines ETS-Projekts entsprechen. Der Standardwert ist 1000

Sicheres Tunneling

Geräte-AuthentifizierungscodeDies wird im Feld „IP“ der Schnittstelle in ETS eingestellt.
Benutzer-IDDies entspricht normalerweise der Tunnel-Nummer +1. Der erste Tunnel in der von ETS angezeigten Liste hätte also die Benutzer-ID 2.
Benutzer-PasswortPasswort für die spezifische Tunnelverbindung, die im Bereich „Eigenschaften“ des Tunnels in ETS festgelegt wurde.

Nach der Einrichtung

RatenlimitMaximale Anzahl ausgehender Telegramme pro Sekunde. 0 deaktiviert die Begrenzung. Empfohlen: 0 oder 20 bis 40
Status-UpdaterLegt das Standardverhalten zum Lesen von Zustandsadressen vom KNX-Bus fest. Wenn aktiviert, überwacht Home Assistant jede Gruppenadresse und liest sie vom Bus, wenn eine Stunde lang kein Wert empfangen wurde. Wenn deaktiviert, werden Zustandsadressen nur einmal gelesen, nachdem eine Busverbindung hergestellt wurde. Dieses Verhalten kann für einzelne Entitäten mit der Option sync_state überschrieben werden.
Telegramm-Speicher-BackendWähle aus, wo der KNX-Telegrammverlauf gespeichert werden soll.
Gruppenmonitor-VerlaufAnzahl Stunden des Telegramm-Verlaufs, die beim Öffnen des Gruppenmonitors geladen werden sollen.
AufbewahrungsfristAnzahl der Tage, für die der Telegramm-Verlauf gespeichert werden soll. Ältere Telegramme werden jede Nacht um 3 Uhr automatisch gelöscht. Setze den Wert auf 0, um den gesamten Telegramm-Verlauf bei jedem nächtlichen Durchlauf zu löschen.
DatenbanknameName der Datenbank, in der Telegramme gespeichert werden sollen.
HostHostname oder IP-Adresse des PostgreSQL-Servers.
PasswortPasswort für den PostgreSQL-Benutzer. Feld leer lassen, um das aktuelle Passwort beizubehalten.
PortDer Port, auf dem der PostgreSQL-Server auf Verbindungen wartet.
TLS verwendenDie Verbindung zum PostgreSQL-Server verschlüsseln (sslmode=require). Beachte, dass das Serverzertifikat nicht überprüft wird.
BenutzernameBenutzername zur Authentifizierung am PostgreSQL-Server.

Texte aus dem Quellcode von Home Assistant, Apache License 2.0.

Entitäten

SensorenVerbindung hergestellt, Verbindungstyp, Physikalische Adresse, Telegramme, Nicht decodierbare Data-Secure-Telegramme, Empfangene Telegramme, Empfangsfehler, Gesendete Telegramme, Sendefehler

Aktionen

knx_event registrierenFügt Gruppenadressen zum knx_event-Filter hinzu oder entfernt sie, um knx_events auszulösen. Nur mit dieser Aktion hinzugefügte Adressen können entfernt werden.Felder: Gruppenadresse, Event-Registrierung entfernen, Datentyp
An KNX-Bus weiterleitenFügt Weiterleitungen zum KNX-Bus hinzu oder entfernt sie. Nur mit dieser Aktion hinzugefügte Weiterleitungen können entfernt werden.Felder: Gruppenadresse, Entitätsattribut, Standardwert, Entität, Weiterleitung entfernen, Datentyp
Vom KNX-Bus lesenSendet GroupValueRead-Anfragen an den KNX-Bus. Die Antwort kann von knx_event verwendet werden und wird in KNX-Entitäten verarbeitet. Wenn Antwortdaten angefordert werden, wartet die Aktion auf die Antwort für eine einzelne Gruppenadresse und gibt diese zurück.Felder: Gruppenadresse
Neu ladenLädt die KNX-Integration neu
An KNX-Bus sendenSendet beliebige Daten direkt an den KNX-Bus.Felder: Gruppenadresse, Nutzdaten, Als Antwort senden, Datentyp

Fehlerbehebung

DiagnosedatenLädt eine Diagnosedatei herunter, die du an einen Fehlerbericht anhängen kannst.
ReparaturhinweiseMögliche Hinweise unter Einstellungen > Reparaturen:KNX Data Secure-Telegramme können nicht entschlüsselt werden, Ungültige KNX-Entitätskonfiguration, Fehler des KNX-Telegrammspeichers