A simple command-line python script to drive a robot vacuum. Currently known to work with the Ecovacs Deebot N79, M80 Pro, M81, M88 Pro, and R95 MKII from both North America and Europe.
Does it work for your model as well? Join the discussion on the ozmo-users mailing list.
If you're curious about the protocol, I have a rough doc started. I'll happily accept pull requests for it.
Why the project name? Well, a) it's ridiculous that I needed to MITM my own vacuum. This is not the future I signed up for. And b), it's a vacuum.
If you have a recent version of Python 3, you should be able to
do pip install ozmo
to get the most recently released version of
this.
To get started, you'll need to have already set up an EcoVacs account using your smartphone.
With that ready, step one is to log in:
% ozmo login
Ecovacs app email: [your email]
Ecovacs app password: [your password]
your two-letter country code: us
your two-letter continent code: na
Config saved.
That creates a config file in a platform-appropriate place. The password is hashed before saving, so it's reasonably safe. (If it doesn't appear to work for your continent, try "ww", their world-wide catchall.)
With that set up, you could have it clean in auto mode for 10 minutes and return to its charger:
% ozmo clean 10
You could have it clean for 15 minutes and then do an extra 10 minutes of edging:
% ozmo clean 15 edge 10
If you wanted it to clean for 5 minutes and then stop without charging:
% ozmo clean 5 stop
If it's running amok and you'd just like it to stop where it is:
% ozmo stop
To tell it to go plug in:
% ozmo charge
I run mine from my crontab, but I didn't want it to clean every day, so it also has a mode where it randomly decides to run or not based on a frequency you give it. My crontab entry looks like this:
0 10 * * * /home/william/projects/ozmo/ozmo.sh clean -f 4/7 15 edge -f 1/14 10
This means that every day at 10 am, it might do something. 4 days out of 7, it will do 15 minutes of automatic cleaning. 1 day out of 14, it will do 10 minutes of edging. And afterward it will always go back to charge.
You are welcome to try using this as a python library for other efforts. The API is still experimental, so expect changes. Please join the mailing list to participate in shaping the API.
A simple usage might go something like this:
from ozmo import *
config = ...
api = EcoVacsAPI(config['device_id'], config['email'], config['password_hash'],
config['country'], config['continent'])
my_vac = api.devices()[0]
vacbot = VacBot(api.uid, api.REALM, api.resource, api.user_access_token, my_vac, config['continent'])
vacbot.connect_and_wait_until_ready()
vacbot.run(Clean()) # start cleaning
time.sleep(900) # clean for 15 minutes
vacbot.run(Charge()) # return to the charger
If you'd like to join in on developing, I recommend checking out the code, setting up a virtual environment, and installing this package in editable mode. You can confirm your environment works by running the tests. And please do join the mailing list to discuss your plans.
For more information see the development documentation.
There are now similar libraries in Javascript and Go.
My heartfelt thanks to: