Skip to content

Commit

Permalink
Merge branch 'Koenkk:master' into master
Browse files Browse the repository at this point in the history
  • Loading branch information
3reality-support authored Sep 18, 2024
2 parents 6030756 + a1aa799 commit a50050b
Show file tree
Hide file tree
Showing 100 changed files with 2,293 additions and 1,307 deletions.
17 changes: 9 additions & 8 deletions docs/advanced/zigbee/01_zigbee_network.md
Original file line number Diff line number Diff line change
Expand Up @@ -54,6 +54,7 @@ The following Zigbee routers have already been confirmed to support (at least so

| Zigbee Router | GP Proxy | GP Sink | Unicast |
| :---------------------------------------------------------------------------------- | :------: | :-----: | :-----: |
| [Custom devices (DiY) TI Router](../../devices/ti.router.md) | Y | N | Y |
| [IKEA E1603/E1702/E1708](../../devices/E1603_E1702_E1708.md) | Y | N | Y |
| [IKEA E2204](../../devices/E2204.md) | Y | Y | Y |
| [IKEA ICPSHC24-10EU-IL-2](../../devices/ICPSHC24-10EU-IL-1_ICPSHC24-10EU-IL-2.md)² | Y | Y | Y |
Expand All @@ -62,21 +63,21 @@ The following Zigbee routers have already been confirmed to support (at least so
| [IKEA LED2109G6](../../devices/LED2109G6.md) | Y | Y | Y |
| [IKEA LED2107C4](../../devices/LED2107C4.md) | Y | N | Y |
| [Philips 1742930P7](../../devices/1742930P7.md) | Y | N | Y |
| [Philips 3216131P5](../../devices/3216131P5.md) | Y | Y | Nⁱ |
| [Philips 3261030P7](../../devices/3261030P7.md) | Y | Y | Nⁱ |
| [Philips 3216131P5](../../devices/3216131P5.md) | Y | Y | Nⁱ |
| [Philips 3261030P7](../../devices/3261030P7.md) | Y | Y | Nⁱ |
| [Philips 3261031P6](../../devices/3261031P6.md) | Y | N | Y |
| [Philips 3261331P7](../../devices/3261331P7.md) | Y | Y | Nⁱ |
| [Philips 3261331P7](../../devices/3261331P7.md) | Y | Y | Nⁱ |
| [Philips 3418931P6](../../devices/3418931P6.md) | Y | N | Y |
| [Philips 4023330P7](../../devices/4023330P7.md) | Y | Y | Nⁱ |
| [Philips 4034031P7](../../devices/4034031P7.md) | Y | Y | Nⁱ |
| [Philips 4090230P9](../../devices/4090230P9.md) | Y | Y | Nⁱ |
| [Philips 4023330P7](../../devices/4023330P7.md) | Y | Y | Nⁱ |
| [Philips 4034031P7](../../devices/4034031P7.md) | Y | Y | Nⁱ |
| [Philips 4090230P9](../../devices/4090230P9.md) | Y | Y | Nⁱ |
| [Philips 5047130P9](../../devices/5047130P9.md) | Y | N | Y |
| [Philips 5062131P7](../../devices/5062131P7.md) | Y | N | Y |
| [Philips 9290024896](../../devices/9290024896.md) | Y | N | Y |
| [Philips 9290022166](../../devices/9290022166.md) | Y | N | Nⁱ |
| [Philips 9290022166](../../devices/9290022166.md) | Y | N | Nⁱ |
| [Philips 9290022169](../../devices/9290022169.md) | Y | N | Y |
| [Philips 929001953301](../../devices/929001953301.md) | Y | N | Y |
| [Philips 8718696548738](../../devices/8718696548738.md) | Y | Y | Nⁱ |
| [Philips 8718696548738](../../devices/8718696548738.md) | Y | Y | Nⁱ |
| [Philips 8719514491106](../../devices/8719514491106.md) | Y | N | Y |
| [Sonoff ZBDongle-E](../../devices/ZBDongle-E.md) | Y | N | Y |
| [Sunricher SR-ZG9040A](../../devices/SR-ZG9040A.md) | Y | Y | Y |
Expand Down
73 changes: 73 additions & 0 deletions docs/devices/1811680.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,73 @@
---
title: "SOMFY 1811680 control via MQTT"
description: "Integrate your SOMFY 1811680 via Zigbee2MQTT with whatever smart home infrastructure you are using without the vendor's bridge or gateway."
addedAt: 2024-09-07T11:16:42
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. -->
<!-- !!!! -->

# SOMFY 1811680

| | |
|-----|-----|
| Model | 1811680 |
| Vendor | [SOMFY](/supported-devices/#v=SOMFY) |
| Description | Zigbee opening sensor |
| Exposes | identify, alarm_1, battery_low, battery, linkquality |
| Picture | ![SOMFY 1811680](https://www.zigbee2mqtt.io/images/devices/1811680.png) |


<!-- Notes BEGIN: You can edit here. Add "## Notes" headline if not already present. -->


<!-- Notes END: Do not edit below this line -->



## Options
*[How to use device type specific configuration](../guide/configuration/devices-groups.md#specific-device-options)*

* `identify_timeout`: Sets the duration of the identification procedure in seconds (i.e., how long the device would flash).The value ranges from 1 to 30 seconds (default: 3). The value must be a number with a minimum value of `1` and with a with a maximum value of `30`


## Exposes

### Identify (enum)
Initiate device identification.
Value will **not** be published in the state.
It's not possible to read (`/get`) this value.
To write (`/set`) a value publish a message to topic `zigbee2mqtt/FRIENDLY_NAME/set` with payload `{"identify": NEW_VALUE}`.
The possible values are: `identify`.

### Alarm 1 (binary)
Indicates whether IAS Zone alarm 1 is active.
Value can be found in the published state on the `alarm_1` property.
It's not possible to read (`/get`) or write (`/set`) this value.
If value equals `true` alarm 1 is ON, if `false` OFF.

### Battery low (binary)
Indicates whether the battery of the device is almost empty.
Value can be found in the published state on the `battery_low` property.
It's not possible to read (`/get`) or write (`/set`) this value.
If value equals `true` battery low is ON, if `false` OFF.

### Battery (numeric)
Remaining battery in %.
Value can be found in the published state on the `battery` property.
To read (`/get`) the value publish a message to topic `zigbee2mqtt/FRIENDLY_NAME/get` with payload `{"battery": ""}`.
It's not possible to write (`/set`) this value.
The minimal value is `0` and the maximum value is `100`.
The unit of this value is `%`.

### 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`.

73 changes: 73 additions & 0 deletions docs/devices/1811681.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,73 @@
---
title: "SOMFY 1811681 control via MQTT"
description: "Integrate your SOMFY 1811681 via Zigbee2MQTT with whatever smart home infrastructure you are using without the vendor's bridge or gateway."
addedAt: 2024-09-07T11:16:42
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. -->
<!-- !!!! -->

# SOMFY 1811681

| | |
|-----|-----|
| Model | 1811681 |
| Vendor | [SOMFY](/supported-devices/#v=SOMFY) |
| Description | Zigbee motion sensor |
| Exposes | identify, occupancy, battery_low, battery, linkquality |
| Picture | ![SOMFY 1811681](https://www.zigbee2mqtt.io/images/devices/1811681.png) |


<!-- Notes BEGIN: You can edit here. Add "## Notes" headline if not already present. -->


<!-- Notes END: Do not edit below this line -->



## Options
*[How to use device type specific configuration](../guide/configuration/devices-groups.md#specific-device-options)*

* `identify_timeout`: Sets the duration of the identification procedure in seconds (i.e., how long the device would flash).The value ranges from 1 to 30 seconds (default: 3). The value must be a number with a minimum value of `1` and with a with a maximum value of `30`


## Exposes

### Identify (enum)
Initiate device identification.
Value will **not** be published in the state.
It's not possible to read (`/get`) this value.
To write (`/set`) a value publish a message to topic `zigbee2mqtt/FRIENDLY_NAME/set` with payload `{"identify": NEW_VALUE}`.
The possible values are: `identify`.

### 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.

### Battery low (binary)
Indicates whether the battery of the device is almost empty.
Value can be found in the published state on the `battery_low` property.
It's not possible to read (`/get`) or write (`/set`) this value.
If value equals `true` battery low is ON, if `false` OFF.

### Battery (numeric)
Remaining battery in %.
Value can be found in the published state on the `battery` property.
To read (`/get`) the value publish a message to topic `zigbee2mqtt/FRIENDLY_NAME/get` with payload `{"battery": ""}`.
It's not possible to write (`/set`) this value.
The minimal value is `0` and the maximum value is `100`.
The unit of this value is `%`.

### 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`.

31 changes: 18 additions & 13 deletions docs/devices/37022463.md
Original file line number Diff line number Diff line change
Expand Up @@ -18,7 +18,7 @@ pageClass: device-page
| Model | 37022463 |
| Vendor | [RoomsAI](/supported-devices/#v=RoomsAI) |
| Description | 2 Gang switch with backlight |
| Exposes | switch (state), power_on_behavior, backlight_mode, linkquality |
| Exposes | switch (state), power_on_behavior, switch_type, backlight_mode, indicator_mode, linkquality |
| Picture | ![RoomsAI 37022463](https://www.zigbee2mqtt.io/images/devices/37022463.png) |


Expand Down Expand Up @@ -59,19 +59,19 @@ Additionally an `off_wait_time` property can be added to the payload to specify
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}`.

### Power-on behavior (enum, l1 endpoint)
### Power-on behavior (enum)
Controls the behavior when the device is powered on after power loss. If you get an `UNSUPPORTED_ATTRIBUTE` error, the device does not support it..
Value can be found in the published state on the `power_on_behavior_l1` property.
To read (`/get`) the value publish a message to topic `zigbee2mqtt/FRIENDLY_NAME/get` with payload `{"power_on_behavior_l1": ""}`.
To write (`/set`) a value publish a message to topic `zigbee2mqtt/FRIENDLY_NAME/set` with payload `{"power_on_behavior_l1": NEW_VALUE}`.
Value can be found in the published state on the `power_on_behavior` property.
To read (`/get`) the value publish a message to topic `zigbee2mqtt/FRIENDLY_NAME/get` with payload `{"power_on_behavior": ""}`.
To write (`/set`) a value publish a message to topic `zigbee2mqtt/FRIENDLY_NAME/set` with payload `{"power_on_behavior": NEW_VALUE}`.
The possible values are: `off`, `previous`, `on`.

### Power-on behavior (enum, l2 endpoint)
Controls the behavior when the device is powered on after power loss. If you get an `UNSUPPORTED_ATTRIBUTE` error, the device does not support it..
Value can be found in the published state on the `power_on_behavior_l2` property.
To read (`/get`) the value publish a message to topic `zigbee2mqtt/FRIENDLY_NAME/get` with payload `{"power_on_behavior_l2": ""}`.
To write (`/set`) a value publish a message to topic `zigbee2mqtt/FRIENDLY_NAME/set` with payload `{"power_on_behavior_l2": NEW_VALUE}`.
The possible values are: `off`, `previous`, `on`.
### Switch type (enum)
Type of the switch.
Value can be found in the published state on the `switch_type` property.
To read (`/get`) the value publish a message to topic `zigbee2mqtt/FRIENDLY_NAME/get` with payload `{"switch_type": ""}`.
To write (`/set`) a value publish a message to topic `zigbee2mqtt/FRIENDLY_NAME/set` with payload `{"switch_type": NEW_VALUE}`.
The possible values are: `toggle`, `state`, `momentary`.

### Backlight mode (binary)
Mode of the backlight.
Expand All @@ -80,12 +80,17 @@ To read (`/get`) the value publish a message to topic `zigbee2mqtt/FRIENDLY_NAME
To write (`/set`) a value publish a message to topic `zigbee2mqtt/FRIENDLY_NAME/set` with payload `{"backlight_mode": NEW_VALUE}`.
If value equals `ON` backlight mode is ON, if `OFF` OFF.

### Indicator mode (enum)
LED indicator mode.
Value can be found in the published state on the `indicator_mode` property.
To read (`/get`) the value publish a message to topic `zigbee2mqtt/FRIENDLY_NAME/get` with payload `{"indicator_mode": ""}`.
To write (`/set`) a value publish a message to topic `zigbee2mqtt/FRIENDLY_NAME/set` with payload `{"indicator_mode": NEW_VALUE}`.
The possible values are: `off`, `off/on`, `on/off`, `on`.

### 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`.

qi`.

Loading

0 comments on commit a50050b

Please sign in to comment.