macOS

Deze handleiding beschrijft de installatie voor macOS (10.12 en hoger) met de pakketbeheerder Homebrew.

Opmerking

Wilt u evcc zonder pakketbeheerder installeren of een nightly-versie testen, raadpleeg dan het gedeelte Handmatige installatie.

Installatie

1. Installeren

   Open een terminalvenster en installeer Homebrew als het nog niet aanwezig is.

   brew trust --tap evcc-io/tap
   brew tap evcc-io/tap
   brew update
   brew install --cask evcc

2. Starten

   evcc wordt geleverd als Homebrew-cask, die niet met brew services beheerd kan worden. Maak in plaats daarvan een launchd-agent aan. Deze start evcc bij het inloggen en start het opnieuw als het stopt:

   mkdir -p "$(brew --prefix)/var/log"
   cat > ~/Library/LaunchAgents/io.evcc.plist <<EOF
   <?xml version="1.0" encoding="UTF-8"?>
   <!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
   <plist version="1.0">
   <dict>
     <key>Label</key>
     <string>io.evcc</string>
     <key>ProgramArguments</key>
     <array>
       <string>$(brew --prefix)/bin/evcc</string>
     </array>
     <key>WorkingDirectory</key>
     <string>$(brew --prefix)</string>
     <key>RunAtLoad</key>
     <true/>
     <key>KeepAlive</key>
     <true/>
     <key>StandardOutPath</key>
     <string>$(brew --prefix)/var/log/evcc.log</string>
     <key>StandardErrorPath</key>
     <string>$(brew --prefix)/var/log/evcc.log</string>
   </dict>
   </plist>
   EOF
   launchctl bootstrap gui/$(id -u) ~/Library/LaunchAgents/io.evcc.plist

3. Instellen

   Open de webinterface in uw browser: http://localhost:7070. Stel een beheerderswachtwoord in en configureer uw apparaten daar direct.

Configuratie

Aanbevolen

Configureer evcc direct in uw browser.

Na de eerste start kunt u evcc configureren op http://localhost:7070. Instellingen worden automatisch in de database opgeslagen.

U kunt ook een configuratiebestand evcc.yaml op de locatie /etc/evcc.yaml gebruiken. Details vindt u onder Configuratie.

Upgraden

Voer de volgende stappen uit om naar een nieuwe versie van evcc te upgraden:

• Open een terminalvenster

• Werk de pakketlijsten bij:

  brew update

• Upgrade evcc:

  brew upgrade --cask evcc

• Start evcc opnieuw:

  launchctl kickstart -k gui/$(id -u)/io.evcc

OCPP en de applicatiefirewall

Elke upgrade installeert een nieuw binair bestand, dat de macOS-applicatiefirewall als een nieuwe applicatie behandelt. Als de firewall is ingeschakeld, worden inkomende verbindingen geblokkeerd totdat de nieuwe versie is goedgekeurd. OCPP-laders kunnen dan geen verbinding meer maken, terwijl al het andere blijft werken. Op een Mac zonder scherm ziet niemand het goedkeuringsvenster. Keur het binaire bestand na elke upgrade goed via de opdrachtregel:

sudo /usr/libexec/ApplicationFirewall/socketfilterfw --add "$(brew --prefix)/bin/evcc"
launchctl kickstart -k gui/$(id -u)/io.evcc

Upgraden vanaf de Homebrew-formula

Tot versie 0.314.5 werd evcc geleverd als Homebrew-formula en gestart met brew services. Homebrew upgradet een geïnstalleerde formula niet naar een cask, dus brew upgrade blijft de oude versie als up-to-date melden. Verwijder de formula eenmalig en installeer de cask:

brew services stop evcc
brew uninstall evcc
brew update
brew install --cask evcc

Maak daarna de launchd-agent aan zoals beschreven onder Starten. Uw configuratie en database blijven ongewijzigd.

Aanvullende opdrachten

• Status van de evcc-server controleren:

  launchctl print gui/$(id -u)/io.evcc

• evcc stoppen en de launchd-agent verwijderen:

  launchctl bootout gui/$(id -u) ~/Library/LaunchAgents/io.evcc.plist

• Logs bekijken:

  tail -f "$(brew --prefix)/var/log/evcc.log"

Handmatige installatie

Hier vindt u instructies voor het handmatig installeren van evcc op macOS.

Installatie

• Download het juiste bestand voor uw systeem:
  • 64-bit ARM- of Intel-CPU: evcc_X.XX_macOS_all.tar.gz
• Pak het gedownloade bestand uit (bijv. door erop te dubbelklikken)
• Er is nu een nieuwe map met het programma evcc aangemaakt.
• Open een terminal en ga naar de map met het programma evcc
• Start evcc met de volgende opdracht:

  ./evcc -v

• U zou nu de huidige versie van evcc moeten zien (bijv. evcc version 0.xxx.y).

Configuratie

Open na de eerste start http://localhost:7070 in uw browser en configureer evcc via de webinterface.

U kunt ook een configuratiebestand evcc.yaml aanmaken (zie Configuratie) en evcc daarmee starten:

./evcc -c evcc.yaml

Upgraden en downgraden

Volg de stappen hierboven en vervang het evcc-programmabestand door de nieuwe of vorige versie. De configuratie hoeft niet opnieuw te worden ingesteld.