Valetudo

Cloud-free control webinterface for vacuum robots

View the Project on GitHub Hypfer/Valetudo

General

Supported Robots Capabilities Overview Installation instructions Upgrading

Installation

Roborock OTA Viomi

Companion Apps

Valeronoi Lovelace Valetudo Map Card I can't belive it's not Valetudo node-red-contrib-valetudo Valetudo Minecraft Mapper Other Noteworthy Projects

Integrations

MQTT Home Assistant Node-RED

Misc

FAQ Frequently requested features Troubleshooting

Development

Building and Modifying Valetudo Valetudo core concepts

Knowledge Base

Supported Roborock Devices Supported Viomi Devices Supported Dreame Devices

Frequently asked questions

Why the name?

Valetudo is the roman name for the greek goddess Hygieia which is the goddess of health, cleanliness and hygiene. Also I’m bad at naming things.

Are there still random factory resets?

No. We know what caused them, and it’s not happening anymore.

To add some context:
Roborock V1 and Roborock S5 up to firmware version 1898 hat an issue with random factory resets. This only applies to these two models of vacuum robot. Nothing else.

Those resets were caused by the watchdog of the firmware sometimes noticing that there was less free ram than expected, due to Valetudo running on the vacuum. This set a “broken” flag for the partition and if on the daily reboot both system A and B were flagged, the robot would reset itself to factory defaults.

This isn’t happening anymore on the S5 FW 2008+ due to roborock having optimized their software quite significantly so that they could manufacture the S5 Max with only 256MB RAM as opposed to the 512MB on the S5.

However we’ve also found a mitigation which prevents this issue from appearing on the V1 which hasn’t yet received the new and memory-optimized roborock firmware code.

If you build your firmware with the fix reset option (on by default), it will contain a script that on each reboot checks both System A and System B for the “broken” flag and unsets that.

Therefore, it will never have two “broken” flags, unless stuff is actually broken.

Vendor-specific FAQ

Roborock

Is it possible to remove Valetudo from my robot completely?

Yes. Simply reset your robot to factory defaults.

Can I still use the Mi Home app after installing Valetudo?

No. Valetudo removes the connection to Xiaomi’s cloud, which the Mi Home app relies on, and thus it won’t work anymore. This is by design to improve your privacy. You should be able to do anything you want to do, also on phones, by just connecting to your vacuum’s IP address through your browser. It will open an user-friendly control interface.

Why does my robot speak Chinese?

Because it’s language is set to Chinese!

Edit /mnt/default/roborock.conf and change language=prc to language=en.

How do I install a different language sound pack?

The python-miio project offers a commandline tool to communitcate with the robot. This can upload a language pack and install the sound file in your preferred language.

  1. Download the language pack

    Go to https://dontvacuum.me/robotinfo/ and check out the links in “Soundfiles” column.

  2. Setup python-miio

    For this the following packages need to be installed:

    • python3
    • python3-pip
    • python3-venv

    Setup a python virtual env:

    mkdir miio
    cd miio
    python3 -m venv venv
    

    Install python-miio:

    source venv/bin/activate
    pip3 install wheel
    pip3 install python-miio
    

    Now you can install the sound pack with:

    mirobo --ip <ip> --token <token> install-sound /path/to/<lang>.pkg
    

Where do I find the log file?

tail -f /var/log/upstart/valetudo.log

How can I get the token from the robots FileSystem?

printf $(cat /mnt/data/miio/device.token) | xxd -p

No map displayed

Since v0.3.0 Valetudo now use the cloud interface and that requires the robot to be provisioned (wifi configured). Therefore, the map will not be displayed in AP mode! Ensure you added your device to your own wifi network. In AP mode, a map will nevertheless be created, that map can later be displayed once connected to the wifi network.

My map does not persist / zone co-ordinates change

By default, the robot will generate a new map on each clean, and it is likely this will void any saved zones.

For Gen1, the only way to mitigate this is to not use full cleans, as the feature to save maps is not supported. Perform a full clean once for the map to be created, then create zones that you can use individually.

For Gen2, you can enable persistent maps on the device by opening up Valetudo, navigating to Settings > Persistent data and enabling the feature.

It’s also possible to do this using the python-miio library:

mirobo --ip <ip> --token <token> raw-command set_lab_status 1 # Enabling the lab status allows advanced commands to be issued
mirobo --ip <ip> --token <token> raw-command save_map # Enable persistent maps!

What is the “Sensor” consumable?

The sensors don’t wear out, but Xiaomi recommends cleaning them after each 30 hours of vacuuming as they collect dust. This includes four cliff sensors on the bottom and the wall sensor on the side of the robot. Just reset the sensor consumable after cleaning.

Why am I seeing timeouts when I’m trying to flash my roborock vacuum?

Flashing via the local OTA method is only possible with older firmwares, since newer ones don’t allow that anymore.

If your robot is older than 2019-09, you can simply factory reset and then install Valetudo.

However if your robot is newer and already came with a non-flashable firmware from the factory, you’re pretty much out of luck. Installing Valetudo on such devices requires disassembly and thus voiding the warranty.