KNXIO
| KNXIO | |
|---|---|
| Zweck / Funktion | |
| Unterstützung des KNX Feldbus in FHEM | |
| Allgemein | |
| Typ | Gerätemodul |
| Details | |
| Dokumentation | EN / DE |
| Support (Forum) | KNX/EIB |
| Modulname | 00_KNXIO.pm |
| Ersteller | Erwin (Forum /Wiki) |
| Wichtig: sofern vorhanden, gilt im Zweifel immer die (englische) Beschreibung in der commandref! | |
Das Modul KNXIO implementiert die Unterstützung für den Gebäudeautomations-Feldbus KNX (eine Weiterentwicklung von EIB) innerhalb von FHEM.
Voraussetzungen
KNX ist in FHEM nach dem 2-stufigen Modell implementiert. Das KNXIO-Modul unterstützt die Kommunikation mit einem KNX-Gateway, der "Aussenwelt", während das KNX-Modul die logische Schniitstelle zum Anwender ist.
Anwendung
Define
define <name> KNXIO <mode> <IP-Adresse/Hostname>:<Port> <Phy-Adresse> bzw.
define <name> KNXIO S <socket-path> <Phy-Adresse>
Wie in FHEM üblich, alles was hier zwischen <...> dargestellt ist, sind verpflichtende Angaben! Optionales wird zwischen [...] dargestellt.
Definitions-Felder im Detail
Mode:
- H -Host Mode: Verbindung zu einem KNX-Gateway mit UDP Point-Point Protokoll. Dieser Modus wird auch von der ETS verwendet (KNXNET/IP). Das Protokoll ist sehr kritisch in Bezug auf Timing, Verzögerungen in FHEM (durch andere Module...) größer 1 Sekunde führen zu Verbindungsabbrüchen! Die Verbindung wird zwar unmittelbar wieder hergestellt, allerdings können einige Messages verloren gehen.
- M -Multicast mode: Verbindung zu knxd-Daemon oder KNX_Router mit multicast Protokoll. Dieser Modus wird auch von der ETS verwendet (KNXNET/Routing). Falls ein KNX_Gateway Multicast unterstützt, braucht man keine knxd Installation! Dieser Modus ist der Nachfolger des KNXTUL-Moduls.
- T -TCP Mode: Verbindet mittels TCP-Protokoll mit knxd - default port: 6720. Dieser Modus ist der Nachfolger des TUL-Moduls.. Eine direkte Unterstützung von Seriellen/USB Gateways ist nicht implementiert!
- S -Socket Mode: Verbindet mittels UNIX_Socket zum knxd - Funtionert nur wenn sowohl FHEM als auch knxd am selben System laufen! Default Socket-path: /var/run/knx (abhängig von installierter knxd Version! Getestet wurde mit knxd-Verion 0.14.30. (Funktioniert definitiv NICHT mit knxd Version 0.10.0)
IP-Adresse/Hostname:Port
Hostnamen sind unterstützt im Mode H und T.
Phy-Adresse
Das ist die Physikalische Adresse, die das KNX-Gateway bzw. knxd für Clients am LAN (also auch FHEM) bereitstellt. Der Wert sollte (bei Verwendung knxd) dem -E Parameter in der knxd-Konfiguration entsprechen.
Alle Parameter sind verpflichtend! Bitte sicherstellen, dass es nur einen Kommunikationspfad zwischen dem KNX-Gateway und FHEM gibt!
Beispiele
Siehe commandref/KNXIO.
Attribute
- disable - ident zum FHEM Standard - ident zum FHEM StandardEmpfangen möglich!
- verbose - ident zum FHEM Standard - bestimmt welche/wieviele Meldungen ins Log geschrieben werden.