

Einrichtung und Anmeldung
Starte im Browser, ohne SSH.
Eine schrittweise Anleitung zur Installation von HelioPulse, seiner Architektur, dem Anschließen von Geräten und der Erweiterung durch Treiber.
Die Anleitung ist mit echten Bildschirmen aus der laufenden HelioPulse-Installation illustriert.


Starte im Browser, ohne SSH.


Bestätige, dass das System Produktion und Verbrauch meldet.


Erstelle einen Modbus-Treiber aus einer JSON-Definition.
Das aktuelle Produkt verbindet Live-Monitoring, lokale Historie, Geräteverwaltung und sichere Abläufe auf dem Raspberry Pi.
Bewahre Telemetrie und Historie auf dem Appliance auf und arbeite ohne Internet im lokalen Netzwerk weiter.
Sieh Solarenergie, Verbrauch, Batterie, Netz und Gerätezustand über Live-Updates per WebSocket.
Untersuche Produktion, Verbrauch, SOC, Temperaturen und Phasen von heute bis zu einem eigenen Zeitraum oder einem Jahr.
Lade, erstelle und verwende deklarative Modbus-Treiber ohne das Panel neu zu schreiben.
Verwalte unabhängige Collector, stabile serielle Ports, Gerätezustände und Start/Stop/Restart-Aktionen.
Verfolge Alarmwechsel, bestätige Vorfälle und prüfe Verbindungs-, Konfigurations- und Collector-Ereignisse.
Erstelle deterministische Berichte zu Energie, Anomalien, Alarmen und Ereignissen; lokale KI ist optional.
Prüfe Raspberry-Ressourcen, Verbindung und Diagnose, erstelle Backups und stelle lokal wieder her.
Nutze das Panel auf Desktop oder Mobilgeräten mit neun Sprachen sowie hellen und dunklen Themen.
Vergleiche erwartete und erzeugte Solarenergie nach der Konfiguration des PV-Arrays.
Registriere ein kompatibles BMS als eigenes Gerät und prüfe Zellen, Balancing, SOC, SOH, Temperaturen und Zyklen.
Erzeuge synthetische Telemetrie aus einem Treiber, um die Oberfläche ohne Hardware zu prüfen.
Lade optional ein lokales Modell herunter und aktiviere es; deterministische Berichte bleiben ohne Modell verfügbar.
Veröffentliche Daten optional per TLS an einen Broker und nutze Home-Assistant-Discovery.
Nutze Grenzwerte, Zeitpläne, Alarme oder Ereignisse für MQTT, Webhooks oder Ereignisprotokolle; ein Dry-Run ist verfügbar.
Zugriff per ausgehendem Tunnel und signierte App-Updates hängen von Konfiguration und Verbindung ab.
Ist nicht Teil des aktuellen lokalen Ablaufs.
Manuelles Laden von Treibern ist heute möglich; ein öffentlicher Marktplatz folgt später.
CAN, BLE und nicht auf Modbus basierende JK-Protokolle werden derzeit nicht unterstützt.
Automatisierungen schreiben in dieser Version keine Wechselrichterparameter.
App-OTA ist separat verfügbar; ein A/B-Rollback des gesamten Betriebssystems folgt später.
HelioPulse OS ist ein Linux-Image für Raspberry Pi zur lokalen Energieüberwachung.
Pi 4 mit 4 GB oder Pi 5 mit 4/8 GB.
Empfohlen: 128-GB-USB-3.0-SSD oder High-Endurance-microSD.
USB–RS485-Adapter mit galvanischer Trennung.
Lade das Image aus dem öffentlichen Releases-Repository und lies die Versionshinweise.
Alle Versionen ansehenVerwende Raspberry Pi Imager oder ein gleichwertiges Werkzeug. Wähle Datei und Ziel-SSD oder microSD.
Verbinde Speicher, Netzwerk, USB–RS485-Adapter und ein passendes offizielles Raspberry-Pi-Netzteil.
Verdrahte RS485 nach dem Handbuch des Herstellers. Berühre keine Anschlüsse eines eingeschalteten Wechselrichters.
Beim ersten Start öffnet das Gerät ein Captive Portal im Browser: WLAN verbinden, Administrator erstellen und abschließen. Kein SSH, keine Kabel zu deinem Computer.
Stecke die geflashte microSD in den Raspberry Pi und schließe die Stromversorgung an. Der erste Start erweitert das System und startet HelioPulse; warte eine Minute.
Verbinde dich mit deinem Handy oder Laptop mit dem temporären WLAN, das das Gerät erstellt. Das Setup-Portal öffnet sich automatisch im Browser; andernfalls öffne die auf dem Bildschirm angezeigte Adresse.
Wähle dein Heim-WLAN und gib das Passwort ein, oder fahre mit einem Netzwerkkabel fort. Die Signalstärke hilft, das richtige Netzwerk zu finden.
Lege Benutzername und Passwort (mindestens 8 Zeichen) fest, mit denen du dich am Panel anmeldest. Bewahre sie sicher auf: Das ist dein Administratorkonto.
Wenn dein Gerät es unterstützt, wähle einen Namen, um das Panel sicher über das Internet zu öffnen. Der lokale Zugriff funktioniert immer, du kannst diesen Schritt also überspringen.
Das Portal bestätigt den Abschluss und zeigt die Panel-Adresse. Wechsle zurück ins gewohnte Netzwerk und öffne sie, um dich mit dem erstellten Konto anzumelden.


Wähle dein WLAN (oder fahre mit Netzwerkkabel fort).


Lege die Zugangsdaten für die Anmeldung am Panel fest.


Wechsle zurück ins gewohnte Netzwerk und öffne die angezeigte Panel-Adresse.
Das Portal ist ein responsiver, geführter Ablauf mit Fortschrittsbalken und hellem/dunklem Design. Keine App, kein SSH und keine Kabel zu deinem Computer.
Jedes Gerät hat einen unabhängigen Collector. Ein Fehler oder Neustart in einem Wechselrichter unterbricht die Telemetrie der anderen nicht.
Der Wechselrichter oder das BMS stellt Daten über sein Protokoll bereit.
Beschreibt Protokoll, Register, Skalierung und Metriken.
Liest jedes Gerät in einem isolierten, steuerbaren Prozess.
Führt Telemetrie, Historie, Alarme und Prognosen zusammen.
Ein Treiber ist eine deklarative JSON-Datei. Er beschreibt die Kommunikation über Modbus RTU und die Umwandlung von Herstellerregistern in gemeinsame HelioPulse-Metriken.
Das Paket beschreibt Daten und installiert keine beliebigen Binärdateien im System.
Das Backend prüft Struktur, Protokoll und Register, bevor es die Datei akzeptiert.
Derselbe Treiber kann mit mehreren kompatiblen Geräten verwendet werden.
Du brauchst das Protokollhandbuch des Herstellers und verifizierte Messwerte eines echten Geräts. Das Mindestschema verlangt eine Kennung, das Protokoll modbus_rtu und mindestens eine Gruppe mit einem Register.
{
"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
}]
}]
}Wähle die Datei unter Geräte → Treiber. HelioPulse prüft das Schema vor dem Speichern.
Lege Geräte-ID, Treiber, persistenten by-id-Port und eine Slave-ID von 1 bis 247 fest.
Starte oder starte nur dieses Gerät neu und bestätige die aktive Telemetrie.
Eine weitere Datei mit derselben ID aktualisiert den Treiber. Starte zugehörige Geräte neu, um die neue Definition anzuwenden.
Diese Ansicht zeigt die aktuelle Richtung des Projekts. Umfang und Reihenfolge können sich nach technischer Prüfung und Feldtests ändern.
Lade die stabile Version herunter oder sieh dir Quellcode und Projektentwicklung an.