Dieser Dienst ist dafür gedacht, komplexe MQTT-Topic-Strukturen in eine vereinfachte API umzuwandeln. Der Dienst greift openWB/* Topics auf und republiziert diese unter openWB/simpleAPI/* mit aufgeteilten JSON/Tuple-Werten und ID-Vereinfachung.

• Wert-Änderungserkennung: Publiziert nur wenn sich Werte tatsächlich ändern
• JSON/Tuple-Aufspaltung: Zerlegt komplexe Datenstrukturen in einzelne Topics
• ID-Vereinfachung: Niedrigste IDs werden auch ohne ID-Suffix verfügbar gemacht
• Retained Messages: Alle Nachrichten werden mit retain=true publiziert
• Robuste Verbindung: Automatische Wiederverbindung bei Verbindungsabbruch
• Konfigurationsdatei: Unterstützung für JSON-Konfigurationsdateien
• TLS/SSL Support: Optional verschlüsselte Verbindungen
• Detailliertes Logging: Konfigurierbare Log-Level
• Schreiboperationen: Vereinfachte Steuerung von Ladeparametern

Ist Teil der standard openWB Installation ab 2.1.9

Originale Topics werden von openWB/ zu openWB/simpleAPI/ transformiert.

Original: openWB/chargepoint/template/0 {"id": 0, "name": "Test", "max_current": 32}
Wird zu:
- openWB/simpleAPI/chargepoint/template/0/id → 0
- openWB/simpleAPI/chargepoint/template/0/name → Test  
- openWB/simpleAPI/chargepoint/template/0/max_current → 32

Original: openWB/counter/3/get/voltages [232.4, 0.0, 0.0]
Wird zu:
- openWB/simpleAPI/counter/3/get/voltages/1 → 232.4
- openWB/simpleAPI/counter/3/get/voltages/2 → 0.0
- openWB/simpleAPI/counter/3/get/voltages/3 → 0.0

openWB/simpleAPI/chargepoint/get/connected_vehicle/config/chargemode

Der Lademodus ist zugehörig zum Fahrzeug und dessen Profil. Daher befindet er sich in einem untergeordneten Topic und nicht auf höchster Ebene im Ladeunkt.

Die niedrigste ID jeder Komponente wird auch ohne ID verfügbar gemacht:

Original: openWB/counter/0/get/power 1042.4
Wenn 0 die niedrigste counter-ID ist:
- openWB/simpleAPI/counter/0/get/power → 1042.4
- openWB/simpleAPI/counter/get/power → 1042.4

Beschreibung: Lademodus am Ladepunkt ändern

Topic: openWB/simpleAPI/set/chargepoint/3/chargemode oder openWB/simpleAPI/set/chargepoint/chargemode (niedrigste ID)

Gültige Werte: instant, pv, eco, stop, target

Beispiel:

mosquitto_pub -t "openWB/simpleAPI/set/chargepoint/3/chargemode" -m "pv"

Beschreibung: Ladestrom für das Sofort laden

Topic: openWB/simpleAPI/set/chargepoint/3/chargecurrent

Wert: Stromstärke in Ampere (z.B. „16“)

Beispiel:

mosquitto_pub -t "openWB/simpleAPI/set/chargepoint/3/chargecurrent" -m "16"

Beschreibung: Minimaler EV SoC im PV Laden

Topic: openWB/simpleAPI/set/chargepoint/3/minimal_pv_soc

Wert: SoC in Prozent (z.B. „20“)

Beispiel:

mosquitto_pub -t "openWB/simpleAPI/set/chargepoint/3/minimal_pv_soc" -m "20"

Beschreibung: Minimaler Dauerstrom für das PV Laden

Topic: openWB/simpleAPI/set/chargepoint/3/minimal_permanent_current

Wert: Stromstärke in Ampere (z.B. „6“)

Beispiel:

mosquitto_pub -t "openWB/simpleAPI/set/chargepoint/3/minimal_permanent_current" -m "6"

Beschreibung: Maximaler Preis für das ECO Laden

Topic: openWB/simpleAPI/set/chargepoint/3/max_price_eco

Wert: Preis als Dezimalzahl (z.B. „0.25“)

Beispiel:

mosquitto_pub -t "openWB/simpleAPI/set/chargepoint/3/max_price_eco" -m "0.25"

Beschreibung: Sperrt den Ladepunkt

Topic: openWB/simpleAPI/set/chargepoint/3/chargepoint_lock

Werte: true/false

Beispiel:

mosquitto_pub -t "openWB/simpleAPI/set/chargepoint/3/chargepoint_lock" -m "true"

Beschreibung: Konfiguriert die Speicherbeachtung

Topic: openWB/simpleAPI/set/bat_mode

Gültige Werte: min_soc_bat_mode, ev_mode, bat_mode

Beispiel:

mosquitto_pub -t "openWB/simpleAPI/set/bat_mode" -m "ev_mode"

• Automatisches ID-Management: Wenn keine ID angegeben wird, wird die niedrigste verfügbare ID verwendet
• JSON-Template-Caching: Charge-Templates werden automatisch zwischengespeichert
• Werte-Mapping: Einfache Werte werden zu internen openWB-Werten gemappt
• Fehlerbehandlung: Ungültige Werte werden abgefangen und geloggt
• Logging: Alle Schreiboperationen werden ausführlich geloggt

Der Daemon überwacht folgende openWB-Komponenten:

• bat: Batteriespeicher (Leistung, SoC, Import/Export)
• pv: Photovoltaik-Anlagen (Leistung, Ertrag)
• chargepoint: Ladepunkte (Status, Konfiguration, Messwerte)
• counter: Energiezähler (Leistung, Verbrauch, Netzwerte)

• 51+ Parameter - Umfassende Unterstützung für Chargepoint, Counter, Battery und PV
• Auto-ID Feature - Automatische Auswahl der niedrigsten verfügbaren ID
• Template-basierte Settings - Erweiterte openWB-Template-Manipulation
• Raw & JSON Output - Flexible Ausgabeformate
• GET & POST Support - Beide HTTP-Methoden unterstützt

Alle Daten eines Ladepunkts:

curl "http://IPADRESSE/openWB/simpleAPI/simpleapi.php?get_chargepoint_all=3"

Auto-ID Feature - niedrigste verfügbare ID:

curl "http://IPADRESSE/openWB/simpleAPI/simpleapi.php?get_chargepoint_all=auto"
# oder ohne Angabe einer ID:
curl "http://IPADRESSE/openWB/simpleAPI/simpleapi.php?get_chargepoint_all="

Spannung Phase 1 (Raw-Ausgabe):

curl "http://IPADRESSE/openWB/simpleAPI/simpleapi.php?get_chargepoint_voltage_p1=3&raw=true"

Batterie-Daten:

curl "http://IPADRESSE/openWB/simpleAPI/simpleapi.php?battery=2"

Kombination mehrerer Werte:

curl "http://IPADRESSE/openWB/simpleAPI/simpleapi.php?get_chargepoint_all=3&battery=2"

Lademodus ändern:

curl -X POST -d "set_chargemode=pv&chargepoint_nr=3" \
     "http://IPADRESSE/openWB/simpleAPI/simpleapi.php"

Auto-ID Feature beim Schreiben:

# Schreibt an den Ladepunkt mit der niedrigsten ID
curl -X POST -d "set_chargemode=pv" \
     "http://IPADRESSE/openWB/simpleAPI/simpleapi.php"

Ladestrom setzen:

curl -X POST -d "chargecurrent=8.23&chargepoint_nr=3" \
     "http://IPADRESSE/openWB/simpleAPI/simpleapi.php"

Batterie-Modus setzen:

curl -X POST -d "bat_mode=min_soc_bat_mode" \
     "http://IPADRESSE/openWB/simpleAPI/simpleapi.php"

Das Auto-ID Feature ist eine Erweiterung der openWB SimpleAPI. Wenn keine ID angegeben wird oder auto verwendet wird, wird automatisch die niedrigste verfügbare ID verwendet:

# Diese Aufrufe sind equivalent:
curl "http://IPADRESSE/openWB/simpleAPI/simpleapi.php?get_chargepoint_all="
curl "http://IPADRESSE/openWB/simpleAPI/simpleapi.php?get_chargepoint_all=auto"
 
# Findet automatisch den Ladepunkt mit der niedrigsten ID
curl -X POST -d "chargemode=pv" "http://IPADRESSE/openWB/simpleAPI/simpleapi.php"

curl -H "Authorization: Bearer your-token" \
     -X POST -d "chargemode=pv&chargepoint_nr=3" \
     "https://IPADRESSE/openWB/simpleAPI/simpleapi.php"

curl -X POST \
     -d "username=admin" \
     -d "password=admin123" \
     -d "chargemode=pv" \
     -d "chargepoint_nr=3" \
     "https://IPADRESSE/openWB/simpleAPI/simpleapi.php"

{
  "chargepoint_3": {
    "power": 0,
    "voltages": [237.79, 0, 0],
    "currents": [0, 0, 0],
    "state_str": "Nicht bereit"
  }
}

Für Kompatibilität mit der originalen SimpleAPI kann das Raw-Format verwendet werden:

curl "http://IPADRESSE/openWB/simpleAPI/simpleapi.php?get_chargepoint_power=3&raw=true"
# Ausgabe: 0

# Alle wichtigen Werte in einem Aufruf
curl "http://IPADRESSE/openWB/simpleAPI/simpleapi.php?get_chargepoint_all=auto&battery=auto&pv=auto&get_counter=0"

# PV-Laden aktivieren
curl -X POST -d "set_chargemode=pv&chargepoint_nr=auto" \
     "http://IPADRESSE/openWB/simpleAPI/simpleapi.php"
 
# Ladestrom auf 16A setzen
curl -X POST -d "chargecurrent=16&chargepoint_nr=auto" \
     "http://IPADRESSE/openWB/simpleAPI/simpleapi.php"
 
# Batterie-Modus auf EV-Mode setzen
curl -X POST -d "bat_mode=ev_mode" \
     "http://IPADRESSE/openWB/simpleAPI/simpleapi.php"