Giter Club home page Giter Club logo

homeassistant-roborock's Introduction

Roborock integration for HomeAsssistant

About this repo

I've bought a Roborock S7 Maxv and hated the fact that I had to use the Roborock App or the previous existing HomeAssistant integration. But not both.

Using the Xiaomi integration there is also a limit to the number of map request which this integration doesn't have

Hope everyone can enjoy this integration along side the Roborock App

Buy me a coffee!


Installation

I recommend installing it through HACS

IMPORTANT

Ensure that your HA instance can listen for device broadcasts on port 58866 Ensure that your HA instance can communicate to device on port 58867

Installing via HACS

Open your Home Assistant instance and open a repository inside the Home Assistant Community Store.

or

  1. Go to HACS->Integrations
  2. Add this repo into your HACS custom repositories
  3. Search for Roborock and Download it
  4. Restart your HomeAssistant
  5. Go to Settings->Devices & Services
  6. Shift reload your browser

Setup the Integration

Open your Home Assistant instance and start setting up a new integration.

  1. Click Add Integration
  2. Search for Roborock
  3. Type your username used in the Roborock App and hit submit
  4. You will receive an Email with a verification code
  5. Type the verification code and hit submit
  6. You're all set

Functionality

Vacuum

  • Start the vacuum
  • Stop the vacuum
  • Pause the vacuum
  • Dock the vacuum
  • Control vacuum fan speed
  • Vacuum battery
  • Locate vacuum
  • Clean Spot

Additional Vacuum functionality that is supported through services:

  • Remote control
  • Clean zone
  • Go to
  • Clean segment
  • Set mop mode
  • Set mop intensity
  • Reset consumables

Map

There is a map built in to the integration that shows you your most recent/current run of the vacuum.

Sensors

  • DND start
  • DND end
  • Last clean start
  • Last clean end
  • last clean duration
  • last clean area
  • current error
  • current clean duration
  • current clean area
  • total duration
  • total clean area
  • total clean count
  • total dust collection count
  • main brush left
  • side brush left
  • filter left
  • sensor dirty left
  • battery

Binary Sensors

  • Mop attached
  • Water box attached
  • Water shortage

Camera

If your vacuum has a builtin camera, you can use go2rtc made by @AlexxIT. Steps here


Special thanks

Thanks @rovo89 for https://gist.github.com/rovo89/dff47ed19fca0dfdda77503e66c2b7c7 And thanks @PiotrMachowski for https://github.com/PiotrMachowski/Home-Assistant-custom-components-Xiaomi-Cloud-Map-Extractor


homeassistant-roborock's People

Contributors

humbertogontijo avatar lash-l avatar shred86 avatar felixhaeberle avatar nezz avatar menelao147 avatar hsk-dk avatar lukasjakobi avatar dependabot[bot] avatar jdejaegh avatar xyaren avatar syndikatss avatar mirkochip88 avatar gatisr avatar beersteddy avatar muhviehstar avatar labbs1 avatar jezza34000 avatar nerdiyde avatar tzagim avatar piitaya avatar tefracky avatar ainmosni avatar chrillebile avatar hkabig avatar barrelltitor avatar ccsalvesen avatar janvanicek avatar jason-curtis avatar samuelthng avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.