explain ext, aux meters (#735)

Author: naltatis

docs/devices/meters.mdx

@@ -9,35 +9,54 @@ import DeviceFeatureFilter from "/src/components/DeviceFeatureFilter";
 import DeviceConfig from "/src/components/DeviceConfig";
 import SponsorshipRequired from "/docs/_sponsorship_required.mdx";
 
-# PV, Batterie, Netz
+# PV, Batterie, Netz, Zähler
 
 Die aufgelisteten Geräte können als `meter` für verschiedene Zwecke eingebunden werden:
 
-- `grid`: Netzanschluss
+- `grid`: Netzanschluss (nur eins möglich)
 - `pv`: PV Produktion
 - `battery`: Hausbatterie
 - `charge`: Ladeleistung an der Wallbox
 - `aux`: intelligenter Verbraucher mit eigener Überschussregelung
+- `ext`: weiterer Zähler, bspw. für [Lastmanagement](../features/loadmanagement) oder Datenerfassung
 
 In der Konfigurationsdatei gibt es hierzu den folgenden Bereich:
 
 ```yaml
+# Definition aller Geräte
 meters:
   - name: grid1
     type: ...
   - name: pv1
     type: ...
+  - name: pv2
+    type: ...
   - name: battery1
     type: ...
+
+# Zuordnung nach Verwendungszweck
+site:
+  meters:
+    grid: grid1
+    pv:
+      - pv1
+      - pv2
+    battery:
+      - battery1
+    aux:
+      - ...
+    ext:
+      - ...
 ```
 
-Auf dieser Seite findest du die Konfigurationen für alle von evcc bekannterweise unterstützte Komponenten die als Energiemesspunkte (Zähler) eingebunden werden kann.
-Nachdem du das Code-Beispiel für deine Zähler angepasst und in die `evcc.yaml` übernommen hast, kannst du die Verbindung mit dem Befehl `evcc meter` testen. Dabei werden alle konfigurierten Zähler getestet. Mit dem Befehl `evcc meter --name my_meter` kann man mittels des vergebenen Namens selektiv testen.
+Auf dieser Seite findest du die Konfigurationen für alle unterstützte Komponenten die als Energiemesspunkte (Zähler) eingebunden werden können.
+Nachdem du das Code-Beispiel für deine Zähler angepasst und in die `evcc.yaml` übernommen hast, kannst du die Verbindung mit dem Befehl `evcc meter` testen. Dabei werden alle konfigurierten Zähler getestet.
+Mit dem Befehl `evcc meter --name my_meter` kann man mittels des vergebenen Namens selektiv testen.
 
 ```
 $ ./evcc meter
 
-grid
+grid1
 -----
 Power:          -31W
 Energy:         5195.5kWh

docs/features/loadmanagement.mdx

@@ -91,6 +91,11 @@ Standardmäßig bildet die Steuerung die aktuelle Leistung und Stromstärke aus
 Dies ist insbesondere sinnvoll, wenn an der Sicherung auch noch weitere Verbraucher angeschlossen sind.
 
 ```yaml
+site:
+  meters:
+    ext:
+      - carport_meter
+
 meters:
   - name: carport_meter
     type: template
@@ -102,6 +107,8 @@ circuits:
     maxCurrent: 32
 ```
 
+Hinweis: Kommt ein Zähler zum Einsatz, der noch keine andere Verwendung (bspw. `grid`) hat, muss er als externer Zähler unter `site.meters.ext` verknüpft werden.
+
 ## Grenzwerte
 
 An jedem Stromkreis kann sowohl eine maximale Stromstärke pro Phase (`maxCurrent`) als auch eine maximale Leistung (`maxPower`) konfiguriert werden.

docs/reference/configuration/site.mdx

@@ -25,7 +25,9 @@ site:
     battery:
       - mybat5 # battery meter reference
     aux:
-      - myaux1
+      - myaux1 # self-regulating consumer
+    ext:
+      - myext1 # for data logging, load management, etc.
   residualPower: 100
 ```
 

i18n/en/docusaurus-plugin-content-docs/current/devices/meters.mdx

@@ -9,7 +9,7 @@ import DeviceFeatures from "/src/components/DeviceFeatures";
 import DeviceFeatureFilter from "/src/components/DeviceFeatureFilter";
 import SponsorshipRequired from "/docs/_sponsorship_required.mdx";
 
-# PV, Battery, Grid
+# PV, Battery, Grid, Meter
 
 The devices on this page can all be used as energy measuring points (`meter`) for various purposes:
 
@@ -18,26 +18,45 @@ The devices on this page can all be used as energy measuring points (`meter`) fo
 - `battery`: House battery
 - `charge`: Charging power at the wallbox
 - `aux`: Smart consumer with its own surplus regulation
+- `ext`: Additional meter, e.g. for [load management](../features/loadmanagement) or data logging
 
 The configuration is formatted as follows:
 
 ```yaml
+# Definition of all devices
 meters:
   - name: grid1
     type: ...
   - name: pv1
     type: ...
+  - name: pv2
+    type: ...
   - name: battery1
     type: ...
+
+# Mapping by purpose
+site:
+  meters:
+    grid: grid1
+    pv:
+      - pv1
+      - pv2
+    battery:
+      - battery1
+    aux:
+      - ...
+    ext:
+      - ...
 ```
 
+This page lists the configurations for all supported components that can be used as energy measuring points (`meter`).
 Once you have adapted the code samples to suit your meters in `evcc.yaml`, you can test the connection using the `evcc meter` command, which returns the current status of all connected meters.
-If you just want to test one meter at a time, use `evcc meter --name my_meter`.
+The command `evcc meter --name grid1` can be used to test a single meter by name.
 
 ```
 $ ./evcc meter
 
-grid
+grid1
 -----
 Power:          -31W
 Energy:         5195.5kWh

i18n/en/docusaurus-plugin-content-docs/current/features/loadmanagement.mdx

@@ -88,6 +88,11 @@ By configuring a `meter` on a `circuit`, the real load can also be taken into ac
 This is particularly useful if other consumers are also connected to the fuse.
 
 ```yaml
+site:
+  meters:
+    ext:
+      - carport_meter
+
 meters:
   - name: carport_meter
     type: template
@@ -99,6 +104,8 @@ circuits:
     maxCurrent: 32
 ```
 
+Note: If a meter is used that is not yet used for another purpose (e.g. `grid`), it must be linked as an external meter under `site.meters.ext`.
+
 ## Limits
 
 Both a maximum current per phase (`maxCurrent`) and a maximum power (`maxPower`) can be configured on each circuit.

i18n/en/docusaurus-plugin-content-docs/current/reference/configuration/site.mdx

@@ -25,7 +25,9 @@ site:
     battery:
       - mybat5 # battery meter reference
     aux:
-      - myaux1
+      - myaux1 # self-regulating consumer
+    ext:
+      - myext1 # for data logging, load management, etc.
   residualPower: 100
 ```