

Configuration et connexion
Commencez dans le navigateur, sans SSH.
Un guide progressif pour installer HelioPulse, comprendre son architecture, connecter des équipements et étendre la plateforme avec des pilotes.
Le guide est illustré par de vrais écrans de l’installation HelioPulse en service.


Commencez dans le navigateur, sans SSH.


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


Créez un pilote Modbus à partir d’une définition JSON.
Le produit actuel réunit suivi en direct, historique local, gestion des équipements et opérations sûres sur Raspberry Pi.
Conservez télémétrie et historique sur l’appliance et continuez à travailler sur le réseau local sans Internet.
Visualisez solaire, consommation, batterie, réseau et connexion des équipements grâce aux mises à jour WebSocket.
Explorez production, consommation, SOC, températures et phases, d’aujourd’hui à une période personnalisée ou un an.
Chargez, créez et réutilisez des pilotes Modbus déclaratifs sans réécrire le panneau.
Gérez des collectors indépendants, des ports série stables, l’état des équipements et les actions start/stop/restart.
Suivez les transitions d’alarme, acquittez les incidents et auditez les événements de connexion, de configuration et de collector.
Générez des rapports déterministes sur l’énergie, les anomalies, les alarmes et les événements ; l’IA locale est optionnelle.
Inspectez les ressources, la connectivité et le diagnostic du Raspberry ; créez des sauvegardes et restaurez localement.
Utilisez le panneau sur ordinateur ou mobile avec neuf langues et des thèmes clair/sombre.
Comparez l’énergie solaire prévue et produite après configuration du champ PV.
Enregistrez un BMS compatible comme équipement distinct et consultez cellules, équilibrage, SOC, SOH, températures et cycles.
Générez une télémétrie synthétique depuis un pilote pour valider l’interface sans matériel.
Téléchargez et activez éventuellement un modèle local ; les rapports déterministes restent disponibles sans lui.
Publiez vers un broker optionnel avec TLS et la découverte Home Assistant.
Utilisez seuils, horaires, alarmes ou événements pour publier MQTT, appeler des webhooks ou journaliser des événements ; le dry-run est disponible.
L’accès par tunnel sortant et les mises à jour signées dépendent de la configuration et de la connectivité.
Ne fait pas partie du flux local actuel.
Le chargement manuel des pilotes existe aujourd’hui ; une marketplace publique reste à venir.
CAN, BLE et protocoles JK sans Modbus ne font pas partie du parcours pris en charge actuellement.
Les automatisations n’écrivent pas les paramètres de l’onduleur dans cette version.
L’OTA de l’application est disponible séparément ; le rollback A/B complet du système d’exploitation reste à venir.
HelioPulse OS est une image Linux pour Raspberry Pi conçue pour le suivi énergétique local.
Pi 4 avec 4 Go ou Pi 5 avec 4/8 Go.
SSD USB 3.0 de 128 Go recommandé ou microSD High Endurance.
Adaptateur USB–RS485 avec isolation galvanique.
Obtenez l’image et consultez les notes de version dans le dépôt public des releases.
Voir toutes les versionsUtilisez Raspberry Pi Imager ou un outil équivalent. Sélectionnez le fichier téléchargé et le SSD ou la microSD de destination.
Branchez le stockage, le réseau, l’adaptateur USB–RS485 et l’alimentation officielle adaptée à votre Raspberry Pi.
Câblez le RS485 selon le manuel du fabricant. Ne manipulez pas de connexions d’onduleur sous tension.
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.
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.
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.
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.
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.
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.
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éé.


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


Définissez les identifiants pour vous connecter au panneau.


Revenez à votre réseau habituel et ouvrez l’adresse du panneau indiquée.
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.
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.
L’onduleur ou le BMS expose ses données via son protocole.
Décrit le protocole, les registres, les échelles et les métriques.
Lit chaque équipement dans un processus isolé et contrôlable.
Consolide télémétrie, historique, alarmes et prévisions.
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.
Le paquet décrit des données ; il n’installe pas de binaires arbitraires sur le système.
Le backend vérifie la structure, le protocole et les registres avant d’accepter le fichier.
Le même pilote peut servir à plusieurs équipements compatibles.
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
}]
}]
}Dans Équipements → Pilotes, sélectionnez le fichier. HelioPulse valide le schéma avant de l’enregistrer.
Définissez un device ID, le pilote, le port persistant by-id et un slave ID entre 1 et 247.
Démarrez ou redémarrez uniquement cet équipement et confirmez que la télémétrie est active.
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.
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.
Téléchargez la version stable ou consultez le code source et l’évolution du projet.