Setup y login
Comienza desde el navegador sin SSH.
De una Raspberry vacía a tu primer dato energético.
Una guía progresiva para instalar HelioPulse, comprender su arquitectura, conectar equipos y extender la plataforma mediante drivers.
Basado en HelioPulse OS 1.7.0 Instrucciones alineadas con el repositorio
Recorrido del producto real
Mira los pasos antes de instalar.
La guía está ilustrada con pantallas reales de la instalación activa de HelioPulse.
Resumen energético en vivo
Confirma que el sistema informa producción y consumo.
Editor de drivers
Crea un driver Modbus desde una definición JSON.
Lo que HelioPulse tiene hoy
Una plataforma energética local que puedes usar ahora.
El producto actual combina monitoreo en vivo, históricos locales, gestión de equipos y operaciones seguras en la Raspberry Pi.
Disponible hoy
Monitoreo local-first
Conserva telemetría e históricos en el appliance y sigue operando en tu red local sin Internet.
Telemetría en vivo con calidad
Ve solar, consumo, batería, red y estado de conexión mediante actualizaciones WebSocket.
Análisis histórico
Explora producción, consumo, SOC, temperaturas y fases desde hoy hasta un rango personalizado o un año.
Drivers JSON validados
Carga, crea y reutiliza drivers Modbus declarativos sin reescribir el panel.
Operación multi-dispositivo
Administra collectors independientes, puertos seriales estables, estado y acciones start/stop/restart.
Alarmas y timeline de eventos
Sigue transiciones de alarmas, reconoce incidencias y audita conectividad, configuración y collectors.
Informes diarios y semanales
Genera informes deterministas con energía, anomalías, alarmas y eventos; la AI local es opcional.
Salud, backups y recuperación
Inspecciona recursos, conectividad y diagnóstico de la Raspberry; crea backups y recupera localmente.
UI responsive y multidioma
Usa el panel en escritorio o móvil con nueve idiomas y temas claro/oscuro.
Opcional y avanzado
Pronóstico solar
Compara energía solar esperada y producida después de configurar el arreglo fotovoltaico.
BMS por Modbus RTU
Registra un BMS compatible como dispositivo propio y consulta celdas, balanceo, SOC, SOH, temperaturas y ciclos.
Modo mock
Genera telemetría sintética desde un driver para validar la interfaz sin hardware.
AI local para informes
Descarga y activa opcionalmente un modelo local; los informes deterministas siguen disponibles sin él.
MQTT y Home Assistant
Publica en un broker opcional con TLS y discovery de Home Assistant.
Automatizaciones locales
Usa umbrales, horarios, alarmas o eventos para publicar MQTT, llamar webhooks o registrar eventos; hay dry-run.
Acceso remoto y OTA de la app
El acceso por túnel saliente y las actualizaciones firmadas dependen de configuración y conectividad.
Hoja de ruta
Sincronización Cloud
No forma parte del flujo local actual.
Marketplace de drivers
La carga manual existe hoy; un marketplace público queda para el futuro.
Protocolos BMS propietarios
CAN, BLE y protocolos JK no Modbus no forman parte del camino soportado actual.
Escrituras automáticas en inversores
Las automatizaciones no escriben parámetros del inversor en esta versión.
Rollback A/B del sistema completo
La OTA de aplicación existe por separado; el rollback A/B del sistema operativo queda para el futuro.
Prepara el appliance.
HelioPulse OS es una imagen Linux para Raspberry Pi diseñada para monitoreo energético local.
Pi 4 con 4 GB o Pi 5 con 4/8 GB.
SSD USB 3.0 de 128 GB recomendado o microSD High Endurance.
Adaptador USB–RS485 con aislamiento galvánico.
- 1
Descarga la versión estable
Obtén la imagen y revisa las notas de la versión desde el repositorio público de releases.
Ver todas las versiones - 2
Graba la imagen
Usa Raspberry Pi Imager o una herramienta equivalente. Selecciona el archivo descargado y el SSD o microSD de destino.
- 3
Conecta y enciende
Conecta almacenamiento, red, adaptador USB–RS485 y la fuente oficial adecuada para tu Raspberry.
Trabaja con el sistema sin energía
Realiza el cableado RS485 siguiendo el manual del fabricante. No manipules conexiones del inversor energizado.
Configura desde el navegador.
En el primer arranque el appliance abre un portal cautivo desde tu navegador: conecta el Wi-Fi, crea tu administrador y finaliza. Sin SSH ni cables hacia tu computadora.
Red localLocaliza la Raspberry
Cuenta inicialCrea credenciales seguras
Primer equipoDriver, puerto y slave ID
- 1
Inserta la memoria y enciende
Coloca la microSD grabada en la Raspberry Pi y conecta la corriente. El primer arranque expande el sistema e inicia HelioPulse; espera un minuto.
- 2
Conéctate a la red HelioPulse
Desde tu teléfono o computadora, conéctate a la red Wi-Fi temporal que crea el equipo. El portal de configuración se abre solo en el navegador; si no, abre la dirección que aparece en pantalla.
- 3
1. Conéctate a Internet
Elige tu Wi-Fi de casa y escribe la contraseña, o continúa con cable de red. La intensidad de señal te ayuda a identificar la red correcta.
- 4
2. Crea tu administrador
Define el usuario y la contraseña (mínimo 8 caracteres) con los que entrarás al panel. Guárdalos bien: es tu cuenta de administrador.
- 5
Opcional: habilita el acceso remoto
Si tu equipo lo permite, elige un nombre para abrir el panel de forma segura por Internet. El acceso local siempre funciona, así que puedes omitir este paso.
- 6
3. Listo para usar
El portal confirma que la configuración terminó y muestra la dirección del panel. Vuelve a tu red habitual y ábrela para entrar con la cuenta que creaste.
1. Conéctate a Internet
Elige tu red Wi-Fi (o continúa con cable de red).
2. Crea tu administrador
Define las credenciales con las que entrarás al panel.
3. Listo para usar
Vuelve a tu red habitual y abre la dirección del panel indicada.
Pensado para teléfono y computadora
El portal es un flujo guiado y responsive, con barra de progreso y temas claro/oscuro. Sin app, sin SSH y sin cables hacia tu computadora.
Una plataforma local y modular.
Cada dispositivo tiene un collector independiente. Una falla o reinicio en un inversor no interrumpe la telemetría de los demás.
Dispositivo
El inversor o BMS expone datos mediante su protocolo.
Controlador
Describe protocolo, registros, escalas y métricas.
Recolector
Lee cada equipo en un proceso aislado y controlable.
Panel de control
Consolida telemetría, historia, alarmas y pronóstico.
El traductor entre tu equipo y HelioPulse.
Un driver es un archivo JSON declarativo. Define cómo comunicarse por Modbus RTU y cómo convertir registros del fabricante en métricas comunes de HelioPulse.
Sin código ejecutable
El paquete describe datos; no instala binarios arbitrarios en el sistema.
Validación antes de guardar
El backend comprueba estructura, protocolo y registros antes de aceptar el archivo.
Reutilizable
Un mismo driver puede usarse en varios equipos compatibles.
Comienza con el mapa Modbus.
Necesitas el manual del protocolo del fabricante y lecturas verificadas en un equipo real. El esquema mínimo exige un identificador, protocolo modbus_rtu y al menos un grupo con un registro.
my-inverter-modbus.json Ejemplo 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 publicarlo
- Usa un id estable y seguro para el nombre del archivo.
- Confirma baud rate, paridad, stop bits y slave ID.
- Verifica dirección, signo, escala y unidad de cada registro.
- Compara potencia y energía con el panel físico del equipo.
- Prueba desconexiones y valores fuera de rango.
Actívalo sin usar SSH.
Sube el JSON
En Equipos → Drivers, selecciona el archivo. HelioPulse valida el esquema antes de guardarlo.
Registra el equipo
Define un device ID, el driver, el puerto persistente by-id y un slave ID entre 1 y 247.
Inicia el collector
Inicia o reinicia solo ese equipo y confirma que la telemetría pase a estado activo.
Reemplazo controlado
Subir otro archivo con el mismo ID actualiza el driver. Reinicia los equipos asociados para aplicar la nueva definición.
Lo que viene después.
Esta vista comunica la dirección actual del proyecto. El alcance y el orden pueden cambiar según validación técnica y pruebas en campo.
v1.7Disponible
Base local inteligente
- Multi-inversor y drivers desde el panel
- Informes con modelos locales de IA
- Historial, diagnóstico y pronóstico
v1.8En proyección
Ecosistema de drivers
- Marketplace y catálogo verificable
- Compatibilidad y versiones por driver
- Flujo de prueba y publicación
- Más drivers para inversores y BMS
v1.9En estudio
Operación avanzada confiable
- Ampliación de la observabilidad y el mantenimiento guiado
- Mayor cobertura y coherencia multilingüe
- Validación avanzada de las lecturas de batería entre inversor, BMS y shunt
- Decodificación de alarmas por fabricante y automatización con múltiples acciones
FuturoDirección
Multi-sitio con agentes
- Una Raspberry Pi coordinadora al frente de la instalación
- Agentes colectores en Raspberry Pi o ESP32
- Backups en la nube
- Gestión de múltiples instalaciones
- Integración con Grafana para dashboards personalizados
- Notificaciones en tiempo real mediante canales configurables por el usuario
¿Listo para instalar?
Descarga la versión estable o revisa el código fuente y la evolución del proyecto.