jeans/home-assistant.io
jeans/home-assistant.io
1
0
Fork 0
mirror of https://github.com/home-assistant/home-assistant.io.git synced 2025-07-13 12:26:50 +00:00
Code Issues Packages Projects Releases Wiki Activity

Xiaomi Miio: convert tables to lists to improve readability and display on mobile (#35143)

Browse Source
This commit is contained in:
c0ffeeca7 2024-10-09 10:00:33 +02:00 committed by GitHub
parent 87b1bccafa
commit 32b8196d25
No known key found for this signature in database
GPG Key ID: B5690EEEBB952194
1 changed files with 350 additions and 338 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

688
source/_integrations/xiaomi_miio.markdown
View File

@ -82,17 +82,44 @@ The most common problems are:
The `xiaomi_miio` gateway {% term integration %} allows you to control the gateway and its connected subdevices. The `xiaomi_miio` gateway {% term integration %} allows you to control the gateway and its connected subdevices.
### Supported Xiaomi gateway models: ### Supported Xiaomi gateway models
| Gateway name | Zigbee id | model | supported | The following list shows the Gateway name, the model number, the Zigbee ID, and whether the model is supported or not in Home Assistant.
| ------------------ | ------------------- | ------------------------ | ------------------------------ |
| Chinese version | lumi.gateway.v3 | DGNWG02LM | yes | - **Chinese version**
| European version | lumi.gateway.mieu01 | ZHWG11LM-763 / DGNWQ05LM | yes (cloud credentials needed) | - Model: DGNWG02LM
| Aqara hub | lumi.gateway.aqhm01 | ZHWG11LM | yes | - Zigbee ID: lumi.gateway.v3
| Mijia Zigbee 3.0 | lumi.gateway.mgl03 | ZNDMWG03LM | yes | - Supported: Yes
| Aqara AC Companion | lumi.acpartner.v1 | KTBL01LM | untested |
| Mi AC Companion | lumi.acpartner.v2 | KTBL02LM | untested | - **European version**
| Aqara AC Companion | lumi.acpartner.v3 | KTBL11LM | yes | - Model: ZHWG11LM-763 / DGNWQ05LM
- Zigbee ID: lumi.gateway.mieu01
- Supported: Yes (cloud credentials needed)
- **Aqara hub**
- Model: ZHWG11LM
- Zigbee ID: lumi.gateway.aqhm01
- Supported: Yes
- **Mijia Zigbee 3.0**
- Model: ZNDMWG03LM
- Zigbee ID: lumi.gateway.mgl03
- Supported: Yes
- **Aqara AC Companion**
- Model: KTBL01LM
- Zigbee ID: lumi.acpartner.v1
- Supported: Untested
- **Mi AC Companion**
- Model: KTBL02LM
- Zigbee ID: lumi.acpartner.v2
- Supported: Untested
- **Aqara AC Companion**
- Model: KTBL11LM
- Zigbee ID: lumi.acpartner.v3
- Supported: Yes
Some gateways (lumi.gateway.mieu01) do not support getting the connected subdevices locally. For those gateways, cloud credentials can be specified during the config flow and the "Use cloud to get connected subdevices" can be enabled in the options flow (after setting up the {% term integration %}, click Configuration in the sidebar, then click Integrations and then click Options on the already set up Xiaomi Miio Gateway {% term integration %}). The connected subdevices will then be retrieved from the Xiaomi Miio cloud (internet), control and status updates of those subdevices will then further take place over local network connection. A re-authentication flow may be triggered when no cloud credentials are provided yet and are needed for that particular gateway model. Some gateways (lumi.gateway.mieu01) do not support getting the connected subdevices locally. For those gateways, cloud credentials can be specified during the config flow and the "Use cloud to get connected subdevices" can be enabled in the options flow (after setting up the {% term integration %}, click Configuration in the sidebar, then click Integrations and then click Options on the already set up Xiaomi Miio Gateway {% term integration %}). The connected subdevices will then be retrieved from the Xiaomi Miio cloud (internet), control and status updates of those subdevices will then further take place over local network connection. A re-authentication flow may be triggered when no cloud credentials are provided yet and are needed for that particular gateway model.
@ -111,65 +138,107 @@ Not yet implemented features (but possible):
These subdevices are fully implemented in HomeAssistant: These subdevices are fully implemented in HomeAssistant:
| Subdevice name | Zigbee id | model | features | - **Weather sensor (WSDCGQ01LM)**
| -------------------------------- | --------------------- | ---------- | ------------------------------------------------ | - Zigbee ID: `lumi.sensor_ht`
| Weather sensor | lumi.sensor_ht | WSDCGQ01LM | readout `temperature` and `humidity` | - Features: readout `temperature` and `humidity`
| Weather sensor | lumi.weather.v1 | WSDCGQ11LM | readout `temperature`, `humidity` and `pressure` | - **Weather sensor (WSDCGQ11LM)**
| Wall switch single | lumi.ctrl_ln1 | QBKG11LM | load_power, status, turn_on, turn_off, toggle | - Zigbee ID: `lumi.weather.v1`
| Wall switch single | lumi.ctrl_ln1.aq1 | QBKG11LM | load_power, status, turn_on, turn_off, toggle | - Features: readout `temperature`, `humidity` and `pressure`
| Wall switch no neutral | lumi.ctrl_neutral1.v1 | QBKG04LM | status, turn_on, turn_off, toggle | - **Wall switch single (QBKG11LM)**
| Wall switch double | lumi.ctrl_ln2 | QBKG12LM | load_power, status, turn_on, turn_off, toggle | - Zigbee ID: `lumi.ctrl_ln1`
| Wall switch double | lumi.ctrl_ln2.aq1 | QBKG12LM | load_power, status, turn_on, turn_off, toggle | - Features: load_power, status, turn_on, turn_off, toggle
| Wall switch double no neutral | lumi.ctrl_neutral2 | QBKG03LM | status, turn_on, turn_off, toggle | - **Wall switch single (QBKG11LM)**
| D1 wall switch triple | lumi.switch.n3acn3 | QBKG26LM | load_power, status, turn_on, turn_off, toggle | - Zigbee ID: `lumi.ctrl_ln1.aq1`
| D1 wall switch triple no neutral | lumi.switch.l3acn3 | QBKG25LM | load_power, status, turn_on, turn_off, toggle | - Features: load_power, status, turn_on, turn_off, toggle
| Wall outlet | lumi.ctrl_86plug.v1 | QBCZ11LM | status, turn_on, turn_off, toggle | - **Wall switch no neutral (QBKG04LM)**
| Wall outlet | lumi.ctrl_86plug.aq1 | QBCZ11LM | load_power, status, turn_on, turn_off, toggle | - Zigbee ID: `lumi.ctrl_neutral1.v1`
| Plug | lumi.plug | ZNCZ02LM | load_power, status, turn_on, turn_off, toggle | - Features: status, turn_on, turn_off, toggle
| Relay | lumi.relay.c2acn01 | LLKZMK11LM | load_power, status, turn_on, turn_off, toggle | - **Wall switch double (QBKG12LM)**
| Smart bulb E27 | lumi.light.aqcn02 | ZNLDP12LM | on/off, brightness, color temperature | - Zigbee ID: `lumi.ctrl_ln2`
| IKEA smart bulb E27 white | ikea.light.led1545g12 | LED1545G12 | on/off, brightness, color temperature | - Features: load_power, status, turn_on, turn_off, toggle
| IKEA smart bulb E27 white | ikea.light.led1546g12 | LED1546G12 | on/off, brightness, color temperature | - **Wall switch double (QBKG12LM)**
| IKEA smart bulb E12 white | ikea.light.led1536g5 | LED1536G5 | on/off, brightness, color temperature | - Zigbee ID: `lumi.ctrl_ln2.aq1`
| IKEA smart bulb GU10 white | ikea.light.led1537r6 | LED1537R6 | on/off, brightness, color temperature | - Features: load_power, status, turn_on, turn_off, toggle
| IKEA smart bulb E27 white | ikea.light.led1623g12 | LED1623G12 | on/off, brightness, color temperature | - **Wall switch double no neutral (QBKG03LM)**
| IKEA smart bulb GU10 white | ikea.light.led1650r5 | LED1650R5 | on/off, brightness, color temperature | - Zigbee ID: `lumi.ctrl_neutral2`
| IKEA smart bulb E12 white | ikea.light.led1649c5 | LED1649C5 | on/off, brightness, color temperature | - Features: status, turn_on, turn_off, toggle
- **D1 wall switch triple (QBKG26LM)**
- Zigbee ID: `lumi.switch.n3acn3`
- Features: load_power, status, turn_on, turn_off, toggle
- **D1 wall switch triple no neutral (QBKG25LM)**
- Zigbee ID: `lumi.switch.l3acn3`
- Features: load_power, status, turn_on, turn_off, toggle
- **Wall outlet (QBCZ11LM)**
- Zigbee ID: `lumi.ctrl_86plug.v1`
- Features: status, turn_on, turn_off, toggle
- **Wall outlet (QBCZ11LM)**
- Zigbee ID: `lumi.ctrl_86plug.aq1`
- Features: load_power, status, turn_on, turn_off, toggle
- **Plug (ZNCZ02LM)**
- Zigbee ID: `lumi.plug`
- Features: load_power, status, turn_on, turn_off, toggle
- **Relay (LLKZMK11LM)**
- Zigbee ID: `lumi.relay.c2acn01`
- Features: load_power, status, turn_on, turn_off, toggle
- **Smart bulb E27 (ZNLDP12LM)**
- Zigbee ID: `lumi.light.aqcn02`
- Features: on/off, brightness, color temperature
- **IKEA smart bulb E27 white (LED1545G12)**
- Zigbee ID: `ikea.light.led1545g12`
- Features: on/off, brightness, color temperature
- **IKEA smart bulb E27 white (LED1546G12)**
- Zigbee ID: `ikea.light.led1546g12`
- Features: on/off, brightness, color temperature
- **IKEA smart bulb E12 white (LED1536G5)**
- Zigbee ID: `ikea.light.led1536g5`
- Features: on/off, brightness, color temperature
- **IKEA smart bulb GU10 white (LED1537R6)**
- Zigbee ID: `ikea.light.led1537r6`
- Features: on/off, brightness, color temperature
- **IKEA smart bulb E27 white (LED1623G12)**
- Zigbee ID: `ikea.light.led1623g12`
- Features: on/off, brightness, color temperature
- **IKEA smart bulb GU10 white (LED1650R5)**
- Zigbee ID: `ikea.light.led1650r5`
- Features: on/off, brightness, color temperature
- **IKEA smart bulb E12 white (LED1649C5)**
- Zigbee ID: `ikea.light.led1649c5`
- Features: on/off, brightness, color temperature
### Recognized subdevices (not yet implemented) ### Recognized subdevices (not yet implemented)
These subdevices are recognized by the python-miio code but are still being worked on (not yet implemented). These subdevices are recognized by the python-miio code but are still being worked on (not yet implemented).
| Subdevice name | Zigbee id | model | The list shows the device name, the model number, and the Zigbee ID.
| ------------------------------ | ----------------------- | --------------- |
| Button | lumi.sensor_switch | WXKG01LM | - **Button** (WXKG01LM): `lumi.sensor_switch`
| Button | lumi.sensor_switch.aq2 | WXKG11LM 2015 | - **Button** (WXKG11LM 2015): `lumi.sensor_switch.aq2`
| Button | lumi.sensor_switch.aq3 | WXKG12LM | - **Button** (WXKG12LM): `lumi.sensor_switch.aq3`
| Button | lumi.remote.b1acn01 | WXKG11LM 2018 | - **Button** (WXKG11LM 2018): `lumi.remote.b1acn01`
| Cube | lumi.sensor_cube.v1 | MFKZQ01LM | - **Cube** (MFKZQ01LM): `lumi.sensor_cube.v1`
| Cube | lumi.sensor_cube.aqgl01 | MFKZQ01LM | - **Cube** (MFKZQ01LM): `lumi.sensor_cube.aqgl01`
| Motion sensor | lumi.sensor_motion | RTCGQ01LM | - **Motion sensor** (RTCGQ01LM): `lumi.sensor_motion`
| Motion sensor | lumi.sensor_motion.aq2 | RTCGQ11LM | - **Motion sensor** (RTCGQ11LM): `lumi.sensor_motion.aq2`
| Door sensor | lumi.sensor_magnet | MCCGQ01LM | - **Door sensor** (MCCGQ01LM): `lumi.sensor_magnet`
| Door sensor | lumi.sensor_magnet.aq2 | MCCGQ11LM | - **Door sensor** (MCCGQ11LM): `lumi.sensor_magnet.aq2`
| Vibration sensor | lumi.vibration.aq1 | DJT11LM | - **Vibration sensor** (DJT11LM): `lumi.vibration.aq1`
| Honeywell smoke detector | lumi.sensor_smoke | JTYJ-GD-01LM/BW | - **Honeywell smoke detector** (JTYJ-GD-01LM/BW): `lumi.sensor_smoke`
| Honeywell natural gas detector | lumi.sensor_natgas | JTQJ-BF-01LM/BW | - **Honeywell natural gas detector** (JTQJ-BF-01LM/BW): `lumi.sensor_natgas`
| Water leak sensor | lumi.sensor_wleak.aq1 | SJCGQ11LM | - **Water leak sensor** (SJCGQ11LM): `lumi.sensor_wleak.aq1`
| Remote switch single | lumi.sensor_86sw1.v1 | WXKG03LM 2016 | - **Remote switch single** (WXKG03LM 2016): `lumi.sensor_86sw1.v1`
| Remote switch single | lumi.remote.b186acn01 | WXKG03LM 2018 | - **Remote switch single** (WXKG03LM 2018): `lumi.remote.b186acn01`
| D1 remote switch single | lumi.remote.b186acn02 | WXKG06LM | - **D1 remote switch single** (WXKG06LM): `lumi.remote.b186acn02`
| Remote switch double | lumi.sensor_86sw2.v1 | WXKG02LM 2016 | - **Remote switch double** (WXKG02LM 2016): `lumi.sensor_86sw2.v1`
| Remote switch double | lumi.remote.b286acn01 | WXKG02LM 2018 | - **Remote switch double** (WXKG02LM 2018): `lumi.remote.b286acn01`
| D1 remote switch double | lumi.remote.b286acn02 | WXKG07LM | - **D1 remote switch double** (WXKG07LM): `lumi.remote.b286acn02`
| Curtain | lumi.curtain | ZNCLDJ11LM | - **Curtain** (ZNCLDJ11LM): `lumi.curtain`
| Curtain | lumi.curtain.aq2 | ZNGZDJ11LM | - **Curtain** (ZNGZDJ11LM): `lumi.curtain.aq2`
| Curtain B1 | lumi.curtain.hagl04 | ZNCLDJ12LM | - **Curtain B1** (ZNCLDJ12LM): `lumi.curtain.hagl04`
| Door lock S1 | lumi.lock.aq1 | ZNMS11LM | - **Door lock S1** (ZNMS11LM): `lumi.lock.aq1`
| Door lock S2 | lumi.lock.acn02 | ZNMS12LM | - **Door lock S2** (ZNMS12LM): `lumi.lock.acn02`
| Door lock S2 pro | lumi.lock.acn03 | ZNMS13LM | - **Door lock S2 pro** (ZNMS13LM): `lumi.lock.acn03`
| Vima cylinder lock | lumi.lock.v1 | A6121 | - **Vima cylinder lock** (A6121): `lumi.lock.v1`
| Thermostat S2 | lumi.airrtc.tcpecn02 | KTWKQ03ES | - **Thermostat S2** (KTWKQ03ES): `lumi.airrtc.tcpecn02`
## Xiaomi device tracker (Xiaomi Mi WiFi Repeater 2) ## Xiaomi device tracker (Xiaomi Mi WiFi Repeater 2)
@ -203,57 +272,53 @@ The Air Purifiers, Air Humidifiers and Standing Fans use multiple platforms to a
Supported devices: Supported devices:
| Name | Model | Model no. | The list includes device name, model number (if available), and model.
| ---------------------- | ----------------------- | ------------ |
| Air Purifier | zhimi.airpurifier.v1 | |
| Air Purifier 2 | zhimi.airpurifier.v2 | FJY4006CN |
| Air Purifier V3 | zhimi.airpurifier.v3 | |
| Air Purifier V5 | zhimi.airpurifier.v5 | |
| Air Purifier Pro | zhimi.airpurifier.v6 | |
| Air Purifier Pro V7 | zhimi.airpurifier.v7 | |
| Air Purifier 2 (mini) | zhimi.airpurifier.m1 | |
| Air Purifier (mini) | zhimi.airpurifier.m2 | |
| Air Purifier MA1 | zhimi.airpurifier.ma1 | |
| Air Purifier MA2 | zhimi.airpurifier.ma2 | |
| Air Purifier 2S | zhimi.airpurifier.mc1 | |
| Air Purifier Super | zhimi.airpurifier.sa1 | |
| Air Purifier Super 2 | zhimi.airpurifier.sa2 | |
| Air Purifier 3 (2019) | zhimi.airpurifier.ma4 | AC-M6-SC |
| Air Purifier 3H (2019) | zhimi.airpurifier.mb3 | |
| Air Purifier Pro H | zhimi.airpurifier.va1 | |
| Air Purifier Pro H EU | zhimi.airpurifier.vb2 | |
| Air Purifier 3C | zhimi.airpurifier.mb4 | |
| Air Purifier 3C | zhimi.airp.mb4a | |
| Air Purifier ZA1 | zhimi.airpurifier.za1 | |
| Air Purifier 4 | zhimi.airp.mb5 | AC-M16-SC |
| Air Purifier 4 PRO | zhimi.airp.vb4 | AC-M15-SC |
| Air Fresh A1 | dmaker.airfresh.a1 | MJXFJ-150-A1 |
| Air Fresh VA2 | zhimi.airfresh.va2 | |
| Air Fresh VA4 | zhimi.airfresh.va4 | |
| Air Fresh T2017 | dmaker.airfresh.t2017 | MJXFJ-300-G1 |
| Air Humidifier | zhimi.humidifier.v1 | |
| Air Humidifier CA1 | zhimi.humidifier.ca1 | |
| Air Humidifier CA4 | zhimi.humidifier.ca4 | |
| Air Humidifier CB1 | zhimi.humidifier.cb1 | |
| Air Humidifier JSQ | deerma.humidifier.jsq | |
| Air Humidifier JSQ1 | deerma.humidifier.jsq1 | |
| Air Humidifier MJJSQ | deerma.humidifier.mjjsq | |
| Standing Fan 1X | dmaker.fan.p5 | |
| Inverter Pedestal Fan | zhimi.fan.za1 | |
| Standing Fan 2 | zhimi.fan.za3 | |
| Standing Fan 2S | zhimi.fan.za4 | |
| Standing Fan | zhimi.fan.sa1 | |
| DC Pedestal Fan | zhimi.fan.v2 | |
| DC Pedestal Fan | zhimi.fan.v3 | |
| Standing Fan 1C | dmaker.fan.1c | |
| Tower Fan | dmaker.fan.p9 | |
| Standing Fan 2 | dmaker.fan.p10 | |
| Standing Fan Pro | dmaker.fan.p11 | |
| Standing Fan 3 | zhimi.fan.za5 | |
### Features - **Air Purifier**: `zhimi.airpurifier.v1`
- **Air Purifier 2** (FJY4006CN): `zhimi.airpurifier.v2`
### Air Purifier 2 (zhimi.airpurifier.v2) - **Air Purifier V3**: `zhimi.airpurifier.v3`
- **Air Purifier V5**: `zhimi.airpurifier.v5`
- **Air Purifier Pro**: `zhimi.airpurifier.v6`
- **Air Purifier Pro V7**: `zhimi.airpurifier.v7`
- **Air Purifier 2 (mini)**: `zhimi.airpurifier.m1`
- **Air Purifier (mini)**: `zhimi.airpurifier.m2`
- **Air Purifier MA1**: `zhimi.airpurifier.ma1`
- **Air Purifier MA2**: `zhimi.airpurifier.ma2`
- **Air Purifier 2S**: `zhimi.airpurifier.mc1`
- **Air Purifier Super**: `zhimi.airpurifier.sa1`
- **Air Purifier Super 2**: `zhimi.airpurifier.sa2`
- **Air Purifier 3 (2019) (AC-M6-SC)**: `zhimi.airpurifier.ma4`
- **Air Purifier 3H (2019)**: `zhimi.airpurifier.mb3`
- **Air Purifier Pro H**: `zhimi.airpurifier.va1`
- **Air Purifier Pro H EU**: `zhimi.airpurifier.vb2`
- **Air Purifier 3C**: `zhimi.airpurifier.mb4`
- **Air Purifier 3C**: `zhimi.airp.mb4a`
- **Air Purifier ZA1**: `zhimi.airpurifier.za1`
- **Air Purifier 4 (AC-M16-SC)**: `zhimi.airp.mb5`
- **Air Purifier 4 PRO (AC-M15-SC)**: `zhimi.airp.vb4`
- **Air Fresh A1 (MJXFJ-150-A1)**: `dmaker.airfresh.a1`
- **Air Fresh VA2**: `zhimi.airfresh.va2`
- **Air Fresh VA4**: `zhimi.airfresh.va4`
- **Air Fresh T2017 (MJXFJ-300-G1)**: `dmaker.airfresh.t2017`
- **Air Humidifier**: `zhimi.humidifier.v1`
- **Air Humidifier CA1**: `zhimi.humidifier.ca1`
- **Air Humidifier CA4**: `zhimi.humidifier.ca4`
- **Air Humidifier CB1**: `zhimi.humidifier.cb1`
- **Air Humidifier JSQ**: `deerma.humidifier.jsq`
- **Air Humidifier JSQ1**: `deerma.humidifier.jsq1`
- **Air Humidifier MJJSQ**: `deerma.humidifier.mjjsq`
- **Standing Fan 1X**: `dmaker.fan.p5`
- **Inverter Pedestal Fan**: `zhimi.fan.za1`
- **Standing Fan 2**: `zhimi.fan.za3`
- **Standing Fan 2S**: `zhimi.fan.za4`
- **Standing Fan**: `zhimi.fan.sa1`
- **DC Pedestal Fan**: `zhimi.fan.v2`
- **DC Pedestal Fan**: `zhimi.fan.v3`
- **Standing Fan 1C**: `dmaker.fan.1c`
- **Tower Fan**: `dmaker.fan.p9`
- **Standing Fan 2**: `dmaker.fan.p10`
- **Standing Fan Pro**: `dmaker.fan.p11`
- **Standing Fan 3**: `zhimi.fan.za5`
- Power (on, off) - Power (on, off)
- Operation modes (Auto, Silent, Favorite, Idle) - Operation modes (Auto, Silent, Favorite, Idle)
@ -275,16 +340,14 @@ Supported devices:
- Sensor entities - Sensor entities
| Sensor | Description | Enabled by default | - **Filter Lifetime Remaining**: The remaining life of the filter. Enabled by default.
| ------------------------- | ------------------------------------------------------------- | ------------------ | - **Filter Use**: Filter usage time in hours. Enabled by default.
| Filter Lifetime Remaining | The remaining life of the filter | True | - **Humidity**: The current humidity measured. Enabled by default.
| Filter Use | Filter usage time in hours | True | - **Motor Speed**: The current motor speed measured in rpm. Enabled by default.
| Humidity | The current humidity measured | True | - **PM2.5**: The current particulate matter 2.5 measured. Enabled by default.
| Motor Speed | The current motor speed measured in rpm | True | - **Purify Volume**: The volume of purified air in cubic meter. Disabled by default.
| PM2.5 | The current particulate matter 2.5 measured | True | - **Temperature**: The current temperature measured. Enabled by default.
| Purify Volume | The volume of purified air in qubic meter | False | - **Use Time**: The accumulative number of seconds the device has been in use. Disabled by default.
| Temperature | The current temperature measured | True |
| Use Time | The accumulative number of seconds the device has been in use | False |
- Switch entities - Switch entities
@ -315,19 +378,16 @@ Supported devices:
| Volume | Set the volume | | Volume | Set the volume |
- Sensor entities - Sensor entities
- **Filter Life Remaining**: The remaining lifetime of the filter. Enabled by default.
| Sensor | Description | Enabled by default | - **Filter Use**: Filter usage time in hours. Enabled by default.
| --------------------- | ------------------------------------------------------------- | ------------------ | - **Humidity**: The current humidity measured. Enabled by default.
| Filter Life Remaining | The remaining lifetime of the filter | True | - **Illuminance**: The current illuminance measured. Enabled by default.
| Filter Use | Filter usage time in hours | True | - **Motor Speed**: The current motor speed measured in rpm. Enabled by default.
| Humidity | The current humidity measured | True | - **PM2.5**: The current particulate matter 2.5 measured. Enabled by default.
| Illuminance | The current illuminance measured | True | - **Purify Volume**: The volume of purified air in cubic meter. Disabled by default.
| Motor Speed | The current motor speed measured in rpm | True | - **Second Motor Speed**: The current second motor speed measured in rpm. Enabled by default.
| PM2.5 | The current particulate matter 2.5 measured | True | - **Temperature**: The current temperature measured. Enabled by default.
| Purify Volume | The volume of purified air in qubic meter | False | - **Use Time**: The accumulative number of seconds the device has been in use. Disabled by default.
| Second Motor Speed | The current second motor speed measured in rpm | True |
| Temperature | The current temperature measured | True |
| Use Time | The accumulative number of seconds the device has been in use | False |
- Switch entities - Switch entities
@ -353,18 +413,15 @@ Supported devices:
| Volume | Set the volume | | Volume | Set the volume |
- Sensor entities - Sensor entities
- **Filter Lifetime Remaining**: The remaining lifetime of the filter. Enabled by default.
| Sensor | Description | Enabled by default | - **Filter Use**: Filter usage time in hours. Enabled by default.
| ------------------------- | ------------------------------------------------------------- | ------------------ | - **Humidity**: The current humidity measured. Enabled by default.
| Filter Lifetime Remaining | The remaining lifetime of the filter | True | - **Illuminance**: The current illuminance measured. Enabled by default.
| Filter Use | Filter usage time in hours | True | - **Motor Speed**: The current motor speed measured in rpm. Enabled by default.
| Humidity | The current humidity measured | True | - **PM2.5**: The current particulate matter 2.5 measured. Enabled by default.
| Illuminance | The current illuminance measured | True | - **Second Motor Speed**: The current second motor speed measured in rpm. Enabled by default.
| Motor Speed | The current motor speed measured in rpm | True | - **Temperature**: The current temperature measured. Enabled by default.
| PM2.5 | The current particulate matter 2.5 measured | True | - **Use Time**: The accumulative number of seconds the device has been in use. Disabled by default.
| Second Motor Speed | The current second motor speed measured in rpm | True |
| Temperature | The current temperature measured | True |
| Use Time | The accumulative number of seconds the device has been in use | False |
- Switch entities - Switch entities
@ -396,17 +453,14 @@ Supported devices:
| Favorite Level | Set the favorite level | | Favorite Level | Set the favorite level |
- Sensor entities - Sensor entities
- **Filter Lifetime Remaining**: The remaining lifetime of the filter. Enabled by default.
| Sensor | Description | Enabled by default | - **Filter Use**: Filter usage time in hours. Enabled by default.
| ------------------------- | --------------------------------------------------------------- | ------------------ | - **Humidity**: The current humidity measured. Enabled by default.
| Filter Lifetime Remaining | The remaining lifetime of the filter | True | - **Motor Speed**: The current motor speed measured in rpm. Enabled by default.
| Filter Use | Filter usage time in hours | True | - **PM2.5**: The current particulate matter 2.5 measured. Enabled by default.
| Humidity | The current humidity measured | True | - **Temperature**: The current temperature measured. Enabled by default.
| Motor Speed | The current motor speed measured in rpm | True | - **Illuminance**: The current illuminance measured on top of the device (0-200 lux). Enabled by default.
| PM2.5 | The current particulate matter 2.5 measured | True | - **Use Time**: The accumulative number of seconds the device has been in use. Disabled by default.
| Temperature | The current temperature measured | True |
| Illuminance | The current illuminance meassured on top of the device 0-200lux | True |
| Use Time | The accumulative number of seconds the device has been in use | False |
- Switch entities - Switch entities
@ -432,16 +486,13 @@ Supported devices:
| Favorite Level | Set the favorite level | | Favorite Level | Set the favorite level |
- Sensor entities - Sensor entities
- **Filter Lifetime Remaining**: The remaining lifetime of the filter. Enabled by default.
| Sensor | Description | Enabled by default | - **Filter Use**: Filter usage time in hours. Enabled by default.
| ------------------------- | ------------------------------------------------------------- | ------------------ | - **Humidity**: The current humidity measured. Enabled by default.
| Filter Lifetime Remaining | The remaining lifetime of the filter | True | - **Motor Speed**: The current motor speed measured in rpm. Enabled by default.
| Filter Use | Filter usage time in hours | True | - **PM2.5**: The current particulate matter 2.5 measured. Enabled by default.
| Humidity | The current humidity measured | True | - **Temperature**: The current temperature measured. Enabled by default.
| Motor Speed | The current motor speed measured in rpm | True | - **Use Time**: The accumulative number of seconds the device has been in use. Disabled by default.
| PM2.5 | The current particulate matter 2.5 measured | True |
| Temperature | The current temperature measured | True |
| Use Time | The accumulative number of seconds the device has been in use | False |
- Switch entities - Switch entities
@ -452,7 +503,7 @@ Supported devices:
| Learn Mode | Turn on/off the learn mode | | Learn Mode | Turn on/off the learn mode |
| LED | Turn on/off the LED | | LED | Turn on/off the LED |
### Air Purifier 3/3H (2019) (zhimi.airpurifier.ma4/zhimi.airpurifier.mb3) ### Air Purifier 3/3H (2019) (zhimi.airpurifier.ma4, zhimi.airpurifier.mb3)
This model uses newer MiOT communication protocol. This model uses newer MiOT communication protocol.
@ -474,17 +525,14 @@ This model uses newer MiOT communication protocol.
| LED Brightness | Controls the brightness of the LEDs (bright, dim, off) | | LED Brightness | Controls the brightness of the LEDs (bright, dim, off) |
- Sensor entities - Sensor entities
- **Filter Lifetime Remaining**: The remaining lifetime of the filter. Enabled by default.
| Sensor | Description | Enabled by default | - **Filter Use**: Filter usage time in hours. Enabled by default.
| ------------------------- | ------------------------------------------------------------- | ------------------ | - **Humidity**: The current humidity measured. Enabled by default.
| Filter Lifetime Remaining | The remaining lifetime of the filter | True | - **Motor Speed**: The current motor speed measured in rpm. Enabled by default.
| Filter Use | Filter usage time in hours | True | - **PM2.5**: The current particulate matter 2.5 measured. Enabled by default.
| Humidity | The current humidity measured | True | - **Purify Volume**: The volume of purified air in cubic meter. Disabled by default.
| Motor Speed | The current motor speed measured in rpm | True | - **Temperature**: The current temperature measured. Enabled by default.
| PM2.5 | The current particulate matter 2.5 measured | True | - **Use Time**: The accumulative number of seconds the device has been in use. Disabled by default.
| Purify Volume | The volume of purified air in qubic meter | False |
| Temperature | The current temperature measured | True |
| Use Time | The accumulative number of seconds the device has been in use | False |
- Switch entities - Switch entities
@ -493,7 +541,7 @@ This model uses newer MiOT communication protocol.
| Buzzer | Turn on/off the buzzer | | Buzzer | Turn on/off the buzzer |
| Child Lock | Turn on/off the child lock | | Child Lock | Turn on/off the child lock |
### Air Purifier Pro H/Pro H EU (zhimi.airpurifier.va1/zhimi.airpurifier.vb2) ### Air Purifier Pro H, Pro H EU (zhimi.airpurifier.va1, zhimi.airpurifier.vb2)
- Power (on, off) - Power (on, off)
- Operation modes (Auto, Silent, Favorite, Fan) - Operation modes (Auto, Silent, Favorite, Fan)
@ -513,17 +561,14 @@ This model uses newer MiOT communication protocol.
| LED Brightness | Controls the brightness of the LEDs (bright, dim, off) | | LED Brightness | Controls the brightness of the LEDs (bright, dim, off) |
- Sensor entities - Sensor entities
- **Filter Lifetime Remaining**: The remaining lifetime of the filter. Enabled by default.
| Sensor | Description | Enabled by default | - **Filter Use**: Filter usage time in hours. Enabled by default.
| ------------------------- | ------------------------------------------------------------- | ------------------ | - **Humidity**: The current humidity measured. Enabled by default.
| Filter Lifetime Remaining | The remaining lifetime of the filter | True | - **Motor Speed**: The current motor speed measured in rpm. Enabled by default.
| Filter Use | Filter usage time in hours | True | - **PM2.5**: The current particulate matter 2.5 measured. Enabled by default.
| Humidity | The current humidity measured | True | - **Purify Volume**: The volume of purified air in cubic meter. Disabled by default.
| Motor Speed | The current motor speed measured in rpm | True | - **Temperature**: The current temperature measured. Enabled by default.
| PM2.5 | The current particulate matter 2.5 measured | True | - **Use Time**: The accumulative number of seconds the device has been in use. Disabled by default.
| Purify Volume | The volume of purified air in qubic meter | False |
| Temperature | The current temperature measured | True |
| Use Time | The accumulative number of seconds the device has been in use | False |
- Switch entities - Switch entities
@ -532,7 +577,7 @@ This model uses newer MiOT communication protocol.
| Buzzer | Turn on/off the buzzer | | Buzzer | Turn on/off the buzzer |
| Child Lock | Turn on/off the child lock | | Child Lock | Turn on/off the child lock |
### Air Purifier 3C (zhimi.airpurifier.mb4/zhimi.airp.mb4a) ### Air Purifier 3C (zhimi.airpurifier.mb4, zhimi.airp.mb4a)
- Power (on, off) - Power (on, off)
- Operation modes (Auto, Silent, Favorite) - Operation modes (Auto, Silent, Favorite)
@ -544,13 +589,10 @@ This model uses newer MiOT communication protocol.
| LED Brightness | Set the LED brightness | | LED Brightness | Set the LED brightness |
- Sensor entities - Sensor entities
- **Filter Lifetime Remaining**: The remaining lifetime of the filter. Enabled by default.
| Sensor | Description | Enabled by default | - **Filter Use**: Filter usage time in hours. Enabled by default.
| ------------------------- | ------------------------------------------- | ------------------ | - **Motor Speed**: The current motor speed measured in rpm. Enabled by default.
| Filter Lifetime Remaining | The remaining lifetime of the filter | True | - **PM2.5**: The current particulate matter 2.5 measured. Enabled by default.
| Filter Use | Filter usage time in hours | True |
| Motor Speed | The current motor speed measured in rpm | True |
| PM2.5 | The current particulate matter 2.5 measured | True |
- Switch entities - Switch entities
@ -570,16 +612,13 @@ This model uses newer MiOT communication protocol.
| Favorite Level | Set the favorite level | | Favorite Level | Set the favorite level |
- Sensor entities - Sensor entities
- **Filter Lifetime Remaining**: The remaining lifetime of the filter. Enabled by default.
| Sensor | Description | Enabled by default | - **Filter Use**: Filter usage time in hours. Enabled by default.
| ------------------------- | -------------------------------------------------------------- | ------------------ | - **Humidity**: The current humidity measured. Enabled by default.
| Filter Lifetime Remaining | The remaining lifetime of the filter | True | - **Motor Speed**: The current motor speed measured in rpm. Enabled by default.
| Filter Use | Filter usage time in hours | True | - **PM2.5**: The current particulate matter 2.5 measured. Enabled by default.
| Motor Speed | The current motor speed measured in rpm | True | - **Temperature**: The current temperature measured. Enabled by default.
| PM2.5 | The current particulate matter 2.5 measured | True | - **TVOC**: The current concentration of Total Organic Volatile Components. Enabled by default.
| Humidity | The current humidity measured | True |
| Temperature | The current temperature measured | True |
| TVOC | The current concentration of Total Organic Volatile Components | True |
- Switch entities - Switch entities
@ -604,18 +643,16 @@ This model uses newer MiOT communication protocol.
- `extra_features` - `extra_features`
- `use_time` - `use_time`
- `button_pressed` - `button_pressed`
- Sensor entities
| Sensor | Description | Enabled by default | - Sensor entities
| ------------------------- | ------------------------------------------------------------- | ------------------ | - **Filter Lifetime Remaining**: The remaining lifetime of the filter. Enabled by default.
| PM2.5 | The current particulate matter 2.5 measured | True | - **Filter Use**: Filter usage time in hours. Enabled by default.
| Illuminance | The current illuminance measured | True | - **Illuminance**: The current illuminance measured. Enabled by default.
| Filter Lifetime Remaining | The remaining lifetime of the filter | True | - **Motor Speed**: The current motor speed measured in rpm. Enabled by default.
| Filter Use | Filter usage time in hours | True | - **PM2.5**: The current particulate matter 2.5 measured. Enabled by default.
| Motor Speed | The current motor speed measured in rpm | True | - **Purify Volume**: The volume of purified air in cubic meter. Disabled by default.
| Second Motor Speed | The current second motor speed measured in rpm | True | - **Second Motor Speed**: The current second motor speed measured in rpm. Enabled by default.
| Purify Volume | The volume of purified air in qubic meter | False | - **Use Time**: The accumulative number of seconds the device has been in use. Disabled by default.
| Use Time | The accumulative number of seconds the device has been in use | False |
- Switch entities - Switch entities
@ -625,7 +662,7 @@ This model uses newer MiOT communication protocol.
| Child Lock | Turn on/off the child lock | | Child Lock | Turn on/off the child lock |
| LED | Turn on/off the LED | | LED | Turn on/off the LED |
### Air Purifier 4/4 PRO (zhimi.airp.mb5/zhimi.airp.vb4) ### Air Purifier 4/4 PRO (zhimi.airp.mb5, zhimi.airp.vb4)
These models use newer MiOT communication protocol. These models use newer MiOT communication protocol.
@ -646,18 +683,15 @@ These models use newer MiOT communication protocol.
| LED Brightness | Controls the brightness of the Display (bright, dim, off) | | LED Brightness | Controls the brightness of the Display (bright, dim, off) |
- Sensor entities - Sensor entities
- **Filter Lifetime Remaining**: The remaining lifetime of the filter in %. Enabled by default.
| Sensor | Description | Enabled by default | - **Filter Time Left**: The remaining lifetime of the filter in days. Enabled by default.
| ------------------------- | ------------------------------------------------------ | ------------------ | - **Filter Use**: Filter usage time in hours. Enabled by default.
| Filter Lifetime Remaining | The remaining lifetime of the filter in % | True | - **Humidity**: The current humidity measured. Enabled by default.
| Filter Time Left | The remaining lifetime of the filter in days | True | - **Motor Speed**: The current motor speed measured in rpm. Enabled by default.
| Filter Use | Filter usage time in hours | True | - **PM2.5**: The current particulate matter 2.5 measured. Enabled by default.
| Humidity | The current humidity measured | True | - **PM10**: The current particulate matter 10 measured (4 PRO only). Enabled by default.
| Motor Speed | The current motor speed measured in rpm | True | - **Purify Volume**: The volume of purified air in cubic meter. Disabled by default.
| PM2.5 | The current particulate matter 2.5 measured | True | - **Temperature**: The current temperature measured. Enabled by default.
| PM10 | The current particulate matter 10 measured(4 PRO only) | True |
| Purify Volume | The volume of purified air in qubic meter | False |
| Temperature | The current temperature measured | True |
- Switch entities - Switch entities
@ -711,17 +745,14 @@ These models use newer MiOT communication protocol.
- Attributes (fan platform) - Attributes (fan platform)
- `use_time` - `use_time`
- `extra_features` - `extra_features`
- Sensor entities - Sensor entities|
- **Carbon Dioxide**: The current carbon dioxide measured in ppm. Enabled by default.
| Sensor | Description | Enabled by default | - **Filter Lifetime Remaining**: The remaining lifetime of the filter. Enabled by default.
| ------------------------- | ------------------------------------------------------------- | ------------------ | - **Filter Use**: Filter usage time in hours. Enabled by default.
| Carbon Dioxide | The current carbon dioxide measured in ppm | True | - **Humidity**: The current humidity measured. Enabled by default.
| Filter Lifetime Remaining | The remaining lifetime of the filter | True | - **PM2.5**: The current particulate matter 2.5 measured. Enabled by default.
| Filter Use | Filter usage time in hours | True | - **Temperature**: The current temperature measured. Enabled by default.
| Humidity | The current humidity measured | True | - **Use Time**: The accumulative number of seconds the device has been in use. Disabled by default.
| PM2.5 | The current particulate matter 2.5 measured | True |
| Temperature | The current temperature measured | True |
| Use Time | The accumulative number of seconds the device has been in use | False |
- Select entities - Select entities
@ -776,38 +807,26 @@ These models use newer MiOT communication protocol.
- Power (on, off) - Power (on, off)
- Operation modes (Auto, Sleep, Favorite) - Operation modes (Auto, Sleep, Favorite)
- Binary sensor entities - Binary sensor entities
- **Auxiliary Heat Status**: Indicates if the heater is actually on
| Binary sensor | Description |
| --------------------- | -------------------------------------- |
| Auxiliary Heat Status | Indicates if the heater is actually on |
- Button entities - Button entities
- **Reset Dust Filter**: Resets filter lifetime and usage of the dust filter
| Button | Description | - **Reset Upper Filter**: Resets filter lifetime and usage of the upper filter
| ------------------ | ---------------------------------------------------- |
| Reset Dust Filter | Resets filter lifetime and usage of the dust filter |
| Reset Upper Filter | Resets filter lifetime and usage of the upper filter |
- Select entities - Select entities
- **Auxiliary Heat Level**: Controls the level of the heater (Low, Medium, High)
| Select | Description | - **Display Orientation**: Controls the orientation of the display (Forward, Left, Right)
| -------------------- | -------------------------------------------------------------- |
| Auxiliary Heat Level | Controls the level of the heater (Low, Medium, High) |
| Display Orientation | Controls the orientation of the display (Forward, Left, Right) |
- Sensor entities - Sensor entities
- **Carbon Dioxide**: The current carbon dioxide in ppm
| Sensor | Description | - **Dust filter lifetime remaining**: The remaining lifetime of the dust filter
| ------------------------------------ | -------------------------------------------------- | - **Dust filter lifetime remaining days**: The remaining lifetime of the dust filter in days
| Carbon Dioxide | The current carbon dioxide in ppm | - **Upper filter lifetime remaining**: The remaining lifetime of the upper filter
| Dust filter lifetime remaining | The remaining lifetime of the dust filter | - **Upper filter lifetime remaining days**: The remaining lifetime of the upper filter in days
| Dust filter lifetime remaining days | The remaining lifetime of the dust filter in days | - **PM2.5**: The current particulate matter 2.5
| Upper filter lifetime remaining | The remaining lifetime of the upper filter | - **Temperature**: The current outside temperature
| Upper filter lifetime remaining days | The remaining lifetime of the upper filter in days | - **Control Speed**: The current motor speed in rpm
| PM2.5 | The current particulate matter 2.5 | - **Favorite Speed**: The favorite motor speed in rpm
| Temperature | The current outside temperature |
| Control Speed | The current motor speed in rpm |
| Favorite Speed | The favorite motor speed in rpm |
- Switch entities - Switch entities
@ -846,13 +865,10 @@ These models use newer MiOT communication protocol.
| LED Brightness | Controls the brightness of the LEDs (bright, dim, off) | | LED Brightness | Controls the brightness of the LEDs (bright, dim, off) |
- Sensor entities - Sensor entities
- **Humidity**: The current humidity measured. Enabled by default.
| Sensor | Description | Enabled by default | - **Temperature**: The current temperature measured. Enabled by default.
| ----------- | ------------------------------------------------------------- | ------------------ | - **Use Time**: The accumulative number of seconds the device has been in use. Disabled by default.
| Humidity | The current humidity measured | True | - **Water Level**: The current water level percentage measured. Enabled by default.
| Temperature | The current temperature measured | True |
| Use Time | The accumulative number of seconds the device has been in use | False |
| Water Level | The current water level percentage measured | True |
- Switch entities - Switch entities
@ -889,13 +905,10 @@ These models use newer MiOT communication protocol.
| LED Brightness | Controls the brightness of the LEDs (bright, dim, off) | | LED Brightness | Controls the brightness of the LEDs (bright, dim, off) |
- Sensor entities - Sensor entities
- **Humidity**: The current humidity measured. Enabled by default.
| Sensor | Description | Enabled by default | - **Temperature**: The current temperature measured. Enabled by default.
| ----------- | ------------------------------------------------------------- | ------------------ | - **Use Time**: The accumulative number of seconds the device has been in use. Disabled by default.
| Humidity | The current humidity measured | True | - **Water Level**: The current water level percentage measured. Enabled by default.
| Temperature | The current temperature measured | True |
| Use Time | The accumulative number of seconds the device has been in use | False |
| Water Level | The current water level percentage measured | True |
- Switch entities - Switch entities
@ -939,14 +952,11 @@ These models use newer MiOT communication protocol.
| LED Brightness | Controls the brightness of the LEDs (bright, dim, off) | | LED Brightness | Controls the brightness of the LEDs (bright, dim, off) |
- Sensor entities - Sensor entities
- **Actual Speed**: The current motor speed measured in rpm. Enabled by default.
| Sensor | Description | Enabled by default | - **Humidity**: The current humidity measured. Enabled by default.
| ------------ | ------------------------------------------------------------- | ------------------ | - **Temperature**: The current temperature measured. Enabled by default.
| Actual Speed | The current motor speed measured in rpm | True | - **Use Time**: The accumulative number of seconds the device has been in use. Disabled by default.
| Humidity | The current humidity measured | True | - **Water Level**: The current water level percentage measured. Enabled by default.
| Temperature | The current temperature measured | True |
| Use Time | The accumulative number of seconds the device has been in use | False |
| Water Level | The current water level percentage measured | True |
- Switch entities - Switch entities
@ -989,13 +999,10 @@ Clean mode and Motor speed can only be set when the device is turned on.
| LED Brightness | Controls the brightness of the LEDs (bright, dim, off) | | LED Brightness | Controls the brightness of the LEDs (bright, dim, off) |
- Sensor entities - Sensor entities
- **Humidity**: The current humidity measured. Enabled by default.
| Sensor | Description | Enabled by default | - **Temperature**: The current temperature measured. Enabled by default.
| ----------- | ------------------------------------------------------------- | ------------------ | - **Use Time**: The accumulative number of seconds the device has been in use. Disabled by default.
| Humidity | The current humidity measured | True | - **Water Level**: The current water level percentage measured. Enabled by default.
| Temperature | The current temperature measured | True |
| Use Time | The accumulative number of seconds the device has been in use | False |
| Water Level | The current water level percentage measured | True |
- Switch entities - Switch entities
@ -1005,7 +1012,7 @@ Clean mode and Motor speed can only be set when the device is turned on.
| Child Lock | Turn on/off the child lock | | Child Lock | Turn on/off the child lock |
| Dry Mode | Turn on/off the dry mode | | Dry Mode | Turn on/off the dry mode |
### Air Humidifier JSQ/JSQ1/MJJSQ (deerma.humidifier.jsq/deerma.humidifier.jsq1/deerma.humidifier.mjjsq) ### Air Humidifier JSQ/JSQ1/MJJSQ (deerma.humidifier.jsq, deerma.humidifier.jsq1, deerma.humidifier.mjjsq)
- On, Off - On, Off
- Operation modes (low, medium, high, humidity) - Operation modes (low, medium, high, humidity)
@ -1027,13 +1034,10 @@ Clean mode and Motor speed can only be set when the device is turned on.
| Water Tank | Indicates whether the water tank is connected or not | | Water Tank | Indicates whether the water tank is connected or not |
| Water Tank Empty | Indicates whether the water tank is empty or not | | Water Tank Empty | Indicates whether the water tank is empty or not |
- Sensor entities - Sensor entities|
- **Humidity**: The current humidity measured. Enabled by default.
| Sensor | Description | Enabled by default | - **Temperature**: The current temperature measured. Enabled by default.
| ----------- | ------------------------------------------------------------- | ------------------ | - **Use Time**: The accumulative number of seconds the device has been in use. Disabled by default.
| Humidity | The current humidity measured | True |
| Temperature | The current temperature measured | True |
| Use Time | The accumulative number of seconds the device has been in use | False |
- Switch entities - Switch entities
@ -1139,7 +1143,7 @@ Clean mode and Motor speed can only be set when the device is turned on.
| Child Lock | Turn on/off the Child Lock | | Child Lock | Turn on/off the Child Lock |
| LED | Turn on/off the LED | | LED | Turn on/off the LED |
### Tower Fan/Standing Fan 2/Standing Fan Pro (dmaker.fan.p9/dmaker.fan.p10/dmaker.fan.p11) ### Tower Fan/Standing Fan 2/Standing Fan Pro (dmaker.fan.p9, dmaker.fan.p10, dmaker.fan.p11)
- Power (on, off) - Power (on, off)
- Operation modes (Normal, Nature) - Operation modes (Normal, Nature)
@ -1486,11 +1490,17 @@ In addition to all of the actions provided by the `vacuum` {% term integration %
Start the cleaning operation in the areas selected for the number of repeats indicated. Start the cleaning operation in the areas selected for the number of repeats indicated.
| Data attribute | Optional | Description | - **Data attribute**: `entity_id`
| ---------------------- | -------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | - **Description**: Only act on a specific robot.
| `entity_id` | no | Only act on a specific robot | - **Optional**: No.
| `zone` | no | List of zones. Each zone is an array of four integer values. These values represent two sets of x- and y-axis coordinates that describe the beginning and ending points of a square or rectangle cleaning zone. For example, `[[23510,25311,25110,26361]]` creates a box that starts in one corner at the 23510, 25311 (x- and y-axis) coordinates and then is expanded diagonally to the 25110, 26361 coordinates to create a rectangular cleaning zone. |
| `repeats` | no | Number of cleaning repeats for each zone between 1 and 3. | - **Data attribute**: `zone`
- **Description**: List of zones. Each zone is an array of four integer values. These values represent two sets of x- and y-axis coordinates that describe the beginning and ending points of a square or rectangle cleaning zone. For example, `[[23510,25311,25110,26361]]` creates a box that starts in one corner at the 23510, 25311 (x- and y-axis) coordinates and then is expanded diagonally to the 25110, 26361 coordinates to create a rectangular cleaning zone.
- **Optional**: No.
- **Data attribute**: `repeats`
- **Description**: Number of cleaning repeats for each zone between 1 and 3.
- **Optional**: No.
Example of `xiaomi_miio.vacuum_clean_zone` use: Example of `xiaomi_miio.vacuum_clean_zone` use:
@ -1565,10 +1575,12 @@ automation:
Clean the specified segment/room. A room is identified by a number. Instructions on how to find the valid room numbers and determine what rooms they map to, read the section [Retrieving room numbers](#retrieving-room-numbers). Clean the specified segment/room. A room is identified by a number. Instructions on how to find the valid room numbers and determine what rooms they map to, read the section [Retrieving room numbers](#retrieving-room-numbers).
| Data attribute | Optional | Description | - **Data attribute**: `entity_id`
| ---------------------- | -------- | ----------------------------------------------------- | - **Description**: Only act on a specific robot.
| `entity_id` | no | Only act on a specific robot | - **Optional**: No.
| `segments` | no | List of segment numbers or one single segment number. | - **Data attribute**: `segments`
- **Description**: List of segment numbers or one single segment number.
- **Optional**: No.
Example of `xiaomi_miio.vacuum_clean_segment` use: Example of `xiaomi_miio.vacuum_clean_segment` use:
@ -1624,11 +1636,15 @@ automation:
Go the specified coordinates. Go the specified coordinates.
| Data attribute | Optional | Description | - **Data attribute**: `entity_id`
| ---------------------- | -------- | ----------------------------------------------------------------------- | - **Description**: Only act on a specific robot.
| `entity_id` | no | Only act on a specific robot | - **Optional**: No.
| `x_coord` | no | X-coordinate, integer value. The dock is located at x-coordinate 25500. | - **Data attribute**: `x_coord`
| `y_coord` | no | Y-coordinate, integer value. The dock is located at y-coordinate 25500. | - **Description**: X-coordinate, integer value. The dock is located at x-coordinate 25500.
- **Optional**: No.
- **Data attribute**: `y_coord`
- **Description**: Y-coordinate, integer value. The dock is located at y-coordinate 25500.
- **Optional**: No.
Note: If your vacuum is in motion and does not respond to the `xiaomi_miio.vacuum_goto` command, call the `vacuum.pause` or `vacuum.stop` action first. Note: If your vacuum is in motion and does not respond to the `xiaomi_miio.vacuum_goto` command, call the `vacuum.pause` or `vacuum.stop` action first.
@ -1648,27 +1664,23 @@ Exit the remote control mode of the robot.
| ---------------------- | -------- | ---------------------------- | | ---------------------- | -------- | ---------------------------- |
| `entity_id` | no | Only act on a specific robot | | `entity_id` | no | Only act on a specific robot |
### Action `xiaomi_miio.vacuum_remote_control_move` ### Action `xiaomi_miio.vacuuNm_remote_control_move`
Remote control the robot. Please ensure you first set it in remote control mode with `remote_control_start`. Remote control the robot. Please ensure you first set it in remote control mode with `remote_control_start`.
| Data attribute | Optional | Description | - `entity_id`: Only act on a specific robot. Not optional.
| ---------------------- | -------- | --------------------------------------------------------- | - `velocity`: Speed: between -0.29 and 0.29. Not optional.
| `entity_id` | no | Only act on a specific robot | - `rotation`: Rotation: between -179 degrees and 179 degrees. Not optional.
| `velocity` | no | Speed: between -0.29 and 0.29 | - `duration`: The number of milliseconds that the robot should move for. Not optional.
| `rotation` | no | Rotation: between -179 degrees and 179 degrees |
| `duration` | no | The number of milliseconds that the robot should move for |
### Action `xiaomi_miio.vacuum_remote_control_move_step` ### Action `xiaomi_miio.vacuum_remote_control_move_step`
Enter remote control mode, make one move, stop, and exit remote control mode. Enter remote control mode, make one move, stop, and exit remote control mode.
| Data attribute | Optional | Description | - **entity_id**: Only act on a specific robot. Not optional.
| ---------------------- | -------- | --------------------------------------------------------- | - **velocity**: Speed: between -0.29 and 0.29. Not optional.
| `entity_id` | no | Only act on a specific robot | - **rotation**: Rotation: between -179 degrees and 179 degrees. Not optional.
| `velocity` | no | Speed: between -0.29 and 0.29 | - **duration**: The number of milliseconds that the robot should move for. Not optional.
| `rotation` | no | Rotation: between -179 degrees and 179 degrees |
| `duration` | no | The number of milliseconds that the robot should move for |
### Buttons ### Buttons