The Zigbee module provides a core OSGi-based API for efficient management of Zigbee devices, and a supplementary API for using ZCL metadata. For the communication with the devices in a network is used a coordinator. The module provides support for several coordinator models. If needed for a certain target platform, the Zigbee module can be ported onto new coordinator types. Currently the module includes support for the Zigbee Cluster Library 3.0 specification along with the Home Automation 1.2 (HA), Smart Energy 1.x (SE) and Light Link application profiles. It is integrated with the Peripheral module for easier setup.
Feature Set
The Zigbee module provides the following features and functionalities:
Core API for discovery and control of Zigbee PRO devices.
Support for the following public application profiles:
Provides ZCL metadata support for accessing meta information about Zigbee clusters and Zigbee application profiles and devices:
ZCL metadata for Home Automation 1.2 profile
ZCL metadata for Smart Energy 1.x profile
ZCL metadata for Light Link 1.0 profile
Pluggable mechanism for extending the support for public, private and manufacturer specific profiles/clusters
Allows handling cluster logic on behalf of the connected coordinator.
Integration with the management features of the Device Access (DA) module. For mapping with DA Device Items, refer to the Zigbee Module Developer Guide - ZCL to Device Item Mapping.
Pluggable mechanism for adding HDM support for additional profiles/clusters.
Zigbee simulator for development and demonstration of the functionalities of the module.
Detailed information what exactly is implemented from the Home Automation, Light Link and Smart Energy profiles is found in Zigbee to HDM Mapping chapter of Managing ZigBee Devices via HDM.
Supported Devices
Certified Devices - the Zigbee module provides support for all Zigbee-certified devices, with a subset of features as described in the feature set above.
Tested Devices - a number of production devices is fully tested with the latest release of the Bosch IoT Gateway software stack.
For a most up-to-date list of tested and certified devices, visit Supported Devices.
Known Issues and Limitations
The following issues or limitations are known:
Zigbee Network Simulator cannot be extended with support for clusters which behavior is based on information retrieved form a persistent table or synchronized with other system.
Due to the way how Linux-based operating systems deal with some USB devices, the ModemManager component in some Linux distributions might conflict with the port settings made available by your Coordinators/Controllers. In such cases it is recommended that you uninstall the ModemManager package before using this module.
The public profiles HA and LL are not fully implemented.
InterPan messages are only supported by the Telegesis Driver, so the Light Link command Reset to Factory New is only possible through Telegesis.
Module Dependencies
The module depends on the following modules:
OSGi Framework: The OSGi Runtime is required for the module to operate.
Serial Port Module: required in order for the ZigBee module to access physically connected ZigBee Coordinators.
