NetLinx Programming
20
NXB-KNX KNX Communications Gateway
AMX_NXB_MOD Module
The
AMX_NXB_MOD
module is provided to facilitate remote logging from NXB-KNX as well as the "List Save" and
"List Load" functions.
The AMX_NXB_MOD module is integrated with the source code as follows:
DEFINE_MODULE 'AMX_NXB_MOD' nxbMod(dvKNX)
The parameters are as follows:
dvKNX
- the physical interface for NXB-KNX, as a NetLinx D:P:S address
AMX_KNX_Updater Module
The
AMX_KNX_Updater
module is optional, and is provided to support implementations (e.g. legacy CommTec
projects) that use array values for feedback control.
The AMX_KNX_Updater module is integrated with the source code as follows:
DEFINE_MODULE 'AMX_KNX_Updater' Updater(dvKNX, lKNX_Value)
The parameters are as follows:
dvKNX
- the physical interface for NXB-KNX, as a NetLinx D:P:S address
1KNX_Value
- the central value array of the KNX actuators (type LONG!). No strict size is required for the
array: it should be sized appropriately for site-specific optimal performance.
The
1KNX_Value
array should be defined in the DEFINE_VARIABLE section:
DEFINE_VARIABLE
...
LONG lKNX_Value[3000]
...
Accessing Actuators On the KNX Bus
To access actuators on the bus, KNX Destination Addresses must be configured on the NXB-KNX. This is done via the
KNX_Table.axi
file (included). This include file maps the Destination Address, type, poll conjunction and additional
features to an
actor number
between 1 and 3000. Communication with the actuators is accomplished via this actor
number.
KNX_Table.axi Include File
The
KNX_Table.axi
file contains the definition of all actuators on the KNX bus that will be controlled or monitored by
the NetLinx system, and is integrated in to NetLinx code via the following source code line:
#INCLUDE 'KNX_Table.axi'
Refer to the
Sample Program
section on page 30 for more information on the KNX Table and to review sample programs
that illustrate the following:
Structure of KNX Table With Functions From
KNX_Tools.axi
(see page 30)
Structure of KNX-Table with SEND_COMMANDS (see page 32)
KNX_Tools.axi Include File
Additionally, the
KNX_Tools.axi
file should be integrated to have easy access to commonly used functions, and is
integrated in to NetLinx code via the following source code line:
#INCLUDE 'KNX_Tools.axi'
Refer to the
KNX_Tools.axi
section on page 35 for more information, including a listing of the functions available in
KNX_Tools.axi
.
the NXB-KNX supports channels and levels for each actuator. The Updater module is
provided to support legacy NetLinx code (which was designed to work with the
CommTec EIB device). Moving forward the Updater module could and should be
replaced with channel and level event driven feedback from the NXB-KNX, rather
than referencing the lKNX_Value array.