Versions Compared

Key

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

Location: <WorkspaceDirectory>\DataFiles\nxaTelegramDefinitions.40.dat

Within this configuration files, the KNX datapoints i.e. the KNX group addresses are specified. 

Each line – except comment lines that start with ' – defines a single KNX group address.

Info

! This definition file can also be generated using the ETS app import wizard (Studio > KNX > Import NETx ETS App file...) which generates the KNX group address definitions from an exported ETS project.

The structure of the definition file is as follows:

Col#ParameterDescription
1KNX grp. adr.It defines the KNX group address of the data point. The KNX group address can be specified either in three level form (e.g. 0/2/1) or in tow level form (e.g. 0/513).
2KNX gateway name

It specifies the name of the KNXnet/IP device to which the specified KNX group address is assigned. Thus, it defines KNXnet/IP device that is used to send and receive KNX telegrams that are originated to this group address. The name "BROADCAST" defines a KNX data point which is sent to all defined gateways.

Info
! The KNX group address together with the name of the KNXnet/IP device define the effective address of the KNX data point. This effective address is internally used by the server. Using this addressing scheme, it is possible to use the same KNX group address for multiple KNX data points as long as they are assigned to different KNXnet/IP devices. This means that behind each gateway an independent ETS address space can exist. 


3PriorityIt defines the KNX priority that is used to send KNX group telegrams. Possible values are SYSTEM, HIGH, ALARM and LOW. The standard value "LOW" should be used in general.


Info

...

Columns 4 to 7 define how to interpret the received data of a KNX data point. At least two of these attributes has to defined to specify the semantic of a data point. All possible combinations are listed in the data type table.


4Data SizeIt defines the size of the data point. Possible values are: 1BIT, 2BIT, 4BIT, 1BYTE, 2BYTE, 3BYTE, 4BYTE, 5BYTE, 6BYTE, 7BYTE, 8BYTE, 10BYTE, 14BYTE.
5Data TypeUsing this column, the data types is specify by defining the standardized KNX data point type (KNX DPT). As an alternative, the old EIS types can be selected too.
6SigningOnly for EIS types: this attribute specifies whether the data type is a signed or unsigned one.
7UnitOnly for EIS types: it defines engineering units of the KNX data point. 
8DescriptionThis attribute can be used to specify a human-readable text that further describes the data point.
9Read on ReconnectThis attribute is used to define whether a KNX Read telegram shall be sent when the corresponding KNXnet/IP gateway reconnects or when the server is started. If this functionality is activated, the read flag has to be set within the corresponding KNX device using ETS.
10Read Cyclically IntervalThis attributed is used to define whether cyclic KNX Read telegrams be sent to retrieve the current value of the data point. If this functionality is activated, the read flag has to be set within the corresponding KNX device using ETS. Note that cyclically reading KNX data points consumes bandwidth within the KNX lines. The allowed maximum Value is 65535 s with is identical to 18,20 h.
11PersistentThis parameter specifies whether the value of the data point is persistent (restored from the database after server start up ) or not.
12SynchronizeIf this parameter is set to "True (T)", the value is synchronized between the main and backup server (if present). This will work only if main/backup configuration is activated for the NETx BMS Core Server.