Skip to content

ChargePi is a charge point framework/project for Linux devices with OCPP support, API and a management UI

License

Notifications You must be signed in to change notification settings

ChargePi/ChargePi-go

Repository files navigation

⚡ ChargePi-go

ChargePi is an open-source, Linux based ⚡Charging Point🔌 "framework". It makes your EV charging station smart by abstracting and unifying the hardware components into a customizable, modular Charge Point with OCPP 1.6 and 2.0.1 support, an intuitive UI for easy management and an API for custom integrations. It is highly customizable, simple to make and supports both off-the-shelf and commercial hardware.

Concepts

A charge point is a device, consisting of multiple EVSEs, that is capable of delivering energy to an electric vehicle. Each EVSE has a connector, an EV Charge Controller and a Power Meter. Optionally, the charge point can have an RFID/NFC reader as an authentication mechanism, a display as a user interface, a status indicator and a communication module for connecting to the backend.

🔌 Charge point software specification

OCPP version Core functionalities Reservations LocalAuthList SmartCharging FirmwareUpdate Security Extension ISO 15118 (Plug and Charge)
1.6 JSON/WS ✔️ ✔️ ✔️ Planned ✔️ (partial) Planned Planned
2.0.1 JSON/WS Planned Planned Planned Planned Planned Certificate management included Included

📦 Features

  • OCPP 1.6 with planned 2.0.1 support - ChargePi supports OCPP 1.6, the most common protocol for EV charging stations. OCPP 2.0.1 support is planned.
  • Easily configurable - ChargePi is easy to configure and customize. It comes with default settings that require minimal configuration.
  • Easy replication - ChargePi is easy to replicate. It can be deployed on a Raspberry Pi or any other Linux-based device. Configurations can be easily exported from an existing device to other devices.
  • Mix and match hardware - ChargePi supports a variety of hardware components. You can mix and match the hardware components to create a charging station that suits your needs.
  • Customizable UI - ChargePi comes with a customizable UI that allows you to easily manage your charging station.
  • API for custom integrations - ChargePi comes with an API that allows you to integrate it with other systems.

🔌 Hardware support

All contributions for hardware support are welcome. If you want to add support for a new hardware component, please check out the hardware support guide. The more hardware is supported, the more customizable the ChargePi is.

RFID/NFC readers

Reader Is supported
PN532

Display

Display Is supported
HD44780

Power Meters

Power meter Is supported
CS5460A
ETI Planned

EVCC

EVCC Is supported
Relay
Phoenix Contact EVSEs Planned

LED indicators

Indicator Is supported
WS2812b
WS2811

⚡ Quickstart

  1. Choose the desired functionality and hardware.

  2. Wire your hardware according to the provided schematics (if the hardware is supported - otherwise, seek professional guidance or contribute to the project!).

    [!CAUTION] The hardware part of the project requires fairly good electrical knowledge. Make at your own risk or seek professional guidance. The project is not responsible for any damage caused by the hardware and will not take responsibility for any software misconfiguration or misbehavior.

  3. Configure the settings files according to the hardware and desired functionality:

  4. Run the client. ChargePi-go can be deployed/run in multiple ways:

    • standalone (host machine)
    • Docker 🐳 and docker-compose

Details on how to run the client on are described in the client startup guide.

🛠️ Configuration and settings

To configure the ChargePi, check out the configuration guide. Client comes with default settings which require minimal configuration.

Contributing

Contributions are welcome! Please check out the contributing guide for more information.

License

ChargePi-go is licensed under the MIT License.