Xiaomi Miio


The Xiaomi Miio integrationIntegrations connect and integrate Home Assistant with your devices, services, and more.
[Learn more]
supports the following devices:

Prerequisites

Most Xiaomi Miio devices support configuration using the Home Assistant UI, except for the Xiaomi device tracker and Xiaomi IR Remote. Please read the linked sections for those devices for more information.

Devices need to be set up using the Mi Home app and not vendor-specific apps (e.g. Roborock).

For more complex network setups (e.g. VLANs), reference the following documentation for additional information.

Configuration

To add the Xiaomi Miio integration to your Home Assistant instance, use this My button:

Xiaomi Miio can be auto-discovered by Home Assistant. If an instance was found, it will be shown as Discovered. You can then set it up right away.

It is recommend to supply your Xiaomi cloud credentials during configuration to automatically connect to your devices. You need to specify the cloud server you used in the Xiaomi Home App (where you initially setup the device). There are 6 servers: cn, de, i2, ru, sg and us; please see this page for the server to use for each country.

Troubleshooting

The most common problems are:

  • Xiaomi Miio devices do not communicate across subnets/VLANs due to the source address of the UDP packet not belonging to the subnet of the device itself, more information and solutions.
  • Roborock vacuums need to be connected to the Xiaomi Home app, not the Roborock app, more information.
  • Blocking the network access to the device is known to cause intermittent connection issues due to the device’s internal software hanging and a watchdog restarting the internal software, more information.

Xiaomi Gateway

The xiaomi_miio gateway integrationIntegrations connect and integrate Home Assistant with your devices, services, and more.
[Learn more]
allows you to control the gateway and its connected subdevices.

Supported Xiaomi gateway models:

Gateway name Zigbee id model supported
Chinese version lumi.gateway.v3 DGNWG02LM yes
European version lumi.gateway.mieu01 ZHWG11LM-763 / DGNWQ05LM yes (cloud credentials needed)
Aqara hub lumi.gateway.aqhm01 ZHWG11LM yes
Mijia Zigbee 3.0 lumi.gateway.mgl03 ZNDMWG03LM yes
Aqara AC Companion lumi.acpartner.v1 KTBL01LM untested
Mi AC Companion lumi.acpartner.v2 KTBL02LM untested
Aqara AC Companion lumi.acpartner.v3 KTBL11LM 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 integrationIntegrations connect and integrate Home Assistant with your devices, services, and more.
[Learn more]
, click Configuration in the sidebar, then click Integrations and then click Options on the already set up Xiaomi Miio Gateway integrationIntegrations connect and integrate Home Assistant with your devices, services, and more.
[Learn more]
). 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.

Gateway features

  • Gateway alarm control (Turn on/off; see status armed_away, disarmed, arming)
  • Gateway light control (Turn on/off; change brightness; change color; see status)
  • Gateway illuminance sensor readout (illuminance value in lux)

Not yet implemented features (but possible):

  • Gateway internet radio (only chinese stations)
  • Gateway ringtones/sounds

Supported subdevices

These subdevices are fully implemented in HomeAssistant:

Subdevice name Zigbee id model features
Weather sensor lumi.sensor_ht WSDCGQ01LM readout temperature and humidity
Weather sensor lumi.weather.v1 WSDCGQ11LM readout temperature, humidity and pressure
Wall switch single lumi.ctrl_ln1 QBKG11LM load_power, status, turn_on, turn_off, toggle
Wall switch single lumi.ctrl_ln1.aq1 QBKG11LM load_power, status, turn_on, turn_off, toggle
Wall switch no neutral lumi.ctrl_neutral1.v1 QBKG04LM status, turn_on, turn_off, toggle
Wall switch double lumi.ctrl_ln2 QBKG12LM load_power, status, turn_on, turn_off, toggle
Wall switch double lumi.ctrl_ln2.aq1 QBKG12LM load_power, status, turn_on, turn_off, toggle
Wall switch double no neutral lumi.ctrl_neutral2 QBKG03LM status, turn_on, turn_off, toggle
D1 wall switch triple lumi.switch.n3acn3 QBKG26LM load_power, status, turn_on, turn_off, toggle
D1 wall switch triple no neutral lumi.switch.l3acn3 QBKG25LM load_power, status, turn_on, turn_off, toggle
Wall outlet lumi.ctrl_86plug.v1 QBCZ11LM status, turn_on, turn_off, toggle
Wall outlet lumi.ctrl_86plug.aq1 QBCZ11LM load_power, status, turn_on, turn_off, toggle
Plug lumi.plug ZNCZ02LM load_power, status, turn_on, turn_off, toggle
Relay lumi.relay.c2acn01 LLKZMK11LM load_power, status, turn_on, turn_off, toggle
Smart bulb E27 lumi.light.aqcn02 ZNLDP12LM on/off, brightness, color temperature
IKEA smart bulb E27 white ikea.light.led1545g12 LED1545G12 on/off, brightness, color temperature
IKEA smart bulb E27 white ikea.light.led1546g12 LED1546G12 on/off, brightness, color temperature
IKEA smart bulb E12 white ikea.light.led1536g5 LED1536G5 on/off, brightness, color temperature
IKEA smart bulb GU10 white ikea.light.led1537r6 LED1537R6 on/off, brightness, color temperature
IKEA smart bulb E27 white ikea.light.led1623g12 LED1623G12 on/off, brightness, color temperature
IKEA smart bulb GU10 white ikea.light.led1650r5 LED1650R5 on/off, brightness, color temperature
IKEA smart bulb E12 white ikea.light.led1649c5 LED1649C5 on/off, brightness, color temperature

Recognized subdevices (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
Button lumi.sensor_switch WXKG01LM
Button lumi.sensor_switch.aq2 WXKG11LM 2015
Button lumi.sensor_switch.aq3 WXKG12LM
Button lumi.remote.b1acn01 WXKG11LM 2018
Cube lumi.sensor_cube.v1 MFKZQ01LM
Cube lumi.sensor_cube.aqgl01 MFKZQ01LM
Motion sensor lumi.sensor_motion RTCGQ01LM
Motion sensor lumi.sensor_motion.aq2 RTCGQ11LM
Door sensor lumi.sensor_magnet MCCGQ01LM
Door sensor lumi.sensor_magnet.aq2 MCCGQ11LM
Vibration sensor lumi.vibration.aq1 DJT11LM
Honeywell smoke detector lumi.sensor_smoke JTYJ-GD-01LM/BW
Honeywell natural gas detector lumi.sensor_natgas JTQJ-BF-01LM/BW
Water leak sensor lumi.sensor_wleak.aq1 SJCGQ11LM
Remote switch single lumi.sensor_86sw1.v1 WXKG03LM 2016
Remote switch single lumi.remote.b186acn01 WXKG03LM 2018
D1 remote switch single lumi.remote.b186acn02 WXKG06LM
Remote switch double lumi.sensor_86sw2.v1 WXKG02LM 2016
Remote switch double lumi.remote.b286acn01 WXKG02LM 2018
D1 remote switch double lumi.remote.b286acn02 WXKG07LM
Curtain lumi.curtain ZNCLDJ11LM
Curtain lumi.curtain.aq2 ZNGZDJ11LM
Curtain B1 lumi.curtain.hagl04 ZNCLDJ12LM
Door lock S1 lumi.lock.aq1 ZNMS11LM
Door lock S2 lumi.lock.acn02 ZNMS12LM
Door lock S2 pro lumi.lock.acn03 ZNMS13LM
Vima cylinder lock lumi.lock.v1 A6121
Thermostat S2 lumi.airrtc.tcpecn02 KTWKQ03ES

Xiaomi device tracker (Xiaomi Mi WiFi Repeater 2)

The xiaomi_miio device tracker platform is observing your Xiaomi Mi WiFi Repeater 2 and reporting all associated WiFi clients.

Please follow the instructions on Retrieving the Access Token to get the API token.

To add a Xiaomi Mi WiFi Repeater device tracker to your installation, add the following to your configuration.yaml file:

device_tracker:
  - platform: xiaomi_miio
    host: 192.168.130.73
    token: YOUR_TOKEN

Configuration Variables

host string Required

The IP address of your miio device.

token string Required

The API token of your miio device.

Xiaomi Air Purifier, Air Humidifier and Standing Fan

The Air Purifiers, Air Humidifiers and Standing Fans use multiple platforms to allow you to set the control modes and settings of the device.

Supported devices:

Name Model Model no.
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 3C zhimi.airpurifier.mb4
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 2 (zhimi.airpurifier.v2)

  • Power (on, off)
  • Operation modes (Auto, Silent, Favorite, Idle)
  • Attributes (fan platform)
    • model
    • mode
    • sleep_time
    • sleep_mode_learn_count
    • extra_features
    • turbo_mode_supported
    • use_time
    • button_pressed
    • sleep_mode
  • Number entities
Number Description
Favorite Level Set the favorite level
  • Sensor entities
Sensor Description Enabled by default
Filter Lifetime Remaining The remaining life of the filter True
Filter Use Filter usage time in hours True
Humidity The current humidity measured True
Motor Speed The current motor speed measured in rpm True
PM2.5 The current particulate matter 2.5 measured True
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 Description
Buzzer Turn on/off the buzzer
Child Lock Turn on/off the child lock
Learn Mode Turn on/off the learn mode
LED Turn on/off the LED

Air Purifier Pro (zhimi.airpurifier.v6)

  • Power (on, off)
  • Operation modes (Auto, Silent, Favorite)
  • Attributes (fan platform)
    • sleep_time
    • sleep_mode_learn_count
    • extra_features
    • turbo_mode_supported
    • auto_detect
    • use_time
    • button_pressed
  • Number entities
Number Description
Favorite Level Set the favorite level
Volume Set the volume
  • Sensor entities
Sensor Description Enabled by default
Filter Life Remaining The remaining lifetime of the filter True
Filter Use Filter usage time in hours True
Humidity The current humidity measured True
Illuminance The current illuminance measured True
Motor Speed The current motor speed measured in rpm True
PM2.5 The current particulate matter 2.5 measured True
Purify Volume The volume of purified air in qubic meter False
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 Description
Child Lock Turn on/off the child lock
Learn Mode Turn on/off the learn mode
LED Turn on/off the LED

Air Purifier Pro V7 (zhimi.airpurifier.v7)

  • Power (on, off)
  • Operation modes (Auto, Silent, Favorite)
  • Attributes (fan platform)
    • extra_features
    • turbo_mode_supported
    • button_pressed
  • Number entities
Number Description
Favorite Level Set the favorite level
Volume Set the volume
  • Sensor entities
Sensor Description Enabled by default
Filter Lifetime Remaining The remaining lifetime of the filter True
Filter Use Filter usage time in hours True
Humidity The current humidity measured True
Illuminance The current illuminance measured True
Motor Speed The current motor speed measured in rpm True
PM2.5 The current particulate matter 2.5 measured True
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 Description
Child Lock Turn on/off the child lock
Learn Mode Turn on/off the learn mode
LED Turn on/off the LED

Air Purifier MA2 (zhimi.airpurifier.ma2)

  • Power (on, off)
  • Operation modes (Auto, Silent, Favorite)
  • Attributes (fan platform)
    • extra_features
    • turbo_mode_supported
    • button_pressed
    • preset_modes
    • preset_mode
    • sleep_time
    • sleep_mode_learn_count
    • use_time
    • sleep_mode
    • friendly_name
    • supported_features
Number Description
Favorite Level Set the favorite level
  • Sensor entities
Sensor Description Enabled by default
Filter Lifetime Remaining The remaining lifetime of the filter True
Filter Use Filter usage time in hours True
Humidity The current humidity measured True
Motor Speed The current motor speed measured in rpm True
PM2.5 The current particulate matter 2.5 measured True
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 Description
Buzzer Turn on/off the buzzer
Child Lock Turn on/off the child lock
Learn Mode Turn on/off the learn mode
LED Turn on/off the LED

Air Purifier 2S (zhimi.airpurifier.mc1)

  • Power (on, off)
  • Operation modes (Auto, Silent, Favorite)
  • Attributes (fan platform)
    • extra_features
    • turbo_mode_supported
    • button_pressed
  • Number entities
Number Description
Favorite Level Set the favorite level
  • Sensor entities
Sensor Description Enabled by default
Filter Lifetime Remaining The remaining lifetime of the filter True
Filter Use Filter usage time in hours True
Humidity The current humidity measured True
Motor Speed The current motor speed measured in rpm True
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 Description
Buzzer Turn on/off the buzzer
Child Lock Turn on/off the child lock
Learn Mode Turn on/off the learn mode
LED Turn on/off the LED

Air Purifier 3/3H (2019) (zhimi.airpurifier.ma4/zhimi.airpurifier.mb3)

This model uses newer MiOT communication protocol.

  • Power (on, off)
  • Operation modes (Auto, Silent, Favorite, Fan)
  • Attributes (fan platform)
    • use_time
  • Number entities
Number Description
Fan Level Set the fan level
Favorite Level Set the favorite level
  • Select entities
Select Description
LED Brightness Controls the brightness of the LEDs (bright, dim, off)
  • Sensor entities
Sensor Description Enabled by default
Filter Lifetime Remaining The remaining lifetime of the filter True
Filter Use Filter usage time in hours True
Humidity The current humidity measured True
Motor Speed The current motor speed measured in rpm True
PM2.5 The current particulate matter 2.5 measured True
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 Description
Buzzer Turn on/off the buzzer
Child Lock Turn on/off the child lock

Air Purifier 3C (zhimi.airpurifier.mb4)

  • Power (on, off)
  • Operation modes (Auto, Silent, Favorite)
  • Number entities
Number Description
Favorite Motor Speed Set the favorite motor speed
LED Brightness Set the LED brightness
  • Sensor entities
Sensor Description Enabled by default
Filter Lifetime Remaining The remaining lifetime of the filter True
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 Description
Buzzer Turn on/off the buzzer
Child Lock Turn on/off the child lock

Air Purifier ZA1 (zhimi.airpurifier.za1)

  • Power (on, off)
  • Operation modes (Auto, Silent, Favorite)
  • Number entities
Number Description
Favorite Level Set the favorite level
  • Sensor entities
Sensor Description Enabled by default
Filter Lifetime Remaining The remaining lifetime of the filter True
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
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 Description
Buzzer Turn on/off the buzzer
Child Lock Turn on/off the child lock
  • Select entities
Select Description
LED Brightness Controls the brightness of the Display (bright, dim, off)

Air Purifier V3 (zhimi.airpurifier.v3)

  • Power (on, off)
  • Operation modes (Auto, Silent, Favorite, Idle, Medium, High, Strong)
  • Attributes (fan platform)
    • sleep_time
    • sleep_mode_learn_count
    • extra_features
    • use_time
    • button_pressed
  • Sensor entities
Sensor Description Enabled by default
PM2.5 The current particulate matter 2.5 measured True
Illuminance The current illuminance measured True
Filter Lifetime Remaining The remaining lifetime of the filter True
Filter Use Filter usage time in hours True
Motor Speed The current motor speed measured in rpm True
Second Motor Speed The current second motor speed measured in rpm True
Purify Volume The volume of purified air in qubic meter False
Use Time The accumulative number of seconds the device has been in use False
  • Switch entities
Switch Description
Buzzer Turn on/off the buzzer
Child Lock Turn on/off the child lock
LED Turn on/off the LED

Air Purifier 4/4 PRO (zhimi.airp.mb5/zhimi.airp.vb4)

These models use newer MiOT communication protocol.

  • Power (on, off)
  • Operation modes (Auto, Silent, Favorite, Fan)
  • Attributes (fan platform)
  • Number entities
Number Description
Fan Level Set the fan level
Favorite Level Set the favorite level
  • Select entities
Select Description
LED Brightness Controls the brightness of the Display (bright, dim, off)
  • Sensor entities
Sensor Description Enabled by default
Filter Lifetime Remaining The remaining lifetime of the filter in % True
Filter Time Left The remaining lifetime of the filter in days True
Filter Use Filter usage time in hours True
Humidity The current humidity measured True
Motor Speed The current motor speed measured in rpm True
PM2.5 The current particulate matter 2.5 measured True
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 Description
Buzzer Turn on/off the buzzer
Child Lock Turn on/off the child lock
Ionizer Turn on/off the negative ion generator

Air Fresh A1 (dmaker.airfresh.a1)

  • Power (on, off)
  • Operation modes (Auto, Sleep, Favorite)
  • Binary sensor entities
Binary sensor Description
Auxiliary Heat Status Indicates if the heater is actually on
  • Button entities
Button Description
Reset Dust Filter Resets filter lifetimetime and usage of the dust filter
  • Sensor entities
Sensor Description
Carbon Dioxide The current carbon dioxide in ppm
Dust filter lifetime remaining The remaining lifetime of the filter
Dust filter lifetime remaining days The remaining lifetime of the filter in day
PM2.5 The current particulate matter 2.5
Temperature The current outside temperature
Control Speed The current motor speed in rpm
Favorite Speed The favorite motor speed in rpm
  • Switch entities
Switch Description
Buzzer Turn on/off buzzer
Child Lock Turn on/off child lock
Display Turn on/off display
Auxiliary Heat Turn on/off heater

Air Fresh VA2

  • Power (on, off)
  • Operation modes (Auto, Silent, Interval, Low, Middle, Strong)
  • Attributes (fan platform)
    • use_time
    • extra_features
  • Sensor entities
Sensor Description Enabled by default
Carbon Dioxide The current carbon dioxide measured in ppm True
Filter Lifetime Remaining The remaining lifetime of the filter True
Filter Use Filter usage time in hours True
Humidity The current humidity measured True
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 Description
LED Brightness Controls the brightness of the LEDs (bright, dim, off)
  • Switch entities
Switch Description
Buzzer Turn on/off buzzer
Child Lock Turn on/off child lock
LED Turn on/off led

Air Fresh VA4

  • Power (on, off)
  • Operation modes (Auto, Silent, Interval, Low, Middle, Strong)
  • Attributes (fan platform)
    • use_time
    • extra_features
  • Sensor entities
Sensor Description Enabled by default
Carbon Dioxide The current carbon dioxide measured in ppm True
Filter Lifetime Remaining The remaining lifetime of the filter True
Filter Use Filter usage time in hours True
Humidity The current humidity measured True
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 Description
LED Brightness Controls the brightness of the LEDs (bright, dim, off)
  • Switch entities
Switch Description
Buzzer Turn on/off buzzer
Child Lock Turn on/off child lock
LED Turn on/off led
Auxiliary Heat Turn on/off heater

Air Fresh T2017 (dmaker.airfresh.t2017)

  • Power (on, off)
  • Operation modes (Auto, Sleep, Favorite)
  • Binary sensor entities
Binary sensor Description
Auxiliary Heat Status Indicates if the heater is actually on
  • Button entities
Button Description
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 Description
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 Description
Carbon Dioxide The current carbon dioxide in ppm
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
Upper filter lifetime remaining The remaining lifetime of the upper filter
Upper filter lifetime remaining days The remaining lifetime of the upper filter in days
PM2.5 The current particulate matter 2.5
Temperature The current outside temperature
Control Speed The current motor speed in rpm
Favorite Speed The favorite motor speed in rpm
  • Switch entities
Switch Description
Buzzer Turn on/off buzzer
Child Lock Turn on/off child lock
Display Turn on/off display
Auxiliary Heat Turn on/off heater

Air Humidifier (zhimi.humidifier.v1)

  • On, Off
  • Operation modes (Silent, Medium, High, Strong)
  • Target humidity (30, 40, 50, 60, 70, 80)
  • Attributes (humidifier platform)
Attribute Description
available_modes A list with the operation modes available
humidity The current target humidity
max_humidity The maximum settable target humidity
min_humidity The minimum settable target humidity
mode The current operation mode selected
  • Binary sensor entities
Binary sensor Description
Water Tank Indicates whether the water tank is connected or not
  • Select entities
Select Description
LED Brightness Controls the brightness of the LEDs (bright, dim, off)
  • Sensor entities
Sensor Description Enabled 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
Water Level The current water level percentage measured True
  • Switch entities
Switch Description
Buzzer Turn on/off the buzzer
Child Lock Turn on/off the child lock

Air Humidifier CA (zhimi.humidifier.ca1)

  • On, Off
  • Operation modes (Silent, Medium, High, Auto)
  • Target humidity (30, 40, 50, 60, 70, 80)
  • Attributes (humidifier platform)
Attribute Description
available_modes A list with the operation modes available
humidity The current target humidity
max_humidity The maximum settable target humidity
min_humidity The minimum settable target humidity
mode The current operation mode selected
  • Binary sensor entities
Binary sensor Description
Water Tank Indicates whether the water tank is connected or not
  • Select entities
Select Description
LED Brightness Controls the brightness of the LEDs (bright, dim, off)
  • Sensor entities
Sensor Description Enabled 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
Water Level The current water level percentage measured True
  • Switch entities
Switch Description
Buzzer Turn on/off the buzzer
Child Lock Turn on/off the child lock
Dry Mode Turn on/off the dry mode

Air Humidifier CA (zhimi.humidifier.ca4)

  • On, Off
  • Operation modes (Auto, Low, Medium, High)
  • Target humidity (30 - 80)
  • Attributes (humidifier platform)
Attribute Description
available_modes A list with the operation modes available
humidity The current target humidity
max_humidity The maximum settable target humidity
min_humidity The minimum settable target humidity
mode The current operation mode selected
  • Binary sensor entities
Binary sensor Description
Water Tank Indicates whether the water tank is connected or not
  • Number entities
Number Description
Motor Speed Set the motor speed
  • Select entities
Select Description
LED Brightness Controls the brightness of the LEDs (bright, dim, off)
  • Sensor entities
Sensor Description Enabled by default
Actual Speed The current motor speed measured in rpm True
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
Water Level The current water level percentage measured True
  • Switch entities
Switch Description
Buzzer Turn on/off the buzzer
Child Lock Turn on/off the child lock
Clean Mode Turn on/off the clean mode
Dry Mode Turn on/off the dry mode
Clean mode and Motor speed can only be set when the device is turned on.

Air Humidifier CB (zhimi.humidifier.cb1)

  • On, Off
  • Operation modes (Silent, Medium, High, Auto)
  • Target humidity (30, 40, 50, 60, 70, 80)
  • Attributes (humidifier platform)
Attribute Description
available_modes A list with the operation modes available
humidity The current target humidity
max_humidity The maximum settable target humidity
min_humidity The minimum settable target humidity
mode The current operation mode selected
  • Binary sensor entities
Binary sensor Description
Water Tank Indicates whether the water tank is connected or not
  • Select entities
Select Description
LED Brightness Controls the brightness of the LEDs (bright, dim, off)
  • Sensor entities
Sensor Description Enabled 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
Water Level The current water level percentage measured True
  • Switch entities
Switch Description
Buzzer Turn on/off the buzzer
Child Lock Turn on/off the child lock
Dry Mode Turn on/off the dry mode

Air Humidifier JSQ/JSQ1/MJJSQ (deerma.humidifier.jsq/deerma.humidifier.jsq1/deerma.humidifier.mjjsq)

  • On, Off
  • Operation modes (low, medium, high, humidity)
  • Target humidity (30, 40, 50, 60, 70, 80)
  • Attributes (humidifier platform)
Attribute Description
available_modes A list with the operation modes available
humidity The current target humidity
max_humidity The maximum settable target humidity
min_humidity The minimum settable target humidity
mode The current operation mode selected
  • Binary sensor entities
Binary sensor Description
Water Tank Indicates whether the water tank is connected or not
Water Tank Empty Indicates whether the water tank is empty or not
  • Sensor entities
Sensor Description Enabled 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 Description
Buzzer Turn on/off the buzzer
LED Turn on/off the LED

Standing Fan 1X (dmaker.fan.p5)

  • Power (on, off)
  • Operation modes (Normal, Nature)
  • Oscillation (on, off)
  • Number entities
Number Description
Delay Off Countdown Set the delay off countdown in minutes
Oscillation Angle Set the oscillation angle in degrees
  • Switch entities
Switch Description
Buzzer Turn on/off buzzer
Child Lock Turn on/off child lock
LED Turn on/off led

Standing Fan (zhimi.fan.za1, zhimi.fan.za3, zhimi.fan.za4, zhimi.fan.sa1)

  • Power (on, off)
  • Operation modes (Normal, Nature)
  • Oscillation (on, off)
  • Number entities
Number Description
Delay Off Countdown Set the delay off countdown in minutes
Oscillation Angle Set the oscillation angle in degrees
  • Select entities
Select Description
LED Brightness Controls the brightness of the LEDs (bright, dim, off)
  • Switch entities
Switch Description
Buzzer Turn on/off buzzer
Child Lock Turn on/off child lock

DC Pedestal Fan (zhimi.fan.v2, zhimi.fan.v3)

  • Power (on, off)
  • Operation modes (Normal, Nature)
  • Oscillation (on, off)
  • Number entities
Number Description
Delay Off Countdown Set the delay off countdown in minutes
Oscillation Angle Set the oscillation angle in degrees
  • Select entities
Select Description
LED Brightness Controls the brightness of the LEDs (bright, dim, off)
  • Sensor entities
Sensor Description
Battery The current battery level in percentage
Humidity The current humidity measured
Temperature The current temperature measured
  • Switch entities
Switch Description
Buzzer Turn on/off buzzer
Child Lock Turn on/off child lock

Standing Fan 1C (dmaker.fan.1c)

  • Power (on, off)
  • Operation modes (Normal, Nature)
  • Oscillation (on, off)
  • Number entities
Number Description
Delay Off Countdown Set the delay off countdown in minutes
  • Switch entities
Switch Description
Buzzer Turn on/off the Buzzer
Child Lock Turn on/off the Child Lock
LED Turn on/off the LED

Tower Fan/Standing Fan 2/Standing Fan Pro (dmaker.fan.p9/dmaker.fan.p10/dmaker.fan.p11)

  • Power (on, off)
  • Operation modes (Normal, Nature)
  • Oscillation (on, off)
  • Number entities
Number Description
Delay Off Countdown Set the delay off countdown in minutes
Oscillation Angle Set the oscillation angle in degrees
  • Switch entities
Switch Description
Buzzer Turn on/off the Buzzer
Child Lock Turn on/off the Child Lock
LED Turn on/off the LED

Standing Fan 3 (zhimi.fan.za5)

  • Power (on, off)
  • Operation modes (Normal, Nature)
  • Oscillation (on, off)
  • Binary sensor entities
Binary sensor Description
Power Supply Indicates whether the power supply is connected or not
  • Number entities
Number Description
Delay Off Countdown Set the delay off countdown in minutes
LED Brightness Set the LED brightness
Oscillation Angle Set the oscillation angle in degrees
  • Sensor entities
Sensor Description
Humidity The current humidity measured
Temperature The current temperature measured
  • Switch entities
Switch Description
Buzzer Turn on/off the Buzzer
Child Lock Turn on/off the Child Lock
Ionizer Turn on/off the Ionizer

Platform Services

Service humidifier.set_humidity

Set the target humidity.

Service data attribute Optional Description
entity_id no Only act on a specific Xiaomi miIO humidifier entity.
humidity no Target humidity

Service humidifier.set_mode

Set the humidifier operation mode.

Service data attribute Optional Description
entity_id no Only act on a specific Xiaomi miIO humidifier entity.
mode no The Xiaomi miIO operation mode

Service fan.set_percentage

Set the fan speed percentage.

Service data attribute Optional Description
entity_id no Only act on a specific Xiaomi miIO fan entity.
percentage no Fan speed. Percentage speed setting

Service fan.set_preset_mode

Set the fan operation mode.

Service data attribute Optional Description
entity_id no Only act on a specific Xiaomi miIO fan entity.
preset_mode no The Xiaomi miIO operation mode

Service xiaomi_miio.fan_reset_filter (Air Purifier 2 only)

Reset the filter lifetime and usage.

Service data attribute Optional Description
entity_id no Only act on a specific Xiaomi miIO fan entity.

Service xiaomi_miio.fan_set_extra_features (Air Purifier only)

Set the extra features.

Service data attribute Optional Description
entity_id no Only act on a specific Xiaomi miIO fan entity.
features no Integer, known values are 0 and 1.

Xiaomi Air Quality Monitor

The xiaomi_miio Air Quality Monitor is observing your Xiaomi Mi Air Quality Monitor (PM2.5) and reporting the air quality index and other values.

Currently, the supported features are:

  • Air Quality Index (AQI)
  • Particulate matter 2.5
  • Attributes
    • power
    • charging
    • battery
    • time_stat
    • carbon_dioxide_equivalent
    • total_volatile_organic_compounds
    • temperature
    • humidity

Xiaomi IR Remote

The xiaomi miio remote platform allows you to send IR commands from your Xiaomi IR Remote (ChuangmiIr).

Setup

Please follow the instructions on Retrieving the Access Token to get the API token to use in the configuration.yaml file.

Configuring the Platform

To add a Xiaomi IR Remote to your installation, add the following to your configuration.yaml file:

remote:
  - platform: xiaomi_miio
    host: 192.168.42.42
    token: YOUR_TOKEN

Configuration Variables

host string Required

The IP of your remote.

token string Required

The API token of your remote.

name string (Optional)

The name of your remote.

slot integer (Optional, default: 1)

The slot used to save learned command.

timeout integer (Optional, default: 30)

Timeout for learning a new command.

commands map (Optional)

A list of commands

command list Required

A list of commands as raw (learned command) or pronto hex code.

Full Configuration

remote:
  - platform: xiaomi_miio
    name: "bathroom remote"
    host: 192.168.42.42
    token: YOUR_TOKEN
    slot: 1
    timeout: 30
    commands:
      activate_towel_heater:
        command:
          - raw:base64:[optional_frequency]
      read_bad_poem:
        command:
          - raw:base64:[optional_frequency]
          - pronto:pronto_hex:[optional_repeat]

Add command as entity button to a dashboard

type: entity-button
tap_action:
  action: call-service
  service: remote.send_command
  data:
    command: activate_towel_heater
    entity_id: remote.xiaomi_miio_ir
hold_action:
  action: more-info
show_icon: true
show_name: true
entity: remote.xiaomi_miio_ir
icon: "mdi:radiator"
name: Activate Towel Heater

Use named commands to create UI buttons

script:
  towel_heater:
    sequence:
      - service: remote.send_command
        target:
          entity_id: "remote.bathroom_remote"
        data:
          command:
            - "activate_towel_heater"
  please_cover_your_ears:
    sequence:
      - service: remote.send_command
        target:
          entity_id: "remote.bathroom_remote"
        data:
          command:
            - "read_bad_poem"

Command Types

The Xiaomi IR Remote Platform currently supports two different formats for IR codes.

Raw

A raw command is a command learned from xiaomi_miio.remote_learn_command.

A raw command is defined as in the following example:

raw:Z6UFANEAAAAjAQAAAwkAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAQIAE=

with an optional last parameter of frequency:

raw:Z6UFANEAAAAjAQAAAwkAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAQIAE=:38400

Pronto Hex Code

A pronto hex code is a hex code often supplied by the device manufacturer.

A pronto hex code is defined as in the following example:

pronto:0000 006C 0022 0002 015B 00AD 0016 0016 0016 0016 0016 0016 0016 0016 0016 0016 0016 0016 0016 0016 0016 0016 0016 0041 0016 0041 0016 0041 0016 0041 0016 0041 0016 0041 0016 0041 0016 0016 0016 0016 0016 0041 0016 0016 0016 0041 0016 0016 0016 0016 0016 0016 0016 0016 0016 0041 0016 0016 0016 0041 0016 0016 0016 0041 0016 0041 0016 0041 0016 0041 0016 0623 015B 0057 0016 0E6E

with an optional last parameter of repeats (required by some devices):

pronto:0000 006C 0022 0002 015B 00AD 0016 0016 0016 0016 0016 0016 0016 0016 0016 0016 0016 0016 0016 0016 0016 0016 0016 0041 0016 0041 0016 0041 0016 0041 0016 0041 0016 0041 0016 0041 0016 0016 0016 0016 0016 0041 0016 0016 0016 0041 0016 0016 0016 0016 0016 0016 0016 0016 0016 0041 0016 0016 0016 0041 0016 0016 0016 0041 0016 0041 0016 0041 0016 0041 0016 0623 015B 0057 0016 0E6E:2

Note there are at least 4 versions of the Xiaomi IR Remote (ChuangmiIr) which can be recognized by their default hostname:

  • chuangmi.ir.v2
  • chuangmi.remote.h102a03
  • chuangmi.remote.v2
  • chuangmi.remote.h102c01

For now, pronto hex codes only work on the first version (chuangmi.ir.v2).

Platform Services

The Xiaomi IR Remote Platform registers four services.

remote.send_command

Allows sending either named commands using an identifier or sending commands as one of the two types defined in Command Types.

xiaomi_miio.remote_learn_command

Used to learn new commands.

Use the entity_id of the Xiaomi IR Remote to start a learning process.

slot and timeout can be specified, but multiple commands learned to the same slot can still be sent using remote.send_command even if they are overwritten.

After learning the command the base64 string can be found as a notification in Overview, the string can be copied by left clicking on the string and choose the copy option.

xiaomi_miio.remote_set_led_on

Used to turn remote’s blue LED on.

xiaomi_miio.remote_set_led_off

Used to turn remote’s blue LED off.

Xiaomi Mi Robot Vacuum

The xiaomi_miio vacuum platform allows you to control the state of your Xiaomi Mi Robot Vacuum.

Currently supported services are:

  • start
  • pause
  • stop
  • return_to_base
  • locate
  • clean_spot
  • set_fan_speed Fan speeds: Silent, Standard, Medium, Turbo and Gentle (exclusively for mopping).
  • xiaomi_clean_zone
  • xiaomi_clean_segment
  • xiaomi_goto
  • remote_control_* (of your robot)

Platform Services

In addition to all of the services provided by the vacuum integrationIntegrations connect and integrate Home Assistant with your devices, services, and more.
[Learn more]
(start, pause, stop, return_to_base, locate, set_fan_speed and send_command), the xiaomi_miio platform introduces specific services to access the remote control mode of the robot. These are:

  • xiaomi_miio.vacuum_clean_zone
  • xiaomi_miio.vacuum_clean_segment
  • xiaomi_miio.vacuum_goto
  • xiaomi_miio.vacuum_remote_control_start
  • xiaomi_miio.vacuum_remote_control_stop
  • xiaomi_miio.vacuum_remote_control_move
  • xiaomi_miio.vacuum_remote_control_move_step

Service xiaomi_miio.vacuum_clean_zone

Start the cleaning operation in the areas selected for the number of repeats indicated.

Service data attribute Optional Description
entity_id no Only act on a specific robot
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.

Example of xiaomi_miio.vacuum_clean_zone use:

Inline array:

automation:
  - alias: "Test vacuum zone3"
    trigger:
      - event: start
        platform: homeassistant
    condition: []
    action:
      - service: xiaomi_miio.vacuum_clean_zone
        target:
          entity_id: vacuum.xiaomi_vacuum
        data:
          repeats: "{{states('input_number.vacuum_passes')|int}}"
          zone: [[30914, 26007, 35514, 28807], [20232, 22496, 26032, 26496]]

Array with inline zone:

automation:
  - alias: "Test vacuum zone3"
    trigger:
      - event: start
        platform: homeassistant
    condition: []
    action:
      - service: xiaomi_miio.vacuum_clean_zone
        target:
          entity_id: vacuum.xiaomi_vacuum
        data:
          repeats: "{{states('input_number.vacuum_passes')|int}}"
          zone:
            - [30914, 26007, 35514, 28807]
            - [20232, 22496, 26032, 26496]

Array mode:

automation:
  - alias: "Test vacuum zone3"
    trigger:
      - event: start
        platform: homeassistant
    condition: []
    action:
      - service: xiaomi_miio.vacuum_clean_zone
        target:
          entity_id: vacuum.xiaomi_vacuum
        data:
          repeats: 1
          zone:
            - - 30914
              - 26007
              - 35514
              - 28807
            - - 20232
              - 22496
              - 26032
              - 26496

Service xiaomi_miio.vacuum_clean_segment

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.

Service data attribute Optional Description
entity_id no Only act on a specific robot
segments no List of segment numbers or one single segment number.

Example of xiaomi_miio.vacuum_clean_segment use:

Multiple segments:

automation:
  - alias: "Vacuum kitchen and living room"
    trigger:
      - event: start
        platform: homeassistant
    condition: []
    action:
      - service: xiaomi_miio.vacuum_clean_segment
        target:
          entity_id: vacuum.xiaomi_vacuum
        data:
          segments: [1, 2]

Single segment:

automation:
  - alias: "Vacuum kitchen"
    trigger:
      - event: start
        platform: homeassistant
    condition: []
    action:
      - service: xiaomi_miio.vacuum_clean_segment
        target:
          entity_id: vacuum.xiaomi_vacuum
        data:
          segments: 1

The original app for Xiaomi vacuum has a nice feature of room cleaning with repetition, you can achieve the same result with repeating segments:

automation:
  - alias: "Vacuum kitchen"
    trigger:
      - event: start
        platform: homeassistant
    action:
      - service: xiaomi_miio.vacuum_clean_segment
        target:
          entity_id: vacuum.xiaomi_vacuum
        data:
          segments: [1, 1]

Service xiaomi_miio.vacuum_goto

Go the specified coordinates.

Service data attribute Optional Description
entity_id no Only act on a specific robot
x_coord no X-coordinate, integer value. The dock is located at x-coordinate 25500.
y_coord no Y-coordinate, integer value. The dock is located at y-coordinate 25500.

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 service first.

Service xiaomi_miio.vacuum_remote_control_start

Start the remote control mode of the robot. You can then move it with remote_control_move; when done, call remote_control_stop.

Service data attribute Optional Description
entity_id no Only act on a specific robot

Service xiaomi_miio.vacuum_remote_control_stop

Exit the remote control mode of the robot.

Service data attribute Optional Description
entity_id no Only act on a specific robot

Service xiaomi_miio.vacuum_remote_control_move

Remote control the robot. Please ensure you first set it in remote control mode with remote_control_start.

Service data attribute Optional Description
entity_id no Only act on a specific robot
velocity no Speed: between -0.29 and 0.29
rotation no Rotation: between -179 degrees and 179 degrees
duration no The number of milliseconds that the robot should move for

Service xiaomi_miio.vacuum_remote_control_move_step

Enter remote control mode, make one move, stop, and exit remote control mode.

Service data attribute Optional Description
entity_id no Only act on a specific robot
velocity no Speed: between -0.29 and 0.29
rotation no Rotation: between -179 degrees and 179 degrees
duration no The number of milliseconds that the robot should move for

Buttons

Button Description
Reset Main Brush Resets main brush remaining lifespan
Reset Side Brush Resets side brush remaining lifespan
Reset Filter Resets filter remaining lifespan
Reset Sensor Dirty Resets sensor dirtiness (remaining time before needs to be cleaned)

Sensors

DnD Start*

The timestamp when the next DnD (Do not disturb) period will start

DnD End*

The timestamp when the current or next DnD (Do not disturb) period will end

Total duration*

The total cleaning duration in seconds

Total Clean Area*

The total cleaning area in square meters

Total Clean Count*

The total amount of times a clean cycle has been ran

Total Dust Collection Count*

The total amount of dust that has been collected

Filter Left*

How long the filter can be used in seconds

Main Brush Left*

How long the main brush can be used in seconds

Sensor Dirty Left*

How long the sensor can be used in seconds

Current Clean Time

The current cleaning time of the vacuum. If the vacuum is not cleaning, this sensor will have the same value as the “Last Clean Duration” sensor.

Current Clean Area

The current area that has been cleaned. If the vacuum is not cleaning, this sensor will have the same value as the “Last Clean Area” sensor.

Last Clean Area*

The last cleaned area in square meters

Last Clean Duration\*

The last clean duration in seconds

Last Clean End

The last clean end time as a timestamp

Last Clean Start

The last clean start time as a timestamp

Mop Attached**

If the mop is attached

Water Box Attached**

If the watter box is attached

Water Shortage\*\*

If the water box is low on water

* Needs to be manually enabled once the integrationIntegrations connect and integrate Home Assistant with your devices, services, and more.
[Learn more]
has been added.
** Only enabled if the vacuum has a mop.

Attributes

The vacuums from the xiaomi platform does not expose additional attributes other the ones provided by the vacuum integration,

Example on how to clean a specific room

Example script using vacuum.send_command to clean a specific room:

vacuum_kitchen:
  alias: "Clean the kitchen"
  sequence:
    - service: vacuum.send_command
      target:
        entity_id: vacuum.xiaomi_vacuum_cleaner
      data:
        command: app_segment_clean
        params: [18]

Where params specify room numbers, for multiple rooms, params can be specified like [17,18]. Instructions on how to find the valid room numbers and determine what rooms they map to, read the section Retrieving room numbers.

Example on how to reset maintenance hours (brushes, filter, sensors)

The vacuum entity stores attribute values for when brushes, filters and sensors need to be cleaned or replaced (main_brush_left, side_brush_left, filter_left and sensor_dirty_left). The values are measured in hours. Once the parts are cleaned or replaced you can then reset those values on the vacuum. Here is an example script using vacuum.send_command to reset the hours for the main brush:

reset_main_brush_left:
  alias: "Reset hours for main brush replacement"
  sequence:
    - service: vacuum.send_Command
      target:
        entity_id: vacuum.xiaomi_vacuum_cleaner
      data:
        command: reset_consumable
        params: ["main_brush_work_time"]

Allowed params for the reset_consumable command:

  • ['main_brush_work_time']
  • ['side_brush_work_time']
  • ['filter_work_time']
  • ['sensor_dirty_time']

Retrieving Zoned Cleaning Coordinates

Using FloleVac (Android)

  1. Download FloleVac
  2. Login with your Xiaomi credentials
  3. Open Map (make sure you’re on the same network as your vacuum cleaner)
  4. Select “Zone cleanup” and draw a box around the zone you’d like to clean
  5. Long press “Cleanup” and the zone coordinates will be copied to your clipboard

Using RoboRock Control Center (requires Valetudo firmware)

RRCC supports both rooted and non-rooted Vacuums and acts as a mostly fully featured replacement for Mi Home that works locally without the cloud. If you have installed the rooted firmware Valetudo you are able to SSH into your Vacuum and enable MQTT plus use map functions with no cloud requirement.

Using the map editor you are able to acquire the coordinates required for zoned clean up. Here is an example script for zoned clean up:

vacuum_kitchen:
  alias: "vacuum kitchen"
  sequence:
    - service: vacuum.send_command
      target:
        entity_id: "vacuum.xiaomi_vacuum_cleaner"
      data:
        command: app_zoned_clean
        params: [[23084, 26282, 27628, 29727, 1]]

Retrieving Room numbers

Valid room numbers can be retrieved using miio command-line tool:

miiocli roborockvacuum --ip <ip of the vacuum> --token <your vacuum token> get_room_mapping

It will return the full mapping of room numbers to user-defined names as a list of (number,name) tuples. Alternatively, one can just test the clean_segment service with a number and see which room it cleans.

It seems to be the case that Numbers 1..15 are used to number the initial segmentation done by the vacuum cleaner itself. Numbers 16 and upwards numbers rooms from the users manual editing.

Xiaomi Philips Light

The xiaomi_miio platform allows you to control the state of your Xiaomi Philips LED Ball Lamp, Xiaomi Philips Zhirui LED Bulb E14 Candle Lamp, Xiaomi Philips Zhirui Downlight, Xiaomi Philips LED Ceiling Lamp, Xiaomi Philips Eyecare Lamp 2, Xiaomi Philips Moonlight Bedside Lamp and Philips Zhirui Desk Lamp.

Features

Philips LED Ball Lamp, Philips Zhirui LED Candle Lamp and Philips Zhirui Downlight

Supported models: philips.light.bulb, philips.light.candle, philips.light.candle2, philips.light.downlight

  • Power (on, off)
  • Brightness
  • Color temperature (175…333 mireds)
  • Scene (1, 2, 3, 4)
  • Delayed turn off (Resolution in seconds)
  • Attributes
    • model
    • scene
    • delayed_turn_off

Philips LED Ceiling Lamp

Supported models: philips.light.ceiling, philips.light.zyceiling

  • Power (on, off)
  • Brightness
  • Color temperature (175…370 mireds)
  • Scene (1, 2, 3, 4)
  • Night light mode (on, off)
  • Delayed turn off (Resolution in seconds)
  • Attributes
    • model
    • scene
    • delayed_turn_off
    • night_light_mode
    • automatic_color_temperature

Philips Eyecare Smart Lamp 2

Supported models: philips.light.sread1

  • Eyecare light (on, off)
  • Ambient light (on, off)
  • Brightness (of each light)
  • Scene (1, 2, 3, 4)
  • Night light mode (on, off)
  • Delayed turn off (Resolution in seconds)
  • Eye fatigue reminder / notification (on, off)
  • Eyecare mode (on, off)
  • Attributes
    • model
    • scene
    • delayed_turn_off
    • night_light_mode
    • reminder
    • eyecare_mode

Philips Zhirui Desk Lamp

Supported models: philips.light.mono1

  • Power (on, off)
  • Brightness
  • Scene (1, 2, 3, 4)
  • Delayed turn off (Resolution in seconds)
  • Attributes
    • model
    • scene
    • delayed_turn_off

Philips Moonlight Bedside Lamp

Supported models: philips.light.moonlight

  • Power (on, off)
  • Brightness
  • Color
  • Color temperature (153…588 mireds)
  • Scene (1, 2, 3, 4, 5, 6)
  • Attributes
    • model
    • scene
    • sleep_assistant
    • sleep_off_time
    • total_assistant_sleep_time
    • brand_sleep
    • brand

Platform Services

Service xiaomi_miio.light_set_scene

Set one of the 4 available fixed scenes.

Service data attribute Optional Description
entity_id no Only act on a specific Xiaomi miIO light entity.
scene no Scene, between 1 and 4.

Service xiaomi_miio.light_set_delayed_turn_off

Delayed turn off.

Service data attribute Optional Description
entity_id no Only act on a specific Xiaomi miIO light entity.
time_period no Time period for the delayed turn off.

Service xiaomi_miio.light_reminder_on (Eyecare Smart Lamp 2 only)

Enable the eye fatigue reminder/notification.

Service data attribute Optional Description
entity_id no Only act on a specific Xiaomi miIO light entity.

Service xiaomi_miio.light_reminder_off (Eyecare Smart Lamp 2 only)

Disable the eye fatigue reminder/notification.

Service data attribute Optional Description
entity_id no Only act on a specific Xiaomi miIO light entity.

Service xiaomi_miio.light_night_light_mode_on (Eyecare Smart Lamp 2 only)

Turn the smart night light mode on.

Service data attribute Optional Description
entity_id no Only act on a specific Xiaomi miIO light entity.

Service xiaomi_miio.light_night_light_mode_off (Eyecare Smart Lamp 2 only)

Turn the smart night light mode off.

Service data attribute Optional Description
entity_id no Only act on a specific Xiaomi miIO light entity.

Service xiaomi_miio.light_eyecare_mode_on (Eyecare Smart Lamp 2 only)

Turn the eyecare mode on.

Service data attribute Optional Description
entity_id no Only act on a specific Xiaomi miIO light entity.

Service xiaomi_miio.light_eyecare_mode_off (Eyecare Smart Lamp 2 only)

Turn the eyecare mode off.

Service data attribute Optional Description
entity_id no Only act on a specific Xiaomi miIO light entity.

Xiaomi Smart WiFi Socket and Smart Power Strip

The xiaomi_miio switch platform allows you to control the state of your Xiaomi Smart WiFi Socket aka Plug, Xiaomi Smart Power Strip and Xiaomi Chuangmi Plug V1.

Features

Xiaomi Smart WiFi Socket

Supported models: chuangmi.plug.m1, chuangmi.plug.m3, chuangmi.plug.v2, chuangmi.plug.hmi205, chuangmi.plug.hmi206

  • Power (on, off)
  • Attributes
    • Temperature

Xiaomi Chuangmi Plug V1

Supported models: chuangmi.plug.v1, chuangmi.plug.v3, chuangmi.plug.hmi208

  • Power (on, off)
  • USB (on, off)
  • Attributes
    • Temperature

Xiaomi Smart Power Strip

Supported models: qmi.powerstrip.v1, zimi.powerstrip.v2

  • Power (on, off)
  • Wifi LED (on, off)
  • Power Price (0…999)
  • Power Mode (green, normal) (Power Strip V1 only)
  • Attributes
    • Temperature
    • Current
    • Load power
    • Wifi LED
    • Mode (Power Strip V1 only)

Xiaomi Air Conditioning Companion V3

Supported models: lumi.acpartner.v3 (the socket of the acpartner.v1 and v2 isn’t switchable!)

  • Power (on, off)
  • Attributes
    • Load power

Platform Services

Service xiaomi_miio.switch_set_wifi_led_on (Power Strip only)

Turn the wifi LED on.

Service data attribute Optional Description
entity_id no Only act on a specific Xiaomi miIO switch entity.

Service xiaomi_miio.switch_set_wifi_led_off (Power Strip only)

Turn the wifi LED off.

Service data attribute Optional Description
entity_id no Only act on a specific Xiaomi miIO switch entity.

Service xiaomi_miio.switch_set_power_price (Power Strip)

Set the power price.

Service data attribute Optional Description
entity_id no Only act on a specific Xiaomi miIO switch entity.
price no Power price, between 0 and 999.

Service xiaomi_miio.switch_set_power_mode (Power Strip V1 only)

Set the power mode.

Service data attribute Optional Description
entity_id no Only act on a specific Xiaomi miIO switch entity.
mode no Power mode, valid values are ‘normal’ and ‘green’

Retrieving the Access Token

Not recommended, please specify the cloud credentials during the config flow for easier setup. However when setting up a device manually the token can be retrieved in one of the following ways.

Xiaomi Cloud Tokens Extractor

One of Home Assistant users wrote a tokens extractor tool, which is currently the easiest way to retrieve tokens for all devices assigned to Xiaomi account. In the repository there’s executable for convenient use on Windows or Python script to be run on any platform. If you do not wish to run executable, then you can run it using the source code:

  1. Install requirements:
pip3 install pycryptodome pybase64 requests
  1. Run script
python3 token_extractor.py
  1. Provide email address or username for Xiaomi’s account, password and country of the account (most used: CN - China Mainland, DE - Germany etc.)
  2. Script will print out all devices connected to the account with their IP address and tokens for use in Home Assistant.

Xiaomi Home app (Xiaomi Aqara Gateway, Android & iOS)

  1. Install the Xiaomi Home app.
  2. Sign In/make an account.
  3. Make sure you set your region to: Mainland China (Seems to be the longest line with Chinese characters) under settings -> Region (language can later be set on English).
  4. Select your Gateway in Xiaomi Home app.
  5. Then the 3 dots at the top right of the screen.
  6. Then click on about.
  7. Tap the version number (Plug-in version 2.77.1 as of January 2020, iOS has a white space instead of version number) at the bottom of the screen repeatedly.
  8. You should now see 2 extra options listed in English (iOS still in Chinese), this means you enabled developer mode. [if not, try all steps again!].
  9. Android: under “Hub info” there is quite some text in JSON format, this includes the “token” that you need. iOS: Most options are still in Chinese, you need the fourth item from the top.

Note: If you have multiple devices needing a token, e.g., Xiaomi Mi Robot Vacuum and a Xiaomi IR Remote, the above method may not work. The Xiaomi Home app will display a token, though it isn’t the correct one. The alternative method using “Mi Home v5.4.49” will provide the correct token.

Using Get Mi Home Devices Token App

If you are on a Windows or macOS device, you can use the Get MiHome devices token App to retrieve the token. Click the link, download the file that corresponds to your OS, enter your login details and it will retrieve the access token.

Alternative methods

If using an Android device to retrieve the Access Token only v5.4.49 of Mi Home is confirmed working (December 2019). Use v5.4.49 of Mi Home locate a text file under the Smarthome/logs folder where the 32 character token is stored. There will likely be several text files in this directory, search all of them for the word ‘token’ and you should find it there. Be advised that the latest version of Mi Home does not store the token in clear text.

The iPhone app still stores the token in the SQLite db as of v4.23.4 (Nov 17, 2019).

After resetting the Wi-Fi settings of the Xiaomi robot vacuum, a new Access Token will be generated and therefore these instructions need to be followed again.

These instructions are written for the Mi Home app - not for the new RoboRock app.

This token (32 hexadecimal characters) is required for the Xiaomi Mi Robot Vacuum, Mi Robot 2 (Roborock) Vacuum, Xiaomi Philips Lights and Xiaomi IR Remote.

Android (not rooted)

If using an Android device to retrieve the Access Token only v5.4.49 of Mi Home is confirmed working (December 2019).

  1. To begin, set up your Robovac with the latest version of Mi Home on your primary Android device as you normally would.
  2. If your Robovac is already set up, you must reset its WiFi settings for it to get a new token.
  3. Using v5.4.49 of Mi Home locate a text file under the Smarthome/logs folder where the 32 character token is stored.
  4. There will likely be several text files in this directory, search all of them for the word ‘token’ and you should find it there. Be advised that the latest version of Mi Home does not store the token in clear text.

Linux and Rooted Android

  1. To begin, set up your Robovac with the latest version of Mi Home on your primary Android device as you normally would.
  2. Ensure successful operation using the latest Mi Home app and give the Vacuum a static IP in your router or however you do that on your LAN.
  3. Install version v5.4.54 of Mi Home on your rooted Android device and login (you can’t have two version of Mi Home installed at the same time).
  4. Ensure you are using the same server every time
  5. Ensure successful operation using 5.4.54 (locate is a nice simple test)
  6. Using adb we will now extract the token from the rooted phone
  7. Use adb shell to connect to your device and become root (if using Magisck root do adb shell -> su -> whoami to ensure root access.
  8. Then run grep -R ‘“token”’ /data/data/com.xiaomi.smarthome and grab the token

iOS

  1. Configure the robot with the Mi Home app. Make sure to select the correct region, as Xiaomi uses different product names for different geographical areas. Note that the new RoboRock app is currently not supported for this method.

  2. Using iTunes, create an unencrypted backup of your iPhone. Since macOS 10.15 there is no iTunes app. Use Finder instead - after connecting your iOS device you should see it in left menu of Finder window.

  3. Install iBackup Viewer, open it, and open your backup.

  4. Open the “Raw Data” module.

  5. Navigate to com.xiaomi.mihome.

  6. Search for a file that looks like this: 123456789_mihome.sqlite (Note: _mihome.sqlite is not the correct file. Most likely, you will find this file in the Documents folder.)

  7. Save this file to your filesystem.

  8. Install DB Browser for SQLite.

  9. Open DB Browser and load the .sqlite file you saved from your backup.

  10. Click on the Execute SQL tab.

  11. Input and run this query (use appropriate SELECT query for your device i.e. Vacuum, Powerstrip or Plug):

    -- Execute to retrieve token for Vacuum
    SELECT ZTOKEN FROM ZDEVICE WHERE ZMODEL LIKE "%vacuum%"
    
    -- Execute to retrieve token for Smart Powerstrip
    SELECT ZTOKEN FROM ZDEVICE WHERE ZMODEL LIKE "%powerstrip%"
    
    -- Execute to retrieve token for Smart Plug
    SELECT ZTOKEN FROM ZDEVICE WHERE ZMODEL LIKE "%plug%"
    
  12. Copy the returned 96-digit hexadecimal string to your clipboard.

  13. Open Terminal and execute this command:

    echo '0: <YOUR HEXADECIMAL STRING>' | xxd -r -p | openssl enc -d -aes-128-ecb -nopad -nosalt -K 00000000000000000000000000000000
    
  14. Use the resulting 32-digit string as your token. (On your mac in front of the terminal session)

Bluestacks

  1. Configure the robot with the Mi-Home app. Make sure to select the correct region, as Xiaomi uses different product names for different geographical areas. Note that the new RoboRock app is currently not supported for this method.
  2. Install BlueStacks.
  3. Set up Mi Home version 5.4.49 in BlueStacks and login to synchronize devices.
  4. Open Filemanager in the More Apps menu.
  5. Use Explore on the left and navigate to sdcard/SmartHome/logs/plug_DeviceManager.
  6. Click on Export to Windows in the lower left corner and select any or all files to export to you local disk.
  7. Search for "token":"<yourTokenHere>".

Miio command line tool

Use of Miio should be done before the Vacuum is connected to Mi Home. If you already connected to the app you will need to delete it and then join the ad-hoc Wi-Fi network the Vacuum creates. If the vacuum is already paired it’s likely this method will only return ??? as your token.

Discovering devices on the current network:

npx miio discover

This will list devices that are connected to the same network as your computer. Let it run for a while so it has a chance to reach all devices, as it might take a minute or two for all devices to answer.

The commands outputs each device on this format:

Device ID: 48765421
Model info: zhimi.airpurifier.m1
Address: 192.168.100.9
Token: token-as-hex-here via auto-token
Support: At least basic

The information output is:

  • Device ID - The unique identifier of the device, does not change if the device is reset.
  • Model ID- The model id if it could be determined, this indicates what type of device it is.
  • Address - The IP that the device has on the network.
  • Token - The token of the device or ??? if it could not be automatically determined.

Xiaomi Cloud Tokens Extractor

Alternate method to get all yours devices tokens in one run. Please follow this instruction.