Changes between Version 1 and Version 2 of Documentation/gWide/bLTESIM

Timestamp:

Dec 2, 2016, 6:59:06 PM (7 years ago)

Author:

seskar

Comment:

—

Documentation/gWide/bLTESIM

@@ -36 +36 @@
 ==== ORBIT Configuration ====
 
-We use AAAA SIM cards with the following:
+* SIM cards used are Sysmocom sysmoUSIM-SJS1 (orange)
+* We follow the instructions at: [https://sourceforge.net/p/openlte/wiki/Programming%20you%20own%20USIM%20card/]
+* To avoid DAMAGE to your cards, you must have purchased the ADM keys with them. Follow the instructions regarding ADM keys precisely to avoid ruining your cards!
+===== Install Software =====
+1. Install card reader software under linux
+ 1. {{{ sudo apt-get install pcscd pcsc-tools libccid libpcsclite-dev }}}
+ 1. Run {{{ sudo pcsc_scan }}} to verify that the reader detects the card
+ 1. You should see at the bottom the text
+{{{
+3B 9F 96 80 1F C7 80 31 A0 73 BE 21 13 67 43 20 07 18 00 00 01 A5
+        sysmoUSIM-SJS1 (Telecommunication)
+        http://www.sysmocom.de/products/sysmousim-sjs1-sim-usim
+}}}
+1. Install pysim
+ 1. {{{ git clone git://git.osmocom.org/pysim pysim }}}
+ 1. Note: use master branch as of 2015-08-20
+  1. Older revisions cannot write these cards
+  1. This branch cannot read from these cards
 
+===== Select SIM parameters =====
+1. Choose SIM Parameters (Based on [https://gitlab.eurecom.fr/oai/openairinterface5g/wikis/SimCardConfig])
+ 1. For OAI and Amarisoft, we use the following:
+  1. Algorithm = Milenage
+  1. MCC = 001 (Test Country)
+  1. MNC = 01  (Test Network)
+  1. Ki = 8BAF473F2F8FD09487CCCBD7097C6862
+  1. OP = 11111111111111111111111111111111
+  1. or OPc = 8BAF473F2F8FD09487CCCBD7097C6862 (can be used instead of OP)
+  1. ID = 000000000001 (Increment for each sim to make unique)
+  1. IMSI = (MCC|MNC|ID)
+1. Program Cards '''DO NOT PROCEED WITHOUT CORRECT ADM KEYS'''
+ 1. We use the following flags from PySIM
+  1. {{{-p}}} = pcsc card reader index, get from pcsc_scan. Is 0 in our case.
+  1. {{{-t}}} = card type, our case is sysmoUSIM-SJS1
+  1. {{{-x}}} = MCC
+  1. {{{-y}}} = MNC
+  1. {{{-j}}} = ID number, increment as needed
+  1. {{{--op}}} = set OP, OPc is generated automatically by use of K and OP. For security you could increment both imsi and K to keep OPc hidden between clients
+  1. {{{-a}}} = ADM key. '''VERY IMPORTANT'''. These SIM cards must be purchased with ADM unlock keys. They are specific to each individual card. Attempting to program the card without / with an invalid key / the wrong version of pysim can '''BRICK''' your card, rendering it useless!!!
+  1. If pysim exits with a return code like {{{RuntimeError: SW match failed ! Expected 9000 and got 6983.}}} Then you got the ADM wrong, or used the wrong branch. Specific meanings are [https://www.eftlab.com.au/index.php/site-map/knowledge-base/118-apdu-response-list here]
+   1. 63C3 Verify fail, 3 tries left.
+   1. 63C2 Verify fail, 2 tries left.
+   1. 63C1 Verify fail, 1 tries left.
+   1. 63C0 Verify fail, 0 tries left.
+   1. 6389 Key length is not correct.
+   1. 6388 Key number not valid.
+   1. 6983 Authentication method blocked
+
+===== Program SIM Cards ======
+ 1. Our cards were programmed with the following commands
+  1. {{{ ./pySim-prog.py -p 0 -x 001 -y 01 -t sysmoUSIM-SJS1  -j 1 --op=11111111111111111111111111111111 -k 8BAF473F2F8FD09487CCCBD7097C6862 -a 75659958 }}}
+  1. {{{ ./pySim-prog.py -p 0 -x 001 -y 01 -t sysmoUSIM-SJS1  -j 2 --op=11111111111111111111111111111111 -k 8BAF473F2F8FD09487CCCBD7097C6862 -a 21126642 }}}
+ 1. This results in SIMs having the following parameters
+  1. SIM 1 (In dongle attached to node1-2.sb1)
+   * ICCID   : 8901001010000000017
+   * IMSI    : 001010000000001
+   * Ki      : 8BAF473F2F8FD09487CCCBD7097C6862
+   * OPC     : 8e27b6af0e692e750f32667a3b14605d
+  1. SIM 2 (In dongle attached to node2-5.outdoor)
+   * ICCID   : 8901001010000000025
+   * IMSI    : 001010000000002
+   * Ki      : 8BAF473F2F8FD09487CCCBD7097C6862
+   * OPC     : 8e27b6af0e692e750f32667a3b14605d
+   
+ 
+
+