Visão Geral do Projeto

O Deebot 4 Home Assistant é uma integração de código aberto que conecta aspiradores robóticos da linha Ecovacs Deebot à plataforma de automação residencial Home Assistant. Com ele, é possível controlar o equipamento diretamente pela interface do HA, monitorar o status em tempo real e visualizar o mapa de limpeza dinamicamente.

Estrutura de Diretórios

O projeto segue o padrão convencional de extensões Python para Home Assistant. Os principais elementos são:

• README.md — documentação inicial e instruções rápidas de instalação.
• cfgsetup/ — utilitários e scripts auxiliares para preparação da configuração.
• translations/ — arquivos de localização para suporte multilíngue.
• schema.json e translations schema.json — esquemas JSON que validam a integridade dos parâmetros infomrados pelo usuário.
• Pacote principal — contém os módulos responsáveis pela comunicação com a API da Ecovacs e pela implementação da entidade vacuum no Home Assistant.

Mecanismo de Inicialização

Por se tratar de uma integração customizada, não existe um ponto de entrada executável autônomo. O carregamento ocorre automaticamente quando o Home Assistant processa suas integrações durante a inicialização do núcleo. Para habilitá-la, basta registrar a plataforma no arquivo configuration.yaml conforme o exemplo abaixo:

# configuration.yaml
vacuum:
  - platform: deebot_4_home_assistant
    username: seu_email@exemplo.com
    password: "sua_senha_secreta"
    country: "br"
    continent: "ww"

Após salvar o arquivo, reinicie o Home Assistant para que a nova integração seja detectada e os dispositivos vinculados à conta apareçam automaticamente.

Parâmetros de Configuração

A seção vacuum aceita um conjunto de propriedades que definem como o plugin se autentica e se comunica com os servidores da Ecovacs:

• platform — obrigatório, deve ser deebot_4_home_assistant.
• username / password — credenciais da conta Ecovacs utilizadas no aplicativo móvel oficial.
• country — código de duas letras do país (ex.: br, us).
• continent — código do continente correspondente (ww para mundial, eu para Europa).

Um exemplo mais completo, incluindo ajustes opcionais:

# configuration.yaml
vacuum:
  - platform: deebot_4_home_assistant
    username: usuario@exemplo.com
    password: "minha_senha"
    country: "br"
    continent: "ww"
    live_map: true
    show_rooms: true

Os parâmetros live_map e show_rooms ativam, respectivamente, a renderização do mapa de limpeza em tempo real e a divisão visual por cômodos detectados pelo robô.

Recomenda-se sempre consultar o README.md presente no repositório oficial, pois novos recursos e mudanças nos campos aceitos podem ser introduzidos a cada versão.