Smart Home Zigbee Support
Zigbee is a global wireless radio communication standard designed to enable the control and monitoring of connected devices. It's a low-power, close-proximity solution, which makes it well suited for home automation. For more information, see Zigbee Alliance.
The following are some general Zigbee specifications:
- Frequency: 2.4 GHz
- Range: 50-100 feet
- Echo Plus Zigbee support
- Add Zigbee to your products
- Add Works with All Hubs to your products
- Obtain the Works with Alexa Badge for your Zigbee devices
- Test Your Zigbee integration
- Test Your Works with All Hubs cluster
Echo Plus Zigbee support
The Amazon Echo Plus has a built-in smart home hub that seamlessly connects and controls Zigbee smart devices, such as light bulbs, door locks, in-wall switches, and plugs, without the need for separate hubs or a Smart Home skill. After a customer sets up an Echo Plus, they can connect to their devices by saying "Alexa, discover my devices." Echo Plus then discovers and sets up their devices.
Currently, the Echo Plus supports Zigbee 3.0 for device types including:
- In-wall switches
- Plugs and outlets
Add Zigbee to your products
You can implement the Zigbee protocol on your smart home device yourself, or you can purchase components to add to your device.
- To get started with a Zigbee implementation, review the Developer Resources page on the Zigbee Alliance website.
- To see Zigbee components available for purchase, browse the Certified Products page on the Zigbee Alliance website.
Add Works with All Hubs to your products
Works with All Hubs (WWAHu) is a custom Zigbee cluster that standardizes best practices to improve security, reliability, and interoperability for Zigbee devices. For more information, see The All Hubs Initiative.
You can choose to implement the Works with All Hubs cluster yourself, or you can ask the Zigbee stack vendor that your product uses for their WWAHu cluster implementation. Many Zigbee stack vendors have implemented the WWAHu cluster, including Silabs, NXP, and Ubisys. You can request the WWAHu cluster implementation and incorporate it into your Zigbee 3.0 products.
Obtain the Works with Alexa Badge for your Zigbee devices
Works with Alexa (WWA) is a certification program that raises the bar on responsiveness, reliability, and functionality, ensuring your customers have the best smart home experiences. When your products are certified, they can carry the Works with Alexa badge in the Amazon Smart Home Store and on product packaging. For more information, see Works with Alexa Overview.
Verify the following before you apply for WWA certification:
- You must adhere to the WWA program guidelines.
- You must test your Zigbee integration.
- If you support support the Works with All Hubs (WWAHu) cluster, you must test your Works with All Hubs cluster.
Important: Beginning in December 2020, for a Zigbee device to obtain the Works with Alexa certification, it must also support the Works with All Hubs (WWAHu) cluster.Note: Works with Alexa honors certification test results for the WWAHu cluster performed by Element Materials Technology. All additional test cases still apply.
After you have thoroughly tested your device with Echo Plus, you can submit your device for certification. For more information, see the Works with Alexa Certification Workflow.
Test Your Zigbee integration
After you have implemented the Zigbee protocol on your smart home device, you should test it thoroughly with an Echo Plus device. Verify that Alexa can discover your device, and that you can interact with it by using the standard utterances for your device type. For sample utterances, see the Amazon customer guidance and the documentation for the Alexa APIs that your skill implements.
There is a complete list of WWA test cases available in the Alexa Certification Console.
The following are some sample utterances.
|Device type||Example customer utterances|
|In-wall switches||Alexa turn on device name.
Alexa, turn off device name.
|Plugs and outlets||Alexa turn on device name.
Alexa, turn off device name.
|Lights||Alexa turn on device name.
Alexa, dim device name.
|Locks||Alexa, lock the device name.
Alexa, is the device name locked?
Test Your Works with All Hubs cluster
You can download a testing tool that enables you to run the Works with All Hubs (WWAHu) test cases against your product. You can use the tool to pre-test your device, but passing the test cases in the tool is not a guarantee that your device will pass certification. Test cases may change, and environmental conditions can play a role in certification test results.
- Download the test harness tool from the Alexa Certification Console.
To use the test harness, you need the following:
- The test harness tool software, including binaries and instructions.
- A Silabs Wireless Starter Kit (SLWSTK6000B). or If you already have a wireless starter kit, just a radio board (SLWRB4161A).
To simulate a device under test, before using your own device, you need the following:
To run the test tool
Flash the test harness device.
- Erase the chip.
- Program the bootloader.
- Program the application image.
Run the test harness for each test case. For example, to run test case 1, use the following code.
python3 -m pytest test_01.py