# vehicles

> Definisci i veicoli in evcc.yaml con capacità della batteria, fasi, tempo di cache, identificatori RFID o del veicolo per il riconoscimento automatico e l’icona.

Un veicolo rappresenta uno specifico veicolo elettrico (EV) con la sua batteria. Se un veicolo è configurato e assegnato a un [punto di ricarica](/it/reference/configuration/loadpoints#vehicle), 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**:

```yaml
vehicles:
  - name: Zoe
    type: ...
    ...
```

Le configurazioni per i veicoli noti si trovano in [Dispositivi - Veicoli](/it/vehicles).

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](/it/reference/configuration/loadpoints#vehicle).

**Ad esempio**:

```yaml
name: zoe
```

***

### `title`

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

**Ad esempio**:

```yaml
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](/it/vehicles).

***

## 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**:

```yaml
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**:

```yaml
phases: 2
```

***

### `cache`

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

> **Nota**
>
> Il valore va indicato con l’unità di tempo associata (vedi esempio). `m` sta per minuti.

> **Attenzione**
>
> **NON** è consigliato modificare le impostazioni predefinite, perché il costruttore del veicolo potrebbe impedire attivamente il controllo della ricarica tramite evcc. **A TUO RISCHIO.**

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**:

```yaml
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**:

```yaml
identifiers:
  - 12345ABC # ID del token RFID
```

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

**Ad esempio**:

```yaml
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**:

```yaml
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.

```yaml
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**:

```yaml
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**:

```yaml
icon: heater
```

***