fjumelle/domoticz-Tuya-SmartPlug
1
0
Fork 0
Code Issues Pull Requests Projects Releases Wiki Activity

multisocket added

Browse Source
This commit is contained in:
tixi
2018-12-15 15:43:15 +01:00
parent e33229af35
commit b751731096
5 changed files with 599 additions and 128 deletions
Download Patch File Download Diff File Expand all files Collapse all files

39
README.md
View File

@@ -1,14 +1,13 @@
# Domoticz-Tuya-SmartPlug-Plugin
A Domoticz plugin to manage Tuya Smart Plug
A Domoticz plugin to manage Tuya Smart Plug (single and multi socket device)
## ONLY TESTED FOR Raspberry Pi
With Python version 3.5 & Domoticz version 4.9700 (stable) and 4.9999 (beta)
With Python version 3.5 & Domoticz version 4.9700 (stable)
## Prerequisites
This plugin is based on the latest pytuya Python library. For the installation of this library,
This plugin is based on the pytuya Python library. For the installation of this library,
follow the Installation guide below.
See [`https://github.com/clach04/python-tuya/`](https://github.com/clach04/python-tuya/) for more information.
@@ -33,7 +32,9 @@ sudo /etc/init.d/domoticz.sh restart
```
In the web UI, navigate to the Hardware page. In the hardware dropdown there will be an entry called "Tuya SmartPlug".
## Known issue
## Known issues
1/ python environment
Domoticz may not have the path to the pycrypto library in its python environment.
In this case you will observe something starting like that in the log:
@@ -53,6 +54,14 @@ cd ~/domoticz/plugins/Domoticz-Tuya-SmartPlug-Plugin
ln -s /home/pi/.local/lib/python3.5/site-packages/Crypto Crypto
```
2/ Tuya app
The tuya app must be close. This limitation is due to the tuya device itself that support only one connection.
3/ Alternative crypto libraries
PyCryptodome or pyaes can be used instead of pycrypto.
## Updating
Like other plugins, in the Domoticz-Tuya-SmartPlug-Plugin directory:
@@ -68,14 +77,30 @@ sudo /etc/init.d/domoticz.sh restart
| **IP address** | IP of the Smart Plug eg. 192.168.1.231 |
| **DevID** | devID of the Smart Plug |
| **Local Key** | Local Key of the Smart Plug |
| **Debug** | default is False |
| **DPS** | 1 for single socket device and a list of dps separated by ';' for multisocket device eg. 1;2;3;7
| **DPS group** | None for single socket device and a list of list of dps separated by ':' for multisocket device eg. 1;2 : 3;7
| **DPS always ON** | None for single socket device and a list of dps separated by ; for multisocket device eg. 1;2
| **Debug** | default is 0 |
**DPS** should only includes values that correspond to plug's dps id. Be careful some devices also have timers in the dps state.
**DPS group** can be used to group multiple sockets in one Domoticz switch.
**DPS always ON** can be used to force some sockets to be always on (usb for instance).
Helper scripts get_dps.py turnON.py and turnOFF.py can help:
* to determine the dps list
* to check that the needed information are valid (i.e. devID and Local Key) before using the plugin.
## DevID & Local Key Extraction
Recommanded method:
[`https://github.com/codetheweb/tuyapi/blob/master/docs/SETUP.md`](https://github.com/codetheweb/tuyapi/blob/master/docs/SETUP.md)
All the information can be found here:
[`https://github.com/clach04/python-tuya/`](https://github.com/clach04/python-tuya/)
## Acknowledgements
* Special thanks for all the hard work of [clach04](https://github.com/clach04), [codetheweb](https://github.com/codetheweb/) and all the other contributers on [python-tuya](https://github.com/clach04/python-tuya) and [tuyapi](https://github.com/codetheweb/tuyapi) who have made communicating to Tuya devices possible with open source code.
* Special thanks for all the hard work of [clach04](https://github.com/clach04), [codetheweb](https://github.com/codetheweb/) and all the other contributers on [python-tuya](https://github.com/clach04/python-tuya) and [tuyapi](https://github.com/codetheweb/tuyapi) who have made communicating to Tuya devices possible with open source code.
* Domoticz team