Retour au siteCentre de démarrage et de documentation

D’un Raspberry vide à votre première donnée énergétique.

Un guide progressif pour installer HelioPulse, comprendre son architecture, connecter des équipements et étendre la plateforme avec des pilotes.

Basé sur HelioPulse OS 1.7.0 Instructions alignées sur le dépôt
Parcours du produit réel

Découvrez les étapes avant l’installation.

Le guide est illustré par de vrais écrans de l’installation HelioPulse en service.

Configuration et connexionConfiguration et connexion

Configuration et connexion

Commencez dans le navigateur, sans SSH.

Vue énergétique en directVue énergétique en direct

Vue énergétique en direct

Vérifiez que le système transmet production et consommation.

Éditeur de pilotesÉditeur de pilotes

Éditeur de pilotes

Créez un pilote Modbus à partir d’une définition JSON.

Ce que HelioPulse propose aujourd’hui

Une plateforme énergétique locale utilisable dès maintenant.

Le produit actuel réunit suivi en direct, historique local, gestion des équipements et opérations sûres sur Raspberry Pi.

Disponible aujourd’hui

Surveillance local-first

Conservez télémétrie et historique sur l’appliance et continuez à travailler sur le réseau local sans Internet.

Télémétrie en direct avec qualité

Visualisez solaire, consommation, batterie, réseau et connexion des équipements grâce aux mises à jour WebSocket.

Analyse historique

Explorez production, consommation, SOC, températures et phases, d’aujourd’hui à une période personnalisée ou un an.

Pilotes JSON validés

Chargez, créez et réutilisez des pilotes Modbus déclaratifs sans réécrire le panneau.

Opérations multi-équipements

Gérez des collectors indépendants, des ports série stables, l’état des équipements et les actions start/stop/restart.

Alarmes et chronologie des événements

Suivez les transitions d’alarme, acquittez les incidents et auditez les événements de connexion, de configuration et de collector.

Rapports quotidiens et hebdomadaires

Générez des rapports déterministes sur l’énergie, les anomalies, les alarmes et les événements ; l’IA locale est optionnelle.

État, sauvegardes et récupération

Inspectez les ressources, la connectivité et le diagnostic du Raspberry ; créez des sauvegardes et restaurez localement.

Interface responsive et multilingue

Utilisez le panneau sur ordinateur ou mobile avec neuf langues et des thèmes clair/sombre.

Optionnel et avancé

Prévision solaire

Comparez l’énergie solaire prévue et produite après configuration du champ PV.

BMS via Modbus RTU

Enregistrez un BMS compatible comme équipement distinct et consultez cellules, équilibrage, SOC, SOH, températures et cycles.

Mode simulé

Générez une télémétrie synthétique depuis un pilote pour valider l’interface sans matériel.

IA locale pour les rapports

Téléchargez et activez éventuellement un modèle local ; les rapports déterministes restent disponibles sans lui.

MQTT et Home Assistant

Publiez vers un broker optionnel avec TLS et la découverte Home Assistant.

Automatisations locales

Utilisez seuils, horaires, alarmes ou événements pour publier MQTT, appeler des webhooks ou journaliser des événements ; le dry-run est disponible.

Accès distant et OTA de l’application

L’accès par tunnel sortant et les mises à jour signées dépendent de la configuration et de la connectivité.

Feuille de route

Synchronisation cloud

Ne fait pas partie du flux local actuel.

Marketplace de pilotes

Le chargement manuel des pilotes existe aujourd’hui ; une marketplace publique reste à venir.

Protocoles BMS propriétaires

CAN, BLE et protocoles JK sans Modbus ne font pas partie du parcours pris en charge actuellement.

Écritures automatiques dans les onduleurs

Les automatisations n’écrivent pas les paramètres de l’onduleur dans cette version.

Rollback A/B complet du système

L’OTA de l’application est disponible séparément ; le rollback A/B complet du système d’exploitation reste à venir.

01Mise en place

Préparez l’appliance.

HelioPulse OS est une image Linux pour Raspberry Pi conçue pour le suivi énergétique local.

Raspberry Pi 4 ou 5

Pi 4 avec 4 Go ou Pi 5 avec 4/8 Go.

Stockage

SSD USB 3.0 de 128 Go recommandé ou microSD High Endurance.

Liaison

Adaptateur USB–RS485 avec isolation galvanique.

  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.

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

Travaillez hors tension

Câblez le RS485 selon le manuel du fabricant. Ne manipulez pas de connexions d’onduleur sous tension.

02Premier démarrage

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.

Réseau localRepérez le Raspberry Pi
Compte initialCréez des identifiants sûrs
Premier équipementPilote, port et slave ID
  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 temporaire que crée l’appareil. Le portail de configuration s’ouvre automatiquement dans le navigateur ; sinon, ouvrez l’adresse affichée à l’écran.

  3. 3

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

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

    3. Prêt à l’emploi

    Le portail confirme la fin de la configuration et affiche l’adresse du panneau. Revenez à votre réseau habituel et ouvrez-le pour vous connecter avec le compte créé.

1. Connectez-vous à Internet1. Connectez-vous à Internet

1. Connectez-vous à Internet

Choisissez votre réseau Wi-Fi (ou continuez avec un câble réseau).

2. Créez votre administrateur2. Créez votre administrateur

2. Créez votre administrateur

Définissez les identifiants pour vous connecter au panneau.

3. Prêt à l’emploi3. Prêt à l’emploi

3. Prêt à l’emploi

Revenez à votre réseau habituel et ouvrez l’adresse du panneau indiquée.

Conçu pour téléphone et ordinateur

Le portail est un parcours guidé et responsive, avec barre de progression et thèmes clair/sombre. Sans application, sans SSH ni câbles vers votre ordinateur.

03Fonctionnement

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.

01

Équipement

L’onduleur ou le BMS expose ses données via son protocole.

02

Pilote

Décrit le protocole, les registres, les échelles et les métriques.

03

Collecteur

Lit chaque équipement dans un processus isolé et contrôlable.

04

Panneau

Consolide télémétrie, historique, alarmes et prévisions.

04Pilotes

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.

Sans code exécutable

Le paquet décrit des données ; il n’installe pas de binaires arbitraires sur le système.

Validation avant enregistrement

Le backend vérifie la structure, le protocole et les registres avant d’accepter le fichier.

Réutilisable

Le même pilote peut servir à plusieurs équipements compatibles.

05Créer un pilote

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.

my-inverter-modbus.json Exemple minimal
{
  "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
    }]
  }]
}

Avant publication

  • Utilisez un ID stable et sûr pour le nom du fichier.
  • Confirmez le baud rate, la parité, les stop bits et le slave ID.
  • Vérifiez adresse, signe, échelle et unité de chaque registre.
  • Comparez puissance et énergie avec le panneau physique de l’appareil.
  • Testez les déconnexions et les valeurs hors limites.
06Charger et connecter

Activez-la sans SSH.

Étape 1

Importez le JSON

Dans Équipements → Pilotes, sélectionnez le fichier. HelioPulse valide le schéma avant de l’enregistrer.

Étape 2

Enregistrez l’équipement

Définissez un device ID, le pilote, le port persistant by-id et un slave ID entre 1 et 247.

Étape 3

Démarrez le collector

Démarrez ou redémarrez uniquement cet équipement et confirmez que la télémétrie est active.

Remplacement contrôlé

Importer un autre fichier avec le même ID met à jour le pilote. Redémarrez les équipements associés pour appliquer la nouvelle définition.

07Perspectives de versions

La suite.

Cette vue présente la direction actuelle du projet. Le périmètre et l’ordre peuvent évoluer après validation technique et essais sur le terrain.

v1.7Disponible

Fondation locale intelligente

  • Multi-onduleur et pilotes depuis le panneau
  • Rapports avec modèles d’IA locaux
  • Historique, diagnostic et prévisions
v1.8Projeté

Écosystème de pilotes

  • Marketplace et catalogue vérifiable
  • Compatibilité et versions des pilotes
  • Flux de test et de publication
  • Davantage de pilotes d’onduleurs et de BMS
v1.9À l’étude

Opérations avancées fiables

  • Observabilité et maintenance guidée renforcées
  • Couverture et cohérence multilingues accrues
  • Validation avancée des lectures de batterie entre onduleur, BMS et shunt
  • Décodage des alarmes par fabricant et automatisation avec plusieurs actions
FuturOrientation

Multi-site avec agents

  • Un Raspberry Pi principal coordonne l’installation
  • Agents collecteurs sur Raspberry Pi ou ESP32
  • Sauvegardes cloud
  • Gestion de plusieurs installations
  • Intégration Grafana pour des tableaux de bord personnalisés
  • Notifications en temps réel via des canaux configurables par l’utilisateur

Prêt à installer ?

Téléchargez la version stable ou consultez le code source et l’évolution du projet.

Versions
Démarrage : installez HelioPulse sur un Raspberry Pi | HelioPulse