MaEVe is an EV charge station management system (CSMS). It began life as a simple proof of concept for implementing ISO-15118-2 Plug and Charge (PnC) functionality and remains a work in progress. It is hoped that over time it will become more complete, but already provides a useful basis for experimentation.
The system currently integrates with Hubject for PnC functionality.
MaEVe is implemented in Go 1.20. Learn more about MaEVe and its existing components through this High-level design document.
MaEVe runs in a set of Docker containers. This means you need to have docker
, docker-compose
and a docker daemon (e.g. docker desktop, colima
or rancher
) installed and running.
Scripts that fetch various tokens use jq
. Make sure you have it installed.
To get the system up and running:
(cd config/certificates && make)
Charge stations can connect to the CSMS using:
ws://localhost/ws/<cs-id>
wss://localhost/ws/<cs-id>
If the charge station is also running in a Docker container then the charge
station docker container can connect to the maeve-csms
network and the
charge station can connect to the CSMS using:
ws://gateway:9310/ws/<cs-id>
wss://gateway:9311/ws/<cs-id>
Charge stations can use either OCPP 1.6j or OCPP 2.0.1.
For TLS, the charge station should use a certificate provisioned using the Hubject CPO EST service.
A charge station must first be registered with the CSMS before it can be used. This can be done using the manager API. e.g. for TLS with client certificate, use:
$ curl http://localhost:9410/api/v0/cs/<cs-id> -H 'content-type: application/json' -d '{"securityProfile":2}'
Tokens, which identify a payment method for a non-contract charge, must also be registered with the CSMS before they can be used. This can also be done using the manager API. e.g.:
$ curl http://localhost:9410/api/v0/token -H 'content-type: application/json' -d '{
"countryCode": "GB",
"partyId": "TWK",
"type": "RFID",
"uid": "DEADBEEF",
"contractId": "GBTWK012345678V",
"issuer": "Thoughtworks",
"valid": true,
"cacheMode": "ALWAYS"
}'
Docker compose doesn't always rebuild the docker images which can cause all kinds of errors. If in doubt, force a rebuild by docker-compose build
before launching containers.
java.io.IOException: keystore password was incorrect
This error results from incompatibility between java version and openssl; try upgrading your java version.
The gateway is configured through command-line flags. The available flags can be viewed using the -h
flag.
The manager is configured through a TOML configuration file. An example configuration file can be found in ./config/manager/config.toml. Details of the available configuration options can be found in ./manager/config/README.md.
Learn more about how to contribute on this project through Contributing
MaEVe is Apache licensed.