OCPP-J 1.6 client for the ESP8266 and the ESP32 (more coming soon)
Reference usage: OpenEVSE
PlatformIO package: ArduinoOcpp
Website: www.arduino-ocpp.com
Full compatibility with the Arduino platform. Need a FreeRTOS version? Please contact me
You can build an OCPP Charge Point controller using the popular, Wi-Fi enabled microcontrollers ESP8266, ESP32 and comparable. This library allows your EVSE to communicate with an OCPP Central System and to participate in your Charging Network.
✔️ Works with SteVe and The Mobility House OCPP package
✔️ Passed compatibility tests with further commercial Central Systems
✔️ Integrated and tested in many charging stations
- handles the OCPP communication with the charging network
- implements the standard OCPP charging process
- provides an API for the integration of the hardware modules of your EVSE
- works with any TLS implementation and WebSocket library. E.g.
- Arduino networking stack: Links2004/arduinoWebSockets, or
- generic embedded systems: Mongoose Networking Library
For simple chargers, the necessary hardware and internet integration is usually far below 1000 LOCs.
Please take examples/ESP/main.cpp
as the starting point for your first project. It is a minimal example which shows how to establish an OCPP connection and how to start and stop charging sessions. This guide explains the concepts for a minimal integration.
-
To install the dependencies, see the list below for a manual installation or add
matth-x/ArduinoOcpp
to your project using the PIO library manager. -
In your project's
main
file, includeArduinoOcpp.h
and the Wi-Fi library. Initialize Wi-Fi and the Serial output. -
To connect to the OCPP Central System, call
OCPP_initialize(const char *host, uint16_t port, const char *url)
. For a secure connection with TLS, you need to configure the WebSocket in advance. Please takeexamples/ESP-TLS/main.cpp
as an example. -
In
setup()
, configure ArduinoOcpp with the hardware drivers. You can leave that part out for the first connection test. Please refer toArduinoOcpp.h
for a documentation about the supported EVSE peripherals. -
In
loop()
, addOCPP_loop()
.
Sending OCPP operations
There are a couple of OCPP operations you can initialize on your EVSE. For example, to send a Boot Notification
, use the function
void bootNotification(const char *chargePointModel, const char *chargePointVendor, OnReceiveConfListener onConf = nullptr, ...)`
In practice, it looks like this:
void setup() {
... //other code including the initialization of Wi-Fi and OCPP
bootNotification("My CP model name", "My company name", [] (JsonObject confMsg) {
//This callback is executed when the .conf() response from the central system arrives
Serial.print(F("BootNotification was answered. Central System clock: "));
Serial.println(confMsg["currentTime"].as<String>()); //"currentTime" is a field of the central system response
//evseIsBooted = true; <-- Example: Notify your hardware that the BootNotification.conf() has arrived
});
... //rest of setup() function; executed immediately as bootNotification() is non-blocking
}
The parameters chargePointModel
and chargePointVendor
are equivalent to the parameters in the Boot Notification
as defined by the OCPP specification. The last parameter OnReceiveConfListener onConf
is a callback function which the library executes when the central system has processed the operation and the ESP has received the .conf()
response. Here you can add your device-specific behavior, e.g. flash a confirmation LED or unlock the connectors. If you don't need it, the last parameter is optional.
Receiving OCPP operations
You can also add customized behavior to incoming OCPP messages. For example, to flash an LED on receipt of a Set Charging Profile
request, use the following function.
setOnSetChargingProfileRequest([] (JsonObject payload) {
//... will be executed every time this EVSE receives a new Charging Profile
});
Using the payload
object you can access the original payload from the CS.
To get started quickly with or without EVSE hardware, you can flash the sketch in examples/SECC
onto your ESP. That example mimics a full OCPP communications controller as it would look like in a real charging station. You can build a charger prototype based on that example or just view the internal state using the device monitor.
- bblanchon/ArduinoJSON (please upgrade to version
6.19.1
) - Links2004/arduinoWebSockets (please upgrade to version
2.3.6
)
In case you use PlatformIO, you can copy all dependencies from platformio.ini
into your own configuration file. Alternatively, you can install the full library with dependencies by adding matth-x/ArduinoOcpp
in the PIO library manager.
Operation name | supported | in progress | not supported |
---|---|---|---|
Core profile | |||
Authorize |
✔️ | ||
BootNotification |
✔️ | ||
ChangeAvailability |
✔️ | ||
ChangeConfiguration |
✔️ | ||
ClearCache |
✔️ | ||
DataTransfer |
✔️ | ||
GetConfiguration |
✔️ | ||
Heartbeat |
✔️ | ||
MeterValues |
✔️ | ||
RemoteStartTransaction |
✔️ | ||
RemoteStopTransaction |
✔️ | ||
Reset |
✔️ | ||
StartTransaction |
✔️ | ||
StatusNotification |
✔️ | ||
StopTransaction |
✔️ | ||
UnlockConnector |
✔️ | ||
Smart charging profile | |||
ClearChargingProfile |
✔️ | ||
GetCompositeSchedule |
✖️ | ||
SetChargingProfile |
✔️ | ||
Remote trigger profile | |||
TriggerMessage |
✔️ | ||
Firmware management | |||
GetDiagnostics |
✔️ | ||
DiagnosticsStatusNotification |
✔️ | ||
FirmwareStatusNotification |
✔️ | ||
UpdateFirmware |
✔️ |
- reach full compliance to OCPP 1.6 Smart Charging Profile
- integrate Authorization Cache
- get ready for OCPP 2.0.1 and ISO 15118
I hope this guide can help you to successfully integrate an OCPP controller into your EVSE. If something needs clarification or if you have a question, please send me a message.
✉️ : matthias A⊤ arduino-ocpp DО⊤ com
If you want professional assistance for your EVSE project, you can contact me as well. I'm looking forward to hearing about your ideas!