This integration is an amalgamation of a number of community maintained forks. It should be considered unstable quality at this time.
See full list of forks: ha-tuya-ble#1
Inspired by code of @redphx & forked from https://github.com/PlusPlus-ua/ha_tuya_ble
Original HASS component forked from https://github.com/PlusPlus-ua/ha_tuya_ble
This forks base is from https://github.com/markusg1234/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 integration should discover all supported Bluetooth devices, or you can add discoverable devices manually.
The integration works locally, but connection to Tuya BLE device requires device ID and encryption key from Tuya IOT cloud. It could be obtained using the same credentials as in the previous official Tuya integration. To obtain the credentials, please refer to official Tuya integration documentation [1]
Newer protocol-v2 devices require a matching 16-character localKey and
secKey. If Tuya IoT OpenAPI omits secKey, setup asks whether the device is
owned by Smart Life or Tuya Smart, signs in to that mobile service once,
and imports both keys atomically. Mobile session tokens are not stored, and the
integration never logs in to the mobile API in the background.
Tuya's mobile API is private and its versioned application profiles can expire.
Interactive captcha, MFA, social, and QR logins are not automated. If automatic
retrieval fails, the existing manual setup form is prefilled with the OpenAPI
device data so the key pair can be completed from another trusted source.
Classic devices that genuinely do not use secKey can leave it empty.
See a device marked Experimental you have? We could use real world testing feedback (send in a pull request with testing notes, or open an issue for gaps)
| Category | Category ID | Device / Model | Product ID | Notes |
|---|---|---|---|---|
| Fingerbots | szjqr |
Fingerbot | ltak7e1p, y6kttvd6, yrnk7mnn, nvr2rocq, bnt7wajf, rvdceqjh, 5xhbk964 |
Original device, first in category, powered by CR2 battery. |
| Adaprox Fingerbot | y6kttvd6 |
Built-in battery with USB type C charging. | ||
| Fingerbot Plus | blliqpsj, ndvkgsrm, yiihr7zh, neq16kgd, mknd4lci, riecov42, 6jcvqwh0, h8kdwywx |
Almost same as original, has sensor button for manual control. See programming note below. | ||
| Fingerbot Touch | bs3ubslo |
Two independent capacitive-touch channels, each with its own mode, touch duration and action/switch entities. Built-in battery with USB type C charging. | ||
| CubeTouch 1s | 3yqdo5yt |
Built-in battery with USB type C charging. | ||
| CubeTouch II | xhf790if |
Built-in battery with USB type C charging. | ||
| Tuya BLE Switch Robot (SB02) | 4ctjfrzq |
— | ||
| Tuya BLE Fingerbot SM-FB-01B | gnpbj0bq |
— | ||
| Nedis SmartLife Finger Robot | yn4x5fa7 |
— | ||
| Temperature and humidity sensors | wsdcg, zwjcy |
Soil moisture sensor | ojzlzzsw, gpkyrocn, gvygg3m8 |
— |
| SRB-PM01 Soil Moisture Sensor | jabotj1z |
— | ||
| Temperature Humidity Sensor | jm6iasmb, tr0kabuq, iv7hudlj, vlzqwckk |
— | ||
| Temperature Humidity Sensor SS302 | 6lbesej0 |
— | ||
| TH05 Temperature Sensor | vyfoip9h, 1jvidcsf |
Experimental | ||
| Soil Thermo-Hygrometer | tv6peegl |
— | ||
| CO2 sensors | co2bj |
CO2 Detector | 59s19z5m, wmb2xzj6 |
— |
| Smart Locks | ms, jtmspro |
Smart Lock | ludzroix, isk2p555, gumrixyt, uamrw6h3, sidhzylo, mqc2hevy, 7a4xvbtt |
— |
| Primebras Athenas Lock | 6fibxtph |
— | ||
| Foxgard Smart Fingerprint Door Lock | 99gv5nmz |
— | ||
| Guard Dog Security Smart Lock (BS_PLD01) | wgv4haro |
Experimental | ||
| Pulido PLD_P130 Smart Lever Lock | 0qxp5u7s |
Fingerprint and BLE unlock. DP 33 (automatic_lock in the Tuya cloud) is exposed as Free passage mode. |
||
| HU06 Smart Lock | stugc8dl |
Experimental | ||
| Raybuke K7 Pro+ | xicdxood |
Supports BLE unlock and other small features. | ||
| Fingerprint Smart Lock | k53ok3u9 |
— | ||
| T55D | bvclwu9b |
Battery & Door status. | ||
| Gimdow A1 Pro Max | rlyxv7pe |
Experimental. | ||
| A1 Ultra-JM | hc7n0urm |
— | ||
| LA-01 Smart lock | oyqux5vv |
Experimental. | ||
| B16 | ajk32biq |
— | ||
| CS-9 Smart Fingerprint Lock | pyawczjj |
Experimental. | ||
| Smart Cylinder Lock | z7lj676i |
— | ||
| TEKXDD Fingerprint Smart Lock | okkyfgfs |
— | ||
| Orion Smart Door Handle Lock | a6nttc41 |
— | ||
| Smart Cylinder Lock (LVD11_BK) | hs21i377 |
— | ||
| Smart Lock | kholoaew |
Partial. | ||
| CentralAcesso | ebd5e0uauqx0vfsp |
— | ||
| Drawer Lock CTL20H / CTL20H_8018 SmartLock | y2yaegze, qcrilcpr |
— | ||
| Gainsborough Liberty BLE Lock (GGC01HA) | yfqp0shy |
— | ||
| BSTUOKEY Invisible Lock | kpn4zaf7 |
Invisible induction lock. | ||
| XCase NX-4964 Lock Box | qicggi0m |
— | ||
| EL605A Knob Lock | 2hmqh0ty |
BLE unlock via DP71. Requires the FD50 device-info handshake. | ||
| Smart Lock C-014S | djrqe0q6 |
Experimental. BLE unlock via DP71, lock via DP46, state from DP47 (no separate unlock button; the lock entity covers it). FD50 device-info handshake enabled. Battery, alarm, unlock-method counters, auto-lock, volume, double verification and doorbell exposed. | ||
| Example Product Securosmart lock | uyf1ewof |
— | ||
| Climate | wk |
Thermostatic Radiator Valve | drlajpqc, nhj2j7su, zmachryv |
— |
wkf |
Thermostatic Radiator Valve | llflaywg |
— | |
| Smart water bottle | znhsb |
Smart water bottle | cdlandip |
— |
| Irrigation computer | ggq, slj |
Irrigation computer | 6pahkcau |
— |
| 2-outlet irrigation computer | hfgdqhho, fnlw6npo, qycalacn, jjqi2syk, jntxv3q4 |
Also known as: SGW02, SGW08, YZD02B, MOES BWV-YC02-EU-GY, Kogan SmarterHome KASMWATMRDA / KASMWTV2LVA. | ||
| RESTMO BT Water Meter (FML026A) | mqqna0px |
— | ||
| Covers | cl |
Moes Roller Blind Motor | 4pbr8eig |
— |
| Amazon HeyBlinds | vlwf3ud6, v3fzfd2y |
— | ||
| Tuya Smart Curtain Robot | kcy0x4pi |
— | ||
| Blinds Drive | qqdxfdht |
— | ||
| LY Curtain Motor Robot | ulughw4g |
— | ||
| AOK AM24 Venetian Blinds Motor | dy4dh1q0 |
Experimental. | ||
| Roller Blind Robot RSH-MC27 | ousymtkt |
— | ||
| Water valve controller | sfkzq |
Water valve controller | nxquc5lb |
— |
| NOUS L11 Bluetooth Smart Garden Water Timer | 46zia2nz |
— | ||
| WT-03W Diivoo Smart Water Timer for Garden Hose | 1fcnd8xk |
— | ||
| ZX-7378 Smart Irrigation Controller | ldcdnigc |
— | ||
| Rainpoint TTV102B | e1poaiwa |
— | ||
| Valve controller | svhikeyq, 0axr5s0b, d4vpmigg |
Also known as YZD05 water valve/irrigation timer. | ||
| HCT-611 Water Timer | tqzkwarw |
— | ||
| Unistyle WT-04W Water Timer | ojrvmfkk |
— | ||
| MoistenLand Water Timer | 8t5hebn0 |
Experimental | ||
| Lights | Multiple (e.g. dd, dj) |
Strip Lights / Magiacous RGB light bar | nvfrtxlq |
Most BLE light products should be supported as the Light class tries to get device description from the cloud when they are added. But only Strip Lights (category_id 'dd') Magiacous RGB light bar (product_id 'nvfrtxlq') has been tested. See note on Bluetooth Mesh light compatibility below. |
| Magiacous Floor Lamp | umzu0c2y |
|||
| Comfamoli Sunset Lamp | 6jxcdae1 |
|||
| RGB Strip Light | 0qgrjxum |
|||
| LED BULB B509Z2 | bpqbwf8y |
Experimental | ||
| Wireless switches | wxkg |
Arlec Smart Button | kpzc6pm8, ja5osu5g |
Single/Double click and Long press support via events. |
| Battery | dcb |
Parkside Performance Smart Battery 4Ah | z5ztlw3k, vllfabvs |
— |
| Parkside Performance Smart Battery 8Ah | ajrhf1aj |
— | ||
| Parkside Performance Smart Battery 12Ah | fay1puxy |
— | ||
| Humidifier | jsq |
Dituo DT-T2190A Aroma Diffuser | if1nolcm |
Experimental |
| Robot mowers | gcj |
Parkside Robot Mower PAMRC 250 A1 (BT) City | 9hdajpiw |
Lawn mower entity (start / pause / dock), command and schedule buttons, battery, activity, warning, error and work logs, schedule and zones, running time, rain delay, rain mode, hedgehog protection and blade stop. Experimental |
All features available in Home Assistant, programming (series of actions) is implemented for Fingerbot Plus.
For programming exposed entities: 'Program' (switch), 'Repeat forever', 'Repeats count', 'Idle position' and 'Program' (text). Format of program text is: position[/time];... where position is in percents, optional time is in seconds (zero if missing).
Note that some light products are using Bluetooth Mesh protocols and not BLE and so aren't compatible with this integration. That's probably the case if your product isn't at least found (even if non-working) by this integration.
Note that the original hasn't been updated in a long time, still, Support original developer @PlusPlus-ua:
I am working on this integration in Ukraine. Our country was subjected to brutal aggression by Russia. The war still continues. The capital of Ukraine - Kyiv, where I live, and many other cities and villages are constantly under threat of rocket attacks. Our air defense forces are doing wonders, but they also need support. So if you want to help the development of this integration, donate some money and I will spend it to support our air defense.
