Phaeton-Handbuch
Mehrere Wallboxen
Betreiben Sie mehrere Wallboxen an einem Victron GX: eine Phaeton-Installation pro Wallbox, jede mit eigener Einrichtung und Lizenz; sobald der GX die Steuerung übernimmt, verteilt er die Leistung.
So funktioniert es
Phaeton läuft einmal pro Wallbox. Jede Wallbox am GX erhält eine eigene Phaeton-Installation: Weboberfläche und Port, Administratorkonto, Einstellungen, Ladeverlauf, Protokolle und Lizenz hat jede für sich. Jede erscheint auf dem GX und in VRM als eigene EV Charging Station.
- Jede physische Wallbox braucht eine eigene Lizenz. Eine zweite Wallbox im selben Haushalt kann die Lizenz „Weitere Wallbox im Haushalt“ nutzen; sie setzt eine erste oder kostenlose Privatlizenz im selben Haushalt voraus.
- Zwei Phaeton-Installationen dürfen niemals dieselbe physische Wallbox steuern.
- Um auf diese Weise Wallboxen hinzuzufügen, muss Phaeton auf dem GX selbst installiert sein.
Eine Wallbox hinzufügen
Installieren Sie Phaeton zuerst auf dem GX, per USB-Stick oder per SSH, und schließen Sie die Einrichtung ab. Dann:
- Öffnen Sie diese erste Phaeton-Installation, zum Beispiel über VRM → Device list → Control Panel, und melden Sie sich an.
- Öffnen Sie System → Chargers on this GX. Ist die erste Wallbox noch nicht aktiviert, hat auch die Aktivierungsseite eine Schaltfläche Chargers on this GX, sodass Sie eine Wallbox hinzufügen können, bevor Sie die erste aktivieren.
- Geben Sie der ersten Wallbox einen Namen, den Sie wiedererkennen, etwa Garage: Öffnen Sie unter Your chargers den Bereich Name, restart or uninstall, geben Sie den Charger name ein und wählen Sie Save name. Wählen Sie dann Restart charger, damit der GX und VRM den neuen Namen anzeigen.
- Geben Sie unter Add a charger einen Namen ein, etwa Einfahrt, und wählen Sie Add charger. Phaeton legt eine separate Installation an und gibt ihr einen freien Webport. Lassen Sie die Seite geöffnet, solange der Fortschrittsdialog angezeigt wird.
- Warten Sie, bis VRM die neue Wallbox in der Geräteliste zeigt, und öffnen Sie dann ihr Control Panel. Schließen Sie ihre Einrichtung mit einem eigenen Administratorkonto ab und aktivieren Sie sie mit einer eigenen Lizenz.
- Tragen Sie für jede Wallbox ihre eigene Integration und Adresse ein und prüfen Sie die gemeinsamen Stromgrenzen der Anlage.
Der Fernzugriff über VRM setzt voraus, dass der GX online ist, VRM Portal auf Full steht und Ihr VRM-Konto Einstellungen ändern darf. Ihre VRM-Anmeldung und die Phaeton-Konten bleiben getrennt. Jede hinzugefügte Wallbox öffnet sich auch lokal unter einem eigenen Port, zum Beispiel https://GX-IP:8089/.
Wallboxen aktualisieren
Das USB-Installationsprogramm aktualisiert nur die erste Wallbox. Um dieselbe Version auf den hinzugefügten Wallboxen zu installieren, setzen Sie unter Your chargers bei jeder von ihnen das Häkchen Include … in update, prüfen die Auswahl und wählen Update selected chargers. Beenden Sie vorher das Laden an diesen Wallboxen.
- Updates laufen nacheinander, behalten Einstellungen, Identität und Lizenz jeder Wallbox bei und legen eine Wiederherstellungssicherung an.
- Startet eine Wallbox nach ihrem Update nicht, wird ihre vorherige Installation wiederhergestellt. Nach einem unterbrochenen Update wird die vorherige Installation beim nächsten Start des GX wiederhergestellt.
- Wallboxen, die per SSH installiert wurden, erscheinen in der Liste; Sie aktualisieren sie aber über ihr eigenes Control Panel und starten sie dort neu.
Eine Wallbox umbenennen, neu starten oder entfernen
Öffnen Sie eine Wallbox unter Your chargers. Beenden Sie vorher das Laden an ihr.
- Save name ändert ihren Namen. Starten Sie die Wallbox neu, damit VRM den neuen Namen zeigt. Der Name ist unabhängig von der Identität der Wallbox und bleibt beim Zurücksetzen oder Importieren der Einstellungen erhalten.
- Restart charger startet sie neu; das dauert etwa eine Minute.
- Remove charger stoppt eine Wallbox, die Sie auf dieser Seite hinzugefügt haben, entfernt ihren VRM-Control-Panel-Zugang und ihren Autostart-Eintrag, löscht ihre Dateien und gibt ihren Port frei. Ihre Einstellungen, ihr Administratorkonto, ihre Lizenz und ihr Ladeverlauf werden gelöscht und lassen sich nicht wiederherstellen; sichern Sie sie also vorher. Die anderen Wallboxen laufen weiter.
- Um die Lizenz einer entfernten Wallbox für eine später hinzugefügte Wallbox zu nutzen, aktivieren Sie diese Wallbox. Wurde die entfernte Wallbox online aktiviert, erkennt das Lizenzportal den GX, und das Übertragen der Lizenz zählt nicht als Geräteaustausch.
- Ist sie als einzige Wallbox übrig, bietet die erste Wallbox Uninstall Phaeton an; damit entfernen Sie Phaeton vollständig vom GX.
Mehrere Wallboxen sichern
Sichern Sie jede Wallbox. Die erste Wallbox liegt in /data/phaeton. Eine unter Chargers on this GX hinzugefügte Wallbox liegt in einem eigenen Verzeichnis unter /data/phaeton-instances; die Verwaltungsdaten liegen unter /data/phaeton-manager, sobald Sie dort eine Wallbox hinzugefügt haben. In einer GX-Shell sichert dieser Befehl die vorhandenen Verzeichnisse:
cd /data && tar -czf phaeton-chargers-$(date +%Y%m%d).tar.gz $(ls -d phaeton phaeton-instances phaeton-manager 2>/dev/null)
Kopieren Sie die Datei vom GX, zum Beispiel mit scp, und behandeln Sie sie so vertraulich wie ein Passwort. Stellen Sie eine Wallbox nur an derselben Stelle auf demselben GX wieder her, für dieselbe Wallbox. Kopieren Sie keine Identität und keine Lizenz auf eine neue Wallbox, und lassen Sie eine wiederhergestellte Kopie nie neben dem Original laufen.
Erweitert: Eine Wallbox per SSH hinzufügen
Ohne die Seite Chargers on this GX können Sie in einer GX-Shell für jede Wallbox eine benannte Installation hinzufügen; zum SSH-Zugang siehe Erweiterte Installation. Laden Sie das Installationsprogramm einmal herunter und geben Sie dann jeder Wallbox einen Namen und einen eigenen Webport:
curl -fsSL https://phaeton.virtunet.io/install/gx.sh -o /tmp/install-phaeton.sh
sh /tmp/install-phaeton.sh --instance garage --web-port 8089
sh /tmp/install-phaeton.sh --instance driveway --web-port 8090
- Ein Name besteht aus 1 bis 32 Kleinbuchstaben, Ziffern oder Bindestrichen und beginnt mit einem Buchstaben oder einer Ziffer.
- Nutzen Sie einen Port von 1024 bis 65535, den kein anderer Dienst verwendet. Port 8088 ist für die erste Installation reserviert, und das Installationsprogramm lehnt einen Port ab, den eine andere benannte Installation hat, auch wenn diese gestoppt ist.
- Jede Installation liegt in einem eigenen Verzeichnis unter
/data/phaeton-instancesund öffnet sich unter ihrem eigenen Port, zum Beispiel https://GX-IP:8089/ für garage. - Öffnen Sie jede Weboberfläche in einem vertrauenswürdigen Netzwerk, legen Sie ihr Administratorkonto an, wählen Sie ihre Integration und die Adresse der Wallbox und aktivieren Sie sie mit einer eigenen Lizenz.
- Prüfen Sie, ob der GX pro Wallbox eine EV Charging Station zeigt, jede mit eigener Seriennummer.
- Ersetzt eine benannte Installation die erste Installation für dieselbe Wallbox, sichern Sie die erste Installation und deinstallieren Sie sie, bevor Sie die benannte installieren (Uninstall Phaeton oder
/data/phaeton/phaeton --uninstall); dabei wird auch ihr Autostart-Eintrag entfernt. Die Deinstallation funktioniert nur, solange keine andere Wallbox auf dem GX installiert ist. Aktivieren Sie dann die neue Installation, um die Lizenz zu übertragen, damit nur eine Installation die Wallbox steuert. Zeigt der GX die alte nach einigen Minuten noch an, siehe Phaeton deinstallieren. - Führen Sie das Installationsprogramm immer nur für eine Wallbox gleichzeitig aus. Um eine benannte Installation neu zu installieren, stoppen Sie sie zuerst; eine Neuinstallation mit demselben Namen und Port behält ihre Identität und Daten.
Um eine gestoppte benannte Installation zu starten, führen Sie ihr Startskript im Hintergrund aus oder starten Sie den GX neu:
nohup /data/phaeton-instances/garage/run.sh >/dev/null 2>&1 &
Wenn Sie eine Installation von Hand stoppen oder neu starten, wählen Sie ihren Prozess anhand des Programms in ihrem eigenen Verzeichnis aus; stoppen Sie nie alle Prozesse namens phaeton. Wurde das Installationsprogramm zwangsweise beendet, prüfen Sie, ob es wirklich beendet ist, bevor Sie /data/.phaeton-install.lock entfernen und es erneut ausführen.
Mit einer Test-Wallbox ausprobieren
Um neben einer echten Wallbox zu testen, fügen Sie eine weitere Wallbox hinzu und wählen in ihrer Einrichtung Dummy — no license required. Per SSH installieren Sie sie als weitere benannte Installation, zum Beispiel mit --instance demo --web-port 8091.
- Die Test-Wallbox braucht keine Lizenz und keine Aktivierung, verbraucht weder eine Privatlizenz noch einen Installateur-Credit und meldet sich nicht zur Lizenzprüfung.
- Leistung und Energie bleiben in jedem Zustand null. Die Seite Charging hat das Bedienelement Simulated connection, und der GX und VRM zeigen sie als Phaeton demo (zero load).
- Prüfen Sie mit einer echten Wallbox und einer Test-Wallbox die Erkennung, die getrennte Steuerung, was passiert, wenn der GX die Steuerung verliert, den Neustart einer einzelnen Wallbox und dass die Test-Wallbox keine Energie meldet.
- Der GX kann der Test-Wallbox einen Teil der Leistung zuteilen; stellen Sie während des Tests an der echten Wallbox daher vorsichtige Grenzen ein.