textual

README.md

@@ -57,6 +57,7 @@ The Proxmark3 is the swiss-army tool of RFID, allowing for interactions with the
 |[Developing standalone mode](/armsrc/Standalone/readme.md)|[Wiki about standalone mode](https://github.com/RfidResearchGroup/proxmark3/wiki/Standalone-mode)|[Notes on Magic cards](/doc/magic_cards_notes.md)|
 |[Notes on Color usage](/doc/colors_notes.md)|[Makefile vs CMake](/doc/md/Development/Makefile-vs-CMake.md)|[Notes on Cloner guns](/doc/cloner_notes.md)|
 |[Notes on cliparser usage](/doc/cliparser.md)|[Notes on clocks](/doc/clocks.md)|[Notes on MIFARE DESFire](/doc/desfire.md)|
+|[Notes on CIPURSE](/doc/cipurse.md)|||
 
 # How to build?
 

doc/cipurse.md

@@ -16,27 +16,27 @@
 ## Documentation
 ^[Top](#top)
 
+Useful links to documentation about CIPURSE.
 [full documentation accessible from osptalliance](https://www.osptalliance.org/)
-
 [Infineon cipurse](https://www.infineon.com/cms/en/product/security-smart-card-solutions/cipurse-products/)
-
 [Infineon cipurse card SLS 32TLC100(M)](https://www.infineon.com/cms/en/product/security-smart-card-solutions/cipurse-products/sls-32tlc100m/)
 
+
 ## Source code
 ^[Top](#top)
 
+Useful links to Implementations / Source code on Github.
 [cipurse card emulation](https://github.com/duychuongvn/demo-nfc/tree/master/smart-ticket-demo/app/src/main/java/ch/smartlink/smartticketdemo/cipurse)
-
 [cipurse card core](https://github.com/duychuongvn/cipurse-card-core)
-
 [card side some code](https://github.com/duychuongvn/cipurse-card-side)
 
+
 ## Communication channel with a card
 ^[Top](#top)
 
 The card has two secure channels - the reader to the card and the card to the reader.
 
-And each channel has 3 modes: open, MACed, Encrypted.
+And each channel has 3 modes: `open, MACed, Encrypted`
 
 After authentication reader can specify the mode for each channel for each command.
 
@@ -45,7 +45,7 @@ Card answers if the mode that sets by the reader matches the mode of the file an
 ## Card architecture
 ^[Top](#top)
 
-The card has one master file with FID 0x3f00 that works as the root node.
+The card has one master file with FID 0x3F00 that works as the root node.
 
 The card has several applications inside the master file and the applications may have files. There are PxSE (special type) applications that work as an applications directory.
 
@@ -60,15 +60,37 @@ Each file can only have an access control list that specifies what operation the
 ### How to personalize card
 
 1. Format card (if it needs) 
-`hf cipurse formatall`
+```hf cipurse formatall```
 
 2. Create create PxSE file
-`hf cipurse create -d 9200123F00200008000062098407A0000005070100` 
+
-This command creates PTSE file with FID 0x2000, AID A0000005070100, and space for 8 AIDs
+The following command creates PTSE file with FID 0x2000, AID A0000005070100, and space for 8 AIDs
+
+```hf cipurse create -d 9200123F00200008000062098407A0000005070100```
+
+```
+9200123F00200008000062098407A0000005070100
+          ----                               FID
+              --                             Num of AID
+                            --------------   AID
+```
+
 
 3. Create application file
-`hf cipurse create -d 92002438613F010A05020000FFFFFF021009021009621084054144204631D407A0000005070100A00F2873737373737373737373737373737373015FD67B000102030405060708090A0B0C0D0E0F01C6A13B`
+
-This command creates application with FID 0x3F01, AID 4144204631, app type 61, max files count 10, max SFID count 5,
+```hf cipurse create -d 92002438613F010A05020000FFFFFF021009021009621084054144204631D407A0000005070100A00F2873737373737373737373737373737373015FD67B000102030405060708090A0B0C0D0E0F01C6A13B```
-minimum command's group security levels plain/plain/plain/plain (0000), access rights: all two keys can do anything (FFFFFF),
+
-key attributes 021009, 
+This command creates a application with following details:
-2 keys: `73..73` (add. info 01 / kvv 5FD67B), `0001..0e0f` (01/C6A13B), register in the PxSE A0000005070100
+  - FID.................... 0x3F01
+  - AID.................... 4144204631
+  - App type............... 61
+  - Max files count........ 10
+  - Max SFID count......... 5
+  - Minimum command's group security levels plain/plain/plain/plain (0000)
+  - Access rights.......... all two keys can do anything (FFFFFF)
+  - Key attributes......... 021009
+  - 2 keys.........
+    - `73..73`     (add. info 01 / kvv 5FD67B)
+    - `0001..0e0f` (01/C6A13B)
+  - Register in the PxSE... A0000005070100
+