# Write a sim card with pySim
## Installation:
Follow the online instruction: https://github.com/osmocom/pysim then install on an Ubuntu machine.

If commands does not work, remember to restart and enable service `pcscd.service`:

sudo systemctl restart pcscd.service
sudo systemctl enable pcscd.service

## Usage:
* Read: `./pySim-Read.py -p0`
* Write to a sim card, we need to know ADM code. For Gialer, ADM=88888888.
`
/pySim-prog.py -p 0 -n SUTD -a 92788340 -s 8988001010000649510  -i 001010000064951 -x 001 -y 01 -k 12345678901234567890123456789012 -o 12345678123456781234567812345678
`
* Write 525/200 to Gialer sim card, note `nmnclen="3"`:
`
/pySim-prog.py -p 0 -n SUTD -a 88888888 -s 8988001010000649510  -i 525200000064951 -x 525 -y 200 --nmnclen="3" -k 12345678901234567890123456789012 -o 12345678123456781234567812345678
`

* Example to write a sim card to Open5GS core with `IMSI=001010100011318`, key- 12345678901234567890123456789012 -OP code 12345678123456781234567812345678:

fcc@xps:~/ws/pysim$ ./pySim-read.py -p 0
Using PC/SC reader interface
Reading ...
Autodetected card type: OpenCells-SIM
ICCID: 8988001010000649318
IMSI: 001010100011318
GID1: ffffffff
GID2: ffffffff
SMSP: fffffffffffffffffffffffffdffffffffffffffffffffffff0191ffffffffffffffffffffffffff
SPN: SUTD
Show in HPLMN: False
Hide in OPLMN: False
PLMNsel: 00f110ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
PLMNwAcT:
	00f1104000 # MCC: 001 MNC: 01 AcT: E-UTRAN
	ffffffffff # unused
	ffffffffff # unused
	ffffffffff # unused
	ffffffffff # unused
	ffffffffff # unused
	ffffffffff # unused
	ffffffffff # unused
	ffffffffff # unused
	ffffffffff # unused
	ffffffffff # unused
	ffffffffff # unused
	ffffffffff # unused
	ffffffffff # unused
	ffffffffff # unused
	ffffffffff # unused
	ffffffffff # unused
	ffffffffff # unused
	ffffffffff # unused
	ffffffffff # unused
	ffffffffff # unused
	ffffffffff # unused
	ffffffffff # unused
	ffffffffff # unused
	ffffffffff # unused
	ffffffffff # unused
	ffffffffff # unused
	ffffffffff # unused
	ffffffffff # unused
	ffffffffff # unused
	ffffffffff # unused
	ffffffffff # unused
	ffffffffff # unused
	ffffffffff # unused
	ffffffffff # unused
	ffffffffff # unused
	ffffffffff # unused
	ffffffffff # unused
	ffffffffff # unused
	ffffffffff # unused
	ffffffffff # unused
	ffffffffff # unused
	ffffffffff # unused
	ffffffffff # unused
	ffffffffff # unused
	ffffffffff # unused
	ffffffffff # unused
	ffffffffff # unused
	ffffffffff # unused
	ffffffffff # unused
	ffffffffff # unused
	ffffffffff # unused
	ffffffffff # unused
	ffffffffff # unused
	ffffffffff # unused
	ffffffffff # unused
	ffffffffff # unused
	ffffffffff # unused
	ffffffffff # unused
	ffffffffff # unused
	ffffffffff # unused
	ffffffffff # unused
	ffffffffff # unused
	ffffffffff # unused
	ffffffffff # unused
	ffffffffff # unused
	ffffffffff # unused
	ffffffffff # unused
	ffffffffff # unused
	ffffffffff # unused
	ffffffffff # unused
	ffffffffff # unused
	ffffffffff # unused
	ffffffffff # unused
	ffffffffff # unused
	ffffffffff # unused
	ffffffffff # unused
	ffffffffff # unused
	ffffffffff # unused
	ffffffffff # unused
	ffffffffff # unused
	ffffffffff # unused

OPLMNwAcT:
	00f1104000 # MCC: 001 MNC: 01 AcT: E-UTRAN
	ffffffffff # unused
	ffffffffff # unused
	ffffffffff # unused
	ffffffffff # unused
	ffffffffff # unused
	ffffffffff # unused
	ffffffffff # unused
	ffffffffff # unused
	ffffffffff # unused
	ffffffffff # unused
	ffffffffff # unused

HPLMNAcT:
	00f1104000 # MCC: 001 MNC: 01 AcT: E-UTRAN
	ffffffffff # unused
	ffffffffff # unused

ACC: 0100
MSISDN: Not available
Administrative data: 00000002
	MS operation mode: normal
	Ciphering Indicator: disabled
SIM Service Table: ff33ffff00003f033000f0c3
	Service 1 - CHV1 disable function
	Service 2 - Abbreviated Dialling Numbers (ADN)
	Service 3 - Fixed Dialling Numbers (FDN)
	Service 4 - Short Message Storage (SMS)
	Service 5 - Advice of Charge (AoC)
	Service 6 - Capability Configuration Parameters (CCP)
	Service 7 - PLMN selector
	Service 8 - RFU
	Service 9 - MSISDN
	Service 10 - Extension1
	Service 13 - Last Number Dialled (LND)
	Service 14 - Cell Broadcast Message Identifier
	Service 17 - Service Provider Name
	Service 18 - Service Dialling Numbers (SDN)
	Service 19 - Extension3
	Service 20 - RFU
	Service 21 - VGCS Group Identifier List (EFVGCS and EFVGCSS)
	Service 22 - VBS Group Identifier List (EFVBS and EFVBSS)
	Service 23 - enhanced Multi-Level Precedence and Pre-emption Service
	Service 24 - Automatic Answer for eMLPP
	Service 25 - Data download via SMS-CB
	Service 26 - Data download via SMS-PP
	Service 27 - Menu selection
	Service 28 - Call control
	Service 29 - Proactive SIM
	Service 30 - Cell Broadcast Message Identifier Ranges
	Service 31 - Barred Dialling Numbers (BDN)
	Service 32 - Extension4
	Service 49 - MExE
	Service 50 - Reserved and shall be ignored
	Service 51 - PLMN Network Name
	Service 52 - Operator PLMN List
	Service 53 - Mailbox Dialling Numbers
	Service 54 - Message Waiting Indication Status
	Service 57 - Multimedia Messaging Service (MMS)
	Service 58 - Extension 8

EHPLMN:
	00f110 # MCC: 001 MNC: 001
	ffffff # unused
	ffffff # unused
	ffffff # unused

USIM Service Table: 867f1f1c230e0000400050
	Service 2 - Fixed Dialling Numbers (FDN)
	Service 3 - Extension 2
	Service 8 - Outgoing Call Information (OCI and OCT)
	Service 9 - Incoming Call Information (ICI and ICT)
	Service 10 - Short Message Storage (SMS)
	Service 11 - Short Message Status Reports (SMSR)
	Service 12 - Short Message Service Parameters (SMSP)
	Service 13 - Advice of Charge (AoC)
	Service 14 - Capability Configuration Parameters 2 (CCP2)
	Service 15 - Cell Broadcast Message Identifier
	Service 17 - Group Identifier Level 1
	Service 18 - Group Identifier Level 2
	Service 19 - Service Provider Name
	Service 20 - User controlled PLMN selector with Access Technology
	Service 21 - MSISDN
	Service 27 - GSM Access
	Service 28 - Data download via SMS-PP
	Service 29 - Data download via SMS-CB
	Service 33 - shall be set to 1
	Service 34 - Enabled Services Table
	Service 38 - GSM security context
	Service 42 - Operator controlled PLMN selector with Access Technology
	Service 43 - HPLMN selector with Access Technology
	Service 44 - Extension 5
	Service 71 - Equivalent HPLMN
	Service 85 - EPS Mobility Management Information
	Service 87 - Call control on EPS PDN connection by USIM

Done !

* Write PLMN=525/200:

fcc@xps:~/ws/pysim$ ./pySim-prog.py -p 0 -n SUTD -a 88888888 -s 00000005252000011318 -i 525020000011318 -x 525 -y 200 --nmnclen="3" -k 12345678901234567890123456789012 -o 12345678123456781234567812345678
/home/fcc/ws/pysim/./pySim-prog.py:602: SyntaxWarning: "is" with a literal. Did you mean "=="?
  if opts.mnclen is "2":
/home/fcc/ws/pysim/./pySim-prog.py:604: SyntaxWarning: "is" with a literal. Did you mean "=="?
  elif opts.mnclen is "3":
Using PC/SC reader interface
Ready for Programming: Insert card now (or CTRL-C to cancel)
Autodetected card type: OpenCells-SIM
Generated card parameters :
 > Name     : SUTD
 > SMSP     : e1ffffffffffffffffffffffff0581005155f5ffffffffffff000000
 > ICCID    : 00000005252000011318
 > MCC/MNC  : 525/200
 > IMSI     : 525020000011318
 > Ki       : 12345678901234567890123456789012
 > OPC      : 12345678123456781234567812345678
 > ACC      : None
 > ADM1(hex): 3838383838383838
 > OPMODE   : None
Programming ...
Programming successful: Remove card from reader

* write with PLMN=00101
`./pySim-prog.py -p 0 -n SUTD -a 88888888 -s 00000001010100011308 -i 001010100011308 -x 001 -y 01 -k 12345678901234567890123456789012 -o 12345678123456781234567812345678
`