Skip to content

Commit 8b2d357

Browse files
committed
Document map rotation select entity in README
Add documentation for the per-map rotation select entity. Explains: - How to rotate maps (0/90/180/270) - Where to find the rotation select entity - That calibration points are rotated as well - That no reload is required Also clarifies usage with Xiaomi Vacuum Map Card.
1 parent b0f120c commit 8b2d357

1 file changed

Lines changed: 20 additions & 0 deletions

File tree

README.md

Lines changed: 20 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -26,6 +26,26 @@ map_source:
2626
calibration_source:
2727
camera: true
2828
```
29+
### Map rotation (new)
30+
31+
If your map is displayed sideways or upside down, you can rotate the map directly in Home Assistant.
32+
33+
This integration provides a **Select entity per map** to control rotation:
34+
- `select.<...>_rotation`
35+
- Options: `No rotation`, `Rotate 90°`, `Rotate 180°`, `Rotate 270°` (labels depend on your HA language)
36+
37+
This rotates **both**:
38+
- the map image
39+
- and the calibration points used by the Xiaomi Vacuum Map Card
40+
(so rooms/zones and interactions stay aligned after rotation)
41+
42+
**How to use**
43+
1. Go to **Settings → Devices & services → Roborock Custom Map**
44+
2. Open the device/entities list
45+
3. Find the `… rotation` select entity for your map and choose the correct rotation
46+
47+
No reload is required; the map updates immediately.
48+
2949
6. You can hit Edit on the card and then 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'
3050

3151
### Installation

0 commit comments

Comments
 (0)