Skip to content

Latest commit

 

History

History
191 lines (143 loc) · 4.85 KB

tykarolViomiVacuumV8.md

File metadata and controls

191 lines (143 loc) · 4.85 KB
Raw

Viomi Vacuum V8 by @tykarol

Integration's documentation

This platform can be used to control vacuums connected to Home Assistant using Viomi Vacuum V8 integration created by @tykarol.

Available templates

  • Room cleaning (vacuum_clean_segment)

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

    Configuration generator

    Getting coordinates

    Used service: viomi_vacuum_v8.clean_segment

    Example configuration 
    map_modes:
  - template: vacuum_clean_segment
    predefined_selections:
      - id: 14
        outline: [[ 2.1458, 3.2131 ], [ 2.4235, 3.2152 ], [ 2.4194, 2.7409 ], [ 2.3181, 2.7409 ]]
        label:
          text: "Bedroom"
          x: 2.2932
          y: 3.0339
          offset_y: 35
        icon:
          name: "mdi:bed"
          x: 2.2932
          y: 3.0339
      - id: 19
        outline: [[ 2.1478, 2.7237 ], [ 2.3048, 2.7250 ], [ 2.3061, 2.5655 ], [ 2.1478, 2.5680 ]]
        label:
          text: "Bathroom"
          x: 2.2282
          y: 2.6496
          offset_y: 35
        icon:
          name: "mdi:shower"
          x: 2.2282
          y: 2.6496
    Example video
    ROOM.mp4

  • Zone cleaning (vacuum_clean_zone)

    Uses 4 coordinates to clean rectangular zones.

    Used service: viomi_vacuum_v8.clean_zone

    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

    Used service: viomi_vacuum_v8.clean_zone

    Example configuration 
    map_modes:
  - template: vacuum_clean_zone_predefined
    predefined_selections:
      - zones: [[ 2.1485, 2.8767, 2.4236, 3.2131 ], [ 2.3217, 2.7379, 2.4216, 2.8737 ]]
        label:
          text: "Bedroom"
          x: 2.2932
          y: 3.0339
          offset_y: 35
        icon:
          name: "mdi:bed"
          x: 2.2932
          y: 3.0339
      - zones: [[ 2.7782, 2.7563, 2.9678, 2.9369 ]]
        label:
          text: "Kitchen"
          x: 2.8760
          y: 2.8403
          offset_y: 35
        icon:
          name: "mdi:pot-mix"
          x: 2.8760
          y: 2.8403
    Example video
    PREDEFINED_RECTANGLE.mp4

  • Cleaning a specified point (vacuum_clean_point)

    Uses a pair of coordinates for vacuum to clean a user-specified point.

    Used service: viomi_vacuum_v8.clean_point

    Example configuration 
    map_modes:
  - template: vacuum_clean_point
    Example video
    MANUAL_POINT.mp4

  • Cleaning a predefined point (vacuum_clean_point_predefined)

    Uses a pair of coordinates for vacuum to clean a point that has been defined in the configuration. Requires predefined_selections to be provided.

    Getting coordinates

    Used service: viomi_vacuum_v8.clean_point

    Example configuration 
    map_modes:
  - template: vacuum_clean_point_predefined
    predefined_selections:
      - position: [ 2.8006, 2.8036 ]
        label:
          text: "Emptying"
          x: 2.8006
          y: 2.8036
          offset_y: 35
        icon:
          name: "mdi:broom"
          x: 2.8006
          y: 2.8036
      - position: [ 3.2143, 2.6284 ]
        label:
          text: "Sofa"
          x: 3.2143
          y: 2.6284
          offset_y: 35
        icon:
          name: "mdi:sofa"
          x: 3.2143
          y: 2.6284
    Example video
    PREDEFINED_POINT.mp4