[e-mobility-charging-stations-simulator.git] / tests / ocpp-server / README.md

# OCPP2 Mock Server

This project includes an Open Charge Point Protocol (OCPP) version 2.0.1 mock server implemented in Python.

## Prerequisites

This project requires Python 3.7+ and [poetry](https://python-poetry.org/) to install the required packages:

```shell
poetry install
```

## Running the Server

To start the server, run the `server.py` script:

```shell
poetry run task server
```

The server will start listening for connections on port 9000.

## Running the server with OCPP command sending

You can also specify a command and a period duration with the --command and --period options respectively when running the server. The server will then send your chosen command to the connected client(s) every period seconds.

### GetBaseReport Command

To run the server and send a GetBaseReport command every 5 seconds, use:

```shell
poetry run task server --command GetBaseReport --period 5
```

### ClearCache Command

To run the server and send a ClearCache command every 5 seconds, use:

```shell
poetry run task server --command ClearCache --period 5
```

Please be mindful that these commands were examples according to the provided scenario, the available commands and their syntax might vary depending on the ocpp version and the implemented functionalities on your client.

## Overview of the Server Scripts

### Server.py

The server script waits for connections from clients. When a client connects, the server creates a new instance of the `ChargePoint` class. This class includes methods for handling various OCPP messages, most of which return a dummy response.

The server script uses the `websockets` and `ocpp` libraries to facilitate the implementation.

## Development

### Code formatting

```shell
poetry run task format
```

### Code linting

```shell
poetry run task lint
```

## Note

Primarily, this software is intended for testing applications. The server script don't adhere to the full OCPP specifications and it is advised not to use them in a production environment without additional development.

For reference:
https://github.com/mobilityhouse/ocpp
Commit	Line	Data
fa16d389 S	1	# OCPP2 Mock Server
fa16d389 S	2
dd4588bb	3	This project includes an Open Charge Point Protocol (OCPP) version 2.0.1 mock server implemented in Python.
fa16d389 S	4
	5	## Prerequisites
	6
c11be92a	7	This project requires Python 3.7+ and [poetry](https://python-poetry.org/) to install the required packages:
f93800e5	8
ac96356c	9	```shell
c11be92a	10	poetry install
fa16d389 S	11	```
	12
	13	## Running the Server
	14
	15	To start the server, run the `server.py` script:
	16
ac96356c	17	```shell
3a89ffcb	18	poetry run task server
fa16d389	19	```
f93800e5	20
7c945b4a S	21	The server will start listening for connections on port 9000.
7c945b4a S	22
e3861e41	23	## Running the server with OCPP command sending
7c945b4a	24
e3861e41	25	You can also specify a command and a period duration with the --command and --period options respectively when running the server. The server will then send your chosen command to the connected client(s) every period seconds.
7c945b4a S	26
	27	### GetBaseReport Command
	28
	29	To run the server and send a GetBaseReport command every 5 seconds, use:
fa16d389	30
f937c172	31	```shell
299eb3fa	32	poetry run task server --command GetBaseReport --period 5
f937c172	33	```
f93800e5	34
7c945b4a S	35	### ClearCache Command
	36
	37	To run the server and send a ClearCache command every 5 seconds, use:
	38
	39	```shell
299eb3fa	40	poetry run task server --command ClearCache --period 5
7c945b4a S	41	```
7c945b4a S	42
e3861e41	43	Please be mindful that these commands were examples according to the provided scenario, the available commands and their syntax might vary depending on the ocpp version and the implemented functionalities on your client.
fa16d389 S	44
	45	## Overview of the Server Scripts
	46
	47	### Server.py
	48
4c69efea	49	The server script waits for connections from clients. When a client connects, the server creates a new instance of the `ChargePoint` class. This class includes methods for handling various OCPP messages, most of which return a dummy response.
fa16d389	50
4c69efea	51	The server script uses the `websockets` and `ocpp` libraries to facilitate the implementation.
fa16d389	52
ac96356c JB	53	## Development
	54
	55	### Code formatting
	56
	57	```shell
	58	poetry run task format
	59	```
	60
	61	### Code linting
	62
	63	```shell
	64	poetry run task lint
	65	```
	66
fa16d389 S	67	## Note
fa16d389 S	68
c11be92a	69	Primarily, this software is intended for testing applications. The server script don't adhere to the full OCPP specifications and it is advised not to use them in a production environment without additional development.
fa16d389 S	70
	71	For reference:
	72	https://github.com/mobilityhouse/ocpp