Caution

This is the documentation for the current development branch of the CometVisu. It is possible that some of the described features are not yet available in the current release.

Also there might be lots of errors in this documentation as some parts of the content have been translated by an online translation service.

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:playPause	OH_PlayPause
OH:rollershutter	OH_RollerShutter
OH:string	OH_String
OH:switch	OH_Switch
OH:thing-status	OH_Thing
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.