Giter Club home page Giter Club logo

microocpp's Introduction

Icon   MicroOcpp

Build Status Unit tests codecov

OCPP 1.6 client for microcontrollers. Portable C/C++. Compatible with Espressif, Arduino, NXP, STM, Linux and more.

✔️ Works with 15+ commercial Central Systems

✔️ Eligible for public chargers (Eichrecht-compliant)

✔️ Supports all OCPP 1.6 feature profiles and OCPP 2.0.1 preview

Reference usage: OpenEVSE | Technical introduction: Docs | Website: www.micro-ocpp.com

Tester / Demo App

Main repository: MicroOcppSimulator

The Simulator is a demo & development tool for MicroOcpp which allows to quickly assess the compatibility with different OCPP backends. It simulates a full charging station, adds a GUI and a mocked hardware binding to MicroOcpp and runs in the browser (using WebAssembly): Try it

Screenshot

Usage

OCPP server setup: Navigate to "Control Center". In the WebSocket options, add the OCPP backend URL, charge box ID and authorization key if existent. Press "Update WebSocket" to save. The Simulator should connect to the OCPP server. To check the connection status, it could be helpful to open the developer tools of the browser.

If you don't have an OCPP server at hand, leave the charge box ID blank and enter the following backend address: wss://echo.websocket.events/ (this server is sponsored by Lob.com)

RFID authentication: Go to "Control Center" > "Connectors" > "Transaction" and update the idTag with the desired value.

Benchmarks

Full report: MicroOcpp benchmark (esp-idf)

The following measurements were taken on the ESP32 @ 160MHz and represent the optimistic best case scenario for a charger with two physical connectors (i.e. compiled with -Os, disabled debug output and logs).

Description Value
Flash size (minimal) 121,170 B
Heap occupation (idle) 12,308 B
Heap occupation (peak) 21,916 B
Initailization 21 ms
loop() call (idle) 0.05 ms
Large message sent 5 ms

In practical setups, the execution time is largely determined by IO delays and the heap occupation is significantly influenced by the configuration with reservation, local authorization and charging profile lists.

Developers guide

PlatformIO package: MicroOcpp

MicroOcpp is an implementation of the OCPP communication behavior. It automatically initiates the corresponding OCPP operations once the hardware status changes or the RFID input is updated with a new value. Conversely it processes new data from the server, stores it locally and updates the hardware controls when applicable.

Please take examples/ESP/main.cpp as the starting point for the first project. It is a minimal example which shows how to establish an OCPP connection and how to start and stop charging sessions. The API documentation can be found in MicroOcpp.h. Also check out the Docs.

Dependencies

Mandatory:

If compiled with the Arduino integration:

If using the built-in certificate store (to enable, set build flag MO_ENABLE_MBEDTLS=1):

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/[email protected] in the PIO library manager.

OCPP 2.0.1 and ISO 15118

The following OCPP 2.0.1 use cases are implemented:

UC Description Note
M03 - M05 Certificate management Enable Mbed-TLS to use the built-in certificate store
B05 - B07 Variables
B01 - B04
B11 - B12
Provisioning Ported from OCPP 1.6
E01 - E12 Transactions
F01 - F02 Remote Start/Stop Tx
- Protocol negotiation The charger can select the OCPP version at runtime

The OCPP 2.0.1 features are in an alpha development stage (no persistency yet). By default, they are disabled and excluded from the build, so they have no impact on the firmware size. To enable, set the build flag MO_ENABLE_V201=1 and initialize the library with the ProtocolVersion parameter 2.0.1 (see this example in the Simulator).

An integration of the library for OCPP 1.6 will also be functional with the 2.0.1 upgrade. It works with the same API in MicroOcpp.h.

ISO 15118 defines some use cases which include a message exchange between the charger and server. This library facilitates the integration of ISO 15118 by handling its OCPP-side communication.

Contact

If you have further questions, feel free to reach out!

✉️ : matthias [A⊤] micro-ocpp [DО⊤] com

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.