ChargePoint documentation extended

documentation/ChargePoint/OlderTransparencyFormat.md

@@ -0,0 +1,17 @@
+# The older ChargePoint transparency format
+
+From the directory `documentation\ChargePoint\Testdata-2020-02` select the files `0024b1000002e300_2_123017065_payload.tar.bz2` containing the transparency records and `0024b1000002e300_2.pem` containing the public key of the EVSE of the associated charging station.
+
+![](Testdata-2020-02/screenshot01.png)
+![](Testdata-2020-02/screenshot02.png)
+
+
+1. When you select **multiple public key files**, e.g. `0024b1000002e300_2.pem` and `0124a500402e1300_2-publicKey.pem` the transparency software will automatically iterate over all public keys and stop as soon as it found a valid signature. Also the file name of the public key file is not important, see `like_0024b1000002e300_2_butWrongFileName.pem`.
+
+2. The transparency file `0024b1000002e300_2_123017065_payload.tar.bz2` is actually a compressed archive having two files: `secrrct` the transparency data and `secrrct.sign` the digital signature over the transparency data ***as it is*** within this file. No normalization *(minification)* of the JSON data is applied before creating or validating the digital signature, so you have to keep an eye on e.g. whitespaces and line breaks that might break the signature in unexpected ways.
+
+3. The transparency records in `0024b1000002e300_2_123017065_payload.tar.bz2` can also be used in combination with `0024b1000002e300_2-publicKey.chargy` which provides the associated public key and a digital signature for it in the Chargy format.
+
+4. The transparency records in `0024b1000002e300_2_123017065_payload.tar.bz2` can also be used in combination with `0024b1000002e300_2-publicKey_minimal.chargy` which provides the associated public key and a digital signature for it a minimal Chargy format.
+
+5. The transparency format used does not include additional CPO information. Nevertheless Chargy supports additional EVSE Id, address and geo location information within the signed part of transparency record. Within `documentation\ChargePoint\Testdata-2020-02extended` you will find a corresponding example. 

documentation/ChargePoint/README.md

@@ -6,7 +6,6 @@ separate the transparency data, its digital signature and the public key into di
 To make your life easier you can compress all together into e.g. a ZIP file and just drag&drop
 it into the transparency software.
 
-## Example of the older transparency format
 
-![](screenshot01.png)
-![](screenshot02.png)
+1. [The older transparency format](OlderTransparencyFormat.md)
+