Installiere HelioPulse auf deine Art.

Installiere HelioPulse OS auf einem Raspberry Pi.

HelioPulse OS ist ein sofort einsatzbereites Linux-Image für den Raspberry Pi: System, Panel und Updates in einer Installation, gemacht für lokales Energiemonitoring.

1. 1

   Stabile Version herunterladen

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

   Neuestes Image herunterladen · 2.0 GBAlle 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.

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.

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 offenen WLAN HelioPulse-XXXX (ohne Passwort), das das Gerät erstellt. Öffne dann den Browser und rufe http://heliopulse.setup:8090 auf, um zum Setup-Portal zu gelangen. Auf manchen Handys öffnet sich das Portal automatisch; andernfalls gib diese Adresse ein.

3. 3

   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

   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

   Einsatzbereit

   Das Portal bestätigt den Abschluss. Das Gerät ist jetzt in deinem WLAN: Wechsle zurück ins gewohnte Netzwerk und öffne das Panel unter http://heliopulse.local:8080 mit dem erstellten Konto. Das Netzwerk HelioPulse-XXXX verschwindet, da es nicht mehr benötigt wird.

Betreibe HelioPulse in Docker.

Statt ein Image zu flashen, ziehen Sie den Container auf einen Mini-PC, ein NAS oder einen Server. Derselbe Kern, ganz ohne Raspberry: ESP32-Kollektoren verbinden sich über das Netz, USB-RS485-Adapter und Fernzugriff funktionieren wie unter HelioPulse OS.

1. 1

   Container starten

   Nutze docker run zum schnellen Ausprobieren oder Docker Compose für eine dauerhafte Installation. Das Image wählt deine Architektur automatisch.

   Docker Composedocker run

   Kopieren

   # compose.yml — dauerhafte Installation (empfohlen)
   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

   Panel öffnen

   Öffne http://<Host-IP>:8080 von einem Gerät in deinem Netzwerk und lege im Einrichtungsassistenten dein Administratorkonto an.

   Von außerhalb deines lokalen Netzwerks (z. B. über einen ins Internet freigegebenen Port) fragt der Assistent nach einem einmaligen Einrichtungscode; du liest ihn mit docker exec heliopulse cat /data/config/bootstrap-token aus. Lege danach unter System › General › Site location den Standort fest: Tagessummen, Berichte und Zeitpläne verwenden dessen Zeitzone.

3. 3

   Aktuell halten

   Aktualisieren heißt Image ersetzen: neue Version ziehen und Container neu erstellen. Deine Daten bleiben im Volume.

   Aktuell haltenKopieren

   # Auf eine neue Version aktualisieren (Image-Austausch):
   docker compose pull && docker compose up -d

Installiere die Home-Assistant-App.

HelioPulse als App in Home Assistant OS ausführen – mit Seitenleiste, Administrator-Anmeldung und MQTT-Sensoren.

1. 1

   Repository hinzufügen

   Einstellungen → Apps → App-Store → ⋮ → Repositories öffnen und das öffentliche Repository unten hinzufügen.

   Repository hinzufügenKopieren

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

   Zu meinem Home Assistant hinzufügen
2. 2

   HelioPulse installieren und öffnen

   HelioPulse suchen, installieren und starten. In der Seitenleiste anzeigen aktivieren und HelioPulse mit der Home-Assistant-Administratorsitzung öffnen.

3. 3

   Sensoren verbinden (optional)

   Für Sensoren Mosquitto und die MQTT-Integration in Home Assistant einrichten. mqtt_mode auf auto belassen und Geräte in HelioPulse konfigurieren. Pro Instanz ein eigenes topic_prefix verwenden.

4. 4

   Sicher aktualisieren

   Vor Updates ein Backup erstellen und die App über Home Assistant aktualisieren. App-Versionen sind unabhängig von HelioPulse OS und dessen OTA-Updates.

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.

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.

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.

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

Ohne SSH aktivieren.