For a description of the Ecovacs API protocols, see the protocol documentation
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 dev mode. You can confirm your environment works by running the tests. The commands for that look something like like
% python3 -m virtualenv env
% source env/bin/activate
% pip install -e .[dev]
% nosetests
If the test run is successful, it will say something like
Ran 44 tests in 0.734s
OK
Current test are not yet comprehensive, as the integrated nature of this makes it difficult. But we aim to reduce that problem over time, so please add tests as you go.
- Download xmpppeek
- Create a self-signed certificate with the following command
openssl req -x509 -newkey rsa:4096 -keyout key.pem -out cert.pem -days 365 -nodes
-
Edit xmpppeek.py and change port to 5223
-
Look at the the protocol documentation for information on which Ecovacs XMPP server is the right one for your Country. For example, a US user will be using msg-na.ecouser.net. Find and note the IP address for the server.
-
Make sure the mobile App talks to your machine instead of the server. This can be accomplished modifying your router's DNS configuration to have the Ecovacs domain name point to your IP.
-
Run xmppeek as follows.
python ./xmpppeek.py <ECOVACS XMPP SERVER IP> cert.pem key.pem
Ecovacs robots have an undocumented hardware reset button that can be useful in case you run into trouble. Under the dustbin lid there is a small round hole that hides the button (confirmed on models M80 and M81).
With the robot on, use something thin like a paper clip or needle to press and hold the reset button. After about three seconds the robot will beep three times to indicate successful reset.
You will have to delete the robot from the mobile app and go through the setup process.