feat: untangle add charging station op from start charging station op

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

diff --git a/README.md b/README.md
index e171b3e8bf5ac4fa95a532e7906f85ebaebeb92a..89ea7b6c10d3498dcd0d26bae966c40d6f6b2e5a 100644 (file)
--- a/README.md
+++ b/README.md
@@ -131,11 +131,12 @@ But the modifications to test have to be done to the files in the build target d
 | supervisionUrls                                      |               | []                                                                                                                                 | string \| string[]                                                                                                                                                            | string or strings array containing connection URIs to OCPP-J servers                                                                                                                                                                       |
 | supervisionUser                                      |               | undefined                                                                                                                          | string                                                                                                                                                                        | basic HTTP authentication user to OCPP-J server                                                                                                                                                                                            |
 | supervisionPassword                                  |               | undefined                                                                                                                          | string                                                                                                                                                                        | basic HTTP authentication password to OCPP-J server                                                                                                                                                                                        |
-| supervisionUrlOcppConfiguration                      | true/false    | false                                                                                                                              | boolean                                                                                                                                                                       | allow supervision URL configuration via a vendor OCPP parameter key                                                                                                                                                                        |
+| supervisionUrlOcppConfiguration                      | true/false    | false                                                                                                                              | boolean                                                                                                                                                                       | enable supervision URL configuration via a vendor OCPP parameter key                                                                                                                                                                       |
 | supervisionUrlOcppKey                                |               | 'ConnectionUrl'                                                                                                                    | string                                                                                                                                                                        | the vendor string that will be used as a vendor OCPP parameter key to set the supervision URL                                                                                                                                              |
+| autoStart                                            | true/false    | true                                                                                                                               | boolean                                                                                                                                                                       | enable automatic start of added charging station from template                                                                                                                                                                             |
 | ocppVersion                                          | 1.6/2.0/2.0.1 | 1.6                                                                                                                                | string                                                                                                                                                                        | OCPP version                                                                                                                                                                                                                               |
 | ocppProtocol                                         | json          | json                                                                                                                               | string                                                                                                                                                                        | OCPP protocol                                                                                                                                                                                                                              |
-| ocppStrictCompliance                                 | true/false    | true                                                                                                                               | boolean                                                                                                                                                                       | strict adherence to the OCPP version and protocol specifications with OCPP commands PDU validation against [OCA](https://www.openchargealliance.org/) JSON schemas                                                                         |
+| ocppStrictCompliance                                 | true/false    | true                                                                                                                               | boolean                                                                                                                                                                       | enable strict adherence to the OCPP version and protocol specifications with OCPP commands PDU validation against [OCA](https://www.openchargealliance.org/) JSON schemas                                                                  |
 | ocppPersistentConfiguration                          | true/false    | true                                                                                                                               | boolean                                                                                                                                                                       | enable persistent OCPP parameters storage by charging stations 'hashId'. The persistency is ensured by the charging stations configuration files in [dist/assets/configurations](dist/assets/configurations)                               |
 | stationInfoPersistentConfiguration                   | true/false    | true                                                                                                                               | boolean                                                                                                                                                                       | enable persistent station information and specifications storage by charging stations 'hashId'. The persistency is ensured by the charging stations configuration files in [dist/assets/configurations](dist/assets/configurations)        |
 | automaticTransactionGeneratorPersistentConfiguration | true/false    | true                                                                                                                               | boolean                                                                                                                                                                       | enable persistent automatic transaction generator configuration storage by charging stations 'hashId'. The persistency is ensured by the charging stations configuration files in [dist/assets/configurations](dist/assets/configurations) |
@@ -498,11 +499,14 @@ All kind of OCPP parameters are supported in charging station configuration or c
 
 ## UI protocol
 
-Protocol to control the simulator via a Websocket or HTTP server.
+Protocol to control the simulator via a Websocket or HTTP server:
 
-### HTTP Protocol
-
-To learn how to use the HTTP protocol to pilot the simulator, an [Insomnia](https://insomnia.rest/) HTTP requests collection is available in [src/assets/ui-protocol](./src/assets/ui-protocol) directory.
+```mermaid
+sequenceDiagram
+Client->>UI Server: request
+UI Server->>Client: response
+Note over UI Server,Client: Transport protocol: HTTP, Websocket
+```
 
 ### Websocket Protocol
 
@@ -519,7 +523,7 @@ SRPC protocol over Websocket. PDU stands for 'Protocol Data Unit'.
   `uuid`: String uniquely linking the response to the request  
   `PDU`: Response parameters to requested procedure
 
-An [Insomnia](https://insomnia.rest/) WebSocket requests collection is available in [src/assets/ui-protocol](./src/assets/ui-protocol) directory.
+To learn how to use the Websocket protocol to pilot the simulator, an [Insomnia](https://insomnia.rest/) Websocket requests collection is available in [src/assets/ui-protocol](./src/assets/ui-protocol) directory.
 
 #### Version 0.0.1
 
@@ -535,7 +539,7 @@ Set the Websocket header _Sec-Websocket-Protocol_ to `ui0.0.1`.
 
 - Response:  
   `PDU`: {  
-  `status`: 'success' | 'failure'  
+   `status`: 'success' | 'failure'  
   }
 
 ###### Stop Simulator
@@ -546,7 +550,50 @@ Set the Websocket header _Sec-Websocket-Protocol_ to `ui0.0.1`.
 
 - Response:  
   `PDU`: {  
-  `status`: 'success' | 'failure'  
+   `status`: 'success' | 'failure'  
+  }
+
+###### List Charging Station Templates
+
+- Request:  
+  `ProcedureName`: 'listTemplates'  
+  `PDU`: {}
+
+- Response:  
+  `PDU`: {  
+   `status`: 'success' | 'failure',  
+   `templates`: string[]  
+  }
+
+###### Add Charging Stations
+
+- Request:  
+  `ProcedureName`: 'addChargingStations'  
+  `PDU`: {  
+   `template`: string,  
+   `numberOfStations`: number  
+  }
+
+- Response:  
+  `PDU`: {  
+   `status`: 'success' | 'failure'  
+  }
+
+###### Set Charging Station Supervision Url
+
+- Request:  
+  `ProcedureName`: 'setSupervisionUrl'  
+  `PDU`: {  
+   `hashIds`: charging station unique identifier strings array (optional, default: all charging stations),  
+   `uri`: string  
+  }
+
+- Response:  
+  `PDU`: {  
+   `status`: 'success' | 'failure',  
+   `hashIdsSucceeded`: charging station unique identifier strings array,  
+   `hashIdsFailed`: charging station unique identifier strings array (optional),  
+   `responsesFailed`: failed responses payload array (optional)  
   }
 
 ###### List Charging Stations
@@ -557,8 +604,8 @@ Set the Websocket header _Sec-Websocket-Protocol_ to `ui0.0.1`.
 
 - Response:  
   `PDU`: {  
-  `status`: 'success' | 'failure',  
-  `chargingStations`: ChargingStationData[]  
+   `status`: 'success' | 'failure',  
+   `chargingStations`: ChargingStationData[]  
   }
 
 ###### Start Charging Station
@@ -566,15 +613,15 @@ Set the Websocket header _Sec-Websocket-Protocol_ to `ui0.0.1`.
 - Request:  
   `ProcedureName`: 'startChargingStation'  
   `PDU`: {  
-  `hashIds`: charging station unique identifier strings array (optional, default: all charging stations)  
+   `hashIds`: charging station unique identifier strings array (optional, default: all charging stations)  
   }
 
 - Response:  
   `PDU`: {  
-  `status`: 'success' | 'failure',  
-  `hashIdsSucceeded`: charging station unique identifier strings array,  
-  `hashIdsFailed`: charging station unique identifier strings array (optional)  
-  `responsesFailed`: failed responses payload array (optional)  
+   `status`: 'success' | 'failure',  
+   `hashIdsSucceeded`: charging station unique identifier strings array,  
+   `hashIdsFailed`: charging station unique identifier strings array (optional),  
+   `responsesFailed`: failed responses payload array (optional)  
   }
 
 ###### Stop Charging Station
@@ -582,15 +629,15 @@ Set the Websocket header _Sec-Websocket-Protocol_ to `ui0.0.1`.
 - Request:  
   `ProcedureName`: 'stopChargingStation'  
   `PDU`: {  
-  `hashIds`: charging station unique identifier strings array (optional, default: all charging stations)  
+   `hashIds`: charging station unique identifier strings array (optional, default: all charging stations)  
   }
 
 - Response:  
   `PDU`: {  
-  `status`: 'success' | 'failure',  
-  `hashIdsSucceeded`: charging station unique identifier strings array,  
-  `hashIdsFailed`: charging station unique identifier strings array (optional),  
-  `responsesFailed`: failed responses payload array (optional)  
+   `status`: 'success' | 'failure',  
+   `hashIdsSucceeded`: charging station unique identifier strings array,  
+   `hashIdsFailed`: charging station unique identifier strings array (optional),  
+   `responsesFailed`: failed responses payload array (optional)  
   }
 
 ###### Open Connection
@@ -598,15 +645,15 @@ Set the Websocket header _Sec-Websocket-Protocol_ to `ui0.0.1`.
 - Request:  
   `ProcedureName`: 'openConnection'  
   `PDU`: {  
-  `hashIds`: charging station unique identifier strings array (optional, default: all charging stations)  
+   `hashIds`: charging station unique identifier strings array (optional, default: all charging stations)  
   }
 
 - Response:  
   `PDU`: {  
-  `status`: 'success' | 'failure',  
-  `hashIdsSucceeded`: charging station unique identifier strings array,  
-  `hashIdsFailed`: charging station unique identifier strings array (optional),  
-  `responsesFailed`: failed responses payload array (optional)  
+   `status`: 'success' | 'failure',  
+   `hashIdsSucceeded`: charging station unique identifier strings array,  
+   `hashIdsFailed`: charging station unique identifier strings array (optional),  
+   `responsesFailed`: failed responses payload array (optional)  
   }
 
 ###### Close Connection
@@ -614,15 +661,15 @@ Set the Websocket header _Sec-Websocket-Protocol_ to `ui0.0.1`.
 - Request:  
   `ProcedureName`: 'closeConnection'  
   `PDU`: {  
-  `hashIds`: charging station unique identifier strings array (optional, default: all charging stations)  
+   `hashIds`: charging station unique identifier strings array (optional, default: all charging stations)  
   }
 
 - Response:  
   `PDU`: {  
-  `status`: 'success' | 'failure',  
-  `hashIdsSucceeded`: charging station unique identifier strings array,  
-  `hashIdsFailed`: charging station unique identifier strings array (optional),  
-  `responsesFailed`: failed responses payload array (optional)  
+   `status`: 'success' | 'failure',  
+   `hashIdsSucceeded`: charging station unique identifier strings array,  
+   `hashIdsFailed`: charging station unique identifier strings array (optional),  
+   `responsesFailed`: failed responses payload array (optional)  
   }
 
 ###### Start Automatic Transaction Generator
@@ -630,16 +677,16 @@ Set the Websocket header _Sec-Websocket-Protocol_ to `ui0.0.1`.
 - Request:  
   `ProcedureName`: 'startAutomaticTransactionGenerator'  
   `PDU`: {  
-  `hashIds`: charging station unique identifier strings array (optional, default: all charging stations),  
-  `connectorIds`: connector id integer array (optional, default: all connectors)  
+   `hashIds`: charging station unique identifier strings array (optional, default: all charging stations),  
+   `connectorIds`: connector id integer array (optional, default: all connectors)  
   }
 
 - Response:  
   `PDU`: {  
-  `status`: 'success' | 'failure',  
-  `hashIdsSucceeded`: charging station unique identifier strings array,  
-  `hashIdsFailed`: charging station unique identifier strings array (optional),  
-  `responsesFailed`: failed responses payload array (optional)  
+   `status`: 'success' | 'failure',  
+   `hashIdsSucceeded`: charging station unique identifier strings array,  
+   `hashIdsFailed`: charging station unique identifier strings array (optional),  
+   `responsesFailed`: failed responses payload array (optional)  
   }
 
 ###### Stop Automatic Transaction Generator
@@ -647,16 +694,16 @@ Set the Websocket header _Sec-Websocket-Protocol_ to `ui0.0.1`.
 - Request:  
   `ProcedureName`: 'stopAutomaticTransactionGenerator'  
   `PDU`: {  
-  `hashIds`: charging station unique identifier strings array (optional, default: all charging stations),  
-  `connectorIds`: connector id integer array (optional, default: all connectors)  
+   `hashIds`: charging station unique identifier strings array (optional, default: all charging stations),  
+   `connectorIds`: connector id integer array (optional, default: all connectors)  
   }
 
 - Response:  
   `PDU`: {  
-  `status`: 'success' | 'failure',  
-  `hashIdsSucceeded`: charging station unique identifier strings array,  
-  `hashIdsFailed`: charging station unique identifier strings array (optional),  
-  `responsesFailed`: failed responses payload array (optional)  
+   `status`: 'success' | 'failure',  
+   `hashIdsSucceeded`: charging station unique identifier strings array,  
+   `hashIdsFailed`: charging station unique identifier strings array (optional),  
+   `responsesFailed`: failed responses payload array (optional)  
   }
 
 ###### OCPP commands trigger
@@ -666,15 +713,15 @@ Set the Websocket header _Sec-Websocket-Protocol_ to `ui0.0.1`.
   `PDU`: {  
    `hashIds`: charging station unique identifier strings array (optional, default: all charging stations),  
    ...`commandPayload`  
-   } (the OCPP command payload with some optional fields added to target the simulated charging stations)
+  } (the OCPP command payload with some optional fields added to target the simulated charging stations)
 
 - Response:  
-   `PDU`: {  
+  `PDU`: {  
    `status`: 'success' | 'failure',  
    `hashIdsSucceeded`: charging station unique identifier strings array,  
    `hashIdsFailed`: charging station unique identifier strings array (optional),  
    `responsesFailed`: failed responses payload array (optional)  
-   }
+  }
 
 Examples:
 
@@ -683,17 +730,17 @@ Examples:
   - Request:  
     `ProcedureName`: 'startTransaction'  
     `PDU`: {  
-    `hashIds`: charging station unique identifier strings array (optional, default: all charging stations),  
-    `connectorId`: connector id integer,  
-    `idTag`: RFID tag string  
+     `hashIds`: charging station unique identifier strings array (optional, default: all charging stations),  
+     `connectorId`: connector id integer,  
+     `idTag`: RFID tag string  
     }
 
   - Response:  
     `PDU`: {  
-    `status`: 'success' | 'failure',  
-    `hashIdsSucceeded`: charging station unique identifier strings array,  
-    `hashIdsFailed`: charging station unique identifier strings array (optional),  
-    `responsesFailed`: failed responses payload array (optional)  
+     `status`: 'success' | 'failure',  
+     `hashIdsSucceeded`: charging station unique identifier strings array,  
+     `hashIdsFailed`: charging station unique identifier strings array (optional),  
+     `responsesFailed`: failed responses payload array (optional)  
     }
 
 - **Stop Transaction**
@@ -701,16 +748,16 @@ Examples:
   - Request:  
     `ProcedureName`: 'stopTransaction'  
     `PDU`: {  
-    `hashIds`: charging station unique identifier strings array (optional, default: all charging stations),  
-    `transactionId`: transaction id integer  
+     `hashIds`: charging station unique identifier strings array (optional, default: all charging stations),  
+     `transactionId`: transaction id integer  
     }
 
   - Response:  
     `PDU`: {  
-    `status`: 'success' | 'failure',  
-    `hashIdsSucceeded`: charging station unique identifier strings array,  
-    `hashIdsFailed`: charging station unique identifier strings array (optional),  
-    `responsesFailed`: failed responses payload array (optional)  
+     `status`: 'success' | 'failure',  
+     `hashIdsSucceeded`: charging station unique identifier strings array,  
+     `hashIdsFailed`: charging station unique identifier strings array (optional),  
+     `responsesFailed`: failed responses payload array (optional)  
     }
 
 - **Status Notification**
@@ -718,18 +765,18 @@ Examples:
   - Request:  
     `ProcedureName`: 'statusNotification'  
     `PDU`: {  
-    `hashIds`: charging station unique identifier strings array (optional, default: all charging stations),  
-    `connectorId`: connector id integer,  
-    `errorCode`: connector error code,  
-    `status`: connector status  
+     `hashIds`: charging station unique identifier strings array (optional, default: all charging stations),  
+     `connectorId`: connector id integer,  
+     `errorCode`: connector error code,  
+     `status`: connector status  
     }
 
   - Response:  
     `PDU`: {  
-    `status`: 'success' | 'failure',  
-    `hashIdsSucceeded`: charging station unique identifier strings array,  
-    `hashIdsFailed`: charging station unique identifier strings array (optional),  
-    `responsesFailed`: failed responses payload array (optional)  
+     `status`: 'success' | 'failure',  
+     `hashIdsSucceeded`: charging station unique identifier strings array,  
+     `hashIdsFailed`: charging station unique identifier strings array (optional),  
+     `responsesFailed`: failed responses payload array (optional)  
     }
 
 - **Heartbeat**
@@ -737,17 +784,21 @@ Examples:
   - Request:  
     `ProcedureName`: 'heartbeat'  
     `PDU`: {  
-    `hashIds`: charging station unique identifier strings array (optional, default: all charging stations),  
+     `hashIds`: charging station unique identifier strings array (optional, default: all charging stations),  
     }
 
   - Response:  
     `PDU`: {  
-    `status`: 'success' | 'failure',  
-    `hashIdsSucceeded`: charging station unique identifier strings array,  
-    `hashIdsFailed`: charging station unique identifier strings array (optional),  
-    `responsesFailed`: failed responses payload array (optional)  
+     `status`: 'success' | 'failure',  
+     `hashIdsSucceeded`: charging station unique identifier strings array,  
+     `hashIdsFailed`: charging station unique identifier strings array (optional),  
+     `responsesFailed`: failed responses payload array (optional)  
     }
 
+### HTTP Protocol
+
+To learn how to use the HTTP protocol to pilot the simulator, an [Insomnia](https://insomnia.rest/) HTTP requests collection is available in [src/assets/ui-protocol](./src/assets/ui-protocol) directory.
+
 ## Support, Feedback, Contributing
 
 This project is open to feature requests/suggestions, bug reports etc. via [GitHub issues](https://github.com/SAP/e-mobility-charging-stations-simulator/issues). Contribution and feedback are encouraged and always welcome. For more information about how to contribute, the project structure, as well as additional contribution information, see our [Contribution Guidelines](CONTRIBUTING.md).