USIM modifier

---

Abstract

This is my 2nd practice project with Python, and it's a flexible SIM tool to modify some SIM files.
Yes, the tool is not a perfect tool for USIM modify, but I think its enough for most requirement.

Updated on 2020/03/08

USIM modifier V3.0 already release, you can click this for more information.

Comment on 2019/08/10

The project was stop to enhance due to have new plan for next major release. In this project, I found the architectue is not good and cause so many issues, below items are my expected for next major release:

1. Multiple language support with plugin.
2. More rigorous error handling to avoid the system crash if error occurs.
3. Provide 'security' (PIN manager) plugin on system level

PS. Even I stop to enhance this projet, but will kept to resolve bugs.

---

Features

• Interactive mode
• Flexible plugin mechanism
• Logging supported
• Below plugins were supported

• iccid: Display or modify the value of ICCID.
• spn: Display or modify the value of SPN.
• dir: Displayed all contents of EF_DIR file.
• send: Send the APDU command to USIM directly
• mccmnc: Display or modify the value of MCC/MNC.
• atr: Displayed the value of Answer To Reset (ATR).
• pin_cache: Cache the PIN1/ADM code to xml file for future verify automatically.
• arr: Displayed all contents of EF_ARR file.
• gid: Display or modify the value of GID1/GID2.
• msisdn: Display or modify the value of MSISDN.
• imsi: Display or modify the value of IMSI.
• card_info: Displayed the current status of USIM
• pin_count: Display all PIN/PUK/ADM retry counts. ( Added on 2019/07/21 )
• pin: To enable/disable the PIN1 or verify PIN2. ( Added on 2019/08/10 )

---

Card Info Example

---

Requirement Packages

• colorama
• pyscard
• lxml

---

Special Thanks

Brian Beck: switch class

---

Prepare the environment

Linux

linux@ubuntu:/$ pip3 install colorama
linux@ubuntu:/$ sudo apt-get install swig
linux@ubuntu:/$ sudo apt-get install libpcsclite-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

---

Install "USIM modifier"

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

---

User Guide

Please refer USIM Modifier User Guide

---

Tech Note

Please refer USIM Modifier 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