This is for Viomi Robot Vacuum Cleaner SE (apparently EU version) with 4.0.9_0012 firmware and tested in 4.0.9_0017
Using HACS (recommended)
- Open HACS
- Go to "Integrations" section
- Click button with "+" icon
- Search for "Viomi Robot Vacuum Cleaner SE"
- Install repository in HACS
To install this integration manually you have to download following files:
to config/custom_components/viomise
directory:
mkdir -p custom_components/viomise
cd custom_components/viomise
wget https://raw.githubusercontent.com/marotoweb/home-assistant-vacuum-viomise/master/custom_components/viomise/README.md
wget https://raw.githubusercontent.com/marotoweb/home-assistant-vacuum-viomise/master/custom_components/viomise/__init__.py
wget https://raw.githubusercontent.com/marotoweb/home-assistant-vacuum-viomise/master/custom_components/viomise/vacuum.py
wget https://raw.githubusercontent.com/marotoweb/home-assistant-vacuum-viomise/master/custom_components/viomise/manifest.json
or you can download latest release package
mkdir -p custom_components/viomise
cd custom_components/viomise
wget https://github.com/marotoweb/home-assistant-vacuum-viomise/releases/latest/download/viomi_se.zip
unzip viomi_se.zip
Add the configuration to configuration.yaml
file, like the example below:
vacuum:
- platform: viomise
host: 192.168.68.105
token: !secret vacuum
name: Viomi SE
# do not flood the vacuum with requests with scan_interval
scan_interval: 30
Note: Vacuum token can be extracted by following this guide. I recommend using the python script method to extract the token as it is simpler, and only requires you to enter your Xiaomi Cloud username and password. These are the credentials used for the Xiaomi Home app (not ones from Viomi Robot app).