Bedienungsanleitung

Überblick

Das Spyra Rocks Photovoltaik Dashboard dient zur digitalen Anzeige und Auswertung einer Photovoltaikanlage. Die App zeigt aktuelle Leistungswerte, Tageserträge, Diagramme, Jahreswerte sowie ergänzende Wetter- und Sonneninformationen.

Die Daten werden lokal auf dem Server gespeichert und können über die integrierte Backupverwaltung gesichert werden.

Demo-Version

Für einen ersten Eindruck gibt es eine Demo-Version des Photovoltaik Dashboards. In der Demo können Funktionen ausprobiert werden, ohne produktive Anlagendaten zu verändern.

Demo öffnen

Ersteinrichtung

Beim ersten Start ist noch kein Passwort hinterlegt. Die App zeigt deshalb automatisch eine Ersteinrichtungsseite an.

1. Photovoltaik Dashboard im Browser öffnen.
2. Ein eigenes Passwort vergeben.
3. Passwort wiederholen.
4. Speichern.

Das Passwort wird als Hash gespeichert. Es gibt kein Standardpasswort, kein Masterpasswort und keine Hintertür im Code.

Cronjob einrichten

Damit das Photovoltaik Dashboard regelmäßig aktuelle Leistungs- und Ertragsdaten speichern kann, muss ein Cronjob eingerichtet werden.

Der Cronjob ruft in festen Abständen die Aktualisierungsadresse der App auf. Dadurch werden neue Werte automatisch abgefragt und in der Datenbank gespeichert, ohne dass das Dashboard dauerhaft im Browser geöffnet sein muss.

Die Aktualisierungsadresse hat folgenden Aufbau:

https://ihre-domain.de/pv-dashboard/index.php?action=collect&token=IHR-TOKEN

Der Platzhalter IHR-TOKEN muss durch den persönlichen Cronjob-Token der jeweiligen Installation ersetzt werden.

Der Cronjob sollte regelmäßig ausgeführt werden, zum Beispiel alle 5 oder 15 Minuten. Welche Einstellung sinnvoll ist, hängt von der gewünschten Aktualität der Daten und der jeweiligen Serverumgebung ab.

Anmeldung

Nach der Ersteinrichtung erscheint beim Aufruf der App die Loginseite.

1. Passwort eingeben.
2. Auf Anmelden klicken.
3. Nach erfolgreicher Anmeldung wird das Dashboard geöffnet.

Über Abmelden kann die Sitzung beendet werden.

Dashboard

Das Dashboard zeigt die wichtigsten Informationen zur Photovoltaikanlage auf einen Blick. Dazu gehören je nach Datenbestand aktuelle Leistung, Tagesertrag, Prognose, Gesamtertrag, Vergleichswerte, Diagramme sowie Wetter- und Sonneninformationen.

Die Kacheln helfen dabei, den aktuellen Zustand der Anlage schnell einzuschätzen und Erträge im Tages- und Jahresverlauf nachzuvollziehen.

Aktuelle Werte

Im Dashboard werden aktuelle Leistungs- und Ertragswerte angezeigt.

Typische Werte sind:

• aktuelle Leistung
• Prognose für den aktuellen Tag
• heute erzeugter Ertrag
• Gesamtertrag inklusive Startwert beziehungsweise Zählerstand
• Ertrag von gestern
• Ertrag vor 7 Tagen
• Durchschnittswerte
• bester gespeicherter Tag

Die angezeigten Werte hängen davon ab, welche Daten die angebundene Anlage liefert und welche Werte bereits gespeichert wurden.

Diagramme

Die Diagramme zeigen gespeicherte Leistungs- und Ertragsdaten grafisch an. So lassen sich Tagesverlauf und Entwicklung besser nachvollziehen.

Je nach Datenbestand können zum Beispiel Stundenwerte, Tageswerte oder längerfristige Verläufe dargestellt werden.

Wenn Diagramme leer oder unvollständig sind, fehlen meist gespeicherte Werte für den dargestellten Zeitraum. In diesem Fall sollten Cronjob, Datenquelle und Einstellungen geprüft werden.

Wetter & Sonne

Die Kachel Wetter & Sonne zeigt ergänzende Informationen wie Temperatur, Wetterlage, Bewölkung, Sonnenaufgang, Sonnenuntergang und Tageslichtdauer.

Diese Angaben helfen dabei, Ertragsschwankungen besser einzuordnen. Prognosen können wetterbedingt abweichen und ersetzen keine tatsächlich gespeicherten Ertragswerte.

Jahreserträge

Die Kachel Jahreserträge zeigt gespeicherte Jahreswerte. Das aktuelle Jahr wird als bisheriger Jahreswert dargestellt.

Wenn Vorjahresdaten vorhanden sind, kann das aktuelle Jahr mit dem Vorjahr verglichen werden. Für einen fairen Vergleich wird das aktuelle Jahr bis zum gleichen Datum betrachtet, sofern entsprechende Vergleichsdaten vorhanden sind.

Einstellungen

Im Bereich Einstellungen werden technische und organisatorische Angaben gepflegt.

Dazu können je nach Installation gehören:

• Passwort
• Datenquelle
• Cronjob-Token
• Startwert beziehungsweise Zählerstand
• Wartung
• Backups
• Systemcheck

Datenquelle und Aktualisierung

Das Photovoltaik Dashboard kann aktuelle Daten aus der angebundenen Wechselrichter- oder OpenDTU-Umgebung abrufen, sofern diese erreichbar und korrekt eingerichtet ist.

Die genaue Datenquelle wird in der Installation hinterlegt. Entscheidend ist, dass die App die benötigten Leistungs- und Ertragswerte regelmäßig abrufen kann.

Wenn keine neuen Werte gespeichert werden, sollte neben dem Cronjob auch geprüft werden, ob die Datenquelle erreichbar ist und aktuelle Werte liefert.

Passwort ändern

Das Passwort kann in den Einstellungen geändert werden.

1. Aktuelles Passwort eingeben.
2. Neues Passwort eingeben.
3. Neues Passwort wiederholen.
4. Änderung speichern.

Passwort zurücksetzen

Wenn das Passwort vergessen wurde, kann es über eine Reset-Datei zurückgesetzt werden. Diese Funktion ist bewusst an FTP-Zugriff gebunden.

1. Per FTP im App-Ordner die Datei data/passwort-reset.txt anlegen.
2. Der Inhalt der Datei ist egal, zum Beispiel RESET.
3. Im Browser die Reset-Seite öffnen: /pv-dashboard/?action=passwort_reset
4. Neues Passwort setzen.

Nach erfolgreichem Zurücksetzen wird die Reset-Datei automatisch entfernt.

Backups verwalten

Unter Einstellungen → Wartung → Backups verwalten können Sicherungen erstellt und verwaltet werden.

Mögliche Aktionen:

• neues Backup erstellen
• Backup herunterladen
• einzelnes Backup löschen
• Backup wiederherstellen
• alle Backups nach Sicherheitsabfrage löschen

Vor einer Wiederherstellung wird automatisch eine Sicherheitskopie erstellt.

Systemcheck

Der Systemcheck prüft, ob die App korrekt eingerichtet ist.

Geprüft werden unter anderem:

• benötigte Ordner
• Schreibrechte
• Schutzdateien
• Datenbankzugriff
• wichtige PHP-Funktionen

Über Zurück zur App gelangt man wieder ins Photovoltaik Dashboard.

Hinweise zur Nutzung

Das Photovoltaik Dashboard sollte regelmäßig Daten speichern können, damit Tageswerte, Diagramme und Jahresvergleiche nachvollziehbar bleiben.

Wenn keine neuen Daten angezeigt werden, sollten zuerst Cronjob, Datenquelle und Einstellungen geprüft werden.

Prognosewerte und Wetterdaten können abweichen. Entscheidend sind die tatsächlich gespeicherten Ertragswerte.

Der Ordner der App heißt pv-dashboard. Alte Pfade mit kraftwerk sollten nur noch berücksichtigt werden, wenn es sich bewusst um historische Installationen oder Umzüge handelt.