This integration supports Tuya devices connected via BLE. After initial setup via QR code login, the integration operates fully offline — all device communication happens locally over Bluetooth with no cloud dependency.
Inspired by code of @redphx & https://github.com/ProfessorQuantumUniverse/ha_tuya_ble_irrigation
Original HASS component forked from https://github.com/PlusPlus-ua/ha_tuya_ble
Place the custom_components folder in your configuration directory (or add its contents to an existing custom_components folder). Alternatively install via HACS.
After adding to Home Assistant, the integration will discover all supported Bluetooth devices, or you can add discoverable devices manually.
The integration works locally, but connecting to a Tuya BLE device requires a device ID and encryption key from the Tuya cloud. This is obtained via QR code login using your Smart Life / Tuya Smart app — no Tuya IoT developer account required. After initial setup, credentials are stored locally and no further cloud connection is needed.
Setup steps:
- Add the integration and enter your User Code (found in Smart Life app: Me > Settings > Account and Security > User Code)
- Scan the displayed QR code in your Smart Life / Tuya Smart app
- Select your BLE device from the discovered list
| Platform | Description |
|---|---|
binary_sensor |
Door/window state, smoke/CO alarms, button events |
button |
Reset, program triggers |
climate |
Thermostatic radiator valves (TRV) |
cover |
Blind and curtain controllers (open/close/stop) |
light |
LED strip lights, lamps (on/off, brightness, color) |
lock |
Smart locks (lock/unlock, unlock tracking) |
number |
Countdown timers, temperature calibration, Fingerbot program parameters |
select |
Mode selection, Fingerbot program mode |
sensor |
Battery, temperature, humidity, usage time, RSSI, work state |
switch |
On/off, child lock, window check, antifreeze, Fingerbot switches |
text |
Fingerbot program text |
valve |
Water valve controllers (open/close/stop) |
The integration supports a broad range of Tuya BLE devices across the following categories:
| Category | Examples |
|---|---|
Fingerbots (szjqr, kg) |
Fingerbot, Fingerbot Plus, CubeTouch, Nedis Finger Robot, Switch Robot |
Temperature & humidity sensors (wsdcg) |
Soil moisture sensors, BLE temp/humidity sensors, soil thermo-hygrometers |
CO2 sensors (co2bj) |
CO2 detectors |
Smart locks (ms, jtmspro) |
Smart locks, cylinder locks, Raycube K7 Pro+, CentralAcesso |
Climate (wk) |
Thermostatic radiator valves (TRV) |
Irrigation & water (ggq, sfkzq) |
Irrigation computers, water valves, dual water timers |
Smart water bottle (znhsb) |
Smart water bottles |
PARKSIDE batteries (dcb) |
Smart batteries 4Ah / 8Ah |
Lights (dd) |
LED strip lights, floor/sunset lamps |
Blinds & curtains (cl) |
Blind/curtain controllers, venetian blind motors |
Plant sensors (zwjcy) |
Soil moisture / plant sensors |
For the full, up-to-date list of supported devices with their product IDs, see SUPPORTED_DEVICES.md.
Contributions are welcome, whether it's a new device, a bug fix, or an improvement. See CONTRIBUTING.md for details on:
- Adding support for a new device
- Setting up a development environment
- Running the lint/format checks and unit tests
- The PR process
Please open an issue or pull request on GitHub.
This integration's QR code login approach was inspired by tuya-local-key, which demonstrates retrieving Tuya device local keys via QR code login without requiring a Tuya IoT developer account.