Xiaomi BLE
xiaomi_ble
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.
| Entity | Shows up as | Note |
|---|---|---|
binary_sensor | Sensor (contact, leak, motion, occupancy, smoke) | |
sensor | Sensor (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
| Device | In Home Assistant | In Apple Home | What they said | Source |
|---|---|---|---|---|
| Linptech PS1BB pressure sensor | Works Local | Support added in March 2026Saved copyProposed 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 XMOSB01XS | Works Local | Battery-based 2024 occupancy sensor supported via xiaomi-ble 0.31.1Saved copyProposed 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 2 | Partly works Local | Battery entity flaky on firmware 2.1.0_0059Saved copyThe 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 clock | Partly works Local | China-market firmware 2.0.1_0021 is encrypted; needs a bindkeySaved copyThe 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 2 | Partly works Local | Battery entity temporarily unavailable on sleepy deviceSaved copyThe 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) | Requested | Old firmware lacks advertisements; needs polling fallback, which is not providedSaved copyThe 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 in | Home Assistant 2022.8 |
| Set up in the UI | Yes |
| 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.