This is for Viomi Robot Vacuum Cleaner SE (apparently EU version) with 4.0.9_0012 firmware and tested in 4.0.9_0017
Repository is forked from KrzysztofHajdamowicz/home-assistant-vacuum-styj02ym
Due to my lack of knowledge in python some things may not make sense or there is a better way to do them, we just shouldn't be stuck
Using HACS (recommended)
This integration can be added to HACS as a custom repository:
- URL:
https://github.com/marotoweb/home-assistant-vacuum-viomise
- Category:
Integration
After adding a custom repository you can use HACS to install this integration using user interface.
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
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).