Execute-o dentro do Home Assistant

Um ESP32 com 16 MB de flash e PSRAM — um WROVER, ou um S3 no módulo N16R8 — a mesma placa do firmware autónomo, mais os seus módulos rbAmp. Do lado do software: Home Assistant 2026.1 ou posterior com HACS e, se o incorporar na sua própria configuração, ESPHome 2026.5.3 ou posterior sobre a framework ESP-IDF.

Descarregue a imagem de fábrica para a sua placa na página de versões do pacote, depois abra web.esphome.io no Chrome ou no Edge, escolha Connect, selecione a porta série da sua placa, escolha Install e selecione o ficheiro descarregado. Há duas imagens: uma para o ESP32-WROVER, outra para o ESP32-S3.

Configure a Wi-Fi logo após gravar, pelo mesmo cabo USB, quando o instalador o oferecer — assim o hub nunca precisa do seu ponto de acesso de configuração. Se usar o ponto de acesso, altere a palavra-passe uma vez que o hub esteja adotado.

  external_components:
    - source:
        type: git
        url: https://github.com/rb-amp/rbgrid-esphome
        ref: v1.2.0   # the tag of the release you are installing — see the repository's Releases
        path: esphome/components
      components: [rbgrid]

Para uma primeira instalação por USB, use a imagem de fábrica pronta da página de versões — já está fundida com os deslocamentos reais e é gravada em 0x0 — ou esptool com os deslocamentos do flasher_args.json da sua própria compilação. Depois de o hub estar na rede, instale as suas próprias compilações por OTA: esphome run com o hub acessível, ou Install → Wirelessly. Por OTA só é enviada a aplicação, e o dispositivo coloca-a usando a sua própria tabela de partições, por isso o deslocamento está certo por construção.

A ordem importa aqui. Adicione primeiro o hub na integração ESPHome — o Home Assistant já o terá encontrado por si — e só depois adicione a integração RBgrid.

A integração RBgrid não está na lista padrão do HACS, por isso pesquisar no HACS não encontra nada até a adicionar você mesmo. No HACS, adicione https://github.com/rb-amp/rbgrid-ha como repositório personalizado, categoria Integração. Aparece no Home Assistant como RBgrid.

• Um hub expõe doze posições de medição — as mesmas doze para as quais guarda histórico. O nome de cada posição está lá desde o início; o resto das entidades de uma posição aparece quando associa um ponto a ela, por isso o que vê após a adoção são doze nomes e não doze dispositivos cheios de sensores vazios.
• Se libertar uma posição e a atribuir a outro ponto, os totais acumulados dessa posição continuam de onde estavam, por isso as estatísticas do Home Assistant podem mostrar um degrau na mudança. A série por ponto que a integração importa é a visão limpa disso.
• Uma moeda em todo o sistema: qualquer que seja a moeda da sua tarifa, todas as entidades de dinheiro ficam nela.
• As entidades de energia vão diretamente para o painel Energy — são do tipo acumulado que ele espera, por isso não há nada a criar com modelos nem um utility_meter para construir.

E o dinheiro é do próprio hub, não da aritmética do Home Assistant: obtém o preço do dia seguinte para a sua zona, aplica o seu contrato e calcula cada período de 15 minutos ao preço desse período — o mesmo que num hub autónomo. O que isso significa para os seus custos

O componente ESPHome e a integração do Home Assistant são MIT. O firmware autónomo do hub é publicado sob PolyForm Noncommercial, e essa licença não se aplica aqui: estes dois pacotes são MIT por direito próprio.