# Configuratie

> Overzicht van de configuratie via evcc.yaml: waar het bestand staat, hoe het is opgebouwd en welke secties uw locatie en apparaten beschrijven.

evcc kan op twee manieren worden geconfigureerd:

**1. Configuratie via de UI (aanbevolen)**

De configuratie gebeurt via de webinterface onder **Configuratie**. Instellingen worden automatisch in de database opgeslagen. Meer informatie vindt u onder [Configuratie](/nl/installation/configuration).

**2. Configuratie via een bestand**

Configuratie via het bestand `evcc.yaml` wordt nog steeds ondersteund. Deze sectie beschrijft de configuratie op basis van YAML.

> **Parallel gebruik**
>
> Beide configuratiemethoden kunnen naast elkaar worden gebruikt. Apparaten (laadpunten, meters, zonnepanelensystemen, thuisbatterijen, voertuigen) worden uit beide bronnen samengevoegd. Voor andere instellingen heeft de configuratie via de UI voorrang. Details vindt u in de [FAQ](/nl/faq#ui-migration).

## Configuratie via een bestand (evcc.yaml)

Het configuratiebestand is in YAML-formaat geschreven en heet standaard `evcc.yaml`. Het staat in dezelfde map als evcc zelf of, op POSIX-systemen (bijv. Linux), in `/etc/evcc.yaml`.

Een afwijkend pad kunt u bij het starten opgeven: `evcc -c /path/to/evcc.yaml`

### Opbouw

Het configuratiebestand bestaat uit meerdere secties. Apparaten hebben een parameter `name`, zodat de secties naar elkaar kunnen verwijzen.

Een voorbeeldbestand met veel parameters vindt u hier: <https://github.com/evcc-io/evcc/blob/master/evcc.dist.yaml>

Hier volgt een overzicht van hoe de belangrijkste onderdelen van de configuratie samenhangen:

```
graph TD;
    site("site (Zuhause)")
    subgraph loadpoints
      loadpointA("Carport (charger: KEBA)")
      loadpointB("Garage (charger: Wallbe)")
    end
    subgraph meters
      meterGrid("Discovergy")
      meterPV("SMA Tripower")
      meterBattery("LG RESU")
    end
    subgraph vehicles
      vehicleA("VW ID.4")
      vehicleB("Renault Zoe")
      vehicleC("Tesla Model Y")
    end

    loadpointA -- loadpoint.1 --> site
    loadpointB -- loadpoint.2 --> site

    vehicleA --> loadpointA
    vehicleB --> loadpointA
    vehicleB --> loadpointB
    vehicleC --> loadpointB

    meterGrid -- meters.grid --> site
    meterPV -- meters.pvs --> site
    meterBattery -- meters.batterys --> site
```

### Hoe werkt evcc? (een kijkje onder de motorkap)

Voor de werking van het systeem is een netmeter (`grid`-meter) belangrijk. Die bepaalt het actuele overschotvermogen. Het meten van het opgewekte vermogen heeft hierbij geen invloed op de werking. evcc zonder netmeter gebruiken is ook mogelijk, zie de [FAQ](/nl/faq#configuration).

Het overschotvermogen wordt vergeleken met het minimale vermogen dat nodig is om te laden. Is dit voldoende, dan start het laden.

Het minimale vermogen om te laden wordt berekend uit de waarden `minCurrent` en `phases`, die per `loadpoint` (een groep laders op dezelfde plek) worden gedefinieerd. Zie [`loadpoints`](/nl/reference/configuration/loadpoints) voor meer informatie.

Bijvoorbeeld: `phases: 1` en `minCurrent: 8`

1 (fase) × 8 A (minCurrent) × 230 V (netspanning) = 1.840 W (minimaal vermogen om te laden)

#### Mogelijkheden om bij te sturen

Normaal komt het overschotvermogen overeen met het beschikbare laadvermogen. Het beschikbare laadvermogen kunt u echter met de volgende parameters naar wens aanpassen:

* Locatie: `residualpower`
* Locatie: `prioritySoc`
* Locatie: `bufferSoc`
* Locatie: `aux`
* Laadpunt: `enable: threshold`
* Laadpunt: `disable: threshold`

Raadpleeg de beschrijving van de betreffende parameter voor de mogelijke instellingen.

* [Configuratieparameters van de locatie](/nl/reference/configuration/site)
* [Configuratieparameters van het laadpunt](/nl/reference/configuration/loadpoints)

### Locatie

Een [locatie](/nl/reference/configuration/site) beschrijft de locatie met de aanwezige en benodigde apparaten van de thuisinstallatie en regelt het beschikbare vermogen.

### Laadpunt

Een [laadpunt](/nl/reference/configuration/loadpoints) beschrijft de laadinfrastructuur en combineert de *laders*, *voertuigen* en alles wat een laadpunt verder nodig heeft.

### Laders

De sectie [Laders](/nl/reference/configuration/chargers) bevat een lijst met laders en hun eigenschappen, zoals de manier waarop evcc ermee communiceert.

### Meters

De sectie [Meters](/nl/reference/configuration/meters) bevat een lijst met apparaten die verschillende vermogensstromen meten. Daartoe behoren:

* Vermogen van netafname en teruglevering
* Door zonne-energie opgewekt vermogen
* Laadstroom van de elektrische auto (als de lader dit niet zelf ondersteunt)
* Vermogensstroom van de thuisbatterij(en)

### Opwekbegrenzingsapparaten

[Opwekbegrenzingsapparaten](/nl/reference/configuration/curtailers) zijn apparaten die alleen de teruglevering van het zonnepanelensysteem op verzoek van de netbeheerder begrenzen (§ 9 EEG), bijv. de SMA Sunny Home Manager 2.0 of de master-omvormer van een installatie met meerdere omvormers.

### Voertuigen

Om het laden van elektrische auto’s tot een bepaald laadniveau te begrenzen, kunt u hier uw [voertuigen](/nl/reference/configuration/vehicles) en hun online toegangsgegevens opgeven.

### HEMS

evcc kan de laadpunten en hun laadstromen doorgeven aan een ander [Home Energy Management System (HEMS)](/nl/reference/configuration/hems), zodat dat systeem deze informatie kan gebruiken, bijv. om de thuisbatterij aan te sturen.

### Meldingen

In deze sectie kunt u gebeurtenissen definiëren waarover u geïnformeerd wilt worden. Voor het versturen van berichten worden veel verschillende systemen ondersteund.

[Meer informatie](/nl/reference/configuration/messaging)