node-red-contrib-tuya-devices

Support for Tuya devices in SmartHome projects using Node-RED.
The goal of the project is to allow using local devices supports Tuya in Node-Red

Getting Started

Prerequisites: Node-RED installation. For details see here.

Install via npm

$ cd ~/.node-red
$ npm install node-red-contrib-tuya-devices

then restart node-red

The Tuya devices are represented by config Nodes (single Node per device). The flow Nodes references a device node and can exists multiple times in different flows. It can be defined a project object to group and control all Tuya devices in the local network. The IP addresses of the devices will be detect automaticaly. If configured a cloud access the device capabilities will be downloded and cached localy.

First steps

Insert Tuya manager node. In the manager config form:

Add new tuya-project. In the project config form:
- set the name for the project
- Add new tuya-cloud. In the cloud config form:
- set the AccessID, AccessKey and Any deviceId (needed to recognise the userId and all devices mapped to the same user account)
- optional can be set the Tuya cloud userId if known and a name for the config node

Usage

If the cloud configuration is correct and the manager node has received at least once a message with topic 'updateDevices' all mapped devices will be listed in the config. The device capabilities will be cached localy. With the plus button can be added a config node for every local device. This config nodes contains all setting nedded to use the device localy and can be selected in the configuration of the Tuya device nodes. The device nodes can be easy connected to dashboard ui nodes (see example below). For this the single DP must be selected or a topic must be used to select a rigth DP, e.g by using of switch node. If device capabilites exists in local cache (e.g. after once successfully loaded from cloud) the device commands can be requestet by message usung topic 'dispatchCommands' (as in examle). A whole data model for the device can be requested by message with topic 'getDataModel'.

Examples

Here an flow examle for the possible control and configuration of a Tuya multifunctional alarm device.

Changelog

v1.2.x

Refactoring to use 'tuya-devices' library
Added support for MAC address and Tuya version to the local device
Added tuya explorer (Beta, e.g. http://localhost:1880/resources/node-red-contrib-tuya-devices/index.html)
Improve device scanner
Local devices can be used by IP or MAC address
added dynamic generation of device commands based on model definitions
Added extension for device category "mal". Especially for treatment of sub-devices

v1.1.x

Make possible to use local devices connected by gateway
Refactoring local chache
List cloud devices and models in the manager node configuration and create config nodes using '+' button
Model elements can be manualy translated by editing of the file "translations.json" in .node-red\projects\node-red-contrib-tuya-devices\resources{projectname}\

v1.0.x

Initial implementation
Supports WLAN Tuya devices

TODO

filter models by selected room in manager view
hide space column in manager view devices tab if room selected
add room selection control in the manager view devices tab
link the device settings view to the device row in manager view
make possible to disable device in the admin page
flow examples
Make possible to translate cloud tokens (service descriptions) to english. Existing cache can be translated using manager command with topic 'translateDeviceModels'.