/home-assistant-vacuum-viomise

Hacky Home assistant support for Viomi SE (V-RVCLM21A)

Primary LanguagePython

Hacky Home assistant support for Viomi SE (V-RVCLM21A)

hacs_badge

This is for Viomi Robot Vacuum Cleaner SE (apparently EU version) with 4.0.9_0012 firmware and tested in 4.0.9_0017

Installation

Using HACS (recommended)

  • Open HACS
  • Go to "Integrations" section
  • Click button with "+" icon
  • Search for "Viomi Robot Vacuum Cleaner SE"
  • Install repository in HACS

Manual

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

Configuration

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).

Recommended lovelace card with user-friendly way to fully control Viomi that works with this integration