BTHome
bthome
Integrates BTHome BLE devices into Home Assistant.
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 (carbon monoxide, contact, leak, motion, occupancy, smoke) | |
sensor | Sensor (CO₂, PM10, PM2.5, VOC, air quality, carbon monoxide, humidity, light level, temperature) |
What people report
BTHome sensors run locally over Bluetooth push. Shelly BLU Door/Window with encryption fails on newer firmware, a firmware fault per maintainer.
- Works4
- Not working1
| Device | In Home Assistant | In Apple Home | What they said | Source |
|---|---|---|---|---|
| Xiaomi LYWSD03MMC thermometer | Works Local | Flash with ATC flasher to BTHome or Zigbee over Bluetooth from a browserSaved copyAls het een lywsd03mmc is, dan zou je die kunnen flashen met ATC flasher naar standaard BThome of Zigbee. Ook voor ZTH05 is dit mogelijk. Excerpt saved from the Arctic Shift Reddit archive on 2026-10-23. | Reddit comment · 2023-11 | |
| Xiaomi LYWSD03MMC with ATC firmware | Works Local | Temperature sensors work via BTHome; reported outage was user errorSaved copyThe problem Just updated from 2023.3.2 to 2023.3.3 and all of my BT Home based temperature sensors are now unavailable. They are Xiomi LYWSD03MMC flashed with the ATC firmware and were previously working without any issues. I've tried restarting but they're all still unavailable. There's also nothing in the logs about them. ### What version of Home Assistant Core has the issue? 2023.3.3 ### What was the last working version of Home Assistant Core? 2023.3.2 ### What type of installation are you running? Home Assistant Container ### Integration causing the issue BT Home ### Link to integration … Excerpt saved from GitHub on 2026-10-23. | Issue #89480 · 2023-03 | |
| Xiaomi LYWSD03MMC with pvvx firmware | Works Local | BLE, about 2 year battery life, rock solidSaved copyLYWSD03MMCs have a \~2yr battery life with pvvx firmware (including native HA support via BTHome), yes it's BLE but it's solid as a rock. Excerpt saved from the Arctic Shift Reddit archive on 2026-10-23. | Reddit comment · 2024-09 | |
| Xiaomi Mijia LYWSD03MMC | Works Local | BLE sensor with ATC_MiThermometer firmwareSaved copyXiaomi Mijia LYWSD03MMC BLE Temperature/Humidity sensors running the ATC\_MiThermometer firmware with BTHome. They have increased a bit in price over the last year or so, but can still be had for about $6 a piece when purchased in 5 packs Excerpt saved from the Arctic Shift Reddit archive on 2026-10-23. | Reddit comment · 2024-12 | |
| Shelly BLU Door/Window sensor (encrypted) | Not working Local | Encrypted mode fails on firmware newer than 20230826; unencrypted worksSaved copyI have the same issue with several Shelly BLU Door/Window sensors. It seams to be an issue with the latest firmware versions for the Shelly BLU Door/Window sensor. Integration of an encrypted device in HomeAssistant worked fine with the original firmware of the deivce (Version "20230522-134711/v1.0.6"). After Ugrading to "20240114-142209/v1.09" or "20240202-140519/???", the integration is no longer possible because the bind key is not accepted. The behaviour is the same if i upgrade a already encrypted device to the latest firmware or if i encyrpt the device after the firmware upgrade. Excerpt saved from GitHub on 2026-10-23. | Issue #109529 · 2024-02 |
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) | 30,506 (4.31%) |
|---|---|
| Added in | Home Assistant 2022.9 |
| Set up in the UI | Yes |
| Maintainers | @Ernst79, @thecode |
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.
