2025-03-29 22:53:47 -04:00
2025-03-22 11:15:33 -04:00
2025-03-29 22:53:47 -04:00
2025-03-26 18:33:36 -04:00

Roborock Custom Map

This allows you to use the core Roborock integration with the Xiaomi Map Card

If you would like to support me, you can do so here:

BuyMeCoffee

PaypalMe

Setup

  1. Install the Roborock Core Integration and set it up
  2. It is recommended that you first disable the Image entities within the core integration. Open each image entity, hit the gear icon, then trigger the toggle by enabled.
  3. Install this integration
  4. This integration works by piggybacking off of the Core integration, so the Core integration will do all the data updating to help prevent rate-limits. But that means that the core integration must be setup and loaded first. If you run into any issues, make sure the Roborock integration is loaded first, and then reload this one.
  5. Setup the map card like normal! An example configuration would look like
type: custom:xiaomi-vacuum-map-card
vacuum_platform: roborock
entity: vacuum.s7
map_source:
  camera: image.s7_downstairs_full_custom
calibration_source:
  camera: true
  1. You can hit Generate Room Configs to allow for cleaning of rooms. It might generate extra keys, so check the yaml and make sure there are no extra 'predefined_sections'

Alternative/optional

Once you set up this integration, you can generate a static config in the lovelace card, and theoretically, you should be able to use that code with your Roborock CORE integration. However, it wont stay up to date if the map calibrations change significantly, or rooms change. So I'd only do this when I was sure everything was good!

Installation

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(https://github.com/Lash-L/RoborockCustomMap) into your HACS custom repositories
  3. Search for Roborock Custom Map and Download it
  4. Restart your HomeAssistant
  5. Go to Settings->Devices & Services
  6. Add the Roborock Custom Map integration
S
Description
Add support for working with Piotr Machowski's map card for the official Roborock integration ⚠️ ARCHIVED: Original GitHub repository no longer exists. Preserved as backup on 2026-07-26T21:05:58.402Z
Readme
140 KiB
Languages
Python 100%