Xiaomi Home for Home Assistant (built-in integration)

About

Xiaomi Home is a built-in integration that connects Xiaomi devices to Home Assistant and works locally. It covers many platforms, including vacuums, fans, humidifiers, lights, remotes, switches, sensors and alarms. Setup happens in the UI, where a device can be added with an IP address and API token, or through a Xiaomi account with a server region, and Home Assistant can also discover devices on the network. Beyond basic entities, it offers actions such as resetting a fan filter, setting a light scene, learning an IR command on a remote, and setting a switch power mode. Vacuums can be told to clean specific rooms or zones, or to go to given coordinates. An option lets it use the Xiaomi Home service to get connected subdevices, and a diagnostics file can be downloaded for bug reports.

Automatic summary of Home Assistant's source code. Something wrong? Get in touch

Supports

Works locally Talks to your devices on your own network. No vendor cloud in between.
Set up in the UI Add it in Settings, Devices and services. Nothing to download.
Found by itself Home Assistant spots it on the network and offers to add it.
Updated with Home Assistant Ships and updates with every Home Assistant release.

Provides

Lights
Humidifiers
Fans
Alarms
Remotes
Vacuums
Switches
Sensors
Presence

Setting it up

Home Assistant usually finds it on the network and offers to add it. It can also be added by hand under Settings, Devices and services.

Enter the address

IP address
API token

Cloud

Server region
Password
Username
Configure manually (not recommended)

Connect

Device model

Choose a device

Device

After setup

Use Xiaomi Home service to get connected subdevices

Texts from Home Assistant's source code, Apache License 2.0.

Entities

Binary sensorsMop attached, Water shortage, Water tank empty, Power supply, Auxiliary heat status, Water tank
ButtonsReset dust filter, Reset upper filter, Reset filter, Reset main brush, Reset sensor dirty, Reset side brush
NumbersOscillation angle, Delay off countdown, Fan level, Favorite level, Favorite motor speed, LED brightness, Motor speed, Volume
SelectsMode, Display orientation, LED brightness, Auxiliary heat level
SensorsActual speed, Air quality, Air quality index, Last clean area, Current clean area, Current clean duration, Control speed, Total clean count, DnD end, DnD start, Last clean duration, Total dust collection count, and 24 more
SwitchesIonizer, Autodetect, Buzzer, Child lock, Clean mode, Display, Dry mode, Learn mode, LED, Auxiliary heat

Actions

Fan reset filterResets the filter lifetime and usage.Fields: Entity ID
Fan set extra featuresManipulates a storage register which advertises extra features. The Mi Home app evaluates the value. A feature called "turbo mode" is unlocked in the app on value 1.Fields: Entity ID, Features
Light eyecare mode offTurns off the eyecare mode of a light (EYECARE SMART LAMP 2 ONLY).Fields: Entity ID
Light eyecare mode onTurns on the eyecare mode of a light (EYECARE SMART LAMP 2 ONLY).Fields: Entity ID
Light night light mode offTurns off the night light mode of a light (EYECARE SMART LAMP 2 ONLY).Fields: Entity ID
Light night light mode onTurns on the night light mode of a light (EYECARE SMART LAMP 2 ONLY).Fields: Entity ID
Light reminder offDisables the eye fatigue reminder/notification (EYECARE SMART LAMP 2 ONLY).Fields: Entity ID
Light reminder onEnables the eye fatigue reminder/notification (EYECARE SMART LAMP 2 ONLY).Fields: Entity ID
Light set delayed turn offSets the delayed turning off of a light.Fields: Entity ID, Time period
Light set sceneSets a fixed scene.Fields: Entity ID, Scene
Remote learn commandLearns an IR command. Select Perform action, point the remote at the IR device, and the learned command will be shown as a notification in Overview.Fields: Slot, Timeout
Remote set LED offTurns off the remote’s blue LED.
Remote set LED onTurns on the remote’s blue LED.
Switch set power modeSets the power mode.Fields: Entity ID, Mode
Switch set power priceSets the power price.Fields: Entity ID, Mode
Switch set Wi-Fi LED offTurns off the Wi-Fi LED of a switch.Fields: Entity ID
Switch set Wi-Fi LED onTurns on the Wi-Fi LED of a switch.Fields: Entity ID
Vacuum clean segmentStarts cleaning of the specified segments/rooms.Fields: Segments
Vacuum clean zoneStarts the cleaning operation in the selected areas for the number of repeats indicated.Fields: Repeats, Zone
Vacuum go toSends the robot to the specified coordinates.Fields: X coordinate, Y coordinate