https://github.com/hgross/node-red-contrib-tuya-smart

NodeRED nodes to get data from tuya smart devices (like smart plugs, bulbs, ...).
https://github.com/hgross/node-red-contrib-tuya-smart

iot node-red node-red-contrib smart-home smarthome

Last synced: 2 months ago
JSON representation

NodeRED nodes to get data from tuya smart devices (like smart plugs, bulbs, ...).

• Host: GitHub
• URL: https://github.com/hgross/node-red-contrib-tuya-smart
• Owner: hgross
• License: mit
• Created: 2018-11-04T21:27:01.000Z (about 6 years ago)
• Default Branch: master
• Last Pushed: 2020-09-07T09:25:21.000Z (over 4 years ago)
• Last Synced: 2024-11-13T16:19:49.333Z (2 months ago)
• Topics: iot, node-red, node-red-contrib, smart-home, smarthome
• Language: TypeScript
• Size: 981 KB
• Stars: 43
• Watchers: 10
• Forks: 14
• Open Issues: 6
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • License: LICENSE

Awesome Lists containing this project

• awesome-nodered - tuya-smart - Interface with smart plugs, bulbs, etc. from tuya. (Nodes / Smarthome)

README

        
# tuya-smart

[![Build Status](https://travis-ci.org/hgross/node-red-contrib-tuya-smart.svg?branch=master)](https://travis-ci.org/hgross/node-red-contrib-tuya-smart)

[![npm version](https://badge.fury.io/js/node-red-contrib-tuya-smart.svg)](https://badge.fury.io/js/node-red-contrib-tuya-smart)

Input nodes to interface with smart plugs, bulbs, ... from tuya.

Makes use of the [tuyapi library](https://github.com/codetheweb/tuyapi "tuyapi project site").

Check out their great [guide on how to get your device id/device key out of the Tuya Smart/Smart Life app](https://github.com/codetheweb/tuyapi/blob/master/docs/SETUP.md) to get started.

Once you got these device credentials, you will be able to configure and use this input node for NodeRED.

The tuya devices are sold under different names like Gosund, BlitzWolf, Teckin, Meross, Homecube, ...

Check out the [general discussion](https://github.com/codetheweb/tuyapi/issues/5) regarding the tuya api and compatibility.

![Connecting nodes](https://raw.githubusercontent.com/hgross/node-red-contrib-tuya-smart/master/images/connecting.png "Connecting tuya smart devices")

![Connected nodes and output format](https://raw.githubusercontent.com/hgross/node-red-contrib-tuya-smart/master/images/output_single_plug_meter.png "Connected tuya smart devices and data format")

![Input node with input and output format](https://raw.githubusercontent.com/hgross/node-red-contrib-tuya-smart/master/images/input-single-plug-meter.png "Input node with input and output format")

![powerstrip input node with input and output format](https://raw.githubusercontent.com/hgross/node-red-contrib-tuya-smart/master/images/input-power-strip.png "powerstrip input node with input and output format")

![tuya 3-socket powerstrip outputs explained](https://raw.githubusercontent.com/hgross/node-red-contrib-tuya-smart/master/images/output-power-strip.png "tuya 3-socket powerstrip outputs explained")

## Installation

You can install the package from the public npm registry using npm or the tooling provided by the NodeRED-GUI.

Check out the [NodeRED guide on adding nodes](https://nodered.org/docs/getting-started/adding-nodes).

## Development - how to build

You should be able to build the nodes executing

```bash

npm install

npm run-script build

```

To test them I use docker and mount the dist directory to /data/nodes like this `docker run -it --name tuya-test-container -p 1880:1880 -v $(pwd)/dist/lib:/data/nodes nodered/node-red-docker`. Be aware that by using this shortcut you have to ensure the dependencies of the nodes inside the container have to be installed manually `docker exec -it tuya-test-container bash -c 'cd /data && npm i [email protected] --upgrade'`.