This plugin uses the Python-miio library to control the Xiaomi Mi Robot Vacuum.

See this link for more information on how to use Python plugins in Domoticz.

Plugin provides: Status, Control, Fan Level, Care status devices, Zone Control, Target Control

Status: show current status and battery level in readable layout of switch. Status updates by polls (interval) and when you click Control device (for instant status change).

Control: for sending commands.

Fan Level: for adjusting suction power. (MiHome app related: Quiet=38, Balanced=60, Turbo=77, Max=90)

Care: 5 devices for the care status, and a care reset tool.

Zone Control

Target Control

Python >= 3.8 is required.

Before installation plugin check the python3, python3-dev, pip3 is installed for Domoticz plugin system:

sudo apt-get install python3 python3-dev python3-pip

Make sure you have libffi and openssl headers installed, you can do this on Debian-based systems (like Rasperry Pi) with:

sudo apt-get install libffi-dev libssl-dev.

Then go to plugins folder and clone repository:

cd domoticz/plugins
git clone https://github.com/joro75/domoticz-mirobot-plugin.git xiaomi-mirobot
cd xiaomi-mirobot
mv ~/domoticz/plugins/xiaomi-mirobot/miio/ ~/

# and then:
sudo pip3 install -r requirements.txt 
# or sudo pip3 install gevent msgpack python-miio setuptools

Need some prepare of MIIO Server to run as service:

1. Open and edit miio_server.sh by vi/nano:

cd ~/miio/
nano ~/miio/miio_server.sh

# 1. Check and update absolute path to miio_server.py
# 2. Update IP and TOKEN for robot
# 3. Optional. Change MIIO server host-port bindings if need it

# file miio_server.sh
DAEMON_USER=root
DAEMON=/home/pi/miio/miio_server.py
DAEMON_ARGS="192.168.1.12 476e6b70343055483230644c53707a12"
DAEMON_ARGS="$DAEMON_ARGS --host 127.0.0.1 --port 22222"
#

2. Check path to python3 (which python3). By default is /usr/bin/python3. If your path different than default, update miio_server.py first line with your path.

#!/usr/bin/python3

3. For run as system service:

sudo chmod +x miio_server.py
sudo chmod +x miio_server.sh

# check your path here:
sudo ln -s /home/pi/miio/miio_server.sh /etc/init.d/miio_server

# add to startup
sudo update-rc.d miio_server defaults
sudo systemctl daemon-reload

# if you want to remove from startup
sudo update-rc.d -f miio_server remove

4. Run server and test script:

sudo service miio_server start
sudo chmod +x test.py
sudo ./test.py

# to stop miio server service
sudo service miio_server stop

Also you can run MIIO Server manually and look log output:

sudo ./miio_server.py 192.168.1.12 476e6b70343055483230644c53707a12 --host 127.0.0.1 --port 22222

# then you can run test
sudo ./test.py

If server and test is ok, time to restart the Domoticz:

sudo service domoticz.sh restart

Now go to Setup -> Hardware in your Domoticz interface and add type with name Xiaomi Mi Robot Vacuum.

Check the instruction

After clicking on the Add button the new devices are available in Setup -> Devices.

If you want to change Fan Level Type just disable hardware, update type and enable again. Old device can be deleted manually in Devices menu.

cd domoticz/plugins/xiaomi-mirobot
git pull

Restart the Domoticz service

sudo service domoticz.sh restart

The device token is required to be set in the miio_server.sh script, which is the identification of the Xiaomi Mi vacuum. Check the instruction on how to get access to the correct device token.

Originally created by: mrin/domoticz-mirobot-plugin