https://github.com/monta-app/ocpp-emulator
An open source OCPP Charge Point Emulator built using Kotlin Multiplatform and Jetbrains Compose
https://github.com/monta-app/ocpp-emulator
jetbrains-compose kotlin kotlin-multiplatform ocpp ocpp16j ocpp201
Last synced: 5 months ago
JSON representation
An open source OCPP Charge Point Emulator built using Kotlin Multiplatform and Jetbrains Compose
- Host: GitHub
- URL: https://github.com/monta-app/ocpp-emulator
- Owner: monta-app
- License: apache-2.0
- Created: 2024-04-20T09:20:47.000Z (about 2 years ago)
- Default Branch: main
- Last Pushed: 2026-01-12T14:24:52.000Z (5 months ago)
- Last Synced: 2026-01-12T19:43:01.212Z (5 months ago)
- Topics: jetbrains-compose, kotlin, kotlin-multiplatform, ocpp, ocpp16j, ocpp201
- Language: Kotlin
- Homepage: https://monta.com
- Size: 23.6 MB
- Stars: 155
- Watchers: 14
- Forks: 16
- Open Issues: 4
-
Metadata Files:
- Readme: README.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
- Codeowners: .github/CODEOWNERS
Awesome Lists containing this project
- awesome-ev-charging - monta-app/ocpp-emulator
README
# OCPP Charge Point Emulator
This project's goal is to allow users to emulate all of the features of OCPP (both 1.6 & 2.0.1) in order to allow
easier testing and speed up local development, here is an overview of what has been implemented in the project so
far
### OCPP 1.6
- Core (Done)
- Firmware Management (Done)
- Local Auth List Management (Done)
- Reservation (Not Done)
- Smart Charging (Semi Done)
- Remote Trigger (Done)
### OCPP 2.0.1
- Currently under development, the OCPP 2.0.1 version is not yet fully implemented, but we're working on it.
### How to run
If you're using Intellij IDEA, you can just run one of the two configurations that are saved in the `.run` folder
- `Run V16` for OCPP 1.6
- `Run V201` for OCPP 2.0.1
If you're just using the terminal, you can run the following command:
**OCPP 1.6**
```shell
./gradlew run v16:run
```
**OCPP 2.0.1**
```shell
./gradlew run v201:run
```
## What's up with the 🤓?
Clicking the icon gives access to "message interception". The primary purpose is to have a high degree of control over which messages
are sent and received by the charge point. That way it is possible to replicate potentially buggy behavior or custom implementations in
a one-off manner without needing to change the actual programming of the charge point. For "normal operation" of the charge point the
standard interface should be sufficient.
Also note that the message interception functions are not hooked up to the internal machinery of the charge point. For example, sending
a `StopTransaction` message will not actually change the state of an ongoing charge to be stopped. That means using these functions
also makes it very easy to put the charge point into a state that does not match up with what the CSMS is expecting, which can quickly
lead to unexpected behavior.
## Executables
If you only care about running the application you can find the latest release on
the [releases page](https://github.com/monta-app/ocpp-emulator/releases) we are currently building executables for
Windows, Linux and MacOS.
## MacOS
If you're installing the `.dmg` please make sure you run `xattr -d com.apple.quarantine /Applications/OcppEmulator.
app` before trying to run the application :) otherwise you'll see `Apple could not verify “OcppEmulator” is free of malware that may harm your Mac or compromise your privacy.`
## How to contribute
We welcome contributions from everyone who is willing to improve this project. Whether you're fixing bugs, adding new
features, improving documentation, or suggesting new ideas, your help is greatly appreciated! Just make sure you
follow these simple guidelines before opening up a PR:
- Follow the [Code of Conduct](CODE_OF_CONDUCT.md): Always adhere to the Code of Conduct and be respectful of others
in the community.
- Test Your Changes: Ensure your code is tested and as bug-free as possible.
- Update Documentation: If you're adding new features or making changes that require it, update the documentation
accordingly.