tinytuya

• 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)

• PyPi Version 1.2.7
• Updated setup wizard to support new Tuya IoT Cloud signature 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)

• 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)

• PyPi Version 1.2.5
• Added raw mode send() and receive() function to allow direct control of payload transfers. Useful to monitor 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)

• 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

• 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).

• 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()

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

• 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'}

• 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)

• 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()

• PyPi Version 1.1.2
• Bug Fix for 3.1 Devices using CONTROL command - updated tohexdigest[8:][:16]
• See Issue: https://github.com/jasonacox/tinytuya/issues/11

• 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

• 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

• 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

• 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

• 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__

Initial Release v1.0.0