[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 --no-root
```

## Running the Server

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

```shell
poetry run task server
```

Or

```shell
poetry run python server.py
```

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
	1	# OCPP2 Mock Server
	2
	3	This project includes an Open Charge Point Protocol (OCPP) version 2.0.1 mock server implemented in Python.
	4
	5	## Prerequisites
	6
	7	This project requires Python 3.7+ and [poetry](https://python-poetry.org/) to install the required packages:
	8
	9	```shell
	10	poetry install --no-root
	11	```
	12
	13	## Running the Server
	14
	15	To start the server, run the `server.py` script:
	16
	17	```shell
	18	poetry run task server
	19	```
	20
	21	Or
	22
	23	```shell
	24	poetry run python server.py
	25	```
	26
	27	The server will start listening for connections on port 9000.
	28
	29	## Running the server with OCPP command sending
	30
	31	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.
	32
	33	### GetBaseReport Command
	34
	35	To run the server and send a GetBaseReport command every 5 seconds, use:
	36
	37	```shell
	38	poetry run task server --command GetBaseReport --period 5
	39	```
	40
	41	### ClearCache Command
	42
	43	To run the server and send a ClearCache command every 5 seconds, use:
	44
	45	```shell
	46	poetry run task server --command ClearCache --period 5
	47	```
	48
	49	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.
	50
	51	## Overview of the Server Scripts
	52
	53	### Server.py
	54
	55	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.
	56
	57	The server script uses the `websockets` and `ocpp` libraries to facilitate the implementation.
	58
	59	## Development
	60
	61	### Code formatting
	62
	63	```shell
	64	poetry run task format
	65	```
	66
	67	### Code linting
	68
	69	```shell
	70	poetry run task lint
	71	```
	72
	73	## Note
	74
	75	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.
	76
	77	For reference:
	78	https://github.com/mobilityhouse/ocpp