Page tree

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

KNX protocol

Supported device types and versions 
Communication line configuration
Line protocol parameters
Communication station configuration
I/O tag configuration
Literature
Changes and modifications
Document revisions

Anchor
typy_verzie
typy_verzie
Supported device types and versions

...

The KNX protocol is an open standard used in building automation. The KNX implementation uses the Falcon SDK developed by the KNX association. Since this SDK is developed in C #C#, the connection to the D2000 KOM process is handled by a separate module d2knx, which by default is located in the protdll directory and communicates with the D2000 KOM process via a TCP connection.
For each communication line on which there are stations with KNX protocol, it is necessary to run one instance of the d2knx module, which requires a separate KNX interface. The KNX interface can be connected via the USB interface or can be accessed via network based on its IP address.

...

Examples of manually running d2knx:

  • d2knx 127.0.0.1  4011 debug
  • d2knx 0.0.0.0  4012

Example output (if start without parameters):

EIB/KNX interface module
(c) 2020 Ipesoft
Usage : knx ListenIP ListenPort [debug]
Example: knx 127.0.0.1 4011
Available interfaces:
Device 0 Path \\?\hid#vid_16d0&pid_0490#6&34ad9346&0&0000#{4d1e55b2-f16f-11cf-88cb-001111000030}, Name Tapko USB Interface

...

ParameterMeaningUnit / SizeDefault value


ParameterMeaningUnit / SizeDefault value

Anchor
kd
kd
KNX Driver Program

Configuration of starting the d2knx module by the D2000 KOM process. If this parameter is empty, the d2knx module will not be started (another starting mechanism is assumed).

The parameter contains the following symbolic names:

  • # PROTDIR # - it will be replaced by the path to the protdll directory in the D2000 installation, where d2knx is located by default (e.g. D:\D2000\D2000.EXE\protdll)
  • # BINDIR # - it will be replaced with the path to the bin directory (bin64 in the 64-bit version of D2000 on Windows) in the D2000 installation
  • # HOST # - it will be replaced by the IP address configured on the line (in case of the configuration of several IP addresses, these will be used alternately)
  • # PORT # - it will be replaced by the TCP port number configured on the line
-#PROTDIR#d2knx #HOST# #PORT#

Anchor
it
it
KNX Interface Type

Type of KNX adapter that the d2knx module opens and with which it communicates via the KNX bus:

  • USB interface by position - from the list of available KNX USB devices, the device at the position defined by the KNX Interface ID parameter (number 0, 1, 2, etc.) is selected
  • USB interface by name - a device whose name contains the text entered by the KNX Interface ID parameter (e.g. "Tapco") is selected from the list of available KNX USB devices
  • USB interface by path - from the list of available KNX USB devices, a device whose path contains the text specified by the KNX Interface ID parameter is selected (e.g. "4d1e55b2")
  • IP interface (IP address, port, protocol, NAT) - the device whose IP address is in the KNX Interface ID parameter is used
-USB interface by position

Anchor
iid
iid
KNX Interface ID

Identification of the KNX adapter to be opened, which depends on the selected KNX interface type - see the description of the KNX Interface Type parameter. This can be the serial number of the USB interface, part of its name or path, or the IP address of the KNX router.

-0

Anchor
ipp
ipp
IP Interface Port

If KNX Interface ID = "IP interface", then this parameter specifies the port number (TCP or UDP) on which the KNX router communicates. The default port number is 3671.

-3671

Anchor
ipl
ipl
IP Interface Protocol

If KNX Interface ID = "IP interface", then this parameter indicates whether UDP or TCP protocol is used for communication with the KNX router:

  • Automatic - automatic detection (default)
  • UDP - UDP protocol will be used
  • TCP - TCP protocol will be used

Automatic
UDP
TCP

Automatic

Anchor
nat
nat
IP Interface NAT

If KNX Interface ID = "IP interface" and communication goes via the UDP protocol, this parameter specifies whether address translation (NAT) is to be used for communication.

YES/NONO

Anchor
ia
ia
KNX Interface Address (x.y.z)

KNX address that can be set on the KNX interface after opening it. If not specified, the existing KNX interface address is used.
The KNX address has the format area.line.device (e.g. 1.3.99) where the area is 0..15, the line is 0..15, the device is 0..255.

--

Anchor
sk
sk
Security Keys

The name of the security key file. If secure group communication is used, this file (so-called keyring file - * .knxkeys) can be exported from the ETS configuration tool, which is available on the KNX asociácie's website.

The parameter contains the following symbolic names:

  • # APPDIR # - it will be replaced by the path to the application directory (e.g. D:\D2000\D2000.APP\myapp\)
    Examples:
    #APPDIR#myfile.knxkeys
    D:\keys.knxkeys
--

Anchor
sp
sp
Security Password

A password to access the security key file.
Note: If secure communication is used, both Security Keys and Security Password must be specified.

--

Anchor
dd
dd
Driver Debug

This parameter activates the d2knx module debugging information.

Zapnutie ladiacich informácii modulu d2knx.

YES/NONO

Anchor
fd
fd
Full Debug

This parameter activates the debugging information about the read/written values.

YES/NONO


Anchor
komunikacna_stanica
komunikacna_stanica
Communication station configuration

...

The following station parameters can be set:

ParameterMeaningUnit / SizeDefault value

Anchor
rga
rga
Read Group Addresses

Method of explicit reading of I/O tags of type Group address:

  • Never - I/O tags are never read explicitly, only spontaneously received values are collected
  • Once - I/O tags are read explicitly only after the start (or restart) of the communication
  • Always - I/O tags are read explicitly in each reading cycle (according to the setting of time parameters of the station)
Never
Once
Always
Once

Anchor
rgp
rgp
Read Group Priority

Reading priority used for explicit reading of I/O tags of type Group address:

  • System (0)
  • High (1)
  • Alarm (2)
  • Low (3)
-Low

Anchor
rgt
rgt
Read Group Timeout

Timeout for the response when explicitly reading I/O tags of type Group address. Allowed values are 0-60000 ms.
A value of 0 means the default timeout defined by the KNX driver.

ms0

Anchor
merany_bod
merany_bod
I/O tag configuration

...