macOS

Questa guida descrive l’installazione su macOS (10.12 e successivi) con il gestore di pacchetti Homebrew.

Nota

Se vuoi installare evcc senza un gestore di pacchetti o provare una versione nightly, consulta la sezione Installazione manuale.

Installazione

1. Installa

   Apri una finestra del terminale e installa Homebrew, se non l’hai già fatto.

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

2. Avvia

   evcc viene distribuito come cask di Homebrew, che non può essere gestito con brew services. Crea invece un agente launchd, che avvia evcc all’accesso e lo riavvia se si interrompe:

   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. Configura

   Apri l’interfaccia web di evcc nel browser: http://localhost:7070. Imposta una password di amministratore e configura i tuoi dispositivi direttamente dall’interfaccia web.

Configurazione

Consigliato

Configura evcc direttamente nel browser.

Dopo il primo avvio puoi configurare evcc all’indirizzo http://localhost:7070. Le impostazioni vengono salvate automaticamente nel database.

In alternativa puoi usare un file di configurazione evcc.yaml in /etc/evcc.yaml. Trovi i dettagli in Configurazione.

Aggiornamenti

Per aggiornare evcc a una nuova versione, segui questi passaggi:

• Apri una finestra del terminale

• Aggiorna l’elenco dei pacchetti:

  brew update

• Aggiorna evcc:

  brew upgrade --cask evcc

• Riavvia evcc:

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

OCPP e l’Application Firewall

Ogni aggiornamento installa un nuovo binario, che l’Application Firewall di macOS considera una nuova applicazione. Se il firewall è attivo, le connessioni in entrata restano bloccate finché la nuova versione non viene approvata. I caricabatterie OCPP non riescono più a connettersi, mentre tutto il resto continua a funzionare. Su un Mac senza monitor la finestra di approvazione non si vede mai. Dopo ogni aggiornamento approva il binario dalla riga di comando:

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

Passaggio dalla formula Homebrew al cask

Fino alla versione 0.314.5 evcc veniva distribuito come formula Homebrew e avviato con brew services. Homebrew non aggiorna una formula installata a cask, quindi brew upgrade considera la vecchia versione sempre aggiornata. Rimuovi la formula una volta e installa il cask:

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

Poi crea l’agente launchd come descritto in Avvia. La tua configurazione e il tuo database non vengono toccati.

Altri comandi

• Controlla lo stato del server evcc:

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

• Arresta evcc e rimuovi l’agente launchd:

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

• Visualizza i log:

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

Installazione manuale

Qui trovi le istruzioni per installare evcc manualmente su macOS.

Installazione

• Scarica il file adatto al tuo sistema:
  • CPU a 64 bit ARM o Intel: evcc_X.XX_macOS_all.tar.gz
• Estrai il file scaricato (ad es. con un doppio clic sul file)
• Ora c’è una nuova cartella con il programma evcc
• Apri un terminale e vai nella cartella che contiene il programma evcc
• Avvia evcc con questo comando:

  ./evcc -v

• Dovresti vedere la versione attuale di evcc (ad es. evcc version 0.xxx.y).

Configurazione

Dopo il primo avvio apri http://localhost:7070 nel browser e configura evcc tramite l’interfaccia web.

In alternativa puoi creare un file di configurazione evcc.yaml (vedi Configurazione) e avviare evcc con questo file:

./evcc -c evcc.yaml

Aggiornamento e ritorno a una versione precedente

Segui i passaggi descritti sopra e sostituisci il file del programma evcc con la versione nuova o precedente. Non è necessario ripetere la configurazione.