Voltar ao siteCentral de primeiros passos e documentação

De um Raspberry vazio ao seu primeiro dado de energia.

Um guia progressivo para instalar o HelioPulse, entender sua arquitetura, conectar equipamentos e ampliar a plataforma com drivers.

Baseado no HelioPulse OS 1.7.0 Instruções alinhadas ao repositório
Percurso pelo produto real

Veja os passos antes de instalar.

O guia é ilustrado com telas reais da instalação ativa do HelioPulse.

Configuração e loginConfiguração e login

Configuração e login

Comece pelo navegador, sem SSH.

Visão geral da energia ao vivoVisão geral da energia ao vivo

Visão geral da energia ao vivo

Confirme que o sistema informa produção e consumo.

Editor de driversEditor de drivers

Editor de drivers

Crie um driver Modbus a partir de uma definição JSON.

O que o HelioPulse tem hoje

Uma plataforma de energia local que você pode usar agora.

O produto atual combina monitoramento ao vivo, histórico local, gestão de dispositivos e operações seguras no Raspberry Pi.

Disponível hoje

Monitoramento local-first

Mantenha telemetria e histórico no appliance e continue operando na rede local sem Internet.

Telemetria ao vivo com qualidade

Veja solar, consumo, bateria, rede e estado de conexão dos dispositivos por atualizações WebSocket.

Análise histórica

Explore produção, consumo, SOC, temperaturas e fases desde hoje até um intervalo personalizado ou um ano.

Drivers JSON validados

Carregue, crie e reutilize drivers Modbus declarativos sem reescrever o painel.

Operação com vários dispositivos

Gerencie collectors independentes, portas seriais estáveis, estado dos dispositivos e ações start/stop/restart.

Alarmes e linha do tempo de eventos

Acompanhe transições de alarmes, reconheça incidentes e audite eventos de conectividade, configuração e collectors.

Relatórios diários e semanais

Gere relatórios determinísticos com energia, anomalias, alarmes e eventos; a AI local é opcional.

Saúde, backups e recuperação

Inspecione recursos, conectividade e diagnóstico do Raspberry; crie backups e recupere localmente.

Interface responsiva e multilíngue

Use o painel no desktop ou celular com nove idiomas e temas claro/escuro.

Opcional e avançado

Previsão solar

Compare a energia solar esperada e produzida depois de configurar o conjunto PV.

BMS por Modbus RTU

Registre um BMS compatível como dispositivo próprio e consulte células, balanceamento, SOC, SOH, temperaturas e ciclos.

Modo simulado

Gere telemetria sintética a partir de um driver para validar a interface sem hardware.

AI local para relatórios

Baixe e ative opcionalmente um modelo local; relatórios determinísticos continuam disponíveis sem ele.

MQTT e Home Assistant

Publique em um broker opcional com TLS e discovery do Home Assistant.

Automações locais

Use limites, agendas, alarmes ou eventos para publicar MQTT, chamar webhooks ou registrar eventos; há dry-run.

Acesso remoto e OTA do app

O acesso por túnel de saída e as atualizações assinadas dependem de configuração e conectividade.

Roteiro

Sincronização na nuvem

Não faz parte do fluxo local atual.

Marketplace de drivers

O carregamento manual de drivers existe hoje; um marketplace público fica para o futuro.

Protocolos proprietários de BMS

CAN, BLE e protocolos JK sem Modbus não fazem parte do caminho suportado atualmente.

Gravações automáticas nos inversores

As automações não gravam parâmetros do inversor nesta versão.

Rollback A/B completo do sistema

A OTA do aplicativo está disponível separadamente; o rollback A/B completo do sistema operacional fica para o futuro.

01Instalação

Prepare o appliance.

O HelioPulse OS é uma imagem Linux para Raspberry Pi projetada para monitoramento energético local.

Raspberry Pi 4 ou 5

Pi 4 com 4 GB ou Pi 5 com 4/8 GB.

Armazenamento

SSD USB 3.0 de 128 GB recomendado ou microSD High Endurance.

Comunicação

Adaptador USB–RS485 com isolamento galvânico.

  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.

    Ver 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.

Trabalhe com o sistema desligado

Faça a ligação RS485 conforme o manual do fabricante. Não manipule conexões de inversores energizados.

02Primeira inicialização

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.

Rede localLocalize o Raspberry Pi
Conta inicialCrie credenciais seguras
Primeiro dispositivoDriver, porta e slave ID
  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 temporária que o equipamento cria. O portal de configuração abre sozinho no navegador; se não, abra o endereço mostrado na tela.

  3. 3

    1. 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

    2. 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

    3. Pronto para usar

    O portal confirma que a configuração terminou e mostra o endereço do painel. Volte à sua rede habitual e abra-o para entrar com a conta que você criou.

1. Conecte-se à Internet1. Conecte-se à Internet

1. Conecte-se à Internet

Escolha sua rede Wi-Fi (ou continue com cabo de rede).

2. Crie seu administrador2. Crie seu administrador

2. Crie seu administrador

Defina as credenciais que você usará para acessar o painel.

3. Pronto para usar3. Pronto para usar

3. Pronto para usar

Volte à sua rede habitual e abra o endereço do painel indicado.

Pensado para celular e computador

O portal é um fluxo guiado e responsivo, com barra de progresso e temas claro/escuro. Sem app, sem SSH e sem cabos até o seu computador.

03Como funciona

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.

01

Dispositivo

O inversor ou BMS expõe dados por seu protocolo.

02

Controlador

Descreve protocolo, registros, escalas e métricas.

03

Coletor

Lê cada dispositivo em um processo isolado e controlável.

04

Painel

Consolida telemetria, histórico, alarmes e previsão.

04Controladores

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.

Sem código executável

O pacote descreve dados; não instala binários arbitrários no sistema.

Validação antes de salvar

O backend verifica estrutura, protocolo e registros antes de aceitar o arquivo.

Reutilizável

O mesmo driver pode ser usado em vários dispositivos compatíveis.

05Criar um driver

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.

my-inverter-modbus.json Exemplo mínimo
{
  "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
    }]
  }]
}

Antes de publicar

  • Use um ID estável e seguro para o nome do arquivo.
  • Confirme baud rate, paridade, stop bits e slave ID.
  • Verifique endereço, sinal, escala e unidade de cada registro.
  • Compare potência e energia com o painel físico do dispositivo.
  • Teste desconexões e valores fora do intervalo.
06Carregar e conectar

Ative sem usar SSH.

Etapa 1

Envie o JSON

Em Equipamentos → Drivers, selecione o arquivo. O HelioPulse valida o esquema antes de salvá-lo.

Etapa 2

Registre o dispositivo

Defina um device ID, o driver, a porta persistente by-id e um slave ID entre 1 e 247.

Etapa 3

Inicie o collector

Inicie ou reinicie somente esse dispositivo e confirme que a telemetria ficou ativa.

Substituição controlada

Enviar outro arquivo com o mesmo ID atualiza o driver. Reinicie os dispositivos associados para aplicar a nova definição.

07Projeção de versões

O que vem depois.

Esta visão comunica a direção atual do projeto. O escopo e a ordem podem mudar após validação técnica e testes em campo.

v1.7Disponível

Base local inteligente

  • Multi-inversor e drivers pelo painel
  • Relatórios com modelos locais de IA
  • Histórico, diagnóstico e previsão
v1.8Projetado

Ecossistema de drivers

  • Marketplace e catálogo verificável
  • Compatibilidade e versões dos drivers
  • Fluxo de teste e publicação
  • Mais drivers para inversores e BMS
v1.9Em estudo

Operação avançada confiável

  • Observabilidade e manutenção guiada ampliadas
  • Maior cobertura e consistência multilíngue
  • Validação avançada das leituras das baterias entre inversor, BMS e shunt
  • Decodificação de alarmes por fabricante e automação com múltiplas ações
FuturoDireção

Multi-site com agentes

  • Uma Raspberry Pi coordenadora à frente da instalação
  • Agentes coletores em Raspberry Pi ou ESP32
  • Backups na nuvem
  • Gestão de múltiplas instalações
  • Integração com Grafana para dashboards personalizados
  • Notificações em tempo real por canais configuráveis pelo usuário

Pronto para instalar?

Baixe a versão estável ou consulte o código-fonte e a evolução do projeto.

Versões
Primeiros passos: instale o HelioPulse em um Raspberry Pi | HelioPulse