Zigbee for Domoticz is a powerful Python plugin that integrates Zigbee devices into the Domoticz home automation system without requiring cloud applications. Evolving from the original Zigate plugin, it supports a wide range of Zigbee coordinators and approximately 500 certified Zigbee devices, leveraging the zigpy libraries for enhanced compatibility and performance.
- Broad Coordinator Support: Compatible with Zigate, Texas Instruments (CC2531, CC13x2, CC26x2 via zigpy-znp), Silicon Labs (EFR32MGxx via zigpy-bellows), and deCONZ (ConBee/RaspBee via zigpy-deconz) Zigbee coordinators.
- Device Compatibility: Supports Zigbee 3.0, Zigbee Home Automation, and Zigbee Light Link devices, with dedicated configuration files for ~500 certified devices via the z4d-certified-devices module. Any Zigbee 3.0-compliant device can be integrated without specific configuration.
- Web User Interface: A modern WebUI (available at Domoticz-Zigbee-UI) allows device management, raw Zigbee command sending, and network topology visualization. Accessible at
/z4dand reverse-proxy compatible. - Over-The-Air (OTA) Updates: Supports firmware upgrades for compatible Zigbee devices.
- Advanced Features: Includes network topology visualization, attribute discovery (in zigpy mode), and support for devices like ZLinky in multiple modes.
- Limit of 255 Widgets: Domoticz devices (widgets) are capped at 255, requiring mains-powered Zigbee routers to extend the network mesh.
- Domoticz: Version 2021.1 or higher.
- Python: Version 3.8 or higher with the
python3-devpackage. - Operating System: Recommended for Linux (Raspberry Pi, Debian, Ubuntu). Windows support is not officially supported and may encounter issues.
- Zigbee Coordinator: A supported Zigbee radio module (see Coordinator Compatibility).
Everything is on our Wiki : https://zigbeefordomoticz.github.io/wiki
The wiki is available in English. Le wiki est disposnible en Français. Der wiki ist auf Deutsch verfügbar.
- Zigate: Native support for Zigate coordinators (serial and WiFi). NOT SUPPORTED anymore, we advise any user to move to a TI, Silicon Labs, or deConz coordinaor
- Texas Instruments: CC2531, CC13x2, CC26x2 (via zigpy-znp). Note: CC253x adapters are obsolete and not recommended compatible hardware
- Silicon Labs: EFR32MGxx chipsets (via zigpy-bellows) compatible hardware
- deCONZ: ConBee/RaspBee (via zigpy-deconz). ConBee III support is deprecated due to instability.
- Supports ~500 certified devices with configuration files in z4d-certified-devices.
- Compatible with Zigbee 3.0-compliant devices, even without specific configurations.
- Limitations:
- Some devices (e.g., Philips bulbs) require polling due to missing Configure Reporting.
- Non-standard devices (e.g., GLEDOPTO) may act as poor routers or lack features like LQI reporting.
- Partial support for devices like Wiser Thermostat (temperature reporting only).
The community maintains a list of certified Zigbee Device Objects at https://zigbee.blakadder.com. It's important to note that if a Zigbee Device object is not listed there, it does not necessarily mean that it won't work with the plugin. Zigbee devices may still function directly or partially, requiring some customization to achieve full compatibility. The community, including anyone interested, can contribute to updating and maintaining the list through Blackadder's Zigbee Device Compatibility Repository.
In theory, any Zigbee devices that fully comply with the Zigbee 3.0, Zigbee Home Automation, and Zigbee Light Link specifications set by the Zigbee Alliance should be technically compatible with this project. However, it's worth noting that certain hardware manufacturers may not consistently adhere to all the specified requirements, resulting in partial or non-functional device behavior without custom integrations. Nevertheless, developers often find solutions or workarounds for non-standard features to address these issues.
- stable7: Recommended for production use (version 7.1.xxx).
- develop7: Ongoing development, parallel to stable7.
- wip-develop: Experimental features (use with caution).
- Check the Domoticz log file for errors.
- Refer to the Wiki for best practices and troubleshooting guides.
- Ensure mains-powered Zigbee routers are included to extend the network mesh.
- For zigpy-related issues, consult the zigpy documentation.
- English Forum: Domoticz Forum
- French Forum: EasyDomoticz Forum
- Wiki: Zigbee for Domoticz Wiki (available in English, French, German)
- Contributions: We welcome device samples for testing, WebUI translations (English, French, German, Spanish), and code contributions. See CONTRIBUTING.md.
This project is licensed under the GNU General Public License v3.0.
- Built on the original Zigate plugin.
- Powered by zigpy and its radio libraries.
- Thanks to the Domoticz and Zigbee communities for their support and contributions.
We warmly invite Manufacturers and sellers to contribute by sending us samples of their devices for integration. Your support in this regard is greatly appreciated as it enables us to expand our compatibility and offer a more comprehensive solution. We extend our heartfelt gratitude to our generous donors whose contributions enable us to acquire additional equipment for rigorous testing and seamless integration. With your support, we can further enhance the plugin's capabilities and deliver an even more powerful and versatile experience for our users.
