Se você tem um cortador de grama robótico moderno e já usa o Home Assistant, está a um passo de transformá-lo em um robô ainda mais eficiente. mais uma peça do seu ecossistema de automação residencial Em vez de deixar a função bloqueada no aplicativo oficial, a integração permite que você decida quando e como desligar as luzes: com base no clima, na presença de pessoas no jardim, no excesso de produção de energia solar ou simplesmente na rotina da família.
Neste artigo, veremos, em detalhes e de forma prática, como eles se comportam no Home Assistant. Os principais cortadores de grama inteligentes e suas integrações.Mammotion (Luba/Yuka), Bosch Indego via MQTT, Husqvarna Automower usando sua API oficial, o truque para integrar o Mammotion ao Apple Home como um aspirador de pó via Matter e o que o Home Assistant oferece para quem está começando a pesquisar qual robô comprar. Tudo explicado em espanhol (Espanha) e com muitas ideias práticas de automação.
Quais são os benefícios de integrar um cortador de grama inteligente ao Home Assistant?
Quando o cortador de grama existe apenas no aplicativo, ele permanece em um “silo” completamente desconectado do restante da sua casa inteligente. A integração com o Home Assistant elimina essa compartimentalização e transforma o robô em apenas mais um dispositivo, com entidades, sensores e serviços que você pode usar em automações.
Na prática, isso significa que você pode usar dados como a bateria, o estado de funcionamento, a localização GPS, a zona de corte ou a previsão meteorológica. Para decidir se o robô sai para cortar, retorna à base, interrompe o trabalho ou permanece parado.
Algumas ideias muito comuns que fazem bastante sentido quando você tem o cortador de grama integrado ao Home Assistant são:
- Interrompa o corte se houver previsão de chuva. Utilizando sensores locais ou integrações temporais.
- Evite as horas mais quentes do dia. ou para evitar danos ao gramado, agende o trabalho para o início da manhã ou final da tarde.
- Inicie o desligamento quando houver excedente fotovoltaico., se você monitorar sua produção de energia solar no Home Assistant.
- Bloqueie o robô quando houver pessoas no jardim. (crianças brincando, visitantes no churrasco, portão do jardim aberto, etc.).
- Alinhe o recorte com os calendários da família. para que não atrapalhe reuniões, cochilos ou eventos especiais.
Tudo isso é possível porque, uma vez integrado, o robô expõe sensores (bateria, estado, modo, zona, erros…) e ações (iniciar, pausar, conectar, substituir, etc.) que podem ser combinados com o restante da sua casa inteligente.
Integração dos cortadores de grama Mammotion (Luba e Yuka) no Home Assistant
Os modelos Mammotion (Luba, Yuka e derivados) apresentam uma integração comunitária muito completa que transforma o robô em um... dispositivo nativo “cortador de grama” Dentro do Home Assistant. A partir daí, você pode ler dezenas de sensores e executar comandos de corte avançados.
A grande vantagem dessa integração é que ela extrai dados do cortador de grama, como por exemplo: Nível da bateria, estado de funcionamento, posição GPS, número de satélites, área ativa, tipo de conexão (Wi-Fi/BLE/4G) e outros parâmetros específicos do modelo, além de expor serviços para iniciar, pausar, parar ou enviar o robô de volta à base.
Em relação aos requisitos, é importante ter o Home Assistant. Atualizado para uma versão recente (mínimo 2025.3.0) e incluir o HACS (Home Assistant Community Store), visto que a integração não faz parte do núcleo e é instalada como um repositório personalizado.
O detalhe mais delicado não é técnico, mas sim relacionado à contabilidade: recomenda-se criar uma segunda conta Mammotion exclusiva para o Home AssistantSe você usar a mesma conta principal que já utiliza no aplicativo, corre o risco de sofrer desconexões incômodas no seu dispositivo móvel sempre que o Home Assistant renovar o login.
O fluxo de trabalho típico para preparar essa segunda conta é:
- Crie uma nova conta no aplicativo Mammotion, usando um endereço de e-mail diferente.
- Retorne à sua conta principal e compartilhar o robô com a conta secundária.
- Faça login com a conta secundária, aceite o dispositivo compartilhado e reserve-o exclusivamente para o Home Assistant.
Assim que a seção de contas estiver pronta, a integração é instalada a partir do HACS adicionando o seguinte código: o repositório personalizado "https://github.com/mikey0000/Mammotion-HA" Como integração, o Home Assistant é instalado e reiniciado para que apareça disponível no menu Integrações.
Ao configurar a integração em Configurações → Dispositivos e serviços → Adicionar integração, você pode escolher se deseja conectar o robô via Bluetooth Low Energy (BLE) ou via Wi-Fi/4GSe você usa BLE e o servidor do Home Assistant está longe do jardim, você pode contar com um Proxy Bluetooth com ESPHome (um ESP32 atuando como uma ponte BLE perto do cortador de grama).
Com uma conexão Wi-Fi, que geralmente é a mais conveniente se o jardim for bem coberto, basta entrar o e-mail e a senha da conta secundária A Mammotion e a integração começarão a criar o dispositivo com suas entidades.
Após a instalação, no painel de controle do dispositivo você verá sua Luba/Yuka com controles de corte e uma ampla gama de sensores: bateria, estado atual (cortando, carregando, ocioso…), tipo de conexão, localização, número de satélites, área de trabalho ativa, progresso do corte e muito mais, de acordo com o modelo.
Além dos sensores, a integração expõe serviços muito poderosos, como: mammotion.iniciar_cortar_o_maçoque permite executar um corte parametrizado. Em Ferramentas do Desenvolvedor → Ações, você pode selecionar esse serviço, escolher seu cortador de grama e passar parâmetros como velocidade, modo de trajetória, detecção de obstáculos, altura de corte (nos modelos Luba) ou lista de áreas.
Em muitos casos, existem combinações de parâmetros comuns a toda a gama (por exemplo, velocidade, modos de navegação ou sensibilidade a obstáculos) e outros específicos do Yuka (coleta, bordas, etc.) ou do Luba (altura de corte, diferentes estratégias de mapeamento), permitindo a adaptação. As cenas de corte apresentam um alto nível de detalhes..
Automações úteis com Mammotion e Home Assistant
O verdadeiro salto de qualidade acontece quando você começa a criar. automações que conectam a lógica do cortador de grama com o restante da sua casa inteligente. Ao saber o status, o nível da bateria e a localização, você pode tomar decisões muito mais precisas do que com a programação padrão do aplicativo.
Um exemplo clássico é a reação às condições meteorológicas: se a sua estação meteorológica local, os seus sensores Zigbee externos ou uma integração de previsão detectarem alguma alteração climática, isso pode causar problemas. alta probabilidade de chuva iminenteO Home Assistant pode ordenar que o cortador de grama pare de funcionar e retorne à base antes que o jardim vire lama.
Algo semelhante pode ser feito com temperaturas extremas. Se um sensor externo registrar mais de, por exemplo, 30 °C, você pode atrasar o desligamento para Evite trabalhar sob luz solar direta.tanto para proteger o gramado quanto para cuidar da bateria e dos componentes do robô.
Se você tiver sistemas fotovoltaicos integrados ao Home Assistant, outra funcionalidade de automação muito útil é... aproveitando o excedente de energia solarQuando o sistema detecta que você está exportando energia para a rede (ou que a produção excede um determinado limite), ele aciona o cortador de grama dentro de um período de tempo "aceitável". Dessa forma, grande parte da recarga subsequente do robô é feita com a energia que você produz.
Também é muito comum estabelecer regras de segurança e convivência: se o portão do jardim for aberto, se uma câmera detectar a presença humana ou se você ativar um modo "churrasco" ou "crianças brincando", o sistema pode pausar a poda para evitar surpresas. Dessa forma, o robô deixa de ser... um objeto esquecido no meio do gramado O que pode ser irritante justamente quando você menos espera.
Por fim, a integração dos calendários familiares ao Home Assistant permite evitar que o cortador de grama seja acionado durante reuniões, horários de trabalho remoto ou em horários específicos (por exemplo, se um evento no calendário indicar "soneca do bebê", o robô permanece na base). O cortador de grama, então, se comporta como um cortador de grama convencional. um membro mais coordenado com a rotina da casa.
Na interface do usuário, com todos os sensores e comandos à sua disposição, você pode criar um painel específico para o robô, com cartões animados, botões de controle rápido e uma exibição de status bastante refinada. É comum usar projetos como o HA-Animated-Cards para essa finalidade. Criar cartões visualmente atraentes que mostram em tempo real o progresso do corte ou a área atual.
Se, em algum momento, a integração falhar com erros de tempo limite na API "api.link.aliyun.com", é recomendável verificar o roteador ou firewall. Bloqueando conexões com serviços hospedados na China.Isso pode acontecer com certas políticas de segurança. Além disso, se o processo de configuração da conta rejeitar o endereço de e-mail, o próprio repositório sugere o uso do "número da conta" em vez do e-mail, pois isso funciona melhor em alguns casos.
Controle avançado do Mammoth a partir do Apple Home usando o Matter.
A integração do Mammotion ao Home Assistant expõe o cortador de grama como uma entidade. cortador de gramaO problema é que o Matter, até o momento, não inclui um tipo específico de dispositivo para cortadores de grama, portanto não há um mapeamento direto entre essa entidade e um acessório do Apple Home.
A solução reside em observar que, da perspectiva da automação residencial, um cortador de grama autônomo e um aspirador de pó robótico são gêmeos praticamente funcionaisAmbos cobrem áreas definidas, possuem baterias, zonas, modos de funcionamento, comandos de iniciar/pausar/parar e função "retornar à base".
A especificação da Matter inclui o tipo de dispositivo. Aspirador de pó robótico (0x0074), com clusters para status operacional, modo de limpeza, modo de operação e, muito importante, um cluster serviceArea que se encaixa perfeitamente com as áreas de corte de grama.
O segredo é criá-lo no Home Assistant. uma entidade de vácuo modelo que "envolve" a entidade cortador de grama Mammotion: os comandos iniciar/parar/pausar/retornar à base tornam-se os equivalentes do aspirador de pó, o nível da bateria vem do sensor de bateria do cortador de grama e as zonas são representadas como "salas" do aspirador.
Para configurar tudo isso, você precisa ter a integração do Mammotion funcionando no Home Assistant, o complemento. Central de Assuntos do Assistente Doméstico (de preferência a versão modificada mantida por RiDDiX), um HomePod ou Apple TV recente como central do Apple Home e os botões de zona do cortador de grama disponíveis no Home Assistant (as entidades button.*_zone_* expostas pelo Mammotion).
O primeiro passo é localizar todas as entidades relevantes do robô em Ferramentas de Desenvolvedor → Estados: o arquivo principal lawn_mower.*, os sensores de modo e bateria, os botões de zona, o botão de cancelamento de tarefa e o seletor de modo de percurso. Esses IDs exatos são então usados para construir o arquivo configuration.yaml. um modelo de vácuo que traduz o estado interno de "MODE_WORKING", "MODE_CHARGING", etc., para estados do aspirador de pó, como limpeza, acoplado, pausado ou ocioso.
Esse aspirador de pó modelo também define:
- El nível de bateria Obtendo o valor do sensor da bateria do cortador de grama.
- Os comandos iniciar, parar, pausar e retornar à base são suportados pelos serviços lawn_mower.* e button.* correspondentes.
- Uma lista de "velocidades do ventilador" que é usada para selecionar. a zona de corte (Zona A, Zona B, Zona C…).
- Atributo quartos, que contém em JSON uma matriz de objetos {id, nome} com as diferentes zonas, no formato esperado pelo Matter Hub.
Esse atributo "salas" é fundamental porque a lógica do Matter Hub inclui uma função que, ao detectar esse campo na entidade do aspirador de pó, cria automaticamente o cluster. Área de serviço e preenche as áreas suportadas. Dessa forma, no Apple Home, você acaba vendo cada zona de corte como se fosse um "cômodo" selecionável na interface do aspirador de pó.
Opcionalmente, você pode criar um bloco de modelo dentro do mesmo bloco. selecionar modelo de entidade Isso traduz os diferentes modos de trajetória de corte (grade simples, grade dupla, grade segmentada, sem grade) em nomes mais amigáveis ao usuário, como "Cortar em linhas", "Cortar em ziguezague", "Cortar em grade" ou "Sem grade". Essa seleção é então usada no Matter Hub como uma entidade de modo de limpeza, para que o Apple Home exiba esses nomes em sua interface de aspirador robô.
Após validar e reiniciar o Home Assistant para carregar esses modelos, verificamos se a nova entidade vacuum.* possui o estado correto, se o nível da bateria está preenchido e se o atributo rooms contém o JSON da zona. Com isso em ordem, passamos para a parte do Matter Hub.
Na interface do plugin Matter Hub, uma nova ponte é criada no modo servidor, seu filtro de entidade é limitado ao modelo vacuum e um mapeamento é adicionado indicando que este vacuum.* deve ser exposto como Dispositivo de matéria do tipo aspirador de pó robóticoA entidade de seleção para o modo de corte pode ser vinculada ali, caso já tenha sido criada.
Após reiniciar o acessório e verificar se o endpoint exibe os clusters esperados (incluindo a serviceArea com as áreas suportadas), basta acessar o app Casa da Apple, selecionar "Adicionar Acessório", escanear o código QR do Matter Hub Bridge e concluir o emparelhamento. Feito isso, o cortador de grama aparecerá no app Casa da Apple como Aspirador robô com botões Reproduzir/Pausar/Basear, indicador de porcentagem da bateria, seleção de zona e seleção de modo..
Vale ressaltar algumas limitações: por enquanto, a seleção de áreas no Apple Home é principalmente visual, já que o comando SelectAreas do Matter ainda não está conectado a um serviço genérico do Home Assistant que acione os botões de zona; o modo de corte de grama pode exibir "desconhecido" se o cortador de grama estiver desligado, e quaisquer alterações na definição de cluster ou zona geralmente exigem retirar e reativar o acessório no Apple Home.
Integração do Bosch Indego via MQTT
Os cortadores de grama Bosch Indego não possuem uma integração nativa com o Home Assistant tão completa quanto os da Mammotion ou da Husqvarna, mas existe um projeto muito sólido chamado “Aplicação de controlador e API para Bosch Indego Connect” que fornece acesso à sua API e também inclui um adaptador MQTT perfeito para integração com o Home Assistant.
A ideia é simples: um processo chamado Adaptador IndegoMqtt Ele se conecta à nuvem da Bosch usando suas credenciais e, simultaneamente, publica e recebe informações em seu broker MQTT local. O Home Assistant simplesmente lê esses tópicos MQTT como sensores e envia comandos publicando mensagens em outros tópicos.
Para que o adaptador inicialize automaticamente em um ambiente Linux, é muito comum adicionar uma linha ao cron do sistema com a sintaxe @reboot, por exemplo:
@reboot /home/pi/indego/bin/IndegoMqttAdapter -c /home/pi/indego/IndegoMqttAdapterConfig.properties
O arquivo de configuração IndegoMqttAdapterConfig.properties contém todos os dados confidenciais: o URL base do serviço Indego, o nome de usuário e a senha que você usa no aplicativo oficial, o endereço do broker MQTT (ip:porta), as credenciais do broker, o tópico raiz para mensagens e o intervalo de polling em milissegundos.
Um exemplo típico de tal arquivo inclui campos como indego.mqtt.device.username e password, o parâmetro indego.mqtt.broker.connection apontando para tcp://IP_BROKER:1883, o client-id para distinguir o adaptador, um topic-root do tipo test/device/indego e um polling-interval-ms de cerca de 30000 ms para Atualizar status a cada 30 segundos.
Com o adaptador já publicando estados em MQTT, no Home Assistant você só precisa declarar os sensores MQTT no arquivo configuration.yaml, apontando para os tópicos apropriados. As entidades são normalmente criadas para os estado de energia (ligado/desligado), o estado de funcionamento (Atracado, Carregando, Cortando, Retornando à base…), a porcentagem de grama cortada, o horário do último corte e o tempo total de trabalho.
Os modelos de valor (value_template) são usados para traduzir os estados em inglês recebidos via MQTT em strings de texto em espanhol, de modo que o usuário veja “Carregando”, “Cortando a grama”, “Voltando para casa”, “Aparando as bordas”, “Ocioso no jardim”, “Bateria fraca”, etc. Também é possível Converter minutos de trabalho em horas Dividir por 60 e arredondar para exibir métricas mais convenientes nos cartões.
Após reiniciar o Home Assistant, esses sensores podem ser colocados em um painel para visualizar rapidamente o status da energia, o status atual do cortador de grama, a porcentagem da área já cortada e as horas de operação.
Para controlar o Indego a partir da interface HA, geralmente são utilizadas placas do seguinte tipo: botão-entidade Uma pilha horizontal com três botões: um para iniciar o corte (enviando o comando MOW para o tópico), outro para pausar (comando PAUSE) e um terceiro para enviar o robô de volta para a base (comando RETURN). Todos esses botões iniciam o serviço mqtt.publish com o tópico e o comando apropriados.
Com isso configurado e funcionando, agora você também pode criar automações semelhantes às de outros robôs: por exemplo, iniciar a poda às 6h da manhã somente se não tiver chovido e não houver previsão de chuva, combinando o status MQTT do robô com dados de uma integração como o AccuWeather. Ou enviar notificações via Telegram ou alto-falantes Quando o cortador de grama começa a cortar, termina um ciclo ou fica preso no jardim.
Essa abordagem baseada em MQTT tem a vantagem de ser muito flexível: como tudo acontece por meio de tópicos, você pode Combine-o facilmente com outros sistemas, painéis de controle ou automações avançadas.E você não depende de haver uma integração oficial específica para o Indego no núcleo do Home Assistant.
Integração oficial do Husqvarna Automower com Home Assistant
A Husqvarna oferece integração oficial para seus cortadores de grama automatizados equipados com Automower Connect ou módulo Automower ConnectAproveitando a API em nuvem própria da marca, isso fornece entidades altamente detalhadas para o status, estatísticas e controle do cortador de grama.
Para usar essa integração, você precisa configurar as credenciais OAuth2 no Portal do Desenvolvedor da HusqvarnaVocê faz login com a mesma conta que usa no aplicativo Automower Connect, cria um novo aplicativo e atribui a ele um URL de redirecionamento específico do Home Assistant (https://my.home-assistant.io/redirect/oauth), além de conectar as APIs de Autenticação e Automower Connect.
Ao criar a aplicação, o portal gera uma Chave de Aplicação e um Segredo de Aplicação que devem ser tratados como credenciais sensíveis (equivalentes a nome de usuário e senha)Em seguida, a partir do Home Assistant, é utilizada a integração do Husqvarna Automower, que o guiará pelo processo de login e autorização usando esses dados.
Após a configuração, o Home Assistant cria um "hub" da Husqvarna e, a partir daí, uma série de entidades associadas ao cortador de grama. Isso inclui sensores binários para detectar se ele está sendo usado. carregando a bateria (quando o robô retorna devido à bateria fraca e está recarregando) ou se estiver saindo da base a caminho do ponto de partida.
A integração também pode gerar botões Para confirmar pequenos erros, redefinir o tempo de utilização da lâmina ou sincronizar o relógio interno do cortador de relva com a hora do Home Assistant, são ações muito úteis para manutenção e diagnóstico.
UM calendário Para cada robô, são exibidos os horários de corte configurados, permitindo visualizar no Home Assistant os horários programados atuais e futuros, integrando-os com os demais calendários da casa.
Se o modelo o suportar, uma entidade aparecerá. rastreador de dispositivos que exibe a posição GPS do cortador de grama e uma entidade de evento que reflete o último erro, com atributos como gravidade, latitude e longitude exatas do incidente e o registro de data e hora. Isso abre caminho para automações como "se ocorrer um erro de inclinação, envie uma notificação com a localização e exiba um marcador no mapa".
A entidade de controle central é uma entidade cortador de gramaA partir daqui, você pode retomar o programa, pausar o corte ou estacionar o robô até o próximo horário agendado. Em alguns modelos, também são criadas entidades numéricas para ajustar o altura geral de corte (de 1 a 9) e a altura de corte por área de trabalho (0% a 100% em relação à altura base), para que você possa adaptar o corte a diferentes partes do jardim.
Existem também entidades selecionáveis para controlar, por exemplo, o modo de operação dos faróis do cortador de grama, e sensores muito abrangentes para duração da bateria, tempo de uso da lâmina, erros, períodos de inatividade, motivos de restrição (geada, limite diário, programação semanal…), tempo de carga restante, modo atual, próxima inicialização, contagem de ciclos de carga, colisões, tempos de corte acumulados, pesquisa, condução, etc., bem como o nome do área de trabalho ativa.
Para cada área de trabalho com corte sistemático ativado, são criados sensores adicionais com o progresso em porcentagem e a data/hora da última conclusão, facilitando automações como "se o progresso da área X atingir 100%, notifique e envie o robô para a base".
A integração também gera interruptores para controle. zonas de exclusão (zonas de proibição de entrada)Esses interruptores permitem ativar ou desativar o programa de corte global do robô e habilitar ou desabilitar cada área de trabalho separadamente. Com esses interruptores, você pode decidir, por exemplo, que o robô deve evitar uma área específica quando você estiver dando uma festa no gramado.
Em relação a ações específicas, a integração inclui apelos para sobrescrever o programa (Substituir programação) e fazer com que o robô corte a grama ou estacione por um período específico (de 1 minuto a 42 dias), com duração especificada em dias, horas e minutos. Você também pode comandá-lo para cortar uma área de trabalho específica por um determinado período, usando o ID da área obtido do sensor correspondente.
É importante estar ciente de algumas limitações de design: você não pode simplesmente iniciar o cortador de grama com `lawn_mower.start_mowing` fora dos horários programados; você precisa usar ações de sobreposição para isso. Além disso, em modelos com tecnologia EPOS, o gerenciamento de zonas de exclusão ainda não é compatível com esta integração oficial.
O que um usuário ganha ao começar a usar o Home Assistant e pesquisar por um cortador de grama?
Se você está nos estágios iniciais da pesquisa sobre qual cortador de grama robótico comprar (por exemplo, considerando um Mammotion Yuka Mini 700/800 Se você tem um Ecovacs Goat (ou um Ecovacs Goat) e instalou o Home Assistant "apenas para experimentar", talvez esteja se perguntando se vale a pena se aprofundar em toda essa questão de integração.
A resposta geralmente é sim, especialmente se você planejar seu jardim e sua casa como um sistema coerente: ao integrar o cortador de grama com o Home Assistant, você obtém muito mais controle e visibilidade Com o aplicativo oficial, isso se traduz em menos surpresas e mais autonomia real no uso diário.
No caso específico de Yuka/Luba, a integração com o Mammotion permite:
- Confira rapidamente status, bateria, posição e zona do painel do Home Assistant.
- Cortes de lançamento condicionados a regras como clima, presença ou produção de energia solar.
- Sincronize os horários com os calendários da família ou os modos da casa (ausente, férias, noite...).
- Explore cenários avançados como o Exposição ao Apple Home via Matter para controlá-lo como se fosse um robô aspirador de pó.
Para tirar o máximo proveito, além do cortador de grama, você precisará de alguns elementos básicos de automação residencial: alguma integração temporal confiável (Meteosat, AccuWeather, estação local), sensores de presença ou câmeras, caso queira bloquear o corte de energia quando houver pessoas por perto e, se tiver painéis solares, integre-os ao Home Assistant para explorar a lógica de excedentes.
O esforço envolvido na configuração inicial pode parecer grande no começo, mas uma vez concluídas as automações iniciais, o sistema funciona sem problemas e seu robô se torna “aquele colega freelancer que trabalha nos bastidores”Mas agora, obedecendo a regras que levam em consideração o que realmente acontece em sua casa e jardim.
Em última análise, integrar um cortador de grama inteligente ao Home Assistant, seja ele Mammotion, Bosch Indego via MQTT ou Husqvarna Automower com sua API oficial, transforma uma função aparentemente simples como cortar a grama em algo realmente útil. Mais uma peça do quebra-cabeça da automação residencialEm sintonia com o clima, a energia, a presença e os hábitos da família, o sistema se manifesta tanto no conforto quanto na tranquilidade, quando o jardim praticamente se cuida sozinho e você mal se lembra de que há um robô trabalhando ali.