====== ioBroker SoC ======
Die Einrichtung erfolgt in openWB software2 im Webinterface unter **Einstellungen - Konfiguration - Fahrzeuge** im jeweiligen Fahrzeug. Das ioBroker-SoC-Modul für das Auslesen von SoC-Werten (und optional Reichweite/Kilometerstand) aus einem (meist lokalen) ioBroker-System stammt von openWB.

{{:openwb:vc:2.3.0:software:fahrzeug-infos:iobroker-soc_fahrzeug-modul.png?800|}}

Bild: Fahrzeug-Konfiguration mit ausgewähltem SoC-Modul ioBroker

===== Voraussetzung: ioBroker.rest-api =====
Für die Anbindung wird der Adapter **ioBroker.rest-api** benötigt. Dieser muss in ioBroker installiert und gestartet sein. Standardport ist **8093**.

Für die Einrichtung von ioBroker selbst bzw. der benötigten Fahrzeug-Adapter (z. B. zum Auslesen von SoC-Daten) bitte im [openWB-Forum](https://github.com/openWB/core/discussions/categories/fahrzeug-soc) beraten lassen – das ist keine Support-Leistung von openWB. Der Umweg über ioBroker lohnt sich aber oft: Für viele Fahrzeuge gibt es dort Adapter, die von der ioBroker-Community gepflegt werden und teils mehr oder aktuellere Fahrzeuge unterstützen als die openWB-eigenen Module. Wichtig ist dabei, die passende State-ID mit dem richtigen Wert (SoC in %, Reichweite, Kilometerstand) auszuwählen – eine falsche Auswahl kann sonst zu fehlerhaften Werten oder Problemen in openWB führen.

===== Konfiguration =====

{{:openwb:vc:2.3.0:software:fahrzeug-infos:iobroker-soc_konfiguration.png?800|}}

Bild: Einstellungen für SoC-Modul ioBroker

**ioBroker-URL**
Komplette URL mit Protokoll, IP/Hostname und Port des rest-api-Adapters.
Beispiel: `http://192.168.1.20:8093`

**Benutzer / Passwort (optional)**
Nur nötig, wenn im rest-api-Adapter die Authentifizierung aktiviert ist.

**State-ID SoC**
Vollständige State-ID aus ioBroker, z. B. der Objektbaum-Pfad eines Adapters.
Beispiel: `renault.0.folder.soc`
Zu finden im ioBroker-Admin unter „Objekte", per Klick auf den State kopierbar.

**State-ID Reichweite** *(optional)*
Leer lassen, wenn nicht verfügbar.

**State-ID Kilometerstand** *(optional)*
Leer lassen, wenn nicht verfügbar.

**SoC während der Ladung berechnen**
Berechnet den Ladestand (SoC) während der Ladung, falls ioBroker den Wert nicht laufend aktualisiert. Wenn openWB den SoC-Stand nach Ladestart selbst berechnen soll, werden die Werte aus dem Fahrzeugprofil (Kapazität, Wirkungsgrad und Durchschnittsverbrauch) herangezogen.

**Hinweis:** Bitte darauf achten, dass die Angaben im Fahrzeugprofil korrekt sind – bei jedem Ladevorgang den angezeigten und den tatsächlichen SoC am Ladeende vergleichen und bei Bedarf eine Feinabstimmung durchführen.

===== Funktionsweise =====
openWB fragt die hinterlegte(n) State-ID(s) über den ioBroker-rest-api-Adapter ab und liest den jeweils aktuellen Wert aus. Der SoC-Wert muss dabei zwischen 0 und 100 % liegen; Reichweite und Kilometerstand müssen, sofern angegeben, positive Werte sein.