Wbec
Control Heidelberg Wallbox Energy Control over WiFi using ESP8266
Install / Use
/learn @steff393/WbecREADME
wbec - WLAN-Anbindung der Heidelberg WallBox Energy Control über ESP8266
Die Heidelberg Wallbox Energy Control ist eine hochwertige Ladestation, bietet aber nur Modbus RTU als Schnittstelle.
Ziel des Projekts ist es, eine WLAN-Schnittstelle zu entwickeln um zusätzliche Funktionen (z.B. PV-Überschussladen) zu ermöglichen.
wbec Homepage
Empfehlung im Heidelberg Amperfied Blog
Funktionen
- Anbindung an openWB, EVCC, Solaranzeige
- MQTT-Kommunikation mit openWB und EVCC (ideal für mehrere Ladestationen)
- Steuerbar per Android App Wallbox Steuerung
- PV-Überschussladen, Zielladen, etc. mit den o.g. Steuerungen
- Abfrage von Shelly 3EM, powerfox, Solaredge, Fronius, ...
- RFID-Kartenleser zur Freischaltung der Wallbox mit gültiger Karte/Chip (spezielle HW nötig, s. Wiki)
- Ansteuerung aller verbundenen Ladestationen (bis zu 16 Follower am Modbus, bis zu 8 openWB-Ladepunkte)
- Lokales Lastmanagement für zwei Wallboxen
- Softwareupdate per WLAN (Over The Air), z.B. mit PlatformIO oder einfach per Browser (s. Wiki)
- Weniger als 1W Strombedarf (trotz Ansteuerung von bis zu 16 Ladestationen)
- -> Neue Funktionen
Kontakt
Bei Fragen oder wenn ihr Unterstützung braucht gerne einfach eine Mail schicken (wbec393@gmail.com).
Bitte schaut auch ins Wiki und in meine anderen Projekte, z.B. den SmartUploader zum Auslesen von Wechselrichtern und hgdo zur Steuerung von Torantrieben.
Beispiele
Einfaches Web-Interface (geeignet für alle Browser, Smartphone, PC, etc.):
http://wbec.local/
JSON API Schnittstelle:
http://wbec.local/json
{
"wbec": {
"version": "v0.3.0" // wbec version
"bldDate": "2021-06-10" // wbec build date
},
"box": [
{ // s. also https://wallbox.heidelberg.com/wp-content/uploads/2021/04/EC_ModBus_register_table_20210222.pdf
"busId": 1, // Modbus bus id (as configured by DIP switches)
"version": "108", // Modbus Register-Layouts Version, e.g. 1.0.8
"chgStat": 2, // Charging State
"currL1": 0, // L1 - Current RMS (in 0.1A)
"currL2": 0, // L2 - Current RMS (in 0.1A)
"currL3": 0, // L3 - Current RMS (in 0.1A)
"pcbTemp": 333, // PCB-Temperatur (in 0.1°C)
"voltL1": 232, // Voltage L1 - N rms in Volt
"voltL2": 9, // Voltage L2 - N rms in Volt
"voltL3": 9, // Voltage L3 - N rms in Volt
"extLock": 1, // extern lock state
"power": 0, // Power (L1+L2+L3) in VA
"energyP": 0, // Energy since PowerOn (in kWh)
"energyI": 0.003, // Energy since Installation (in kWh)
"currMax": 16, // Hardware configuration maximal current (in 0.1A)
"currMin": 6, // Hardware configuration minimal current (in 0.1A)
"logStr": "<item no> <mfgDate> <serial>",
"wdTmOut": 15000, // ModBus-Master WatchDog Timeout (in ms)
"standby": 4, // Standby Function Control
"remLock": 1, // Remote lock (only if extern lock unlocked)
"currLim": 130, // Maximal current command
"currFs": 0, // FailSafe Current configuration
"load": 0, // wbec load management
"resCode": "0" // Result code of last Modbus message (0 = ok)
},
{ // Values of 2nd box ...
"busId": 2,
"version": "0",
"chgStat": 0,
...
"load": 0,
"resCode": "e4"
}
],
"modbus": {
"state": {
"lastTm": 2852819, // Timestamp of last Modbus message (in ms)
"millis": 2855489 // Time since start of wbec (in ms)
}
},
"rfid": {
"enabled": true,
"release": false,
"lastId": "0cb6a781"
},
"wifi": {
"mac": "00:1F:3F:15:29:7E", // wbec MAC address
"rssi": -76, // WiFi signal
"signal": 48, // WiFi signal quality (in %)
"channel": 11 // WiFi channel
}
}
Maximalen Ladestrom einstellen:
http://192.168.xx.yy/json?currLim=120 --> set current limit to 12A (on the box with id=0, i.e. ModBus Bus-ID=1)
http://192.168.xx.yy/json?currLim=60&id=2 --> set current limit to 6A on the box with id=2 (i.e. ModBus Bus-ID=3)
Danksagung
Folgende Projekte wurden in wbec genutzt/angepasst:
- modbus-esp8266
- ESP Async WebServer
- ArduinoJson
- PubSubClient
- NTPClient
- MFRC522
- RTCVars
- arduinoWebSockets
- WiFiManager
- Web Interface
- A Beginner's Guide to the ESP8266 - article
- AsyncElegantOTA
Ein besonderer Dank ergeht an die frühen Tester und Unterstützer: mli987, profex1337, Clanchef und viele mehr!
Unterstützung des Projektes
wbec gefällt dir? Dann gib dem Projekt einen Stern auf GitHub!
Related Skills
node-connect
334.5kDiagnose OpenClaw node connection and pairing failures for Android, iOS, and macOS companion apps
frontend-design
82.2kCreate distinctive, production-grade frontend interfaces with high design quality. Use this skill when the user asks to build web components, pages, or applications. Generates creative, polished code that avoids generic AI aesthetics.
openai-whisper-api
334.5kTranscribe audio via OpenAI Audio Transcriptions API (Whisper).
commit-push-pr
82.2kCommit, push, and open a PR
