wiki:Documentation/gWide/bLTESIM

LTE SIM Configuration

SIM Card Setting Intro

  • International Mobile Subscriber Identity (IMSI): 15 digit unique identifying number that is used to identify the subscriber to the service. Typically issued by the operator. IMSI consists of:
    • MCC: Mobile Country Code - identifies geographic region of the SIM card
    • MNC: Mobile Network Code - identifies the operator
    • MSIN: Mobile Subscriber Identifier - identifies individual subscriber

Typically MCC and MNC are 5, 6 or 7 digit combination leaving 10, 9 or 8 digits for the subscriber serial number.

  • Authentication Algorithm: A number of standard security algorithms are sued in cellular networks. The two that are related to SIM configuration are:
    • XOR - Mostly used for testing
    • Mileanage - Mostly used in production. Parameters stored in SIm realated to authentication are:
      • Ki: Subscriber Authentication Key (128 bit)
      • OP: Operator Code - same for all SIMs from a single operator
      • OPc: Derived operator code unique for each SIM

These keys should be validated before deployment.

  • Answer To Reset (ATR): Information message that helps reader access the card information (i.e. describes how to read the SIM card).

NOTE: International Mobile Equipment Identity (IMEI) is not related to SIM but is rather a unique identifier of the device.

ORBIT Configuration

Installation requirements 04/26/17
  1. Install card reader software under linux, (master branch now works)
    1. sudo apt-get install pcscd pcsc-tools libpcsclite1 libpcsclite-dev python-pip swig
    2. pip install pyscard
    3. git clone git://git.osmocom.org/pysim pysim
    4. Run sudo pcsc_scan to verify that the reader detects the card
    5. 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
      
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
      2. MCC = 001 (Test Country)
      3. MNC = 01 (Test Network)
      4. Ki = 8BAF473F2F8FD09487CCCBD7097C6862
      5. OP = 11111111111111111111111111111111
      6. or OPc = 8BAF473F2F8FD09487CCCBD7097C6862 (can be used instead of OP)
      7. ID = 000000000001 (Increment for each sim to make unique)
      8. IMSI = (MCC|MNC|ID)
  2. 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.
      2. -t = card type, our case is sysmoUSIM-SJS1
      3. -x = MCC
      4. -y = MNC
      5. -j = ID number, increment as needed
      6. --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
      7. -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!!!
      8. 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 here
        1. 63C3 Verify fail, 3 tries left.
        2. 63C2 Verify fail, 2 tries left.
        3. 63C1 Verify fail, 1 tries left.
        4. 63C0 Verify fail, 0 tries left.
        5. 6389 Key length is not correct.
        6. 6388 Key number not valid.
        7. 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
    2. ./pySim-prog.py -p 0 -x 001 -y 01 -t sysmoUSIM-SJS1 -j 2 --op=11111111111111111111111111111111 -k 8BAF473F2F8FD09487CCCBD7097C6862 -a 21126642
  2. 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
    2. SIM 2 (In dongle attached to node2-5.outdoor)
      • ICCID : 8901001010000000025
      • IMSI : 001010000000002
      • Ki : 8BAF473F2F8FD09487CCCBD7097C6862
      • OPC : 8e27b6af0e692e750f32667a3b14605d

Last modified 8 months ago Last modified on 04/26/17 13:44:24