Phaeton-handleiding
Phaeton op je GX installeren
Download, kopieer naar een USB-stick, herstart je GX en rond de setup af in je browser.
Aanbevolen USB-installatie
Je kunt installeren zonder terminalopdrachten of SSH-toegang. Er is geen setupcode nodig. Je GX kan tijdens de installatie offline blijven.
Leg een lege USB-stick klaar en gebruik een computer met internet. Je hebt fysieke toegang nodig om de stick te plaatsen en de GX te herstarten. Daarna kun je Phaeton openen via VRM of vanuit het lokale netwerk van de GX.
Al geïnstalleerd?
Herstart met de USB-installer om de versie op de stick te installeren, ook bij herinstallatie of teruggaan naar een oudere versie. Phaeton maakt een back-up op de GX, behoudt configuratie, identiteit en licenties en controleert daarna de nieuwe toepassing. Bij een mislukte start wordt de vorige installatie hersteld. Open Instellingen voor configuratiemeldingen; herstelmodus blokkeert laden totdat geldige instellingen zijn opgeslagen en Phaeton opnieuw is gestart. Afzonderlijke benoemde installaties behouden hun eigen software. Via Software Updates in Phaeton kun je ook online en offline bijwerken. Wil je zonder SSH een tweede laadpaal toevoegen? Open System → Chargers on this GX in de Control Panel van de laadpaal die je vanaf USB hebt geïnstalleerd.
1. Download de USB-installer
GX USB-installer downloaden (0.66.7)
Laat het gedownloade .tgz-bestand ongeopend. Pak het niet uit en hernoem het niet.
Voor welke GX-apparaten is deze installer?
Deze installer is voor 32-bits ARMv7 Venus OS, waaronder Cerbo GX. Het bestand heet venus-data-phaeton-VERSIE-armv7.tgz. Gebruik voor andere Linux-apparaten de geavanceerde downloads hieronder. Een .phaeton-update-bestand is voor updates via de webinterface van Phaeton.
2. Kopieer het bestand naar je USB-stick
Gebruik een lege, schrijfbare FAT32-USB-stick met minstens 256 MB vrije ruimte. Bekijk de hulp hieronder als je de stick moet formatteren.
Kopieer het ongeopende .tgz-bestand rechtstreeks naar het USB-station, buiten een map. Werp de stick uit via je computer zodra het kopiëren klaar is.
Je USB-stick voorbereiden
De stick moet een MBR-partitietabel hebben. Formatteren wist de inhoud. Bewaar gewenste bestanden eerst ergens anders. Vraag je installateur om hulp bij het voorbereiden van de stick als je twijfelt over het formaat. Gebruik geen stick met GX-loggegevens.
Kopiëren op Windows, macOS of Linux
Windows: kopieer het archief in Verkenner vanuit Downloads rechtstreeks naar het USB-station en kies daarna Uitwerpen.
macOS: kopieer het archief in Finder vanuit Downloads rechtstreeks naar het USB-station en gebruik daarna het uitwerpsymbool. Schakel in Safari eerst 'Open veilige bestanden na downloaden' uit; download opnieuw als het al is uitgepakt.
Linux: kopieer het archief in je bestandsbeheerder vanuit Downloads rechtstreeks naar het USB-station en werp het station daarna veilig uit.
3. Plaats de stick en herstart je GX
Controleer op het GX-scherm of in Remote Console: Instellingen → Algemeen → Modification checks → Modifications enabled. Menunamen verschillen per firmware. Laat dit aanstaan zodat Phaeton na een herstart automatisch start.
Koppel andere verwisselbare media los. Plaats de stick in een USB-poort met data. De voedingspoort voor GX Touch kan de stick niet lezen. Herstart op een geschikt moment, zonder laden of ander essentieel werk te onderbreken.
Geef de installatie vijf minuten om te starten en wacht totdat de USB-activiteit stopt. Trek geen actieve stick uit en onderbreek de GX-voeding niet. Weet je niet zeker of verwijderen veilig is, laat de stick dan zitten en neem contact op met support. Je kunt de setup in de browser afronden.
4. Open Phaeton en rond de setup af
Bij een nieuwe installatie met Phaeton 0.59.0 of nieuwer: log in op VRM, open je installatie en kies Device list → Phaeton EV Charging Station → Control Panel. Tijdens de eerste setup heet het apparaat Phaeton. Geef de apparatenlijst tijd om na het starten te verversen.
Je GX moet online zijn, Instellingen → VRM → VRM Portal moet op Full staan en je VRM-account moet instellingen mogen wijzigen. Je browser mag op een ander netwerk zitten. Remote Console opent de GX-interface; gebruik Control Panel om Phaeton te openen.
VRM openen · VRM-instellingen en hulp bij verbinding
Phaeton openen op het lokale netwerk
Zoek het GX-IP-adres bij Instellingen → Ethernet of Instellingen → Wi-Fi → je verbonden netwerk. Open op hetzelfde vertrouwde lokale netwerk https://GX-IP:8088/ in je browser en vervang GX-IP door dat adres.
Certificaatwaarschuwing in de browser
Lokale HTTPS gebruikt het eigen certificaat van Phaeton, waardoor je browser een privacywaarschuwing kan tonen. Open na veilige verwijdering van de stick PHAETON-RESULT.html op je computer. Vergelijk de openbare SHA-256-certificaatvingerafdruk met de certificaatdetails in je browser voordat je inloggegevens invoert. Stop als ze verschillen. Dit offline rapport bevat geen setupgeheim. VRM gebruikt een eigen HTTPS-certificaat; de USB-vingerafdrukcontrole geldt alleen voor lokale toegang.
Kies je Phaeton-beheerdersnaam en wachtwoord. Volg de wizard om je laadpaal en GX te verbinden. Activeer Phaeton daarna met je portalaccount. Je VRM-account, Phaeton-login en licentieportalaccount staan los van elkaar.
Probeer Phaeton eerst, zonder licentie
Kies in de wizard “Dummy — no license required” als laadpaal. Alles is gesimuleerd en er loopt geen vermogen, dus je verkent de laadpagina, het schema en de instellingen gratis. Schakel later bij Instellingen over op je echte laadpaal; dan wordt de licentie gecontroleerd.
Een offline GX kun je activeren door aanvraag- en licentiebestanden uit te wisselen via een computer met internet. Controleer het dashboard en de laadpaalverbinding voordat je bewust een laadtest start.
Installatie niet voltooid of resultaatbestand ontbreekt
Open na veilige verwijdering PHAETON-RESULT.html en PHAETON-<GX-identiteit>.log op je computer. Het log vermeldt de installatiestappen en uitkomsten voor deze GX, zonder configuratie of wachtwoorden. Ontbreekt een van beide bestanden, staat er nog installatie bezig of wordt een fout gemeld, volg dan de USB-herstelhandleiding. Alleen-lezen media kunnen geen resultaat ontvangen. Een hergebruikte stick kan een oud GX-resultaat bevatten als de installer niet is gestart; controleer de setup op de huidige GX.
Venus kan ook vrmlogger-backlog.sqlite3 aanmaken voor de eigen VRM-loggegevens. Dit is niet nodig voor de setup; bewaar nog niet geüploade VRM-records.
Phaeton openen via VRM Control Panel
Phaeton 0.59.0 en nieuwer beheren toegang op afstand voor nieuwe GX-installaties via USB/SSH en bestaande benoemde MQTT-instanties. Versie 0.64.0 maakt de route na een update en herstart ook automatisch aan voor bestaande lokale Modbus- en onbenoemde MQTT-installaties, met behoud van backend, identiteit en besturingsinstellingen.
Configureer de GX
- Gebruik het GX-scherm of Remote Console. Verbind de GX met internet via Instellingen → Connectivity → Ethernet / Wi-Fi; in oudere menu's staan Ethernet / Wi-Fi direct onder Instellingen.
- Open Instellingen → VRM → VRM Portal, of Instellingen → VRM online portal → VRM Portal op oudere firmware. Kies Full als de eigenaar configuratie op afstand wil toestaan.
- Controleer in hetzelfde VRM-menu of Last contact recent is en er geen verbindingsfout is. Voeg de GX zo nodig toe aan je VRM-installatie. Je VRM-account moet instellingen mogen wijzigen.
- Laat Instellingen → Algemeen → Modification checks → Modifications enabled aanstaan voor Phaeton. Op ondersteunde installaties beheert Phaeton na het starten zijn eigen Control Panel-route.
Open Phaeton
- Gebruik een nieuwe GX-installatie met de installer van 0.59.0 of nieuwer, of werk een bestaande benoemde MQTT-instantie bij. Gebruik voor een bestaande Modbus- of onbenoemde MQTT-installatie 0.64.0 of nieuwer. Rond bij Modbus setup en activering eerst lokaal af. Geef de apparatenlijst tijd om na het starten te verversen.
- Log in op VRM, open je installatie en kies Device list. Klap de bedoelde Phaeton EV Charging Station open en kies Control Panel. Tijdens de setup heet de registratie Phaeton. Remote Console opent de GX-interface.
- Maak bij de eerste setup je Phaeton-beheerdersaccount aan, of log in met je bestaande Phaeton-gegevens. VRM logt je niet in bij Phaeton. Je VRM-account, lokale Phaeton-login en licentieportalaccount staan los van elkaar.
Behoud het bestaande lokale beveiligingsprofiel. MQTT-installaties gebruiken de lokale broker intern; Modbus-installaties hebben voor deze route geen MQTT nodig. MQTT op LAN of het koppelen van netwerkapparaten maakt de webroute niet aan. Control Panel vereist geen SSH op LAN, Remote Support of poortdoorschakelingen.
Lokale HTTPS blijft beschikbaar voor offline inbedrijfstelling via https://GX-IP:8088/. Wil je zonder SSH een tweede laadpaal toevoegen? Open System → Chargers on this GX in de Control Panel van de laadpaal die je vanaf USB hebt geïnstalleerd.
Ontbreekt Control Panel of opent het GX, controleer dan het installatietype, GX-internet, VRM Full en wijzigingsrechten. Bekijk de Control Panel-status en Phaeton-logs; ondersteunde installaties herstellen hun route elke 30 seconden. Controleer bij Modbus of oudere onbenoemde MQTT of 0.64.0 of nieuwer draait, de lokale verbindingsinstellingen ondersteund worden en Control Panel aanstaat. Ga lokaal verder via https://GX-IP:8088/. De USB-vingerafdruk hoort bij dat lokale certificaat; VRM gebruikt zijn eigen HTTPS-certificaat.
De firmwareversie in VRM is EVCS-compatibiliteitsinformatie, niet de geïnstalleerde Phaeton-versie. Installaties met beheerde Control Panel-toegang melden v1.29. Een uitgeschakelde of onbeschikbare Modbus-route kan v1.22 blijven melden, net als een oudere of uitgeschakelde MQTT-registratie. Alleen dat nummer wijzigen maakt de webroute niet aan; bekijk eerst de Control Panel-status en logs.
Geavanceerde installatie via SSH
1. Controleer wat je nodig hebt
Gebruik dit alternatief als je geen USB-stick kunt gebruiken of liever met een terminal werkt. Volg deze zes stappen op een computer in hetzelfde lokale netwerk als je GX. De SSH-installer downloadt de software voor je; een extra account is niet nodig.
- Een Cerbo GX met Venus OS en toestemming om instellingen te wijzigen. De SSH-installer kiest een native ARMv7- of ARM64-pakket voor je Venus OS.
- Internettoegang vanaf de GX en een Windows-, macOS- of Linux-computer in hetzelfde lokale netwerk. Alleen een VRM-verbinding geeft je computer geen SSH-toegang tot de GX.
- Een ondersteunde laadpaal en toegang tot de verbindingsinstellingen. Controleer de handleiding voor je laadpaal voordat je de laadregeling gebruikt.
2. Bereid je GX voor
Gebruik het GX-scherm, of log in op Victron VRM, open je installatie en kies Remote Console. Ken je het GX IP-adres al? Open dat dan in je browser op het lokale netwerk. Houd het GX-instellingenscherm open.
Zoek het IP-adres bij Instellingen → Ethernet, of Instellingen → Wi-Fi → je verbonden netwerk. Gebruik het adres van het netwerk waarin je computer zit.
Bijvoorbeeld 192.168.1.50. Vul alleen het adres in, zonder http:// of poort. Het blijft in deze browser en wordt niet naar de Phaeton-website verstuurd.
- Stel bij Algemeen / Toegang & beveiliging een tijdelijk rootwachtwoord in. Kies zelf een wachtwoord en bewaar het voor de volgende stap; ZZZ is niet je SSH-wachtwoord.
- Schakel SSH op LAN in. Op huidige Venus OS-versies hoef je Remote Support niet in te schakelen.
- Open Algemeen → Modification checks en zorg dat Modifications enabled aanstaat, zodat Phaeton na een herstart automatisch start.
Menunamen verschillen per Venus OS-versie. Is het toegangswachtwoord ZZZ gewijzigd? Vraag het aan je installateur. Gebruik bij een ander scherm de geïllustreerde handleiding van Victron.
3. Maak verbinding vanaf je computer
Windows: Open Start, typ PowerShell en open Windows PowerShell of Terminal. Plak de opdracht hieronder en druk op Enter.
macOS: Open Spotlight met Command + spatie, typ Terminal en open het. Plak de opdracht hieronder en druk op Return.
Linux: Open je Terminal-app. Plak de opdracht hieronder en druk op Enter.
Voer uit op je computer
ssh root@<gx-ip>- Bij de eerste verbinding toont SSH een vingerafdruk van de hostsleutel. Controleer of het adres van je GX is en verifieer de sleutel zo nodig via een vertrouwd apparaat of beheerder. Accepteer alleen een apparaat dat je herkent. Een onverwacht gewijzigde sleutel moet worden onderzocht.
- Vul het tijdelijke rootwachtwoord in dat je zojuist op de GX hebt ingesteld. Tijdens het typen verschijnen geen tekens of stippen; dat is normaal. Druk op Enter.
- Een prompt die begint met root@ betekent dat je met de GX verbonden bent. Houd deze terminal open totdat de installatie klaar is.
Hulp bij verbinding
- Connection refused: controleer of SSH op LAN aanstaat.
- Connection timed out: controleer het GX-adres en of beide apparaten in hetzelfde lokale netwerk zitten; gast-wifi of een VPN kan ze scheiden.
- Permission denied: gebruik root als gebruikersnaam en je tijdelijke GX-rootwachtwoord. Een Venus-firmware-update wist dat wachtwoord.
- ssh wordt niet herkend: schakel de optionele Windows-functie OpenSSH Client in en open PowerShell opnieuw.
4. Installeer Phaeton
Je bent nu in de GX-terminal. Kopieer deze volledige opdracht, plak deze bij de root@-prompt en druk op Enter. Houd de terminal open tot de installer klaar is.
Voer uit op de GX nadat je verbinding hebt gemaakt
(installer=$(mktemp) && trap 'rm -f "$installer"' EXIT && curl -fL --connect-timeout 15 --max-time 120 https://phaeton.virtunet.io/install/gx.sh -o "$installer" && sh "$installer")De installer controleert de GX, downloadt de stabiele release, controleert de handtekening, installeert Phaeton en wacht op de webinterface. Automatisch starten wordt ingesteld zonder startopdrachten van andere software te vervangen.
Hulp bij installatie
- Download mislukt: controleer internettoegang op de GX en probeer de opdracht opnieuw.
- Niet-ondersteund apparaat of weinig opslag: volg de melding voordat je opnieuw probeert. Kies niet zomaar een ander binair bestand.
- Modificaties uitgeschakeld: schakel ze in via het GX-menu. Volg de herstelmelding van de installer als een oud opstartbestand is uitgeschakeld.
- Phaeton draait al: gebruik Software Updates in Phaeton. Het opnieuw uitvoeren van de installatieopdracht werkt een draaiende installatie niet bij.
- Webinterface niet gereed: houd de terminal open en volg de log- en herstelinstructies van de installer. De installatie is nog niet voltooid.
5. Open Phaeton
Na een nieuwe installatie met Phaeton 0.59.0 of nieuwer kun je Phaeton openen via VRM → je installatie → Device list → Phaeton EV Charging Station → Control Panel. Hiervoor zijn GX-internet, VRM Full en wijzigingsrechten nodig. Zoek tijdens de eerste setup naar Phaeton.
Phaeton openen via VRM Control Panel
De installer toont het Phaeton-webadres en de SHA-256-vingerafdruk van het certificaat. Open Phaeton en kies je lokale beheerdersnaam en wachtwoord. Vanaf Phaeton 0.58.0 is geen setupcode nodig.
Bij lokale HTTPS kan je browser melden dat de verbinding niet privé is, omdat deze GX een eigen certificaat gebruikt. Open eerst de certificaatdetails en vergelijk de SHA-256-vingerafdruk met de uitvoer van de installer. Ga alleen verder als ze overeenkomen. VRM gebruikt een eigen HTTPS-certificaat.
https://<gx-ip>:8088/
Gebruik het HTTPS-adres van de installer als het afwijkt. Deze knop opent het ingevulde adres en test de verbinding niet.
Certificaatdetails vinden
- Chrome / Edge: open de verbindings- of certificaatdetails van de site (of het Security-paneel) en bekijk de SHA-256-vingerafdruk.
- Firefox: kies op de waarschuwingspagina Geavanceerd → Certificaat bekijken en zoek de SHA-256-vingerafdruk.
- Safari: kies Toon details → Bekijk het certificaat en open de vingerafdrukdetails. Menunamen kunnen per browserversie verschillen.
- Verschillen de vingerafdrukken? Stop en controleer het GX-adres voordat je een wachtwoord invult.
Vraagt een oudere Phaeton-versie nog om een setupcode?
Alleen versies vóór 0.58.0 vereisen een code. Voer voor die versies de opdracht hieronder uit in dezelfde GX-terminal. Gebruik token als Setup code en certificate_sha256 om het browsercertificaat te controleren. Is de installatie al afgerond? Log dan in met je bestaande Phaeton-account.
Voer uit in je privé-GX-terminal; deel de uitvoer niet
cat /data/phaeton/setup-claim.json6. Rond de installatie af
- Kies een lokale Phaeton-gebruikersnaam en wachtwoord in de eerste-startwizard. Dit staat los van je GX-rootwachtwoord.
- Kies de laadpaalintegratie en vul de verbindingsgegevens in. Volg de wizard voor de gewenste GX-integratie. Optionele verbindingsinstellingen kun je later afronden.
- Sla op, log in bij Phaeton en activeer Phaeton met je portalaccount. Dat account beheert je licentie en staat los van je Phaeton-login en VRM-account. Volg eventuele herstartmeldingen.
- Controleer het dashboard, de laadpaalverbinding en de gewenste GX-integratie. Start alleen een laadtest als je er klaar voor bent en de laadpaal correct is ingesteld.
Gebruik Software Updates in Phaeton voor toekomstige updates. Werkt alles? Dan kun je SSH op LAN uitschakelen als het niet meer nodig is. Laat Modifications enabled aanstaan zodat Phaeton na een herstart start.
Andere Linux-apparaten en geavanceerde downloads
De GX-installer kiest zelf het pakket. Volg voor een ander Linux-systeem de Linux-handleiding. Archieven voor handmatige installatie en ondertekende .phaeton-update-bundels zijn verschillende bestanden; gebruik Software Updates voor een bestaande Phaeton-installatie.