Home

Welcome to the python-tuya wiki!

Dumping ground for things related to devices and software:

• https://github.com/codetheweb/tuyapi/issues/5 information on some of the protocol that is not yet implemented as code
• https://wikidevi.com/wiki/Xenon_SM-PW701U device that this project can control (works on 110V and 240V)
• https://bitbucket.org/xoseperez/espurna/overview replacement firmware for ESP8266 based smart devices/switches
  • https://bitbucket.org/xoseperez/espurna/pull-requests/36/add-support-for-xenon-sm-pw702u-wifi-smart/diff support for Xenon_SM-PW701U
• https://fccid.io/2AJ5F-SM-PW701U/Letter/Model-Differences-Description-3200194/ is documentation from Xenon to the FCC declaring "models SM-PW701U, SM-PW702, SM-SW801, SM-SW102, SM-S0301, SM-PZ701, SM-PZ702, SW-SZ801, SM-SZ202, and SM-SZ301 contain identical circuitry". NOTE SM-S0301-US may well have the same circuitry (I've not taken a device apart to confirm) but it does have a slightly different payload/protocol compared with SM-PW701U (due to different switches).

Protocol information

For single switch devices like SM-PW701U, the status json content looks like:

{"devId":"DEVICE_ID","dps":{"1":false,"2":0}}

NOTE all keys are strings.

dps.1 - is the switch status for ON(True)/OFF(False. dps.2 appears to be a timer specified in seconds. This reports the timeout that was set, 0 means stay on forever. This number does NOT go down, so if a time off of 10 secs has been set, querying status 5 secs later still shows 10.

dps.1 and dps.2 can be set. Setting dps.2 will change the state from the current state that many seconds later (i.e. if OFF, it will be turn on and vice-versa).

For multi switch devices like SM-S0301-US (4 separate AC switch controls and 1 for USB), the status json content looks like:

{"devId":"DEVICE_ID","dps":{"1":true,"2":false,"3":false,"4":false,"5":true,"6":0}}