Skip to content

About

Home Assistant support for Tuya BLE devices

Resources

Contributing

Stars

0 stars

Watchers

0 watching

Forks

 
 

Repository files navigation

Home Assistant support for Tuya BLE devices

Overview

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

Installation

Place the custom_components folder in your configuration directory (or add its contents to an existing custom_components folder). Alternatively install via HACS.

Open your Home Assistant instance and open a repository inside the Home Assistant Community Store.

Usage

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.

Supported devices list

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

Fingerbots Programming Note

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).

Lights Compatibility Note

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.

Buy me an air defense

About

Home Assistant support for Tuya BLE devices

Resources

Contributing

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages