

Configuração e login
Comece pelo navegador, sem SSH.
Um guia progressivo para instalar o HelioPulse, entender sua arquitetura, conectar equipamentos e ampliar a plataforma com drivers.
O guia é ilustrado com telas reais da instalação ativa do HelioPulse.


Comece pelo navegador, sem SSH.


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


Crie um driver Modbus a partir de uma definição JSON.
O produto atual combina monitoramento ao vivo, histórico local, gestão de dispositivos e operações seguras no Raspberry Pi.
Mantenha telemetria e histórico no appliance e continue operando na rede local sem Internet.
Veja solar, consumo, bateria, rede e estado de conexão dos dispositivos por atualizações WebSocket.
Explore produção, consumo, SOC, temperaturas e fases desde hoje até um intervalo personalizado ou um ano.
Carregue, crie e reutilize drivers Modbus declarativos sem reescrever o painel.
Gerencie collectors independentes, portas seriais estáveis, estado dos dispositivos e ações start/stop/restart.
Acompanhe transições de alarmes, reconheça incidentes e audite eventos de conectividade, configuração e collectors.
Gere relatórios determinísticos com energia, anomalias, alarmes e eventos; a AI local é opcional.
Inspecione recursos, conectividade e diagnóstico do Raspberry; crie backups e recupere localmente.
Use o painel no desktop ou celular com nove idiomas e temas claro/escuro.
Compare a energia solar esperada e produzida depois de configurar o conjunto PV.
Registre um BMS compatível como dispositivo próprio e consulte células, balanceamento, SOC, SOH, temperaturas e ciclos.
Gere telemetria sintética a partir de um driver para validar a interface sem hardware.
Baixe e ative opcionalmente um modelo local; relatórios determinísticos continuam disponíveis sem ele.
Publique em um broker opcional com TLS e discovery do Home Assistant.
Use limites, agendas, alarmes ou eventos para publicar MQTT, chamar webhooks ou registrar eventos; há dry-run.
O acesso por túnel de saída e as atualizações assinadas dependem de configuração e conectividade.
Não faz parte do fluxo local atual.
O carregamento manual de drivers existe hoje; um marketplace público fica para o futuro.
CAN, BLE e protocolos JK sem Modbus não fazem parte do caminho suportado atualmente.
As automações não gravam parâmetros do inversor nesta versão.
A OTA do aplicativo está disponível separadamente; o rollback A/B completo do sistema operacional fica para o futuro.
O HelioPulse OS é uma imagem Linux para Raspberry Pi projetada para monitoramento energético local.
Pi 4 com 4 GB ou Pi 5 com 4/8 GB.
SSD USB 3.0 de 128 GB recomendado ou microSD High Endurance.
Adaptador USB–RS485 com isolamento galvânico.
Obtenha a imagem e leia as notas da versão no repositório público de releases.
Ver todas as versõesUse o Raspberry Pi Imager ou ferramenta equivalente. Selecione o arquivo baixado e o SSD ou microSD de destino.
Conecte armazenamento, rede, adaptador USB–RS485 e a fonte oficial adequada ao Raspberry Pi.
Faça a ligação RS485 conforme o manual do fabricante. Não manipule conexões de inversores energizados.
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.
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.
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.
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.
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.
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.
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.


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


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


Volte à sua rede habitual e abra o endereço do painel indicado.
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.
Cada dispositivo tem um collector independente. Uma falha ou reinício em um inversor não interrompe a telemetria dos demais.
O inversor ou BMS expõe dados por seu protocolo.
Descreve protocolo, registros, escalas e métricas.
Lê cada dispositivo em um processo isolado e controlável.
Consolida telemetria, histórico, alarmes e previsão.
Um driver é um arquivo JSON declarativo. Ele define como comunicar por Modbus RTU e converter registros do fabricante em métricas comuns do HelioPulse.
O pacote descreve dados; não instala binários arbitrários no sistema.
O backend verifica estrutura, protocolo e registros antes de aceitar o arquivo.
O mesmo driver pode ser usado em vários dispositivos compatíveis.
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
}]
}]
}Em Equipamentos → Drivers, selecione o arquivo. O HelioPulse valida o esquema antes de salvá-lo.
Defina um device ID, o driver, a porta persistente by-id e um slave ID entre 1 e 247.
Inicie ou reinicie somente esse dispositivo e confirme que a telemetria ficou ativa.
Enviar outro arquivo com o mesmo ID atualiza o driver. Reinicie os dispositivos associados para aplicar a nova definição.
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.
Baixe a versão estável ou consulte o código-fonte e a evolução do projeto.