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 ligado a esta entrada, expondo as entidades, serviços e dados de mapa do aspirador. As opções de configuração permitem o acesso às definições por dispositivo, permitindo que o comportamento de cada entrada de integração seja personalizado de forma independente.

Estas definições podem ser acedidas imediatamente durante o processo inicial de configuração, como o passo final após completar a configuração do tipo de ligação selecionado (logo antes de o dispositivo ser adicionado ao Home Assistant). 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 Aspirador Dreame. Quando é introduzida uma chave válida, a integração ativa automaticamente o cartão personalizado incorporado e torna-o disponível entre os cartões personalizados no painel. Se for introduzida uma chave inválida, o cartão permanecerá em modo de pré-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 tenha sido ativada, fica permanentemente associada a esse dispositivo específico e não pode ser usada para ativar o cartão em qualquer outro dispositivo.

Nota

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

Notificações

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

• Limpeza Concluída (cleanup_completed): Gerado sempre que uma tarefa de limpeza termina com sucesso.
• Consumível (consumable): Gerado quando a vida útil de um consumível está a acabar ou quando um componente necessita de manutenção.
• Informação (information): Gerado para eventos gerais de informação e atualizações de estado.
• Aviso (warning): Gerado quando o dispositivo encontra erros que podem ser resolvidos ou problemas menores.
• Erro (error): Gerado quando o dispositivo apresenta uma falha crítica ou um erro de hardware.

Mais sobre a funcionalidade de notificações

Aplicação Companheira

Por predefinição, as notificações persistentes são apenas exibidas no painel do Home Assistant. Não podem ser enviadas diretamente para a App Companion do Home Assistant num dispositivo móvel, porque é necessário um ID de dispositivo de notificação específico. Para receber notificações push num dispositivo móvel, deve ser criado um automação personalizada que ouça os eventos da integração ou monitorize as notificações persistentes geradas, e depois as encaminhe para o dispositivo móvel específico.

Opções de Visualização do Mapa Suporte de Mapa

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

Cartão Aspirador Dreame

As definições abaixo aplicam-se apenas à entidade de câmara do mapa gerada. O Cartão Aspirador Dreame apresenta nativamente o seu próprio mapa e pode substituir 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, pelo que é altamente recomendada a ativação de Imagem do Mapa em Baixa Resolução para poupar memória.

Esquema de cores

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

• Dreame Light (dreame_light): Tema da aplicação oficial Dreame.
• Dreame Dark (dreame_dark): Tema escuro exclusivo da integração dreame_vacuum.
• Mijia Light (mijia_light): Tema claro da aplicação oficial Xiaomi Mi Home.
• Mijia Dark (mijia_dark): Tema escuro da aplicação oficial Xiaomi Mi Home.
• Escala de Cinzentos (grayscale): Um tema de mapa monocromático e sem cor.
• Transparente (transparent): Gera o chão, paredes e preenchimentos das divisões totalmente transparentes, útil para sobrepor o mapa sobre um fundo personalizado.

Veja os esquemas de cores disponíveis em Suporte de Mapas

Conjunto de ícones

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

• Dreame (dreame): Conjunto de ícones da aplicação oficial Dreame.
• Dreame Antigo (dreame_old): Conjunto de ícones da aplicação Dreame antiga.
• Mijia (mijia): Conjunto de ícones da aplicação 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. Isto é útil para simplificar o mapa ou ocultar informações que não são necessárias para um determinado painel.

Objetos disponíveis

• Cores das Divisões (color): A cor distinta de preenchimento para cada divisão.
• Ícones das Divisões (icon): O ícone da divisão baseado no seu tipo.
• Nomes das Divisões (name): As etiquetas de texto para os nomes das divisões.
• Fundo do Nome da Divisão (name_background): O fundo em forma de cápsula por trás dos nomes das divisões com a sua cor associada.
• Ordem da Sala (order): Os distintivos numerados que indicam a sequência de limpeza.
• Nível de Sucção da Sala (suction_level): O ícone que indica o nível de sucção configurado para a sala.
• Volume de Água da Sala (water_volume): O ícone que indica o volume de água configurado para a sala.
• Tempos de Limpeza da Sala (cleaning_times): O distintivo que indica quantas vezes a sala será limpa.
• Modo de Limpeza da Sala (cleaning_mode): O ícone que indica o modo de limpeza configurado para a sala (varrer, passar o pano ou ambos). (Apenas em dispositivos suportados)
• Modo de Passar o Pano da Sala (mopping_mode): O ícone que indica o tipo de pano configurado para a sala. (Apenas em dispositivos suportados)
• Percurso (path): O percurso que mostra onde o robô limpou.
• Zonas Proibidas (no_go): Zonas restritas.
• Zonas Sem Passar o Pano (no_mop): Zonas de limpeza com pano restritas.
• Paredes Virtuais (virtual_wall): Uma parede virtual adicionada para impedir que o robô atravesse.
• Limiares Virtuais (pathway): Limiares definidos que o robô deve atravessar com cuidado. (Apenas em dispositivos suportados)
• Áreas Ativas (active_area): A caixa de delimitação 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 que representa o próprio robô.
• Direção de Limpeza (cleaning_direction): A seta que indica a direção em que o robô está atualmente a limpar.
• Obstáculo de IA (obstacle): Ícones de obstáculos detetados pela IA, como sapatos e cabos. (Apenas em dispositivos suportados)
• Animal de Estimação (pet): Obstáculos detectados como animal de estimação. (Apenas em dispositivos suportados)
• Área de Tapete (carpet): Textura de tapete. (Apenas em dispositivos suportados)
• Material do Piso (material): A textura do material do chão da divisão, como madeira ou azulejo. (Apenas em dispositivos suportados)
• Áreas Baixas (low_lying_area): Áreas baixas onde o robô entra baixando o seu scanner LiDAR. (Apenas em dispositivos suportados)
• Mobiliário (furniture): Mobiliário 3D ou 2D. (Apenas em dispositivos suportados)
• Rampa (ramp): Rampas colocadas no ambiente. (Apenas em dispositivos suportados)
• Cortina (curtain): Cortinas. (Apenas em dispositivos suportados)
• Pontos de Cruzeiro (cruise_point): Ir para pontos de operação. (Apenas em dispositivos suportados)

Imagem de Mapa Quadrada

Força a imagem da câmara gerada do mapa 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 de Mapa de Baixa Resolução

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

Restrições de Memória

A geração de mapas grandes pode exigir uma quantidade significativa de memória. Se o Home Assistant falhar e reiniciar ao navegar para a página do dispositivo ou ao aceder à entidade da câmara do mapa, é muito provável que se deva a memória insuficiente. Ativar esta opção geralmente resolve o problema.

Nota

Ativar esta opção também desativa a entidade de câmara Mapa WiFi Guardado, uma vez que não está disponível em baixa resolução.

Preferir a Nuvem

Apenas disponível para dispositivos configurados com uma conta Xiaomi Home. Esta definição permite atualizar a preferência originalmente seleccionada durante a etapa de configuração inicial.

• Quando ativado: Obriga toda a comunicação a passar pela nuvem. Isto é necessário para dispositivos mais recentes onde a Xiaomi desativou as capacidades de acesso local, ou quando o dispositivo e o Home Assistant residem em sub-redes diferentes.
• Quando desativado (Recomendado para configurações suportadas): A integração estabelece uma ligação local direta com o dispositivo (enquanto continua a gerir automaticamente os tokens e renovações de IP a partir da cloud). Isto mantém todas as comunicações (excepto os dados do mapa) inteiramente locais.

Testar a Disponibilidade da API Local

Esta opção fornece uma forma muito útil de testar a conectividade local. Para garantir que a configuração inicial do dispositivo é bem-sucedida sem erros, Preferir Cloud 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á-la para voltar à ligação via cloud.

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