Installez HelioPulse à votre façon.

Installez HelioPulse OS sur un Raspberry Pi.

HelioPulse OS est une image Linux prête à l’emploi pour Raspberry Pi : système, panneau et mises à jour dans une seule installation conçue pour la supervision énergétique locale.

1. 1

   Téléchargez la version stable

   Obtenez l’image et consultez les notes de version dans le dépôt public des releases.

   Télécharger la dernière image · 2.0 GBVoir toutes les versions
2. 2

   Flashez l’image

   Utilisez Raspberry Pi Imager ou un outil équivalent. Sélectionnez le fichier téléchargé et le SSD ou la microSD de destination.

3. 3

   Branchez et démarrez

   Branchez le stockage, le réseau, l’adaptateur USB–RS485 et l’alimentation officielle adaptée à votre Raspberry Pi.

Configurez depuis votre navigateur.

Au premier démarrage, l’appareil ouvre un portail captif depuis votre navigateur : connectez le Wi-Fi, créez votre administrateur et terminez. Sans SSH ni câbles vers votre ordinateur.

1. 1

   Insérez la carte et allumez

   Placez la microSD gravée dans le Raspberry Pi et branchez l’alimentation. Le premier démarrage étend le système et lance HelioPulse ; patientez une minute.

2. 2

   Rejoignez le réseau HelioPulse

   Depuis votre téléphone ou ordinateur, connectez-vous au réseau Wi-Fi ouvert HelioPulse-XXXX (sans mot de passe) que crée l’appareil. Ouvrez ensuite le navigateur et allez sur http://heliopulse.setup:8090 pour accéder au portail de configuration. Sur certains téléphones le portail s’ouvre tout seul ; sinon, saisissez cette adresse.

3. 3

   Connectez-vous à Internet

   Choisissez votre Wi-Fi domestique et saisissez le mot de passe, ou continuez avec un câble réseau. La force du signal aide à repérer le bon réseau.

4. 4

   Créez votre administrateur

   Définissez le nom d’utilisateur et le mot de passe (au moins 8 caractères) pour vous connecter au panneau. Conservez-les : c’est votre compte administrateur.

5. 5

   Optionnel : activez l’accès distant

   Si votre appareil le permet, choisissez un nom pour ouvrir le panneau en toute sécurité via Internet. L’accès local fonctionne toujours, vous pouvez donc ignorer cette étape.

6. 6

   Prêt à l’emploi

   Le portail confirme la fin de la configuration. L’appareil est désormais sur votre Wi-Fi : revenez à votre réseau habituel et ouvrez le panneau sur http://heliopulse.local:8080 avec le compte créé. Le réseau HelioPulse-XXXX disparaît car il n’est plus nécessaire.

Exécutez HelioPulse avec Docker.

Au lieu de flasher une image, récupérez le conteneur sur un mini-PC, un NAS ou un serveur. Le même cœur, sans Raspberry : les collecteurs ESP32 se connectent par le réseau, et les adaptateurs USB-RS485 et l'accès à distance fonctionnent comme sur HelioPulse OS.

1. 1

   Démarrez le conteneur

   Utilisez docker run pour un essai rapide, ou Docker Compose pour une installation permanente. L’image sélectionne automatiquement votre architecture.

   Docker Composedocker run

   Copier

   # compose.yml — installation permanente (recommandée)
   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

   Ouvrez le panneau

   Ouvrez http://<IP-de-l’hôte>:8080 depuis n’importe quel appareil du réseau et créez votre compte administrateur dans l’assistant.

   Depuis l’extérieur de votre réseau local (par exemple, un port publié sur Internet), l’assistant demande un code de configuration à usage unique ; lisez-le avec docker exec heliopulse cat /data/config/bootstrap-token. Réglez ensuite Système › Général › Emplacement du site : les totaux journaliers, les rapports et les horaires utilisent son fuseau horaire.

3. 3

   Gardez-le à jour

   Mettre à jour revient à remplacer l’image : récupérez la nouvelle version et recréez le conteneur. Vos données restent dans le volume.

   Gardez-le à jourCopier

   # Mettre à jour vers une nouvelle version (remplacement d’image) :
   docker compose pull && docker compose up -d

Installez l’App Home Assistant.

Exécutez HelioPulse comme App dans Home Assistant OS, avec accès latéral, session administrateur et capteurs MQTT.

1. 1

   Ajoutez le dépôt

   Ouvrez Paramètres → Apps → Boutique d’Apps → ⋮ → Dépôts et ajoutez le dépôt public ci-dessous.

   Ajoutez le dépôtCopier

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

   Ajouter à mon Home Assistant
2. 2

   Installez et ouvrez HelioPulse

   Recherchez HelioPulse, installez-le et démarrez-le. Activez Afficher dans la barre latérale, puis ouvrez HelioPulse avec votre session administrateur Home Assistant.

3. 3

   Connectez les capteurs (optionnel)

   Pour les capteurs, configurez Mosquitto et l’intégration MQTT dans Home Assistant. Gardez mqtt_mode sur auto et configurez vos appareils dans HelioPulse. Utilisez un topic_prefix distinct par instance.

4. 4

   Mettez à jour en toute sécurité

   Installez les mises à jour de l’App depuis Home Assistant après une sauvegarde. Les versions de l’App sont indépendantes de HelioPulse OS et de ses mises à jour OTA.

Une plateforme locale et modulaire.

Chaque équipement possède un collector indépendant. Une panne ou un redémarrage d’un onduleur n’interrompt pas la télémétrie des autres.

Le traducteur entre votre équipement et HelioPulse.

Un pilote est un fichier JSON déclaratif. Il définit la communication en Modbus RTU et la conversion des registres fabricant en métriques communes HelioPulse.

Commencez par la carte Modbus.

Il vous faut le manuel du protocole fabricant et des mesures vérifiées sur un appareil réel. Le schéma minimal exige un identifiant, le protocole modbus_rtu et au moins un groupe contenant un registre.

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

Activez-la sans SSH.