# site

> So beschreibst du deine Hausinstallation in der evcc.yaml: Netz-, PV- und Batteriezähler zuordnen und die Überschussregelung mit residualPower abstimmen.

Beschreibt den Standort mit den vorhandenen und benötigten Geräten der Hausinstallation und ist für das Regeln der verfügbaren Leistung zuständig.

Um das Laden mit PV-Überschuss zu regeln, ist ein auslesbarer Zähler direkt hinter dem Netzanschlusspunkt notwendig. Zusätzlich können auch Geräte für die PV-Leistung und Hausbatterie(n) angegeben werden. Mehrere Geräte werden dabei in der Leistung intern automatisch addiert. Bei Batteriespeichern wird der Mittelwert des Ladezustands gebildet.

**Beispiel**:

```yaml
site:
  title: Zuhause # display name for UI
  meters:
    grid: mygridmeter # grid meter reference
    pv:
      - mypv1 # first pv meter reference
      - mypv9 # second pv meter reference
    battery:
      - mybat5 # battery meter reference
    aux:
      - myaux1 # self-regulating consumer
    consumer:
      - myconsumer1 # regular consumer, recorded for consumption statistics
    ext:
      - myext1 # for data logging, load management, etc.
  curtailers:
    - my_curtailer # curtailment device reference
  residualPower: 100
```

***

## Erforderliche Parameter

### `title`

Die angezeigte Beschreibung des Ladepunktes, wird in der UI angezeigt.

**Beispiel**:

```yaml
title: Zuhause
```

***

### `meters`

Definiert welche konfigurierten [`meter`](/de/reference/configuration/meters) (Strommessgeräte) als welche Art Messpunkt verwendet werden sollen. Hier erfolgt somit die logische Verknüpfung der Gerätedefiniton mit dem Verwendungszweck. Ein zunächst universeller Zähler bekommt somit entsprechend seines Einbauortes in der Hausinstallation einen Zweck zugewiesen.

> **Hinweis**
>
> Es ist mindestens die Konfiguration eines `grid` oder eines `pv` Elementes notwendig!
>
> Ohne mindestens einen der beiden Einträge kann evcc nicht verwendet werden!

**Beispiel**:

```yaml
site:
  meters:
    grid: mygridmeter # grid meter reference
    pv: mypv1 # pv meter reference
    battery: mybat2 # battery meter reference
    aux: myaux1
```

***

## Optionale Parameter

### `meters.grid`

Definiert das [`meter`](/de/reference/configuration/meters) (Strommessgerät), welches die Messwerte des Netzanschlusspunktes liefert.

**Mögliche Werte**: Wert eines `name` Parameters in der [`meters`](#meters) Konfiguration.

**Beispiel**:

```yaml
grid: mygridmeter # grid meter reference
```

***

### `meters.pv`

Definiert die [`meter`](/de/reference/configuration/meters) (Strommessgeräte), welche die PV-Erzeugungswerte liefern. Es können mehrere Geräte angegeben werden. Die Leistungsdaten werden automatisch addiert.

**Mögliche Werte**: Ein Wert oder eine Liste von Werten eines `name` Parameters in der [`meters`](#meters) Konfiguration. Wobei die Listenversion auch bei Einzelwerten genutzt werden kann.

**Beispiel**:

```yaml
pv: myonlypv # single pv meter reference
```

oder

```yaml
pv: # (pvs = veraltet)
  - myoldpv # first pv meter reference
  - mynewestpv # second pv meter reference
```

***

### `meters.battery`

Definiert die [`meter`](/de/reference/configuration/meters) (Strommessgeräte), welche die Messdaten des/der Batteriespeicher(s) liefern. Es können mehrere Geräte angegeben werden. Die Leistungsdaten werden automatisch addiert und aus den Speicherfüllständen wird ein Mittelwert gebildet.

**Mögliche Werte**: Ein Wert oder eine Liste von Werten eines `name` Parameters in der [`meters`](#meters) Konfiguration. Wobei die Listenversion auch bei Einzelwerten genutzt werden kann.

**Beispiel**:

```yaml
battery: myonlybat # single battery meter reference
```

oder

```yaml
battery: # (batteries = veraltet)
  - mysmallbat # first battery meter reference
  - myhugebat # second battery meter reference
```

### `meters.aux`

Zähler für externe Geräte, die über eine eigene Überschussregelung verfügen, aber nicht direkt durch evcc gesteuert werden, z. B. ein selbstregelnder Heizstab. Ihre Leistung fließt in die verfügbare Überschussleistung zur Fahrzeugladung ein, unter der Annahme, dass das Gerät seinen Verbrauch reduziert, sobald evcc diese Leistung der Ladung zuschlägt. Mehrere Zähler werden addiert.

**Mögliche Werte**: Ein Wert oder eine Liste von Werten eines `name` Parameters in der [`meters`](#meters) Konfiguration. Wobei die Listenversion auch bei Einzelwerten genutzt werden kann.

**Beispiel**:

```yaml
aux: myaux # single aux meter reference
```

oder

```yaml
aux:
  - myaux1 # first aux meter reference
  - myaux2 # second aux meter reference
```

### `meters.consumer`

Zähler für reguläre Verbraucher wie Waschmaschine oder Spülmaschine, die ausschließlich für die Verbrauchsstatistik erfasst werden. Anders als bei `aux` fließt diese Leistung nicht in die verfügbare Überschussleistung zur Fahrzeugladung ein.

**Mögliche Werte**: Ein Wert oder eine Liste von Werten eines `name` Parameters in der [`meters`](#meters) Konfiguration. Wobei die Listenversion auch bei Einzelwerten genutzt werden kann.

**Beispiel**:

```yaml
consumer: myconsumer # single consumer meter reference
```

oder

```yaml
consumer:
  - myconsumer1 # first consumer meter reference
  - myconsumer2 # second consumer meter reference
```

### `meters.ext`

Zähler, die nicht für die Regelung verwendet oder in der Oberfläche angezeigt werden, z. B. Unterverteilungen oder alternative Netz- oder PV-Zähler. Ihre Daten werden nur geloggt und exportiert, fließen aber nicht in die Überschuss- oder Verbrauchsstatistik ein.

**Mögliche Werte**: Ein Wert oder eine Liste von Werten eines `name` Parameters in der [`meters`](#meters) Konfiguration. Wobei die Listenversion auch bei Einzelwerten genutzt werden kann.

**Beispiel**:

```yaml
ext: myext # single ext meter reference
```

oder

```yaml
ext:
  - myext1 # first ext meter reference
  - myext2 # second ext meter reference
```

### `curtailers`

Einspeisebegrenzer aus der [`curtailers`](/de/reference/configuration/curtailers)-Konfiguration, die die Einspeisung auf Anforderung des Netzbetreibers begrenzen (§ 9 EEG). Sie werden zusammen mit den abregelbaren `pv`-Zählern angesteuert, wenn die [`hems`](/de/reference/configuration/hems)-Integration ein Limit signalisiert.

**Mögliche Werte**: Eine Liste von Werten eines `name` Parameters in der [`curtailers`](/de/reference/configuration/curtailers) Konfiguration.

**Beispiel**:

```yaml
curtailers:
  - my_curtailer # curtailment device reference
```

### `residualPower`

Legt den Soll-Arbeitspunkt der Überschussregelung am Netzübergang (Gridmeter) fest. Der Standardwert ist 0 (Watt). Positive Werte verschieben den Sollwert in Richtung Netzeinspeisung, negative Werte in Richtung Netzbezug. Mit diesem Wert wird der durch die Steuerung einzustellende “Ruhezustand” des Regelkreises eingestellt.

Insbesondere im Zusammenspiel mit weiteren unabhängigen Überschussausregelungen wie z. B. der eines Batteriespeichers ist es obligatorisch, diesen Wert anzupassen, um ein definiertes Systemverhalten mit klaren Prioritäten zu erzielen.

Soll im Smart-Modus ein Netzbezugsanteil verbleiben bzw. zugelassen werden, muss hier eine negative Leistung entsprechend des Maximalanteils des Netzbezugs konfiguriert werden.

#### `grid` `meter` vorhanden

* Positiver Wert: Verbleibende Netzeinspeiseleistung
* Negativer Wert: Verbleibende Netzbezugsleistung

#### Nur `pv` `meter` vorhanden

* Positiver Wert: Typischer Hausverbrauch, um damit den PV-Überschuss abschätzen zu können
* Negativer Wert: angegebene Leistung wird zur PV-Leistung addiert und erhöht die zur Verfügung stehende Ladeleistung (Achtung: Netzbezug)

> **Hinweis**
>
> Bei Existenz eines Batteriespeichers wird dringend empfohlen hier einen kleinen Wert von 100 bis 300 (Watt) einzutragen, um damit eine Speicherladung gemäß der konfigurierten Prioritäten (siehe `prioritySoc`) zu ermöglichen. Andernfalls “sieht” die unabhängige Regelung des Speichers keinen nutzbaren Überschuss.
>
> Ebenso lässt sich damit bei schnellen Erzeugungs- und Lastwechseln auch ohne Speicher ein kurzzeitiger Netzbezug besser vermeiden.

**Beispiel “Batteriespeicher”**:

```yaml
residualPower: 100
```

**Beispiel “Netzbezugsanteil”**:

Die Ladung soll im Smart-Modus mit mindestens 6A (einphasig) auch bereits mit nur 50% PV-Anteil beginnen (Rest Netzbezug) Mindestladeleistung: 1 Phase \_ 6A \_ 230V = 1380 W, davon 50%: 690 W. Siehe auch die [Alternative mittels enable/disable um anteilig PV und Netzbezug zu erlauben](/de/features/solar-charging).

```yaml
residualPower: -690
```