Implement Zigbee in Arduino

[P-R-O-C-H-Y]

Related area

Create an API for Zigbee within Arduino

Hardware specification

ESP32-C6 and ESP32-H2 as Standalone Nodes. Other SoC can be used as radio co-processor attached to a RPC (802.15.4 radio layer).

Is your feature request related to a problem?

This is an issue to track the progress of developing Zigbee library, a new API for Arduino.

Describe the solution you'd like

Initial tasks:

• Add zigbee-sdk to Arduino lib-builder Copy Zigbee + Zboss libraries esp32-arduino-lib-builder#146
• Add zigbee support Zigbee protocol support #8844
• Port basic IDF examples to Arduino Add Zigbee examples #9024 Zigbee examples update #9627

Zigbee library (wrapper) tasks:

• Create Zigbee classes and implement all Zigbee roles
• Implement Zigbee network scanning
• Allow multiple endpoints on same Zigbee device (test needed)
• Implement basic HA devices (lights, switches, sensors, etc..)
  • On/off light + switch
  • Color Dimmable light + switch
  • Temperature sensor + Thermostat
• Implement setting Manufacturer and model name
• Update ported examples to use the Zigbee Library
• Documentation feat(docs): Add Zigbee library API documentation #11525

PR: #10265

Good to have features:

• Zigbee identify handling (user can for example blink LED of EP) -> comment
• Zigbee sleepy device / deep sleep-lightsleep Zigbee Implementation: Deep Sleep example #10405
• Power source/battery level info feat(Zigbee): Support for sleepy device + Power Source and battery level + Humidity sensor cluster #10551

more tasks will be added while in progress.
Development branch

Describe alternatives you've considered

No other usable Zigbee wrapper around.

Additional context

Related issues:
#8807 #9156 #9962 #9480

I have checked existing list of Feature requests and the Contribution Guide

• I confirm I have checked existing list of Feature requests and Contribution Guide.

[elgerg]

Hi, love the work so far. I'm so excited to get this running. It looks like it's going to be the next best thing since sliced bread!

Are there any intentions to add power source/battery level into the config?

If mains powered could it act as a router as well or is that too much for a H2? Maybe ok for the C6..

Many thanks and appreciate the hard work!

[P-R-O-C-H-Y]

Dev update 12/08/2024 pushed to the dev branch:

• Implemented Factory reset of Zigbee device, in order to connect to new network without reflashing/erasing flash
• Implemented optional setting for Manufacturer and Model names
• Added option to allow endpoint to have multiple endpoint connected -> switch - 2 lights (tested)
• Implemented easy transfer from device it to Device type (0x0000 = ESP_ZB_HA_ON_OFF_SWITCH_DEVICE_ID -> "General On/Off switch".
• Minor sketches update

[elgerg]

Oh wow, that looks amazing! So easy, I'm going to love this. Thanks!

[P-R-O-C-H-Y]

Hi, love the work so far. I'm so excited to get this running. It looks like it's going to be the next best thing since sliced bread!

Are there any intentions to add power source/battery level into the config?

If mains powered could it act as a router as well or is that too much for a H2? Maybe ok for the C6..

Many thanks and appreciate the hard work!

Thank you for your feedback 👍 I really appreciate it.

About the power source/baterry level I will add it on the list as good to have, so I will look after having the main part done :)

[P-R-O-C-H-Y]

Dev Update 14/08/2024 pushed to dev branch:

• Implemented Color Dimmable Light and Colour Dimmer Switch endpoints, working in RGB colour space (automatically convert to/from XYZ).
• Added examples: Zigbee_Color_Dimmable_Light, Zigbee_Color_Dimmer_Switch
• Printing of bound devices (endpoints)
• Minor code updates

[elgerg]

Nice,
Any chance you can take a look at adding temp sensor and light sensor?
They are the 2 I'm most eager to try, I'm currently using the temp sensor and it works great (even if the code is way difficult to understand).
Thanks!

[P-R-O-C-H-Y]

Nice, Any chance you can take a look at adding temp sensor and light sensor? They are the 2 I'm most eager to try, I'm currently using the temp sensor and it works great (even if the code is way difficult to understand). Thanks!

@elgerg The temperature sensor + thermostat are on the list of upcoming tasks.
The light sensor device type is not present in the list in esp32-zigbee-sdk, it should have value 0x106, which is not present.
Can you open a feature request to the esp-zigbee-sdk repository please? Seems that the main part is already there which contains all the clusters and attributes for luminance sensor.

Edit: found your issue you opened. Added a comment.