Addresses - the communication with the backend

Most widgets require one or more address elements for the communication with the backend to get the information from the KNX bus, OpenHAB or MQTT. The content of the element is the address itself, the attributes control the behavior:

transform

set the datatype at the backend, e.g. DPT:1.001 for the KNX datapoint type 1.001

mode

defines whether the address will only be listened at (read), written to (write) or both (readwrite)

variant

optional and only relevant for some widgets where multiple addresses are required at the same time, e.g. to define the red, green and blue channel for a color

Transform

The “namespace” for the backend specific value for transform is separated by a colon written in front of the data type. The valid values for the different backends are:

KNX

transform

name

description

unit

min

max

DPT:1

1 bit

1 bit

-

0

1

DPT:1.001

DPT_Switch

off on switch

-

0

1

DPT:1.002

DPT_Bool

boolean value

-

0

1

DPT:1.003

DPT_Enable

disable / enable

-

0

1

DPT:1.008

DPT_UpDown

up down switch

-

0

1

DPT:1.009

DPT_OpenClose

open close switch

-

0

1

DPT:2

2 bit

2 bit

-

0

3

DPT:3

4 bit

4 bit

-

-100

100

DPT:3.007

DPT_Control_Dimming

dimming

-

-100

100

DPT:3.008

DPT_Control_Blinds

blind control

-

-100

100

DPT:4

char

char

-

DPT:4.001

DPT_Char_ASCII

char

-

DPT:5

8 bit unsigned

8 bit unsigned integer

-

0

255

DPT:5.001

DPT_Scaling

percentage

%

0

100

DPT:5.003

DPT_Angle

angle

°

0

360

DPT:5.004

DPT_Percent_U8

percentage

%

0

255

DPT:5.010

DPT_Value_1_Ucount

counter

-

0

255

DPT:6

8 bit signed

8 bit signed integer

-

-128

127

DPT:6.001

DPT_Percent_V8

percentage with sign

%

-128

127

DPT:6.010

DPT_Value_1_Count

counter with sign

-

-128

127

DPT:7

2 byte unsigned

2 byte unsigned integer

-

0

65535

DPT:7.001

DPT_Value_2_Ucount

2 byte unsigned integer

-

0

65535

DPT:7.600

DPT_Absolute_Colour_Temperature

2 byte unsigned integer

K

0

65535

DPT:8

2 byte signed

2 byte signed integer

-

-32768

32767

DPT:8.001

DPT_Value_2_Count

2 byte signed integer

-

-32768

32767

DPT:9

2 byte float

2 byte float value

-

-671088.64

670433.28

DPT:9.001

DPT_Value_Temp

temperature

°C

-671088.64

670433.28

DPT:9.004

DPT_Value_Lux

illuminance

Lux

-671088.64

670433.28

DPT:9.007

DPT_Value_Humidity

humidity

%

-671088.64

670433.28

DPT:9.008

DPT_Value_AirQuality

air quality

ppm

-671088.64

670433.28

DPT:9.020

DPT_Value_Volt

voltage

mV

-671088.64

670433.28

DPT:9.021

DPT_Value_Curr

current

mA

-671088.64

670433.28

DPT:10.001

DPT_TimeOfDay

time

-

DPT:11.001

DPT_Date

date

-

DPT:12

4 byte unsigned

4 byte unsigned integer

-

0

4294967295

DPT:12.001

DPT_Value_4_Ucount

4 byte unsigned integer

-

0

4294967295

DPT:13

4 byte signed

4 byte signed integer

-

-2147483648

2147483647

DPT:13.001

DPT_Value_4_Count

4 byte signed integer

-

-2147483648

2147483647

DPT:14

4 byte float

4 byte float IEEE 754 (only decode)

-

DPT:14.001

DPT_Value_Acceleration_Angular

4 byte float IEEE 754 (only decode)

-

DPT:16

DPT_String_ASCII

14 byte text ASCII

-

DPT:16.000

DPT_String_ASCII

14 byte text ASCII

-

DPT:16.001

DPT_String_8859_1

14 byte text ISO-8859-1

-

DPT:17

DPT_SceneNumber

Scene Number

-

1

64

DPT:17.001

DPT_SceneControl

Scene Number

-

1

192

DPT:18

DPT_SceneControl

Scene Number

-

1

192

DPT:18.001

DPT_SceneControl

Scene Number

-

1

192

DPT:20.102

DPT_HVACMode

HVAC mode

-

DPT:24.001

DPT_VarString_8859_1

variable String ISO-8859-1

-

DPT:26

DPT_SceneInfo

Scene Number

-

1

128

DPT:26.001

DPT_SceneInfo

Scene Number

-

1

128

DPT:225

3 byte unsigned

3 byte unsigned integer

-

0

16777215

DPT:225.001

DPT_ScalingSpeed

scaling speed

-

DPT:232

3xDPT_Scaling

three percentages

%

0

100

DPT:232.600

DPT_Colour_RGB

rgb color

%

0

100

DPT:232.600HSV

DPT_Colour_HSV_inofficial

hsv color (inofficial)

-

DPT:242.600

DPT_Colour_xyY

xyY color

-

DPT:251.600

DPT_Colour_RGBW

rgbw color

%

0

100

OpenHab

transform

name

description

unit

min

max

OH:color

OH_Color

OH:contact

OH_Contact

OH:datetime

OH_DateTime

OH:dimmer

OH_Dimmer

OH:number

OH_Number

OH:rollershutter

OH_RollerShutter

OH:string

OH_String

OH:switch

OH_Switch

OH:time

OH_Time

MQTT

transform

name

description

example

unit

min

max

MQTT:color_h_s_l

MQTT_color_h_s_l

HSL color

{"h":360,"s":100,"l":100}

-

MQTT:color_h_s_v

MQTT_color_h_s_v

HSV color

{"h":360,"s":100,"v":100}

-

MQTT:color_hsl

MQTT_color_hsl

HSL color as string

"360,100,100"

-

MQTT:color_hsv

MQTT_color_hsv

HSV color as string

"360,100,100"

-

MQTT:color_r_g_b

MQTT_color_r_g_b

RGB color

{"r":100,"g":100,"b":100}

-

MQTT:color_r_g_b_w

MQTT_color_r_g_b_w

RGBW color

{"r":100,"g":100,"b":100,"w":100}

-

MQTT:color_rgb

MQTT_color_rgb

RGB color as string

"100,100,100"

-

MQTT:color_rgb_hex

MQTT_color_rgb_hex

RGB color

"#11FF88"

-

MQTT:color_rgbw

MQTT_color_rgbw

RGBW color as string

"100,100,100,100"

-

MQTT:color_rgbw_hex

MQTT_color_rgbw_hex

RGBW color

"#11FF88AA"

-

MQTT:color_xy

MQTT_color_xy

xy color

{"x":0.123,"y":0.123}

-

MQTT:color_xyY

MQTT_color_xyY

xyY color

{"x":0.123,"y":0.123,"Y":100}

-

MQTT:datetime

MQTT_datetime

ISO 8601 time string

"2022-01-01T16:30:00.000Z"

-

MQTT:number

MQTT_Number

number

42

-

MQTT:string

MQTT_String

string

"abc"

-

MQTT:timestring

MQTT_timestring

time string

"16:30:00"

-

MQTT:unixtime

MQTT_unixtime

UNIX timestamp

1641054600

-

Raw-Values / test:

The transform values without a namespace are mostly for development purposes of the CometVisu, but in special cases they might also be useful in the production environment.

transform

name

description

unit

min

max

float

Cast to Float

int

Cast to Int

raw

Only the RAW value

Mode

Note

In the KNX context it is common to have write for only one address and one or more (different) addresses with read.

This principle is exactly the same that the KNX components are using to set a value and give back the status.