Skip to content
Home Assistant TestFlight
Xiaomi

Xiaomi BLE

xiaomi_ble

Built inLocal push

Integrates devices that use the Xiaomi Mijia BLE MiBeacon protocol and the BLE protocols implemented in the MiScales and the MiFora plant sensor. This integration does not support Xiaomi BLE Mesh devices. The integration listens to Bluetooth broadcasts that the device makes by itself, allowing it to track the latest sensor values or events without waking the device up for polling (except HHCCJCY01, see note below). This method conserves battery lifetime.

In Apple Home through HomeKit Bridge

What HomeKit Bridge makes of each kind of entity this integration creates, read from its source code. A device only gets the ones that apply to it.

EntityShows up asNote
binary_sensorSensor (contact, leak, motion, occupancy, smoke)
sensorSensor (humidity, light level, temperature)

What people report

Local BLE advertisement parsing covers many Xiaomi sensors; newer ones need a bindkey, and old Flower Care firmware is not supported (no polling).

  • Works2
  • Partly works3
  • Requested1
DeviceIn Home AssistantIn Apple HomeWhat they saidSource
Linptech PS1BB pressure sensorWorks LocalSupport added in March 2026
Saved copy
Proposed change Add support for the Linptech PS1BB seat pressure sensor in the xiaomi_ble integration. This adds two `SENSOR_DESCRIPTIONS` entries for the new sensor types introduced in xiaomi-ble: - `PRESSURE_PRESENT_DURATION`, how long the seat has been occupied (seconds) - `PRESSURE_NOT_PRESENT_DURATION`, how long the seat has been vacant (seconds) These map the new `ExtendedSensorDeviceClass` values from the xiaomi-ble library to Home Assistant `SensorEntityDescription` objects. Depends on Bluetooth-Devices/xiaomi-ble#283 being released (adds the PS1BB parser, device entry, and the new …

Excerpt saved from GitHub on 2026-10-23.

PR #166095 · 2026-03
Xiaomi Mijia human presence sensor XMOSB01XSWorks LocalBattery-based 2024 occupancy sensor supported via xiaomi-ble 0.31.1
Saved copy
Proposed change xiaomi-ble changelog: https://github.com/Bluetooth-Devices/xiaomi-ble/compare/v0.30.2...v0.31.1 feat: support 2024 new battery based xiaomi mijia occupancy(human presence) sensor (XMOSB01XS) New test cases are added. Also the change is verified by Home Assistant (

Excerpt saved from GitHub on 2026-10-23.

PR #124751 · 2024-08
Xiaomi door/window sensor 2Partly works LocalBattery entity flaky on firmware 2.1.0_0059
Saved copy
The problem The sleepy devices fix doesn't seem to work on the battery entity yet. This affects the MotionSensor2 - RTCGQ02LM (stock firmware) and the DoorWindowContact2 MCCGQ02HL with newest firmware 2.1.0_0059 (apparently not with older firmware) ### What version of Home Assistant Core has the issue? 2023.2.5 ### What was the last working version of Home Assistant Core? _No response_ ### What type of installation are you running? Home Assistant OS ### Integration causing the issue xiaomi_ble ### Link to integration documentation on our website …

Excerpt saved from GitHub on 2026-10-23.

Issue #88437 · 2023-02
Xiaomi LYWSD02 e-paper clockPartly works LocalChina-market firmware 2.0.1_0021 is encrypted; needs a bindkey
Saved copy
The problem I have two LYWSD02 (Xiaomi humidity and temperature and e-Paper) from the same seller on Aliexpress. Only one of them is showing up in Home Assistant. There seems to be different versions of the device, im the Mi Home app I can see that they have different Plugin versions and firmwares even though they're both updated to the newest firmware available to them. The one that shows up in Home Assistant is running: Plugin version 489.8-80.8 Firmware 1.1.2_0097 The one that dosen't show up in Home Assistant is running: Plugin version 489.8-3.8 Firmware 2.0.1_0021 They're otherwise …

Excerpt saved from GitHub on 2026-10-23.

Issue #91847 · 2023-04
Xiaomi Mijia motion sensor 2Partly works LocalBattery entity temporarily unavailable on sleepy device
Saved copy
The problem The sleepy devices fix doesn't seem to work on the battery entity yet. This affects the MotionSensor2 - RTCGQ02LM (stock firmware) and the DoorWindowContact2 MCCGQ02HL with newest firmware 2.1.0_0059 (apparently not with older firmware) ### What version of Home Assistant Core has the issue? 2023.2.5 ### What was the last working version of Home Assistant Core? _No response_ ### What type of installation are you running? Home Assistant OS ### Integration causing the issue xiaomi_ble ### Link to integration documentation on our website …

Excerpt saved from GitHub on 2026-10-23.

Issue #88437 · 2023-02
Xiaomi Flower Care plant sensor (firmware 2.6.2)RequestedOld firmware lacks advertisements; needs polling fallback, which is not provided
Saved copy
The problem I have two Xiaomi Flower Care plant sensors. One I was able to make work work following the firmware update instructions, however the other can not be upgraded to a newer firmware version. Maybe it's from a different batch? It's running on Firmware 2.6.2 and the Flower Care app does not give the option to upgrade the firmware. Years and years ago I had developed the Flower Care/MiFlora plugin for PiMatic, and then this sensor was working. You can find the source code here: https://github.com/rrooggiieerr/pimatic-ble-mi-flora ### What version of Home Assistant Core has the issue? …

Excerpt saved from GitHub on 2026-10-23.

Issue #79511 · 2022-10

Gathered from GitHub issues, pull requests, discussions and docs, and from r/homeassistant. These are individual reports, so check the linked thread and the date before you buy.

How it connects

Local push

Talks to the device on your network, and the device tells Home Assistant the moment something changes.

Found automatically over

  • Bluetooth

Details

Installs (analytics)28,065 (3.96%)
Added inHome Assistant 2022.8
Set up in the UIYes
Maintainers@Jc2k, @Ernst79

Devices listed in its documentation

  • Install the official "Flower Care" app by HHCC:
  • Google Play (requires location and storage permission)
  • Apple App Store
  • Place the device with the app within 10cm of the plant sensor
  • Press the "+" button on the top right in the devices tab of the app
  • Add the plant sensor to the app and select an arbitrary plant
  • Wait for the synchronization of the sensor to finish, and a dialog asking for a firmware update should appear (this might take a few minutes)
  • The installed and latest firmware version can be verified by selecting the plant -> three dots menu -> Hardware settings -> Hardware update
  • The Flower Care account and app are not required any further for this integration to work

In ReReHome

Whatever HomeKit Bridge shares reaches Apple Home as normal HomeKit accessories behind your Home Assistant bridge, so ReReHome shows and controls them like any other.

Bridges get their own settings page listing the accessories behind them.