Zurück zur WebsiteStart- und Dokumentationszentrum

Vom leeren Raspberry Pi zum ersten Energiewert.

Eine schrittweise Anleitung zur Installation von HelioPulse, seiner Architektur, dem Anschließen von Geräten und der Erweiterung durch Treiber.

Basierend auf HelioPulse OS 1.7.0 Anleitung auf das Repository abgestimmt
Rundgang durch das echte Produkt

Sieh dir die Schritte vor der Installation an.

Die Anleitung ist mit echten Bildschirmen aus der laufenden HelioPulse-Installation illustriert.

Einrichtung und AnmeldungEinrichtung und Anmeldung

Einrichtung und Anmeldung

Starte im Browser, ohne SSH.

Live-EnergieübersichtLive-Energieübersicht

Live-Energieübersicht

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

TreibereditorTreibereditor

Treibereditor

Erstelle einen Modbus-Treiber aus einer JSON-Definition.

Was HelioPulse heute bietet

Eine lokale Energieplattform, die du jetzt nutzen kannst.

Das aktuelle Produkt verbindet Live-Monitoring, lokale Historie, Geräteverwaltung und sichere Abläufe auf dem Raspberry Pi.

Heute verfügbar

Lokal-first-Monitoring

Bewahre Telemetrie und Historie auf dem Appliance auf und arbeite ohne Internet im lokalen Netzwerk weiter.

Live-Telemetrie mit Qualitätsstatus

Sieh Solarenergie, Verbrauch, Batterie, Netz und Gerätezustand über Live-Updates per WebSocket.

Historische Analyse

Untersuche Produktion, Verbrauch, SOC, Temperaturen und Phasen von heute bis zu einem eigenen Zeitraum oder einem Jahr.

Validierte JSON-Treiber

Lade, erstelle und verwende deklarative Modbus-Treiber ohne das Panel neu zu schreiben.

Betrieb mehrerer Geräte

Verwalte unabhängige Collector, stabile serielle Ports, Gerätezustände und Start/Stop/Restart-Aktionen.

Alarme und Ereignisverlauf

Verfolge Alarmwechsel, bestätige Vorfälle und prüfe Verbindungs-, Konfigurations- und Collector-Ereignisse.

Tägliche und wöchentliche Berichte

Erstelle deterministische Berichte zu Energie, Anomalien, Alarmen und Ereignissen; lokale KI ist optional.

Zustand, Backups und Wiederherstellung

Prüfe Raspberry-Ressourcen, Verbindung und Diagnose, erstelle Backups und stelle lokal wieder her.

Responsive, mehrsprachige Oberfläche

Nutze das Panel auf Desktop oder Mobilgeräten mit neun Sprachen sowie hellen und dunklen Themen.

Optional und erweitert

Solarprognose

Vergleiche erwartete und erzeugte Solarenergie nach der Konfiguration des PV-Arrays.

BMS über Modbus RTU

Registriere ein kompatibles BMS als eigenes Gerät und prüfe Zellen, Balancing, SOC, SOH, Temperaturen und Zyklen.

Simulationsmodus

Erzeuge synthetische Telemetrie aus einem Treiber, um die Oberfläche ohne Hardware zu prüfen.

Lokale KI für Berichte

Lade optional ein lokales Modell herunter und aktiviere es; deterministische Berichte bleiben ohne Modell verfügbar.

MQTT und Home Assistant

Veröffentliche Daten optional per TLS an einen Broker und nutze Home-Assistant-Discovery.

Lokale Automatisierungen

Nutze Grenzwerte, Zeitpläne, Alarme oder Ereignisse für MQTT, Webhooks oder Ereignisprotokolle; ein Dry-Run ist verfügbar.

Fernzugriff und App-OTA

Zugriff per ausgehendem Tunnel und signierte App-Updates hängen von Konfiguration und Verbindung ab.

Zukunftsplan

Cloud-Synchronisierung

Ist nicht Teil des aktuellen lokalen Ablaufs.

Treiber-Marktplatz

Manuelles Laden von Treibern ist heute möglich; ein öffentlicher Marktplatz folgt später.

Proprietäre BMS-Protokolle

CAN, BLE und nicht auf Modbus basierende JK-Protokolle werden derzeit nicht unterstützt.

Automatische Wechselrichter-Schreibvorgänge

Automatisierungen schreiben in dieser Version keine Wechselrichterparameter.

Vollständiges A/B-OS-Rollback

App-OTA ist separat verfügbar; ein A/B-Rollback des gesamten Betriebssystems folgt später.

01Inbetriebnahme

Bereite die Appliance vor.

HelioPulse OS ist ein Linux-Image für Raspberry Pi zur lokalen Energieüberwachung.

Raspberry Pi 4 oder 5

Pi 4 mit 4 GB oder Pi 5 mit 4/8 GB.

Speicher

Empfohlen: 128-GB-USB-3.0-SSD oder High-Endurance-microSD.

Kommunikation

USB–RS485-Adapter mit galvanischer Trennung.

  1. 1

    Stabile Version herunterladen

    Lade das Image aus dem öffentlichen Releases-Repository und lies die Versionshinweise.

    Alle Versionen ansehen
  2. 2

    Image schreiben

    Verwende Raspberry Pi Imager oder ein gleichwertiges Werkzeug. Wähle Datei und Ziel-SSD oder microSD.

  3. 3

    Verbinden und einschalten

    Verbinde Speicher, Netzwerk, USB–RS485-Adapter und ein passendes offizielles Raspberry-Pi-Netzteil.

Arbeite bei ausgeschaltetem System

Verdrahte RS485 nach dem Handbuch des Herstellers. Berühre keine Anschlüsse eines eingeschalteten Wechselrichters.

02Erster Start

Im Browser konfigurieren.

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.

Lokales NetzwerkRaspberry Pi finden
Erstes KontoSichere Zugangsdaten erstellen
Erstes GerätTreiber, Port und Slave-ID
  1. 1

    Karte einsetzen und einschalten

    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.

  2. 2

    Mit dem HelioPulse-Netzwerk verbinden

    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.

  3. 3

    1. Mit dem Internet verbinden

    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.

  4. 4

    2. Administrator erstellen

    Lege Benutzername und Passwort (mindestens 8 Zeichen) fest, mit denen du dich am Panel anmeldest. Bewahre sie sicher auf: Das ist dein Administratorkonto.

  5. 5

    Optional: Fernzugriff aktivieren

    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.

  6. 6

    3. Einsatzbereit

    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.

1. Mit dem Internet verbinden1. Mit dem Internet verbinden

1. Mit dem Internet verbinden

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

2. Administrator erstellen2. Administrator erstellen

2. Administrator erstellen

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

3. Einsatzbereit3. Einsatzbereit

3. Einsatzbereit

Wechsle zurück ins gewohnte Netzwerk und öffne die angezeigte Panel-Adresse.

Für Handy und Laptop gestaltet

Das Portal ist ein responsiver, geführter Ablauf mit Fortschrittsbalken und hellem/dunklem Design. Keine App, kein SSH und keine Kabel zu deinem Computer.

03Funktionsweise

Eine lokale, modulare Plattform.

Jedes Gerät hat einen unabhängigen Collector. Ein Fehler oder Neustart in einem Wechselrichter unterbricht die Telemetrie der anderen nicht.

01

Gerät

Der Wechselrichter oder das BMS stellt Daten über sein Protokoll bereit.

02

Treiber

Beschreibt Protokoll, Register, Skalierung und Metriken.

03

Sammler

Liest jedes Gerät in einem isolierten, steuerbaren Prozess.

04

Bedienfeld

Führt Telemetrie, Historie, Alarme und Prognosen zusammen.

04Treiber

Der Übersetzer zwischen Gerät und HelioPulse.

Ein Treiber ist eine deklarative JSON-Datei. Er beschreibt die Kommunikation über Modbus RTU und die Umwandlung von Herstellerregistern in gemeinsame HelioPulse-Metriken.

Kein ausführbarer Code

Das Paket beschreibt Daten und installiert keine beliebigen Binärdateien im System.

Validierung vor dem Speichern

Das Backend prüft Struktur, Protokoll und Register, bevor es die Datei akzeptiert.

Wiederverwendbar

Derselbe Treiber kann mit mehreren kompatiblen Geräten verwendet werden.

05Treiber erstellen

Beginne mit der Modbus-Karte.

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.

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

Vor der Veröffentlichung

  • Verwende eine stabile, sichere ID als Dateinamen.
  • Bestätige Baudrate, Parität, Stopbits und Slave-ID.
  • Prüfe Adresse, Vorzeichen, Skalierung und Einheit jedes Registers.
  • Vergleiche Leistung und Energie mit dem physischen Gerätepanel.
  • Teste Verbindungsabbrüche und Werte außerhalb des Bereichs.
06Laden und verbinden

Ohne SSH aktivieren.

Schritt 1

JSON hochladen

Wähle die Datei unter Geräte → Treiber. HelioPulse prüft das Schema vor dem Speichern.

Schritt 2

Gerät registrieren

Lege Geräte-ID, Treiber, persistenten by-id-Port und eine Slave-ID von 1 bis 247 fest.

Schritt 3

Collector starten

Starte oder starte nur dieses Gerät neu und bestätige die aktive Telemetrie.

Kontrollierter Austausch

Eine weitere Datei mit derselben ID aktualisiert den Treiber. Starte zugehörige Geräte neu, um die neue Definition anzuwenden.

07Ausblick auf Versionen

Was als Nächstes kommt.

Diese Ansicht zeigt die aktuelle Richtung des Projekts. Umfang und Reihenfolge können sich nach technischer Prüfung und Feldtests ändern.

v1.7Verfügbar

Intelligente lokale Grundlage

  • Multi-Wechselrichter und Panel-Treiber
  • Berichte mit lokalen KI-Modellen
  • Historie, Diagnose und Prognose
v1.8Geplant

Treiber-Ökosystem

  • Marktplatz und überprüfbarer Katalog
  • Kompatibilität und Treiberversionen
  • Test- und Veröffentlichungsablauf
  • Weitere Wechselrichter- und BMS-Treiber
v1.9In Prüfung

Zuverlässiger fortgeschrittener Betrieb

  • Erweiterte Beobachtbarkeit und geführte Wartung
  • Breitere Mehrsprachigkeit und Konsistenz
  • Fortgeschrittene Prüfung von Batteriewerten aus Wechselrichter, BMS und Shunt
  • Herstellerspezifische Alarmdecodierung und umfangreichere Automatisierung mit mehreren Aktionen
ZukunftRichtung

Multi-Standort mit Agenten

  • Primär-Agent-Architektur mit einem koordinierenden Raspberry Pi
  • Collector-Agenten auf Raspberry Pi oder ESP32
  • Cloud-Backups
  • Verwaltung mehrerer Installationen
  • Grafana-Integration für benutzerdefinierte Dashboards
  • Echtzeitbenachrichtigungen über vom Benutzer konfigurierbare Kanäle

Bereit für die Installation?

Lade die stabile Version herunter oder sieh dir Quellcode und Projektentwicklung an.

Versionen
Erste Schritte: HelioPulse auf einem Raspberry Pi installieren | HelioPulse