Update README.md

README.md

@@ -1,12 +1,48 @@
-OpenKMS notice
-==============
-This code is based on GPJ, Global Platform for SmartCardIO
-Java SDK library, available from http://gpj.sourceforge.net,
-adapted for use in OpenKMS.
+GlobalPlatform for OpenKMS
+==========================
+Load and manage applets with GlobalPlatform compatible JavaCards
+### Usage
+Command line samples assume default test keys of ```40..4F```. If you need custom keys, specify them with any or all of the following options: ```-keyid``` ```-keyver``` ```-enc``` ```-mac``` ```-kek``` (you need to know the details or ask your card provider). Some cards require key diversification with ```-emv``` or ```-visa2``` (you should be notified if that's the case).
 
-It is licensed under LGPL 3.0
+ * Show some basic information about a card (failsafe):
 
-Credits:
+        java -jar openkms-globalplatform.jar -info
+
+ * List applets:
+
+        java -jar openkms-globalplatform.jar -list
+
+ * Delete current default applet:
+
+        java -jar openkms-globalplatform.jar -delete -default
+
+ * Install applet.cap as default applet (with information from the CAP):
+
+        java -jar openkms-globalplatform.jar -load applet.cap -install -default
+
+ * Show APDU-s sent to the card:
+
+   add ```-debug``` to your command
+
+ * Don't use MAC on commands (plain GlobalPlatform commands):
+   add ```-mode clr``` to your command (not supported on all cards)
+
+
+### Contact 
+
+ * [email protected]
+ * .. or file an issue on Github
+
+### History
+
+The ancestor of this code is GPJ (Global Platform for SmartCardIO)
+available from http://gpj.sourceforge.net.
+
+### License
+
+ * [LGPL 3.0](http://www.gnu.org/licenses/lgpl-3.0.html)
+
+### Credits (from GPJ):
 *  Wojciech Mostowski <[email protected]>,
 *  Francois Kooman <[email protected]>
 *  Martijn Oostdijk <[email protected]>
@@ -15,6 +51,4 @@ Credits:
 *  Dusan Kovacevic
 
 -- 
-OpenKMS - open source key management
-
-http://openkms.org
+OpenKMS - open source key management - [openkms.org](http://openkms.org)