macOS

Denne vejledning beskriver installationen på macOS (10.12 og nyere) med pakkehåndteringen Homebrew.

Note

Hvis du vil installere evcc uden pakkehåndtering eller teste en nightly-version, kan du se afsnittet Manuel installation.

Installation

1. Installer

   Åbn et terminalvindue, og installer Homebrew, hvis det ikke allerede er installeret.

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

2. Start

   evcc leveres som en Homebrew-cask, der ikke kan styres med brew services. Opret i stedet en launchd-agent. Den starter evcc ved login og genstarter det, hvis det stopper:

   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. Sæt op

   Åbn evcc-grænsefladen i din browser: http://localhost:7070. Angiv en administratoradgangskode, og konfigurer dine enheder direkte i webgrænsefladen.

Konfiguration

Anbefalet

Konfigurer evcc direkte i din browser.

Efter den første start kan du konfigurere evcc på http://localhost:7070. Indstillingerne gemmes automatisk i databasen.

Alternativt kan du bruge en evcc.yaml-konfigurationsfil i /etc/evcc.yaml. Du finder detaljer under Konfiguration.

Opgraderinger

Følg disse trin for at opgradere til en ny version af evcc:

• Åbn et terminalvindue

• Opdater pakkelisterne:

  brew update

• Opgrader evcc:

  brew upgrade --cask evcc

• Genstart evcc:

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

OCPP og macOS-firewallen

Hver opgradering installerer en ny binærfil, der for macOS-firewallen er et nyt program. Hvis firewallen er slået til, blokeres indgående forbindelser, indtil den nye version er godkendt. OCPP-opladere kan så ikke længere oprette forbindelse, mens alt andet fortsat virker. På en Mac uden skærm vises godkendelsesdialogboksen aldrig. Godkend binærfilen fra kommandolinjen efter hver opgradering:

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

Opgradering fra Homebrew-formlen

Til og med version 0.314.5 blev evcc leveret som Homebrew-formel og startet med brew services. Homebrew opgraderer ikke en installeret formel til en cask, så brew upgrade bliver ved med at melde den gamle version som opdateret. Fjern formlen, og installer casken (det skal kun gøres én gang):

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

Opret derefter launchd-agenten som beskrevet under Start. Din konfiguration og database påvirkes ikke.

Yderligere kommandoer

• Tjek status for evcc-serveren:

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

• Stop evcc, og fjern launchd-agenten:

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

• Vis logfiler:

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

Manuel installation

Her finder du en vejledning i at installere evcc manuelt på macOS.

Installation

• Download den passende fil til dit system:
  • 64-bit ARM- eller Intel-CPU: evcc_X.XX_macOS_all.tar.gz
• Pak den downloadede fil ud (f.eks. ved at dobbeltklikke på filen)
• Der er nu en ny mappe med programmet evcc
• Åbn en terminal, og gå til mappen med programmet evcc
• Start evcc med følgende kommando:

  ./evcc -v

• Du bør nu se den aktuelle version af evcc (f.eks. evcc version 0.xxx.y).

Konfiguration

Efter den første start åbner du http://localhost:7070 i din browser og konfigurerer evcc i webgrænsefladen.

Alternativt kan du oprette en evcc.yaml-konfigurationsfil (se Konfiguration) og starte evcc med den:

./evcc -c evcc.yaml

Opdateringer/nedgraderinger

Følg trinene ovenfor, og erstat evcc-programfilen med den nye eller den tidligere version. Konfigurationen behøver ikke at blive lavet igen.