Xiaomi Home

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

• Xiaomi Gateway
• Xiaomi device tracker
• Xiaomi Air Purifier, Air Humidifier and Standing Fan
• Xiaomi Air Quality Monitor
• Xiaomi IR Remote
• Xiaomi Mi Robot Vacuum
• Xiaomi Philips Light
• Xiaomi Smart Wi-Fi Socket and Smart Power Strip

Prerequisites

Most Xiaomi Home devices are configured using the Home Assistant UI. The Xiaomi device tracker and Xiaomi IR Remote require manual YAML configuration.

Before you add a device to Home Assistant:

1. Install the Xiaomi Home app and sign in to your account.
2. Add the device to the Xiaomi Home app.
3. Use the Xiaomi Home app instead of a vendor-specific app, such as the Roborock app.

Configuration

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

Xiaomi Home 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.

During setup, enter your Xiaomi Home account credentials and select the server region you use in the Xiaomi Home app. Home Assistant retrieves your device’s connection information and API token, then connects to the device over your local network.

If you cannot use your Xiaomi Home account, select Configure manually (not recommended). You need the device’s IP address and 32-character API token. For instructions on finding the API token, refer to Retrieving the access token.

Troubleshooting

Xiaomi Gateway

The Xiaomi Home 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

Retrieving connected subdevices through Xiaomi Home

Some gateways, such as lumi.gateway.mieu01, cannot retrieve connected subdevices locally. To add their subdevices, use the Xiaomi Home service.

1. During setup, provide your Xiaomi Home account credentials.
2. Go to Settings > Devices & services.
3. Select Xiaomi Home, then select the cogwheel (Configure) next to your gateway.
4. Turn on Use Xiaomi Home service to get connected subdevices, then select Submit.

Home Assistant retrieves the subdevices from Xiaomi Home, then controls them and receives their status updates over your local network. If credentials are required but have not been provided, Home Assistant starts a reauthentication flow.

Gateway features

• Alarm: Arms or disarms the gateway alarm, and shows whether it is armed away, disarmed, or arming.
• Light: Turns the gateway light on or off, and sets its brightness and color.
• Illuminance: Shows the illuminance measured by the gateway, in lux.

Supported subdevices

Home Assistant supports these subdevices:

• Weather sensor (WSDCGQ01LM)
  • Zigbee ID: lumi.sensor_ht
  • Features: Temperature and humidity sensors
• Weather sensor (WSDCGQ11LM)
  • Zigbee ID: lumi.weather.v1
  • Features: Temperature, humidity, and pressure sensors
• Wall switch single (QBKG11LM)
  • Zigbee ID: lumi.ctrl_ln1
  • Features: On/off and toggle control, and a load power sensor
• Wall switch single (QBKG11LM)
  • Zigbee ID: lumi.ctrl_ln1.aq1
  • Features: On/off and toggle control, and a load power sensor
• Wall switch no neutral (QBKG04LM)
  • Zigbee ID: lumi.ctrl_neutral1.v1
  • Features: On/off and toggle control
• Wall switch double (QBKG12LM)
  • Zigbee ID: lumi.ctrl_ln2
  • Features: On/off and toggle control, and a load power sensor
• Wall switch double (QBKG12LM)
  • Zigbee ID: lumi.ctrl_ln2.aq1
  • Features: On/off and toggle control, and a load power sensor
• Wall switch double no neutral (QBKG03LM)
  • Zigbee ID: lumi.ctrl_neutral2
  • Features: On/off and toggle control
• D1 wall switch triple (QBKG26LM)
  • Zigbee ID: lumi.switch.n3acn3
  • Features: On/off and toggle control, and a load power sensor
• D1 wall switch triple no neutral (QBKG25LM)
  • Zigbee ID: lumi.switch.l3acn3
  • Features: On/off and toggle control, and a load power sensor
• Wall outlet (QBCZ11LM)
  • Zigbee ID: lumi.ctrl_86plug.v1
  • Features: On/off and toggle control
• Wall outlet (QBCZ11LM)
  • Zigbee ID: lumi.ctrl_86plug.aq1
  • Features: On/off and toggle control, and a load power sensor
• Plug (ZNCZ02LM)
  • Zigbee ID: lumi.plug
  • Features: On/off and toggle control, and a load power sensor
• Relay (LLKZMK11LM)
  • Zigbee ID: lumi.relay.c2acn01
  • Features: On/off and toggle control, and a load power sensor
• Smart bulb E27 (ZNLDP12LM)
  • Zigbee ID: lumi.light.aqcn02
  • Features: On/off, brightness, and color temperature control
• IKEA smart bulb E27 white (LED1545G12)
  • Zigbee ID: ikea.light.led1545g12
  • Features: On/off, brightness, and color temperature control
• IKEA smart bulb E27 white (LED1546G12)
  • Zigbee ID: ikea.light.led1546g12
  • Features: On/off, brightness, and color temperature control
• IKEA smart bulb E12 white (LED1536G5)
  • Zigbee ID: ikea.light.led1536g5
  • Features: On/off, brightness, and color temperature control
• IKEA smart bulb GU10 white (LED1537R6)
  • Zigbee ID: ikea.light.led1537r6
  • Features: On/off, brightness, and color temperature control
• IKEA smart bulb E27 white (LED1623G12)
  • Zigbee ID: ikea.light.led1623g12
  • Features: On/off, brightness, and color temperature control
• IKEA smart bulb GU10 white (LED1650R5)
  • Zigbee ID: ikea.light.led1650r5
  • Features: On/off, brightness, and color temperature control
• IKEA smart bulb E12 white (LED1649C5)
  • Zigbee ID: ikea.light.led1649c5
  • Features: On/off, brightness, and color temperature control

Recognized but unsupported subdevices

Home Assistant recognizes these subdevices but does not create entities for them.

Each item lists the device name, model number, and Zigbee ID.

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

Xiaomi device tracker

The Xiaomi Mi Wi-Fi Repeater 2 device tracker requires manual YAML configuration. It reports the Wi-Fi clients associated with the repeater.

Configure the device tracker

To configure the device tracker, add its IP address and access token to your configuration.yamlThe configuration.yaml file is the main configuration file for Home Assistant. It lists the integrations to be loaded and their specific configurations. In some cases, the configuration needs to be edited manually directly in the configuration.yaml file. Most integrations can be configured in the UI. [Learn more] file. For instructions on finding the access token, refer to Retrieving the access token.

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

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 device models

The following list shows each device name and model ID.

• Air Purifier: zhimi.airpurifier.v1
• Air Purifier 2 (FJY4006CN): 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 2: dmaker.fan.p18
• Standing Fan 2 Pro: dmaker.fan.p33
• Standing Fan 3: zhimi.fan.za5

Depending on the model, air purifiers that don’t have their own section on this page can provide the following controls and entities.

Controls

• Turn the air purifier on or off.
• Select a preset mode: Auto, Silent, Favorite, or Idle.

Attributes

In addition to the standard fan attributes, the fan entity shows these attributes.

• extra_features
• turbo_mode_supported
• button_pressed
• sleep_time
• sleep_mode_learn_count
• use_time
• sleep_mode

Number entities

• Favorite level: Sets the fan level used in Favorite mode.

Sensor entities

• Filter life remaining: Shows the remaining filter life, as a percentage. Enabled by default.
• Filter use: Shows how long the filter has been in use, in hours. Enabled by default.
• Humidity: Shows the measured humidity. Enabled by default.
• Motor speed: Shows the current motor speed, in rpm. Enabled by default.
• PM2.5: Shows the measured PM2.5 concentration. Enabled by default.
• Purify volume: Shows the total volume of purified air, in cubic meters. Disabled by default.
• Temperature: Shows the measured temperature. Enabled by default.
• Use time: Shows the total device usage time. Disabled by default.

Switch entities

• Buzzer: Turns the buzzer on or off.
• Child lock: Turns the child lock on or off.
• Learn mode: Turns learn mode on or off.
• LED: Turns the LED on or off.

Air Purifier Pro

Supported model ID: zhimi.airpurifier.v6.

Controls

• Turn the air purifier on or off.
• Select a preset mode: Auto, Silent, or Favorite.

Attributes

In addition to the standard fan attributes, the fan entity shows these attributes.

• extra_features
• turbo_mode_supported
• button_pressed
• use_time
• sleep_time
• sleep_mode_learn_count

Number entities

• Favorite level: Sets the fan level used in Favorite mode.
• Volume: Sets the device volume.

Sensor entities

• Filter life remaining: Shows the remaining filter life, as a percentage. Enabled by default.
• Filter use: Shows how long the filter has been in use, in hours. Enabled by default.
• Humidity: Shows the measured humidity. Enabled by default.
• Illuminance: Shows the measured light level. Enabled by default.
• Motor speed: Shows the current motor speed, in rpm. Enabled by default.
• PM2.5: Shows the measured PM2.5 concentration. Enabled by default.
• Purify volume: Shows the total volume of purified air, in cubic meters. Disabled by default.
• Second motor speed: Shows the current speed of the second motor, in rpm. Enabled by default.
• Temperature: Shows the measured temperature. Enabled by default.
• Use time: Shows the total device usage time. Disabled by default.

Switch entities

• Child lock: Turns the child lock on or off.
• Learn mode: Turns learn mode on or off.
• LED: Turns the LED on or off.

Air Purifier Pro V7

Supported model ID: zhimi.airpurifier.v7.

Controls

• Turn the air purifier on or off.
• Select a preset mode: Auto, Silent, or Favorite.

Attributes

In addition to the standard fan attributes, the fan entity shows these attributes.

• extra_features
• turbo_mode_supported
• button_pressed

Number entities

• Favorite level: Sets the fan level used in Favorite mode.
• Volume: Sets the device volume.

Sensor entities

• Filter life remaining: Shows the remaining filter life, as a percentage. Enabled by default.
• Filter use: Shows how long the filter has been in use, in hours. Enabled by default.
• Humidity: Shows the measured humidity. Enabled by default.
• Illuminance: Shows the measured light level. Enabled by default.
• Motor speed: Shows the current motor speed, in rpm. Enabled by default.
• PM2.5: Shows the measured PM2.5 concentration. Enabled by default.
• Second motor speed: Shows the current speed of the second motor, in rpm. Enabled by default.
• Temperature: Shows the measured temperature. Enabled by default.
• Use time: Shows the total device usage time. Disabled by default.

Switch entities

• Child lock: Turns the child lock on or off.
• Learn mode: Turns learn mode on or off.
• LED: Turns the LED on or off.

Air Purifier MA2

Supported model ID: zhimi.airpurifier.ma2.

Controls

• Turn the air purifier on or off.
• Select a preset mode: Auto, Silent, Favorite, or Idle.

Attributes

In addition to the standard fan attributes, the fan entity shows these attributes.

• extra_features
• turbo_mode_supported
• button_pressed
• sleep_time
• sleep_mode_learn_count
• use_time
• sleep_mode

Number entities

• Favorite level: Sets the fan level used in Favorite mode.

Sensor entities

• Filter life remaining: Shows the remaining filter life, as a percentage. Enabled by default.
• Filter use: Shows how long the filter has been in use, in hours. Enabled by default.
• Humidity: Shows the measured humidity. Enabled by default.
• Motor speed: Shows the current motor speed, in rpm. Enabled by default.
• PM2.5: Shows the measured PM2.5 concentration. Enabled by default.
• Temperature: Shows the measured temperature. Enabled by default.
• Illuminance: Shows the light level measured on top of the device. Enabled by default.
• Use time: Shows the total device usage time. Disabled by default.

Switch entities

• Buzzer: Turns the buzzer on or off.
• Child lock: Turns the child lock on or off.
• Learn mode: Turns learn mode on or off.
• LED: Turns the LED on or off.

Air Purifier 2S

Supported model ID: zhimi.airpurifier.mc1.

Controls

• Turn the air purifier on or off.
• Select a preset mode: Auto, Silent, or Favorite.

Attributes

In addition to the standard fan attributes, the fan entity shows these attributes.

• extra_features
• turbo_mode_supported
• button_pressed

Number entities

• Favorite level: Sets the fan level used in Favorite mode.

Sensor entities

• Filter life remaining: Shows the remaining filter life, as a percentage. Enabled by default.
• Filter use: Shows how long the filter has been in use, in hours. Enabled by default.
• Humidity: Shows the measured humidity. Enabled by default.
• Motor speed: Shows the current motor speed, in rpm. Enabled by default.
• PM2.5: Shows the measured PM2.5 concentration. Enabled by default.
• Temperature: Shows the measured temperature. Enabled by default.
• Use time: Shows the total device usage time. Disabled by default.

Switch entities

• Buzzer: Turns the buzzer on or off.
• Child lock: Turns the child lock on or off.
• Learn mode: Turns learn mode on or off.
• LED: Turns the LED on or off.

Air Purifier 3 and 3H (2019)

Supported model IDs:

• zhimi.airpurifier.ma4
• zhimi.airpurifier.mb3

These models use the newer MiOT communication protocol.

Controls

• Turn the air purifier on or off.
• Select a preset mode: Auto, Silent, Favorite, or Fan.

Attributes

In addition to the standard fan attributes, the fan entity shows the use_time attribute.

Number entities

• Fan level: Sets the fan level used in Fan mode, from 1 to 3.
• Favorite level: Sets the fan level used in Favorite mode.

Select entities

• LED brightness: Sets the brightness of the LEDs: Bright, Dim, or Off.

Sensor entities

• Filter life remaining: Shows the remaining filter life, as a percentage. Enabled by default.
• Filter use: Shows how long the filter has been in use, in hours. Enabled by default.
• Humidity: Shows the measured humidity. Enabled by default.
• Motor speed: Shows the current motor speed, in rpm. Enabled by default.
• PM2.5: Shows the measured PM2.5 concentration. Enabled by default.
• Purify volume: Shows the total volume of purified air, in cubic meters. Disabled by default.
• Temperature: Shows the measured temperature. Enabled by default.
• Use time: Shows the total device usage time. Disabled by default.

Switch entities

• Buzzer: Turns the buzzer on or off.
• Child lock: Turns the child lock on or off.

Air Purifier Pro H and Pro H EU

Supported model IDs:

• zhimi.airpurifier.va1
• zhimi.airpurifier.vb2

Controls

• Turn the air purifier on or off.
• Select a preset mode: Auto, Silent, Favorite, or Fan.

Attributes

In addition to the standard fan attributes, the fan entity shows the use_time attribute.

Number entities

• Fan level: Sets the fan level used in Fan mode, from 1 to 3.
• Favorite level: Sets the fan level used in Favorite mode.

Select entities

• LED brightness: Sets the brightness of the LEDs: Bright, Dim, or Off.

Sensor entities

• Filter life remaining: Shows the remaining filter life, as a percentage. Enabled by default.
• Filter use: Shows how long the filter has been in use, in hours. Enabled by default.
• Humidity: Shows the measured humidity. Enabled by default.
• Motor speed: Shows the current motor speed, in rpm. Enabled by default.
• PM2.5: Shows the measured PM2.5 concentration. Enabled by default.
• Purify volume: Shows the total volume of purified air, in cubic meters. Disabled by default.
• Temperature: Shows the measured temperature. Enabled by default.
• Use time: Shows the total device usage time. Disabled by default.

Switch entities

• Buzzer: Turns the buzzer on or off.
• Child lock: Turns the child lock on or off.

Air Purifier 3C

Supported model IDs:

• zhimi.airpurifier.mb4
• zhimi.airp.mb4a

Controls

• Turn the air purifier on or off.
• Select a preset mode: Auto, Silent, or Favorite.

Number entities

• Favorite motor speed: Sets the motor speed used in Favorite mode, in rpm.
• LED brightness: Sets the brightness of the display.

Sensor entities

• Filter life remaining: Shows the remaining filter life, as a percentage. Enabled by default.
• Filter use: Shows how long the filter has been in use, in hours. Enabled by default.
• Motor speed: Shows the current motor speed, in rpm. Enabled by default.
• PM2.5: Shows the measured PM2.5 concentration. Enabled by default.

Switch entities

• Buzzer: Turns the buzzer on or off.
• Child lock: Turns the child lock on or off.

Air Purifier ZA1

Supported model ID: zhimi.airpurifier.za1.

Controls

• Turn the air purifier on or off.
• Select a preset mode: Auto, Silent, or Favorite.

Attributes

In addition to the standard fan attributes, the fan entity shows the use_time attribute.

Number entities

• Favorite level: Sets the fan level used in Favorite mode.

Sensor entities

• Filter life remaining: Shows the remaining filter life, as a percentage. Enabled by default.
• Filter use: Shows how long the filter has been in use, in hours. Enabled by default.
• Humidity: Shows the measured humidity. Enabled by default.
• Motor speed: Shows the current motor speed, in rpm. Enabled by default.
• PM2.5: Shows the measured PM2.5 concentration. Enabled by default.
• Temperature: Shows the measured temperature. Enabled by default.
• TVOC: Shows the measured concentration of total volatile organic compounds (TVOC). Enabled by default.

Switch entities

• Buzzer: Turns the buzzer on or off.
• Child lock: Turns the child lock on or off.

Select entities

• LED brightness: Sets the brightness of the display: Bright, Dim, or Off.

Air Purifier V3

Supported model ID: zhimi.airpurifier.v3.

Controls

• Turn the air purifier on or off.
• Select a preset mode: Auto, Silent, Favorite, Idle, Medium, High, or Strong.

Attributes

In addition to the standard fan attributes, the fan entity shows these attributes.

• sleep_time
• sleep_mode_learn_count
• extra_features
• use_time
• button_pressed

Sensor entities

• Filter life remaining: Shows the remaining filter life, as a percentage. Enabled by default.
• Filter use: Shows how long the filter has been in use, in hours. Enabled by default.
• Illuminance: Shows the measured light level. Enabled by default.
• Motor speed: Shows the current motor speed, in rpm. Enabled by default.
• PM2.5: Shows the measured PM2.5 concentration. Enabled by default.
• Purify volume: Shows the total volume of purified air, in cubic meters. Disabled by default.
• Second motor speed: Shows the current speed of the second motor, in rpm. Enabled by default.
• Use time: Shows the total device usage time. Disabled by default.

Switch entities

• Buzzer: Turns the buzzer on or off.
• Child lock: Turns the child lock on or off.
• LED: Turns the LED on or off.

Air Purifier 4 and 4 Pro

Supported model IDs:

• zhimi.airp.mb5
• zhimi.airp.vb4

These models use the newer MiOT communication protocol.

Controls

• Turn the air purifier on or off.
• Select a preset mode: Auto, Silent, Favorite, or Fan.

Attributes

In addition to the standard fan attributes, the fan entity shows the use_time attribute.

Number entities

• Fan level: Sets the fan level used in Fan mode, from 1 to 3.
• Favorite level: Sets the fan level used in Favorite mode.

Select entities

• LED brightness: Sets the brightness of the display: Bright, Dim, or Off.

Sensor entities

• Filter life remaining: Shows the remaining filter life, as a percentage. Enabled by default.
• Filter lifetime remaining: Shows the remaining filter life, in days. Enabled by default.
• Filter use: Shows how long the filter has been in use, in hours. Enabled by default.
• Humidity: Shows the measured humidity. Enabled by default.
• Motor speed: Shows the current motor speed, in rpm. Enabled by default.
• PM2.5: Shows the measured PM2.5 concentration. Enabled by default.
• PM10: Shows the measured PM10 concentration. Available on the Air Purifier 4 Pro only. Enabled by default.
• Purify volume: Shows the total volume of purified air, in cubic meters. Disabled by default.
• Temperature: Shows the measured temperature. Enabled by default.

Switch entities

• Buzzer: Turns the buzzer on or off.
• Child lock: Turns the child lock on or off.
• Ionizer: Turns the negative ion generator on or off.

Air Fresh A1

Supported model ID: dmaker.airfresh.a1.

Controls

• Turn the device on or off.
• Select a preset mode: Auto, Sleep, or Favorite.

Binary sensor entities

• Auxiliary heat status: Shows whether the heater is currently on.

Button entities

• Reset dust filter: Resets the remaining life and usage of the dust filter.

Sensor entities

• Carbon dioxide: Shows the measured carbon dioxide concentration, in ppm. Enabled by default.
• Dust filter life remaining: Shows the remaining dust filter life, as a percentage. Enabled by default.
• Dust filter lifetime remaining days: Shows the remaining dust filter life, in days. Enabled by default.
• PM2.5: Shows the measured PM2.5 concentration. Enabled by default.
• Temperature: Shows the measured outdoor temperature. Enabled by default.
• Control speed: Shows the current motor speed, in rpm. Enabled by default.
• Favorite speed: Shows the motor speed used in Favorite mode, in rpm. Enabled by default.

Switch entities

• Buzzer: Turns the buzzer on or off.
• Child lock: Turns the child lock on or off.
• Display: Turns the display on or off.
• Auxiliary heat: Turns the heater on or off.

Air Fresh VA2

Supported model ID: zhimi.airfresh.va2.

Controls

• Turn the device on or off.
• Select a preset mode: Auto or Interval.
• Set the fan speed.

Attributes

In addition to the standard fan attributes, the fan entity shows these attributes.

• use_time
• extra_features

Sensor entities

• Carbon dioxide: Shows the measured carbon dioxide concentration, in ppm. Enabled by default.
• Filter life remaining: Shows the remaining filter life, as a percentage. Enabled by default.
• Filter use: Shows how long the filter has been in use, in hours. Enabled by default.
• Humidity: Shows the measured humidity. Enabled by default.
• PM2.5: Shows the measured PM2.5 concentration. Enabled by default.
• Temperature: Shows the measured temperature. Enabled by default.
• Use time: Shows the total device usage time. Disabled by default.

Select entities

• LED brightness: Sets the brightness of the LEDs: Bright, Dim, or Off.

Switch entities

• Buzzer: Turns the buzzer on or off.
• Child lock: Turns the child lock on or off.
• LED: Turns the LED on or off.

Air Fresh VA4

Supported model ID: zhimi.airfresh.va4.

Controls

• Turn the device on or off.
• Select a preset mode: Auto or Interval.
• Set the fan speed.

Attributes

In addition to the standard fan attributes, the fan entity shows these attributes.

• use_time
• extra_features

Sensor entities

• Carbon dioxide: Shows the measured carbon dioxide concentration, in ppm. Enabled by default.
• Filter life remaining: Shows the remaining filter life, as a percentage. Enabled by default.
• Filter use: Shows how long the filter has been in use, in hours. Enabled by default.
• Humidity: Shows the measured humidity. Enabled by default.
• PM2.5: Shows the measured PM2.5 concentration. Enabled by default.
• Temperature: Shows the measured temperature. Enabled by default.
• Use time: Shows the total device usage time. Disabled by default.

Select entities

• LED brightness: Sets the brightness of the LEDs: Bright, Dim, or Off.

Switch entities

• Buzzer: Turns the buzzer on or off.
• Child lock: Turns the child lock on or off.
• LED: Turns the LED on or off.
• Auxiliary heat: Turns the heater on or off.

Air Fresh T2017

Supported model ID: dmaker.airfresh.t2017.

Controls

• Turn the device on or off.
• Select a preset mode: Auto, Sleep, or Favorite.

Binary sensor entities

• Auxiliary heat status: Shows whether the heater is currently on.

Button entities

• Reset dust filter: Resets the remaining life and usage of the dust filter.
• Reset upper filter: Resets the remaining life and usage of the upper filter.

Select entities

• Auxiliary heat level: Sets the heater level: Low, Medium, or High.
• Display orientation: Sets the orientation of the display: Forward, Left, or Right.

Sensor entities

• Carbon dioxide: Shows the measured carbon dioxide concentration, in ppm. Enabled by default.
• Dust filter life remaining: Shows the remaining dust filter life, as a percentage. Enabled by default.
• Dust filter lifetime remaining days: Shows the remaining dust filter life, in days. Enabled by default.
• Upper filter life remaining: Shows the remaining upper filter life, as a percentage. Enabled by default.
• Upper filter lifetime remaining days: Shows the remaining upper filter life, in days. Enabled by default.
• PM2.5: Shows the measured PM2.5 concentration. Enabled by default.
• Temperature: Shows the measured outdoor temperature. Enabled by default.
• Control speed: Shows the current motor speed, in rpm. Enabled by default.
• Favorite speed: Shows the motor speed used in Favorite mode, in rpm. Enabled by default.

Switch entities

• Buzzer: Turns the buzzer on or off.
• Child lock: Turns the child lock on or off.
• Display: Turns the display on or off.
• Auxiliary heat: Turns the heater on or off.

Air Humidifier

Supported model ID: zhimi.humidifier.v1.

Controls

• Turn the humidifier on or off.
• Select a mode: Silent, Medium, High, or Strong.
• Set the target humidity from 30% to 80%, in steps of 10%.

Binary sensor entities

• Water tank: Shows whether the water tank is attached.

Select entities

• LED brightness: Sets the brightness of the LEDs: Bright, Dim, or Off.

Sensor entities

• Humidity: Shows the measured humidity. Enabled by default.
• Temperature: Shows the measured temperature. Enabled by default.
• Use time: Shows the total device usage time. Disabled by default.
• Water level: Shows the water level in the tank, as a percentage. Enabled by default.

Switch entities

• Buzzer: Turns the buzzer on or off.
• Child lock: Turns the child lock on or off.

Air Humidifier CA1

Supported model ID: zhimi.humidifier.ca1.

Controls

• Turn the humidifier on or off.
• Select a mode: Silent, Medium, High, or Auto.
• Set the target humidity from 30% to 80%, in steps of 10%.

Binary sensor entities

• Water tank: Shows whether the water tank is attached.

Select entities

• LED brightness: Sets the brightness of the LEDs: Bright, Dim, or Off.

Sensor entities

• Humidity: Shows the measured humidity. Enabled by default.
• Motor speed: Shows the current motor speed, in rpm. Enabled by default.
• Temperature: Shows the measured temperature. Enabled by default.
• Use time: Shows the total device usage time. Disabled by default.
• Water level: Shows the water level in the tank, as a percentage. Enabled by default.

Switch entities

• Buzzer: Turns the buzzer on or off.
• Child lock: Turns the child lock on or off.
• Dry mode: Turns dry mode on or off.

Air Humidifier CA4

Supported model ID: zhimi.humidifier.ca4.

Controls

• Turn the humidifier on or off.
• Select a mode: Auto, Low, Mid, or High.
• Set the target humidity from 30% to 80%.

Binary sensor entities

• Water tank: Shows whether the water tank is attached.

Number entities

• Motor speed: Sets the motor speed, in rpm.

Select entities

• LED brightness: Sets the brightness of the LEDs: Bright, Dim, or Off.

Sensor entities

• Actual speed: Shows the current motor speed, in rpm. Enabled by default.
• Humidity: Shows the measured humidity. Enabled by default.
• Temperature: Shows the measured temperature. Enabled by default.
• Use time: Shows the total device usage time. Disabled by default.
• Water level: Shows the water level in the tank, as a percentage. Enabled by default.

Switch entities

• Buzzer: Turns the buzzer on or off.
• Child lock: Turns the child lock on or off.
• Clean mode: Turns clean mode on or off.
• Dry mode: Turns dry mode on or off.

Air Humidifier CB1

Supported model ID: zhimi.humidifier.cb1.

Controls

• Turn the humidifier on or off.
• Select a mode: Silent, Medium, High, or Auto.
• Set the target humidity from 30% to 80%, in steps of 10%.

Binary sensor entities

• Water tank: Shows whether the water tank is attached.

Select entities

• LED brightness: Sets the brightness of the LEDs: Bright, Dim, or Off.

Sensor entities

• Humidity: Shows the measured humidity. Enabled by default.
• Motor speed: Shows the current motor speed, in rpm. Enabled by default.
• Temperature: Shows the measured temperature. Enabled by default.
• Use time: Shows the total device usage time. Disabled by default.
• Water level: Shows the water level in the tank, as a percentage. Enabled by default.

Switch entities

• Buzzer: Turns the buzzer on or off.
• Child lock: Turns the child lock on or off.
• Dry mode: Turns dry mode on or off.

Air Humidifier JSQ, JSQ1, and MJJSQ

Supported model IDs:

• deerma.humidifier.jsq
• deerma.humidifier.jsq1
• deerma.humidifier.mjjsq

Controls

• Turn the humidifier on or off.
• Select a mode: Low, Medium, High, or Humidity.
• Set the target humidity from 30% to 80%.

Binary sensor entities

• Water tank: Shows whether the water tank is attached.
• Water tank empty: Shows whether the water tank is empty.

Sensor entities

• Humidity: Shows the measured humidity. Enabled by default.
• Temperature: Shows the measured temperature. Enabled by default.

Switch entities

• Buzzer: Turns the buzzer on or off.
• LED: Turns the LED on or off.

Standing Fan 1X

Supported model ID: dmaker.fan.p5.

Controls

• Turn the fan on or off.
• Select a preset mode: Normal or Nature.
• Turn oscillation on or off.

Number entities

• Delay off countdown: Sets a timer, in minutes, after which the fan turns off.
• Oscillation angle: Sets the oscillation angle, in degrees.

Switch entities

• Buzzer: Turns the buzzer on or off.
• Child lock: Turns the child lock on or off.
• LED: Turns the LED on or off.

Standing Fan

Supported model IDs:

• zhimi.fan.za1
• zhimi.fan.za3
• zhimi.fan.za4
• zhimi.fan.sa1

Controls

• Turn the fan on or off.
• Select a preset mode: Normal or Nature.
• Turn oscillation on or off.

Number entities

• Delay off countdown: Sets a timer, in minutes, after which the fan turns off.
• Oscillation angle: Sets the oscillation angle, in degrees.

Select entities

• LED brightness: Sets the brightness of the LEDs: Bright, Dim, or Off.

Switch entities

• Buzzer: Turns the buzzer on or off.
• Child lock: Turns the child lock on or off.

DC Pedestal Fan

Supported model IDs:

• zhimi.fan.v2
• zhimi.fan.v3

Controls

• Turn the fan on or off.
• Select a preset mode: Normal or Nature.
• Turn oscillation on or off.

Number entities

• Delay off countdown: Sets a timer, in minutes, after which the fan turns off.
• Oscillation angle: Sets the oscillation angle, in degrees.

Select entities

• LED brightness: Sets the brightness of the LEDs: Bright, Dim, or Off.

Sensor entities

• Battery: Shows the battery level, as a percentage. Enabled by default.
• Humidity: Shows the measured humidity. Enabled by default.
• Temperature: Shows the measured temperature. Enabled by default.

Switch entities

• Buzzer: Turns the buzzer on or off.
• Child lock: Turns the child lock on or off.

Standing Fan 1C

Supported model ID: dmaker.fan.1c.

Controls

• Turn the fan on or off.
• Select a preset mode: Normal or Nature.
• Turn oscillation on or off.

Number entities

• Delay off countdown: Sets a timer, in minutes, after which the fan turns off.

Switch entities

• Buzzer: Turns the buzzer on or off.
• Child lock: Turns the child lock on or off.
• LED: Turns the LED on or off.

Tower Fan/Standing Fan 2/Standing Fan 2 Pro/Standing Fan Pro

Supported model IDs:

• dmaker.fan.p9
• dmaker.fan.p10
• dmaker.fan.p11
• dmaker.fan.p18
• dmaker.fan.p33

Controls

• Turn the fan on or off.
• Select a preset mode: Normal or Nature.
• Turn oscillation on or off.

Number entities

• Delay off countdown: Sets a timer, in minutes, after which the fan turns off.
• Oscillation angle: Sets the oscillation angle, in degrees.

Switch entities

• Buzzer: Turns the buzzer on or off.
• Child lock: Turns the child lock on or off.
• LED: Turns the LED on or off.

Standing Fan 3

Supported model ID: zhimi.fan.za5.

Controls

• Turn the fan on or off.
• Select a preset mode: Normal or Nature.
• Turn oscillation on or off.

Binary sensor entities

• Power supply: Shows whether the power supply is connected.

Number entities

• Delay off countdown: Sets a timer, in minutes, after which the fan turns off.
• LED brightness: Sets the brightness of the LEDs.
• Oscillation angle: Sets the oscillation angle, in degrees.

Sensor entities

• Humidity: Shows the measured humidity. Enabled by default.
• Temperature: Shows the measured temperature. Enabled by default.

Switch entities

• Buzzer: Turns the buzzer on or off.
• Child lock: Turns the child lock on or off.
• Ionizer: Turns the ionizer on or off.

Actions

These devices support the standard humidifier and fan actions, such as humidifier.set_humidity, humidifier.set_mode, fan.set_percentage, and fan.set_preset_mode. To act on a specific device, target its entity.

The integration also adds Xiaomi-specific actions for air purifiers, such as Fan reset filter and Fan set extra features. For the full list, see Actions.

Xiaomi Air Quality Monitor

Home Assistant shows the air quality measured by your Xiaomi Mi Air Quality Monitor (PM2.5).

• Air quality: Shows the air quality index (AQI). Its attributes show the power state, charging state, battery level, display clock, night mode and its schedule, and sensor state.

Depending on the model, a separate air quality entity also provides readings for PM2.5, PM10, carbon dioxide, carbon dioxide equivalent, total volatile organic compounds (TVOC), temperature, and humidity.

Xiaomi IR Remote

The Xiaomi IR Remote (ChuangmiIr) requires manual YAML configuration. It lets you send infrared commands to other devices.

Configure the remote

To configure the remote, add its IP address and access token to your configuration.yamlThe configuration.yaml file is the main configuration file for Home Assistant. It lists the integrations to be loaded and their specific configurations. In some cases, the configuration needs to be edited manually directly in the configuration.yaml file. Most integrations can be configured in the UI. [Learn more] file. For instructions on finding the access token, refer to Retrieving the access token.

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

Create reusable commands

Define named commands when you want to reuse them in scripts or dashboard controls.

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]

Send commands from a dashboard

You can add a named command to a dashboard as an entity button.

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

You can also use named commands in a script.

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

Command formats

The Xiaomi IR Remote supports raw and Pronto hex command formats.

Raw commands

A raw command is learned with the Remote learn command action.

The following is an example raw command:

raw:Z6UFANEAAAAjAQAAAwkAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAQIAE=

You can add the frequency as the last parameter:

raw:Z6UFANEAAAAjAQAAAwkAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAQIAE=:38400

Pronto hex codes

A Pronto hex code is often supplied by the device manufacturer.

The following is an example Pronto hex command:

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

You can add the number of repeats as the last parameter when required by the device:

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

The following Xiaomi IR Remote models are identified by their model IDs:

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

Pronto hex codes work only with chuangmi.ir.v2.

Available actions

The Xiaomi IR Remote registers a generic remote.send_command action, along with Xiaomi-specific actions for learning commands and controlling the remote’s LED.

remote.send_command

Use this action to send a named command or a command in one of the supported formats.

To learn a new command, use the Remote learn command action. After learning, the base64 string is shown as a notification in Overview, where you can copy it. Commands learned to the same slot can still be sent using remote.send_command even if they are overwritten.

For the full list of actions this integration adds, see Actions.

Xiaomi Mi Robot Vacuum

The Xiaomi Home integration lets you control your Xiaomi Mi Robot Vacuum.

The vacuum supports these actions:

• 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)

Actions

In addition to all of the actions provided by the vacuum integration (start, pause, stop, return_to_base, locate, set_fan_speed, and send_command), this integration adds Xiaomi-specific actions to clean zones and segments, send the robot to a coordinate, and remote control the robot. For the full list, see Actions.

Button entities

• Reset main brush: Resets the remaining life of the main brush.
• Reset side brush: Resets the remaining life of the side brush.
• Reset filter: Resets the remaining life of the filter.
• Reset sensor dirty: Resets the remaining time until the sensors need cleaning.

Sensor entities

• Battery: Shows the battery level, in percent. Enabled by default.
• Current clean area: Shows the area cleaned during the current cleaning run, in square meters. When the vacuum is not cleaning, shows the same value as Last clean area. Enabled by default.
• Current clean duration: Shows the duration of the current cleaning run. When the vacuum is not cleaning, shows the same value as Last clean duration. Enabled by default.
• DnD start: Shows when the next Do Not Disturb period starts. Disabled by default.
• DnD end: Shows when the current or next Do Not Disturb period ends. Disabled by default.
• Filter remaining: Shows the remaining filter life. Enabled by default.
• Last clean area: Shows the area cleaned during the last cleaning run, in square meters. Enabled by default.
• Last clean duration: Shows the duration of the last cleaning run. Enabled by default.
• Last clean end: Shows when the last cleaning run ended. Enabled by default.
• Last clean start: Shows when the last cleaning run started. Enabled by default.
• Main brush remaining: Shows the remaining main brush life. Enabled by default.
• Side brush remaining: Shows the remaining side brush life. Enabled by default.
• Sensor dirty remaining: Shows the remaining time until the sensors need cleaning. Enabled by default.
• Total clean area: Shows the total area cleaned, in square meters. Disabled by default.
• Total clean count: Shows the total number of cleaning runs. Disabled by default.
• Total duration: Shows the total cleaning time. Disabled by default.
• Total dust collection count: Shows the total number of dust collections. Disabled by default.

Binary sensor entities

Binary sensor entities are only available for vacuums with a mop.

• Water box attached: Shows whether the water box is attached. Enabled by default. On models with a separate mop, an additional Mop attached entity shows whether the mop is attached.
• Water shortage: Shows whether the water box is low on water. Enabled by default.

Attributes

In addition to the standard vacuum attributes, the vacuum entity shows these attributes:

• status: The current status reported by the vacuum.
• error: The current error, if the vacuum reports one.
• timers: The cleaning timers set on the vacuum, if any.

Cleaning a specific room

Use vacuum.send_command to clean a specific room:

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

The params value specifies a room number. To clean multiple rooms, provide a list of room numbers, such as 17 and 18. For instructions on finding valid room numbers and the rooms they map to, refer to Retrieving room numbers.

Resetting maintenance hours

The vacuum entity stores the remaining time before its brushes, filter, and sensors need maintenance in the main_brush_left, side_brush_left, filter_left, and sensor_dirty_left attributes. The values are measured in hours. After cleaning or replacing a part, use vacuum.send_command to reset its maintenance hours. This example resets the main brush:

script:
  reset_main_brush_left:
    alias: "Reset hours for main brush replacement"
    sequence:
      - action: vacuum.send_command
        target:
          entity_id: vacuum.xiaomi_vacuum_cleaner
        data:
          command: reset_consumable
          params:
            - "main_brush_work_time"

The reset_consumable command supports these params values:

• main_brush_work_time
• side_brush_work_time
• filter_work_time
• sensor_dirty_time

Retrieve zone cleaning coordinates

Using FloleVac (Android)

1. Download FloleVac.
2. Sign in with your Xiaomi Home account.
3. Open the map while connected to the same network as your vacuum.
4. Select Zone cleanup, then draw a box around the area you want to clean.
5. Press and hold Cleanup to copy the zone coordinates to your clipboard.

Using RoboRock Control Center (requires Valetudo firmware)

RoboRock Control Center supports rooted and non-rooted vacuums and can work locally without the cloud. If you install Valetudo firmware on a rooted vacuum, you can connect to it with SSH and enable MQTT and map functions.

Use the map editor to find the coordinates for zone cleaning. This example cleans a zone:

script:
  vacuum_kitchen:
    alias: "Vacuum kitchen"
    sequence:
      - action: vacuum.send_command
        target:
          entity_id: "vacuum.xiaomi_vacuum_cleaner"
        data:
          command: app_zoned_clean
          params:
            - - 23084
              - 26282
              - 27628
              - 29727
              - 1

Retrieving room numbers

Use the Miio command-line tool to retrieve room numbers:

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

The command returns room numbers and their user-defined names as (number, name) pairs. You can also test the clean_segment action with a number to identify the room it cleans.

The vacuum appears to use numbers 1 through 15 for its initial room segmentation. Numbers 16 and above appear to be rooms created by manual edits.

Xiaomi Philips Light

The Xiaomi Home light 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 model IDs:

• philips.light.bulb
• philips.light.candle
• philips.light.candle2
• philips.light.downlight

Controls

• Turn the light on or off.
• Set the brightness.
• Set the color temperature from about 3000 K to 5700 K.
• Select a fixed scene: 1, 2, 3, or 4.
• Turn the light off after a delay, in seconds.

Attributes

In addition to the standard light attributes, the light entity shows these attributes.

• scene
• delayed_turn_off

Philips LED Ceiling Lamp

Supported model IDs:

• philips.light.ceiling
• philips.light.zyceiling

Controls

• Turn the light on or off.
• Set the brightness.
• Set the color temperature from about 2700 K to 5700 K.
• Select a fixed scene: 1, 2, 3, or 4.
• Turn the light off after a delay, in seconds.

Attributes

In addition to the standard light attributes, the light entity shows these attributes.

• scene
• delayed_turn_off
• night_light_mode
• automatic_color_temperature

Philips Eyecare Smart Lamp 2

Supported model ID: philips.light.sread1.

This lamp has two light entities: the eyecare light and the ambient light.

Controls

• Turn the eyecare light on or off.
• Turn the ambient light on or off.
• Set the brightness of each light.
• Select a fixed scene: 1, 2, 3, or 4.
• Turn night light mode on or off.
• Turn the eyecare light off after a delay, in seconds.
• Turn the eye fatigue reminder on or off.
• Turn eyecare mode on or off.

Attributes

In addition to the standard light attributes, the eyecare light entity shows these attributes.

• scene
• delayed_turn_off
• night_light_mode
• reminder
• eyecare_mode

Philips Zhirui Desk Lamp

Supported model IDs:

• philips.light.mono1
• philips.light.hbulb

Controls

• Turn the light on or off.
• Set the brightness.
• Select a fixed scene: 1, 2, 3, or 4.
• Turn the light off after a delay, in seconds.

Attributes

In addition to the standard light attributes, the light entity shows these attributes.

• scene
• delayed_turn_off

Philips Moonlight Bedside Lamp

Supported model ID: philips.light.moonlight.

Controls

• Turn the light on or off.
• Set the brightness.
• Set the color.
• Set the color temperature from about 1700 K to 6500 K.
• Select a fixed scene: 1, 2, 3, 4, 5, or 6.

Attributes

In addition to the standard light attributes, the light entity shows these attributes.

• scene
• sleep_assistant
• sleep_off_time
• total_assistant_sleep_time
• band_sleep
• band

Actions

This integration adds actions to set a fixed scene, schedule a delayed turn off, and, on the Philips Eyecare Smart Lamp 2, toggle the reminder, night light, and eyecare modes. For the full list, see Actions.

Xiaomi Smart Wi-Fi Socket and Smart Power Strip

The Xiaomi Home switch platform lets you control your Xiaomi Smart Wi-Fi Socket, Xiaomi Smart Power Strip, and Xiaomi Chuangmi Plug V1.

Features

Xiaomi Smart Wi-Fi Socket

Supported model IDs:

• chuangmi.plug.m1
• chuangmi.plug.m3
• chuangmi.plug.v2
• chuangmi.plug.hmi205
• chuangmi.plug.hmi206

Controls

• Turn the socket on or off.

Attributes

In addition to the standard switch attributes, the switch entity shows these attributes.

• model
• temperature

Xiaomi Chuangmi Plug V1

Supported model IDs:

• chuangmi.plug.v1
• chuangmi.plug.v3
• chuangmi.plug.hmi208

Controls

• Turn the plug on or off.
• Turn the USB port on or off.

Attributes

In addition to the standard switch attributes, the switch entities show these attributes.

• model
• temperature

Xiaomi Smart Power Strip

Supported model IDs:

• qmi.powerstrip.v1
• zimi.powerstrip.v2

Controls

• Turn the power strip on or off.
• Turn the Wi-Fi LED on or off.
• Set the power price, from 0 to 999.
• Set the power mode to Green or Normal. Only available on the qmi.powerstrip.v1.

Attributes

In addition to the standard switch attributes, the switch entity shows these attributes.

• model
• temperature
• load_power

On the qmi.powerstrip.v1, it also shows the power_mode attribute.

Xiaomi Air Conditioning Companion V3

Supported model ID: lumi.acpartner.v3. You cannot control the socket on lumi.acpartner.v1 and lumi.acpartner.v2.

Controls

• Turn the socket on or off.

Attributes

In addition to the standard switch attributes, the switch entity shows these attributes.

• model
• load_power

Actions

This integration adds actions to toggle the Wi-Fi LED and, on supported power strips, set the power mode and power price. For the full list, see Actions.

List of actions

The Xiaomi Home integrationIntegrations connect and integrate Home Assistant with your devices, services, and more. [Learn more] provides the following actions. Each link below opens a dedicated page with examples, parameters, and a step-by-step UI walkthrough.

• Fan reset filter (xiaomi_miio.fan_reset_filter) Resets the filter lifetime and usage of a Xiaomi air purifier.

• Fan set extra features (xiaomi_miio.fan_set_extra_features) Sets a storage register that unlocks extra features in the Mi Home app.

• Light eyecare mode off (xiaomi_miio.light_eyecare_mode_off) Turns off eyecare mode on a Xiaomi Philips Eyecare Smart Lamp 2.

• Light eyecare mode on (xiaomi_miio.light_eyecare_mode_on) Turns on eyecare mode on a Xiaomi Philips Eyecare Smart Lamp 2.

• Light night light mode off (xiaomi_miio.light_night_light_mode_off) Turns off night light mode on a Xiaomi Philips Eyecare Smart Lamp 2.

• Light night light mode on (xiaomi_miio.light_night_light_mode_on) Turns on night light mode on a Xiaomi Philips Eyecare Smart Lamp 2.

• Light reminder off (xiaomi_miio.light_reminder_off) Disables the eye fatigue reminder on a Xiaomi Philips Eyecare Smart Lamp 2.

• Light reminder on (xiaomi_miio.light_reminder_on) Enables the eye fatigue reminder on a Xiaomi Philips Eyecare Smart Lamp 2.

• Light set delayed turn off (xiaomi_miio.light_set_delayed_turn_off) Schedules a Xiaomi Philips light to turn off after a delay.

• Light set scene (xiaomi_miio.light_set_scene) Sets a fixed scene on a Xiaomi Philips light.

• Remote learn command (xiaomi_miio.remote_learn_command) Learns an IR command with a Xiaomi IR remote.

• Remote set LED off (xiaomi_miio.remote_set_led_off) Turns off the blue LED of a Xiaomi IR remote.

• Remote set LED on (xiaomi_miio.remote_set_led_on) Turns on the blue LED of a Xiaomi IR remote.

• Switch set power mode (xiaomi_miio.switch_set_power_mode) Sets the power mode of a Xiaomi power strip.

• Switch set power price (xiaomi_miio.switch_set_power_price) Sets the power price stored on a Xiaomi power strip.

• Switch set Wi-Fi LED off (xiaomi_miio.switch_set_wifi_led_off) Turns off the Wi-Fi LED of a Xiaomi smart plug or power strip.

• Switch set Wi-Fi LED on (xiaomi_miio.switch_set_wifi_led_on) Turns on the Wi-Fi LED of a Xiaomi smart plug or power strip.

• Vacuum clean segment (xiaomi_miio.vacuum_clean_segment) Starts a Xiaomi robot vacuum cleaning one or more segments or rooms.

• Vacuum clean zone (xiaomi_miio.vacuum_clean_zone) Starts a Xiaomi robot vacuum cleaning one or more rectangular zones.

• Vacuum go to (xiaomi_miio.vacuum_goto) Sends a Xiaomi robot vacuum to a specific coordinate on its map.

• Vacuum remote control move (xiaomi_miio.vacuum_remote_control_move) Steers a Xiaomi robot vacuum while it is in remote control mode.

• Vacuum remote control move step (xiaomi_miio.vacuum_remote_control_move_step) Makes a Xiaomi robot vacuum perform a single remote control move.

• Vacuum remote control start (xiaomi_miio.vacuum_remote_control_start) Puts a Xiaomi robot vacuum into remote control mode.

• Vacuum remote control stop (xiaomi_miio.vacuum_remote_control_stop) Takes a Xiaomi robot vacuum out of remote control mode.

For an overview of every action across all integrations, see the actions reference.

Retrieving the access token

Only retrieve an access token if you are setting up a device manually or configuring a Xiaomi Mi Wi-Fi Repeater 2 or Xiaomi IR Remote in configuration.yamlThe configuration.yaml file is the main configuration file for Home Assistant. It lists the integrations to be loaded and their specific configurations. In some cases, the configuration needs to be edited manually directly in the configuration.yaml file. Most integrations can be configured in the UI. [Learn more]. For other devices, sign in to your Xiaomi Home account during setup so Home Assistant can retrieve the token automatically.

Xiaomi Cloud Tokens Extractor

The community-maintained Xiaomi Cloud Tokens Extractor can retrieve tokens for devices connected to your Xiaomi account. The project provides a Windows executable and Python source code for other platforms. To run the source code:

1. Install the requirements:

pip3 install pycryptodome pybase64 requests

2. Run the script:

python3 token_extractor.py

3. Enter the email address or username, password, and region for your Xiaomi account.
4. The script lists the devices connected to the account with their IP addresses and access tokens.

Retrieving a gateway access token using Xiaomi Home

1. Install the Xiaomi Home app and sign in to your account.
2. Set the region to Chinese mainland.
3. Select your gateway, then select the three dots menu .
4. Select About.
5. Repeatedly select the version number at the bottom of the page to enable developer mode.
6. On Android, select Hub info, then find the token value in the JSON text. On iOS, select the fourth option from the top.

Retrieving an access token with the Get Mi Home Devices Token app

On Windows or macOS, you can use Get MiHome devices token to retrieve an access token. Download the file for your operating system, enter your sign-in details, and follow the app’s instructions.

Other ways to retrieve an access token

Android (not rooted)

1. Set up your vacuum in the current version of the Xiaomi Home app.
2. If the vacuum is already set up, reset its Wi-Fi settings to generate a new access token.
3. Install Mi Home version 5.4.49 and locate a text file in the Smarthome/logs folder.
4. Search the files for token to find the 32-character access token.

Linux and rooted Android

1. Set up your vacuum in the current version of the Xiaomi Home app.
2. Assign the vacuum a static IP address in your router.
3. Install Mi Home version 5.4.54 on your rooted Android device and sign in. You cannot install two Mi Home versions at the same time.
4. Use the same server region that you used to set up the vacuum.
5. Connect to the device with adb shell and become root.
6. Run grep -R '"token"' /data/data/com.xiaomi.smarthome to find the access token.

iOS

1. Set up the vacuum in the Xiaomi Home app. Select the region used to set up the vacuum, as product names vary by region.

2. Create an unencrypted backup of your iPhone using iTunes. On macOS 10.15 and later, use Finder instead.

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 named like 123456789_mihome.sqlite. Do not use _mihome.sqlite. The file is usually in the Documents folder.

7. Save the file to your computer.

8. Install DB Browser for SQLite, open it, then open the .sqlite file.

9. Select the Execute SQL tab.

10. Run the query for your device type:

    -- Retrieve the token for a vacuum
    SELECT ZTOKEN FROM ZDEVICE WHERE ZMODEL LIKE "%vacuum%"
    
    -- Retrieve the token for a smart power strip
    SELECT ZTOKEN FROM ZDEVICE WHERE ZMODEL LIKE "%powerstrip%"
    
    -- Retrieve the token for a smart plug
    SELECT ZTOKEN FROM ZDEVICE WHERE ZMODEL LIKE "%plug%"
    

11. Copy the returned 96-digit hexadecimal string.

12. Run this command in a terminal:

    echo '0: <YOUR HEXADECIMAL STRING>' | xxd -r -p | openssl enc -d -aes-128-ecb -nopad -nosalt -K 00000000000000000000000000000000
    

13. Use the resulting 32-character string as the access token.

Bluestacks

1. Set up the vacuum in the Xiaomi Home app, using the region selected when you set up the vacuum.
2. Install BlueStacks.
3. Install Mi Home version 5.4.49 in BlueStacks and sign in to synchronize your devices.
4. In the More Apps menu, open File Manager.
5. Select Explore, then navigate to sdcard/SmartHome/logs/plug_DeviceManager.
6. Select Export to Windows, then export one or more files to your local disk.
7. Search the exported files for "token":"<yourTokenHere>".

Miio command line tool

Use Miio before connecting the vacuum to the Xiaomi Home app. If the vacuum is already paired, remove it from the app and join the ad hoc Wi-Fi network created by the vacuum. Otherwise, the command might return ??? instead of the access token.

To discover devices on the current network, run:

npx miio discover

The command lists devices connected to the same network as your computer. Allow a few minutes for all devices to respond.

The command displays each device in 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 output includes:

• Device ID: The unique identifier of the device. It does not change if you reset the device.
• Model ID: The model ID, when it can be identified.
• Address: The device’s IP address.
• Token: The access token, or ??? if the command cannot determine it automatically.