• Table of contents
• sysmoISIM-SJA2
  • User Manual
  • Tools
    • pySIM
    • sysmo-isim-tool.sja2
    • SIM Toolkit
    • VoLTE / Android Carrier Privileges / ARA-M / IMS Configuration
  • Availability

sysmoISIM-SJA2¶

The sysmoISIM-SJA2 is programmable and Java capable SIM, USIM, ISIM and HPSIM card, supporting 2G, 3G, 4G and 5G. It is the successor of the sysmoUSIM-SJS1.

Each card is using a separate ADM1 key and the default configuration is hacker/developer friendly (fields being writable, reduced security for installing applets to have more quick development cycles).

User Manual¶

sysmocom provides a comprehensive user manual at https://sysmocom.de/manuals/sysmousim-manual.pdf - please refer to that manual rather than this rarely maintained wiki page for most up-to-date reference information.

Tools¶

pySIM¶

The sysmoISIM-SJA2 can be parameterized using pySim and sysmo-isim-tool.sja2

PySim provides the common general bulk provisioning features, which are already known from MagicSIM and previous sysmocom simcard models. Most of the settings (like Ki, ICCIC, OPC, etc...) listed below are covered by PySim.

Please see the pySim-prog.py program from https://gitea.osmocom.org/sim-card/pysim

sysmo-isim-tool.sja2¶

For tweaking higly sysmoISIM-SJA1 specific parameters (authentication algorithms, milenage parameters, enable/disable USIM/ISIM application etc...), sysmo-isim-tool.sja2 can be used. For more information see section "7.2 sysmo-usim-tool" in the provided manual.

Please see the sysmo-isim-tool.sja2.py program from https://git.sysmocom.de/sysmocom/sysmo-usim-tool/

SIM Toolkit¶

Please see shadysim.py for a tutorial on installing and removing a SIM Toolkit applications.

VoLTE / Android Carrier Privileges / ARA-M / IMS Configuration¶

If you want to use IMS (VoLTE/VoWiFi) on android devices, you will need to

• use a SIM card with ARA-M applet (sysmoISIM-SJA2 has it pre-installed for you)
• grant an android app special carrier privileges. This is done by storing a hash of the singing key of the android app on the SIM.

See VoLTE_IMS_Android_Carrier_Privileges for details.

Availability¶

sysoISIM-SJA2 is available from https://shop.sysmocom.de/sysmoISIM-SJA2-SIM-USIM-ISIM-Card-10-pack-with-ADM-keys/sysmoISIM-SJA2-10p-adm