Ecovacs Deebot

In diesem Beitrag zeige ich euch, wie ihr euren Ecovacs Deebot zu Home Assistant hinzufügen und steuern könnt.

Habt ihr Fragen oder Anregungungen, könnt ihr mir diese gerne in den Kommentaren schreiben. Ich freue mich auf eure Kommentare.

Deebot 4 Home Assistant

Die Integration Deebot 4 Home Assistant (https://github.com/DeebotUniverse/Deebot-4-Home-Assistant) ist herunterzuladen. Für das Dashboard werden folgende Karten aus dem HACS benötigt.

• Vacuum Card (https://github.com/denysdovhan/vacuum-card)
• Button Card (https://github.com/custom-cards/button-card)

*

Quelltext

Der folgende Quelltext ist an die entsprechenden Stellen in Home Assistant zu kopieren. Der Code des Deebot Universe Projekts (https://deebot.readthedocs.io/integrations/home-assistant/examples/ui/advanced/) wurde an die Home Assistant Version 2022.9 angepasst. Vielen Dank für die Programmierung. Wichtig! Die xxx sind durch den Namen eures Ecovacs Deebot abzuändern.

Configurations.yaml

Für die Datei Configuration.yaml benötigt ihr folgenden Code.

#deebot
recorder:
  exclude:
    entities:
      - input_text.deebot_xxx_queue
      - script.deebot_room_queue
    entity_globs:
      - sensor.deebot_*_queue_*

input_text:
  deebot_xxx_queue:
    name: xxx Raum Reihenfolge
    max: 255 # Current max limit. See https://www.home-assistant.io/integrations/input_text/#max

# Room name comes from the integration to match attribute names
template:
  unique_id: deebot_xxx_queue
  trigger:
    - platform: state
      entity_id: input_text.deebot_xxx_queue
  sensor:
    # Add for each room the following. Change room_name accordingly
    - unique_id: deebot_xxx_queue_living_room
      name: deebot_xxx_queue_living_room
      # room_name must match the room name provided by the vacuum
      state: >
        {% set room_name = "living_room" %}
        {% set queue = trigger.to_state.state.split(",") %}
        {{ queue.index(room_name)+1 if room_name in queue else 0 }}

Wichtig! Die xxx sind durch den Namen eures Ecovacs Deebot abzuändern. Im fettgedruckten Bereich sind die einzelnen Zimmer (deebot – Attribute) einzutragen.

Automations.yaml

In der Automations.yaml ist folgender Code einzutragen.

- alias: Staubsauger Zimmer resetieren
  description: ''
  trigger:
  - platform: event
    event_type: deebot_cleaning_job
    event_data:
      status: finished
  condition: []
  action:
  - service: input_text.set_value
    alias: Reset room queue
    data: {}
    target:
      entity_id: input_text.deebot_xxx_queue
  mode: single

Wichtig! Die xxx sind durch den Namen eures Ecovacs Deebot abzuändern.

Scripts.yaml

In der Datei Scripts.yaml ist folgender Code einzufügen.

deebot_room_queue:
  alias: deebot_room_queue
  description: Add/Remove a room from the queue
  variables:
    queue: input_text.deebot_xxx_queue
  fields:
    queue:
      description: The queue variable
      example: input_text.deebot_xxx_queue
    room:
      description: Room, which should be removed or added
      example: kueche
  sequence:
  - service: input_text.set_value
    target:
      entity_id: '{{ queue }}'
    data:
      value: "{%- set queue_state = states(queue) -%}\n{%- set queue_split = queue_state.split(\",\")
        -%}\n{%- if queue_state | length == 0 -%}\n  {{ room }}\n{%- elif room in
        queue_split -%}\n  {{ queue_split | reject(\"eq\", room) | list | join(\",\")}}\n{%-
        else -%} \n  {{ (queue_split + [room]) | join(\",\") }}  \n{%- endif -%}"
  mode: single

deebot_clean:
  alias: deebot_clean
  variables:
    queue: input_text.deebot_xxx_queue
    vacuum_bot: vacuum.xxx
  sequence:
  - alias: get room numbers
    variables:
      rooms: "{%- set queue_split = states(queue).split(\",\") -%}\n{%- set rooms
        = state_attr(vacuum_bot, \"rooms\")-%}\n{%- set data = namespace(rooms=[])
        -%}\n{%- for room_name in queue_split -%}\n  {%- set data.rooms = data.rooms
        + [rooms[room_name]] -%}\n{%- endfor -%}\n{{ data.rooms | join(\",\") }}"
  - alias: Send cleaning job to vacuum
    service: vacuum.send_command
    data:
      command: spot_area
      params:
        rooms: '{{ rooms }}'
        cleanings: 1
      entity_id: '{{ vacuum_bot }}'
  mode: single

Wichtig! Die xxx sind durch den Namen eures Ecovacs Deebot abzuändern.

RAW-Konfigurationsdatei

In den RAW-Konfigurationseditor ist folgender Code einzufügen.

button_card_templates:
  vacuum_service:
    color: var(--text-color)
    entity: vacuum.xxx # change me
    tap_action:
      action: call-service
      service_data:
        entity_id: vacuum.xxx # change me
    lock:
      enabled: |
        [[[ return variables.enabled ]]]
      exemptions: []
    styles:
      card:
        - height: 80px
      lock:
        - color: var(--primary-text-color)
    state:
      - operator: template
        value: |
          [[[ return variables.enabled ]]]
        styles:
          card:
            - color: var(--disabled-text-color)
  vacuum_room:
    color: var(--text-color)
    variables:
      # change me
      lock_enabled: >
        [[[ return ['cleaning', 'paused'].includes(states['vacuum.xxx'].state)
        ]]]
    state:
      - operator: template
        value: |
          [[[ return variables.lock_enabled && entity.state == 0 ]]]
        styles:
          card:
            - color: var(--disabled-text-color)
      - styles:
          card:
            - background-color: var(--primary-color)
        operator: ">="
        value: 1
    styles:
      card:
        - font-size: 12px
      grid:
        - position: relative
      custom_fields:
        order:
          - display: |
              [[[
                if (entity.state == "0")
                  return "none";
                return "block";
              ]]]
          - position: absolute
          - left: 5%
          - top: 5%
          - height: 20px
          - width: 20px
          - font-size: 20px
          - font-weight: bold
          - line-height: 20px
    custom_fields:
      order: |
        [[[ return entity.state ]]]
    tap_action:
      action: call-service
      service: script.deebot_room_queue
      service_data:
        queue: input_text.deebot_xxx_queue
    lock:
      enabled: |
        [[[ return variables.lock_enabled ]]]
      exemptions: []

Wichtig! Die xxx sind durch den Namen eures Ecovacs Deebot abzuändern.

Dashboard Code

Bei einer manuellen Karte ist folgender Code einzufügen.

type: vertical-stack
cards:
  - type: custom:vacuum-card
    entity: vacuum.xxx # change me
    stats:
      default:
        - entity_id: sensor.xxx_life_span_brush # change me
          unit: "%"
          subtitle: Hauptbürste
        - entity_id: sensor.xxx_life_span_side_brush # change me
          unit: "%"
          subtitle: Seitenbürsten
        - entity_id: sensor.xxx_life_span_filter # change me
          unit: "%"
          subtitle: Filter
      cleaning:
        - entity_id: sensor.xxx_stats_area # change me
          unit: m²
          subtitle: Geputzte Fläche
        - entity_id: sensor.xxx_stats_time # change me
          unit: Minuten
          subtitle: Reinigungsdauer
    show_status: true
    show_toolbar: false
    compact_view: true
  - type: custom:button-card
    color: auto-no-temperature
    name: Räume zum Putzen auswählen
    styles:
      card:
        - font-size: 18px
        - height: 30px
      name:
        - color: var(--primary-color)
  - type: horizontal-stack
    cards:
      # Add the following chard for each room. Change values accordingly
      - type: custom:button-card
        template: vacuum_room
        entity: sensor.deebot_xxx_queue_living_room # change me
        icon: mdi:sofa
        name: Wohnzimmer
        tap_action:
          service_data:
            room: living_room # change me

  - type: horizontal-stack
    cards:
      - type: conditional
        conditions:
          - entity: vacuum.xxx # change me
            state_not: cleaning
          - entity: vacuum.xxx # change me
            state_not: paused
        card:
          type: custom:button-card
          template: vacuum_service
          icon: mdi:play
          name: Start
          tap_action:
            action: call-service
            service: script.deebot_clean
          variables:
            # change me
            enabled: |
              [[[ 
                return ((!states['input_text.deebot_xxx_queue'].state || 
                    states['input_text.deebot_xxx_queue'].state.length === 0)
                    && ['docked', 'idle', 'error', 'returning'].includes(entity.state))
              ]]]
      - type: conditional
        conditions:
          - entity: vacuum.xxx # change me
            state: cleaning
        card:
          type: custom:button-card
          color: auto
          icon: mdi:pause
          name: Pause
          tap_action:
            action: call-service
            service: vacuum.pause
            service_data:
              entity_id: vacuum.xxx # change me
          styles:
            card:
              - height: 80px
              - background-color: var(-color)
      - type: conditional
        conditions:
          - entity: vacuum.xxx # change me
            state: paused
        card:
          type: custom:button-card
          color: auto
          icon: mdi:play-pause
          name: Weiter
          tap_action:
            action: call-service
            service: vacuum.start
            service_data:
              entity_id: vacuum.xxx # change me
          styles:
            card:
              - height: 80px
              - background-color: var(-color)
      - type: custom:button-card
        template: vacuum_service
        icon: mdi:stop
        name: Stop
        tap_action:
          service: vacuum.stop
        variables:
          enabled: |
            [[[ 
              return !(['cleaning', 'paused', 'returning'].includes(entity.state))
            ]]]
  - type: horizontal-stack
    cards:
      - type: custom:button-card
        template: vacuum_service
        icon: mdi:home-map-marker
        name: Zurück zur Ladestation
        tap_action:
          service: vacuum.return_to_base
        variables:
          enabled: |
            [[[ 
              return ['docked', 'returning'].includes(entity.state)
            ]]]
      - type: custom:button-card
        color: auto
        icon: mdi:map-marker
        name: Lokalisieren
        tap_action:
          action: call-service
          service: vacuum.locate
          service_data:
            entity_id: vacuum.xxx # change me
        styles:
          card:
            - height: 80px
            - background-color: var(-color)
  - type: picture-entity
    entity: camera.xxx_live_map # change me
    tap_action:
      action: none
    hold_action:
      action: none
    show_state: false
    show_name: false

Wichtig! Die xxx sind durch den Namen eures Ecovacs Deebot abzuändern. Im fettgedruckten Bereich sind die einzelnen Zimmer (deebot – Attribute) einzutragen.

Benutzerdefinierte Fläche

Über den Helfer wird eine Taste erstellt. Im Anschluss wird eine Automatisierung mit folgendem Inhalt erstellt.

Die für die Automatisierung benötigten Koordinaten müssen aus der Logdatei ausgelesen werden. Hierzu ist in die Configuration.yaml folgender Code einzutragen:

logger:
  logs:
    homeassistant.components.vacuum: debug
    custom_components.deebot: debug
    deebot_client: debug

Im Anschluss eines Neustarts von Home Assistant ist über die Ecovacs App der gewünschte Bereich zu saugen. Mit Fertigstellung des Vorgangs werden die Koordinaten in die Logdatei geschrieben. Hierzu ist unter Einstellungen -> System -> Logs die vollständige Logdatei aufzurufen. Nun muss hier nach dem Eintrag deebot_cleaning_job gesucht werden. Die Koordinaten stehen in eckigen Klammern in der Logdatei.

* Die mit Sternchen markierten Links sind sogenannte „Affiliate-Links“. Als Amazon-Partner verdiene ich an qualifizierten Verkäufen. Wird über diese ein Einkauf getätigt, werde ich mit einer kleinen Provision beteiligt – ohne das Kosten für dich entstehen. Vielen Dank für deinen Support!