evcc 🚘☀️

Evcc is an extensible EV Charge Controller with PV integration implemented in Go. Featured in PV magazine.

Features

• simple and clean user interface
• wide range of supported chargers:
  • ABL eMH1, Alfen (Eve), Bender (CC612/613), cFos (PowerBrain), Daheimladen, Ebee (Wallbox), Ensto (Chago Wallbox), EVSEWifi/ smartWB, Garo (GLB, GLB+, LS4), go-eCharger, HardyBarth (eCB1, cPH1, cPH2), Heidelberg (Energy Control), Innogy (eBox), Juice (Charger Me), KEBA/BMW, Menneckes (Amedio, Amtron Premium/Xtra, Amtron ChargeConrol), NRGkick, openWB (includes Pro), Optec (Mobility One), PC Electric (includes Garo), TechniSat (Technivolt), Ubitricity (Heinz), Vestel, Wallbe, Webasto (Live), Mobile Charger Connect
  • experimental EEBus support (PMCC)
  • Build-your-own: Phoenix (includes ESL Walli), EVSE DIN
  • Smart-Home outlets: FritzDECT, Shelly, Tasmota, TP-Link
• wide range of supported meters for grid, pv, battery and charger:
  • ModBus: Eastron SDM, MPM3PM, ORNO WE, SBC ALE3 and many more, see https://github.com/volkszaehler/mbmd#supported-devices for a complete list
  • Integrated systems: SMA Sunny Home Manager and Energy Meter, KOSTAL Smart Energy Meter (KSEM, EMxx)
  • Sunspec-compatible inverter or home battery devices: Fronius, SMA, SolarEdge, KOSTAL, STECA, E3DC, ...
  • and various others: Discovergy, Tesla PowerWall, LG ESS HOME, OpenEMS (FENECON)
• vehicle integration (state of charge, remote charge, battery and preconditioning status):
  • Audi, BMW, Citroën, Dacia, Fiat, Ford, Hyundai, Jaguar, Kia, Landrover, Mercedes, Mini, Nissan, Opel, Peugeot, Porsche, Renault, Seat, Smart, Skoda, Tesla, Volkswagen, Volvo
  • Services: OVMS, Tronity
  • Scooters: Niu, Silence
• plugins for integrating with any charger/ meter/ vehicle:
  • Modbus, HTTP, MQTT, Javascript, WebSockets and shell scripts
• status notifications using Telegram, PushOver and many more
• logging using InfluxDB and Grafana
• granular charge power control down to mA steps with supported chargers (labeled by e.g. smartWB als OLC)
• REST and MQTT APIs for integration with home automation systems
• HomeAssistant add-on

Getting Started

You'll find everything you need in our documentation (German).

Contribute

To build evcc from source, Go 1.18 and Node 16 are required.

Build and run go backend. The UI becomes available at http://127.0.0.1:7070/

make
./evcc

For frontend development start the Vue toolchain in dev-mode. Open http://127.0.0.1:7071/ to get to the livelreloading development server. It pulls its data from port 7070 (see above).

npm install
npm run start

Code formatting

We use linters (golangci-lint, Prettier) to keep a coherent source code formatting. It's recommended to use the format-on-save feature of your editor. For VSCode use the Go, Prettier and Veture extension. You can manually reformat your code by running:

make lint
make lint-ui

Changing UI code

To ensure reproducability the build frontend artifacts are part of the source code repository. If you've made changes to frontend code, please make sure to rebuild the production assets before you commit.

make ui

Changing templates

Evcc supports a massive amount of different devices. To keep our documentation and website in sync with the latest software the core project (this repo) generates meta-data that's pushed to the docs and evcc.io repository. Make sure to update this meta-data every time you make changes to a templates.

make docs

If you miss one of the above steps Gitub Actions will likely trigger a Porcelain error.

Sponsorship

Evcc believes in open source software. We're committed to provide best in class EV charging experience. Maintaining evcc consumes time and effort. With the vast amount of different devices to support, we depend on community and vendor support to keep EVCC alive.

While evcc is open source, we would also like to encourage vendors to provide open source hardware devices, public documentation and support open source projects like ours that provide additional value to otherwised closed hardware. Where this is not the case, EVCC requires "sponsor token" to finance ongoing development and support of evcc.

The personal sponsor token requires a Github Sponsorship and can be requested at cloud.evcc.io. A sponsor token is valid for one year and can be renewed any time with active sponsorship.

Background

Evcc is heavily inspired by OpenWB. However, in 2019, I found OpenWB's architecture slightly intimidating with everything basically global state and heavily relying on shell scripting. On the other side, especially the scripting aspect is one that contributes to OpenWB's flexibility.

Hence, for a simplified and stricter implementation of an EV charge controller, the design goals for evcc were:

• typed language with ability for systematic testing - achieved by using Go
• structured configuration - supports YAML-based config file
• avoidance of feature bloat, simple and clean UI - utilizes Vue.js and Bootstrap
• containerized operation beyond Raspberry Pi - provide multi-arch Docker Image