import tinytuya
devices = tinytuya.deviceScan()
for ip, info in devices.items():
    print(ip, info.get('gwId'), info.get('version'))

tinytuya.scan()

result = tinytuya.find_device(dev_id='01234567891234567890')
print(result)
# {'ip': '10.0.1.50', 'version': '3.3', 'id': '01234567891234567890', 'product_id': '...', 'data': {...}}

info = tinytuya.device_info('01234567891234567890')
print(info)  # {'name': 'My Plug', 'id': '...', 'key': '...'}

tinytuya.assign_dp_mappings(devices, mappings)

plaintext = tinytuya.decrypt_udp(raw_bytes)

tinytuya.set_debug(True)

XenonDevice(
    dev_id,                   # str  – Device ID
    address=None,             # str  – IP address, or "Auto" to discover
    local_key="",             # str  – Encryption key
    dev_type="default",       # str  – "default" or "device22"
    connection_timeout=5,     # int  – TCP connect timeout (seconds)
    version=3.1,              # float – Tuya protocol version
    persist=False,            # bool – Keep TCP connection open
    cid=None,                 # str  – Sub-device (Zigbee) ID
    node_id=None,             # str  – Alias for cid
    parent=None,              # object – Gateway device for sub-devices
    connection_retry_limit=5, # int
    connection_retry_delay=5, # int
    port=6668,                # int
)

d.set_version(3.3)

d.set_socketPersistent(True)  # good for tight loops

d.set_socketNODELAY(True)

d.set_socketRetryLimit(3)

d.set_socketRetryDelay(2)

d.set_socketTimeout(10)

d.set_sendWait(0.1)

d.set_retry(False)

data = d.status()
print(data)
# {'dps': {'1': True, '2': 0, ...}}

# Non-blocking, fire-and-forget (use receive() later)
d.status(nowait=True)

d.set_socketPersistent(True)
data = d.status()              # primes the cache
later = d.cached_status()      # returns cached result

data = d.receive()

payload = d.generate_payload(tinytuya.CONTROL, {'1': True})
d.send(payload)

d.set_dpsUsed({'1': None, '2': None})

d.add_dps_to_request(18)
d.add_dps_to_request([18, 19, 20])

dps = d.detect_available_dps()
print(dps)  # {'1': None, '2': None, ...}

payload = d.generate_payload(tinytuya.CONTROL, {'1': True})
d.send(payload)

d.heartbeat()

d.updatedps([18, 19, 20])

d.subdev_query()

import tinytuya

d = tinytuya.Device('DEVICE_ID', '192.168.1.50', 'LOCAL_KEY', version=3.3)

d.set_status(True)        # turn on switch 1
d.set_status(False, 4)    # turn off switch 4

d.turn_on()
d.turn_on(switch=2)

d.turn_off()

d.set_value(25, 'scene_data_hex_string')
d.set_value(2, 500)

d.set_multiple_values({'20': True, '21': 'colour', '22': 800})

d.set_timer(3600)          # 1-hour timer on auto-detected DPS
d.set_timer(600, dps_id=9) # 10-minute timer on DPS 9

d.heartbeat()

info = d.product()

import tinytuya

d = tinytuya.OutletDevice(
    dev_id='DEVICE_ID',
    address='192.168.1.50',
    local_key='LOCAL_KEY',
    version=3.3
)
d.turn_on()
d.turn_off()
data = d.status()
print(data['dps']['1'])   # True = on, False = off

d.set_dimmer(50)            # 50% brightness
d.set_dimmer(value=128)     # raw value
d.set_dimmer(0)             # turns device off via turn_off()

import tinytuya

d = tinytuya.BulbDevice('DEVICE_ID', '192.168.1.51', 'LOCAL_KEY')
d.set_version(3.3)
d.set_socketPersistent(True)

d.turn_on()
d.turn_off()

d.set_mode('colour')

d.set_colour(255, 0, 0)       # red
d.set_colour(0, 255, 128)     # seafoam green

d.set_hsv(0.0, 1.0, 1.0)   # pure red
d.set_hsv(0.5, 0.8, 0.9)   # teal

d.set_white_percentage(brightness=80, colourtemp=50)

d.set_brightness_percentage(60)

d.set_colourtemp_percentage(75)

d.set_scene(1)   # nature
d.set_scene(3)   # rave
d.set_scene(4)   # rainbow

d.set_timer(1800)   # 30 minutes

d.set_musicmode(tinytuya.BulbDevice.MUSIC_TRANSITION_JUMP)
d.set_musicmode(tinytuya.BulbDevice.MUSIC_TRANSITION_FADE)

d.set_music_colour(tinytuya.BulbDevice.MUSIC_TRANSITION_FADE, 0, 128, 255)

s = d.state()
print(s)
# {'switch': True, 'mode': 'colour', 'brightness': 800,
#  'colourtemp': 300, 'colour': '00f003e803e8', 'is_on': True, ...}

print(d.get_mode())

print(d.brightness())

print(d.get_brightness_percentage())

r, g, b = d.colour_rgb()

h, s, v = d.colour_hsv()

hex_str = tinytuya.BulbDevice.rgb_to_hexvalue(255, 0, 0, 'hsv16')

hex_str = tinytuya.BulbDevice.hsv_to_hexvalue(0.0, 1.0, 1.0, 'hsv16')

r, g, b = tinytuya.BulbDevice.hexvalue_to_rgb('ff000000ffff')

h, s, v = tinytuya.BulbDevice.hexvalue_to_hsv('00000fa003e8')

if d.bulb_has_capability('colour'):
    d.set_colour(0, 0, 255)

d.detect_bulb()
print(d.bulb_type)  # 'A', 'B', 'C', or None

d.set_bulb_type('B')

import tinytuya

d = tinytuya.CoverDevice('DEVICE_ID', '192.168.1.52', 'LOCAL_KEY', version=3.3)

d.open_cover()

d.close_cover()

d.stop_cover()

import tinytuya

c = tinytuya.Cloud(
    apiRegion='us',                # Region code: cn, us, us-e, eu, eu-w, in, sg
    apiKey='xxxxxxxxxxxxxxxxxxxx', # Access ID / Client ID
    apiSecret='xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx',
    apiDeviceID='xxxxxxxxxxxxxxxxxxID',  # Optional – one of your device IDs
    configFile='tinytuya.json',    # Optional – load credentials from file
)

# Or load credentials automatically from tinytuya.json:
c = tinytuya.Cloud()

c.setregion('eu')

result = c.cloudrequest('/v1.0/devices/DEVICE_ID/logs', query={'size': 10})

devices = c.getdevices()
for dev in devices:
    print(dev['name'], dev['id'], dev['key'])

result = c.getstatus('DEVICE_ID')
print(result)
# {'result': [{'code': 'switch_1', 'value': True}, ...], 'success': True, ...}

funcs = c.getfunctions('DEVICE_ID')

props = c.getproperties('DEVICE_ID')

dps = c.getdps('DEVICE_ID')

commands = {
    'commands': [
        {'code': 'switch_1', 'value': True},
        {'code': 'countdown_1', 'value': 0},
    ]
}
result = c.sendcommand('DEVICE_ID', commands)
print(result['success'])

online = c.getconnectstatus('DEVICE_ID')
print('online:', online)

import json, tinytuya

c = tinytuya.Cloud()

# Last 24 hours of all events
logs = c.getdevicelog('DEVICE_ID')
print(json.dumps(logs, indent=2))

# Only DP reports for the last 7 days
logs = c.getdevicelog('DEVICE_ID', start=-7, evtype=7)

# Specific time range
logs = c.getdevicelog('DEVICE_ID', start=1706000000, end=1706086400)

result = d.status()
if result and 'Err' in result:
    print('Error', result['Err'], result['Error'])

from tinytuya.Contrib import ThermostatDevice

thermo = ThermostatDevice.ThermostatDevice(
    dev_id='DEVICE_ID',
    address='192.168.1.53',
    local_key='LOCAL_KEY',
    version=3.3
)
data = thermo.status()
print(data)

from tinytuya.Contrib import WiFiDualMeterDevice

meter = WiFiDualMeterDevice.WiFiDualMeterDevice(
    dev_id='DEVICE_ID',
    address='192.168.1.54',
    local_key='LOCAL_KEY',
    version=3.4
)
data = meter.status()
print(data)

import tinytuya

d = tinytuya.OutletDevice('DEVICE_ID', 'DEVICE_IP', 'LOCAL_KEY', version=3.3, persist=True)

d.status(nowait=True)   # prime the connection

while True:
    data = d.receive()
    if data:
        print('Update:', data)
    else:
        d.heartbeat()   # keep connection alive

import tinytuya

# Create gateway device
gw = tinytuya.Device('GATEWAY_ID', '192.168.1.55', 'GATEWAY_KEY', version=3.3)

# Attach a child sub-device (node_id / cid is the sub-device node ID)
child = tinytuya.Device('SUB_DEVICE_ID', parent=gw, cid='SUB_NODE_ID')

data = child.status()
print(data)
child.set_value(1, True)