BTHome Sensors – Support
This page provides support and contact information for the BTHome Sensors mobile application.
Supported devices & compatibility
BTHome Sensors reads nearby Bluetooth devices that broadcast data using the BTHome protocol. Examples include Shelly BLU devices, selected Xiaomi, Miaomiaoce, Qingping and Tuya sensors with BTHome firmware, and open-source or custom-built sensors.
This is a non-exhaustive list of devices with documented BTHome support, rather than a list of models individually tested in the app. Compatibility depends on the device firmware, broadcast settings and data types supported by the app.
Shelly BLU — native BTHome broadcasts
- Shelly BLU Button1
- Shelly BLU Door/Window
- Shelly BLU H&T
- Shelly BLU Motion
- Shelly BLU RC Button 4
- Shelly BLU Wall Switch 4
- Shelly BLU Button Tough 1 ZB
- Shelly BLU Door/Window ZB
- Shelly BLU H&T ZB
- Shelly BLU H&T Display ZB
- Shelly BLU Motion ZB
- Shelly BLU RC Button 4 ZB
- Shelly BLU Wall Switch 4 ZB
- Shelly BLU Remote Control ZB
- Shelly BLU Distance
- Shelly BLU TRV
ZB models are listed for their Bluetooth BTHome broadcasts. The app does not read Zigbee traffic. For Shelly BLU TRV, this list refers to broadcast data, not radiator control or configuration.
Ecowitt / Shelly weather station
- Ecowitt WS90 with Shelly integration — BTHome model SBWS-90CM.
The standard WS90 radio version is not covered by this entry.
Xiaomi, Miaomiaoce & Qingping — BTHome firmware required
- Xiaomi Mijia LYWSD03MMC
- Xiaomi Mijia LYWSD02MMC
- Xiaomi Mijia MJWSD05MMC
- Xiaomi Mijia MJWSD06MMC
- Miaomiaoce MHO-C401
- Miaomiaoce MHO-C401N
- Miaomiaoce MHO-C122
- Qingping CGG1-Mijia
- Qingping CGDK2 (Temp & RH Monitor Lite)
These models require compatible PVVX / ATC_MiThermometer firmware with the advertising format set to BTHome. Their original manufacturer firmware is not covered by this list. Check the exact hardware revision in the firmware documentation; the update method varies by model.
Selected Tuya models — BTHome firmware required
- Tuya TH03
- Tuya LKTMZL02
- Tuya ZTH05
- Tuya TS0201 (supported Telink variants)
- Tuya TH03Z
- Tuya ZTH01
- Tuya ZTH02
- Tuya ZY-ZTH02
- Tuya ZY-ZTH02Pro
- Tuya ZY-ZTH03Pro
- Tuya ZG-227Z
- Tuya SGS01 plant monitor
- HOBEIAN/Sonoff Tuya ZG-303Z soil sensor
- Tuya ZBEACON-TH01 / v2.0
- Tuya ZBEACON-MC
Only hardware variants supported by the PVVX firmware project are covered, after installing the appropriate BLE firmware and enabling BTHome broadcasts. Some variants require a programmer or hardware modifications. A matching product name alone does not establish compatibility, and Zigbee-only firmware cannot be read by the app.
Open-source & DIY devices — configured to broadcast BTHome
- b-parasite soil, temperature, humidity and light sensors running BTHome BLE firmware.
- ESP32 / Espressif sensors using BTHomeV2 ESP32 or BTHome-weather-station firmware.
- Espruino / Puck.js devices running BTHome scripts, including the BTHome Electricity Meter project.
- Seeed Studio XIAO nRF52840 Sense running the BTHome Inertial Sensor CircuitPython example.
- Other Bluetooth sensors running firmware that broadcasts standards-compliant BTHome data.
Before scanning: confirm that BTHome broadcasting is enabled and keep the device within Bluetooth range. Buttons and other event-driven devices may only send data when pressed or triggered. Encrypted broadcasts require the correct device bindkey and support for that encryption mode in the app.
Contact
If you have questions, issues, or feedback, contact the developer:
Email: bthome.sensors@gmail.com
Common questions
- The app scans nearby Bluetooth devices using the BTHome protocol.
- Sensor data is stored locally on your device only.
- You can delete stored data at any time from within the app.
- Bluetooth and Location permissions are required for device scanning.
Privacy
For details about data handling and privacy, see the Privacy Policy:
Privacy Policy