# ioBroker

Quelle: https://docs.evcc.io/de/meters/iobroker

Auf der verwendeten ioBroker Instanz muss der `rest-api` adapter (nicht `simple-api`) installiert sein. Er muss als Extension eines Web adapters
konfiguriert sein.
Authentifiziert werden kann nur mittels `basic` authentication. Wird kein Passwort angegeben, so wird keine Authentifizierung durchgeführt.
Bei der Angabe der Entities für die einzelnen Messwerte ist darauf zu achten, dass diese korrekt URL-Encoded sind.
So wird aus `shelly.0.SHEM-3#8CAAB561991E#1.Total.ConsumedPower  shelly.0.SHEM-3%238CAAB561991E%231.Total.ConsumedPower`

## Parameter

| Name | Beschreibung | Standard / Beispiel | |
| --- | --- | --- | --- |
| uri | Der vollständige URI der ioBroker Instanz HTTP(S) Adresse | https://iobroker.homelab.lan:8082 |  |
| user | Benutzerkonto bspw. E-Mail Adresse, User Id, etc. |  |  |
| password | Passwort Zugangspasswort des Dienstes |  |  |
| power | Leistung |  W |  |
| soc | Ladestand |  % |  |
| capacity | Akkukapazität | 50 kWh |  |
| minsoc | Minimaler Ladestand Untere Grenze wie am Batteriesystem eingestellt. Wird vom Optimizer genutzt. | 0 % |  |
| maxsoc | Maximaler Ladestand Obere Grenze wie am Batteriesystem eingestellt. Wird vom Optimizer und für Netzladen genutzt. | 100 % |  |
| cache | Cache Zeitintervall für erneute Datenabfrage | 5m | erweitert |
| energy | Zählerstand |  kWh | erweitert |
| currentL1 | L1 Stromstärke |  A | erweitert |
| currentL2 | L2 Stromstärke |  A | erweitert |
| currentL3 | L3 Stromstärke |  A | erweitert |
| maxchargepower | Maximale Ladeleistung Für erzwungenes Laden des Speichers. |  W | erweitert |
| maxdischargepower | Maximale Entladeleistung Maximale Entladeleistung des Speichers. |  W | erweitert |
| maxacpower | Maximale AC Leistung des Hybrid-Wechselrichters | 0 W | erweitert |

## Konfigurationsbeispiel für evcc.yaml

```yaml
meters:
    - name: my_grid
      type: template
      template: iobroker
      usage: grid
      uri: https://iobroker.homelab.lan:8082 # Der vollständige URI der ioBroker Instanz, HTTP(S) Adresse
      user: # Benutzerkonto, bspw. E-Mail Adresse, User Id, etc. (optional)
      password: # Passwort, Zugangspasswort des Dienstes (optional)
      power: # Leistung (W), optional
      soc: # Ladestand (%), optional
      cache: 5m # Cache, Zeitintervall für erneute Datenabfrage (optional)
      energy: # Zählerstand (kWh), optional
      currentL1: # L1 Stromstärke (A), optional
      currentL2: # L2 Stromstärke (A), optional
      currentL3: # L3 Stromstärke (A), optional
```

```yaml
meters:
    - name: my_pv
      type: template
      template: iobroker
      usage: pv
      uri: https://iobroker.homelab.lan:8082 # Der vollständige URI der ioBroker Instanz, HTTP(S) Adresse
      user: # Benutzerkonto, bspw. E-Mail Adresse, User Id, etc. (optional)
      password: # Passwort, Zugangspasswort des Dienstes (optional)
      power: # Leistung (W), optional
      soc: # Ladestand (%), optional
      cache: 5m # Cache, Zeitintervall für erneute Datenabfrage (optional)
      energy: # Zählerstand (kWh), optional
      currentL1: # L1 Stromstärke (A), optional
      currentL2: # L2 Stromstärke (A), optional
      currentL3: # L3 Stromstärke (A), optional
      maxacpower: 0 # Maximale AC Leistung des Hybrid-Wechselrichters (W), optional
```

```yaml
meters:
    - name: my_battery
      type: template
      template: iobroker
      usage: battery
      uri: https://iobroker.homelab.lan:8082 # Der vollständige URI der ioBroker Instanz, HTTP(S) Adresse
      user: # Benutzerkonto, bspw. E-Mail Adresse, User Id, etc. (optional)
      password: # Passwort, Zugangspasswort des Dienstes (optional)
      power: # Leistung (W), optional
      soc: # Ladestand (%), optional
      capacity: 50 # Akkukapazität (kWh), optional
      minsoc: 0 # Minimaler Ladestand (%), Untere Grenze wie am Batteriesystem eingestellt. Wird vom Optimizer genutzt. (optional)
      maxsoc: 100 # Maximaler Ladestand (%), Obere Grenze wie am Batteriesystem eingestellt. Wird vom Optimizer und für Netzladen genutzt. (optional)
      cache: 5m # Cache, Zeitintervall für erneute Datenabfrage (optional)
      energy: # Zählerstand (kWh), optional
      currentL1: # L1 Stromstärke (A), optional
      currentL2: # L2 Stromstärke (A), optional
      currentL3: # L3 Stromstärke (A), optional
      maxchargepower: # Maximale Ladeleistung (W), Für erzwungenes Laden des Speichers. (optional)
      maxdischargepower: # Maximale Entladeleistung (W), Maximale Entladeleistung des Speichers. (optional)
```

```yaml
meters:
    - name: my_charger
      type: template
      template: iobroker
      usage: charge
      uri: https://iobroker.homelab.lan:8082 # Der vollständige URI der ioBroker Instanz, HTTP(S) Adresse
      user: # Benutzerkonto, bspw. E-Mail Adresse, User Id, etc. (optional)
      password: # Passwort, Zugangspasswort des Dienstes (optional)
      power: # Leistung (W), optional
      soc: # Ladestand (%), optional
      cache: 5m # Cache, Zeitintervall für erneute Datenabfrage (optional)
      energy: # Zählerstand (kWh), optional
      currentL1: # L1 Stromstärke (A), optional
      currentL2: # L2 Stromstärke (A), optional
      currentL3: # L3 Stromstärke (A), optional
```