Opções de Configuração

No Home Assistant, cada aspirador robô configurado com sucesso é armazenado como uma entrada de integração distinta. Um dispositivo correspondente é automaticamente criado e vinculado a essa entrada, expondo as entidades, serviços e dados de mapa do aspirador. As opções de configuração fornecem acesso às configurações por dispositivo, permitindo que o comportamento de cada entrada de integração seja personalizado de forma independente.

Essas configurações podem ser acessadas imediatamente durante o processo inicial de configuração como a etapa final após concluir a configuração para o tipo de conexão selecionado (logo antes de o dispositivo ser adicionado ao Home Assistant). Elas também podem ser modificadas a qualquer momento posteriormente na página Integrações do Home Assistant clicando no botão Configurar localizado no canto superior direito do cartão do dispositivo.

Chave do Dreame Vacuum Card

Um campo opcional para uma chave de licença Cartão de Aspirador Dreame. Quando uma chave válida é inserida, a integração ativa automaticamente o cartão personalizado incorporado e o torna disponível entre os cartões personalizados no painel. Se uma chave inválida for inserida, o cartão permanecerá no modo de visualização no painel.

Obter chave DVC

Ativação de Dispositivo Único

Cada chave de licença é estritamente limitada a um único dispositivo. Uma vez que uma chave é ativada, ela fica permanentemente vinculada a esse dispositivo específico e não pode ser usada para ativar o cartão em nenhum outro dispositivo.

Nota

Este campo é totalmente opcional. Se deixado vazio, o cartão personalizado incorporado ainda pode ser adicionado a um painel, mas funcionará no modo de visualização. Uma chave válida sempre pode ser adquirida posteriormente diretamente através da interface do cartão no modo de visualização.

Notificações

Selecione quais categorias de notificações persistentes a integração está autorizada a criar para este dispositivo. Desmarcar uma categoria a desativa completamente, mesmo que o evento subjacente do dispositivo ainda ocorra.

• Limpeza Concluída (cleanup_completed): Gerado toda vez que uma tarefa de limpeza é concluída com sucesso.
• Consumível (consumable): Gerado quando a vida útil de um consumível está acabando ou quando um componente requer manutenção.
• Informação (information): Gerado para eventos informativos gerais e atualizações de status.
• Aviso (warning): Gerado quando o dispositivo encontra erros que podem ser corrigidos ou problemas menores.
• Erro (error): Gerado quando o dispositivo apresenta uma falha crítica ou erro de hardware.

Mais sobre o recurso de notificações

App Companion

Por padrão, as notificações persistentes são exibidas apenas dentro do painel do Home Assistant. Elas não podem ser enviadas diretamente para o aplicativo Complementar do Home Assistant em um dispositivo móvel porque é necessário um ID de dispositivo de notificação específico. Para receber notificações push em um dispositivo móvel, um automação personalizada deve ser criado que ouça o eventos da integração ou monitore notificações persistentes geradas, e então as encaminhe para o dispositivo móvel específico.

Opções de Exibição do Mapa Suporte a Mapas

As seguintes configurações estão disponíveis apenas para dispositivos configurados com uma conta na nuvem (DreameHome, MovaHome, TROUVER ou Xiaomi Home), já que todas dependem de dados do mapa:

Cartão de Aspirador Dreame

As configurações abaixo se aplicam apenas à entidade de câmera do mapa gerado. O Cartão de Aspirador Dreame exibe nativamente seu próprio mapa e pode sobrescrever de forma independente o Esquema de Cores e o Conjunto de Ícones através do seu configuração avançada. As opções Imagem do Mapa Quadrado e Imagem do Mapa em Baixa Resolução não têm efeito no cartão personalizado, portanto, habilitar Imagem do Mapa em Baixa Resolução é altamente recomendado para economizar memória.

Esquema de cores

Seleciona a paleta de cores utilizada ao gerar a imagem do mapa.

• Dreame Claro (dreame_light): Tema oficial do aplicativo Dreame.
• Dreame Escuro (dreame_dark): Tema escuro exclusivo da integração dreame_vacuum.
• Mijia Claro (mijia_light): Tema claro oficial do aplicativo Xiaomi Mi Home.
• Mijia Escuro (mijia_dark): Tema escuro oficial do aplicativo Xiaomi Mi Home.
• Escala de Cinza (grayscale): Um tema de mapa monocromático, sem cores.
• Transparente (transparent): Gera o piso, paredes e preenchimentos de cômodos totalmente transparentes, útil para sobrepor o mapa em um fundo personalizado.

Veja os esquemas de cores disponíveis em Suporte ao Mapa

Ícones

Seleciona o estilo de ícone usado para marcadores de mapa, como o robô, carregador e móveis, correspondendo aos conjuntos de ícones dos Apps oficiais.

• Dreame (dreame): Conjunto de ícones do app oficial Dreame.
• Dreame Antigo (dreame_old): Conjunto de ícones do app Dreame legado.
• Mijia (mijia): Conjunto de ícones do app oficial Xiaomi Mi Home.
• Material (material): Ícones Material Design incorporados do Home Assistant.

Objetos de mapa ocultos

Seleciona quais elementos do mapa são excluídos da imagem do mapa gerada. Isso é útil para simplificar o mapa ou ocultar informações que não são necessárias para um determinado painel.

Objetos disponíveis

• Cores dos Cômodos (color): A cor distinta preenchida para cada cômodo.
• Ícones dos Cômodos (icon): O ícone do cômodo baseado em seu tipo.
• Nomes dos Cômodos (name): As etiquetas de texto para os nomes dos cômodos.
• Fundo do Nome do Cômodo (name_background): O fundo em formato de pílula atrás dos nomes dos cômodos com sua cor associada.
• Ordem do Quarto (order): Os distintivos numerados indicando a sequência de limpeza.
• Nível de Sucção do Quarto (suction_level): O ícone indicando o nível de sucção configurado do quarto.
• Volume de Água do Quarto (water_volume): O ícone indicando o volume de água configurado do quarto.
• Tempos de Limpeza do Quarto (cleaning_times): O distintivo indicando quantas vezes o quarto será limpo.
• Modo de Limpeza do Quarto (cleaning_mode): O ícone indicando o modo de limpeza configurado do quarto (varrer, passar pano ou ambos). (Apenas em dispositivos compatíveis)
• Modo de Passar Pano do Quarto (mopping_mode): O ícone indicando o tipo de pano configurado do quarto. (Apenas em dispositivos compatíveis)
• Caminho (path): O caminho mostrando onde o robô limpou.
• Zonas de Proibição (no_go): Zonas restritas.
• Zonas sem Pano (no_mop): Zonas restritas para passar pano.
• Paredes Virtuais (virtual_wall): Uma parede virtual adicionada para impedir o robô de atravessar.
• Limiares Virtuais (pathway): Limiares definidos que o robô deve atravessar com cuidado. (Apenas em dispositivos compatíveis)
• Áreas Ativas (active_area): A caixa delimitadora desenhada durante a limpeza de zonas.
• Pontos Ativos (active_point): Pontos de limpeza localizada mostrando uma área de 1,5m².
• Ícone do Carregador (charger): O ícone da estação base.
• Ícone do Robô (robot): O ícone representando o próprio robô.
• Direção de Limpeza (cleaning_direction): A seta indicando a direção na qual o robô está limpando atualmente.
• Obstáculo AI (obstacle): Ícones de obstáculos detectados pela IA, como sapatos e fios. (Apenas em dispositivos compatíveis)
• Animal de Estimação (pet): Obstáculos detectados como animal de estimação. (Apenas em dispositivos compatíveis)
• Área de Tapete (carpet): Textura de tapete. (Apenas em dispositivos compatíveis)
• Material do Piso (material): A textura do material do piso da sala, como madeira ou azulejo. (Apenas em dispositivos compatíveis)
• Áreas Baixas (low_lying_area): Áreas baixas onde o robô entra abaixando seu scanner LiDAR. (Somente em dispositivos compatíveis)
• Móveis (furniture): Móveis 3D ou 2D. (Somente em dispositivos compatíveis)
• Rampa (ramp): Rampas colocadas no ambiente. (Somente em dispositivos compatíveis)
• Cortina (curtain): Cortinas. (Somente em dispositivos compatíveis)
• Pontos de Cruzeiro (cruise_point): Ir para pontos de operação. (Somente em dispositivos compatíveis)

Imagem do Mapa Quadrada

Força a imagem da câmera do mapa gerada a ter uma proporção quadrada de 1:1 em vez da caixa delimitadora natural do mapa, o que pode ser útil para layouts de painel que esperam uma imagem quadrada.

Imagem do Mapa em Baixa Resolução

Gera a imagem da câmera do mapa em resolução reduzida para diminuir o uso de memória e acelerar as atualizações.

Restrições de Memória

Gerar mapas grandes pode exigir uma quantidade significativa de memória. Se o Home Assistant travar e reiniciar ao navegar para a página do dispositivo ou ao acessar a entidade de câmera do mapa, é muito provável que seja devido à memória insuficiente. Habilitar esta opção geralmente resolverá o problema.

Nota

Habilitar esta opção também desativa a entidade de câmera Mapa WiFi Salvo, pois não está disponível em baixa resolução.

Preferir Nuvem

Disponível apenas para dispositivos configurados com uma conta Xiaomi Home. Esta configuração permite atualizar a preferência selecionada originalmente durante a etapa de configuração inicial.

• Quando habilitado: Força toda a comunicação através da nuvem. Isso é necessário para dispositivos mais novos, nos quais a Xiaomi desativou as capacidades de acesso local, ou quando o dispositivo e o Home Assistant estão em sub-redes diferentes.
• Quando desativado (Recomendado para configurações suportadas): A integração estabelece uma conexão local direta com o dispositivo (enquanto ainda lida automaticamente com a renovação de token e IP da nuvem). Isso mantém todas as comunicações (exceto os dados do mapa) completamente locais.

Testando a Disponibilidade da API Local

Esta opção fornece uma maneira muito útil de testar a conectividade local. Para garantir que a configuração inicial do dispositivo seja bem-sucedida sem erros, Preferir Nuvem pode ser mantida ativada durante o fluxo de configuração. Uma vez que o dispositivo seja adicionado com sucesso ao Home Assistant, esta opção pode ser desativada aqui para verificar se o dispositivo realmente suporta a API local. Se o dispositivo se tornar indisponível após a desativação, basta reativá-lo para retornar à conexão com a nuvem.

YAML Para Referência

dreame_vacuum:
  # Local connection
  host: 192.168.1.100
  token: b2a1c3d4e5f6a7b8c9d0e1f2a3b4c5d6

  # Cloud connection
  username: your@email.com
  password: your_password
  country: de
  prefer_cloud: true # Only available on Xiaomi Home

  # Options available regardless of connection type
  dvc_key: 123e4567-e89b-42d3-a456-426614174000
  notify:
    - information
    - warning
    - error

  # Options available only with map support (Cloud)
  color_scheme: dreame_dark
  icon_set: dreame_old
  hidden_map_objects:
    - name_background
    - name
    - order
  square: true
  low_resolution: true