🌡️ Control custom display content on PVVX firmware Xiaomi BLE thermometers directly from Home Assistant
This custom integration enables Home Assistant users to send custom display content to Xiaomi thermometers flashed with the PVVX firmware.
You can send GATT write commands to display:
BigNumber(Main value)SmallNumber(Secondary text)Icon(Emoji or symbol)Validity(Display timeout duration in seconds)
✨ Built upon Home Assistant’s native Bluetooth Framework (habluetooth, bleak),
this integration coexists perfectly with the official BTHome passive broadcast receiver -- no conflict, seamless coexistence.
Install in HACS with button:
or
- Open HACS in Home Assistant
- Go to "Integrations"
- Click the three dots in the top right and select "Custom repositories"
- Add this repository URL: https://github.com/Angelic47/pvvx_display Select category "Integration" Click "Install" Restart Home Assistant
Recommended: Clone directly into your Home Assistant custom components directory
cd /config/custom_components
git clone https://github.com/Angelic47/pvvx_display.gitAlternatively, you may download this repo as .zip and extract it to:
/config/custom_components/pvvx_display
Then restart Home Assistant.
This integration supports two setup methods:
- Home Assistant will automatically scan for nearby PVVX devices (requires Bluetooth enabled or configured BLE proxy)
- Navigate to Settings > Devices & Services > Discovered and click Configure
- Confirm the device to finish setup
🎯 Supports ESPHome Bluetooth Proxy for remote discovery and control
If the device is not auto-discovered:
- Go to Settings > Devices & Services > Add Integration
- Search for
PVVX Display - Enter the device MAC address in uppercase (e.g.,
A4:C1:38:12:34:56)
This integration registers a service called pvvx_display.show.
- Can be used via Developer Tools > Services or within automations and scripts
- You can specify the device address and display contents directly
💡 Supported parameters are listed in
services.yaml, or search forpvvx_display.showin the Developer Tools UI for schema details.
Once a device is configured, it also provides a device action:
- Can be used in automations via UI without entering the MAC address manually
- The graphical editor provides field hints and full support
- ✅ Fully compatible with the official
BTHomeintegration (no conflict) - ✅ Works with ESPHome Bluetooth Proxy (no onboard adapter required)
⚠️ Connection and write typically take 5–10 seconds, suitable for status messages, ambient updates, or light display tasks (not for real-time switching)
This project is licensed under the MIT License.