Zum Inhalt

Solar-Log & Inverter Monitor

Willkommen bei der Dokumentation des Solar-Log und Wechselrichter Monitoring Systems.

Übersicht

Dieses System ermöglicht die Überwachung und Datenaggregation verschiedener Wechselrichter-Typen in einer einheitlichen Benutzeroberfläche.

🌐 Live-System

📊 Unterstützte Wechselrichter

Das System unterstützt 8 führende Hersteller mit automatischer API-Konfiguration:

Produktionsreif implementiert:

  • SMA - Modbus TCP (Port 502)
  • Sunny Boy 3.0, 5.0

  • Sunny Tripower 10.0, 25.0

  • Delta - Modbus TCP (Port 502)

  • RPI M6A, M10A, M15A, M20A

  • RPI H6, H10

  • Kostal - HTTP REST API (Port 80)

  • PLENTICORE plus 4.2, 10
  • PIKO 10, 20

In Vorbereitung:

  • Fronius - HTTP Solar API
  • SolarEdge - SunSpec Modbus
  • Huawei - Modbus TCP
  • GoodWe - Modbus TCP
  • Growatt - Modbus TCP

✨ Hauptfunktionen

Datenerfassung

  • ⚡ Echtzeit-Leistungsdaten - Aktuelle AC/DC-Leistung
  • 📈 Produktionsstatistiken - Tages-, Monats- und Jahresertrag
  • 🔋 Batterie-Monitoring - SOC, SOH, Lade-/Entladeleistung, Temperatur
  • 🏠 Eigenverbrauch - Netzeinspeisung und Hausverbrauch
  • 📊 Grafana Dashboards - 11 Panels für Battery Storage System

Battery Storage System

  • 🔋 Multi-Battery Support - Verwaltung mehrerer Batteriespeicher
  • 📱 Card-Based UI - Material-UI Cards mit Statusanzeige
  • 🎯 Tab-basierte Dialoge - Allgemein, Verbindung, Simulator
  • 🖥️ ESP32 Simulator - E-Paper Display Preview (296×128)
  • 🌙 Realistische Demo-Daten - Tag/Nacht-Zyklen, auch nachts geladen
  • 📊 API-Protokolle - Modbus TCP, REST API, MQTT
  • 🏷️ Standort-Gruppierung - Organisation nach Location

Benutzeroberfläche

  • 🎨 Material-UI Design - Moderne, responsive Oberfläche
  • 📱 Mobile-First - Optimiert für alle Bildschirmgrößen
  • 🌓 Dark/Light Mode - Automatische Theme-Umschaltung
  • 🔄 Auto-Refresh - Live-Daten alle 10-60 Sekunden

Neue Features (Oktober 2025)

  • 🎯 Settings Page Integration - Batteries + Inverters zusammen
  • 🔋 Battery Management - CRUD Operations mit UUID-basierter API
  • 🖥️ Battery Simulator - Standalone ESP32 E-Paper Display
  • 📊 Grafana Dashboard - 11 Panels für Battery Monitoring
  • 🔐 Authentication - Username/Password für API-Zugriff
  • 👁️ Password Visibility Toggle - Sicheres Passwort-Management
  • 🎪 Demo Mode - Simulierte Daten für Tests (Inverters + Batteries)
  • 📡 EVCC Integration - Automatische API-Konfiguration

Deployment

  • 🐳 Docker Compose - Multi-Container Setup (Backend, Frontend, Postgres, Nginx)
  • ☁️ Cloudflare Tunnel - Sichere Fernverbindung ohne Port-Forwarding
  • 🔒 HTTPS - TLS-Verschlüsselung via Cloudflare
  • 📦 NixOS Support - Reproducible Builds mit Nix Flakes

Schnellstart

  1. Klonen Sie das Repository: 

    git clone https://github.com/yourusername/solarlog.git
cd solarlog

  2. Installieren Sie die Abhängigkeiten: 

    npm install

  3. Konfigurieren Sie Ihre Umgebungsvariablen: 

    cp .env.example .env
# Bearbeiten Sie .env mit Ihren Einstellungen

  4. Starten Sie die Anwendung: 

    npm run dev

Dokumentationsstruktur

  • Installation: Grundlegende Setup-Anweisungen
  • Konfiguration: Detaillierte Konfigurationsoptionen
  • Wechselrichter: Spezifische Dokumentation für jeden unterstützten Wechselrichter-Typ
  • API: API-Referenz und Beispiele
  • Entwicklung: Richtlinien für Entwickler