KNXIO: Unterschied zwischen den Versionen

Aus FHEMWiki
(initial)
(initial)
Zeile 1: Zeile 1:
{{Infobox Modul
|ModPurpose=Unterstützung des KNX Feldbus in FHEM
|ModType=d
|ModForumArea=KNX/EIB
|ModFTopic=
|ModTechName=00_KNXIO.pm
|ModOwner=Erwin ({{Link2FU|115|Forum}}/[[Benutzer Diskussion:Erwin111|Wiki]])
}}
Das Modul [[KNXIO]] implementiert die Unterstützung für den Gebäudeautomations-Feldbus [https://de.wikipedia.org/wiki/KNX-Standard KNX] (eine Weiterentwicklung von EIB) innerhalb von FHEM.
Das Modul [[KNXIO]] implementiert die Unterstützung für den Gebäudeautomations-Feldbus [https://de.wikipedia.org/wiki/KNX-Standard KNX] (eine Weiterentwicklung von EIB) innerhalb von FHEM.


Zeile 7: Zeile 15:
=== Define ===
=== Define ===
<syntaxhighlight lang="text">
<syntaxhighlight lang="text">
define <name> KNXIO <mode> <IP-Adresse/Hostname>:<Port> <Phy-Adresse>
define <name> KNXIO <mode> <IP-Adresse/Hostname>:<Port> <Phy-Adresse> bzw.
define <name> KNXIO S <socket-path> <Phy-Adresse>


</syntaxhighlight>Wie in FHEM üblich, alles was hier zwischen <...> dargestellt ist, sind mandatory Angaben! Optionales wird zwischen [...] dargestellt.  
</syntaxhighlight>Wie in FHEM üblich, alles was hier zwischen <...> dargestellt ist, sind verpflichtende Angaben! Optionales wird zwischen [...] dargestellt.  


==== Definitions-Felder im Detail ====
==== Definitions-Felder im Detail ====


====== Mode: ======
====== 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 Protololl ist sehr kritisch in Bezug auf Timing, Verzögeungen 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.  
* '''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.  
* '''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!  
* '''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 - Funtioneert 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)  
* '''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)  
Alle Parameter sind mandatory! Bitte sicherstellen, dass es nur einen Kommunikationspfad zwischen dem KNX-Gateway und FHEM gibt!


=====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====
====Beispiele====


Version vom 15. Dezember 2021, 23:52 Uhr

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.

Bekannte Probleme

Links

Abgerufen von „http://wiki.fhem.de/w/index.php?title=KNXIO&oldid=36567“