Bardi-Tuya Smart Home#

Control Tuya smart home devices via cloud API.

Requirements#

• tinytuya Python library installed
• Environment variables must be set:
  • TUYA_ACCESS_ID — Cloud project Access ID
  • TUYA_ACCESS_SECRET — Cloud project Access Secret
  • TUYA_API_REGION — Data center region (default: sg)

The skill will not function if TUYA_ACCESS_ID and TUYA_ACCESS_SECRET are missing.

Setup#

See SETUP.md for detailed installation and configuration instructions.

API Reference#

See references/api-reference.md for DP codes, color presets, HSV encoding, and device details.

Scripts#

Two scripts in scripts/:

ScriptPurposedevices_control.pyDevice controller — lights, plugs, sensors, any Tuya devicedevices_scan.pyLocal network device discovery

Workflows#

Control Any Device#

bash

python3 scripts/devices_control.py <device_id> <command> [args]

Light Commands#

bash

python3 scripts/devices_control.py <device_id> on
python3 scripts/devices_control.py <device_id> off
python3 scripts/devices_control.py <device_id> color blue
python3 scripts/devices_control.py <device_id> white 750 80
python3 scripts/devices_control.py <device_id> brightness 50
python3 scripts/devices_control.py <device_id> preset warm 50

Generic Device Commands#

bash

python3 scripts/devices_control.py <device_id> status
python3 scripts/devices_control.py <device_id> detail
python3 scripts/devices_control.py <device_id> model
python3 scripts/devices_control.py <device_id> send bright_value 500
python3 scripts/devices_control.py discover

Scan Local Network#

bash

python3 scripts/devices_scan.py [--timeout 10] [--verbose]

Brightness Convention#

User input is always 1–100 (percentage). Scripts convert to Tuya range (10–1000) internally:

• 100% → 1000
• 50% → 500
• 10% → 100

Color Presets#

Available presets: red, orange, yellow, green, cyan, blue, purple, mauve, pink, warm, cool

warm and cool use white mode with temperature control. All others use HSV color mode.