Python 2.7 and Python 3.6.1 interface to ESP8266MOD WiFi smart devices from Shenzhen Xenon. If you are using the Jinvoo Smart app, this allows local control over the LAN. NOTE requires the devices to have already been activated by Jinvoo Smart app (or similar).
Known to work with:
- SKYROKU SM-PW701U Wi-Fi Plug Smart Plug - see https://wikidevi.com/wiki/Xenon_SM-PW701U
- Wuudi SM-S0301-US - WIFI Smart Power Socket Multi Plug with 4 AC Outlets and 4 USB Charging
- Jinvoo WiFi Curtain / Roller Shutter Switch
-
background knowledge
- The
local-keyis used for AES-based encryption of the messages sent between device and client. - Key changes every time the device is reset and paired to a new account (e.g. using app)
- Key and further meta-data is regularly requested by the app from the cloud-server via HTTPS requests
- The request responses can be recorded by apps to extract the key and further data (such as name, ip, state, etc.)
- The
-
how to extract key
- Android
- Install your app used for setup and paring (tested with TuyaSmart)
- Install SSL Capture
- Change app settings to only record your pairing app and start recording
- Go inside app and do something with one of your devices
- Go back inside the SSL Capture app, stop the recording
- Find the package with the longest response by the server
- Copy all information from the response body to your computer (e.g. via email)
- Use pytuya to extract key from the response stored inside a file:
pytuya utils extract_keys response.txt
- IOS
-
TODO
-
- Android
-
further resources:
- https://github.com/clach04/python-tuya/wiki has further information for how to get device id and local key. (the device id can be seen in Jinvoo Smart app, under "Device Info").
The command line tool pytuya can be used to send actions to devices. Simply executing pytuya after
installing displays the following options:
>pytuya
Usage: pytuya [OPTIONS] COMMAND [ARGS]...
Options:
-l, --debug / --no-debug
-c, --config_path PATH
--help Show this message and exit.
Commands:
bulb
cover
outlet
update_config
utils
In order to use this client interface, it is first necessary to update the configuration, which should a name, ip, id and local key used for encryption for each device. Given a recorded API response extracted from the app using SSL Capture (see above), the configuration can be automatically built as following:
> pytuya update_config example_response.txt
INFO:root:Querying devices
WARNING:root:wrote config at C:\Users\username\pytuya.yaml with content:
Bedroom Blinds:
id: 51870625b4e62e4b2fc4
ip: 192.168.1.116
key: afab3d41b839c54c
Bedroom Lights:
id: 5517064584f3ec2e4095
ip: 192.168.1.210
key: bfa4804827714672
Once this config file exists, actions can be sent to the corresponding devices by referencing them via name:
> pytuya cover close "bedroom blinds"
INFO:root:sending close to device bedroom blinds at 192.168.1.116
In order to get help, simply use the --help flag, e.g.:
> pytuya bulb --help
Usage: pytuya bulb [OPTIONS] COMMAND [ARGS]...
Options:
--help Show this message and exit.
Commands:
brightness set brightness of device
colour set colour of device using provided R, G, B...
off sends turn off action to device
on sends turn on action to device
state sends turn off action to device
> pytuya bulb colour --help
Usage: pytuya bulb colour [OPTIONS] NAME [R] [G] [B]
set colour of device using provided R, G, B (red green and blue)
Options:
--help Show this message and exit.
HomeAssistant does already support tuya devices via the official cloud API. However, the direct communication of the pytuya package may be preferable to relying on cloud services (pytuya works regardless of internet connectivity). To use pytuya in HomeAssistant, simply use the commandline device components. Here's an example configuration for a cover device with the name "bedroom blinds":
cover:
- platform: command_line
covers:
bedroom:
command_open: pytuya cover open "bedroom blinds"
command_close: pytuya cover close "bedroom blinds"
command_stop: pytuya cover stop "bedroom blinds"Note that pytuya needs to be set up first before these commands can work (see pytuya update_config)
import pytuya
d = pytuya.OutletDevice('DEVICE_ID_HERE', 'IP_ADDRESS_HERE', 'LOCAL_KEY_HERE')
data = d.status() # NOTE this does NOT require a valid key
print('Dictionary %r' % data)
print('state (bool, true is ON) %r' % data['dps']['1']) # Show status of first controlled switch on device
# Toggle switch state
switch_state = data['dps']['1']
data = d.set_status(not switch_state) # This requires a valid key
if data:
print('set_status() result %r' % data)
# on a switch that has 4 controllable ports, turn the fourth OFF (1 is the first)
data = d.set_status(False, 4)
if data:
print('set_status() result %r' % data)
print('set_status() extrat %r' % data[20:-8])
TODO demo timer (with comment not all devices support this, one way to check, is to check Jinvoo Smart App and see if there is a clock icon that is not dimmed out).
These devices uses AES encryption, this is not available in Python standard library, there are three options:
- PyCrypto
- PyCryptodome
- pyaes (note Python 2.x support requires ricmoo/pyaes#13)
- https://github.com/sean6541/tuyaapi Python API to the web api
- https://github.com/codetheweb/tuyapi node.js
- https://github.com/Marcus-L/m4rcus.TuyaCore - .NET
- https://github.com/SDNick484/rectec_status/ - RecTec pellet smokers control (with Alexa skill)
- Major breakthroughs on protocol work came from https://github.com/codetheweb/tuyapi from the reverse engineering time and skills of codetheweb and blackrozes, additional protocol reverse engineering from jepsonrob and clach04.
- nijave pycryptodome support and testing
- Exilit for unittests and docstrings
- mike-gracia for improved Python version support
- samuscherer for RGB Bulb support
- magneticflux- for improved Python version support
- sean6541 - for initial PyPi package and Home Assistant support https://github.com/sean6541/tuya-homeassistant