-
-
Notifications
You must be signed in to change notification settings - Fork 75
Installation process
- Provisioning the vacuum and getting its token;
- Downloading pre-rooted firmware;
- Flashing pre-rooted firmware;
- Installing Valetudo.
The simplest way to get the token is to install a modified version of Mi Home app by vevs. You can get it i.e. here or otherwise google the Internet. It can not only setup the device to connect to your Wi-Fi network, but also can show current device token which will be required for flashing firmware.
If you happen not to have an Android device, you may want to try using BlueStacks Android emulator and installing Mi Home mod there.
So, provision your vacuum normally as you do with genuine Mi Home app, next find the token of the device. After you've successfully got the token, you may want to uninstall this app since you won't need it anymore.
There are several locations where you can download a pre-rooted firmware.
Some links are provided on the firmware downloads page. You may choose between modded firmware or just pre-rooted ones: they both have pre-set password cleaner for connecting to the device via SSH.
Some may want to use dustBuilder service to get a firmware with injected crypto key for passwordless SSH connection. And for sure it is possible to build your own firmware image yourself using dustcloud imagebuilder script, though you'll need a linux-based VM in this case.
To flash the firmware under Windows there's a tool called WIN-MIROBO. To use it, unzip to any folder and edit file called win-mirobo.ini. You need to specify the IP-address of the vacuum (that it got from Wi-Fi router) and its token.
Next you need to put firmware image file to firmwares folder. Then just run win-mirobo.bat (it doesn't require admin permissions). It will run a console application, all the menu options are self-explanatory.
To successfully begin firmware installation you may need to temporary disable any firewall software on the computer. This is required since it is the vacuum which connects to the PC to get the image file, not vise versa, thus requirements to allow incoming connections.
Also you can flash custom sound packs using this tool.
It is also possible to flash firmware using XVacuum Firmware app from your smartphone. This app is obviously not available from the official stores, it can be installed manually from the xda-developers.com site. Root access is not required for using it.
As long as you have rooted firmware on the vacuum, now you just need to place some files into the right places on the device. You will need any SCP-based (or SFTP) file manager for that (or be an experienced SSH console user). Freeware WinSCP will do for Windows PC, something like ES File Explorer will be fine for an Android device.
If you're OK with using pre-built binary, start with downloading latest valetudo release. If not, just proceed to deployment section and follow the README there.
Next if you are to use GUI file manager, you'll need to unpack .tar.gz archive since current releases are compressed. Then upload valetudo binary to /usr/local/bin path on the vacuum and make sure it has the executable permissions (744) set.
Or, if you're comfortable with SSH console, you can upload packed binary to the vacuum and unpack it on the device itself by using tar zxf filename command.
Next copy valetudo.conf file to upstart scripts directory at /etc/init, this will make valetudo app start on the device's boot.
Then you need to insert into existing files the next two files contents:
- hosts append to the end of /etc/hosts file;
- rc.local insert just before exit 0 line in the /etc/rc.local file.
When finished, just reboot the device either by long pressing "ON" bug button on the device itself until it shuts down and then quick clicking it again for device to boot, or by issuing reboot command into SSH console.
After device reboots, you should be able to see Valetudo webGUI at http://your.vacuum.ip.address/ in your favorite browser.