Migrating devices from older ZigBee pro profiles to zigbee 3.0 can seem confusing. However with the right steps, it can be a lot more understandable. This KBA will help to demonstrate the steps for how to move App Builder projects from legacy ZigBee Pro profiles to full zigbee 3.0. The initial focus will be on HA device, but it will soon include ZLL devices as well.
For this guide, we are going to be looking at the various tabs in App Builder and the change that need to be made in each section.
This is where the initial changes between older HA and ZigBee 3.0 will be found. Where an HA router application will normally have a single endpoint, a ZigBee 3.0 application will have multiple endpoints. See the pictures below.
Figure 1. The ZCL configuration of an HA profile
Figure 2. The ZCL configuration of a zigbee 3.0 profile
In the HA profile, there is a single endpoint called primary. In the zigbee 3.0 profile there will be multiple endpoints. All of profile IDs will be HA, but their device ID will be different. The GreenPower profile (ID 0x0066) is required by the zigbee 3.0 specification. Touchlink (ID 0x0200) is not, but including it will give you the most flexibility and compatibility within the zigbee 3.0 network.
In terms of clusters, these should be the same for your device from HA to zigbee 3.0.
Because zigbee 3.0 uses a new security model, there is another change that will need to be made from application to application. HA had a single security model, zigbee 3.0 Security includes all of the security models needed for new zigbee 3.0 devices.
This is where you will see major changes between the two application profiles. First we will breakdown the plugins which you will find removed from your HA device profile. Then we will breakdown and explain the new zigbee 3.0 plugins, many of which are new to the EmberZnet stack.
Plugins removed in the transition from your HA device:
The plugins you removed in the previous section are replaced by new plugins that are zigbee 3.0 compatible. Along with this there are many more plugins which need to be added to support newer zigbee 3.0 features. All of them are as follows:
If required for the Network Creation and Steering plugin, you will need to make sure to include these callbacks with your project:
Generation and rebuilding
Once you have completed moving your project over to zigbee 3.0 compliant settings, you should be able to generate and compile your project. There may be other steps required for full project migration. Manually rebuilding your project callbacks file might be necessary as well as modification of any custom code. Ideally with this KBA this process is much simpler.