Instale o HelioPulse do seu jeito.

Instale o HelioPulse OS em um Raspberry Pi.

O HelioPulse OS é uma imagem Linux pronta para usar no Raspberry Pi: sistema, painel e atualizações em uma única instalação pensada para o monitoramento energético local.

1. 1

   Baixe a versão estável

   Obtenha a imagem e leia as notas da versão no repositório público de releases.

   Baixar última imagem · 2.0 GBVer todas as versões
2. 2

   Grave a imagem

   Use o Raspberry Pi Imager ou ferramenta equivalente. Selecione o arquivo baixado e o SSD ou microSD de destino.

3. 3

   Conecte e ligue

   Conecte armazenamento, rede, adaptador USB–RS485 e a fonte oficial adequada ao Raspberry Pi.

Configure pelo navegador.

Na primeira inicialização o appliance abre um portal cativo pelo navegador: conecte o Wi-Fi, crie seu administrador e finalize. Sem SSH nem cabos até o seu computador.

1. 1

   Insira o cartão e ligue

   Coloque o microSD gravado no Raspberry Pi e conecte a energia. A primeira inicialização expande o sistema e inicia o HelioPulse; aguarde um minuto.

2. 2

   Conecte-se à rede HelioPulse

   No seu celular ou computador, conecte-se à rede Wi-Fi aberta HelioPulse-XXXX (sem senha) que o equipamento cria. Depois abra o navegador e acesse http://heliopulse.setup:8090 para ver o portal de configuração. Em alguns celulares o portal abre sozinho; se não, digite esse endereço.

3. 3

   Conecte-se à Internet

   Escolha o Wi-Fi da sua casa e digite a senha, ou continue com cabo de rede. A intensidade do sinal ajuda a identificar a rede certa.

4. 4

   Crie seu administrador

   Defina o usuário e a senha (mínimo 8 caracteres) que você usará para acessar o painel. Guarde-os bem: é a sua conta de administrador.

5. 5

   Opcional: ative o acesso remoto

   Se o seu equipamento permitir, escolha um nome para abrir o painel com segurança pela Internet. O acesso local sempre funciona, então você pode pular esta etapa.

6. 6

   Pronto para usar

   O portal confirma que a configuração terminou. Agora o equipamento já está na sua Wi-Fi: volte à sua rede habitual e acesse o painel em http://heliopulse.local:8080 com a conta que você criou. A rede HelioPulse-XXXX desaparece porque não é mais necessária.

Execute o HelioPulse no Docker.

Em vez de gravar uma imagem, baixe o contêiner em um mini-PC, NAS ou servidor. O mesmo núcleo, sem Raspberry: os coletores ESP32 se conectam pela rede, e os adaptadores USB-RS485 e o acesso remoto funcionam como no HelioPulse OS.

1. 1

   Inicie o contêiner

   Use docker run para um teste rápido ou Docker Compose para uma instalação permanente. A imagem escolhe sua arquitetura automaticamente.

   Docker Composedocker run

   Copiar

   # compose.yml — instalação permanente (recomendada)
   services:
     heliopulse:
       image: public.ecr.aws/j7s7r2j5/heliopulse:latest
       container_name: heliopulse
       ports: ["8080:8080"]
       volumes: ["heliopulse-data:/data"]
       environment: { HP_RUNTIME: docker }
       restart: unless-stopped
       read_only: true
       tmpfs: [/tmp]
       cap_drop: [ALL]
       security_opt: ["no-new-privileges:true"]
       logging: { driver: json-file, options: { max-size: 10m, max-file: "3" } }
   volumes: { heliopulse-data: {} }

2. 2

   Abra o painel

   Acesse http://<IP-do-host>:8080 de qualquer dispositivo da sua rede e crie sua conta de administrador no assistente inicial.

   De fora da sua rede local (por exemplo, com uma porta publicada na Internet), o assistente pede um código de configuração de uso único; leia-o com docker exec heliopulse cat /data/config/bootstrap-token. Depois configure Sistema › Geral › Localização do site: os totais diários, os relatórios e os horários usam o fuso horário dela.

3. 3

   Mantenha atualizado

   Atualizar é substituir a imagem: baixe a nova versão e recrie o contêiner. Seus dados permanecem no volume.

   Mantenha atualizadoCopiar

   # Atualizar para uma nova versão (substituição de imagem):
   docker compose pull && docker compose up -d

Instale o App do Home Assistant.

Execute o HelioPulse como App no Home Assistant OS, com acesso lateral, sessão de administrador e sensores MQTT.

1. 1

   Adicione o repositório

   Abra Definições → Apps → Loja de Apps → ⋮ → Repositórios e adicione o repositório público abaixo.

   Adicione o repositórioCopiar

   https://github.com/helios-pulse/heliopulse-releases

   Adicionar ao meu Home Assistant
2. 2

   Instale e abra o HelioPulse

   Procure HelioPulse, instale e inicie. Ative Mostrar na barra lateral e abra o HelioPulse com a sua sessão de administrador do Home Assistant.

3. 3

   Conecte os sensores (opcional)

   Para os sensores, configure Mosquitto e a integração MQTT no Home Assistant. Mantenha mqtt_mode em auto e configure os dispositivos no HelioPulse. Use um topic_prefix diferente por instância.

4. 4

   Atualize com segurança

   Instale atualizações do App pelo Home Assistant e faça antes uma cópia de segurança. As versões do App são independentes do HelioPulse OS e das suas OTA.

Uma plataforma local e modular.

Cada dispositivo tem um collector independente. Uma falha ou reinício em um inversor não interrompe a telemetria dos demais.

O tradutor entre seu equipamento e o HelioPulse.

Um driver é um arquivo JSON declarativo. Ele define como comunicar por Modbus RTU e converter registros do fabricante em métricas comuns do HelioPulse.

Comece pelo mapa Modbus.

Você precisa do manual de protocolo do fabricante e de leituras verificadas em um dispositivo real. O esquema mínimo exige um identificador, protocolo modbus_rtu e pelo menos um grupo com um registro.

{
  "id": "my-inverter-modbus",
  "name": "My inverter",
  "manufacturer": "Manufacturer",
  "models": ["Model A"],
  "protocol": {
    "type": "modbus_rtu",
    "baud_rate": 9600,
    "slave_id": 1
  },
  "register_groups": [{
    "name": "battery",
    "interval": "5s",
    "registers": [{
      "address": 256,
      "name": "battery_soc",
      "metric": "battery.soc_pct",
      "unit": "%",
      "scale": 1,
      "signed": false
    }]
  }]
}

Ative sem usar SSH.