Skip to content

airy10/ha_tuya_ble

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Home Assistant support for Tuya BLE devices

Overview

This integration supports Tuya devices connected via BLE.

Inspired by code of @redphx

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 official Tuya integration. To obtain the credentials, please refer to official Tuya integration documentation

Supported devices list

  • Fingerbots (category_id 'szjqr')

    • Fingerbot (product_ids 'ltak7e1p', 'y6kttvd6', 'yrnk7mnn', 'nvr2rocq', 'bnt7wajf', 'rvdceqjh', '5xhbk964'), original device, first in category, powered by CR2 battery.
    • Adaprox Fingerbot (product_id 'y6kttvd6'), built-in battery with USB type C charging.
    • Fingerbot Plus (product_ids 'blliqpsj', 'ndvkgsrm', 'yiihr7zh', 'neq16kgd'), almost same as original, has sensor button for manual control.
    • CubeTouch 1s (product_id '3yqdo5yt'), built-in battery with USB type C charging.
    • CubeTouch II (product_id 'xhf790if'), built-in battery with USB type C charging.

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

  • Temperature and humidity sensors (category_id 'wsdcg')

    • Soil moisture sensor (product_id 'ojzlzzsw').
  • CO2 sensors (category_id 'co2bj')

    • CO2 Detector (product_id '59s19z5m').
  • Smart Locks (category_id 'ms', 'jtmspro')

    • Smart Lock (product_id 'ludzroix', 'isk2p555').
    • Raybuke K7 Pro+ (product_id 'xicdxood'), supports ble unlock and other small features.
  • Climate (category_id 'wk')

    • Thermostatic Radiator Valve (product_ids 'drlajpqc', 'nhj2j7su').
  • Smart water bottle (category_id 'znhsb')

    • Smart water bottle (product_id 'cdlandip')
  • Irrigation computer (category_id 'ggq')

    • Irrigation computer (product_id '6pahkcau')
  • Lights

    • Most BLE light products should be supported as the Light class tries to get device description from the cloud when there are added but only Strip Lights (category_id 'dd') Magiacous RGB light bar (product_id 'nvfrtxlq') has has been tested

      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

Support project

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

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Python 100.0%