Skip to content

A Homebridge plugin for Xiaomi/Roborock vacuum cleaners running Valetudo

License

Notifications You must be signed in to change notification settings

hankipanky/homebridge-valetudo-xiaomi-vacuum

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

33 Commits
 
 
 
 
 
 
 
 

Repository files navigation

Fork by MrLitchyB

The original repo is not really updated anymore and I had some error messages in my logs. Fixed them up here for personal use. Will create PRs if it works fine for me. Also changed the functionality a bit to pause instead of stop when tapping the vacuum in Homekit while cleaning.

homebridge-valetudo-xiaomi-vacuum

This is a fork of homebridge-valetudo-xiaomi-vacuum which is a Homebridge plugin which you can use to control your Xiaomi Roborock vacuum that has Valetudo installed.

Installation

npm -g install homebridge-valetudo-xiaomi-vacuum

Configuration

An entry in config.json is needed.

Example:

{
    "accessory": "ValetudoXiaomiVacuum",
    "name": "<Accessory name, e.g. Vacuum>",
    "ip": "<Vacuum's ip address>"
}

Optionally, you can enable switches for controlling speed modes of the device by adding the power-control dictionary with default-speed and high-speed keys (both mandatory in that case), where the speed preset may be one of: quiet, balanced, turbo, and max.

For a mopping-capable vacuum (i.e. Gen 2 - S50/S55), a mop mode button can be also enabled using the mop-enabled option that is a true/false value. You can skip that option altogether - false will be the default.

Example:

{
    "accessory": "ValetudoXiaomiVacuum",
    "name": "Mo",
    "ip": "192.00.486.259",
    "power-control": {
        "default-speed": "quiet",
        "high-speed": "turbo",
        "mop-enabled": true
    }
}

Compatibility

Tested on Roborock S50 with firmware v001748 and Valetudo 0.6.1.

Vacuum map in Home app

I played a little with an idea of setting up a HomeKit camera that grabs the generated Vacuum image and streams it as a video. The idea issue contains more details.

About

A Homebridge plugin for Xiaomi/Roborock vacuum cleaners running Valetudo

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • JavaScript 100.0%