Accessory Types
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
Use the Lightbulb accessory to control lights. Depending on the type of light, select the appropriate channel setting.
Setup
- Open the Web Interface by accessing your KNX Bridge here and navigate to Accessory Manager.
- Click the + icon and select Lightbulb
- Enter a name for the accessory
- Select the channel setting that matches your light (see below)
- 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. A separate dimming address is not needed because brightness is already included in the HSV 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
Use the Outlet accessory to control power outlets via KNX.
Setup
- Go to Accessory Manager
- Click the + icon and select Outlet
- Enter a name for the accessory
- 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
- Go to Accessory Manager
- Click the + icon and select Programmable Switch
- Enter a name for the accessory
- 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
Use the Switch accessory for simple on/off control of a KNX device.
Setup
- Go to Accessory Manager
- Click the + icon and select Switch
- Enter a name for the accessory
- 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
Use the Motorized Window accessory to control KNX-connected motorized windows.
Setup
- Go to Accessory Manager
- Click the + icon and select Motorized Window
- Enter a name for the accessory
- 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
Use the Shutter accessory to control KNX blinds, shutters, and window coverings.
Setup
- Go to Accessory Manager
- Click the + icon and select Shutter
- Enter a name for the accessory
- 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
Use the Fan accessory to control KNX-connected fans.
Setup
- Go to Accessory Manager
- Click the + icon and select Fan
- Enter a name for the accessory
- 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
Use the Pump accessory to control a KNX-connected pump.
Setup
- Go to Accessory Manager
- Click the + icon and select Pump
- Enter a name for the accessory
- Enter the KNX group addresses
KNX Group Addresses
| Characteristic | Control | Status | Datatype |
|---|---|---|---|
| Active | 0/0/1 | 0/0/2 | DPT-1 |
Thermostat
Use the Thermostat accessory to control KNX heating and cooling systems.
Setup
- Go to Accessory Manager
- Click the + icon and select Thermostat
- Choose a mode: Heating, Cooling, or Heating + Cooling
- Enter a name for the accessory
- 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
- Go to Accessory Manager
- Click the + icon and select Valve
- Choose the valve type: Generic Valve, Irrigation Valve, Shower Head, or Water Faucet
- Enter a name for the accessory
- 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
Use the Carbon Monoxide Sensor accessory to expose a KNX CO sensor to your smart home app.
Setup
- Go to Accessory Manager
- Click the + icon and select Carbon Monoxide Sensor
- Enter a name for the accessory
- Enter the KNX group addresses
KNX Group Addresses
| Characteristic | Control | Status | Datatype |
|---|---|---|---|
| CarbonMonoxideDetected | n/a | 0/0/1 | DPT-1 |
Contact Sensor
Use the Contact Sensor accessory to expose a KNX contact (open/closed) sensor to your smart home app.
Setup
- Go to Accessory Manager
- Click the + icon and select Contact Sensor
- Enter a name for the accessory
- 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
Use the Humidity Sensor accessory to expose a KNX humidity sensor to your smart home app.
Setup
- Go to Accessory Manager
- Click the + icon and select Humidity Sensor
- Enter a name for the accessory
- Enter the KNX group addresses
KNX Group Addresses
| Characteristic | Control | Status | Datatype |
|---|---|---|---|
| CurrentRelativeHumidity | n/a | 0/0/1 | DPT-9 |
Illuminance Sensor
Use the Illuminance Sensor accessory to expose a KNX light level sensor to your smart home app.
Setup
- Go to Accessory Manager
- Click the + icon and select Illuminance Sensor
- Enter a name for the accessory
- Enter the KNX group addresses
KNX Group Addresses
| Characteristic | Control | Status | Datatype |
|---|---|---|---|
| CurrentAmbientLightLevel | n/a | 0/0/1 | DPT-9 |
Motion Sensor
Use the Motion Sensor accessory to expose a KNX motion detector to your smart home app.
Setup
- Go to Accessory Manager
- Click the + icon and select Motion Sensor
- Enter a name for the accessory
- 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
Use the Occupancy Sensor accessory to expose a KNX occupancy detector to your smart home app.
Setup
- Go to Accessory Manager
- Click the + icon and select Occupancy Sensor
- Enter a name for the accessory
- 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
Use the Smoke Sensor accessory to expose a KNX smoke detector to your smart home app.
Setup
- Go to Accessory Manager
- Click the + icon and select Smoke Sensor
- Enter a name for the accessory
- Enter the KNX group addresses
KNX Group Addresses
| Characteristic | Control | Status | Datatype |
|---|---|---|---|
| SmokeDetected | n/a | 0/0/1 | DPT-1 |
Temperature Sensor
Use the Temperature Sensor accessory to expose a KNX temperature sensor to your smart home app.
Setup
- Go to Accessory Manager
- Click the + icon and select Temperature Sensor
- Enter a name for the accessory
- 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
Use the Alarm accessory to expose a KNX alarm system to your smart home app.
Setup
- Go to Accessory Manager
- Click the + icon and select Alarm
- Enter a name for the accessory
- Enter the KNX group addresses
KNX Group Addresses
| Characteristic | Control | Status | Datatype |
|---|---|---|---|
| Active | 0/0/1 | 0/0/2 | DPT-1 |
Door Lock
Use the Door Lock accessory to control KNX-connected door locks.
Setup
- Go to Accessory Manager
- Click the + icon and select Door Lock
- Enter a name for the accessory
- 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
Use the Garage accessory to control KNX-connected garage doors. A garage door in HomeKit only has binary states: open or closed.
Setup
- Go to Accessory Manager
- Click the + icon and select Garage
- Enter a name for the accessory
- 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.