Home Assistant

O GrowController aparece no Home Assistant como um dispositivo por estufa, sozinho, pela descoberta MQTT: leituras, alarme, setpoints, fotoperíodo, um seletor por tomada e, nas placas com câmera, a foto da estufa.

O Home Assistant é um controle remoto, não um segundo cérebro. Quem decide ligar o exaustor continua sendo o controlador, e tudo que você muda pelo HA vale igual a mudar pelo painel. Com o HA desligado, fora do ar ou mal configurado, a estufa funciona exatamente igual.

Nota

Precisa do firmware v1.10.0 ou mais novo no controlador (a foto, da v1.11.0). A versão aparece no painel local, em ⋯ → Diagnóstico.

Escolha o modo

O HA conversa com um broker MQTT só. Por isso há dois jeitos de ligar:

• No broker do Home Assistant (recomendado): cada controlador conecta no Mosquitto do seu HA. É o caminho para mais de uma estufa, ou se o HA já usa MQTT para outra coisa (Zigbee2MQTT, por exemplo).
• No broker desta unidade: o controlador já tem um broker MQTT embutido, e o HA conecta direto nele. Serve para uma estufa só, num HA que não usa MQTT para mais nada.

No broker do Home Assistant

1. No HA, instale o add-on Mosquitto broker (Configurações → Complementos) e inicie-o.

2. Crie um usuário para os controladores: Configurações → Pessoas → Usuários → Adicionar usuário (por exemplo gfc, com “só pode entrar pela rede local”). O Mosquitto aceita os usuários do HA.

3. Confira se a integração MQTT do HA aponta para o add-on. Normalmente o HA a oferece sozinho, como descoberta, logo depois que o add-on sobe.

4. No painel local do controlador (http://grow.local), toque em ⋯ → Configuração → card Home Assistant:

   • ative Integração ativada;
   • Onde publicar: No broker do Home Assistant;
   • Broker do HA (IP): o IP do seu Home Assistant, porta 1883;
   • o usuário e a senha do passo 2;
   • Salvar Home Assistant.

5. Repita o passo 4 em cada estufa. Cada uma aparece como um dispositivo próprio em Configurações → Dispositivos e serviços → MQTT.

No broker desta unidade

1. No painel local do controlador, toque em ⋯ → Configuração → card Home Assistant: ative Integração ativada, Onde publicar: No broker desta unidade, e Salvar Home Assistant. Anote o IP que o card mostra.

2. No HA: Configurações → Dispositivos e serviços → Adicionar integração → MQTT, com o IP do controlador como broker, porta 1883, sem usuário e sem senha.

3. O dispositivo aparece em segundos.

Dica

O GrowController com display (Guition) tem pouca memória sobrando: nele, prefira este modo. Para juntá-lo a um HA que já usa o Mosquitto, faça uma ponte do Mosquitto para ele (abaixo).

Ponte do Mosquitto do HA para uma estufa neste modo

Na configuração do add-on Mosquitto, ative a pasta de customização:

customize:
  active: true
  folder: mosquitto

Crie /share/mosquitto/gfc-bridges.conf com um bloco por estufa, trocando o nome, o IP e <ID> pelo id mostrado no card (os 12 caracteres depois de gfc_), e reinicie o add-on:

connection estufa-2
address 192.168.0.130:1883
cleansession true
topic gfc/<ID>/state in 0
topic gfc/<ID>/availability in 0
topic gfc/<ID>/cmd/# out 0
topic gfc/<ID>/snapshot out 0
topic homeassistant/device/gfc_<ID>/config in 0
topic homeassistant/status out 0

Cada linha é presa ao id daquela estufa de propósito: um gfc/# both copiaria as outras estufas para o broker desta, que mora na memória do aparelho.

Cuidado

Use IPs, não grow.local. O HA rodando em Docker ou numa máquina virtual costuma não enxergar nomes .local, e o formulário só responde “Falha ao conectar”. Para os IPs não mudarem, reserve-os no DHCP do roteador.

O card mostra o id da unidade (gfc_ + o MAC do aparelho). É ele que segura as entidades no HA: renomear a estufa muda só o nome mostrado, nunca quebra uma automação sua.

O que aparece no HA

Entidade	O que é
Temperatura, Umidade, CO₂, VPD	as leituras do sensor. Viram “desconhecido” se o sensor para de mandar, em vez de ficar parado no último valor
Status do VPD	ok, low ou high, pela faixa ideal da fase da planta
Alarme de segurança	o mesmo alarme que força o umidificador a desligar e avisa no Telegram
tomada modo	seletor auto / on / off
tomada	o que a tomada está fazendo de fato
Exaustor liga acima de, umidade alvo, histereses	os setpoints, gravados no aparelho como pelo painel
Luz liga às / desliga às	o fotoperíodo, em HH:MM
Foto	só nas placas com câmera. Renova sozinha a cada hora
Tirar foto	só nas placas com câmera. Renova a Foto na hora

Cada tomada aparece com o apelido dela, ou com a função (Luz, Exaustor…).

Por que um seletor e não um interruptor. Um interruptor não tem como “voltar ao automático”: uma automação do HA que o ligasse deixaria a tomada presa no manual para sempre. on e off são um comando manual que vale até você voltar para auto — ou até o controlador reiniciar, quando tudo volta ao automático. Se o seletor diz on e a tomada aparece desligada, olhe o Alarme de segurança: a trava de segurança vence qualquer comando manual.

A foto não passa pelo MQTT. O HA baixa a imagem direto do controlador, pelo IP dele. Então o HA precisa alcançar o controlador na rede (porta 80), não só o broker. “Tirar foto” não grava nada no cartão SD nem mexe no timelapse.

Convivência com o resto

• Telegram continua avisando sozinho. Se você criar uma notificação no HA a partir do alarme, vai receber as duas.
• Plataforma online e HA podem mudar o mesmo setpoint; vale o último.
• Tomadas e sensores não aparecem por conta própria no HA, e assim deve ser: o HA os vê pelo controlador. Não ative a API do ESPHome neles, ou o HA passaria a comandar a tomada por fora do controlador.
• Histórico: o HA guarda o dele. Enquanto o HA estiver fora do ar ele fica sem dados; o controlador continua gravando no SD e na nuvem.

Se não aparecer

• Em ⋯ → Diagnóstico no painel local, ou em http://grow.local/api/diagnostics no bloco ha: link_up deve ser true.
• No modo No broker do Home Assistant, link_last_connack igual a 5 é usuário ou senha errados; um erro de rede com link_last_connack 0 é IP errado, firewall ou o add-on parado.
• Desligar a integração no card tira a estufa do HA sozinho. Uma tomada que você esqueceu no controlador some do HA na próxima publicação.