RELEASE NOTES

v1.14.0 - Command Line Updates

PyPI 1.14.0 rewrite of main to use argparse and add additional options by @uzlonewolf in #503
Add support for pipx install tinytuya as raised by @felipecrs in #500 allowing for easier CLI use.
Note possible breaking change: Running tinytuya by itself will now produce a "Usage" page instead of running a scan. Use tinytuya scan or python -m tinytuya scan.
Updated docs to explain timeout as raised by @GamerPeggun in #501

v1.13.2 - Contrib Updates

Add example for XmCosy+ RGBW patio string lights by @bikerglen in #445
Fix case when the number of colors in the colors list is not exactly six by @bikerglen in #446
Adding support for Presence Detector Device by @mrioan in #451
Makes some tweaks to the recently-added Contrib/PresenceDetectorDevice by @mrioan and Deprecates Contrib/__init__.py by @uzlonewolf in #466
Add a note about QR code scanning with Dark Reader to the README #463 by @uzlonewolf in #466
Add option to specify port in XenonDevice class by @unit-404 in #468

v1.13.1 - Cryptography Version

PyPI 1.13.1
Require pyca/cryptography>=3.1 or fallback to PyCryptodome
Add tools/fake-v35-device.py script to tools
Allow pyca/cryptography to GCM decrypt without the tag (makes it match PyCryptodome) by @uzlonewolf in #424

v1.13.0 - Crypto Library Update

PyPI 1.13.0
Updates AESCipher() to make it a bit easier to add additional crypto libraries. It also adds pyca/cryptography as the default. By @uzlonewolf in #423
Fixes issue with tinytuya.find_device() for v3.1 devices and the infinite loop in Contrib/IRRemoteControlDevice.py (Closes #403).
Officially removes Python 2.7 support.

v1.12.11 - Bug Fix for _get_socket()

PyPI 1.12.11
Fix local variable collision in _get_socket() exception handling for device offline conditions.

v1.12.10 - Various Updates

PyPI 1.12.10
Various updates inspired by recent issues by @uzlonewolf in #397 - Updates to scanner, added error code and helpful troubleshooting messages, make connection/key errors more descriptive, added socketRetryLimit (connection_retry_limit) and socketRetryDelay (connection_retry_limit) to Device constructor args.
[MQTT Gateway for Server] Fixed endless loop causing 100% cpu usage by @michaelmittermair in #390

v1.12.9 - Import Issue with urllib3

PyPI 1.12.9
Add graceful handling of issue where urllib3 v2.0 causes ImportError: urllib3 v2.0 only supports OpenSSL 1.1.1+ error. See #377 & #379.
Fix bug in Cloud getdevices() that can error with older devices.json versions as raised in #381 & #382
[Server] Mapping for DP IDs by @mschlenstedt in #353 and #363
[MQTT Gateway for Server] by @mschlenstedt in #364, #367 and #366
Add Contrib support for Inverter Heat Pump such as Fairland IPHR55 by @valentindusollier in #368

v1.12.8 - Device DP Mapping

PyPI 1.12.8
[Server] - Use {DeviceName} instead of {DeviceID} alternatively for API commands by @mschlenstedt in #352
Wizard - New Cloud functions to download DP Name mappings by @uzlonewolf in #356

Example device from UPDATED devices.json showing new "mapping" data:

    {
        "name": "Smart Plug",
        "id": "01234567890abcdef012",
        "key": "abcdef0123456789",
        "mac": "aa:bb:cc:dd:33:11",
        "uuid": "01234567890abcdef012",
        "category": "cz",
        "product_name": "WP1-Smart Socket",
        "product_id": "iXfg9AQVUPhlfyGw",
        "biz_type": 18,
        "model": "WP1/10A/\u5e26\u8ba1\u91cf/gosund",
        "sub": false,
        "icon": "https://images.tuyaus.com/smart/icon/1472009231_0.png",
        "mapping": {
            "1": {
                "code": "switch",
                "type": "Boolean",
                "values": {}
            },
            "4": {
                "code": "cur_current",
                "type": "Integer",
                "values": {
                    "unit": "mA",
                    "min": 0,
                    "max": 30000,
                    "scale": 0,
                    "step": 1
                }
            },
            "5": {
                "code": "cur_power",
                "type": "Integer",
                "values": {
                    "unit": "W",
                    "min": 0,
                    "max": 50000,
                    "scale": 1,
                    "step": 1
                }
            },
            "6": {
                "code": "cur_voltage",
                "type": "Integer",
                "values": {
                    "unit": "V",
                    "min": 0,
                    "max": 5000,
                    "scale": 1,
                    "step": 1
                }
            },
            "2": {
                "code": "countdown_1",
                "type": "Integer",
                "values": {
                    "unit": "s",
                    "min": 0,
                    "max": 86400,
                    "scale": 0,
                    "step": 1
                }
            }
        },
        "ip": "10.20.30.40",
        "version": "3.1"
    }

v1.12.7 - Status Bug Fix

PyPI 1.12.7
Fix bug in detect_available_dps() to resolve issue where status() call for smartbulbs would randomly cause devices to turn off by @xgustavoh in #345

v1.12.6 - Minor Fixes

PyPI 1.12.6
Cloud - Bug Fix KeyError: 'has_more' by @Liborsaf in #342
Add Contrib support for IR+RF devices such as the S11 by @uzlonewolf in #343

v1.12.5 - Scanner Update

PyPI 1.12.5
Remove requirement for PyCryptodome in scanner (allows pyaes for devices < 3.5) by @uzlonewolf in #332
Added AES library details to debug output.
README update - Add link to Moonraker support project by @teejo75 in #335
Misc minor updates by @uzlonewolf in #336: Normalize ability/ablilty in scanner #333 - Fix examples/getstatus.py - Cloud device list and Content-Type update #324 - Rework examples/async_send_receive.py

v1.12.4 - Wizard Scan for ID

PyPI 1.12.4
Adds option allowing wizard to scan for a Device ID by @uzlonewolf in #331 - Related to Tuya IoT permission denied issue #330 and #323

v1.12.3 - Fix Cloud Device List

PyPI 1.12.3
Fix fan_run_time typo in Contrib/ThermostatDevice by @elockman in #326
Cloud device list and Content-Type update by @uzlonewolf in #324 Bug Fix for #323

v1.12.2 - Gateway/Sub-device Update

PyPI 1.12.2
Gateway/sub-device updates, payload_dict reworked, and subdev_query() added by @uzlonewolf in #308
Add tools/pcap_parse.py by @uzlonewolf in #311
[Server] Formatted data into tables and added version information.

v1.12.1 - Cloud & Wizard Updates

PyPI 1.12.1
[tinytuya.Cloud] Added cloud sendcommand() parameter for URI by @Syrooo in #303
Wizard and tinytuya.Cloud - Fetch the device list a 2nd time to make sure we have the local key by @uzlonewolf in #306 - Updated internal _get_all_devices() and _update_device_list()

v1.12.0 - Zigbee Gateway Updates

PyPI 1.12.0
Improve detect_available_dps() function by @nyok92 in #294
Tighten up parent device detection in the Wizard by @uzlonewolf in #296
Updates for Zigbee Gateway sub-device usage by @uzlonewolf in #298

v1.11.0 - Cloud Device Listing

PyPI 1.11.0
Simplification and cleanup of math functions in core and IRRemoteControlDevice by @gstein in #291
Rework Cloud device list fetching by @uzlonewolf in #289 includes new tuya-raw.json (backward compatible).

Additional data in tuya-raw.json:

    "file": {
        "name": "tuya-raw.json",
        "description": "Full raw list of Tuya devices.",
        "account": "xxxxxxxxxxxxxxxxxxxx",
        "date": "2023-03-04T19:50:08.879865",
        "tinytuya": "1.11.0"
    }

v1.10.3 - Cloud Updates

PyPI 1.10.3
Fix params leak in getdevicelog() as discovered by @klightspeed and @uzlonewolf in #219
Log message formatting by @johnno1962 in #285
Add Cloud IR example, updated docs, and allow an optional initial token to Cloud by @uzlonewolf in #288

v1.10.2 - Bug Fix for ThermostatDevice and Misc. Cleanup

PyPI 1.10.2
Fix Contrib.ThermostatDevice.SetSetpoint() by @uzlonewolf in #273
Added command line -debug flag and code cleanup based on pylint by @jasonacox in #276

v1.10.1 - Bug Fix for BulbDevice and Zigbee Devices

PyPI 1.10.1
Fix _process_message() missing parameters discovered via issue #266 by @jasonacox in #267
Removed bulb attribute conditional blocking in BulbDevice set_colour(), set_hsv() and set_colourtemp() as some devices do not correctly report capabilities. Conditional provides debug warning message instead by @jasonacox in #265

v1.10.0 - Tuya Protocol v3.5 Device Support / Scanner Rewrite

PyPI 1.10.0
Tuya Protocol v3.5 Support by @uzlonewolf in #256 #257 & #259
[tinytuya.Cloud] Updated getdevicelog() to handle fetching more when "has_next" is True by @uzlonewolf in #236
[Server] Added delayed-off & help function to server by @cowboy3d in #242 & #243
[Server] Added ability to modify device dps using web browser by @cowboy3d in #244
Added nowait parameter to status() and split message parsing into separate function by @uzlonewolf in #253
[Scanner] Complete rewrite of the scanner for speed improvements and allowing force-scanning of IP ranges by @uzlonewolf in #252 #254 #261 & #262

TinyTuya [1.10.0]

Usage:

    python -m tinytuya <command> [<max_time>] [-nocolor] [-force [192.168.0.0/24 192.168.1.0/24 ...]] [-h]

      wizard         Launch Setup Wizard to get Tuya Local KEYs.
      scan           Scan local network for Tuya devices.
      devices        Scan all devices listed in devices.json file.
      snapshot       Scan devices listed in snapshot.json file.
      json           Scan devices listed in snapshot.json file [JSON].
      <max_time>     Maximum time to find Tuya devices [Default=18]
      -nocolor       Disable color text output.
      -force         Force network scan for device IP addresses.  Auto-detects network range if none provided.
      -no-broadcasts Ignore broadcast packets when force scanning.
      -h             Show usage.

v1.9.1 - Minor Bug Fix for Cloud

PyPI 1.9.1
Fix logging for Cloud _gettoken() to prevent extraneous output. #229

v1.9.0 - Zigbee Gateway Support

PyPI 1.9.0
Add support for subdevices connected to gateway by @LesTR in #222
Rework Zigbee Gateway handling to support multiple devices with persistent connections by @uzlonewolf in #226
Add support for newer IR devices, and several IR format converters by @uzlonewolf in #228
Rework Cloud log start/end times, and update documentation by @uzlonewolf in #229

import tinytuya

# Zigbee Gateway support uses a parent/child model where a parent gateway device is
#  connected and then one or more children are added.

# Configure the parent device
gw = tinytuya.Device( 'eb...4', address=None, local_key='aabbccddeeffgghh', persist=True, version=3.3 )

print( 'GW IP found:', gw.address )

# Configure one or more children.  Every dev_id must be unique!
zigbee1 = tinytuya.OutletDevice( 'eb14...w', cid='0011223344556601', parent=gw )
zigbee2 = tinytuya.OutletDevice( 'eb04...l', cid='0011223344556689', parent=gw )

print(zigbee1.status())
print(zigbee2.status())

v1.8.0 - Expanded Cloud Functions

PyPI 1.8.0
Add AtorchTemperatureController by @Poil in #213
Add new Cloud functions to fetch device logs from TuyaCloud (getdevicelog(id)), make generic cloud request with custom URL and params (cloudrequest(url, ...)) and fetch connection status (getconnectstatus(id)) by @uzlonewolf in #219
Update README for new Cloud functions, and tighter deviceid error checking by @uzlonewolf in #220

import tinytuya
import json

c = tinytuya.Cloud()
r = c.getdevicelog( '00112233445566778899' )
print( json.dumps(r, indent=2) )

v1.7.2 - Fix Contrib Devices Bug

PyPI 1.7.2
Restore reference to 'self' in init() functions by @uzlonewolf in #207
Misc updates to find_device(), wizard, and repr(device) by @uzlonewolf in #196
Added socketRetryDelay as parameter instead of fixed value = 5. by @erathaowl in #199

v1.7.1 - Auto-IP Detection Enhancement

PyPI 1.7.1
Add Climate device module and simple example for portable air conditioners by @fr3dz10 in #189 and #192
Constructor and documentation updates by @uzlonewolf in #188
Get local key from devices.json if not provided by @uzlonewolf in #187
Rework device finding for auto-IP detection, and unpack_message() retcode fix by @uzlonewolf in #186
Standardize indentation for code snippets in the README by @TheOnlyWayUp in #184

d = tinytuya.OutletDevice( '0123456789abcdef0123' )

v1.7.0 - Tuya Protocol v3.4 Device Support

PyPI 1.7.0
Add support for v3.4 protocol Tuya devices by @uzlonewolf in #179
API change with _send_receive() - now takes care of the packing and encrypting so it can re-encode whenever the socket is closed and reopened, and _get_socket() now takes care of negotiating the session key (v3.4)
Optimize detect_available_dps() by @pawel-szopinski in #176
Update ThermostatDevice by @uzlonewolf in #174
Add Pronto/NEC/Samsung IR code conversion functions to IRRemoteControlDevice by @uzlonewolf in #173
Added DoorbellDevice by @JonesMeUp in #162
Added ability to set version on constructor for more intuitive use:

d = tinytuya.OutletDevice(
    dev_id='xxxxxxxxxxxxxxxxxxxxxxxx',
    address='x.x.x.x',
    local_key='xxxxxxxxxxxxxxxx',
    version=3.4)

print(d.status())

v1.6.6 - Updated Payload Dictionary and Command List

PyPI 1.6.6
Added support for v3.2 protocol Tuya devices
Added SocketDevice by @Felix-Pi in #167
Skip DPS detection for 3.2 protocol devices if it has already been set by @pawel-szopinski in #169

# Example usage of community contributed device modules
from tinytuya.Contrib import SocketDevice

socket = SocketDevice('abcdefghijklmnop123456', '172.28.321.475', '1234567890123abc', version=3.3)

print(socket.get_energy_consumption())
print(socket.get_state())

v1.6.5 - Updated Payload Dictionary and Command List

PyPI 1.6.5
Reworked payload_dict and realigned the command list to match Tuya's API by @uzlonewolf in #166
Changed socket.send() to socket.sendall() in _send_receive() by @uzlonewolf in #166
Created TuyaSmartPlug-example.py by @fajarmnrozaki in #163 and #165

v1.6.4 - IRRemoteControlDevice and Read Improvements

PyPI 1.6.4
Separates read retries from send retries by @uzlonewolf #158
IRRemoteControlDevice - New community contributed device module for IR Remote Control devices by @ClusterM in #160 - See example: examples/IRRemoteControlDevice-example.py

# Example usage of community contributed device modules
from tinytuya import Contrib

ir = Contrib.IRRemoteControlDevice( 'abcdefghijklmnop123456', '172.28.321.475', '1234567890123abc' )

v1.6.2 - Cloud, TuyaMessage & ThermostatDevice Improvements

PyPI 1.6.2
Add getconnectstatus() function to Cloud class by @Paxy in #151
Improve TuyaMessage Header processing for mulit-payload messages by @uzlonewolf in #153
More verbose debug logging on decode error by @uzlonewolf in #155
Add schedule editing to Contrib/ThermostatDevice and various fixes by @uzlonewolf in #157

v1.6.1 - ThermostatDevice - User Contributed Device Module

PyPI 1.6.1
Cloud - Fix bug in getdevices() to import device mac addresses (same as wizard).
Break the Outlet/Cover/Bulb/Cloud modules out into separate files by @uzlonewolf in #142
Fix logging calls in XenonDevice.detect_available_dps by @pkasprzyk in #144
TinyTuya API Server - Add Cloud API syncing with auto-retry by @uzlonewolf in #147
TinyTuya API Server - List registered but offline devices via /offline and web UI.
ThermostatDevice - First community contributed device module ThermostatDevice by @uzlonewolf in #146 - See example: examples/ThermostatDevice-example.py

# Example usage of community contributed device modules
from tinytuya import Contrib

thermo = Contrib.ThermostatDevice( 'abcdefghijklmnop123456', '172.28.321.475', '1234567890123abc' )

v1.6.0 - Colorama for Terminal Color

PyPI 1.6.0
Add colorama terminal color capability for all platforms including MS Windows and stdout redirects
Fix to allow setting socket options to existing open sockets by @uzlonewolf in #140
BETA: Started standalone TinyTuya API Server (see here). No change to core library.

v1.5.0 - Add 'nowait' Option to Commands

PyPI 1.5.0
Added an optional 'nowait' boolean setting (True/False) to functions to allow sending commands without waiting for a device response. (Issue #74)
Clean up code to address pylint warnings. (PR #135)

# Example use of nowait option
d.turn_on(nowait=True)
d.set_colour(r, g, b, nowait=True)
d.set_value(201, '9AEmAvQBJgL0ASYCQAYmAkAGJgJABiY', nowait=True)  # send IR command
d.set_value(25, '010e0d0000000000000003e803e8', nowait=True)      # set scene

v1.4.0 - Updated Scanner Functions

PyPI 1.4.0 - Minor Update to APIs (additional arguments and elements)
Debug - Updated debug output for payloads to formatted hexadecimal (pull request #98)
Scan - Terminal color fix for 3.1 devices.
Error Handling added for set_timer() function (Issue #87)
Add wizard capability to pull mac addresses from TuyaPlatform in devices.json (Issue #117)
Add wizard -force option to perform network scan for device IP addresses (Issue #117)
Separated scan functions into scanner.py file.
NEW: Added command line functions for scanning:
- devices - Display and poll all registered devices for status (using devices.json). This will force a network scan for IP address changes and will create snapshot.json.
- snapshot - Display and poll all devices as listed snapshot.json. This assume IP address are the same as the last snapshot.
- json - Same as snapshot but respond with a JSON payload.

# Run wizard using brute force scan for IP addresses
python -m tinytuya wizard -force

# New Interactive Command Line Options
python -m tinytuya devices
python -m tinytuya snapshot

# Non-Interactive poll with JSON response
python -m tinytuya json

v1.3.1 - TuyaCloud API Support

PyPi Version 1.3.1
Added TuyaCloud token expiration detection and renewal logic (Issue #94)

v1.3.0 - TuyaCloud API Support

PyPi Version 1.3.0
Code format cleanup and readability improvements (pull request #91)
Upgrade - Add TuyaCloud API support and functions (#87 #95)

import tinytuya

c = tinytuya.Cloud(
        apiRegion="us", 
        apiKey="xxxxxxxxxxxxxxxxxxxx", 
        apiSecret="xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx", 
        apiDeviceID="xxxxxxxxxxxxxxxxxxID")

# Display list of devices
devices = c.getdevices()
print("Device List: %r" % devices)

# Select a Device ID to Test
id = "xxxxxxxxxxxxxxxxxxID"

# Display DPS IDs of Device
result = c.getdps(id)
print("DPS IDs of device:\n", result)

# Display Status of Device
result = c.getstatus(id)
print("Status of device:\n", result)

# Send Command - This example assumes a basic switch
commands = {
	'commands': [{
		'code': 'switch_1',
		'value': True
	}, {
		'code': 'countdown_1',
		'value': 0
	}]
}
print("Sending command...")
result = c.sendcommand(id,commands)
print("Results\n:", result)

v1.2.11 - Updated Scan and Wizard Retry Logic

PyPi Version 1.2.11
Added retries logic to wizard and scan to honor value set by command line or default to a value based on the number of devices (if known):

# Explicit value set via command line
python3 -m tinytuya wizard 50   # Set retry to 50 
python3 -m tinytuya scan 50     

# Use automatic computed value
python3 -m tinytuya wizard      # Compute a default
python3 -m tinytuya scan        

# Example output
TinyTuya (Tuya device scanner) [1.2.11]

[Loaded devices.json - 32 devices]

Scanning on UDP ports 6666 and 6667 for devices (47 retries)...

v1.2.10 - Wizard Update for New Tuya Regions

PyPi Version 1.2.10
Added ability to disable device auto-detect (default vs device22) via d.disabledetect=True.
Wizard: Added new data center regions for Tuya Cloud: (Issues #66 #75)

Code	Region	Endpoint
cn	China Data Center	https://openapi.tuyacn.com
us	Western America Data Center	https://openapi.tuyaus.com
us-e	Eastern America Data Center	https://openapi-ueaz.tuyaus.com
eu	Central Europe Data Center	https://openapi.tuyaeu.com
eu-w	Western Europe Data Center	https://openapi-weaz.tuyaeu.com
in	India Data Center	https://openapi.tuyain.com

v1.2.9 - Edge Case Device Support

PyPi Version 1.2.9
Added Error Handling in class Device(XenonDevice) for conditions where response is None (Issue #68)
Added edge-case handler in _decode_payload() to decode non-string type decrypted payload (Issue #67)

v1.2.8 - BulbDevice

PyPi Version 1.2.8
Added additional error checking for BulbDevice type selection
Added TinyTuya version logging for debug mode
Fix bug in scan when color=False (Issue #63)

v1.2.7 - New Tuya Cloud IoT Setup Wizard

PyPi Version 1.2.7
Updated setup wizard to support new Tuya Cloud signing method (Issue #57)
Added Bulb type C and manual setting function set_bulb_type(type) (PR #54)
Wizard creates tuya-raw.json to record raw response from Tuya IoT Platform
Fixed device22 bug on retry - Now returns ERR_DEVTYPE error, status() includes auto-retry (#56)

v1.2.6 - Improved Error Handling

PyPi Version 1.2.6
Added wizard handling to capture and display Tuya API server error responses (PR #45)
Added better error handling for BulbDevice state() function to not crash when dps values are missing in response (PR #46)
Added async examples using send() and receive()
Updated scan output to include device Local Key if known (PR #49 #50)
Fixed print typo in examples/devices.py (PR #51)

v1.2.5 - Send and Receive Functions

PyPi Version 1.2.5
Added raw mode send() and receive() function to allow direct control of payload transfers. Useful to monitor constant state changes via threads or continuous loops. This example opens a Tuya device and watches for state changes (e.g. switch going on and off):

import tinytuya

d = tinytuya.OutletDevice('DEVICEID', 'DEVICEIP', 'DEVICEKEY')
d.set_version(3.3)
d.set_socketPersistent(True)

print(" > Send Initial Query for Status < ")
payload = d.generate_payload(tinytuya.DP_QUERY)
d.send(payload)

while(True):
    # See if any data is available
    data = d.receive()
    print('Received Payload: %r' % data)

    # Send a keyalive heartbeat ping
    print(" > Send Heartbeat Ping < ")
    payload = d.generate_payload(tinytuya.HEART_BEAT)
    d.send(payload)

v1.2.4 - DPS Detection and Bug Fixes

PyPi Version 1.2.4
Added detect_available_dps() function
Fixed bug in json_error() function
Updated instruction for using Tuya iot.tuya.com to run Wizard
Added option to disable deviceScan() automatic device polling
Added better error handling processing Tuya messages (responses) Issue #39
Fixed display bug in Wizard device polling to show correct On/Off state

v1.2.3 - Dimmer and Brightness Functions

PyPi Version 1.2.3
Added set_dimmer() to OutletDevice class.
Added set_hsv() to BulbDevice class.
Updated set_brightness() in BulbDevice to handle white and colour modes. Issue #30
BulbDevice determines features of device and presents boolean variables has_colour, has_brightness and has_colourtemp to ignore requests that do not exist (returns error).

v1.2.2 - Bug Fix for Bulb Functions

PyPi Version 1.2.2
Fix bug in set_white_percentage(): added missing self. PR #32
Fixed set_white_percentage: colour temp was incorrectly computed for B type Bulbs. PR #33
Moved setup Wizard out of module init to standalone import to save import load.

Command line mode is still the same:

python3 -m tinytuya wizard

Import now requires additional import to run Wizard programmatically:

import tinytuya
import tinytuya.wizard

tinytuya.wizard.wizard()

v1.2.1 - Bug Fix for Command 0x12 UpdateDPS

PyPi Version 1.2.1
Fixed header for 0x12 Update DPS Command (see issue #8)

v1.2.0 - Error Handling and Bug Fixes

PyPi Version 1.2.0
Now decrypting all TuyaMessage responses (not just status)
Fixed set_colour(r, g, b) to work with python2
Fixed set_debug() to toggle on debug logging (with color)
Added handler for device22 to automatically detect and set_dpsUsed() with available DPS values.
Added set_socketTimeout(s) for adjustable connection timeout setting (defaults to 5s)
Added set_sendWait(s) for adjustable wait time after sending device commands
Improved and added additional error handling and retry logic
Instead of Exceptions, tinytuya responds with Error response codes (potential breaking change):

Example

import tinytuya

tinytuya.set_debug(toggle=False, color=True)

d = tinytuya.OutletDevice('<ID>','<IP>','<KEY>')
d.set_version(3.3)
d.status()

{u'Payload': None, u'Err': u'905', u'Error': u'Network Error: Device Unreachable'}

v1.1.4 - Update DPS (Command 18)

PyPi Version 1.1.4
Added updatedps() command 18 function to request device to update DPS values (Issue #8)
Added set_debug() function to activate debug logging

import tinytuya
import time

tinytuya.set_debug(True)

d = tinytuya.OutletDevice('DEVICEID', 'IP', 'LOCALKEY')
d.set_version(3.3)

print(" > Fetch Status < ")
data = d.status()
time.sleep(5)

print(" > Request Update for DPS indexes 18, 19 and 20 < ")
result = d.updatedps([18, 19, 20])

print(" > Fetch Status Again < ")
data2 = d.status()

print("Before %r" % data)
print("After  %r" % data2)

v1.1.3 - Automatic IP Lookup

PyPi Version 1.1.3
Updated device read retry logic for minimum response payload (28 characters) (Issue #17)
Feature added to do automatic IP address lookup via network scan if None or '0.0.0.0' is specified. Example:

    import tinytuya
    ID = "01234567890123456789"
    IP = None
    KEY = "0123456789012345"
    d = tinytuya.OutletDevice(ID,IP,KEY)
    d.status()

v1.1.2 - Bug Fix or 3.1 Devices

PyPi Version 1.1.2
Bug Fix for 3.1 Devices using CONTROL command - updated to hexdigest[8:][:16]
See Issue: #11

v1.1.1 - BulbDevice Class Update

PyPi Version 1.1.1
Updated BulbDevice Class to support two types of bulbs with different DPS mappings and functions: - Type A - Uses DPS index 1-5 and represents color with RGB+HSV - Type B - Uses DPS index 20-27 (no index 1)
Updated Colour Support - Index (DPS_INDEX_COLOUR) is assumed to be in the format: - (Type A) Index: 5 in hex format: rrggbb0hhhssvv - (Type B) Index: 24 in hex format: hhhhssssvvvv
New Functions to help abstract Bulb Type: - set_white_percentage(brightness=100, colourtemp=0): - set_brightness_percentage(brightness=100): - set_colourtemp_percentage(colourtemp=100): - set_mode(mode='white'): # white, colour, scene, music
Example Script https://github.com/jasonacox/tinytuya/blob/master/examples/bulb.py

v1.1.0 - Setup Wizard

PyPi Version 1.1.0
Added TinyTuya Setup Wizard to help users grab device LOCAL_KEY from the Tuya Platform.
Added formatted terminal color output (optionally disabled with -nocolor) for interactive Wizard and Scan functions.

python3 -m tinytuya wizard

s

v1.0.5 - Persistent Socket Connections

PyPi Version 1.0.5
Updated cipher json payload to mirror TuyAPI - hexdigest from [8:][:16] to [8:][:24]
Added optional persistent socket connection, NODELAY and configurable retry limit (@elfman03) #5 #6 #7

    set_socketPersistent(False/True)   # False [default] or True
    set_socketNODELAY(False/True)      # False or True [default]	    
    set_socketRetryLimit(integer)      # retry count limit [default 5]

Add some "scenes" supported by color bulbs (@elfman03)

    set_scene(scene):             # 1=nature, 3=rave, 4=rainbow

v1.0.4 - Network Scanner

PyPi Version 1.0.4
Added scan() function to get a list of Tuya devices on your network along with their device IP, ID and VERSION number (3.1 or 3.3):

python3 -m tinytuya

v1.0.3 - Device22 Fix

PyPi Version 1.0.3
Removed automatic device22 type selection. The assumption that 22 character ID meant it needed dev_type device22 was discovered to be incorrect and there are Tuya devices with 22 character ID's that behave similar to default devices. Device22 type is now available via a dev_type specification on initialization:

    OutletDevice(dev_id, address, local_key=None, dev_type='default')
    CoverDevice(dev_id, address, local_key=None, dev_type='default')
    BulbDevice(dev_id, address, local_key=None, dev_type='default')

Added Tuya Command Types framework to definitions and payload dictionary per device type.
Bug fixes (1.0.2):
- Update SET to CONTROL command
- Fixed BulbDevice() __init__

v1.0.0 - Initial Release

PyPi Version 1.0.0

Files

RELEASE.md

Latest commit

History