Accessory Manager

The Accessory Manager lets you add and configure KNX devices that will be exposed to Matter-compatible smart home apps.

Adding a Device

1. Open the Web Interface of your KNX Bridge and go to Accessory Manager
2. Click the + icon
3. Select the device type
4. Enter a name for the accessory
5. Fill in the KNX group addresses for each characteristic
6. Click Save Configuration once all accessories are added
7. Reboot the KNX Bridge

Quick links

Lighting & Power	Blinds & Shutters	Climate	Sensors	Security & Access
Lightbulb	Motorized Window	Fan	Carbon Monoxide Sensor	Alarm
Outlet	Shutter	Pump	Contact Sensor	Door Lock
Programmable Switch		Thermostat	Humidity Sensor	Garage
Switch		Valve	Illuminance Sensor
			Motion Sensor
			Occupancy Sensor
			Smoke Sensor
			Temperature Sensor

---

Lighting & Power

Lightbulb

Setup

1. Open the Web Interface by connecting to your KNX Bridge here and navigate to Accessory Manager.
2. Click the + icon and select Lightbulb
3. Enter a name for the accessory
4. Select the channel setting that matches your light (see below)
5. Enter the KNX group addresses

Channel Settings

The Lightbulb accessory supports four channel settings. Each one requires different KNX group addresses depending on the capabilities of the light.

Switchable

For lights that can only be turned on and off.

Characteristic	Control	Status	Datatype
Switching	0/0/1	0/0/2	DPT-1

Dimmable

For lights that support on/off and brightness control.

Characteristic	Control	Status	Datatype
Switching	0/0/1	0/0/2	DPT-1
Dimming	0/0/3	0/0/4	DPT-5

Tunable White

For lights that support on/off, brightness, and colour temperature control.

Characteristic	Control	Status	Datatype
Switching	0/0/1	0/0/2	DPT-1
Dimming	0/0/3	0/0/4	DPT-5
Color Temperature	0/0/5	0/0/6	DPT-7

Colour

For lights that support full colour control (RGB or HSV).

Characteristic	Control	Status	Datatype
Switching	0/0/1	0/0/2	DPT-1
HSV Color	0/0/3	0/0/4	DPT-232

INFO

HSV Color (DPT 232.600) is a single 3-byte datapoint that carries hue, saturation, and brightness in one value.

Descriptions

Group Address	Description	Datatype
0/0/1	Switching, toggles the lamp on or off	DPT-1
0/0/2	Switching status, indicates whether the lamp is on or off	DPT-1
0/0/3	Dimming, sets the brightness level (0-100%)	DPT-5
0/0/4	Dimming status, returns the current brightness level	DPT-5
0/0/5	Color Temperature, sets the colour temperature (warm to cool)	DPT-7
0/0/6	Color Temperature status, returns the current colour temperature	DPT-7
0/0/3	HSV Color, sets hue, saturation, and brightness in a single value	DPT-232
0/0/4	HSV Color status, returns the current colour value	DPT-232

Outlet

Setup

1. Go to Accessory Manager
2. Click the + icon and select Outlet
3. Enter a name for the accessory
4. Enter the KNX group addresses

KNX Group Addresses

Characteristic	Control	Status	Datatype
On	0/0/1	0/0/2	DPT-1

Descriptions

Group Address	Description	Datatype
0/0/1	Toggles the outlet on or off	DPT-1
0/0/2	Status, indicates if the outlet is on or off	DPT-1

Programmable Switch

Use the Programmable Switch accessory for KNX button inputs that trigger events in your smart home app.

Setup

1. Go to Accessory Manager
2. Click the + icon and select Programmable Switch
3. Enter a name for the accessory
4. Enter the KNX group addresses

KNX Group Addresses

Characteristic	Control	Status	Datatype
Event	n/a	0/0/1	DPT-1

Descriptions

Group Address	Description	Datatype
0/0/1	Triggers the event the switch was programmed for	DPT-1

Switch

Setup

1. Go to Accessory Manager
2. Click the + icon and select Switch
3. Enter a name for the accessory
4. Enter the KNX group addresses

KNX Group Addresses

Characteristic	Control	Status	Datatype
On	0/0/1	0/0/2	DPT-1

Descriptions

Group Address	Description	Datatype
0/0/1	Toggles the switch on or off	DPT-1
0/0/2	Status, indicates if the switch is on or off	DPT-1

Blinds & Shutters

Motorized Window

Setup

1. Go to Accessory Manager
2. Click the + icon and select Motorized Window
3. Enter a name for the accessory
4. Enter the KNX group addresses

KNX Group Addresses

Characteristic	Control	Status	Datatype
Movement	0/0/1	0/0/2	DPT-1
TargetPosition	0/0/3	n/a	DPT-5
CurrentPosition	n/a	0/0/4	DPT-5

Descriptions

Group Address	Description	Datatype
0/0/1	Opens or closes the window completely	DPT-1
0/0/2	Indicates whether the window is open (1) or closed (0)	DPT-1
0/0/3	Position, moves window to a fixed position between 0–100%	DPT-5
0/0/4	Position status, current position of the window	DPT-5

Shutter

Setup

1. Go to Accessory Manager
2. Click the + icon and select Shutter
3. Enter a name for the accessory
4. Enter the KNX group addresses

KNX Group Addresses

Characteristic	Control	Status	Datatype
Movement	0/0/1	0/0/4	DPT-1
Stop	0/0/2	n/a	DPT-1
TargetPosition	0/0/3	n/a	DPT-5
CurrentPosition	n/a	0/0/4	DPT-5
TargetTilt	0/0/5	n/a	DPT-5
CurrentTilt	n/a	0/0/6	DPT-5

Descriptions

Group Address	Description	Datatype
0/0/1	Long Up/Down, opens or closes the shutter completely	DPT-1
0/0/2	Short Up/Down, step moves the shutter and/or adjusts tilt angle	DPT-1
0/0/3	Position, moves shutter to a fixed position between 0–100%	DPT-5
0/0/4	Position status, current position of the shutter	DPT-5
0/0/5	Tilt Position, rotates slats to a fixed angle between 0–100%	DPT-5
0/0/6	Tilt Position status, current tilt angle between 0–100%	DPT-5

Climate

Fan

Setup

1. Go to Accessory Manager
2. Click the + icon and select Fan
3. Enter a name for the accessory
4. Enter the KNX group addresses

KNX Group Addresses

Characteristic	Control	Status	Datatype
Active	0/0/1	0/0/2	DPT-1
RotationSpeed	0/0/3	0/0/4	DPT-5
SwingMode	0/0/5	0/0/6	DPT-1

Descriptions

Group Address	Description	Datatype
0/0/1	Switches the fan on (1) or off (0)	DPT-1
0/0/2	Returns the status of the fan: on (1) or off (0)	DPT-1
0/0/3	Sets the rotation speed	DPT-5
0/0/4	Returns the current rotation speed	DPT-5
0/0/5	Switches swing mode on (1) or off (0)	DPT-1
0/0/6	Returns the status of swing mode: on (1) or off (0)	DPT-1

Pump

Setup

1. Go to Accessory Manager
2. Click the + icon and select Pump
3. Enter a name for the accessory
4. Enter the KNX group addresses

KNX Group Addresses

Characteristic	Control	Status	Datatype
Active	0/0/1	0/0/2	DPT-1

Thermostat

Setup

1. Go to Accessory Manager
2. Click the + icon and select Thermostat
3. Choose a mode: Heating, Cooling, or Heating + Cooling
4. Enter a name for the accessory
5. Enter the KNX group addresses

KNX Group Addresses

Heating

If the thermostat sends a binary object only, tick the box Thermostat sends DPT 1.001 (On/Off).

Characteristic	Control	Status	Datatype
TargetTemperature	0/0/1	0/0/1	DPT-9
CurrentTemperature	n/a	0/0/2	DPT-9
TargetMode	0/0/3	n/a	DPT-1
CurrentMode	n/a	0/0/4	DPT-20

Heating and Cooling

Characteristic	Control	Status	Datatype
TargetTemperature	0/0/1	0/0/1	DPT-9
CurrentTemperature	n/a	0/0/2	DPT-9
TargetMode	0/0/3	n/a	DPT-20
CurrentMode	n/a	0/0/4	DPT-20

Air Conditioning

Characteristic	Control	Status	Datatype
TargetTemperature	0/0/1	0/0/1	DPT-9
CurrentTemperature	n/a	0/0/2	DPT-9
TargetMode	0/0/3	n/a	DPT-20
CurrentMode	n/a	0/0/4	DPT-20
OnOff	0/0/5	0/0/6	DPT-1

Valve

Use the Valve accessory to control KNX-connected valves, including irrigation valves, shower heads, and water faucets.

Setup

1. Go to Accessory Manager
2. Click the + icon and select Valve
3. Choose the valve type: Generic Valve, Irrigation Valve, Shower Head, or Water Faucet
4. Enter a name for the accessory
5. Enter the KNX group addresses

KNX Group Addresses

Characteristic	Control	Status	Datatype
Active	0/0/1	0/0/2	DPT-1

Descriptions

Group Address	Description	Datatype
0/0/1	Opens (1) or closes (0) the valve	DPT-1
0/0/2	Returns the status: open (1) or closed (0)	DPT-1

Sensors

Carbon Monoxide Sensor

Setup

1. Go to Accessory Manager
2. Click the + icon and select Carbon Monoxide Sensor
3. Enter a name for the accessory
4. Enter the KNX group addresses

KNX Group Addresses

Characteristic	Control	Status	Datatype
CarbonMonoxideDetected	n/a	0/0/1	DPT-1

Contact Sensor

Setup

1. Go to Accessory Manager
2. Click the + icon and select Contact Sensor
3. Enter a name for the accessory
4. Enter the KNX group addresses

KNX Group Addresses

Characteristic	Control	Status	Datatype
State	n/a	0/0/1	DPT-1

Descriptions

Group Address	Description	Datatype
0/0/1	Status of contact sensor (1 = contact detected, 0 = off)	DPT-1

Humidity Sensor

Setup

1. Go to Accessory Manager
2. Click the + icon and select Humidity Sensor
3. Enter a name for the accessory
4. Enter the KNX group addresses

KNX Group Addresses

Characteristic	Control	Status	Datatype
CurrentRelativeHumidity	n/a	0/0/1	DPT-9

Illuminance Sensor

Setup

1. Go to Accessory Manager
2. Click the + icon and select Illuminance Sensor
3. Enter a name for the accessory
4. Enter the KNX group addresses

KNX Group Addresses

Characteristic	Control	Status	Datatype
CurrentAmbientLightLevel	n/a	0/0/1	DPT-9

Motion Sensor

Setup

1. Go to Accessory Manager
2. Click the + icon and select Motion Sensor
3. Enter a name for the accessory
4. Enter the KNX group addresses

KNX Group Addresses

Characteristic	Control	Status	Datatype
MotionDetected	n/a	0/0/1	DPT-1

Descriptions

Group Address	Description	Datatype
0/0/1	Status of motion detector (0 = motion detected, 1 = no motion)	DPT-1

Occupancy Sensor

Setup

1. Go to Accessory Manager
2. Click the + icon and select Occupancy Sensor
3. Enter a name for the accessory
4. Enter the KNX group addresses

KNX Group Addresses

Characteristic	Control	Status	Datatype
OccupancyDetected	n/a	0/0/1	DPT-1

Descriptions

Group Address	Description	Datatype
0/0/1	Status of occupancy detector (1 = occupancy detected, 0 = off)	DPT-1

Smoke Sensor

Setup

1. Go to Accessory Manager
2. Click the + icon and select Smoke Sensor
3. Enter a name for the accessory
4. Enter the KNX group addresses

KNX Group Addresses

Characteristic	Control	Status	Datatype
SmokeDetected	n/a	0/0/1	DPT-1

Temperature Sensor

Setup

1. Go to Accessory Manager
2. Click the + icon and select Temperature Sensor
3. Enter a name for the accessory
4. Enter the KNX group addresses

KNX Group Addresses

Characteristic	Control	Status	Datatype
CurrentTemperature	n/a	0/0/1	DPT-9

Descriptions

Group Address	Description	Datatype
0/0/1	Indicates the current temperature	DPT-9

Security & Access

Alarm

Setup

1. Go to Accessory Manager
2. Click the + icon and select Alarm
3. Enter a name for the accessory
4. Enter the KNX group addresses

KNX Group Addresses

Characteristic	Control	Status	Datatype
Active	0/0/1	0/0/2	DPT-1

Door Lock

Setup

1. Go to Accessory Manager
2. Click the + icon and select Door Lock
3. Enter a name for the accessory
4. Enter the KNX group addresses

KNX Group Addresses

Characteristic	Control	Status	Datatype
TargetLockState	0/0/1	n/a	DPT-1
CurrentLockState	n/a	0/0/2	DPT-1

Descriptions

Group Address	Description	Datatype
0/0/1	Locks (1) and unlocks (0) the door	DPT-1
0/0/2	Status, indicates if the door is locked (1) or unlocked (0)	DPT-1

Garage

Setup

1. Go to Accessory Manager
2. Click the + icon and select Garage
3. Enter a name for the accessory
4. Enter the KNX group addresses

KNX Group Addresses

Characteristic	Control	Status	Datatype
TargetDoorState	0/0/1	n/a	DPT-1
CurrentDoorState	n/a	0/0/2	DPT-1

Descriptions

Group Address	Description	Datatype
0/0/1	Opens (0) and closes (1) the garage	DPT-1
0/0/2	Returns the status: 0 = open, 1 = closed	DPT-1

Implementation Tip

We recommend implementing a garage in KNX with a relay actuator that sends a short impulse, and a binary input connected to a reed contact that closes when the garage door is fully closed.

If you measure the time the garage needs to fully open, you can add this turn-off delay to the binary input to get an "open" notification in the app only after the door is physically open.