Merge branch 'release/esp-zigbee-sdk-v1.6.1' into 'main'

esp-zigbee-sdk: release/v1.6.1(46f74423)

See merge request espressif/esp-zigbee-sdk!154

.gitlab/ci/common.yml

@@ -7,7 +7,7 @@ stages:
 variables:
     GIT_STRATEGY: fetch
     GIT_SUBMODULE_STRATEGY: none
-    DEFAULT_IDF_VERSION: "v5.3.1"
+    DEFAULT_IDF_VERSION: "v5.3.2"
     DEFAULT_DOC_DOCKER_ENV: "v5.3:1-1"
     # tell build system do not check submodule update as we download archive instead of clone
     IDF_SKIP_CHECK_SUBMODULES: 1

RELEASE_NOTES.md

@@ -1,5 +1,30 @@
 # Espressif Zigbee SDK Release Notes
 
+## 05-Dec-2024
+1.6.1 version release of ESP-ZIGBEE-SDK is based on esp-idf v5.3.2
+
+### Features
+- Added support for APS to send data requests in parallel to multiple devices
+- Added support for ZCL dehumidification control cluster
+- Added support for ZCL OTA upgrade cluster to process commands with wildcard parameters
+- Added support for APP to configure Zigbee non-volatile memory by setting the size of zb_storage partition
+- Added support for ESP32C6 and ESP32C5 to communicate via radio spinel
+- Added API to enable/disable install code only mode at runtime
+
+### Bug Fixes
+- Fixed the crash on coordinator when numerous devices attempt to associate with the network simultaneously
+- Fixed the crash caused by insufficient delayed buffers for MAC transactions
+- Fixed the infinite loop issue when the tx queue is no sufficient on ZB_RADIO_SPINEL_UART enabled device
+- Fixed the issue where APS fragments could not be sent again after a previous fragment is not acked
+- Fixed the rejoin issue for Touchlink initiator when attempting to start the network with the second target
+- Fixed the issue where ZDO mgmt LQI req will not trigger user_cb when the response neighbor table is empty
+
+### Changes
+- Updated esp-zboss-lib to v1.6.1
+- Updated esp-zigbee-lib to v1.6.1
+- Rename `ESP_ZB_ZCL_CLUSTER_ID_DEHUMID_CONTROL` to `ESP_ZB_ZCL_CLUSTER_ID_DEHUMIDIFICATION_CONTROL`
+
+
 ## 01-NOV-2024
 1.6.0 version release of ESP-ZIGBEE-SDK is based on esp-idf v5.3.1
 

components/esp-zigbee-console/src/zb_data/zcl.c

@@ -102,7 +102,7 @@ const static esp_zcl_cluster_fn_t s_cluster_fn_table[] = {
     CLUSTER_NON_SUPPORT_FN_ENTRY(pump_config_control, ESP_ZB_ZCL_CLUSTER_ID_PUMP_CONFIG_CONTROL),
     CLUSTER_FN_ENTRY(thermostat, ESP_ZB_ZCL_CLUSTER_ID_THERMOSTAT),
     CLUSTER_FN_ENTRY(fan_control, ESP_ZB_ZCL_CLUSTER_ID_FAN_CONTROL),
-    CLUSTER_NON_SUPPORT_FN_ENTRY(dehumid_control, ESP_ZB_ZCL_CLUSTER_ID_DEHUMID_CONTROL),
+    CLUSTER_FN_ENTRY(dehumidification_control, ESP_ZB_ZCL_CLUSTER_ID_DEHUMIDIFICATION_CONTROL),
     CLUSTER_FN_ENTRY(thermostat_ui_config, ESP_ZB_ZCL_CLUSTER_ID_THERMOSTAT_UI_CONFIG),
     CLUSTER_FN_ENTRY(color_control, ESP_ZB_ZCL_CLUSTER_ID_COLOR_CONTROL),
     CLUSTER_NON_SUPPORT_FN_ENTRY(ballast_config, ESP_ZB_ZCL_CLUSTER_ID_BALLAST_CONFIG),

components/esp-zigbee-lib/CMakeLists.txt

@@ -21,18 +21,18 @@ if(CONFIG_ZB_ENABLED)
 
     if(CONFIG_ZB_ZCZR)
         if(CONFIG_ZB_DEBUG_MODE)
-            add_prebuilt_library(esp_zigbee_api_lib "${CMAKE_CURRENT_SOURCE_DIR}/lib/${idf_target}/libesp_zb_api_zczr.debug.a" REQUIRES espressif__esp-zboss-lib)
+            add_prebuilt_library(esp_zigbee_api_lib "${CMAKE_CURRENT_SOURCE_DIR}/lib/${idf_target}/libesp_zb_api.zczr.debug.a" REQUIRES espressif__esp-zboss-lib)
         else()
-            add_prebuilt_library(esp_zigbee_api_lib "${CMAKE_CURRENT_SOURCE_DIR}/lib/${idf_target}/libesp_zb_api_zczr.a" REQUIRES espressif__esp-zboss-lib)
+            add_prebuilt_library(esp_zigbee_api_lib "${CMAKE_CURRENT_SOURCE_DIR}/lib/${idf_target}/libesp_zb_api.zczr.a" REQUIRES espressif__esp-zboss-lib)
         endif()
     elseif(CONFIG_ZB_ZED)
         if(CONFIG_ZB_DEBUG_MODE)
-            add_prebuilt_library(esp_zigbee_api_lib "${CMAKE_CURRENT_SOURCE_DIR}/lib/${idf_target}/libesp_zb_api_ed.debug.a" REQUIRES espressif__esp-zboss-lib)
+            add_prebuilt_library(esp_zigbee_api_lib "${CMAKE_CURRENT_SOURCE_DIR}/lib/${idf_target}/libesp_zb_api.ed.debug.a" REQUIRES espressif__esp-zboss-lib)
         else()
-            add_prebuilt_library(esp_zigbee_api_lib "${CMAKE_CURRENT_SOURCE_DIR}/lib/${idf_target}/libesp_zb_api_ed.a" REQUIRES espressif__esp-zboss-lib)
+            add_prebuilt_library(esp_zigbee_api_lib "${CMAKE_CURRENT_SOURCE_DIR}/lib/${idf_target}/libesp_zb_api.ed.a" REQUIRES espressif__esp-zboss-lib)
         endif()
     elseif(CONFIG_ZB_ZGPD)
-        add_prebuilt_library(esp_zigbee_api_lib "${CMAKE_CURRENT_SOURCE_DIR}/lib/${idf_target}/libesp_zb_api_gpd.a" REQUIRES espressif__esp-zboss-lib)
+        add_prebuilt_library(esp_zigbee_api_lib "${CMAKE_CURRENT_SOURCE_DIR}/lib/${idf_target}/libesp_zb_api.gpd.a" REQUIRES espressif__esp-zboss-lib)
     endif()
 
     list(APPEND ESP_ZIGBEE_API_LIBS esp_zigbee_api_lib)

components/esp-zigbee-lib/idf_component.yml

@@ -1,4 +1,4 @@
-version: "1.6.0"
+version: "1.6.1"
 description: esp-zigbee library component
 url: https://github.com/espressif/esp-zigbee-sdk
 dependencies:

components/esp-zigbee-lib/include/esp_zigbee_attribute.h

@@ -684,6 +684,20 @@ esp_err_t esp_zb_meter_identification_cluster_add_attr(esp_zb_attribute_list_t *
  */
 esp_err_t esp_zb_drlc_cluster_add_attr(esp_zb_attribute_list_t *attr_list, uint16_t attr_id, void *value_p);
 
+/**
+ * @brief Add an attribute in dehumidification control cluster.
+ *
+ * @param[in] attr_list A pointer to attribute list @ref esp_zb_attribute_list_s
+ * @param[in] attr_id  An attribute id to be added
+ * @param[in] value_p A pointer to attribute value wants to add
+ *
+ * @return
+ *      - ESP_OK on success
+ *      - ESP_ERR_INVALID_ARG if attribute is existed or unsupported
+ *
+ */
+esp_err_t esp_zb_dehumidification_control_cluster_add_attr(esp_zb_attribute_list_t *attr_list, uint16_t attr_id, void *value_p);
+
 /**
  * @brief Add an attribute in a specified cluster.
  *

components/esp-zigbee-lib/include/esp_zigbee_cluster.h

@@ -503,6 +503,16 @@ esp_zb_attribute_list_t *esp_zb_price_cluster_create(esp_zb_price_cluster_cfg_t
  */
 esp_zb_attribute_list_t *esp_zb_drlc_cluster_create(esp_zb_drlc_cluster_cfg_t *drlc_cfg);
 
+/**
+ * @brief  Create a standard dehumidification control attribute list
+ *
+ * @param[in] dehumidification_cfg Configuration parameters for this cluster defined by @ref esp_zb_dehumidification_control_cluster_cfg_s
+ *
+ * @return pointer to attribute list @ref esp_zb_attribute_list_s
+ *
+ */
+esp_zb_attribute_list_t *esp_zb_dehumidification_control_cluster_create(esp_zb_dehumidification_control_cluster_cfg_t *dehumidification_cfg);
+
 /**************************************** ADD CLUSTER ***********************************/
 /**
  * @brief Add basic cluster (attribute list) in a cluster list.
@@ -1123,6 +1133,20 @@ esp_err_t esp_zb_cluster_list_add_price_cluster(esp_zb_cluster_list_t *cluster_l
  */
 esp_err_t esp_zb_cluster_list_add_drlc_cluster(esp_zb_cluster_list_t *cluster_list, esp_zb_attribute_list_t *attr_list, uint8_t role_mask);
 
+/**
+ * @brief Add dehumidification control cluster (attribute list) in a cluster list.
+ *
+ * @param[in] cluster_list A pointer to cluster list @ref esp_zb_cluster_list_s
+ * @param[in] attr_list  An attribute list which wants to add
+ * @param[in] role_mask  A role of server or client for this cluster (attribute list) refer to esp_zb_zcl_cluster_role_t
+ *
+ * @return
+ *      - ESP_OK on success
+ *      - ESP_ERR_INVALID_ARG if cluster list not initialized
+ *
+ */
+esp_err_t esp_zb_cluster_list_add_dehumidification_control_cluster(esp_zb_cluster_list_t *cluster_list, esp_zb_attribute_list_t *attr_list, uint8_t role_mask);
+
 /**
  * @brief Add customized cluster (attribute list) in a cluster list.
  *

components/esp-zigbee-lib/include/esp_zigbee_secur.h

@@ -24,6 +24,15 @@ typedef enum {
 } esp_zb_secur_ic_type_t;
 /********************* Declare functions **************************/
 
+/**
+ * @brief Enable Trust Center to only use install code policy
+ *
+ * @param[in] enabled A boolean indicating whether only the install code policy is enabled.
+ * @return
+ *      - ESP_OK: on success, otherwise, failed
+ */
+esp_err_t esp_zb_secur_ic_only_enable(bool enabled);
+
 /**
  * @brief   Get the Zigbee install code from storage
  *

components/esp-zigbee-lib/include/esp_zigbee_type.h

@@ -804,7 +804,17 @@ typedef struct esp_zb_drlc_cluster_cfg_s {
 } esp_zb_drlc_cluster_cfg_t;
 
 /**
- * @brief Zigbee standard mandatory attribute for toucklink commissioning cluster
+ * @brief Zigbee standard mandatory attribute for dehumidification control cluster
+ */
+typedef struct esp_zb_dehumidification_control_cluster_cfg_s {
+    uint8_t cooling;        /*!< This attribute specifies the current dehumidification cooling output (in %) */
+    uint8_t set_point;      /*!< This attribute represents the relative humidity (in %) at which dehumidification occurs */
+    uint8_t hysteresis;     /*!< This attribute specifies the hysteresis (in %) associated with RelativeHumidity value */
+    uint16_t max_cool;      /*!< This attribute specifies the maximum dehumidification cooling output (in %) */
+} esp_zb_dehumidification_control_cluster_cfg_t;
+
+/**
+ * @brief Zigbee standard mandatory attribute for touchlink commissioning cluster
  *
  */
 typedef struct esp_zb_touchlink_commissioning_cfg_s {

components/esp-zigbee-lib/include/esp_zigbee_version.h

@@ -15,5 +15,5 @@
 #endif
 
 #ifndef ESP_ZB_VER_PATCH
-#define ESP_ZB_VER_PATCH 0
+#define ESP_ZB_VER_PATCH 1
 #endif

components/esp-zigbee-lib/include/zcl/esp_zigbee_zcl_common.h

@@ -53,6 +53,7 @@ extern "C" {
 #include "esp_zigbee_zcl_ph_measurement.h"
 #include "esp_zigbee_zcl_wind_speed_measurement.h"
 #include "esp_zigbee_zcl_drlc.h"
+#include "esp_zigbee_zcl_dehumidification_control.h"
 
 #ifdef ZB_ENABLE_ZGP
 #include "esp_zigbee_zcl_green_power.h"
@@ -165,7 +166,7 @@ typedef enum {
     ESP_ZB_ZCL_CLUSTER_ID_PUMP_CONFIG_CONTROL   = 0x0200U,          /*!< Pump configuration and control cluster identifier. */
     ESP_ZB_ZCL_CLUSTER_ID_THERMOSTAT            = 0x0201U,          /*!< Thermostat cluster identifier. */
     ESP_ZB_ZCL_CLUSTER_ID_FAN_CONTROL           = 0x0202U,          /*!< Fan control cluster identifier. */
-    ESP_ZB_ZCL_CLUSTER_ID_DEHUMID_CONTROL       = 0x0203U,          /*!< Dehumidification control cluster identifier. */
+    ESP_ZB_ZCL_CLUSTER_ID_DEHUMIDIFICATION_CONTROL = 0x0203U,       /*!< Dehumidification control cluster identifier. */
     ESP_ZB_ZCL_CLUSTER_ID_THERMOSTAT_UI_CONFIG  = 0x0204U,          /*!< Thermostat user interface configuration cluster identifier. */
     ESP_ZB_ZCL_CLUSTER_ID_COLOR_CONTROL         = 0x0300U,          /*!< Color control cluster identifier. */
     ESP_ZB_ZCL_CLUSTER_ID_BALLAST_CONFIG        = 0x0301U,          /*!< Ballast configuration cluster identifier. */

components/esp-zigbee-lib/include/zcl/esp_zigbee_zcl_dehumidification_control.h

@@ -0,0 +1,93 @@
+/*
+ * SPDX-FileCopyrightText: 2024 Espressif Systems (Shanghai) CO LTD
+ *
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+#pragma once
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+#include "esp_zigbee_type.h"
+
+/** @brief Dehumidification Control cluster attribute identifiers */
+typedef enum esp_zb_zcl_dehumidification_control_attr_e {
+    ESP_ZB_ZCL_ATTR_DEHUMIDIFICATION_CONTROL_RELATIVE_HUMIDITY_ID           = 0x0000, /*!< The RelativeHumidity attribute is an 8-bit value that represents the
+                                                                                           current relative humidity (in %) measured by a local or remote sensor. */
+    ESP_ZB_ZCL_ATTR_DEHUMIDIFICATION_CONTROL_DEHUMIDIFICATION_COOLING_ID    = 0x0001, /*!< Dehumidification Cooling attribute */
+    ESP_ZB_ZCL_ATTR_DEHUMIDIFICATION_CONTROL_RHDEHUMIDIFICATION_SETPOINT_ID = 0x0010, /*!< RHDehumidification Setpoint attribute */
+    ESP_ZB_ZCL_ATTR_DEHUMIDIFICATION_CONTROL_RELATIVE_HUMIDITY_MODE_ID      = 0x0011, /*!< The RelativeHumidityMode attribute is an 8-bit value that specifies
+                                                                                           how the RelativeHumidity value is being updated. */
+    ESP_ZB_ZCL_ATTR_DEHUMIDIFICATION_CONTROL_DEHUMIDIFICATION_LOCKOUT_ID    = 0x0012, /*!< The DehumidificationLockout attribute is an 8-bit value that specifies
+                                                                                           whether dehumidification is allowed or not. */
+    ESP_ZB_ZCL_ATTR_DEHUMIDIFICATION_CONTROL_DEHUMIDIFICATION_HYSTERESIS_ID = 0x0013, /*!< Dehumidification Hysteresis attribute */
+    ESP_ZB_ZCL_ATTR_DEHUMIDIFICATION_CONTROL_DEHUMIDIFICATION_MAX_COOL_ID   = 0x0014, /*!< Dehumidification Max Cool attribute */
+    ESP_ZB_ZCL_ATTR_DEHUMIDIFICATION_CONTROL_RELATIVE_HUMIDITY_DISPLAY_ID   = 0x0015, /*!< The RelativeHumidityDisplay attribute is an 8-bit value that specifies
+                                                                                           whether the RelativeHumidity value is displayed to the user or not. */
+} esp_zb_zcl_dehumidification_control_attr_t;
+
+
+/** @brief Default value for Dehumidification Control cluster revision global attribute */
+#define ESP_ZB_ZCL_DEHUMIDIFICATION_CONTROL_CLUSTER_REVISION_DEFAULT 0x0001
+
+/** @brief Min value for RHDehumidification Setpoint attribute */
+#define ESP_ZB_ZCL_DEHUMIDIFICATION_CONTROL_RHDEHUMIDIFICATION_SETPOINT_MIN_VALUE 0x1e
+
+/** @brief Max value for RHDehumidification Setpoint attribute */
+#define ESP_ZB_ZCL_DEHUMIDIFICATION_CONTROL_RHDEHUMIDIFICATION_SETPOINT_MAX_VALUE 0x64
+
+/** @brief Default value for RHDehumidification Setpoint attribute */
+#define ESP_ZB_ZCL_DEHUMIDIFICATION_CONTROL_RHDEHUMIDIFICATION_SETPOINT_DEFAULT_VALUE 0x32
+
+/** @brief Default value for RelativeHumidityMode attribute */
+#define ESP_ZB_ZCL_DEHUMIDIFICATION_CONTROL_RELATIVE_HUMIDITY_MODE_DEFAULT_VALUE ((uint8_t)ESP_ZCL_DEHUMIDIFICATION_CONTROL_RELATIVE_HUMIDITY_MEASURED_LOCALLY)
+
+/** @brief Default value for DehumidificationLockout attribute */
+#define ESP_ZB_ZCL_DEHUMIDIFICATION_CONTROL_DEHUMIDIFICATION_LOCKOUT_DEFAULT_VALUE ((uint8_t)ESP_ZCL_DEHUMIDIFICATION_CONTROL_DEHUMIDIFICATION_LOCKOUT_ALLOWED)
+
+/** @brief Min value for Dehumidification Hysteresis attribute */
+#define ESP_ZB_ZCL_DEHUMIDIFICATION_CONTROL_DEHUMIDIFICATION_HYSTERESIS_MIN_VALUE 0x02
+
+/** @brief Max value for Dehumidification Hysteresis attribute */
+#define ESP_ZB_ZCL_DEHUMIDIFICATION_CONTROL_DEHUMIDIFICATION_HYSTERESIS_MAX_VALUE 0x14
+
+/** @brief Default value for Dehumidification Hysteresis attribute */
+#define ESP_ZB_ZCL_DEHUMIDIFICATION_CONTROL_DEHUMIDIFICATION_HYSTERESIS_DEFAULT_VALUE 0x02
+
+/** @brief Default value for Dehumidification Cool attribute */
+#define ESP_ZB_ZCL_DEHUMIDIFICATION_CONTROL_DEHUMIDIFICATION_COOL_DEFAULT_VALUE 0x00
+
+/** @brief Min value for Dehumidification Max Cool attribute */
+#define ESP_ZB_ZCL_DEHUMIDIFICATION_CONTROL_DEHUMIDIFICATION_MAX_COOL_MIN_VALUE 0x14
+
+/** @brief Max value for Dehumidification Max Cool attribute */
+#define ESP_ZB_ZCL_DEHUMIDIFICATION_CONTROL_DEHUMIDIFICATION_MAX_COOL_MAX_VALUE 0x64
+
+/** @brief Default value for Dehumidification Max Cool attribute */
+#define ESP_ZB_ZCL_DEHUMIDIFICATION_CONTROL_DEHUMIDIFICATION_MAX_COOL_DEFAULT_VALUE 0x14
+
+/** @brief Default value for RelativeHumidityDisplay attribute */
+#define ESP_ZB_ZCL_DEHUMIDIFICATION_CONTROL_RELATIVE_HUMIDITY_DISPLAY_DEFAULT_VALUE ((uint8_t)ESP_ZCL_DEHUMIDIFICATION_CONTROL_RELATIVE_HUMIDITY_NOT_DISPLAYED)
+
+/** @brief Enumerate the RelativeHumidityMode Attribute */
+typedef enum esp_zb_zcl_dehumidification_control_relative_humidity_mode_e {
+    ESP_ZCL_DEHUMIDIFICATION_CONTROL_RELATIVE_HUMIDITY_MEASURED_LOCALLY         = 0x00, /*!< RelativeHumidity measured locally */
+    ESP_ZCL_DEHUMIDIFICATION_CONTROL_RELATIVE_HUMIDITY_UPDATED_OVER_THE_NETWORK,        /*!< RelativeHumidity updated over the network */
+} esp_zb_zcl_dehumidification_control_relative_humidity_mode_t;
+
+/** @brief Enumerate the DehumidificationLockout Attribute */
+typedef enum esp_zb_zcl_dehumidification_control_dehumidification_lockout_e {
+    ESP_ZCL_DEHUMIDIFICATION_CONTROL_DEHUMIDIFICATION_LOCKOUT_NOT_ALLOWED  = 0x00, /*!< Dehumidification is not allowed */
+    ESP_ZCL_DEHUMIDIFICATION_CONTROL_DEHUMIDIFICATION_LOCKOUT_ALLOWED,             /*!< Dehumidification is allowed */
+} esp_zb_zcl_dehumidification_control_dehumidification_lockout_t;
+
+/** @brief Enumerate the RelativeHumidityDisplay Attribute */
+typedef enum esp_zb_zcl_dehumidification_control_relative_humidity_display_e {
+    ESP_ZCL_DEHUMIDIFICATION_CONTROL_RELATIVE_HUMIDITY_NOT_DISPLAYED    = 0x00, /*!< RelativeHumidity is not displayed */
+    ESP_ZCL_DEHUMIDIFICATION_CONTROL_RELATIVE_HUMIDITY_DISPLAYED,               /*!< RelativeHumidity is displayed */
+} esp_zb_zcl_dehumidification_control_relative_humidity_display_t;
+
+#ifdef __cplusplus
+}
+#endif

components/esp-zigbee-ncp/src/esp_ncp_zb.c

@@ -956,7 +956,7 @@ static esp_ncp_zb_cluster_fn_t cluster_list_fn_table[] = {
     { ESP_ZB_ZCL_CLUSTER_ID_PUMP_CONFIG_CONTROL        , esp_zb_cluster_list_add_custom_cluster , NULL },
     { ESP_ZB_ZCL_CLUSTER_ID_THERMOSTAT                 , esp_zb_cluster_list_add_thermostat_cluster , NULL },
     { ESP_ZB_ZCL_CLUSTER_ID_FAN_CONTROL                , esp_zb_cluster_list_add_fan_control_cluster , NULL },
-    { ESP_ZB_ZCL_CLUSTER_ID_DEHUMID_CONTROL            , esp_zb_cluster_list_add_custom_cluster , NULL },
+    { ESP_ZB_ZCL_CLUSTER_ID_DEHUMIDIFICATION_CONTROL   , esp_zb_cluster_list_add_dehumidification_control_cluster , NULL },
     { ESP_ZB_ZCL_CLUSTER_ID_THERMOSTAT_UI_CONFIG       , esp_zb_cluster_list_add_thermostat_ui_config_cluster , NULL },
     { ESP_ZB_ZCL_CLUSTER_ID_COLOR_CONTROL              , esp_zb_cluster_list_add_color_control_cluster , NULL },
     { ESP_ZB_ZCL_CLUSTER_ID_BALLAST_CONFIG             , esp_zb_cluster_list_add_custom_cluster , NULL },

docs/Doxyfile

@@ -76,6 +76,7 @@ INPUT = \
     $(PROJECT_PATH)/components/esp-zigbee-lib/include/zcl/esp_zigbee_zcl_ph_measurement.h              \
     $(PROJECT_PATH)/components/esp-zigbee-lib/include/zcl/esp_zigbee_zcl_wind_speed_measurement.h      \
     $(PROJECT_PATH)/components/esp-zigbee-lib/include/zcl/esp_zigbee_zcl_drlc.h                        \
+    $(PROJECT_PATH)/components/esp-zigbee-lib/include/zcl/esp_zigbee_zcl_dehumidification_control.h    \
     $(PROJECT_PATH)/components/esp-zigbee-lib/include/zdo/esp_zigbee_zdo_command.h                     \
     $(PROJECT_PATH)/components/esp-zigbee-lib/include/zdo/esp_zigbee_zdo_common.h                      \
     $(PROJECT_PATH)/components/esp-zigbee-lib/include/bdb/esp_zigbee_bdb_touchlink.h                   \

docs/en/api-reference/zcl/esp_zigbee_zcl_dehumidification_control.rst

@@ -0,0 +1,7 @@
+ZCL Dehumidification Control
+============================
+
+Zigbee Cluster Library (ZCL) dehumidification control usage definition for ESP Zigbee SDK.
+
+
+.. include-build-file:: inc/esp_zigbee_zcl_dehumidification_control.inc

docs/en/api-reference/zcl/index.rst

@@ -52,4 +52,5 @@ This section provides the ESP Zigbee SDK's APIs that support different kind of Z
    esp_zigbee_zcl_ec_measurement
    esp_zigbee_zcl_ph_measurement
    esp_zigbee_zcl_wind_speed_measurement
-   esp_zigbee_zcl_drlc
+   esp_zigbee_zcl_drlc
+   esp_zigbee_zcl_dehumidification_control

docs/en/developing.rst

@@ -11,15 +11,15 @@ This section talks about setting up your development environment, fetching the G
 
 2.1.1 Setting up the Repositories
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-Follow the `ESP-IDF getting started guide <https://docs.espressif.com/projects/esp-idf/en/latest/esp32/get-started/index.html>`_ to set up the IDF development environment. For beginners, please check `Installation Step by Step <https://docs.espressif.com/projects/esp-idf/en/v5.1.3/esp32h2/get-started/linux-macos-setup.html#installation-step-by-step>`_ for esp-idf.
+Follow the `ESP-IDF getting started guide <https://docs.espressif.com/projects/esp-idf/en/latest/esp32/get-started/index.html>`_ to set up the IDF development environment. For beginners, please check `Installation Step by Step <https://docs.espressif.com/projects/esp-idf/en/v5.3.2/esp32h2/get-started/linux-macos-setup.html#installation-step-by-step>`_ for esp-idf.
 
 Cloning esp-idf:
 
 .. code-block:: bash
 
    git clone --recursive https://github.com/espressif/esp-idf.git
    cd esp-idf
-   git checkout v5.1.3
+   git checkout v5.3.2
    git submodule update --init --recursive
    ./install.sh
    source ./export.sh

docs/en/introduction.rst

@@ -99,6 +99,7 @@ The supported features in current ESP Zigbee SDK are listed below:
      window_covering                        0x0102
      thermostat                             0x0201
      fan_control                            0x0202
+     dehumidification_control               0x0203
      thermostat_user_interface              0x0204
      color_control                          0x0300
      illuminance_measurement                0x0400