Um nó é um ESP32 que mede num sítio onde o seu hub não chega por cabo — um quadro secundário num anexo, uma bomba no seu próprio barracão, um aparelho do outro lado da casa — e envia as leituras por rádio.
A primeira pergunta é sempre a mesma, e ninguém a pode responder por si: vai chegar? Isso depende das suas paredes, do seu quadro, do seu edifício. O que lhe podemos dizer é que pode descobrir em cerca de dez minutos, sem nada montado e sem furar nada.
Por isso, faça isso primeiro.
Antes de começar
Um nó precisa de três coisas, e a primeira surpreende as pessoas:
- Um módulo que meça tensão. Na v1.1.7, um nó só regista energia se um dos seus módulos rbAmp medir tensão. Com módulos só de corrente, mostra-lhe a corrente em tempo real e não guarda nada — nem períodos, nem histórico, nem custo. Portanto, o conjunto para um nó é um conjunto rbAmp monofásico com medição de tensão.
- Um ESP32 original com 4 MB de flash e sem PSRAM. Não um S2, S3 ou C3 — o firmware do nó não é compilado para eles.
- Um hub ligado ao seu Wi-Fi. O rádio com que o nó comunica é o rádio Wi-Fi, por isso um hub sem rede não tem nada que o nó possa encontrar.
⚠️ Para qualquer trabalho dentro de um quadro elétrico, chame um eletricista qualificado.
Emparelhe-o onde vai ficar
Não na bancada. Todo o objetivo dos próximos dez minutos é testar o caminho que o nó vai realmente usar, por isso leve-o ao local, ligue-o aí e emparelhe-o a partir de onde está.
Points → Nodes → abra a janela de emparelhamento. Escolhe quanto tempo a janela fica aberta — entre 10 segundos e 10 minutos. Ligue o nó dentro desse intervalo e os dois encontram-se: trocam chaves, e os pontos do nó aparecem logo na aplicação, com histórico desde a primeira hora. Nenhum dos dispositivos reinicia.
Nunca escolhe um canal de rádio. O nó procura o hub e fixa-se nele sozinho — na nossa bancada, em menos de quatro segundos.
⚠️ A janela de emparelhamento não tem PIN. Enquanto estiver aberta, qualquer nó RBgrid no alcance que pedir para emparelhar será emparelhado. Abra-a apenas quando estiver prestes a ligar o seu próprio nó, feche-a depois e verifique a lista de nós para ver o que entrou.
Os três números
Depois de emparelhado, o cartão do nó mostra a ligação. São estes que substituem uma promessa sobre a distância:
- Sinal — a força da última mensagem que o hub ouviu deste nó.
- Pacotes perdidos — a percentagem que o nó falhou no último minuto, mais ou menos. Só aparece depois da primeira janela completa, por isso dê-lhe um minuto antes de tirar conclusões.
- Última receção — há quanto tempo o hub ouviu o nó pela última vez.
Não há valor mínimo aceitável, e não o vamos inventar. O firmware não tem limiar de sinal nem de perda, por isso um número que parece razoável num local não quer dizer nada noutro. O que deve observar é o comportamento:
Deixe-o dez minutos com a carga efetivamente a funcionar — a bomba a bombear, o carregador a carregar — e verifique que os pacotes perdidos se mantêm em zero e que o nó continua online. Uma ligação que está boa com tudo parado e que falha quando o motor arranca é a que lhe vai estragar a tarde, e só se revela sob carga.
Se isso se confirmar, monte-o. Se não, ficou a saber para o preço de estar num anexo, e não de furar uma parede.
Quando não é suficientemente bom
Pela ordem em que as pessoas costumam tentar:
- Mude o nó de sítio. Um metro conta mais do que se imagina, e o nó é que se move — não os cabos das pinças. Prolongar o cabo do sensor para trazer a medição até ao hub é o caminho ao contrário, e é exatamente o que um nó existe para evitar.
- Tire a antena do metal. Um nó fechado dentro de uma caixa de aço está a comunicar através de uma caixa.
- Passe um cabo até um sítio melhor para o nó, e mantenha o salto de rádio curto.
O que o hub faz enquanto a ligação está em baixo
Esta é a parte que vale a pena conhecer antes de se preocupar com uma ligação marginal.
Um nó mantém a sua própria hora e fecha cada período de 15 minutos pelo seu próprio relógio. Se o hub estiver inacessível, o nó guarda esses períodos concluídos e envia-os quando o hub voltar, e são arquivados e tarifados pela hora em que foram medidos, não pela hora em que chegaram. Quanto tempo os consegue guardar depende do firmware do próprio nó, não do hub:
- Firmware do nó 1.5, que vem com o hub v1.1.8, escreve cada período concluído na flash do próprio nó: cerca de cinco dias deles.
- Firmware do nó 1.4 guarda oito deles, cerca de duas horas, em memória. Depois disso, o nono empurra para fora o mais antigo, e esse perde-se para sempre.
Em qualquer dos casos, o mais antigo sai primeiro quando a retenção estiver cheia. Mas a pergunta para uma ligação instável deixa de ser "a falha foi mais longa do que duas horas?" e passa a ser uma que raramente precisa de fazer.
O que a retenção não cobre:
- Um nó que perde a alimentação. No firmware 1.4 perde a fila e o período em curso. No 1.5 os períodos guardados estão na flash e sobrevivem; o período que estava aberto no momento do corte continua perdido.
- Um nó que arranca enquanto o hub está inacessível guarda a energia, mas regista-a na hora errada. O relógio dele vem do hub, por isso, até ter ouvido um, não consegue fechar um período. Na v1.1.7, tudo o que mediu entretanto chega depois no primeiro registo, que cobre todo o intervalo desde a ligação até ao fim do primeiro período completo de 15 minutos — e é registado como se tudo tivesse acontecido nesse único período. Nada se perde; um dia a funcionar às cegas fica simplesmente concentrado num único período do seu histórico.
Quando algo parece errado
O hub considera um nó offline após cerca de quinze segundos sem qualquer sinal dele, e regista-o como um evento — também em MQTT, se o usar, juntamente com um tópico de estado por nó e um sensor de sinal no Home Assistant.
⚠️ Fora de alcance e desligado parecem iguais. A aplicação não os consegue distinguir, e a API também não. O que os distingue é o que aconteceu antes: uma ligação que se degrada costuma derivar primeiro — os pacotes perdidos sobem, o sinal desce, o nó alterna entre online e offline. Um corte de energia é uma queda limpa com bons números até ao último momento.
Uma ligação marginal mostra-se com pacotes perdidos acima de zero e com falhas nos valores em tempo real. Os seus registos são mais robustos do que a vista em tempo real: os períodos são reenviados até o hub confirmar, por isso continuam a chegar atrasados e ainda assim caem na hora certa, desde que esteja dentro da retenção de duas horas.
Se o router mudar o canal Wi-Fi, o nó repara no silêncio após cerca de oito segundos e volta a procurar o hub. Nada reinicia, e os períodos fechados entretanto ficam retidos.
Desligar o rádio de nós do hub comporta-se da mesma forma: os nós continuam a fechar os seus períodos e guardam até oito deles, enviando-os quando o rádio voltar. O que perde é a vista em tempo real durante esse intervalo, e tudo o que for mais antigo do que a retenção — não os seus registos.
Mover ou remover um nó
Remover um nó apaga os seus pontos e o respetivo histórico. Leia isto duas vezes antes de arrumar uma lista.
Um nó não fica casado com um hub que não consegue ouvir. Após cerca de 150 segundos sem resposta, marca-se a si próprio como desemparelhado e começa a pedir para emparelhar outra vez por iniciativa própria; se o reiniciar, pede logo. Por isso, mudar um nó para outro hub — ou voltar a emparelhar um que removeu — é: abrir a janela de emparelhamento no hub que quer, e depois reiniciar o nó, ou simplesmente esperar dois minutos e meio. Apagar a flash é uma opção para começar do zero, não um requisito.
⚠️ Esta é também a outra metade do aviso acima. Um nó qualquer no alcance que tenha perdido o seu próprio hub estará a pedir para emparelhar — por isso, uma janela aberta sem nenhum dos seus dispositivos a ligar é um convite a qualquer outra coisa que esteja a escutar.
E há uma que apanha as pessoas de surpresa: um nó não tem atualização over-the-air. O hub pode ser atualizado over-the-air a partir da aplicação; o nó não. O novo firmware é instalado por USB, da mesma forma que foi instalado da primeira vez — por isso, deixe-o num sítio onde ainda consiga chegar com um cabo.
O que um nó não é
É um emissor. Não tem ecrã nem interface web, não guarda um histórico que possa ler, e não faz nada sozinho se o hub desaparecer, para além de reter os períodos concluídos até o hub voltar. A medição é feita pelos módulos rbAmp ligados a ele; o nó lê-os e encaminha-os.
Na v1.1.7 também não faz trifásico: o agrupamento de fases pertence ao hub e ao seu próprio módulo de entrada, e um nó aceita um conjunto monofásico.
⚠️ Um nó não acrescenta histórico. Os seus pontos partilham as mesmas doze posições de histórico que tudo o que está ligado ao hub — um nó que acrescenta ocupa posições de pontos que já mantém. → Que cargas merecem uma posição de histórico
Próximo passo
- Sensors and modules · Points
- O que a versão mudou: RBgrid v1.1.7
- Perguntas → Apoio