Valetudo

Open source cloud replacement for vacuum robots enabling local-only operation

View the Project on GitHub Hypfer/Valetudo

General

Newcomer Guide Late 2021 Why Valetudo? Why not Valetudo? Getting Started Supported Robots Capabilities Overview Rooting instructions Upgrading Firmware Updates Buying supported robots

Installation

Roborock OTA

Companion Apps

Valetudo Companion (Android) Valetudo Tray Companion (Windows) Valeronoi Lovelace Valetudo Map Card I can't believe it's not Valetudo node-red-contrib-valetudo Fun & Games Other Noteworthy Projects

Integrations

MQTT Home Assistant Node-RED openHAB

Misc

FAQ Roborock, Files to backup Style Guide Troubleshooting

Development

Building and Modifying Valetudo Valetudo core concepts MQTT

Archive

Supported Dreame Devices Supported Roborock Devices Newcomer Guide Early 2021

Firmware Updates

By rooting your robot, you will lose the ability to install firmware updates directly from the vendor via OTA. This is intentional as those would un-root your robot. To update your robots’ firmware, you will need to install a rooted version of that firmware.

Do note that just because a new firmware version is out, this does not mean that you’ll be able to instantly install and use it. With every new firmware, we need to figure out how to root and patch it to work offline.

Usually, some software updates break out patching, and thus we have to rework it. Occasionally, the vendor might even introduce new countermeasures against us. While unlikely, it might happen that a new firmware version turns out to not be rootable at all. Do keep that in mind.

To update your robots’ firmware, simply head over to the Dustbuilder and build a new rooted firmware image with the version you want to install. Make sure to select the “Build for manual installation” option.

With the image built, SSH into your robot, download the tar file, extract it and install the firmware with the installation script provided inside the tar file. The process is basically the same as the one done during the initial root. Make sure that the robot is docked during that procedure.

If your robot has multiple system partitions like most of them do, you can run that install procedure twice for good measure. It is however not required to do that.