Add Zigbee examples (espressif#9024)

* feat: added zigbee light and switch examples * fix: added skip files for unsupported socs * fix(example): Removed Serial and updated readme. * fix(): Simplify examples + fix zigbee partition table

Author: P-R-O-C-H-Y

libraries/ESP32/examples/Zigbee/Zigbee_Light_Bulb/.skip.esp32

@@ -0,0 +1,70 @@
+# Arduino-ESP32 Zigbee Light Bulb Example
+
+This example shows how to configure the Zigbee end device and use it as a HA on/off light bulb.
+
+**This example is based on ESP-Zigbee-SDK example esp_zigbee_HA_sample/HA_on_off_light.**
+
+# Supported Targets
+
+Currently, this example supports the following targets.
+
+| Supported Targets | ESP32-C6 | ESP32-H2 |
+| ----------------- | -------- | -------- |
+
+## Hardware Required
+
+* One development board (ESP32-H2 or ESP32-C6) acting as Zigbee coordinator (loaded with Zigbee_Light_switch example)
+* A USB cable for power supply and programming
+* Choose another board (ESP32-H2 or ESP32-C6) as Zigbee end device (loaded with Zigbee_Light_bulb example)
+
+### Configure the Project
+
+Set the LED GPIO by changing the `LED_PIN` definition. By default, the LED_PIN is `RGB_BUILTIN`.
+By default, the `neoPixelWrite` function is used to control the LED. You can change it to digitalWrite to control a simple LED.
+
+#### Using Arduino IDE
+
+To get more information about the Espressif boards see [Espressif Development Kits](https://www.espressif.com/en/products/devkits).
+
+* Before Compile/Verify, select the correct board: `Tools -> Board`.
+* Select the End device Zigbee mode: `Tools -> Zigbee mode: Zigbee ED (end device)`
+* Select Partition Scheme for Zigbee: `Tools -> Partition Scheme: Zigbee 4MB with spiffs`
+* Select the COM port: `Tools -> Port: xxx` where the `xxx` is the detected COM port.
+
+## Troubleshooting
+
+If the End device flashed with this example is not connecting to the coordinator, erase the flash before flashing it to the board. It is recommended to do this if you did changes to the coordinator. 
+You can do the following:
+
+* In the Arduino IDE go to the Tools menu and set `Erase All Flash Before Sketch Upload` to `Enabled`
+* In the sketch uncomment function `esp_zb_nvram_erase_at_start(true);` located in `esp_zb_task` function.
+
+***Important: Make sure you are using a good quality USB cable and that you have a reliable power source***
+
+***LED not blinking:** Check the wiring connection and the IO selection.
+***Programming Fail:** If the programming/flash procedure fails, try reducing the serial connection speed.
+***COM port not detected:** Check the USB cable and the USB to Serial driver installation.
+
+If the error persists, you can ask for help at the official [ESP32 forum](https://esp32.com) or see [Contribute](#contribute).
+
+## Contribute
+
+To know how to contribute to this project, see [How to contribute.](https://github.com/espressif/arduino-esp32/blob/master/CONTRIBUTING.rst)
+
+If you have any **feedback** or **issue** to report on this example/library, please open an issue or fix it by creating a new PR. Contributions are more than welcome!
+
+Before creating a new issue, be sure to try Troubleshooting and check if the same issue was already created by someone else.
+
+## Resources
+
+The ESP Zigbee SDK provides more examples:
+* ESP Zigbee SDK Docs: [Link](https://docs.espressif.com/projects/esp-zigbee-sdk)
+* ESP Zigbee SDK Repo: [Link](https://github.com/espressif/esp-zigbee-sdk)
+
+* Official ESP32 Forum: [Link](https://esp32.com)
+* Arduino-ESP32 Official Repository: [espressif/arduino-esp32](https://github.com/espressif/arduino-esp32)
+* ESP32 Datasheet: [Link to datasheet](https://www.espressif.com/sites/default/files/documentation/esp32_datasheet_en.pdf)
+* ESP32-S2 Datasheet: [Link to datasheet](https://www.espressif.com/sites/default/files/documentation/esp32-s2_datasheet_en.pdf)
+* ESP32-C3 Datasheet: [Link to datasheet](https://www.espressif.com/sites/default/files/documentation/esp32-c3_datasheet_en.pdf)
+* ESP32-S3 Datasheet: [Link to datasheet](https://www.espressif.com/sites/default/files/documentation/esp32-s3_datasheet_en.pdf)
+* Official ESP-IDF documentation: [ESP-IDF](https://idf.espressif.com)

libraries/ESP32/examples/Zigbee/Zigbee_Light_Bulb/.skip.esp32c3

@@ -0,0 +1,191 @@
+// Copyright 2023 Espressif Systems (Shanghai) PTE LTD
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+/**
+ * @brief This example demonstrates simple Zigbee light bulb.
+ * 
+ * The example demonstrates how to use ESP Zigbee stack to create a end device light bulb.
+ * The light bulb is a Zigbee end device, which is controlled by a Zigbee coordinator.
+ * 
+ * Proper Zigbee mode must be selected in Tools->Zigbee mode 
+ * and also the correct partition scheme must be selected in Tools->Partition Scheme.
+ * 
+ * Please check the README.md for instructions and more detailed description.
+*/
+
+#ifndef ZIGBEE_MODE_ED
+#error "Zigbee end device mode is not selected in Tools->Zigbee mode"
+#endif
+
+#include"esp_zigbee_core.h"
+#include"freertos/FreeRTOS.h"
+#include"freertos/task.h"
+#include"ha/esp_zigbee_ha_standard.h"
+
+#defineLED_PIN RGB_BUILTIN
+
+/* Default End Device config */
+#defineESP_ZB_ZED_CONFIG() \
+{\
+ .esp_zb_role = ESP_ZB_DEVICE_TYPE_ED, \
+ .install_code_policy = INSTALLCODE_POLICY_ENABLE, \
+ .nwk_cfg ={\
+ .zed_cfg ={\
+ .ed_timeout = ED_AGING_TIMEOUT, \
+ .keep_alive = ED_KEEP_ALIVE, \
+ }, \
+ }, \
+ }
+
+#defineESP_ZB_DEFAULT_RADIO_CONFIG() \
+{\
+ .radio_mode = RADIO_MODE_NATIVE, \
+ }
+
+#defineESP_ZB_DEFAULT_HOST_CONFIG() \
+{\
+ .host_connection_mode = HOST_CONNECTION_MODE_NONE, \
+ }
+
+/* Zigbee configuration */
+#defineINSTALLCODE_POLICY_ENABLEfalse/* enable the install code policy for security */
+#defineED_AGING_TIMEOUT ESP_ZB_ED_AGING_TIMEOUT_64MIN
+#defineED_KEEP_ALIVE3000/* 3000 millisecond */
+#defineHA_ESP_LIGHT_ENDPOINT10/* esp light bulb device endpoint, used to process light controlling commands */
+#defineESP_ZB_PRIMARY_CHANNEL_MASK ESP_ZB_TRANSCEIVER_ALL_CHANNELS_MASK /* Zigbee primary channel mask use in the example */
+
+/********************* Zigbee functions **************************/
+staticvoidbdb_start_top_level_commissioning_cb(uint8_t mode_mask)
+{
+ESP_ERROR_CHECK(esp_zb_bdb_start_top_level_commissioning(mode_mask));
+}
+
+voidesp_zb_app_signal_handler(esp_zb_app_signal_t *signal_struct)
+{
+uint32_t *p_sg_p = signal_struct->p_app_signal;
+esp_err_t err_status = signal_struct->esp_err_status;
+esp_zb_app_signal_type_t sig_type = (esp_zb_app_signal_type_t)*p_sg_p;
+switch (sig_type){
+case ESP_ZB_ZDO_SIGNAL_SKIP_STARTUP:
+log_i("Zigbee stack initialized");
+esp_zb_bdb_start_top_level_commissioning(ESP_ZB_BDB_MODE_INITIALIZATION);
+break;
+case ESP_ZB_BDB_SIGNAL_DEVICE_FIRST_START:
+case ESP_ZB_BDB_SIGNAL_DEVICE_REBOOT:
+if (err_status == ESP_OK){
+log_i("Start network steering");
+esp_zb_bdb_start_top_level_commissioning(ESP_ZB_BDB_MODE_NETWORK_STEERING);
+ } else{
+/* commissioning failed */
+log_w("Failed to initialize Zigbee stack (status: %s)", esp_err_to_name(err_status));
+ }
+break;
+case ESP_ZB_BDB_SIGNAL_STEERING:
+if (err_status == ESP_OK){
+esp_zb_ieee_addr_t extended_pan_id;
+esp_zb_get_extended_pan_id(extended_pan_id);
+log_i("Joined network successfully (Extended PAN ID: %02x:%02x:%02x:%02x:%02x:%02x:%02x:%02x, PAN ID: 0x%04hx, Channel:%d, Short Address: 0x%04hx)",
+ extended_pan_id[7], extended_pan_id[6], extended_pan_id[5], extended_pan_id[4],
+ extended_pan_id[3], extended_pan_id[2], extended_pan_id[1], extended_pan_id[0],
+esp_zb_get_pan_id(), esp_zb_get_current_channel(), esp_zb_get_short_address());
+ } else{
+log_i("Network steering was not successful (status: %s)", esp_err_to_name(err_status));
+esp_zb_scheduler_alarm((esp_zb_callback_t)bdb_start_top_level_commissioning_cb, ESP_ZB_BDB_MODE_NETWORK_STEERING, 1000);
+ }
+break;
+default:
+log_i("ZDO signal: %s (0x%x), status: %s", esp_zb_zdo_signal_to_string(sig_type), sig_type,
+esp_err_to_name(err_status));
+break;
+ }
+}
+
+staticesp_err_tzb_action_handler(esp_zb_core_action_callback_id_t callback_id, constvoid *message)
+{
+esp_err_t ret = ESP_OK;
+switch (callback_id){
+case ESP_ZB_CORE_SET_ATTR_VALUE_CB_ID:
+ ret = zb_attribute_handler((esp_zb_zcl_set_attr_value_message_t *)message);
+break;
+default:
+log_w("Receive Zigbee action(0x%x) callback", callback_id);
+break;
+ }
+return ret;
+}
+
+staticvoidesp_zb_task(void *pvParameters)
+{
+esp_zb_cfg_t zb_nwk_cfg = ESP_ZB_ZED_CONFIG();
+esp_zb_init(&zb_nwk_cfg);
+esp_zb_on_off_light_cfg_t light_cfg = ESP_ZB_DEFAULT_ON_OFF_LIGHT_CONFIG();
+esp_zb_ep_list_t *esp_zb_on_off_light_ep = esp_zb_on_off_light_ep_create(HA_ESP_LIGHT_ENDPOINT, &light_cfg);
+esp_zb_device_register(esp_zb_on_off_light_ep);
+esp_zb_core_action_handler_register(zb_action_handler);
+esp_zb_set_primary_network_channel_set(ESP_ZB_PRIMARY_CHANNEL_MASK);
+
+//Erase NVRAM before creating connection to new Coordinator
+//esp_zb_nvram_erase_at_start(true); //Comment out this line to erase NVRAM data if you are conneting to new Coordinator
+
+ESP_ERROR_CHECK(esp_zb_start(false));
+esp_zb_main_loop_iteration();
+}
+
+/* Handle the light attribute */
+
+staticesp_err_tzb_attribute_handler(constesp_zb_zcl_set_attr_value_message_t *message)
+{
+esp_err_t ret = ESP_OK;
+bool light_state = 0;
+
+if(!message){
+log_e("Empty message");
+ }
+if(message->info.status != ESP_ZB_ZCL_STATUS_SUCCESS){
+log_e("Received message: error status(%d)", message->info.status);
+ }
+
+log_i("Received message: endpoint(%d), cluster(0x%x), attribute(0x%x), data size(%d)", message->info.dst_endpoint, message->info.cluster,
+ message->attribute.id, message->attribute.data.size);
+if (message->info.dst_endpoint == HA_ESP_LIGHT_ENDPOINT){
+if (message->info.cluster == ESP_ZB_ZCL_CLUSTER_ID_ON_OFF){
+if (message->attribute.id == ESP_ZB_ZCL_ATTR_ON_OFF_ON_OFF_ID && message->attribute.data.type == ESP_ZB_ZCL_ATTR_TYPE_BOOL){
+ light_state = message->attribute.data.value ? *(bool *)message->attribute.data.value : light_state;
+log_i("Light sets to %s", light_state ? "On" : "Off");
+neopixelWrite(LED_PIN,255*light_state,255*light_state,255*light_state); // Toggle light
+ }
+ }
+ }
+return ret;
+}
+
+/********************* Arduino functions **************************/
+voidsetup(){
+// Init Zigbee
+esp_zb_platform_config_t config ={
+ .radio_config = ESP_ZB_DEFAULT_RADIO_CONFIG(),
+ .host_config = ESP_ZB_DEFAULT_HOST_CONFIG(),
+ };
+ESP_ERROR_CHECK(esp_zb_platform_config(&config));
+
+// Init RMT and leave light OFF
+neopixelWrite(LED_PIN,0,0,0);
+
+// Start Zigbee task
+xTaskCreate(esp_zb_task, "Zigbee_main", 4096, NULL, 5, NULL);
+}
+
+voidloop(){
+//empty, zigbee running in task
+}