ecovacs

1# Ecovacs
2 
3## Purpose
4Control Ecovacs DEEBOT robot vacuums through the official Ecovacs Open Platform: list bound robots, read robot state and battery, start/pause/resume/stop cleaning, send the robot back to its dock, and set the sweep/mop work mode. Use when the user mentions their DEEBOT or robot vacuum.
5 
6## Tooling
7All commands go through `bin/ecovacs.py`. `--region` selects the Open Platform region (`global` for open.ecovacs.com, `cn` for open.ecovacs.cn; default `global`) and must match the region of the user's Ecovacs account and robots. `--robot` is the robot's nickname (a fragment of the name shown in the app is enough for the gateway to match it).
8 
9```bash
10bin/ecovacs.py auth --region global                 # verify the Access Key
11bin/ecovacs.py devices                              # list bound robots
12bin/ecovacs.py status --robot Blue                  # cleaning/paused/docked state
13bin/ecovacs.py battery --robot Blue                 # battery percent
14bin/ecovacs.py stats --robot Blue                   # area cleaned, duration
15 
16# MEDIUM: cleaning start needs --confirm "<exact effect>" on first use per robot
17bin/ecovacs.py clean --robot Blue --confirm "start cleaning on Blue"
18 
19# LOW: no confirmation
20bin/ecovacs.py pause --robot Blue
21bin/ecovacs.py resume --robot Blue
22bin/ecovacs.py stop --robot Blue
23bin/ecovacs.py dock --robot Blue
24bin/ecovacs.py undock --robot Blue
25…