# site

> Beschrijf uw thuisinstallatie in evcc.yaml: wijs net-, zonne-energie-, thuisbatterij- en andere meters toe en stem de overschotregeling af met residualPower.

De sectie site beschrijft de locatie met de aanwezige en benodigde apparaten van de thuisinstallatie en regelt het beschikbare vermogen.

Om het laden met zonneoverschot te regelen, is een uitleesbare meter direct achter het netaansluitpunt nodig. Daarnaast kunnen ook apparaten voor zonne-energie en thuisbatterij(en) worden opgegeven. Bij meerdere apparaten wordt het vermogen automatisch opgeteld of, bij thuisbatterijen, het gemiddelde laadniveau berekend.

**Voorbeeld**:

```yaml
site:
  title: Thuis # weergavenaam in de UI
  meters:
    grid: mygridmeter # verwijzing naar de netmeter
    pv:
      - mypv1 # verwijzing naar de eerste zonne-energiemeter
      - mypv9 # verwijzing naar de tweede zonne-energiemeter
    battery:
      - mybat5 # verwijzing naar de batterijmeter
    aux:
      - myaux1 # zelfregelende verbruiker
    consumer:
      - myconsumer1 # gewone verbruiker, geregistreerd voor de verbruiksstatistieken
    ext:
      - myext1 # voor datalogging, lastbeheer enz.
  curtailers:
    - my_curtailer # verwijzing naar het opwekbegrenzingsapparaat
  residualPower: 100
```

***

## Verplichte parameters

### `title`

De naam van de locatie, die in de UI als titel wordt weergegeven.

**Voorbeeld**:

```yaml
title: Thuis
```

***

### `meters`

Legt vast welke geconfigureerde [`meter`](/nl/reference/configuration/meters) (meetapparaten voor stroom) voor welk type meetpunt worden gebruikt. Zo wordt de apparaatdefinitie logisch gekoppeld aan het beoogde gebruik. Een meter die in principe overal inzetbaar is, krijgt daarmee een functie op basis van zijn plaats in de thuisinstallatie.

> **Opmerking**
>
> Er moet minstens één `grid`-element of minstens één `pv`-element zijn geconfigureerd.
>
> Zonder minstens één van deze vermeldingen kan evcc niet worden gebruikt.

**Voorbeeld**:

```yaml
site:
  meters:
    grid: mygridmeter # verwijzing naar de netmeter
    pv: mypv1 # verwijzing naar de zonne-energiemeter
    battery: mybat2 # verwijzing naar de batterijmeter
    aux: myaux1
```

***

## Optionele parameters

### `meters.grid`

Legt de [`meter`](/nl/reference/configuration/meters) (meetapparaat voor stroom) vast die de meetwaarden van het netaansluitpunt levert.

**Mogelijke waarden**: Waarde van een parameter `name` in de configuratie [`meters`](#meters).

**Voorbeeld**:

```yaml
grid: mygridmeter # verwijzing naar de netmeter
```

***

### `meters.pv`

Legt de [`meter`](/nl/reference/configuration/meters) (meetapparaat voor stroom) vast waarvan evcc de meetwaarden van de zonne-energieproductie ophaalt. Er kunnen meerdere apparaten worden opgegeven. De vermogensgegevens worden automatisch opgeteld.

**Mogelijke waarden**: Een enkele waarde of een lijst met waarden van een parameter name in de configuratie [`meters`](#meters). De lijstvorm kan ook met een enkele waarde worden gebruikt.

**Voorbeeld**:

```yaml
pv: myonlypv # verwijzing naar de enige zonne-energiemeter
```

of

```yaml
pv: # (pvs = verouderd)
  - myoldpv # verwijzing naar de eerste zonne-energiemeter
  - mynewestpv # verwijzing naar de tweede zonne-energiemeter
```

***

### `meters.battery`

Legt de [`meter`](/nl/reference/configuration/meters) (meetapparaat voor stroom) vast dat de meetgegevens van de batterij(en) levert. Er kunnen meerdere apparaten worden opgegeven. De vermogensgegevens worden automatisch opgeteld en uit het laadniveau van de batterijen wordt een gemiddelde berekend.

**Mogelijke waarden**: Een enkele waarde of een lijst met waarden van een parameter `name` in de configuratie [`meters`](#meters). De lijstvorm kan ook met een enkele waarde worden gebruikt.

**Voorbeeld**:

```yaml
battery: myonlybat # verwijzing naar de enige batterijmeter
```

of

```yaml
battery: # (batteries = verouderd)
  - mysmallbat # verwijzing naar de eerste batterijmeter
  - myhugebat # verwijzing naar de tweede batterijmeter
```

### `meters.aux`

Meters voor externe apparaten die hun eigen overschotregeling hebben, maar niet direct door evcc worden aangestuurd, bijv. een zelfregelend verwarmingselement. Hun vermogen telt mee in het beschikbare overschot voor het laden van voertuigen, in de veronderstelling dat het apparaat zijn verbruik verlaagt wanneer evcc dat vermogen aan het laden toewijst. Meerdere meters worden opgeteld.

**Mogelijke waarden**: Een enkele waarde of een lijst met waarden van een parameter `name` in de configuratie [`meters`](#meters). De lijstvorm kan ook met een enkele waarde worden gebruikt.

**Voorbeeld**:

```yaml
aux: myaux # verwijzing naar de enige aux-meter
```

of

```yaml
aux:
  - myaux1 # verwijzing naar de eerste aux-meter
  - myaux2 # verwijzing naar de tweede aux-meter
```

### `meters.consumer`

Meters voor gewone verbruikers zoals een wasmachine of vaatwasser, die alleen voor de verbruiksstatistieken worden geregistreerd. Anders dan bij `aux` telt dit vermogen niet mee in het beschikbare overschot voor het laden van voertuigen.

**Mogelijke waarden**: Een enkele waarde of een lijst met waarden van een parameter `name` in de configuratie [`meters`](#meters). De lijstvorm kan ook met een enkele waarde worden gebruikt.

**Voorbeeld**:

```yaml
consumer: myconsumer # verwijzing naar de enige verbruikersmeter
```

of

```yaml
consumer:
  - myconsumer1 # verwijzing naar de eerste verbruikersmeter
  - myconsumer2 # verwijzing naar de tweede verbruikersmeter
```

### `meters.ext`

Meters die niet voor de regeling worden gebruikt en niet in de UI verschijnen, bijv. meters in groepenkasten (subverdelers) of alternatieve net- of zonne-energiemeters. Hun gegevens worden alleen gelogd en geëxporteerd en tellen niet mee in het overschot of de verbruiksstatistieken.

**Mogelijke waarden**: Een enkele waarde of een lijst met waarden van een parameter `name` in de configuratie [`meters`](#meters). De lijstvorm kan ook met een enkele waarde worden gebruikt.

**Voorbeeld**:

```yaml
ext: myext # verwijzing naar de enige ext-meter
```

of

```yaml
ext:
  - myext1 # verwijzing naar de eerste ext-meter
  - myext2 # verwijzing naar de tweede ext-meter
```

### `curtailers`

Opwekbegrenzingsapparaten uit de configuratie [`curtailers`](/nl/reference/configuration/curtailers) die de teruglevering op verzoek van de netbeheerder begrenzen (§ 9 EEG). Ze worden samen met de begrensbare `pv`-meters toegepast wanneer de integratie [`hems`](/nl/reference/configuration/hems) een limiet doorgeeft.

**Mogelijke waarden**: Een lijst met waarden van een parameter `name` in de configuratie [`curtailers`](/nl/reference/configuration/curtailers).

**Voorbeeld**:

```yaml
curtailers:
  - my_curtailer # verwijzing naar het opwekbegrenzingsapparaat
```

### `residualPower`

Stelt het beoogde werkpunt van de overschotregeling aan de netaansluiting (netmeter) in. De standaardwaarde is 0 W. Positieve waarden verschuiven de doelwaarde richting teruglevering, negatieve waarden richting netafname. Uiteindelijk bepaalt deze waarde de *rusttoestand* van de regelkring, waar de regelaar naartoe stuurt.

Vooral in combinatie met andere onafhankelijke overschotregelingen, zoals een thuisbatterij, moet deze waarde worden aangepast om voorspelbaar systeemgedrag met duidelijke prioriteiten te krijgen.

Moet in de modus **Slim** een deel netafname blijven of toegestaan zijn, dan kunt u een negatieve waarde instellen die overeenkomt met het maximale aandeel netafname.

#### `grid` `meter` aanwezig

* Positieve waarde: resterend terugleververmogen
* Negatieve waarde: resterend netafnamevermogen

#### Alleen `pv` `meter` aanwezig

* Positieve waarde: typisch huishoudelijk verbruik, gebruikt om het zonneoverschot te schatten.
* Negatieve waarde: het opgegeven vermogen wordt bij het vermogen uit zonne-energie opgeteld en verhoogt het beschikbare laadvermogen (let op: netafname).

> **Opmerking**
>
> Als er een thuisbatterij aanwezig is, wordt sterk aangeraden hier een kleine waarde in te vullen, bijv. tussen 100 en 300 W, zodat de batterij volgens de ingestelde prioriteiten kan laden (zie `prioritySoc`). Anders ziet de onafhankelijke regeling van de thuisbatterij geen bruikbaar overschot. Ook zonder batterij voorkomt dit tijdelijke netafname bij snelle wisselingen in opwekking en belasting.

**Voorbeeld “thuisbatterij”**:

```yaml
residualPower: 100
```

**Voorbeeld “aandeel netafname”**:

Het laden moet in de modus **Slim** met minstens 6 A (enkelfasig) starten, ook als er maar 50% zonneoverschot is (de rest uit het net). Minimaal laadvermogen: 1 fase × 6 A × 230 V = 1.380 W, daarvan 50%: 690 W.

Zie ook het [alternatief met enable/disable om naast zonne-energie een deel netafname toe te staan](/nl/features/solar-charging).

```yaml
residualPower: -690
```