Bardi-Tuya Smart Home
Control Tuya smart home devices via cloud API.
Requirements
tinytuyaPython library installed- Environment variables must be set:
TUYA_ACCESS_ID— Cloud project Access IDTUYA_ACCESS_SECRET— Cloud project Access SecretTUYA_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/:
| Script | Purpose |
|---|---|
devices_control.py |
Device controller — lights, plugs, sensors, any Tuya device |
devices_scan.py |
Local network device discovery |
Workflows
Control Any Device
python3 scripts/devices_control.py <device_id> <command> [args]
Light Commands
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
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
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.
