Versions Compared

Key

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

Within the BMS NETx Server we can split up complex KNX data point types to into different sub fields. For example, to activate the sub fields for a 1 byte DALI object, open the Telegram Definition, select the corresponding group address(es) and change the data type to: 238.600 DALI_Diagnostics.

...

First, the DPT has to be defined in the nxaKNXDataTypeDefinitions.xml file (see XML format description in the section below):

Custom DPT
Code Block
languagexml
titleCustom DPT
<data_type name="Custom.001" descr="CustomeDPT" length_type="1BYTE" set_flag="T">
  <sub_type id="Scene" desc="Scene Number" start_index="0" length="6" length_type="1BYTE" input_type="EIS14" su="U" output_type="UINT8" unit="" pre_offset="0" post_offset="0" scale="1" min_max="" />
  <sub_type id="SA" desc="Scene Activation" start_index="6" length="1" length_type="1BIT" input_type="EIS1" su="" output_type="BOOL" unit="" pre_offset="0" post_offset="0" scale="1" min_max="" />
  <sub_type id="S" desc="BStorage function" start_index="7" length="1" length_type="1BIT" input_type="EIS1" su="" output_type="BOOL" unit="" pre_offset="0" post_offset="0" scale="1" min_max="" />
</data_type>

Now that the custom DPT is defined it has be announced in the BMS Studio's configuration file for telegram definitions, which can be found in <install-dir>\System\Definitions\nxaTelegramDefinitions.35.tvd.

In the Data Type line, the new Definition of the DPT should be inserted following the format <Data_Type Length_Type>|<Data<Data_Type Name>@<Data_Type Descr>. In our example the definition will be like the following:Image Removed

...

After saving the custom DPT in nxaKNXDataTypeDefinitions.xml and the modified nxaTelegramDefinitions.35.tvd the BMS Studio needs to be restarted to be aware of the new DPT. After that the new DPT is ready to use in the telegram definition table:Image Removed

...

XML format description

data_type attributes

Description

name

The name of the custom DPT which will be used later.

descr

Data type description.

length_type

Type length of DPT, 1BIT, 2BIT, 4BIT, 1BYTE, 2BYTE, etc.

set_flag

Set the DPT flag.

sub_type attributes

Description

id

The ID of the Sub_Type.

desc

Sub_Type description.

start_index

The start index of the Sub_Type.

(Warnung)

(warning) The most right bit's position is 0

length

The length of the Sub_Type in bits.

length_type

The length type of the Sub_Type.

input_type

The input type EIS1, EIS2, EIS5, etc....

su

S (signed) or U (unsigned); default is signed

output_type

The Sub_Type output type.

unit

The Sub_Type unit type °C, K/h, m/s, %, etc...

pre_offset

offset to be added before scaling

post_offset

offset to be added after scaling

scale

Sub_Type scaling factor

min_max

define the min and max value e.g. "0:10" min is 0 and max is 10.

Article applies to the following products:

  • NETx BMS Platform

  • NETx Multi Protocol Server

  • NETx BMS Server 2.0