vehicles

Un veicolo rappresenta uno specifico veicolo elettrico (EV) con la sua batteria. Se un veicolo è configurato e assegnato a un punto di ricarica, l’interfaccia utente può mostrare lo stato di ricarica, il livello di carica, il tempo di ricarica residuo e altri dati che evcc recupera dal veicolo ed elabora automaticamente.

È anche possibile limitare la ricarica a un determinato livello di carica (solo tramite interfaccia). Poiché la maggior parte dei caricabatterie non conosce il livello di carica (viene trasmesso solo in combinazioni molto specifiche di caricabatterie), con questa configurazione evcc può comunicare direttamente con il veicolo tramite l’interfaccia online (API) del costruttore del veicolo.

La configurazione vehicles è un elenco di veicoli diversi.

Ad esempio:

vehicles:
  - name: Zoe
    type: ...
    ...

Le configurazioni per i veicoli noti si trovano in Dispositivi - Veicoli.

Di seguito vengono spiegati i vari parametri.

Parametri obbligatori

`name`

Una breve denominazione del veicolo configurato. Il valore viene usato per fare riferimento al veicolo nella configurazione del punto di ricarica.

Ad esempio:

name: zoe

`title`

Una descrizione del veicolo che viene mostrata nell’interfaccia utente.

Ad esempio:

title: Zoe

`type`

È il tipo di interfaccia di evcc che permette la comunicazione con il veicolo. I veicoli noti si possono integrare con il tipo template. Il tipo (template) adatto per i veicoli noti e le istruzioni per la configurazione manuale custom si trovano in Dispositivi - Veicoli.

Parametri opzionali

`capacity`

La capacità utilizzabile della batteria del veicolo in chilowattora (kWh).

Serve a calcolare il fabbisogno di energia per la pianificazione della ricarica.

Ad esempio:

capacity: 50 # kWh

`phases`

Il numero massimo di fasi che questo veicolo può usare (tenendo conto anche del cavo di ricarica). Il valore predefinito è 3. I valori possibili sono 1, 2 o 3.

Alcuni veicoli, in particolare gli ibridi plug-in, non usano per la ricarica il massimo possibile di 3 fasi. Se è installato un contatore di ricarica, evcc può determinare le fasi effettivamente usate all’inizio della ricarica, ma questa informazione non è disponibile prima che la ricarica inizi. Configurando il parametro phases sul veicolo, evcc può avviare la ricarica con una potenza disponibile inferiore in modalità intelligente.

Ad esempio:

phases: 2

`cache`

Il tempo di conservazione dei dati, durante il quale evcc evita nuove richieste esterne all’interfaccia dati del veicolo (API).

Per determinare i dati di stato attuali del veicolo (ad es. il livello di carica della batteria di trazione), l’interfaccia del costruttore viene interrogata online a intervalli regolari. Per evitare però di sovraccaricare i server del costruttore del veicolo con richieste continue (che potrebbero portare al blocco dell’account), è implementata una cache che intercetta queste richieste e risponde con i dati recuperati di recente fino all’età massima indicata qui. Poiché la maggior parte dei veicoli aggiorna i dati solo durante una ricarica in corso e a intervalli molto ampi (sono comuni da 10 a 30 minuti), richieste più frequenti non offrono alcun valore aggiunto.

Valore predefinito: 15m

Ad esempio:

cache: 5m

`identifiers`

Un elenco di uno o più identificatori con cui riconoscere il veicolo. Se il veicolo deve essere identificato presso caricabatterie diversi, possono servire più identificatori. L’identificazione è possibile con i seguenti meccanismi:

RFID

Se il caricabatterie ha un’interfaccia RFID, a un veicolo si può assegnare una tessera RFID per l’identificazione. In questo caso è necessario l’RFID Token ID.

Ad esempio:

identifiers:
  - 12345ABC # ID del token RFID

Nota: se l’identificatore può essere interpretato come numero, le virgolette sono obbligatorie.

Ad esempio:

identifiers:
  - "012345"
  - "12345e2"
  - "0x1234"

Identificatore del veicolo

Se il caricabatterie lo supporta, riceve dal veicolo un identificatore del veicolo. Può essere l’indirizzo MAC del caricatore di bordo oppure un identificatore di un certificato Plug & Charge installato in modo permanente (un certificato diverso da quello per la ricarica in DC!).

Ad esempio:

identifiers:
  - 01:23:45:67:89:0A # indirizzo MAC

Alcuni veicoli generano ogni giorno un nuovo indirizzo MAC. In questo caso si possono usare dei caratteri jolly, se i veicoli presenti si distinguono nella parte invariabile dell’indirizzo MAC.

identifiers:
  - 01:23:45:*

`features: ["coarsecurrent"]`

Indica che un veicolo non può essere regolato con una limitazione continua della corrente.

Questa impostazione va usata per la seguente combinazione:

il veicolo può regolare la corrente solo a passi di ampere interi
il caricabatterie può elaborare valori di corrente di ricarica più fini (ad es. 1 mA)

In questa combinazione può succedere che variazioni di corrente di pochi mA causino una variazione inattesa di 1 A nella corrente di fase usata per la regolazione. La regolazione può allora iniziare a oscillare. Questa funzionalità limita inoltre la regolazione a passi grossolani di 1 A.

NON si può usare insieme a un template di veicolo. Per usarla, il veicolo deve essere configurato come tipo nativo.

Ad esempio:

features: ["coarsecurrent"]

`icon`

I veicoli possono essere mostrati nell’interfaccia con icone diverse. Le opzioni disponibili sono:

car
bike
scooter
moped
motorcycle
van
bus
tractor
generic
heater
cooler
waterheater

Ad esempio:

icon: heater