Merge remote-tracking branch 'origin/master' into dev

docs/devices/WDE002961.md → docs/devices/NH3516A.md

@@ -1,6 +1,6 @@
 ---
-title: "Schneider Electric WDE002961 control via MQTT"
-description: "Integrate your Schneider Electric WDE002961 via Zigbee2MQTT with whatever smart home infrastructure you are using without the vendor's bridge or gateway."
+title: "Schneider Electric NH3516A control via MQTT"
+description: "Integrate your Schneider Electric NH3516A via Zigbee2MQTT with whatever smart home infrastructure you are using without the vendor's bridge or gateway."
 addedAt: 2022-12-13T19:23:01Z
 pageClass: device-page
 ---
@@ -11,15 +11,16 @@ pageClass: device-page
 <!-- Do not use h1 or h2 heading within "## Notes"-Section. -->
 <!-- !!!! -->
 
-# Schneider Electric WDE002961
+# Schneider Electric NH3516A
 
 |     |     |
 |-----|-----|
-| Model | WDE002961  |
+| Model | NH3516A  |
 | Vendor  | [Schneider Electric](/supported-devices/#v=Schneider%20Electric)  |
 | Description | Rotary dimmer |
 | Exposes | light (state, brightness, level_config), ballast_minimum_level, ballast_maximum_level, dimmer_mode, linkquality |
-| Picture | ![Schneider Electric WDE002961](https://www.zigbee2mqtt.io/images/devices/WDE002961.png) |
+| Picture | ![Schneider Electric NH3516A](https://www.zigbee2mqtt.io/images/devices/NH3516A.png) |
+| White-label | Elko EKO07278, Elko EKO07279, Elko EKO07280, Elko EKO07281, Elko EKO30198, Schneider WDE002961, Schneider WDE003961, Schneider WDE004961 |
 
 
 <!-- Notes BEGIN: You can edit here. Add "## Notes" headline if not already present. -->
@@ -54,6 +55,27 @@ Additionally an `off_wait_time` property can be added to the payload to specify
 Support depends on the light firmware. Some devices might require both `on_time` and `off_wait_time` to work
 Examples : `{"state" : "ON", "on_time": 300}`, `{"state" : "ON", "on_time": 300, "off_wait_time": 120}`.
 
+#### Transition
+For all of the above mentioned features it is possible to do a transition of the value over time. To do this add an additional property `transition` to the payload which is the transition time in seconds.
+Examples: `{"brightness":156,"transition":3}`, `{"color_temp":241,"transition":1}`.
+
+#### Moving/stepping
+Instead of setting a value (e.g. brightness) directly it is also possible to:
+- move: this will automatically move the value over time, to stop send value `stop` or `0`.
+- step: this will increment/decrement the current value by the given one.
+
+The direction of move and step can be either up or down, provide a negative value to move/step down, a positive value to move/step up.
+To do this send a payload like below to `zigbee2mqtt/FRIENDLY_NAME/set`
+
+**NOTE**: brightness move/step will stop at the minimum brightness and won't turn on the light when it's off. In this case use `brightness_move_onoff`/`brightness_step_onoff`
+````js
+{
+  "brightness_move": -40, // Starts moving brightness down at 40 units per second
+  "brightness_move": 0, // Stop moving brightness
+  "brightness_step": 40 // Increases brightness by 40
+}
+````
+
 ### Ballast minimum level (numeric)
 Specifies the minimum light output of the ballast.
 Value can be found in the published state on the `ballast_minimum_level` property.
@@ -69,11 +91,11 @@ To write (`/set`) a value publish a message to topic `zigbee2mqtt/FRIENDLY_NAME/
 The minimal value is `1` and the maximum value is `254`.
 
 ### Dimmer mode (enum)
-Sets dimming mode to autodetect or fixed RC/RL/RL_LED mode (max load is reduced in RL_LED).
+Auto detects the correct mode for the ballast. RL-LED may have improved dimming quality for LEDs..
 Value can be found in the published state on the `dimmer_mode` property.
 To read (`/get`) the value publish a message to topic `zigbee2mqtt/FRIENDLY_NAME/get` with payload `{"dimmer_mode": ""}`.
 To write (`/set`) a value publish a message to topic `zigbee2mqtt/FRIENDLY_NAME/set` with payload `{"dimmer_mode": NEW_VALUE}`.
-The possible values are: `auto`, `rc`, `rl`, `rl_led`.
+The possible values are: `Auto`, `RL-LED`.
 
 ### Linkquality (numeric)
 Link quality (signal strength).

docs/devices/545D6306.md → docs/devices/NH3526.md

@@ -1,6 +1,6 @@
 ---
-title: "Schneider Electric 545D6306 control via MQTT"
-description: "Integrate your Schneider Electric 545D6306 via Zigbee2MQTT with whatever smart home infrastructure you are using without the vendor's bridge or gateway."
+title: "Schneider Electric NH3526 control via MQTT"
+description: "Integrate your Schneider Electric NH3526 via Zigbee2MQTT with whatever smart home infrastructure you are using without the vendor's bridge or gateway."
 addedAt: 2022-01-31T17:42:44
 pageClass: device-page
 ---
@@ -11,15 +11,16 @@ pageClass: device-page
 <!-- Do not use h1 or h2 heading within "## Notes"-Section. -->
 <!-- !!!! -->
 
-# Schneider Electric 545D6306
+# Schneider Electric NH3526
 
 |     |     |
 |-----|-----|
-| Model | 545D6306  |
+| Model | NH3526  |
 | Vendor  | [Schneider Electric](/supported-devices/#v=Schneider%20Electric)  |
-| Description | LK FUGA Wiser wireless PIR with relay |
-| Exposes | switch (state), occupancy, illuminance_lux, illuminance, occupancy_timeout, linkquality |
-| Picture | ![Schneider Electric 545D6306](https://www.zigbee2mqtt.io/images/devices/545D6306.png) |
+| Description | Motion sensor with switch |
+| Exposes | switch (state), illuminance_lux, illuminance, occupancy, occupancy_timeout, occupancy_sensitivity, ambience_light_threshold, linkquality |
+| Picture | ![Schneider Electric NH3526](https://www.zigbee2mqtt.io/images/devices/NH3526.png) |
+| White-label | Elko EKO06988, Elko EKO06989, Elko EKO06990, Elko EKO06991, LK 545D6306 |
 
 
 <!-- Notes BEGIN: You can edit here. Add "## Notes" headline if not already present. -->
@@ -43,42 +44,60 @@ pageClass: device-page
 
 ## Exposes
 
-### Switch (l1 endpoint)
-The current state of this switch is in the published state under the `state_l1` property (value is `ON` or `OFF`).
-To control this switch publish a message to topic `zigbee2mqtt/FRIENDLY_NAME/set` with payload `{"state_l1": "ON"}`, `{"state_l1": "OFF"}` or `{"state_l1": "TOGGLE"}`.
-To read the current state of this switch publish a message to topic `zigbee2mqtt/FRIENDLY_NAME/get` with payload `{"state_l1": ""}`.
+### Switch 
+The current state of this switch is in the published state under the `state` property (value is `ON` or `OFF`).
+To control this switch publish a message to topic `zigbee2mqtt/FRIENDLY_NAME/set` with payload `{"state": "ON"}`, `{"state": "OFF"}` or `{"state": "TOGGLE"}`.
+To read the current state of this switch publish a message to topic `zigbee2mqtt/FRIENDLY_NAME/get` with payload `{"state": ""}`.
 
 #### On with timed off
 When setting the state to ON, it might be possible to specify an automatic shutoff after a certain amount of time. To do this add an additional property `on_time` to the payload which is the time in seconds the state should remain on.
 Additionally an `off_wait_time` property can be added to the payload to specify the cooldown time in seconds when the switch will not answer to other on with timed off commands.
 Support depends on the switch firmware. Some devices might require both `on_time` and `off_wait_time` to work
 Examples : `{"state" : "ON", "on_time": 300}`, `{"state" : "ON", "on_time": 300, "off_wait_time": 120}`.
 
-### Occupancy (binary)
-Indicates whether the device detected occupancy.
-Value can be found in the published state on the `occupancy` property.
-It's not possible to read (`/get`) or write (`/set`) this value.
-If value equals `true` occupancy is ON, if `false` OFF.
-
-### Illuminance (lux) (numeric)
+### Illuminance lux (numeric)
 Measured illuminance in lux.
 Value can be found in the published state on the `illuminance_lux` property.
-It's not possible to read (`/get`) or write (`/set`) this value.
+To read (`/get`) the value publish a message to topic `zigbee2mqtt/FRIENDLY_NAME/get` with payload `{"illuminance_lux": ""}`.
+It's not possible to write (`/set`) this value.
 The unit of this value is `lx`.
 
 ### Illuminance (numeric)
 Raw measured illuminance.
 Value can be found in the published state on the `illuminance` property.
-It's not possible to read (`/get`) or write (`/set`) this value.
+To read (`/get`) the value publish a message to topic `zigbee2mqtt/FRIENDLY_NAME/get` with payload `{"illuminance": ""}`.
+It's not possible to write (`/set`) this value.
+
+### Occupancy (binary)
+Indicates whether the device detected occupancy.
+Value can be found in the published state on the `occupancy` property.
+To read (`/get`) the value publish a message to topic `zigbee2mqtt/FRIENDLY_NAME/get` with payload `{"occupancy": ""}`.
+It's not possible to write (`/set`) this value.
+If value equals `true` occupancy is ON, if `false` OFF.
 
 ### Occupancy timeout (numeric)
-Time in seconds after which occupancy is cleared after detecting it.
+Time in seconds before occupancy is cleared after the last detected movement..
 Value can be found in the published state on the `occupancy_timeout` property.
 To read (`/get`) the value publish a message to topic `zigbee2mqtt/FRIENDLY_NAME/get` with payload `{"occupancy_timeout": ""}`.
 To write (`/set`) a value publish a message to topic `zigbee2mqtt/FRIENDLY_NAME/set` with payload `{"occupancy_timeout": NEW_VALUE}`.
-The minimal value is `0` and the maximum value is `3600`.
+The minimal value is `0` and the maximum value is `65534`.
 The unit of this value is `s`.
 
+### Occupancy sensitivity (enum)
+Sensitivity of the occupancy sensor.
+Value can be found in the published state on the `occupancy_sensitivity` property.
+To read (`/get`) the value publish a message to topic `zigbee2mqtt/FRIENDLY_NAME/get` with payload `{"occupancy_sensitivity": ""}`.
+To write (`/set`) a value publish a message to topic `zigbee2mqtt/FRIENDLY_NAME/set` with payload `{"occupancy_sensitivity": NEW_VALUE}`.
+The possible values are: `Low`, `Medium`, `High`.
+
+### Ambience light threshold (numeric)
+Threshold above which occupancy will not trigger the light switch..
+Value can be found in the published state on the `ambience_light_threshold` property.
+To read (`/get`) the value publish a message to topic `zigbee2mqtt/FRIENDLY_NAME/get` with payload `{"ambience_light_threshold": ""}`.
+To write (`/set`) a value publish a message to topic `zigbee2mqtt/FRIENDLY_NAME/set` with payload `{"ambience_light_threshold": NEW_VALUE}`.
+The minimal value is `1` and the maximum value is `2000`.
+The unit of this value is `lx`.
+
 ### Linkquality (numeric)
 Link quality (signal strength).
 Value can be found in the published state on the `linkquality` property.

docs/devices/NH3527A.md

@@ -1,3 +1,28 @@
+---
+title: "Schneider Electric NH3527A control via MQTT"
+description: "Integrate your Schneider Electric NH3527A via Zigbee2MQTT with whatever smart home infrastructure you are using without the vendor's bridge or gateway."
+addedAt: 2024-11-24T16:19:30.887Z
+pageClass: device-page
+---
+
+<!-- !!!! -->
+<!-- ATTENTION: This file is auto-generated through docgen! -->
+<!-- You can only edit the "Notes"-Section between the two comment lines "Notes BEGIN" and "Notes END". -->
+<!-- Do not use h1 or h2 heading within "## Notes"-Section. -->
+<!-- !!!! -->
+
+# Schneider Electric NH3527A
+
+|     |     |
+|-----|-----|
+| Model | NH3527A  |
+| Vendor  | [Schneider Electric](/supported-devices/#v=Schneider%20Electric)  |
+| Description | Motion sensor with dimmer |
+| Exposes | light (state, brightness, level_config), ballast_minimum_level, ballast_maximum_level, illuminance_lux, illuminance, occupancy, occupancy_timeout, occupancy_sensitivity, ambience_light_threshold, dimmer_mode, linkquality |
+| Picture | ![Schneider Electric NH3527A](https://www.zigbee2mqtt.io/images/devices/NH3527A.png) |
+| White-label | Elko EKO07250, Elko EKO07251, Elko EKO07252, Elko EKO07253, Elko EKO30199, Exxact WDE002962, Exxact WDE003962 |
+
+
 <!-- Notes BEGIN: You can edit here. Add "## Notes" headline if not already present. -->
 ## Notes
 
@@ -10,3 +35,125 @@ The LED will start blinking amber.
 
 The indicator light is only used for device status, and cannot be controlled. The indicator light is green as long as the network permits joining.
 <!-- Notes END: Do not edit below this line -->
+
+
+
+## Options
+*[How to use device type specific configuration](../guide/configuration/devices-groups.md#specific-device-options)*
+
+* `illuminance_lux_calibration`: Calibrates the illuminance_lux value (percentual offset), takes into effect on next report of device. The value must be a number.
+
+* `illuminance_calibration`: Calibrates the illuminance value (percentual offset), takes into effect on next report of device. The value must be a number.
+
+* `transition`: Controls the transition time (in seconds) of on/off, brightness, color temperature (if applicable) and color (if applicable) changes. Defaults to `0` (no transition). The value must be a number with a minimum value of `0`
+
+* `state_action`: State actions will also be published as 'action' when true (default false). The value must be `true` or `false`
+
+* `no_occupancy_since`: Sends a message after the last time no occupancy (occupancy: false) was detected. When setting this for example to [10, 60] a `{"no_occupancy_since": 10}` will be send after 10 seconds and a `{"no_occupancy_since": 60}` after 60 seconds. The value must be a list of [object Object].
+
+
+## Exposes
+
+### Light 
+This light supports the following features: `state`, `brightness`, `level_config`.
+- `state`: To control the state publish a message to topic `zigbee2mqtt/FRIENDLY_NAME/set` with payload `{"state": "ON"}`, `{"state": "OFF"}` or `{"state": "TOGGLE"}`. To read the state send a message to `zigbee2mqtt/FRIENDLY_NAME/get` with payload `{"state": ""}`.
+- `brightness`: To control the brightness publish a message to topic `zigbee2mqtt/FRIENDLY_NAME/set` with payload `{"brightness": VALUE}` where `VALUE` is a number between `0` and `254`. To read the brightness send a message to `zigbee2mqtt/FRIENDLY_NAME/get` with payload `{"brightness": ""}`.
+
+#### On with timed off
+When setting the state to ON, it might be possible to specify an automatic shutoff after a certain amount of time. To do this add an additional property `on_time` to the payload which is the time in seconds the state should remain on.
+Additionally an `off_wait_time` property can be added to the payload to specify the cooldown time in seconds when the light will not answer to other on with timed off commands.
+Support depends on the light firmware. Some devices might require both `on_time` and `off_wait_time` to work
+Examples : `{"state" : "ON", "on_time": 300}`, `{"state" : "ON", "on_time": 300, "off_wait_time": 120}`.
+
+#### Transition
+For all of the above mentioned features it is possible to do a transition of the value over time. To do this add an additional property `transition` to the payload which is the transition time in seconds.
+Examples: `{"brightness":156,"transition":3}`, `{"color_temp":241,"transition":1}`.
+
+#### Moving/stepping
+Instead of setting a value (e.g. brightness) directly it is also possible to:
+- move: this will automatically move the value over time, to stop send value `stop` or `0`.
+- step: this will increment/decrement the current value by the given one.
+
+The direction of move and step can be either up or down, provide a negative value to move/step down, a positive value to move/step up.
+To do this send a payload like below to `zigbee2mqtt/FRIENDLY_NAME/set`
+
+**NOTE**: brightness move/step will stop at the minimum brightness and won't turn on the light when it's off. In this case use `brightness_move_onoff`/`brightness_step_onoff`
+````js
+{
+  "brightness_move": -40, // Starts moving brightness down at 40 units per second
+  "brightness_move": 0, // Stop moving brightness
+  "brightness_step": 40 // Increases brightness by 40
+}
+````
+
+### Ballast minimum level (numeric)
+Specifies the minimum light output of the ballast.
+Value can be found in the published state on the `ballast_minimum_level` property.
+To read (`/get`) the value publish a message to topic `zigbee2mqtt/FRIENDLY_NAME/get` with payload `{"ballast_minimum_level": ""}`.
+To write (`/set`) a value publish a message to topic `zigbee2mqtt/FRIENDLY_NAME/set` with payload `{"ballast_minimum_level": NEW_VALUE}`.
+The minimal value is `1` and the maximum value is `254`.
+
+### Ballast maximum level (numeric)
+Specifies the maximum light output of the ballast.
+Value can be found in the published state on the `ballast_maximum_level` property.
+To read (`/get`) the value publish a message to topic `zigbee2mqtt/FRIENDLY_NAME/get` with payload `{"ballast_maximum_level": ""}`.
+To write (`/set`) a value publish a message to topic `zigbee2mqtt/FRIENDLY_NAME/set` with payload `{"ballast_maximum_level": NEW_VALUE}`.
+The minimal value is `1` and the maximum value is `254`.
+
+### Illuminance lux (numeric)
+Measured illuminance in lux.
+Value can be found in the published state on the `illuminance_lux` property.
+To read (`/get`) the value publish a message to topic `zigbee2mqtt/FRIENDLY_NAME/get` with payload `{"illuminance_lux": ""}`.
+It's not possible to write (`/set`) this value.
+The unit of this value is `lx`.
+
+### Illuminance (numeric)
+Raw measured illuminance.
+Value can be found in the published state on the `illuminance` property.
+To read (`/get`) the value publish a message to topic `zigbee2mqtt/FRIENDLY_NAME/get` with payload `{"illuminance": ""}`.
+It's not possible to write (`/set`) this value.
+
+### Occupancy (binary)
+Indicates whether the device detected occupancy.
+Value can be found in the published state on the `occupancy` property.
+To read (`/get`) the value publish a message to topic `zigbee2mqtt/FRIENDLY_NAME/get` with payload `{"occupancy": ""}`.
+It's not possible to write (`/set`) this value.
+If value equals `true` occupancy is ON, if `false` OFF.
+
+### Occupancy timeout (numeric)
+Time in seconds before occupancy is cleared after the last detected movement..
+Value can be found in the published state on the `occupancy_timeout` property.
+To read (`/get`) the value publish a message to topic `zigbee2mqtt/FRIENDLY_NAME/get` with payload `{"occupancy_timeout": ""}`.
+To write (`/set`) a value publish a message to topic `zigbee2mqtt/FRIENDLY_NAME/set` with payload `{"occupancy_timeout": NEW_VALUE}`.
+The minimal value is `0` and the maximum value is `65534`.
+The unit of this value is `s`.
+
+### Occupancy sensitivity (enum)
+Sensitivity of the occupancy sensor.
+Value can be found in the published state on the `occupancy_sensitivity` property.
+To read (`/get`) the value publish a message to topic `zigbee2mqtt/FRIENDLY_NAME/get` with payload `{"occupancy_sensitivity": ""}`.
+To write (`/set`) a value publish a message to topic `zigbee2mqtt/FRIENDLY_NAME/set` with payload `{"occupancy_sensitivity": NEW_VALUE}`.
+The possible values are: `Low`, `Medium`, `High`.
+
+### Ambience light threshold (numeric)
+Threshold above which occupancy will not trigger the light switch..
+Value can be found in the published state on the `ambience_light_threshold` property.
+To read (`/get`) the value publish a message to topic `zigbee2mqtt/FRIENDLY_NAME/get` with payload `{"ambience_light_threshold": ""}`.
+To write (`/set`) a value publish a message to topic `zigbee2mqtt/FRIENDLY_NAME/set` with payload `{"ambience_light_threshold": NEW_VALUE}`.
+The minimal value is `1` and the maximum value is `2000`.
+The unit of this value is `lx`.
+
+### Dimmer mode (enum)
+Auto detects the correct mode for the ballast. RL-LED may have improved dimming quality for LEDs..
+Value can be found in the published state on the `dimmer_mode` property.
+To read (`/get`) the value publish a message to topic `zigbee2mqtt/FRIENDLY_NAME/get` with payload `{"dimmer_mode": ""}`.
+To write (`/set`) a value publish a message to topic `zigbee2mqtt/FRIENDLY_NAME/set` with payload `{"dimmer_mode": NEW_VALUE}`.
+The possible values are: `Auto`, `RL-LED`.
+
+### Linkquality (numeric)
+Link quality (signal strength).
+Value can be found in the published state on the `linkquality` property.
+It's not possible to read (`/get`) or write (`/set`) this value.
+The minimal value is `0` and the maximum value is `255`.
+The unit of this value is `lqi`.
+