holowinski/home-assistant-vacuum-viomise

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

★ 0Forks 0PythonGitHub ↗Compare

README

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

Installation

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.

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

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

Contributors

marotowebKrzysztofHajdamowicznqkdevMaczugaholowinski

Issues