Na maioria dos medidores de energia ESPHome, alterar a maior parte das definições significa editar o YAML, compilá-lo, gravar o resultado e esperar. A documentação dos chips de energia mais comuns diz exatamente isto: ajustar um número, recompilar, instalar, ver a leitura, repetir. Cada passagem custa um reinício, e um reinício custa medição.
Esse ciclo é o que as pessoas realmente criticam — não a falta de funcionalidades. Por isso, a pergunta útil sobre correr um medidor dentro do Home Assistant é uma pergunta estreita: o que se pode alterar enquanto ele continua a funcionar, e o que ainda exige o ciclo?
O que muda com o hub em funcionamento
Tudo isto é uma ação enviada a um hub em funcionamento: aplica-se de imediato, sem recompilar nem gravar. Duas destas linhas têm uma parte que espera por um reinício, e estão assinaladas em nota abaixo.
| Onde | |
|---|---|
| Pontos: criar, dar nome, associar a um canal, reassociar, função, fase, potência nominal, grupo, inversão de sinal, eliminar e recuperar | painel → Points |
| Módulos: procurar no barramento, adicionar um pelo endereço, ver o modelo, a versão de firmware e o estado | painel → Points |
| Qual o modelo de pinça num canal — por ação, não por um botão; o painel mostra-o | ação + painel → Points |
| Plano tarifário: zonas por hora, taxa de rede, imposto sobre a energia, taxa, IVA | painel → Tariff |
| Moeda do plano | painel → Tariff |
| Fontes de preço: fornecedor, zona, fonte de reserva, margem, fator, valores mínimos, modo de preço de venda, preço de cada período de uma hora igual à média dessa hora, sobreposição de uma zona do plano sobre o preço spot | painel → Prices |
| Regras de janela barata, até oito | painel → Prices |
| Picos de importação: mostrados aqui; o dia de início do ciclo de faturação é definido chamando a ação da integração a partir de uma automação ou das Developer Tools, em vez de um formulário | painel → Prices |
| Fuso horário do hub, incluindo um botão para usar o do Home Assistant | painel → Prices |
| Nós ESP-NOW: emparelhar, listar, desativar, ativar, remover, escolher que entradas transportam | painel → Network |
Um item desta lista é topologia e não uma definição: a função supply — a sua entrada da rede — define-se ao criar ou reassociar um ponto, não ao editá-lo.
E eliminar um ponto encerra a sua contabilidade em vez de a apagar: o histórico fica em flash, e existe a opção de o recuperar.
A única exceção: os pinos do barramento I²C
Alterar os pinos que o barramento dos módulos usa exige que o hub reinicie. O painel avisa disso onde o faz, e é honesto quanto à consequência: os módulos nos pinos antigos deixam de responder até o reinício acontecer.
Essa é a lista completa de exceções. Tudo o resto acima se aplica com o hub em funcionamento.
O que espera, e durante quanto tempo
Nada disto é uma recompilação. É a diferença entre uma definição ficar em vigor e um registo começar.
| Entra em vigor | Espera por | |
|---|---|---|
| Um ponto que cria, renomeia ou associa | de imediato — valores em direto e períodos de 15 minutos | o seu histórico em flash (os registos horários) começa após o próximo reinício |
| Um nó que acabou de emparelhar | o próprio emparelhamento | os seus pontos aparecem após um reinício |
| Guardar a configuração de pontos inteira de uma vez | — | um reinício; editar um único ponto não o exige |
| Os pinos do barramento I²C | — | um reinício, e os módulos nos pinos antigos deixam de responder até lá |
O que exige YAML e uma instalação
| Uma chave de encriptação da API | a imagem pronta é gerada sem chave, por isso uma chave implica a sua própria configuração e uma instalação |
| A versão do componente, se gerar a sua própria | aumentar ref: em external_components, e depois instalar |
| Qualquer outra coisa no seu próprio YAML | por definição |
Se não estiver a gerar a sua própria configuração, a versão do componente chega da mesma forma que o firmware: uma nova imagem pronta, instalada pelo ar. Sem YAML envolvido.
Convém saber de antemão: estas duas linhas estão ligadas. No momento em que quiser uma chave de encriptação da API, está a gerar a sua própria configuração — e a partir daí cada instalação é sua para gerar, incluindo as que, de outra forma, seriam uma imagem pronta.
⚠️ Instale pelo ar, não por USB. Gravado por USB com as ferramentas do próprio ESPHome —
esphome runpara uma porta série, ou Manual download → Factory format — o seu build fica no endereço errado e a placa não arranca nada de novo: uma placa vazia não arranca, e uma placa com uma imagem antiga continua discretamente a correr a antiga. Pelo ar, só a aplicação é enviada, e o dispositivo coloca-a usando a sua própria tabela de partições. Faça a primeira instalação por USB com a imagem de fábrica pronta, e depois instale o seu próprio build pelo ar.
Alterar o Wi-Fi do hub
Não está no painel, e na imagem pronta também não está no YAML.
Quando o hub não consegue chegar à rede guardada — um router novo, uma mudança de casa — abre o seu próprio ponto de acesso de configuração cerca de um minuto depois, com um portal cativo: ligue-se a ele e escolha a nova rede. O ponto de acesso é rbgrid-hub-xxxxxx com a palavra-passe RBGRID123; altere essa palavra-passe depois de configurar o hub, da mesma forma que alteraria qualquer predefinição de fábrica. O Improv por USB também funciona: web.esphome.io → Connect → Change Wi-Fi.
A medição não para enquanto o hub está fora da rede. Continua a medir e a fechar os seus períodos; o que fica cortado é o Home Assistant e a obtenção de preços, até a ligação voltar.
O que não é uma definição
É aqui que a resposta honesta difere daquela que poderia esperar.
Não há campo de calibração — em nenhuma das duas formas, e não por ter ficado de fora do painel. O módulo rbAmp é o dispositivo de medição: devolve tensão, corrente e potência já calibradas, e essa calibração é feita no próprio módulo, na fábrica. O RBgrid nunca a escreve de propósito — o hub recolhe, regista e valoriza aquilo que o módulo reporta.
Por isso, se está habituado a ajustar uma pinça contra um medidor de referência: não existe ajuste por canal, nem ferramenta para isso. Os registos de ganho só são graváveis em modo de fábrica; num módulo que comprou, a escrita é recusada.
A razão está em onde a calibração acontece. Cada canal de cada módulo é calibrado na produção, e escolher o modelo de pinça converte essa calibração para a potência nominal da sua pinça. O que sobra é a tolerância da sua SCT-013 em particular, que é uma propriedade do sensor e vem indicada numa linha própria na especificação do sensor — não é algo que o módulo afirme eliminar.
E se quiser corrigir a sua própria instalação, o lugar para isso é o seu próprio software: um sensor de modelo no Home Assistant que multiplique a leitura é uma coisa perfeitamente razoável de fazer. O módulo não o fará por si, e nada no hub finge que o faz.
Esse modelo é uma definição, e muda com o hub em funcionamento — no painel, no diálogo Edit do ponto, onde "CT clamp model" lista os modelos que o próprio hub oferece. O seletor só aparece quando o módulo permite escolher um; um módulo que não está calibrado recusa a alteração e diz isso nas palavras do próprio hub.
⚠️ Se não vir esse seletor, a sua integração é mais antiga do que a versão que o acrescentou — nas anteriores, o painel mostrava o modelo de pinça e não o alterava, e a forma de o definir era uma chamada, não um campo. Atualizar é a resposta curta; a chamada continua a funcionar se preferir não o fazer.
Alterar o modelo não lhe custa a calibração. Defina-o ao ligar uma pinça e defina-o de novo ao substituí-la; no caminho que o hub usa, a calibração do canal sobrevive tanto à alteração como a um reinício.
Quanto custa uma instalação em medição
Uma instalação pelo ar é um reinício planeado. A hora em curso e os totais de vida sobrevivem-lhe — medido num S3 em quatro instalações que alternaram entre duas imagens.
A lacuna são alguns segundos: durante o envio propriamente dito, o hub continua a medir, e o núcleo volta alguns segundos depois do reinício. Nenhum período de 15 minutos se perde — embora aquele em que cai o reinício fique mais curto esses segundos.
O que esses segundos custam depende dos módulos que tem, e esta é a parte que vale a pena descrever com precisão:
- Módulos STD — módulos de medição que mantêm os seus próprios contadores de energia: nada. A energia é contada no módulo, e o hub lê a diferença do contador após o reinício.
- Módulos Basic — do tipo que lê pinças, em que o módulo mede a potência e o hub a integra em energia: esses alguns segundos não são contados. É uma quantidade de energia insignificante. Não é zero.
Portanto: alguns segundos durante o reinício, em vez de um registo contínuo.
O que isto não faz
- Não tira o ESPHome da equação. O dispositivo é um dispositivo ESPHome; o lado da rede, as instalações e o seu próprio YAML, se o mantiver, são do ESPHome.
- Não liga nem desliga nada. Todas as definições acima dizem respeito a medir e a valorizar; o que fazer com uma janela barata é decisão da sua automação.
- Não torna um reinício gratuito. Torna-o raro, e diz quanto custa esse raro.
Onde ler mais
- Executar dentro do Home Assistant — a via em si, e o que o painel faz.
- Duas formas de executar o RBgrid, e como escolher — se ainda não escolheu uma via.
- Points e Sensors and modules — o que é um ponto e como um módulo é endereçado.
- Remote nodes — emparelhamento, e o que um nó faz por conta própria.