Welcome to my little documentation repository that describes how to integrate Homeassistant with Heidelberg Energy Wallbox.
I bought a Heidelberg Energy Wallbox to charge my electric car. The Wallbox can be controlled using RS485/Modbus interface. With this integration I want to control the Wallbox to optimize the charge/energy level since I have solar modules installed on my roof. (german: "PV Überschussladen") Furthermore I tried to assemble everything with as few components as required.
- 1x Heidelberg Energy Control
- Homeassistant 2022.7.5 running inside a Jail
- FreeBSD 13.0-RELEASE
- DSD Tech RS485/USB Adapter
- Ensure that everything is powered off (german: "Die 5 Sicherheitsregeln der Elektrotechnik")
- Remove the cover from the Wallbox
- Connect the wire (I used RJ45/Cat6) with A/B pins at the right side of the board (IN, marked with label "4"). You should use one twisted pair (picture source)
- Configure the Wallbox via Jumpers according to this manual: https://github.com/steff393/wbec#switch-configuration-of-wallbox
- Connect the wire with RS485/USB Adapter (A/B) which is plugged on your homeassistant hardware
- Ensure you can access the DSD Tech Adapter via /dev/ttyUSB0 (Linux) or /dev/ttyU0 (Freebsd)
- Add the modbus integration as specified in integration_wallbox.yaml
- Add the modbus automation to ensure the wallbox does not show an error (a "heartbeat" command must be sent via modbus)
- add modbus/wallbox configuration, e.g. in your configuration.yaml:
modbus: !include integration_wallbox.yaml
- add automation_wallbox.yaml to your automation rules
- by writing to a specific register you can now adjust the target output power of your wallbox
Example service call
service: modbus.write_register
data:
slave: 1
address: 261
value: 60
hub: wallbox
- Great project, https://github.com/steff393/wbec
- Homeassistant's Modbus documentation, https://www.home-assistant.io/integrations/modbus/
- Register Table, https://www.amperfied.de/wp-content/uploads/2022/06/ModBus-Register-Tabelle.pdf