SAP / e-mobility-charging-stations-simulator

e-Mobility charging stations simulator Simple node.js software to simulate and scale a set of charging stations based on the OCPP-J protocol as part of SAP e-Mobility solution. Table of contents • Installation • Prerequisites • Windows • macOS • GNU/Linux • Development prerequisites (optional) • Unix • Windows • Branching model • Dependencies • Initial configuration • Start simulator • Start Web UI • Configuration files syntax • Charging stations simulator configuration • Charging station template configuration • Charging station configuration • Docker • OCPP-J commands supported • Version 1.6 • Version 2.0.x • OCPP-J standard parameters supported • Version 1.6 • Version 2.0.x • UI Protocol • WebSocket Protocol • HTTP Protocol • Support, Feedback, Contributing • Code of Conduct • Licensing Installation Prerequisites Install the node.js current LTS or superior version runtime environment: Windows • Chocolatey: macOS • Homebrew: GNU/Linux • NodeSource node.js binary distributions for all supported versions. Development prerequisites (optional) Install volta for managing automatically the node.js runtime and package manager version: Unix Windows Setup volta with pnpm package manager support: https://docs.volta.sh/advanced/pnpm Branching model The branch is the default development branch. The branches are the maintenance branches for the corresponding major version . The branches are the maintenance branches for the corresponding major and minor version . Dependencies Enable corepack, if volta is not installed and configured, and install latest pnpm version: In the repository root, run the following command: Initial configuration Copy the configuration template file src/assets/config-template.json to src/assets/config.json. Copy the RFID tags template file src/assets/idtags-template.json to src/assets/idtags.json. Tweak them to your needs by following the section configuration files syntax: OCPP server supervision URL(s), charging station templates, etc. Start simulator Start Web UI See Web UI README.md for more information. Configuration files syntax All configuration files are using the JSON standard syntax. **Configuration files locations**: • charging stations simulator configuration: src/assets/config.json; • charging station configuration templates: src/assets/station-templates; • charging station configurations: dist/assets/configurations; • charging station RFID tags lists: src/assets. The charging stations simulator's configuration parameters must be within the file. A charging station simulator configuration template file is available at src/assets/config-template.json. All charging station configuration templates are in the directory src/assets/station-templates. A list of RFID tags must be defined for the automatic transaction generator in a file with the default location and name: . A template file is available at src/assets/idtags-template.json. **Configuration files hierarchy and priority**: • charging station configuration: dist/assets/configurations; • charging station configuration template: src/assets/station-templates; • charging stations simulator configuration: src/assets/config.json. The charging stations simulator has an automatic configuration files reload feature at change for: • charging stations simulator configuration; • charging station configuration templates; • charging station authorization RFID tags lists. But the modifications to test have to be done to the files in the build target directory dist/assets. Once the modifications are done, they have to be reported to the matching files in the build source directory src/assets to ensure they will be taken into account at next build. Charging stations simulator configuration **src/assets/config.json**: | Key | Value(s) | Default Value | Value type | Description | | -------------------------- | -------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | supervisionUrls | | [] | string \| string[] | string or strings array containing global connection URIs to OCPP-J servers | | supervisionUrlDistribution | round-robin/random/charging-station-affinity | charging-station-affinity | string | supervision urls distribution policy to simulated charging stations | | log | | { "enabled": true, "file": "logs/combined.log", "errorFile": "logs/error.log", "statisticsInterval": 60, "level": "info", "console": false, "format": "simple", "rotate": true } | { enabled?: boolean; file?: string; errorFile?: string; statisticsInterval?: number; level?: string; console?: boolean; format?: string; rotate?: boolean; maxFiles?: string \| number; maxSize?: st…