Dev Update: Version setting, Thermostat fix, ...

Simplified bounded device print as the structure is common for any EP type
Allowed setting custom app version for EP, default is 0
Small fixes and code updates

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

boards.txt

@@ -24,7 +24,7 @@ Set the Button Switch GPIO by changing the `GPIO_SWITCH` definition. By default,
 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 Coordinator Zigbee mode: `Tools -> Zigbee mode: Zigbee ZCZR (coordinator)`.
+* Select the Coordinator Zigbee mode: `Tools -> Zigbee mode: Zigbee ZCZR (coordinator/router)`.
 * 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.
 * Optional: Set debug level to info to see logs from Zigbee stack: `Tools -> Core Debug Level: Info`.

libraries/Zigbee/examples/Zigbee_Color_Dimmer_Switch/README.md

@@ -17,14 +17,14 @@ Currently, this example supports the following targets.
 
 ### Configure the Project
 
-Set the Button Switch GPIO by changing the `GPIO_INPUT_IO_TOGGLE_SWITCH` definition. By default, the LED_PIN is `GPIO_NUM_9`.
+Set the Button Switch GPIO by changing the `GPIO_INPUT_IO_TOGGLE_SWITCH` definition. By default, it's the pin `9` (BOOT button on ESP32-C6 and ESP32-H2).
 
 #### 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 Coordinator Zigbee mode: `Tools -> Zigbee mode: Zigbee ZCZR (coordinator)`.
+* Select the Coordinator Zigbee mode: `Tools -> Zigbee mode: Zigbee ZCZR (coordinator/router)`.
 * 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.
 * Optional: Set debug level to info to see logs from Zigbee stack: `Tools -> Core Debug Level: Info`.

libraries/Zigbee/examples/Zigbee_On_Off_Switch/README.md

@@ -35,7 +35,7 @@ Set the Button GPIO by changing the `BUTTON_PIN` definition. By default, it's th
 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 Coordinator Zigbee mode: `Tools -> Zigbee mode: Zigbee ZCZR (coordinator)`.
+* Select the Coordinator Zigbee mode: `Tools -> Zigbee mode: Zigbee ZCZR (coordinator/router)`.
 * 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.
 * Optional: Set debug level to info to see logs from Zigbee stack: `Tools -> Core Debug Level: Info`.

libraries/Zigbee/examples/Zigbee_Thermostat/README.md

@@ -93,7 +93,7 @@ void setup() {
   // When all EPs are registered, start Zigbee with ZIGBEE_COORDINATOR mode
   Zigbee.begin(ZIGBEE_COORDINATOR);
 
-  Serial.println("Waiting for Light to bound to the switch");
+  Serial.println("Waiting for Temperature sensor to bound to the switch");
   //Wait for switch to bound to a light:
   while(!zbThermostat.is_bound()) 
   {

libraries/Zigbee/examples/Zigbee_Thermostat/Zigbee_Thermostat.ino

@@ -4,5 +4,6 @@ author=P-R-O-C-H-Y
 maintainer=Jan Procházka <jan.prochazka@espressif.com>
 sentence=Enables zigbee connection with the ESP32
 paragraph=With this library you can create zigbee end devices, routers, coordinators and connect them to the zigbee network.
+category=Communication
 url=
 architectures=esp32

libraries/Zigbee/library.properties

@@ -244,7 +244,7 @@ void esp_zb_app_signal_handler(esp_zb_app_signal_t *signal_struct) {
         esp_zb_zdo_match_desc_req_param_t cmd_req;
         cmd_req.dst_nwk_addr = dev_annce_params->device_short_addr;
         cmd_req.addr_of_interest = dev_annce_params->device_short_addr;
-        log_i("Device capabilities: 0x%02x", dev_annce_params->capability);
+        log_v("Device capabilities: 0x%02x", dev_annce_params->capability);
         /*
             capability: 
             Bit 0 – Alternate PAN Coordinator
@@ -257,8 +257,6 @@ void esp_zb_app_signal_handler(esp_zb_app_signal_t *signal_struct) {
             Bit 7 – Reserved
         */
 
-        //TODO: Save the device short address and endpoint to the list ????????
-
         // for each endpoint in the list call the find_endpoint function if not bounded or allowed to bind multiple devices
         for (std::list<Zigbee_EP*>::iterator it = Zigbee.ep_objects.begin(); it != Zigbee.ep_objects.end(); ++it) {
           if (!(*it)->_is_bound || (*it)->_allow_multiple_binding) {
@@ -278,7 +276,7 @@ void esp_zb_app_signal_handler(esp_zb_app_signal_t *signal_struct) {
         }
       }
       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;
+    default: log_v("ZDO signal: %s (0x%x), status: %s", esp_zb_zdo_signal_to_string(sig_type), sig_type, esp_err_to_name(err_status)); break;
   }
 }
 
@@ -338,28 +336,6 @@ void Zigbee_Core::scanDelete() {
   _scan_status = ZB_SCAN_FAILED;
 }
 
-// NOTE: Binding functions to not forget
-// void esp_zb_zdo_device_bind_req(esp_zb_zdo_bind_req_param_t *cmd_req, esp_zb_zdo_bind_callback_t user_cb, void *user_ctx)
-// {
-//     uint8_t output = 0;
-//     uint16_t outlen = sizeof(uint8_t);
-
-//     typedef struct {
-//         esp_zb_zdo_bind_req_param_t bind_req;
-//         esp_zb_user_cb_t            bind_usr;
-//     } esp_zb_zdo_bind_req_t;
-
-//     esp_zb_zdo_bind_req_t zdo_data = {
-//         .bind_usr = {
-//             .user_ctx = (uint32_t)user_ctx,
-//             .user_cb = (uint32_t)user_cb,
-//         },
-//     };
-
-//     memcpy(&zdo_data.bind_req, cmd_req, sizeof(esp_zb_zdo_bind_req_param_t));
-//     esp_host_zb_output(ESP_ZNSP_ZDO_BIND_SET, &zdo_data, sizeof(esp_zb_zdo_bind_req_t), &output, &outlen);
-// }
-
 // Function to convert enum value to string
 const char* Zigbee_Core::getDeviceTypeString(esp_zb_ha_standard_devices_t deviceId) {
     switch (deviceId) {
@@ -386,6 +362,7 @@ const char* Zigbee_Core::getDeviceTypeString(esp_zb_ha_standard_devices_t device
         case ESP_ZB_HA_COLOR_DIMMABLE_LIGHT_DEVICE_ID: return "Color Dimmable Light Device";
         case ESP_ZB_HA_DIMMER_SWITCH_DEVICE_ID: return "Dimmer Switch Device";
         case ESP_ZB_HA_COLOR_DIMMER_SWITCH_DEVICE_ID: return "Color Dimmer Switch Device";
+        case ESP_ZB_HA_LIGHT_SENSOR_DEVICE_ID: return "Light Sensor";
         case ESP_ZB_HA_SHADE_DEVICE_ID: return "Shade";
         case ESP_ZB_HA_SHADE_CONTROLLER_DEVICE_ID: return "Shade controller";
         case ESP_ZB_HA_WINDOW_COVERING_DEVICE_ID: return "Window Covering client";

libraries/Zigbee/src/Zigbee_core.cpp

@@ -18,6 +18,10 @@ Zigbee_EP::~Zigbee_EP() {
 
 }
 
+void Zigbee_EP::setVersion(uint8_t version) {
+    _ep_config.app_device_version = version;
+}
+
 void Zigbee_EP::setManufacturerAndModel(const char *name, const char *model) {
     // Convert manufacturer to ZCL string
     size_t length = strlen(name);
@@ -74,6 +78,14 @@ void Zigbee_EP::readManufacturerAndModel(uint8_t endpoint, uint16_t short_addr)
     esp_zb_zcl_read_attr_cmd_req(&read_req);
 }
 
+void Zigbee_EP::printBoundDevices() {
+    log_i("Bound devices:");
+    for(const auto& device : _bound_devices) {
+        log_i("Device on endpoint %d, short address: 0x%x", device->endpoint, device->short_addr);
+        print_ieee_addr(device->ieee_addr);
+    }
+}
+
 void Zigbee_EP::readBasicCluster(uint16_t cluster_id, const esp_zb_zcl_attribute_t *attribute) {
     /* Basic cluster attributes */
     if (attribute->id == ESP_ZB_ZCL_ATTR_BASIC_MANUFACTURER_NAME_ID && attribute->data.type == ESP_ZB_ZCL_ATTR_TYPE_CHAR_STRING && attribute->data.value) {

libraries/Zigbee/src/Zigbee_ep.cpp

@@ -31,6 +31,12 @@ typedef struct zbstring_s {
 } ESP_ZB_PACKED_STRUCT
 zbstring_t;
 
+typedef struct zb_device_params_s {
+  esp_zb_ieee_addr_t ieee_addr;
+  uint8_t endpoint;
+  uint16_t short_addr;
+} zb_device_params_t;
+
 /* Zigbee End Device Class */
 class Zigbee_EP {
   public:
@@ -42,19 +48,23 @@ class Zigbee_EP {
 
     static uint8_t _endpoint;
     esp_zb_ha_standard_devices_t _device_id; //type of device
-    uint8_t _version;
 
     esp_zb_endpoint_config_t _ep_config;
     esp_zb_cluster_list_t *_cluster_list;
+    std::list<zb_device_params_t*> _bound_devices;
+
+    static bool _is_bound;
 
     // Set ep config and cluster list
     void set_ep_config(esp_zb_endpoint_config_t ep_config, esp_zb_cluster_list_t *cluster_list) {
         _ep_config = ep_config;
         _cluster_list = cluster_list;
     }
 
-    static bool _is_bound;
+    void setVersion(uint8_t version);
+
     static bool is_bound() { return _is_bound; }
+    void printBoundDevices();
 
     static bool _allow_multiple_binding;
     static void allowMultipleBinding(bool bind) { _allow_multiple_binding = bind; }
@@ -72,7 +82,4 @@ class Zigbee_EP {
     virtual void readBasicCluster(uint16_t cluster_id, const esp_zb_zcl_attribute_t *attribute); //already implemented
 
     friend class ZigbeeCore;
-
-    // List of Zigbee EP classes 
-    friend class ZigbeeLight;
 };

libraries/Zigbee/src/Zigbee_ep.h

@@ -2,15 +2,14 @@
 
 ZigbeeColorDimmableLight::ZigbeeColorDimmableLight(uint8_t endpoint) : Zigbee_EP(endpoint) {
     _device_id = ESP_ZB_HA_COLOR_DIMMABLE_LIGHT_DEVICE_ID;
-    _version = 0;
 
     esp_zb_color_dimmable_light_cfg_t light_cfg = ESP_ZB_DEFAULT_COLOR_DIMMABLE_LIGHT_CONFIG();
     _cluster_list = esp_zb_color_dimmable_light_clusters_create(&light_cfg);
     _ep_config = {       
         .endpoint = _endpoint,
         .app_profile_id = ESP_ZB_AF_HA_PROFILE_ID,
         .app_device_id = ESP_ZB_HA_COLOR_DIMMABLE_LIGHT_DEVICE_ID,
-        .app_device_version = _version
+        .app_device_version = 0
     };
 }