# site

> Descrivi il tuo impianto domestico in evcc.yaml, assegna contatori di rete, fotovoltaici, della batteria e altri, e affina la regolazione del surplus con residualPower.

La sezione site descrive il tuo impianto domestico con tutti i dispositivi necessari e regola la potenza disponibile.

Per regolare la ricarica con il surplus solare serve un contatore leggibile installato subito dopo il punto di connessione alla rete. Si possono inoltre indicare dispositivi per la potenza solare e per una o più batterie domestiche. Se i dispositivi sono più di uno, le loro potenze vengono sommate automaticamente oppure, nel caso delle batterie domestiche, viene calcolato il livello di carica medio.

**Esempio**:

```yaml
site:
  title: Casa # nome visualizzato nell’interfaccia
  meters:
    grid: mygridmeter # riferimento al contatore di rete
    pv:
      - mypv1 # riferimento al primo contatore fotovoltaico
      - mypv9 # riferimento al secondo contatore fotovoltaico
    battery:
      - mybat5 # riferimento al contatore della batteria
    aux:
      - myaux1 # consumatore a regolazione autonoma
    consumer:
      - myconsumer1 # consumatore normale, registrato per le statistiche di consumo
    ext:
      - myext1 # per registrazione dati, gestione del carico ecc.
  curtailers:
    - my_curtailer # riferimento al dispositivo limitatore
  residualPower: 100
```

***

## Parametri obbligatori

### `title`

Il nome del sito (luogo), mostrato come titolo nell’interfaccia.

**Esempio**:

```yaml
title: Casa
```

***

### `meters`

Definisce quale [`meter`](/it/reference/configuration/meters) (contatore) configurato va usato per ciascun tipo di punto di misura. In questo modo la definizione del dispositivo viene collegata logicamente al suo utilizzo. A un contatore inizialmente generico viene così assegnato uno scopo in base alla sua posizione nell’impianto domestico.

> **Nota**
>
> È necessario configurare almeno un elemento `grid` o almeno un elemento `pv`!
>
> Senza almeno una di queste voci evcc non si può usare!

**Esempio**:

```yaml
site:
  meters:
    grid: mygridmeter # riferimento al contatore di rete
    pv: mypv1 # riferimento al contatore fotovoltaico
    battery: mybat2 # riferimento al contatore della batteria
    aux: myaux1
```

***

## Parametri facoltativi

### `meters.grid`

Definisce il [`meter`](/it/reference/configuration/meters) (contatore) che fornisce le misure del punto di connessione alla rete.

**Valori possibili**: valore di un parametro `name` nella configurazione [`meters`](#meters).

**Esempio**:

```yaml
grid: mygridmeter # riferimento al contatore di rete
```

***

### `meters.pv`

Definisce i [`meter`](/it/reference/configuration/meters) (dispositivi di misura) da cui evcc legge le misure della produzione solare. Si possono indicare più dispositivi. I dati di potenza vengono sommati automaticamente.

**Valori possibili**: un singolo valore o un elenco di valori di un parametro name nella configurazione [`meters`](#meters). La forma a elenco si può usare anche con valori singoli.

**Esempio**:

```yaml
pv: myonlypv # riferimento a un singolo contatore fotovoltaico
```

oppure

```yaml
pv: # (pvs = obsoleto)
  - myoldpv # riferimento al primo contatore fotovoltaico
  - mynewestpv # riferimento al secondo contatore fotovoltaico
```

***

### `meters.battery`

Definisce i [`meter`](/it/reference/configuration/meters) (dispositivi di misura) che forniscono i dati di misura di una o più batterie. Si possono indicare più dispositivi. I dati di potenza vengono sommati automaticamente e dal livello di carica delle batterie viene calcolata una media.

**Valori possibili**: un singolo valore o un elenco di valori di un parametro `name` nella configurazione [`meters`](#meters). La forma a elenco si può usare anche con valori singoli.

**Esempio**:

```yaml
battery: myonlybat # riferimento a un singolo contatore della batteria
```

oppure

```yaml
battery: # (batteries = obsoleto)
  - mysmallbat # riferimento al primo contatore della batteria
  - myhugebat # riferimento al secondo contatore della batteria
```

### `meters.aux`

Contatori per dispositivi esterni che eseguono una propria regolazione del surplus ma non sono controllati direttamente da evcc, ad es. una resistenza elettrica a regolazione autonoma. La loro potenza conta come surplus disponibile per la ricarica del veicolo, partendo dal presupposto che il dispositivo riduca il proprio consumo quando evcc destina quella potenza alla ricarica. Se ci sono più contatori, le loro potenze vengono sommate.

**Valori possibili**: un singolo valore o un elenco di valori di un parametro `name` nella configurazione [`meters`](#meters). La forma a elenco si può usare anche con valori singoli.

**Esempio**:

```yaml
aux: myaux # riferimento a un singolo contatore aux
```

oppure

```yaml
aux:
  - myaux1 # riferimento al primo contatore aux
  - myaux2 # riferimento al secondo contatore aux
```

### `meters.consumer`

Contatori per consumatori normali come una lavatrice o una lavastoviglie, registrati solo per le statistiche di consumo. A differenza di `aux`, questa potenza non viene considerata nel surplus disponibile per la ricarica del veicolo.

**Valori possibili**: un singolo valore o un elenco di valori di un parametro `name` nella configurazione [`meters`](#meters). La forma a elenco si può usare anche con valori singoli.

**Esempio**:

```yaml
consumer: myconsumer # riferimento a un singolo contatore consumatore
```

oppure

```yaml
consumer:
  - myconsumer1 # riferimento al primo contatore consumatore
  - myconsumer2 # riferimento al secondo contatore consumatore
```

### `meters.ext`

Contatori che non vengono usati per la regolazione né mostrati nell’interfaccia, ad es. sottoquadri o contatori di rete o fotovoltaici alternativi. I loro dati vengono solo registrati ed esportati, senza essere considerati nel surplus o nelle statistiche di consumo.

**Valori possibili**: un singolo valore o un elenco di valori di un parametro `name` nella configurazione [`meters`](#meters). La forma a elenco si può usare anche con valori singoli.

**Esempio**:

```yaml
ext: myext # riferimento a un singolo contatore ext
```

oppure

```yaml
ext:
  - myext1 # riferimento al primo contatore ext
  - myext2 # riferimento al secondo contatore ext
```

### `curtailers`

Dispositivi limitatori della configurazione [`curtailers`](/it/reference/configuration/curtailers) che limitano l’immissione in rete su richiesta del gestore di rete (§ 9 EEG). Vengono applicati insieme ai contatori `pv` limitabili quando l’integrazione [`hems`](/it/reference/configuration/hems) segnala un limite.

**Valori possibili**: un elenco di valori di un parametro `name` nella configurazione [`curtailers`](/it/reference/configuration/curtailers).

**Esempio**:

```yaml
curtailers:
  - my_curtailer # riferimento al dispositivo limitatore
```

### `residualPower`

Imposta il punto di lavoro desiderato della regolazione del surplus al punto di connessione alla rete (contatore di rete). Il valore predefinito è 0 W. I valori positivi spostano il punto di lavoro verso l’immissione in rete, quelli negativi verso il prelievo dalla rete. In pratica questo valore definisce lo *stato di riposo* dell’anello di regolazione, cioè il valore a cui il regolatore tende.

Soprattutto in combinazione con altri sistemi di regolazione del surplus indipendenti, come una batteria domestica, questo valore va adattato per ottenere un comportamento prevedibile del sistema, con priorità chiare.

Se in modalità intelligente deve restare o essere consentita una certa quota di prelievo dalla rete, si può configurare un valore negativo pari alla quota massima di prelievo dalla rete.

#### Con `meter` di tipo `grid`

* Valore positivo: potenza di immissione in rete residua
* Valore negativo: potenza di prelievo dalla rete residua

#### Solo `meter` di tipo `pv`

* Valore positivo: consumo domestico tipico, usato per stimare il surplus solare.
* Valore negativo: la potenza indicata viene aggiunta alla potenza solare e aumenta la potenza di ricarica disponibile (attenzione: prelievo dalla rete).

> **Nota**
>
> Con una batteria domestica si consiglia vivamente di inserire qui un valore piccolo, ad es. tra 100 e 300 W, così da permettere la carica della batteria secondo le priorità configurate (vedi `prioritySoc`). Altrimenti la regolazione indipendente della batteria domestica non vede alcun surplus utilizzabile. Allo stesso modo, anche senza batteria, si evita un prelievo temporaneo dalla rete durante rapide variazioni di produzione e carico.

**Esempio “Batteria domestica”**:

```yaml
residualPower: 100
```

**Esempio “Quota di prelievo dalla rete”**:

In modalità intelligente la ricarica deve partire con almeno 6 A (monofase) anche con solo il 50% di surplus solare (il resto dalla rete). Potenza di ricarica minima: 1 fase × 6 A × 230 V = 1.380 W, il 50% di questa: 690 W

Vedi anche l’[alternativa con enable/disable per consentire una quota di solare e di prelievo dalla rete](/it/features/solar-charging).

```yaml
residualPower: -690
```