Skip to content

Latest commit

 

History

History
124 lines (94 loc) · 3.4 KB

alOneHassXiaomiMiot.md

File metadata and controls

124 lines (94 loc) · 3.4 KB

Xiaomi MIoT

Integration's documentation

This platform can be used to control vacuums connected to Home Assistant using Xiaomi MIoT integration created by @al-one.

There is no single configuration that works for all vacuum models: every vacuum has to be configured individually. Here you can find a list of config for different vacuum models (related discussion).

Used service: xiaomi_miot.call_action.

Available templates

  • Room cleaning (vacuum_clean_segment)

    Uses IDs to clean specific rooms. Requires predefined_selections to be provided.

    Configuration generator

    Getting coordinates

    Example configuration
    map_modes:
      - template: vacuum_clean_segment
        predefined_selections:
          - id: 14
            outline: [[ 21458, 32131 ], [ 24235, 32152 ], [ 24194, 27409 ], [ 23181, 27409 ]]
            label:
              text: "Bedroom"
              x: 22932
              y: 30339
              offset_y: 35
            icon:
              name: "mdi:bed"
              x: 22932
              y: 30339
          - id: 19
            outline: [[ 21478, 27237 ], [ 23048, 27250 ], [ 23061, 25655 ], [ 21478, 25680 ]]
            label:
              text: "Bathroom"
              x: 22282
              y: 26496
              offset_y: 35
            icon:
              name: "mdi:shower"
              x: 22282
              y: 26496
    Example video
    ROOM.mp4
  • Zone cleaning (vacuum_clean_zone)

    Uses 4 coordinates to clean rectangular zones.

    Example configuration
    map_modes:
      - template: vacuum_clean_zone
    Example video
    MANUAL_RECTANGLE.mp4
  • Predefined zone cleaning (vacuum_clean_zone_predefined)

    Uses 4 coordinates to clean rectangular zones that have been defined in the configuration. Requires predefined_selections to be provided.

    Getting coordinates

    Example configuration
    map_modes:
      - template: vacuum_clean_zone_predefined
        predefined_selections:
          - zones: [[ 21485, 28767, 24236, 32131 ], [ 23217, 27379, 24216, 28737 ]]
            label:
              text: "Bedroom"
              x: 22932
              y: 30339
              offset_y: 35
            icon:
              name: "mdi:bed"
              x: 22932
              y: 30339
          - zones: [[ 27782, 27563, 29678, 29369 ]]
            label:
              text: "Kitchen"
              x: 28760
              y: 28403
              offset_y: 35
            icon:
              name: "mdi:pot-mix"
              x: 28760
              y: 28403
    Example video
    PREDEFINED_RECTANGLE.mp4