Security & safety

Xiaomi Cloud Map Extractor

PiotrMachowski/Home-Assistant-custom-components-Xiaomi-Cloud-Map-Extractor · vv2.2.5

HACSCloud polling

This custom integration provides a way to present a live view of a map for Xiaomi (Roborock/Viomi/Roidmi/Dreame) vacuums without a need for rooting.

Documentation Source code

In Apple Home through HomeKit Bridge

What HomeKit Bridge makes of each kind of entity this integration creates, read from its source code. A device only gets the ones that apply to it.

Entity	Shows up as	Note
`camera`	Camera	Needs its own HomeKit Bridge in accessory mode

What people report

Cloud map extraction for Roborock, Viomi, Roidmi and Dreame vacuums works; newer Xiaomi-branded models (ov21gl, S40, X20+) are still being added in v3 alpha with room and refresh gaps.

Works22
Partly works4
Not working1
Requested3

Device	In Home Assistant	What they said	Source
Dreame D9	Works Cloud	Listed as supported map format in README Saved copy … (Roidmi EVE Plus); viomi.vacuum.v18 (Viomi S9); viomi.vacuum.v38 (Viomi V5 Pro); zhimi.vacuum.xa1 (Lydsto R1); chuangmi.vacuum.hmi707 (IMILAB V1 Vacuum); Dreame map format:; dreame.vacuum.mc1808 (Xiaomi Mi Mop/Xiaomi Mijia 1C); dreame.vacuum.p2008 (Dreame F9); dreame.vacuum.p2009 (Dreame D9); dreame.vacuum.p2028 (Dreame Z10 Pro); dreame.vacuum.p2029 (Dreame L10 Pro); dreame.vacuum.p2036 (Trouver LDS Cleaner); dreame.vacuum.p2041o (Xiaomi Mop 2 Pro+); dreame.vacuum.p2140 (Mijia Robot Vacuum-Mop 2C); dreame.vacuum.p2157 (MOVA L600); dreame.vacuum.p2259 (Dreame D9 Max). Excerpt saved from the README on 2026-10-23.	README
Dreame D9 Max	Works Cloud	Listed as supported map format in README Saved copy … SDJQR02RR); roborock.vacuum.m1s (Xiaomi Mi Robot 1S); roborock.vacuum.s4 (Roborock S4); roborock.vacuum.s5 (Roborock S5); roborock.vacuum.s5e (Roborock S5 Max); rockrobo.vacuum.s6 (Roborock S6); roborock.vacuum.a08 (Roborock S6 Pure); roborock.vacuum.a10 (Roborock S6 MaxV); roborock.vacuum.a15 (Roborock S7); roborock.vacuum.a19 (Roborocka S4 Max); roborock.vacuum.a27 (Roborock S7 MaxV); roborock.vacuum.a70 (Roborock S8 Pro Ultra); Viomi map format:; viomi.vacuum.v6 (Viomi Vacuum V2 Pro, Xiaomi Mijia STYJ02YM, Mi Robot Vacuum Mop Pro); viomi.vacuum.v7 (Mi Robot Vacuum-Mop Pro); viomi.vacuum.v8 … Excerpt saved from the README on 2026-10-23.	README
Dreame F9	Works Cloud	Listed as supported map format in README Saved copy … (Roidmi EVE Plus); viomi.vacuum.v18 (Viomi S9); viomi.vacuum.v38 (Viomi V5 Pro); zhimi.vacuum.xa1 (Lydsto R1); chuangmi.vacuum.hmi707 (IMILAB V1 Vacuum); Dreame map format:; dreame.vacuum.mc1808 (Xiaomi Mi Mop/Xiaomi Mijia 1C); dreame.vacuum.p2008 (Dreame F9); dreame.vacuum.p2009 (Dreame D9); dreame.vacuum.p2028 (Dreame Z10 Pro); dreame.vacuum.p2029 (Dreame L10 Pro); dreame.vacuum.p2036 (Trouver LDS Cleaner); dreame.vacuum.p2041o (Xiaomi Mop 2 Pro+); dreame.vacuum.p2140 (Mijia Robot Vacuum-Mop 2C); dreame.vacuum.p2157 (MOVA L600); dreame.vacuum.p2259 (Dreame D9 Max). Excerpt saved from the README on 2026-10-23.	README
Dreame L10 Pro	Works Cloud	Listed as supported map format in README Saved copy … MaxV); roborock.vacuum.a15 (Roborock S7); roborock.vacuum.a19 (Roborocka S4 Max); roborock.vacuum.a27 (Roborock S7 MaxV); roborock.vacuum.a70 (Roborock S8 Pro Ultra); Viomi map format:; viomi.vacuum.v6 (Viomi Vacuum V2 Pro, Xiaomi Mijia STYJ02YM, Mi Robot Vacuum Mop Pro); viomi.vacuum.v7 (Mi Robot Vacuum-Mop Pro); viomi.vacuum.v8 (Mi Robot Vacuum-Mop Pro); viomi.vacuum.v13 (Viomi V3); Roidmi map format:; roidmi.vacuum.v60 (Roidmi EVE Plus); viomi.vacuum.v18 (Viomi S9); viomi.vacuum.v38 (Viomi V5 Pro); zhimi.vacuum.xa1 (Lydsto R1); chuangmi.vacuum.hmi707 (IMILAB V1 Vacuum); Dreame map format:; … Excerpt saved from the README on 2026-10-23.	README
Dreame Z10 Pro	Works Cloud	Listed as supported map format in README Saved copy … MaxV); roborock.vacuum.a15 (Roborock S7); roborock.vacuum.a19 (Roborocka S4 Max); roborock.vacuum.a27 (Roborock S7 MaxV); roborock.vacuum.a70 (Roborock S8 Pro Ultra); Viomi map format:; viomi.vacuum.v6 (Viomi Vacuum V2 Pro, Xiaomi Mijia STYJ02YM, Mi Robot Vacuum Mop Pro); viomi.vacuum.v7 (Mi Robot Vacuum-Mop Pro); viomi.vacuum.v8 (Mi Robot Vacuum-Mop Pro); viomi.vacuum.v13 (Viomi V3); Roidmi map format:; roidmi.vacuum.v60 (Roidmi EVE Plus); viomi.vacuum.v18 (Viomi S9); viomi.vacuum.v38 (Viomi V5 Pro); zhimi.vacuum.xa1 (Lydsto R1); chuangmi.vacuum.hmi707 (IMILAB V1 Vacuum); Dreame map format:; … Excerpt saved from the README on 2026-10-23.	README
IMILAB V1	Works Cloud	Listed as supported map format in README Saved copy … roidmi.vacuum.v60 (Roidmi EVE Plus); viomi.vacuum.v18 (Viomi S9); viomi.vacuum.v38 (Viomi V5 Pro); zhimi.vacuum.xa1 (Lydsto R1); chuangmi.vacuum.hmi707 (IMILAB V1 Vacuum); Dreame map format:; dreame.vacuum.mc1808 (Xiaomi Mi Mop/Xiaomi Mijia 1C); dreame.vacuum.p2008 (Dreame F9); dreame.vacuum.p2009 (Dreame D9); dreame.vacuum.p2028 (Dreame Z10 Pro); dreame.vacuum.p2029 (Dreame L10 Pro); dreame.vacuum.p2036 (Trouver LDS Cleaner); dreame.vacuum.p2041o (Xiaomi Mop 2 Pro+); dreame.vacuum.p2140 (Mijia Robot Vacuum-Mop 2C); dreame.vacuum.p2157 (MOVA L600); dreame.vacuum.p2259 (Dreame D9 Max). Excerpt saved from the README on 2026-10-23.	README
Lydsto R1	Works Cloud	Listed as supported map format in README Saved copy … viomi.vacuum.v13 (Viomi V3); Roidmi map format:; roidmi.vacuum.v60 (Roidmi EVE Plus); viomi.vacuum.v18 (Viomi S9); viomi.vacuum.v38 (Viomi V5 Pro); zhimi.vacuum.xa1 (Lydsto R1); chuangmi.vacuum.hmi707 (IMILAB V1 Vacuum); Dreame map format:; dreame.vacuum.mc1808 (Xiaomi Mi Mop/Xiaomi Mijia 1C); dreame.vacuum.p2008 (Dreame F9); dreame.vacuum.p2009 (Dreame D9); dreame.vacuum.p2028 (Dreame Z10 Pro); dreame.vacuum.p2029 (Dreame L10 Pro); dreame.vacuum.p2036 (Trouver LDS Cleaner); dreame.vacuum.p2041o (Xiaomi Mop 2 Pro+); dreame.vacuum.p2140 (Mijia Robot Vacuum-Mop 2C); dreame.vacuum.p2157 (MOVA … Excerpt saved from the README on 2026-10-23.	README
MOVA L600	Works Cloud	Listed as supported map format in README Saved copy … dreame.vacuum.p2036 (Trouver LDS Cleaner); dreame.vacuum.p2041o (Xiaomi Mop 2 Pro+); dreame.vacuum.p2140 (Mijia Robot Vacuum-Mop 2C); dreame.vacuum.p2157 (MOVA L600); dreame.vacuum.p2259 (Dreame D9 Max). Excerpt saved from the README on 2026-10-23.	README
Roborock S4 Max	Works Cloud	Listed as supported map format in README Saved copy Supported devices: Xiaomi map format:; rockrobo.vacuum.v1 (Xiaomi Vacuum Gen 1, Mi Robot Vacuum, SDJQR01RR, SDJQR02RR); roborock.vacuum.m1s (Xiaomi Mi Robot 1S); roborock.vacuum.s4 (Roborock S4); roborock.vacuum.s5 (Roborock S5); roborock.vacuum.s5e (Roborock S5 Max); rockrobo.vacuum.s6 (Roborock S6); roborock.vacuum.a08 (Roborock S6 Pure); roborock.vacuum.a10 (Roborock S6 MaxV); roborock.vacuum.a15 (Roborock S7); roborock.vacuum.a19 (Roborocka S4 Max); roborock.vacuum.a27 (Roborock S7 MaxV); roborock.vacuum.a70 (Roborock S8 Pro Ultra); Viomi map format:; viomi.vacuum.v6 (Viomi Vacuum V2 Pro, … Excerpt saved from the README on 2026-10-23.	README
Roborock S5	Works Cloud	Listed as supported map format in README Saved copy Supported devices: Xiaomi map format:; rockrobo.vacuum.v1 (Xiaomi Vacuum Gen 1, Mi Robot Vacuum, SDJQR01RR, SDJQR02RR); roborock.vacuum.m1s (Xiaomi Mi Robot 1S); roborock.vacuum.s4 (Roborock S4); roborock.vacuum.s5 (Roborock S5); roborock.vacuum.s5e (Roborock S5 Max); rockrobo.vacuum.s6 (Roborock S6); roborock.vacuum.a08 (Roborock S6 Pure); roborock.vacuum.a10 (Roborock S6 MaxV); roborock.vacuum.a15 (Roborock S7); roborock.vacuum.a19 (Roborocka S4 Max); roborock.vacuum.a27 (Roborock S7 MaxV); roborock.vacuum.a70 (Roborock S8 Pro Ultra); Viomi map format:; viomi.vacuum.v6 (Viomi Vacuum V2 Pro, … Excerpt saved from the README on 2026-10-23.	README
Roborock S6	Works Cloud	Listed as supported map format in README Saved copy Supported devices: Xiaomi map format:; rockrobo.vacuum.v1 (Xiaomi Vacuum Gen 1, Mi Robot Vacuum, SDJQR01RR, SDJQR02RR); roborock.vacuum.m1s (Xiaomi Mi Robot 1S); roborock.vacuum.s4 (Roborock S4); roborock.vacuum.s5 (Roborock S5); roborock.vacuum.s5e (Roborock S5 Max); rockrobo.vacuum.s6 (Roborock S6); roborock.vacuum.a08 (Roborock S6 Pure); roborock.vacuum.a10 (Roborock S6 MaxV); roborock.vacuum.a15 (Roborock S7); roborock.vacuum.a19 (Roborocka S4 Max); roborock.vacuum.a27 (Roborock S7 MaxV); roborock.vacuum.a70 (Roborock S8 Pro Ultra); Viomi map format:; viomi.vacuum.v6 (Viomi Vacuum V2 Pro, … Excerpt saved from the README on 2026-10-23.	README
Roborock S7	Works Cloud	Listed as supported map format in README Saved copy Supported devices: Xiaomi map format:; rockrobo.vacuum.v1 (Xiaomi Vacuum Gen 1, Mi Robot Vacuum, SDJQR01RR, SDJQR02RR); roborock.vacuum.m1s (Xiaomi Mi Robot 1S); roborock.vacuum.s4 (Roborock S4); roborock.vacuum.s5 (Roborock S5); roborock.vacuum.s5e (Roborock S5 Max); rockrobo.vacuum.s6 (Roborock S6); roborock.vacuum.a08 (Roborock S6 Pure); roborock.vacuum.a10 (Roborock S6 MaxV); roborock.vacuum.a15 (Roborock S7); roborock.vacuum.a19 (Roborocka S4 Max); roborock.vacuum.a27 (Roborock S7 MaxV); roborock.vacuum.a70 (Roborock S8 Pro Ultra); Viomi map format:; viomi.vacuum.v6 (Viomi Vacuum V2 Pro, … Excerpt saved from the README on 2026-10-23.	README
Roborock S7 MaxV	Works Cloud	Listed as supported map format in README Saved copy Supported devices: Xiaomi map format:; rockrobo.vacuum.v1 (Xiaomi Vacuum Gen 1, Mi Robot Vacuum, SDJQR01RR, SDJQR02RR); roborock.vacuum.m1s (Xiaomi Mi Robot 1S); roborock.vacuum.s4 (Roborock S4); roborock.vacuum.s5 (Roborock S5); roborock.vacuum.s5e (Roborock S5 Max); rockrobo.vacuum.s6 (Roborock S6); roborock.vacuum.a08 (Roborock S6 Pure); roborock.vacuum.a10 (Roborock S6 MaxV); roborock.vacuum.a15 (Roborock S7); roborock.vacuum.a19 (Roborocka S4 Max); roborock.vacuum.a27 (Roborock S7 MaxV); roborock.vacuum.a70 (Roborock S8 Pro Ultra); Viomi map format:; viomi.vacuum.v6 (Viomi Vacuum V2 Pro, … Excerpt saved from the README on 2026-10-23.	README
Roborock S8 Pro Ultra	Works Cloud	Listed as supported map format in README Saved copy Supported devices: Xiaomi map format:; rockrobo.vacuum.v1 (Xiaomi Vacuum Gen 1, Mi Robot Vacuum, SDJQR01RR, SDJQR02RR); roborock.vacuum.m1s (Xiaomi Mi Robot 1S); roborock.vacuum.s4 (Roborock S4); roborock.vacuum.s5 (Roborock S5); roborock.vacuum.s5e (Roborock S5 Max); rockrobo.vacuum.s6 (Roborock S6); roborock.vacuum.a08 (Roborock S6 Pure); roborock.vacuum.a10 (Roborock S6 MaxV); roborock.vacuum.a15 (Roborock S7); roborock.vacuum.a19 (Roborocka S4 Max); roborock.vacuum.a27 (Roborock S7 MaxV); roborock.vacuum.a70 (Roborock S8 Pro Ultra); Viomi map format:; viomi.vacuum.v6 (Viomi Vacuum V2 Pro, … Excerpt saved from the README on 2026-10-23.	README
Roidmi EVE Plus	Works Cloud	Listed as supported map format in README Saved copy … STYJ02YM, Mi Robot Vacuum Mop Pro); viomi.vacuum.v7 (Mi Robot Vacuum-Mop Pro); viomi.vacuum.v8 (Mi Robot Vacuum-Mop Pro); viomi.vacuum.v13 (Viomi V3); Roidmi map format:; roidmi.vacuum.v60 (Roidmi EVE Plus); viomi.vacuum.v18 (Viomi S9); viomi.vacuum.v38 (Viomi V5 Pro); zhimi.vacuum.xa1 (Lydsto R1); chuangmi.vacuum.hmi707 (IMILAB V1 Vacuum); Dreame map format:; dreame.vacuum.mc1808 (Xiaomi Mi Mop/Xiaomi Mijia 1C); dreame.vacuum.p2008 (Dreame F9); dreame.vacuum.p2009 (Dreame D9); dreame.vacuum.p2028 (Dreame Z10 Pro); dreame.vacuum.p2029 (Dreame L10 Pro); dreame.vacuum.p2036 (Trouver LDS … Excerpt saved from the README on 2026-10-23.	README
Viomi S9	Works Cloud	Listed as supported map format in README Saved copy … roborock.vacuum.a15 (Roborock S7); roborock.vacuum.a19 (Roborocka S4 Max); roborock.vacuum.a27 (Roborock S7 MaxV); roborock.vacuum.a70 (Roborock S8 Pro Ultra); Viomi map format:; viomi.vacuum.v6 (Viomi Vacuum V2 Pro, Xiaomi Mijia STYJ02YM, Mi Robot Vacuum Mop Pro); viomi.vacuum.v7 (Mi Robot Vacuum-Mop Pro); viomi.vacuum.v8 (Mi Robot Vacuum-Mop Pro); viomi.vacuum.v13 (Viomi V3); Roidmi map format:; roidmi.vacuum.v60 (Roidmi EVE Plus); viomi.vacuum.v18 (Viomi S9); viomi.vacuum.v38 (Viomi V5 Pro); zhimi.vacuum.xa1 (Lydsto R1); chuangmi.vacuum.hmi707 (IMILAB V1 Vacuum); Dreame map format:; … Excerpt saved from the README on 2026-10-23.	README
Viomi V2 Pro / STYJ02YM	Works Cloud	Map download supported via new API refactor Saved copy I have a Viomi V2 Pro vacuum which is a rebranded STYJ02YM model. I've followed the https://github.com/PiotrMachowski/Home-Assistant-custom-components-Xiaomi-Cloud-Map-Extractor/issues/23 ticket and managed to modify the `XiaomiCloudConnector` to download my map. I know that the map format is different, but I had to download it first. A journey of a thousand miles begins with a single step :-) The new API is a little different and requiring more parameters. I didn't want to add even more arguments to `get_map()` / `get_raw_map_data()`, so I separated the device/map management from the … Excerpt saved from GitHub on 2026-10-23.	PR #121 · 2021-05
Viomi V3	Works Cloud	Listed as supported map format in README Saved copy … roborock.vacuum.a15 (Roborock S7); roborock.vacuum.a19 (Roborocka S4 Max); roborock.vacuum.a27 (Roborock S7 MaxV); roborock.vacuum.a70 (Roborock S8 Pro Ultra); Viomi map format:; viomi.vacuum.v6 (Viomi Vacuum V2 Pro, Xiaomi Mijia STYJ02YM, Mi Robot Vacuum Mop Pro); viomi.vacuum.v7 (Mi Robot Vacuum-Mop Pro); viomi.vacuum.v8 (Mi Robot Vacuum-Mop Pro); viomi.vacuum.v13 (Viomi V3); Roidmi map format:; roidmi.vacuum.v60 (Roidmi EVE Plus); viomi.vacuum.v18 (Viomi S9); viomi.vacuum.v38 (Viomi V5 Pro); zhimi.vacuum.xa1 (Lydsto R1); chuangmi.vacuum.hmi707 (IMILAB V1 Vacuum); Dreame map format:; … Excerpt saved from the README on 2026-10-23.	README
Viomi V5 Pro	Works Cloud	Listed as supported map format in README Saved copy … MaxV); roborock.vacuum.a15 (Roborock S7); roborock.vacuum.a19 (Roborocka S4 Max); roborock.vacuum.a27 (Roborock S7 MaxV); roborock.vacuum.a70 (Roborock S8 Pro Ultra); Viomi map format:; viomi.vacuum.v6 (Viomi Vacuum V2 Pro, Xiaomi Mijia STYJ02YM, Mi Robot Vacuum Mop Pro); viomi.vacuum.v7 (Mi Robot Vacuum-Mop Pro); viomi.vacuum.v8 (Mi Robot Vacuum-Mop Pro); viomi.vacuum.v13 (Viomi V3); Roidmi map format:; roidmi.vacuum.v60 (Roidmi EVE Plus); viomi.vacuum.v18 (Viomi S9); viomi.vacuum.v38 (Viomi V5 Pro); zhimi.vacuum.xa1 (Lydsto R1); chuangmi.vacuum.hmi707 (IMILAB V1 Vacuum); Dreame map format:; … Excerpt saved from the README on 2026-10-23.	README
Xiaomi Mi Robot Vacuum 1S	Works Cloud	Listed as supported map format in README Saved copy Supported devices: Xiaomi map format:; rockrobo.vacuum.v1 (Xiaomi Vacuum Gen 1, Mi Robot Vacuum, SDJQR01RR, SDJQR02RR); roborock.vacuum.m1s (Xiaomi Mi Robot 1S); roborock.vacuum.s4 (Roborock S4); roborock.vacuum.s5 (Roborock S5); roborock.vacuum.s5e (Roborock S5 Max); rockrobo.vacuum.s6 (Roborock S6); roborock.vacuum.a08 (Roborock S6 Pure); roborock.vacuum.a10 (Roborock S6 MaxV); roborock.vacuum.a15 (Roborock S7); roborock.vacuum.a19 (Roborocka S4 Max); roborock.vacuum.a27 (Roborock S7 MaxV); roborock.vacuum.a70 (Roborock S8 Pro Ultra); Viomi map format:; viomi.vacuum.v6 (Viomi Vacuum V2 Pro, … Excerpt saved from the README on 2026-10-23.	README
Xiaomi Mi Robot Vacuum Gen 1	Works Cloud	Listed as supported map format in README Saved copy Supported devices: Xiaomi map format:; rockrobo.vacuum.v1 (Xiaomi Vacuum Gen 1, Mi Robot Vacuum, SDJQR01RR, SDJQR02RR); roborock.vacuum.m1s (Xiaomi Mi Robot 1S); roborock.vacuum.s4 (Roborock S4); roborock.vacuum.s5 (Roborock S5); roborock.vacuum.s5e (Roborock S5 Max); rockrobo.vacuum.s6 (Roborock S6); roborock.vacuum.a08 (Roborock S6 Pure); roborock.vacuum.a10 (Roborock S6 MaxV); roborock.vacuum.a15 (Roborock S7); roborock.vacuum.a19 (Roborocka S4 Max); roborock.vacuum.a27 (Roborock S7 MaxV); roborock.vacuum.a70 (Roborock S8 Pro Ultra); Viomi map format:; viomi.vacuum.v6 (Viomi Vacuum V2 Pro, … Excerpt saved from the README on 2026-10-23.	README
Xiaomi Robot Vacuum S40C	Works Cloud	Added in Xiaomi vacuum support PR 717 Saved copy Added support for Xiaomi vaccums. ## Known supported vacuums: - xiaomi.vacuum.e101gb - xiaomi.vacuum.ov71gl - xiaomi.vacuum.ov31gl - xiaomi.vacuum.ov81gl If you got another vacuum to work, please tell us Excerpt saved from GitHub on 2026-10-23.	PR #717 · 2026-02
Viomi v-rvclm26b	Partly works Cloud	Maintainer says should work; user got 'failed to retrieve device' token mismatch Saved copy Checklist - [X] I have updated the integration to the latest version available - [X] I have checked if the vacuum/platform is already requested - [ ] I have sent raw map file to `piotr.machowski.dev [at] gmail.com` (Retrieving map; please provide your GitHub username in the email) ### What vacuum model do you want to be supported? viomi.vacuum.v6 ### What is its name? v-rvclm26b ### Available APIs - [ ] xiaomi - [ ] viomi - [ ] roidmi - [ ] dreame ### Errors shown in the HA logs (if applicable) [code] ### Other info _No response_ Excerpt saved from GitHub on 2026-10-23.	Issue #497 · 2023-12
Xiaomi Robot Vacuum 5 Pro	Partly works Cloud	Maps show with v3 alpha; room IDs all 0 due to firmware quirk; PRs open Saved copy Problem On some Xiaomi models (confirmed: `xiaomi.vacuum.ov21gl` / Xiaomi Robot Vacuum 5 Pro), every entry in `map_room_info` has `room_id=0` due to a firmware quirk. The `vacuum_map_parser_xiaomi` library uses `room_id` as a dict key, so all rooms overwrite each other and collapse into a single `Room` object, resulting in 1 room instead of the actual 14. Additionally, the library does not parse `fb_regions` (no-go zones), `fb_walls` (virtual walls), or `ai_obj` (AI-detected obstacles) from the JSON payload. Finally, when the vacuum's LAN is temporarily unreachable (e.g. during active … Excerpt saved from GitHub on 2026-10-23.	PR #748 · 2026-06
Xiaomi Robot Vacuum S20+	Partly works Cloud	Map didn't refresh while cleaning; fix PR open Saved copy Related to #563 Two things on the S20+ (xiaomi.vacuum.b108gl): - Status 4 is "working" on this model (see miot-spec), but the default `idle_at` treats it as idle, so the map never updated during a clean. Overrode `idle_at` for b108gl. - The cloud map has no robot/path. The robot publishes its position as MIoT 7-4 (`{"position": [x, y, yaw_mrad]}`) and names a trajectory object as 7-2 (zlib, ` ` records). Read both while not docked and merge them into the payload before parsing. Smaller take on what #750 does, with the position format / yaw unit fixed per the feedback there. Running it on my … Excerpt saved from GitHub on 2026-10-23.	PR #781 · 2026-10
Xiaomi Robot Vacuum S40	Partly works Cloud	Supported in 2026-02 parser PR but users still report errors Saved copy Same error for: Xiaomi Robot Vacuum S40C > > the integration _Xiaomi Miot_ detects it as a different type Xiaomi Robot Vacuum S40C https://home.miot-spec.com/s/xiaomi.vacuum.e101gb > > 2025-12-31 18:57:08.485 ERROR (SyncWorker_7) [custom_components.xiaomi_cloud_map_extractor.camera] Unable to log in, check credentials 2025-12-31 18:57:08.591 WARNING (SyncWorker_7) [miio.device] Found an unsupported model 'xiaomi.vacuum.e101gb' for class 'RoborockVacuum'. If this is working for you, please open an issue at https://github.com/rytilahti/python-miio/ i got s40c working, the implementation is … Excerpt saved from GitHub on 2026-10-23.	Issue #704 · 2025-12
Dreame p2140p	Not working Cloud	Map fails to load, unsupported model error; closed not planned Saved copy … have updated the integration to the latest version available - [X] I have checked if the problem is already reported ### The problem Doesn't work for dreame.vacuum.p2140p. Unable to load the map ### What version of an integration has described problem? v2.2.0 ### What was the last working version of an integration? _No response_ ### What vacuum model do you have problems with? dreame.vacuum.p2140p ### What version of Home Assistant do you use? Home Assistant 2023.5.3 ### What type of installation are you running? Home Assistant OS ### Camera's configuration [code] ### Errors shown in the HA … Excerpt saved from GitHub on 2026-10-23.	Issue #438 · 2023-05
Valetudo vacuums	Requested Local	PR to use local Valetudo map source was closed unmerged Saved copy This PR adds the ability to use valetudo robots as source for map data instead of the Xiaomi cloud. It accepts a valetudo camera entity and extracts the map data from the camera's image. Implemented and working: - Drawing rooms and walls - Drawing map objects (vacuum, charger, zones, ...) - Drawing the vacuum's path Open TODOs: - [ ] Trimming does not work correctly, the map is trimmed but the map objects are positioned wrongly - [ ] Scaling does not work correctly, the map is scaled but the map objects are positioned wrongly - [x] Image generation performance, using Numpy sped things up … Excerpt saved from GitHub on 2026-10-23.	PR #408 · 2023-02
Xiaomi Mijia Robot Vacuum Mop 5 Pro	Requested Cloud	ov21gl reported working on v3 alpha-24; ijai.vacuum.v3 still fails Saved copy Checklist - [x] I have updated the integration to the latest version available - [x] I have checked if the vacuum/platform is already requested - [ ] I have sent raw map file to `piotr.machowski.dev [at] gmail.com` (Retrieving map; please provide your GitHub username in the email) ### What vacuum model do you want to be supported? xiaomi.vacuum.ov21cn ### What is its name? Xiaomi Mijia Robot Vacuum Mop 5 Pro OV21-CN ### Available APIs - [ ] xiaomi - [ ] viomi - [ ] roidmi - [ ] dreame ### Errors shown in the HA logs (if applicable) ```shell Unexpected error fetching xiaomi_cloud_map_extractor … Excerpt saved from GitHub on 2026-10-23.	Issue #657 · 2025-10
Xiaomi Robot Vacuum X20+	Requested Cloud	Support requested; X20 Max map works on v3 alpha, c102gl map not showing Saved copy Checklist - [x] I have updated the integration to the latest version available - [x] I have checked if the vacuum/platform is already requested - [x] I have sent raw map file to `piotr.machowski.dev [at] gmail.com` (Retrieving map; please provide your GitHub username in the email) ### What vacuum model do you want to be supported? Xiaomi Robot Vacuum X20+ ### What is its name? Xiaomi Robot Vacuum X20+ ### Available APIs - [ ] xiaomi - [x] viomi - [x] roidmi - [x] dreame ### Errors shown in the HA logs (if applicable) ```shell 2026-01-05 15:04:17.192 INFO (MainThread) … Excerpt saved from GitHub on 2026-10-23.	Issue #707 · 2026-01

Gathered from GitHub issues, pull requests, discussions and docs, and from r/homeassistant. These are individual reports, so check the linked thread and the date before you buy.

How it connects

Cloud polling

Goes through the maker’s cloud, asking it for updates every so often. Needs the internet and an account.

Details

Installs (analytics)	3,406 (0.48%)
GitHub stars	1,435
Latest version	v2.2.5 (2026-02-20)
Set up in the UI	No, YAML
Maintainers	@PiotrMachowski
License	MIT

Devices listed in its README

Xiaomi map format:
rockrobo.vacuum.v1 (Xiaomi Vacuum Gen 1, Mi Robot Vacuum, SDJQR01RR, SDJQR02RR)
roborock.vacuum.m1s (Xiaomi Mi Robot 1S)
roborock.vacuum.s4 (Roborock S4)
roborock.vacuum.s5 (Roborock S5)
roborock.vacuum.s5e (Roborock S5 Max)
rockrobo.vacuum.s6 (Roborock S6)
roborock.vacuum.a08 (Roborock S6 Pure)
roborock.vacuum.a10 (Roborock S6 MaxV)
roborock.vacuum.a15 (Roborock S7)
roborock.vacuum.a19 (Roborocka S4 Max)
roborock.vacuum.a27 (Roborock S7 MaxV)
roborock.vacuum.a70 (Roborock S8 Pro Ultra)
Viomi map format:
viomi.vacuum.v6 (Viomi Vacuum V2 Pro, Xiaomi Mijia STYJ02YM, Mi Robot Vacuum Mop Pro)
viomi.vacuum.v7 (Mi Robot Vacuum-Mop Pro)
viomi.vacuum.v8 (Mi Robot Vacuum-Mop Pro)
viomi.vacuum.v13 (Viomi V3)
Roidmi map format:
roidmi.vacuum.v60 (Roidmi EVE Plus)
viomi.vacuum.v18 (Viomi S9)
viomi.vacuum.v38 (Viomi V5 Pro)
zhimi.vacuum.xa1 (Lydsto R1)
chuangmi.vacuum.hmi707 (IMILAB V1 Vacuum)
Dreame map format:
dreame.vacuum.mc1808 (Xiaomi Mi Mop/Xiaomi Mijia 1C)
dreame.vacuum.p2008 (Dreame F9)
dreame.vacuum.p2009 (Dreame D9)
dreame.vacuum.p2028 (Dreame Z10 Pro)
dreame.vacuum.p2029 (Dreame L10 Pro)
dreame.vacuum.p2036 (Trouver LDS Cleaner)
dreame.vacuum.p2041o (Xiaomi Mop 2 Pro+)
dreame.vacuum.p2140 (Mijia Robot Vacuum-Mop 2C)
dreame.vacuum.p2157 (MOVA L600)
dreame.vacuum.p2259 (Dreame D9 Max)

Notable forks

Forks with stars, or with code pushed at least 90 days after the original’s last push. Useful when the original goes quiet.

Fork	Stars	Last push	Description
maksp86/HA-custom-components-Xiaomi-Cloud-Map-Extractor-Ijai-Support	★ 15	2026-02-15	This custom integration provides a way to present a live view of a map for Xiaomi (Roborock/Viomi/Roidmi/Dreame/Ijai) vacuums without a need for rooting.
vit9696/Home-Assistant-custom-components-Xiaomi-Cloud-Map-Extractor Newer code	★ 1	2026-10-18	This custom integration provides a way to present a live view of a map for Xiaomi (Roborock/Viomi/Roidmi/Dreame) vacuums without a need for rooting.

In ReReHome

Whatever HomeKit Bridge shares reaches Apple Home as normal HomeKit accessories behind your Home Assistant bridge, so ReReHome shows and controls them like any other.

Bridges get their own settings page listing the accessories behind them.