tinytuya

What's Changed

• PyPI 1.10.0
• Tuya Protocol v3.5 Support by @uzlonewolf in https://github.com/jasonacox/tinytuya/pull/256 https://github.com/jasonacox/tinytuya/pull/257 & https://github.com/jasonacox/tinytuya/pull/259
• [tinytuya.Cloud] Updated getdevicelog() to handle fetching more when "has_next" is True by @uzlonewolf in https://github.com/jasonacox/tinytuya/pull/236
• [Server] Added delayed-off & help function to server by @cowboy3d in https://github.com/jasonacox/tinytuya/pull/242 & https://github.com/jasonacox/tinytuya/pull/243
• [Server] Added ability to modify device dps using web browser by @cowboy3d in https://github.com/jasonacox/tinytuya/pull/244
• Added nowait parameter to status() and split message parsing into separate function by @uzlonewolf in https://github.com/jasonacox/tinytuya/pull/253
• [Scanner] Complete rewrite of the scanner for speed improvements allowing force-scanning of IP ranges by @uzlonewolf in https://github.com/jasonacox/tinytuya/pull/252 https://github.com/jasonacox/tinytuya/pull/254 https://github.com/jasonacox/tinytuya/pull/261 - Normalized snapshot.json fields and added "version" to devices.json by @uzlonewolf in https://github.com/jasonacox/tinytuya/pull/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.

New Contributors

• @cowboy3d made their first contribution in https://github.com/jasonacox/tinytuya/pull/242

Full Changelog: https://github.com/jasonacox/tinytuya/compare/v1.9.1...v1.10.0

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

Full Changelog: https://github.com/jasonacox/tinytuya/compare/v1.9.0...v1.9.1

What's Changed

• PyPI 1.9.0
• Add support for subdevices connected to gateway by @LesTR in https://github.com/jasonacox/tinytuya/pull/222
• Rework Zigbee Gateway handling to support multiple devices with persistent connections by @uzlonewolf in https://github.com/jasonacox/tinytuya/pull/226
• Add support for newer IR devices, and several IR format converters by @uzlonewolf in https://github.com/jasonacox/tinytuya/pull/228
• Rework Cloud log start/end times, and update documentation by @uzlonewolf in https://github.com/jasonacox/tinytuya/pull/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())

New Contributors

• @LesTR made their first contribution in https://github.com/jasonacox/tinytuya/pull/222

Full Changelog: https://github.com/jasonacox/tinytuya/compare/v1.8.0...v1.9.0

What's Changed

• PyPI 1.8.0
• Add AtorchTemperatureController by @Poil in https://github.com/jasonacox/tinytuya/pull/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 https://github.com/jasonacox/tinytuya/pull/219
• Update README for new Cloud functions, and tighter deviceid error checking by @uzlonewolf in https://github.com/jasonacox/tinytuya/pull/220

import tinytuya
import json

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

New Contributors

• @Poil made their first contribution in https://github.com/jasonacox/tinytuya/pull/213

Full Changelog: https://github.com/jasonacox/tinytuya/compare/v1.7.2...v1.8.0

What's Changed

• Misc updates to find_device(), wizard, and repr(device) by @uzlonewolf in https://github.com/jasonacox/tinytuya/pull/196
• Added socketRetryDelay as parameter instead of fixed value = 5. by @erathaowl in https://github.com/jasonacox/tinytuya/pull/199
• Restore reference to 'self' in init() functions by @uzlonewolf in https://github.com/jasonacox/tinytuya/pull/207

New Contributors

• @erathaowl made their first contribution in https://github.com/jasonacox/tinytuya/pull/199

Full Changelog: https://github.com/jasonacox/tinytuya/compare/v1.7.1...v1.7.2

What's Changed

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

import tinytuya 

# Specify only Device ID and tinytuya will scan for IP 
# and lookup Device Local KEY from devices.json

d = tinytuya.OutletDevice( '0123456789abcdef0123' )

New Contributors

• @TheOnlyWayUp made their first contribution in https://github.com/jasonacox/tinytuya/pull/184
• @fr3dz10 made their first contribution in https://github.com/jasonacox/tinytuya/pull/189

Full Changelog: https://github.com/jasonacox/tinytuya/compare/v1.7.0...v1.7.1

What's Changed

• PyPI 1.7.0
• Add support for v3.4 protocol Tuya devices by @uzlonewolf in https://github.com/jasonacox/tinytuya/pull/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 https://github.com/jasonacox/tinytuya/pull/176
• Update ThermostatDevice by @uzlonewolf in https://github.com/jasonacox/tinytuya/pull/174
• Add Pronto/NEC/Samsung IR code conversion functions to IRRemoteControlDevice by @uzlonewolf in https://github.com/jasonacox/tinytuya/pull/173
• Added DoorbellDevice by @JonesMeUp in https://github.com/jasonacox/tinytuya/issues/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())

Full Changelog: https://github.com/jasonacox/tinytuya/compare/v1.6.6...v1.7.0

What's Changed

• PyPI 1.6.6
• Added support for 3.2 protocol Tuya devices
• Added SocketDevice by @Felix-Pi in https://github.com/jasonacox/tinytuya/pull/167
• Skip DPS detection for 3.2 protocol devices if it has already been set by @pawel-szopinski in https://github.com/jasonacox/tinytuya/pull/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())

New Contributors

• @Felix-Pi made their first contribution in https://github.com/jasonacox/tinytuya/pull/167
• @pawel-szopinski made their first contribution in https://github.com/jasonacox/tinytuya/pull/169

Full Changelog: https://github.com/jasonacox/tinytuya/compare/v1.6.5...v1.6.6

What's Changed

• PyPI 1.6.5
• Reworked payload_dict and realigned the command list to match Tuya's API by @uzlonewolf in https://github.com/jasonacox/tinytuya/pull/166
• Changed socket.send() to socket.sendall() in _send_receive() by @uzlonewolf in https://github.com/jasonacox/tinytuya/pull/166
• Created TuyaSmartPlug-example.py by @fajarmnrozaki in https://github.com/jasonacox/tinytuya/pull/163 and https://github.com/jasonacox/tinytuya/pull/165

New Contributors

• @fajarmnrozaki made their first contribution in https://github.com/jasonacox/tinytuya/pull/163

Full Changelog: https://github.com/jasonacox/tinytuya/compare/v1.6.4...v1.6.5

What's Changed

• 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 https://github.com/jasonacox/tinytuya/pull/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' )

New Contributors

• @ClusterM made their first contribution in https://github.com/jasonacox/tinytuya/pull/160

Full Changelog: https://github.com/jasonacox/tinytuya/compare/v1.6.2...v1.6.4

What's Changed

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

New Contributors

• @Paxy made their first contribution in https://github.com/jasonacox/tinytuya/pull/151

Full Changelog: https://github.com/jasonacox/tinytuya/compare/v1.6.1...v1.6.2

What's Changed

• 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 https://github.com/jasonacox/tinytuya/pull/142
• Fix logging calls in XenonDevice.detect_available_dps by @pkasprzyk in https://github.com/jasonacox/tinytuya/pull/144
• TinyTuya API Server - Add Cloud API syncing with auto-retry by @uzlonewolf in https://github.com/jasonacox/tinytuya/pull/147
• TinyTuya API Server - List registered but offline devices via /offline and web UI.
• ThermostatDevice - First community contributed device module ThermostatDevice by @uzlonewolf in https://github.com/jasonacox/tinytuya/pull/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' )

New Contributors

• @pkasprzyk made their first contribution in https://github.com/jasonacox/tinytuya/pull/144

Full Changelog: https://github.com/jasonacox/tinytuya/compare/v1.6.0...v1.6.1

What's Changed

• 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 https://github.com/jasonacox/tinytuya/pull/140
• Add DPS table to README for a 24v Thermostat by @uzlonewolf in https://github.com/jasonacox/tinytuya/pull/141
• BETA: Started standalone TinyTuya API Server (see here). No change to core library.

New Contributors

• @uzlonewolf made their first contribution in https://github.com/jasonacox/tinytuya/pull/140

Full Changelog: https://github.com/jasonacox/tinytuya/compare/v1.5.0...v1.6.0

What's Changed

• 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)
• Support optional version parameter by @dominikkarall in https://github.com/jasonacox/tinytuya/pull/127
• Update README.md to reflect new DPs for v3.3 Plug by @manj9501 in https://github.com/jasonacox/tinytuya/pull/133
• Some cleanup from pylint by @mafrosis in https://github.com/jasonacox/tinytuya/pull/135
• Add Universal IR Controller DP instructions by @mont5piques in https://github.com/jasonacox/tinytuya/pull/137
• Added robot mower data by @Whytey in https://github.com/jasonacox/tinytuya/pull/138

New Contributors

• @dominikkarall made their first contribution in https://github.com/jasonacox/tinytuya/pull/127
• @manj9501 made their first contribution in https://github.com/jasonacox/tinytuya/pull/133
• @mafrosis made their first contribution in https://github.com/jasonacox/tinytuya/pull/135
• @mont5piques made their first contribution in https://github.com/jasonacox/tinytuya/pull/137
• @Whytey made their first contribution in https://github.com/jasonacox/tinytuya/pull/138

# 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

Full Changelog: https://github.com/jasonacox/tinytuya/compare/v1.4.0...v1.5.0

What's Changed

• 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 galaxy lamp example by @knrdl in https://github.com/jasonacox/tinytuya/pull/115
• 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)
• Added support to get the MAC address and local IP address in the Wizard by @frodeheg in https://github.com/jasonacox/tinytuya/pull/120
• 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

New Contributors

• @knrdl made their first contribution in https://github.com/jasonacox/tinytuya/pull/115
• @frodeheg made their first contribution in https://github.com/jasonacox/tinytuya/pull/120

Full Changelog: https://github.com/jasonacox/tinytuya/compare/v1.3.1...v1.4.0

What's Changed

• PyPi Version 1.3.1
• Added TuyaCloud token expiration detection and renewal logic (Issue #94)
• Update instructions, including screenshot for configuring datacenter by @cy1110 in https://github.com/jasonacox/tinytuya/pull/97
• Displays raw data better. by @mores in https://github.com/jasonacox/tinytuya/pull/98

New Contributors

• @cy1110 made their first contribution in https://github.com/jasonacox/tinytuya/pull/97
• @mores made their first contribution in https://github.com/jasonacox/tinytuya/pull/98

Full Changelog: https://github.com/jasonacox/tinytuya/compare/v1.3.0...v1.3.1

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

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

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

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