HDL Buspro
homebridge-hdl-buspro · v2.2.2
Adds HDL Buspro relays, dimmers, curtains, locks, fans and 8-in-1 sensors to HomeKit.
What it says it supports
Brands
- HDL
Devices it names
- HDL Buspro relay lightbulbs
- dimmable relays
- Sensors 8 in 1
- dry contact relays
- relay curtains
- relay locks
- relay fans
Shows up in Apple Home as from its README
Sensor readings in its code
What people report
Supports HDL Buspro relays, dry contacts and fan controller; relay dimmers on DALI gateways and newer multi-sensors do not work.
- Works1
- Not working4
| Device | Status | What they said | Source |
|---|---|---|---|
| HDL 4CH electric fan controller | Works | Exposed as a fan with speed control via relayfan typeSaved copyAdded support for 4ch relay fan controller As requested in #13 . Adding device with `device_type` set to relayfan will reflect as a fan in Homebridge and Homekit. Speed can be varied between 0-100% (Speed is rounded down to the nearest tenth to support HDL Fan controller values between 0-10) Example config [code] Excerpt saved from GitHub on 2026-10-22. | PR #16 · 2024-11 |
| HDL MS12.2C (SB-CMS-12in1) sensor | Not working | Temperature, light and motion all read 0Saved copyIs your feature request related to a problem? Please describe: I have sensors of different types: 1. HDL-MSP02.4C 2. HDL-MSPU03.4C 3. HDL-MS12.2C(SB-CMS-12in1)) However, they are also not working properly, with temperature, light, and motion readings all showing as 0. They are configured as follows: `{ "device_name": "Sensor N", "device_address": 104, "device_type": "sensor8in1", "area": 1, "nc": true, "curtains_precision": 5 } ` Describe the solution you'd like: Are there plans to add support for these devices? Is there any way I can help with development? Is there an understanding of how … Excerpt saved from GitHub on 2026-10-22. | Issue #9 · 2023-04 |
| HDL MSP02.4C multi-sensor | Not working | Temperature, light and motion all read 0Saved copyIs your feature request related to a problem? Please describe: I have sensors of different types: 1. HDL-MSP02.4C 2. HDL-MSPU03.4C 3. HDL-MS12.2C(SB-CMS-12in1)) However, they are also not working properly, with temperature, light, and motion readings all showing as 0. They are configured as follows: `{ "device_name": "Sensor N", "device_address": 104, "device_type": "sensor8in1", "area": 1, "nc": true, "curtains_precision": 5 } ` Describe the solution you'd like: Are there plans to add support for these devices? Is there any way I can help with development? Is there an understanding of how … Excerpt saved from GitHub on 2026-10-22. | Issue #9 · 2023-04 |
| HDL MSPU03.4C multi-sensor | Not working | Temperature, light and motion all read 0Saved copyIs your feature request related to a problem? Please describe: I have sensors of different types: 1. HDL-MSP02.4C 2. HDL-MSPU03.4C 3. HDL-MS12.2C(SB-CMS-12in1)) However, they are also not working properly, with temperature, light, and motion readings all showing as 0. They are configured as follows: `{ "device_name": "Sensor N", "device_address": 104, "device_type": "sensor8in1", "area": 1, "nc": true, "curtains_precision": 5 } ` Describe the solution you'd like: Are there plans to add support for these devices? Is there any way I can help with development? Is there an understanding of how … Excerpt saved from GitHub on 2026-10-22. | Issue #9 · 2023-04 |
| HDL relay dimmer on DALI | Not working | Dimmers do not work; plugin built for older instructions, DALI channels may differSaved copyChecked for what the DALI is and it seems to be among the newer relays. The plugin was coded according to an old leaked internal instruction, so there is a chance it is not supported. But I also checked the manual for it and it seems that channels 65 to 80 virtually correspond to the entire groups of light, and i never had in mind how would this config work. https://b2b.hdl-automation.cz/en/support/products/manuals/buspro/dali/m-hdl-mc64-dali-431(dali-controller) Could you rather try to write in one separate dimmer from this group, maybe it would work? Excerpt saved from GitHub on 2026-10-22. | Issue #6 · 2022-11 |
Gathered from the plugin’s GitHub issues, pull requests, discussions, wiki and docs, and from r/homebridge. These are individual reports, so check the linked thread and the date before you buy.
How it connects
Local
HDL Buspro bus via subnet device addresses
You’ll need
- HDL Buspro bus/gateway
- Device address and type per device
Compatibility
| Verified by Homebridge | No |
|---|---|
| Homebridge versions | ^1.8.0 || ^2.0.0-beta.0 |
| Homebridge 2.0 | Yes |
| Node.js | ^18.20.4 || ^20.18.0 || ^22.10.0 |
| Settings in Homebridge UI | Yes |
| Matter | No |
| Platform name | HDLBusproHomebridge |
| License | Apache-2.0 |
Community signals
| Downloads a week | 28 |
|---|---|
| Downloads a month | 66 |
| GitHub stars | 11 |
| Open issues | 7 |
| Closed issues | 3 |
| Discussions | 2 |
| Last code push | 2024-12-15 |
| Latest version | 2.2.2 (2024-12-15) |
| First published | 2021-03-31 |
| Releases | 9 |
In ReReHome
Whatever this plugin publishes reaches Apple Home as a normal HomeKit accessory behind your Homebridge bridge, so ReReHome shows and controls it like any other.
Bridges get their own settings page listing the accessories behind them.
Caveats from the README
- Dry contacts on 8-in-1 sensor not yet supported
- Heaters and security systems may come later
HomeKit services in its code
Found by scanning the published npm package. A plugin can register a service only for some devices.
- ContactSensor
- Fan
- LeakSensor
- LightSensor
- Lightbulb
- LockMechanism
- Microphone
- MotionSensor
- OccupancySensor
- SmokeSensor
- TemperatureSensor
- Valve
- WindowCovering
