Instala HelioPulse a tu manera.

Instala HelioPulse OS en una Raspberry Pi.

HelioPulse OS es una imagen Linux lista para usar en Raspberry Pi: sistema, panel y actualizaciones en una sola instalación pensada para el monitoreo energético local.

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

   Descargar última imagen · 2.0 GBVer todas las versiones
2. 2

   Graba la imagen

   Usa Raspberry Pi Imager o una herramienta equivalente. Selecciona el archivo descargado y el SSD o microSD de destino.

3. 3

   Conecta y enciende

   Conecta almacenamiento, red, adaptador USB–RS485 y la fuente oficial adecuada para tu Raspberry.

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.

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

   Conéctate a la red HelioPulse

   Desde tu teléfono o computadora, conéctate a la red Wi-Fi abierta HelioPulse-XXXX (sin contraseña) que crea el equipo. Luego abre el navegador y entra a http://heliopulse.setup:8090 para ver el portal de configuración. En algunos teléfonos el portal se abre solo al conectarte; si no, escribe esa dirección manualmente.

3. 3

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

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

   Listo para usar

   El portal confirma que la configuración terminó. A partir de ahora el equipo ya está en tu red Wi-Fi: vuelve a tu red habitual y entra al panel en http://heliopulse.local:8080 con la cuenta que creaste. La red HelioPulse-XXXX desaparece porque ya no hace falta.

Ejecuta HelioPulse en Docker.

En lugar de grabar una imagen, descarga el contenedor en un mini-PC, NAS o servidor. El mismo núcleo, sin Raspberry: los colectores ESP32 se conectan por la red, y los adaptadores USB-RS485 y el acceso remoto funcionan igual que en HelioPulse OS.

1. 1

   Inicia el contenedor

   Usa docker run para una prueba rápida o Docker Compose para una instalación permanente. La imagen elige tu arquitectura automáticamente.

   Docker Composedocker run

   Copiar

   # compose.yml — instalación 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

   Abre el panel

   Entra a http://<IP-del-equipo>:8080 desde cualquier dispositivo de tu red y crea tu cuenta de administrador en el asistente inicial.

   Desde fuera de tu red local (por ejemplo, con un puerto publicado a Internet), el asistente pide un código de configuración de un solo uso; léelo con docker exec heliopulse cat /data/config/bootstrap-token. Después configura Sistema › General › Ubicación del sitio: los totales diarios, los informes y los horarios usan su zona horaria.

3. 3

   Mantenlo actualizado

   Actualizar es reemplazar la imagen: descarga la nueva versión y recrea el contenedor. Tus datos siguen en el volumen.

   Mantenlo actualizadoCopiar

   # Actualizar a una nueva versión (reemplazo de imagen):
   docker compose pull && docker compose up -d

Instala la App de Home Assistant.

Ejecuta HelioPulse como App dentro de Home Assistant OS, con acceso lateral, sesión de administrador y sensores MQTT.

1. 1

   Añade el repositorio

   Abre Ajustes → Apps → Tienda de Apps → ⋮ → Repositorios y añade el repositorio público indicado abajo.

   Añade el repositorioCopiar

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

   Añadir a mi Home Assistant
2. 2

   Instala y abre HelioPulse

   Busca HelioPulse, instálalo e inícialo. Activa Mostrar en la barra lateral y abre HelioPulse con tu sesión de administrador de Home Assistant.

3. 3

   Conecta los sensores (opcional)

   Para los sensores, configura Mosquitto y la integración MQTT en Home Assistant. Mantén mqtt_mode en auto y configura tus dispositivos en HelioPulse. Usa un topic_prefix distinto por instancia.

4. 4

   Actualiza con seguridad

   Instala las actualizaciones del App desde Home Assistant y crea antes una copia de seguridad. Las versiones del App son independientes de HelioPulse OS y sus OTA.

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.

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.

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.

{
  "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
    }]
  }]
}

Actívalo sin usar SSH.