feat(docs( Zigbee docs update

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

docs/en/zigbee/ep_binary.rst

@@ -6,22 +6,11 @@ About
 -----
 
 The ``ZigbeeBinary`` class provides an endpoint for binary input/output sensors in Zigbee networks. This endpoint implements the Zigbee Home Automation (HA) standard for binary sensors, supporting various application types for HVAC, security, and general binary sensing.
+Binary Input (BI) is meant to be used for sensors that provide a binary signal, such as door/window sensors, motion detectors, etc. to be sent to the network.
 
-**Features:**
-* Binary input sensor support
-* Configurable application types (HVAC, Security, etc.)
-* Custom description support
-* Automatic reporting capabilities
-* Integration with common endpoint features (binding, OTA, etc.)
-* Zigbee HA standard compliance
-
-**Use Cases:**
-* Door/window sensors
-* Motion detectors
-* Smoke alarms
-* HVAC status monitoring
-* Security system sensors
-* Any on/off sensor application
+.. note::
+
+    Binary Output (BO) is not supported yet.
 
 API Reference
 -------------
@@ -138,8 +127,8 @@ Manually reports the current binary input value.
 
 This function will return ``true`` if successful, ``false`` otherwise.
 
-Usage Example
--------------
+Example
+-------
 
 Binary Input Implementation
 ****************************

docs/en/zigbee/ep_carbon_dioxide_sensor.rst

@@ -7,22 +7,6 @@ About
 
 The ``ZigbeeCarbonDioxideSensor`` class provides a CO2 sensor endpoint for Zigbee networks. This endpoint implements the Zigbee Home Automation (HA) standard for carbon dioxide measurement devices.
 
-**Features:**
-* CO2 concentration measurement in ppm
-* Configurable measurement range
-* Tolerance and reporting configuration
-* Automatic reporting capabilities
-* Integration with common endpoint features (binding, OTA, etc.)
-* Zigbee HA standard compliance
-
-**Use Cases:**
-* Indoor air quality monitoring
-* Smart home ventilation control
-* HVAC system air quality control
-* Industrial air quality monitoring
-* Health and safety monitoring
-* Environmental monitoring systems
-
 API Reference
 -------------
 
@@ -109,8 +93,8 @@ Manually reports the current CO2 concentration value.
 
 This function will return ``true`` if successful, ``false`` otherwise.
 
-Usage Example
--------------
+Example
+-------
 
 CO2 Sensor Implementation
 *************************

docs/en/zigbee/ep_color_dimmable_light.rst

@@ -213,8 +213,8 @@ Restores the light to its last known state.
 
     void restoreLight();
 
-Usage Example
--------------
+Example
+-------
 
 Color Dimmable Light Implementation
 ***********************************

docs/en/zigbee/ep_color_dimmer_switch.rst

@@ -212,8 +212,8 @@ Turns on lights by recalling a scene.
 
     void lightOnWithSceneRecall();
 
-Usage Example
--------------
+Example
+-------
 
 Color Dimmer Switch Implementation
 **********************************

docs/en/zigbee/ep_contact_switch.rst

@@ -78,8 +78,8 @@ Manually reports the current contact state.
 
 This function will return ``true`` if successful, ``false`` otherwise.
 
-Usage Example
--------------
+Example
+-------
 
 Contact Switch Implementation
 *****************************

docs/en/zigbee/ep_dimmable_light.rst

@@ -128,8 +128,8 @@ Sets a callback function to be called when the light state or level changes.
 * ``bool state`` - New light state (true = on, false = off)
 * ``uint8_t level`` - New brightness level (0-100)
 
-Usage Example
--------------
+Example
+-------
 
 Dimmable Light Implementation
 *****************************

docs/en/zigbee/ep_door_window_handle.rst

@@ -121,5 +121,7 @@ Manually reports the current handle position.
 
 This function will return ``true`` if successful, ``false`` otherwise.
 
-Usage Example
--------------
+Example
+-------
+
+*To be added*

docs/en/zigbee/ep_electrical_measurement.rst

@@ -52,9 +52,9 @@ Adds a DC measurement type to the endpoint.
 
 .. code-block:: arduino
 
-    bool addDCMeasurement(uint16_t measurement_type);
+    bool addDCMeasurement(ZIGBEE_DC_MEASUREMENT_TYPE measurement_type);
 
-* ``measurement_type`` - DC measurement type constant
+* ``measurement_type`` - DC measurement type constant (ZIGBEE_DC_MEASUREMENT_TYPE_VOLTAGE, ZIGBEE_DC_MEASUREMENT_TYPE_CURRENT, ZIGBEE_DC_MEASUREMENT_TYPE_POWER)
 
 This function will return ``true`` if successful, ``false`` otherwise.
 
@@ -65,9 +65,9 @@ Sets the DC measurement value for a specific measurement type.
 
 .. code-block:: arduino
 
-    bool setDCMeasurement(uint16_t measurement_type, int32_t value);
+    bool setDCMeasurement(ZIGBEE_DC_MEASUREMENT_TYPE measurement_type, int16_t value);
 
-* ``measurement_type`` - DC measurement type constant
+* ``measurement_type`` - DC measurement type constant (ZIGBEE_DC_MEASUREMENT_TYPE_VOLTAGE, ZIGBEE_DC_MEASUREMENT_TYPE_CURRENT, ZIGBEE_DC_MEASUREMENT_TYPE_POWER)
 * ``value`` - Measurement value
 
 This function will return ``true`` if successful, ``false`` otherwise.
@@ -79,9 +79,9 @@ Sets the minimum and maximum values for a DC measurement type.
 
 .. code-block:: arduino
 
-    bool setDCMinMaxValue(uint16_t measurement_type, int32_t min, int32_t max);
+    bool setDCMinMaxValue(ZIGBEE_DC_MEASUREMENT_TYPE measurement_type, int16_t min, int16_t max);
 
-* ``measurement_type`` - DC measurement type constant
+* ``measurement_type`` - DC measurement type constant (ZIGBEE_DC_MEASUREMENT_TYPE_VOLTAGE, ZIGBEE_DC_MEASUREMENT_TYPE_CURRENT, ZIGBEE_DC_MEASUREMENT_TYPE_POWER)
 * ``min`` - Minimum value
 * ``max`` - Maximum value
 
@@ -94,9 +94,9 @@ Sets the multiplier and divisor for scaling DC measurements.
 
 .. code-block:: arduino
 
-    bool setDCMultiplierDivisor(uint16_t measurement_type, uint16_t multiplier, uint16_t divisor);
+    bool setDCMultiplierDivisor(ZIGBEE_DC_MEASUREMENT_TYPE measurement_type, uint16_t multiplier, uint16_t divisor);
 
-* ``measurement_type`` - DC measurement type constant
+* ``measurement_type`` - DC measurement type constant (ZIGBEE_DC_MEASUREMENT_TYPE_VOLTAGE, ZIGBEE_DC_MEASUREMENT_TYPE_CURRENT, ZIGBEE_DC_MEASUREMENT_TYPE_POWER)
 * ``multiplier`` - Multiplier value
 * ``divisor`` - Divisor value
 
@@ -109,9 +109,9 @@ Sets the reporting configuration for DC measurements.
 
 .. code-block:: arduino
 
-    bool setDCReporting(uint16_t measurement_type, uint16_t min_interval, uint16_t max_interval, int32_t delta);
+    bool setDCReporting(ZIGBEE_DC_MEASUREMENT_TYPE measurement_type, uint16_t min_interval, uint16_t max_interval, int16_t delta);
 
-* ``measurement_type`` - DC measurement type constant
+* ``measurement_type`` - DC measurement type constant (ZIGBEE_DC_MEASUREMENT_TYPE_VOLTAGE, ZIGBEE_DC_MEASUREMENT_TYPE_CURRENT, ZIGBEE_DC_MEASUREMENT_TYPE_POWER)
 * ``min_interval`` - Minimum reporting interval in seconds
 * ``max_interval`` - Maximum reporting interval in seconds
 * ``delta`` - Minimum change required to trigger a report
@@ -125,9 +125,9 @@ Manually reports a DC measurement value.
 
 .. code-block:: arduino
 
-    bool reportDC(uint16_t measurement_type);
+    bool reportDC(ZIGBEE_DC_MEASUREMENT_TYPE measurement_type);
 
-* ``measurement_type`` - DC measurement type constant
+* ``measurement_type`` - DC measurement type constant (ZIGBEE_DC_MEASUREMENT_TYPE_VOLTAGE, ZIGBEE_DC_MEASUREMENT_TYPE_CURRENT, ZIGBEE_DC_MEASUREMENT_TYPE_POWER)
 
 This function will return ``true`` if successful, ``false`` otherwise.
 
@@ -141,10 +141,10 @@ Adds an AC measurement type for a specific phase.
 
 .. code-block:: arduino
 
-    bool addACMeasurement(uint16_t measurement_type, uint8_t phase);
+    bool addACMeasurement(ZIGBEE_AC_MEASUREMENT_TYPE measurement_type, ZIGBEE_AC_PHASE_TYPE phase_type);
 
-* ``measurement_type`` - AC measurement type constant
-* ``phase`` - Phase number (1-3)
+* ``measurement_type`` - AC measurement type constant (ZIGBEE_AC_MEASUREMENT_TYPE_VOLTAGE, ZIGBEE_AC_MEASUREMENT_TYPE_CURRENT, ZIGBEE_AC_MEASUREMENT_TYPE_POWER, ZIGBEE_AC_MEASUREMENT_TYPE_POWER_FACTOR, ZIGBEE_AC_MEASUREMENT_TYPE_FREQUENCY)
+* ``phase_type`` - Phase type constant (ZIGBEE_AC_PHASE_TYPE_NON_SPECIFIC, ZIGBEE_AC_PHASE_TYPE_A, ZIGBEE_AC_PHASE_TYPE_B, ZIGBEE_AC_PHASE_TYPE_C)
 
 This function will return ``true`` if successful, ``false`` otherwise.
 
@@ -155,10 +155,10 @@ Sets the AC measurement value for a specific measurement type and phase.
 
 .. code-block:: arduino
 
-    bool setACMeasurement(uint16_t measurement_type, uint8_t phase, int32_t value);
+    bool setACMeasurement(ZIGBEE_AC_MEASUREMENT_TYPE measurement_type, ZIGBEE_AC_PHASE_TYPE phase_type, int32_t value);
 
-* ``measurement_type`` - AC measurement type constant
-* ``phase`` - Phase number (1-3)
+* ``measurement_type`` - AC measurement type constant (ZIGBEE_AC_MEASUREMENT_TYPE_VOLTAGE, ZIGBEE_AC_MEASUREMENT_TYPE_CURRENT, ZIGBEE_AC_MEASUREMENT_TYPE_POWER, ZIGBEE_AC_MEASUREMENT_TYPE_POWER_FACTOR, ZIGBEE_AC_MEASUREMENT_TYPE_FREQUENCY)
+* ``phase_type`` - Phase type constant (ZIGBEE_AC_PHASE_TYPE_NON_SPECIFIC, ZIGBEE_AC_PHASE_TYPE_A, ZIGBEE_AC_PHASE_TYPE_B, ZIGBEE_AC_PHASE_TYPE_C)
 * ``value`` - Measurement value
 
 This function will return ``true`` if successful, ``false`` otherwise.
@@ -170,10 +170,10 @@ Sets the minimum and maximum values for an AC measurement type and phase.
 
 .. code-block:: arduino
 
-    bool setACMinMaxValue(uint16_t measurement_type, uint8_t phase, int32_t min, int32_t max);
+    bool setACMinMaxValue(ZIGBEE_AC_MEASUREMENT_TYPE measurement_type, ZIGBEE_AC_PHASE_TYPE phase_type, int32_t min, int32_t max);
 
-* ``measurement_type`` - AC measurement type constant
-* ``phase`` - Phase number (1-3)
+* ``measurement_type`` - AC measurement type constant (ZIGBEE_AC_MEASUREMENT_TYPE_VOLTAGE, ZIGBEE_AC_MEASUREMENT_TYPE_CURRENT, ZIGBEE_AC_MEASUREMENT_TYPE_POWER, ZIGBEE_AC_MEASUREMENT_TYPE_POWER_FACTOR, ZIGBEE_AC_MEASUREMENT_TYPE_FREQUENCY)
+* ``phase_type`` - Phase type constant (ZIGBEE_AC_PHASE_TYPE_NON_SPECIFIC, ZIGBEE_AC_PHASE_TYPE_A, ZIGBEE_AC_PHASE_TYPE_B, ZIGBEE_AC_PHASE_TYPE_C)
 * ``min`` - Minimum value
 * ``max`` - Maximum value
 
@@ -186,10 +186,9 @@ Sets the multiplier and divisor for scaling AC measurements.
 
 .. code-block:: arduino
 
-    bool setACMultiplierDivisor(uint16_t measurement_type, uint8_t phase, uint16_t multiplier, uint16_t divisor);
+    bool setACMultiplierDivisor(ZIGBEE_AC_MEASUREMENT_TYPE measurement_type, uint16_t multiplier, uint16_t divisor);
 
-* ``measurement_type`` - AC measurement type constant
-* ``phase`` - Phase number (1-3)
+* ``measurement_type`` - AC measurement type constant (ZIGBEE_AC_MEASUREMENT_TYPE_VOLTAGE, ZIGBEE_AC_MEASUREMENT_TYPE_CURRENT, ZIGBEE_AC_MEASUREMENT_TYPE_POWER, ZIGBEE_AC_MEASUREMENT_TYPE_POWER_FACTOR, ZIGBEE_AC_MEASUREMENT_TYPE_FREQUENCY)
 * ``multiplier`` - Multiplier value
 * ``divisor`` - Divisor value
 
@@ -202,10 +201,10 @@ Sets the power factor for a specific phase.
 
 .. code-block:: arduino
 
-    bool setACPowerFactor(uint8_t phase, int16_t power_factor);
+    bool setACPowerFactor(ZIGBEE_AC_PHASE_TYPE phase_type, int8_t power_factor);
 
-* ``phase`` - Phase number (1-3)
-* ``power_factor`` - Power factor value
+* ``phase_type`` - Phase type constant (ZIGBEE_AC_PHASE_TYPE_NON_SPECIFIC, ZIGBEE_AC_PHASE_TYPE_A, ZIGBEE_AC_PHASE_TYPE_B, ZIGBEE_AC_PHASE_TYPE_C)
+* ``power_factor`` - Power factor value (-100 to 100)
 
 This function will return ``true`` if successful, ``false`` otherwise.
 
@@ -216,10 +215,10 @@ Sets the reporting configuration for AC measurements.
 
 .. code-block:: arduino
 
-    bool setACReporting(uint16_t measurement_type, uint8_t phase, uint16_t min_interval, uint16_t max_interval, int32_t delta);
+    bool setACReporting(ZIGBEE_AC_MEASUREMENT_TYPE measurement_type, ZIGBEE_AC_PHASE_TYPE phase_type, uint16_t min_interval, uint16_t max_interval, int32_t delta);
 
-* ``measurement_type`` - AC measurement type constant
-* ``phase`` - Phase number (1-3)
+* ``measurement_type`` - AC measurement type constant (ZIGBEE_AC_MEASUREMENT_TYPE_VOLTAGE, ZIGBEE_AC_MEASUREMENT_TYPE_CURRENT, ZIGBEE_AC_MEASUREMENT_TYPE_POWER, ZIGBEE_AC_MEASUREMENT_TYPE_POWER_FACTOR, ZIGBEE_AC_MEASUREMENT_TYPE_FREQUENCY)
+* ``phase_type`` - Phase type constant (ZIGBEE_AC_PHASE_TYPE_NON_SPECIFIC, ZIGBEE_AC_PHASE_TYPE_A, ZIGBEE_AC_PHASE_TYPE_B, ZIGBEE_AC_PHASE_TYPE_C)
 * ``min_interval`` - Minimum reporting interval in seconds
 * ``max_interval`` - Maximum reporting interval in seconds
 * ``delta`` - Minimum change required to trigger a report
@@ -233,15 +232,15 @@ Manually reports an AC measurement value.
 
 .. code-block:: arduino
 
-    bool reportAC(uint16_t measurement_type, uint8_t phase);
+    bool reportAC(ZIGBEE_AC_MEASUREMENT_TYPE measurement_type, ZIGBEE_AC_PHASE_TYPE phase_type);
 
-* ``measurement_type`` - AC measurement type constant
-* ``phase`` - Phase number (1-3)
+* ``measurement_type`` - AC measurement type constant (ZIGBEE_AC_MEASUREMENT_TYPE_VOLTAGE, ZIGBEE_AC_MEASUREMENT_TYPE_CURRENT, ZIGBEE_AC_MEASUREMENT_TYPE_POWER, ZIGBEE_AC_MEASUREMENT_TYPE_POWER_FACTOR, ZIGBEE_AC_MEASUREMENT_TYPE_FREQUENCY)
+* ``phase_type`` - Phase type constant (ZIGBEE_AC_PHASE_TYPE_NON_SPECIFIC, ZIGBEE_AC_PHASE_TYPE_A, ZIGBEE_AC_PHASE_TYPE_B, ZIGBEE_AC_PHASE_TYPE_C)
 
 This function will return ``true`` if successful, ``false`` otherwise.
 
-Usage Example
--------------
+Example
+-------
 
 DC Electrical Measurement
 *************************

docs/en/zigbee/ep_flow_sensor.rst

@@ -109,8 +109,8 @@ Manually reports the current flow rate value.
 
 This function will return ``true`` if successful, ``false`` otherwise.
 
-Usage Example
--------------
+Example
+-------
 
 Flow + PressureSensor Implementation
 ************************************

docs/en/zigbee/ep_gateway.rst

@@ -6,19 +6,7 @@ About
 -----
 
 The ``ZigbeeGateway`` class provides a gateway endpoint for Zigbee networks. This endpoint implements the Zigbee Home Automation (HA) standard for network coordination and gateway functionality.
-
-**Features:**
-* Network coordination
-* Device management
-* Gateway functionality
-* Integration with common endpoint features (binding, OTA, etc.)
-* Zigbee HA standard compliance
-
-**Use Cases:**
-* Zigbee coordinators
-* Smart home hubs
-* Network gateways
-* Bridge devices to other protocols (WiFi, Ethernet, etc.)
+Gateway is a device that can be used to bridge Zigbee network to other networks (e.g. WiFi, Ethernet, etc.).
 
 API Reference
 -------------
@@ -37,8 +25,8 @@ Creates a new Zigbee gateway endpoint.
 
 * ``endpoint`` - Endpoint number (1-254)
 
-Usage Example
--------------
+Example
+-------
 
 Gateway Implementation
 **********************

docs/en/zigbee/ep_illuminance_sensor.rst

@@ -12,16 +12,6 @@ The ``ZigbeeIlluminanceSensor`` class provides an endpoint for illuminance senso
 * Configurable measurement range
 * Tolerance and reporting configuration
 * Automatic reporting capabilities
-* Integration with common endpoint features (binding, OTA, etc.)
-* Zigbee HA standard compliance
-
-**Use Cases:**
-* Ambient light monitoring
-* Smart lighting control
-* Daylight harvesting systems
-* Security lighting systems
-* Energy management systems
-* Smart home automation
 
 API Reference
 -------------
@@ -109,11 +99,11 @@ Manually reports the current illuminance value.
 
 This function will return ``true`` if successful, ``false`` otherwise.
 
-Usage Example
--------------
+Example
+-------
 
 Illuminance Sensor Implementation
-*********************************
+********************************
 
 .. literalinclude:: ../../../libraries/Zigbee/examples/Zigbee_Illuminance_Sensor/Zigbee_Illuminance_Sensor.ino
     :language: arduino