aqara

1# Aqara
2 
3## Purpose
4Read device attributes and send control commands to Aqara devices through the
5Aqara Open Cloud API: plugs and wall switches, lights (brightness, color
6temperature), air conditioners, supported locks, curtain motors, and saved
7scenes, organized by homes and rooms. Use it when the user asks about or wants
8to change anything in their Aqara setup. Zigbee devices need an Aqara hub
9online. Commands drive real physical hardware, so writes are
10confirmation-gated (see Operating Rules).
11 
12## Tooling
13All commands go through `bin/aqara.py`. `--region` picks the regional host
14(`open-<region>.aqara.com`, e.g. `us`, `eu`, `cn`; default `us`).
15 
16**Every path below is UNTESTED.** The exact REST path form and the request
17signature headers could not be pinned from public docs at build time (see
18Operating Rules, open items). Verify every command against the official
19OpenAPI reference on first live use before trusting it.
20 
21```bash
22bin/aqara.py auth --region us                         # UNTESTED: status check, list homes
23bin/aqara.py homes --region us                        # UNTESTED: list homes
24bin/aqara.py rooms --home <home_id> --region us       # UNTESTED: list rooms
25bin/aqara.py devices --home <home_id> --region us     # UNTESTED: list devices
26bin/aqara.py status --device <device_id> --region us  # UNTESTED: read device attributes
27 
28# Writes (all UNTESTED paths). Lock endpoints are HIGH: --confirm on every run:
29…