USIM Modifier Version 3.0

The 'usim midifier v3.0' is for modify your 'TEST USIM' card, you can modify the content of USIM card with PC/SC card reader on multi-platform (Windows/MAC/Linux).

You can use this tool to do:

Modify iccid/imsi/mccmnc/gid/spn for specific test
Update msisdn to easy identify the USIM (Ex: Chunwau Telecom, FET NET, etc)
Enable/disable the PIN1, and query the PIN1/ADM retry count

PS. If you have any suggestion, please raise the 'issues' or send mail to me directly.

Update History

2021-05-30

New: Add 'config' plugin to update 'usim_modifier.xml'

2021-05-15

Fixed bug#3: Add 'admhex' option, value '1' is for hex, else are digits.
Only accept 8(digits) or 16(hex) key length of adm.
Enhance 'pin' plugin, will update the correct 'pin' code if auto save pin option enabled.

2021-04-12

Fixed bug#4: Auto adm_verify did not stop when verify fail

2021-04-11

New 'ust' plugin to display the 'USIM Service Table'.
Modified the input condition of ADM key, it can accept 8 ~ 16 digits hexadecimal and auto fill 'FF' to 16-digit.

Todo

None

Requirement Packages

python3 (Minimum version is 3.6.x)
colorama
pyscard
lxml

Prepare the environment

Linux

linux@ubuntu:/$ pip3 install colorama
linux@ubuntu:/$ pip3 install lxml
linux@ubuntu:/$ sudo apt-get install swig pcscd ibpcsclite-dev
linux@ubuntu:/$ sudo pip3 install pyscard

MAC OSX

Pre-condition: “HomeBrew” must be installed.

mac@osx:/$ pip3 install colorama
mac@osx:/$ pip3 install lxml
mac@osx:/$ brew install swig (PS. install “swig” by homebrew)
mac@osx:/$ pip3 install pyscard

Windows

I lost the install sequence, but 'usim_modifier v3' can works property on Windows platform.
You need to install 'colorama', 'lxml' & 'pyscard' packages.

Install "USIM modifier"

git clone https://github.com/minghsu/usim_modifier_v3.git

Features

Multiple platform supported (Windows/MAC/Linux)
Multi-language with extendable architecture
Flexible plugin mechanism
Dedicated language resource for 'plugin'
Auto verify 'pin' & 'adm' code (from usim_modifier.xml file)
Auto store 'pin' & 'adm' code by ICCID (configurable)
Logging support (configurable)

Plugin supported features

gid: Query or modify the value of GID1/GID2.
mccmnc: Query or modify the value of MCC/MNC
imsi: Query or modify the value of IMSI
spn: Query or modify the value of SPN
atr: Get and show the ATR value
iccid: Query or modify the value of IMSI
msisdn: Query or modify the value of MSISDN
send: Send the 'APDU' to USIM directly
pin: Enable/disable PIN1 and query the retry count of PIN1/ADM
ust: Display the 'USIM Service Table' features
cardinfo: Show the 'iccid', 'imsi', 'mccmnc', 'spn' & 'gid' info

You can type 'plugin' command to get all plugin info, the 'Updatable' column mean is able to modify in current session or not, and the 'AutoExec' mean the plugin will auto execute during startup stage or not.

Start to using 'usim_modifier_v3'

On 'Linux/Mac' OS, just type './usim_modifier.py' command.
For 'Windows' OS, please type 'python3 usim_modifer.py' command.

The 1st step, if the USIM enabled the PIN code, you must input correct 'pin code' to verify for future operation.
For next step, you can type 'adm code' to verification 'adm', and we can press 'ENTER' key to skip if you didn't have the 'adm code', but some 'plugin' may not updatable.

Example of plugins

All example are very simple, you can type 'help' argument to get more detail.

ATR

ICCID

IMSI

MCC/MNC

SPN

GID

MSISDN

UST (USIM Service Table)

ARR

DIR

SEND

CARDINFO

Tech Note

Please refer USIM Modifier V3 Tech Note

Reference

ETSI TS 102 221 - Smart Cards; UICC-Terminal interface; Physical and logical characteristics
ETSI TS 131 102 - UMTS; LTE;Characteristics of the Universal Subscriber Identity Module (USIM) application

nomis/usim_modifier_v3