X-Git-Url: https://git.piment-noir.org/?a=blobdiff_plain;f=README.md;h=d8f73dddf2ec51a5d14c626bcb907507525fc455;hb=6f0ec20eb58d0344c807ed297f9080191270697e;hp=67fadb38d13e51fbf468d35717f082db72e8a338;hpb=ef16e252673a8704c0fc67d9e3588b07706b735a;p=e-mobility-charging-stations-simulator.git diff --git a/README.md b/README.md index 67fadb38..d8f73ddd 100644 --- a/README.md +++ b/README.md @@ -4,10 +4,6 @@ Simple [node.js](https://nodejs.org/) program to simulate a set of charging stations based on the OCPP-J 1.6 protocol. -## Start - -To start the program, run: `npm start`. - ## Configuration syntax All configuration files are in the JSON standard format. @@ -27,14 +23,16 @@ Key | Value(s) | Default Value | Value type | Description supervisionURLs | | [] | string[] | array of connection URIs to OCPP-J servers distributeStationsToTenantsEqually | true/false | true | boolean | distribute charging stations uniformly to the OCPP-J servers statisticsDisplayInterval | | 60 | integer | seconds between charging stations statistics output in the logs -workerProcess | workerSet/staticPool/dynamicPool | workerSet | string | worker threads process type +workerProcess | workerSet/staticPool/dynamicPool | workerSet | string | worker threads process type +workerStartDelay | | 500 | integer | milliseconds to wait at charging station worker threads startup workerPoolMinSize | | 4 | integer | worker threads pool minimum number of threads workerPoolMaxSize | | 16 | integer | worker threads pool maximum number of threads +workerPoolStrategy | ROUND_ROBIN/LESS_RECENTLY_USED/... | [poolifier](https://github.com/pioardi/poolifier) default: ROUND_ROBBIN | string | worker threads pool [poolifier](https://github.com/pioardi/poolifier) worker choice strategy chargingStationsPerWorker | | 1 | integer | number of charging stations per worker threads for the `workerSet` process type logConsole | true/false | false | boolean | output logs on the console logFormat | | simple | string | winston log format logRotate | true/false | true | boolean | enable daily log files rotation -logMaxFiles | | 7 | integer | maximum number of files to keep +logMaxFiles | | 7 | integer | maximum number of log files to keep logLevel | emerg/alert/crit/error/warning/notice/info/debug | info | string | winston logging level logFile | | combined.log | string | log file relative path logErrorFile | | error.log | string | error log file relative path @@ -55,9 +53,156 @@ chargePointModel | | '' | string | charging stations model chargePointVendor | | '' | string | charging stations vendor chargeBoxSerialNumberPrefix | | '' | string | charging stations serial number prefix firmwareVersion | | '' | string | charging stations firmware version -power | | | number\|number[] | charging stations maximum power value(s) -powerSharedByConnectors | true/false | false | boolean | charging stations power shared by connectors +power | | | integer\|integer[] | charging stations maximum power value(s) +powerSharedByConnectors | true/false | false | boolean | charging stations power shared by its connectors powerUnit | W/kW | W | string | charging stations power unit +currentOutType | AC/DC | AC | string | charging stations current out type +numberOfPhases | 0/1/3 | AC:3/DC:0 | integer | charging stations number of phase(s) +numberOfConnectors | | | integer\|integer[] | charging stations number of connector(s) +useConnectorId0 | true/false | true | boolean | use connector id 0 definition from the template +randomConnectors | true/false | false | boolean | randomize runtime connector id affectation from the connector id definition in template +resetTime | | 60 | integer | seconds to wait before the charging stations come back at reset +connectionTimeout | | 30 | integer | connection timeout to the OCPP-J server +autoReconnectMaxRetries | | -1 (unlimited) | integer | connection retries to the OCPP-J server +reconnectExponentialDelay | true/false | false | boolean | connection delay retry to the OCPP-J server +registrationMaxRetries | | -1 (unlimited) | integer | charging stations boot notification retries +enableStatistics | true/false | true | boolean | enable charging stations statistics +voltageOut | | AC:230/DC:400 | integer | charging stations voltage out +Configuration | | | ChargingStationConfiguration | charging stations OCPP configuration parameters +AutomaticTransactionGenerator | | | AutomaticTransactionGenerator | charging stations ATG configuration +Connectors | | | Connectors | charging stations connectors configuration + +#### Configuration section + +```json + "Configuration": { + "configurationKey": [ + ... + { + "key": "StandardKey", + "readonly": false, + "value": "StandardValue", + "visible": true, + "reboot": false + }, + ... + { + "key": "VendorKey", + "readonly": false, + "value": "VendorValue", + "visible": false, + "reboot": true + }, + ... + ] + } +``` + +#### AutomaticTransactionGenerator section + +```json + "AutomaticTransactionGenerator": { + "enable": false, + "minDuration": 60, + "maxDuration": 80, + "minDelayBetweenTwoTransactions": 15, + "maxDelayBetweenTwoTransactions": 30, + "probabilityOfStart": 1, + "stopAfterHours": 0.3, + "stopOnConnectionFailure": true, + "requireAuthorize": false + } +``` +#### Connectors section + +```json + "Connectors": { + "0": {}, + "1": { + "bootStatus": "Available", + "MeterValues": [ + ... + { + "unit": "A", + "measurand": "Current.Import" + }, + ... + { + "unit": "Wh" + }, + ... + ] + } + }, +``` + +## Start + +To start the program, run: `npm start`. + +## Docker + +In the [docker](./docker) folder: + +```bash +make +``` + +Or without the optional git submodules: + +```bash +make SUBMODULES_INIT=false +``` + +## OCPP-J commands supported + +### Version 1.6 + +### Core Profile + +- :heavy_check_mark: Authorize +- :heavy_check_mark: BootNotification +- :heavy_check_mark: ChangeAvailability +- :heavy_check_mark: ChangeConfiguration +- :heavy_check_mark: ClearCache +- :x: DataTransfer +- :heavy_check_mark: GetConfiguration +- :heavy_check_mark: Heartbeat +- :heavy_check_mark: MeterValues +- :heavy_check_mark: RemoteStartTransaction +- :heavy_check_mark: RemoteStopTransaction +- :heavy_check_mark: Reset +- :heavy_check_mark: StartTransaction +- :heavy_check_mark: StatusNotification +- :heavy_check_mark: StopTransaction +- :heavy_check_mark: UnlockConnector + +### Firmware Management Profile + +- :x: GetDiagnostics +- :x: DiagnosticsStatusNotification +- :x: FirmwareStatusNotification +- :x: UpdateFirmware + +### Local Auth List Management Profile + +- :x: GetLocalListVersion +- :x: SendLocalList + +### Reservation Profile + +- :x: CancelReservation +- :x: ReserveNow + +### Smart Charging Profile + +- :heavy_check_mark: ClearChargingProfile +- :heavy_check_mark: GetCompositeSchedule +- :heavy_check_mark: SetChargingProfile + +### Remote Trigger Profile + +- :x: TriggerMessage ## License