blob: 59c57621110c5ba49cc450de87208d0c4a17037c [file] [log] [blame]
Daniel Willmannde07b952020-10-19 10:32:34 +02001#!/usr/bin/env python3
Alexander Chemeris6e589142013-07-04 17:34:06 +04002
3#
4# Utility to display some informations about a SIM card
5#
6#
7# Copyright (C) 2009 Sylvain Munaut <tnt@246tNt.com>
8# Copyright (C) 2010 Harald Welte <laforge@gnumonks.org>
9# Copyright (C) 2013 Alexander Chemeris <alexander.chemeris@gmail.com>
10#
11# This program is free software: you can redistribute it and/or modify
12# it under the terms of the GNU General Public License as published by
13# the Free Software Foundation, either version 2 of the License, or
14# (at your option) any later version.
15#
16# This program is distributed in the hope that it will be useful,
17# but WITHOUT ANY WARRANTY; without even the implied warranty of
18# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
19# GNU General Public License for more details.
20#
21# You should have received a copy of the GNU General Public License
22# along with this program. If not, see <http://www.gnu.org/licenses/>.
23#
24
25import hashlib
26from optparse import OptionParser
27import os
28import random
29import re
30import sys
Vadim Yanitskiydfe3dbb2020-07-28 05:26:02 +070031from pySim.ts_51_011 import EF, DF, EF_SST_map, EF_AD_mode_map
Sebastian Viviani0dc8f692020-05-29 00:14:55 +010032from pySim.ts_31_102 import EF_UST_map, EF_USIM_ADF_map
Supreeth Herle5ad9aec2020-03-24 17:26:40 +010033from pySim.ts_31_103 import EF_IST_map, EF_ISIM_ADF_map
Alexander Chemeris6e589142013-07-04 17:34:06 +040034
Alexander Chemeris6e589142013-07-04 17:34:06 +040035from pySim.commands import SimCardCommands
Harald Welte6e0458d2021-04-03 11:52:37 +020036from pySim.transport import init_reader
herlesupreethcebf8b12021-01-21 05:57:06 +010037from pySim.cards import card_detect, Card, UsimCard, IsimCard
Philipp Maierff84c232020-05-12 17:24:18 +020038from pySim.utils import h2b, swap_nibbles, rpad, dec_imsi, dec_iccid, dec_msisdn
Harald Welte6e0458d2021-04-03 11:52:37 +020039from pySim.utils import format_xplmn_w_act, dec_spn, dec_st, dec_addr_tlv
Supreeth Herle99d55552020-03-24 13:03:43 +010040from pySim.utils import h2s, format_ePDGSelection
Alexander Chemeris6e589142013-07-04 17:34:06 +040041
42def parse_options():
43
44 parser = OptionParser(usage="usage: %prog [options]")
45
46 parser.add_option("-d", "--device", dest="device", metavar="DEV",
47 help="Serial Device for SIM access [default: %default]",
48 default="/dev/ttyUSB0",
49 )
50 parser.add_option("-b", "--baud", dest="baudrate", type="int", metavar="BAUD",
51 help="Baudrate used for SIM access [default: %default]",
52 default=9600,
53 )
54 parser.add_option("-p", "--pcsc-device", dest="pcsc_dev", type='int', metavar="PCSC",
55 help="Which PC/SC reader number for SIM access",
56 default=None,
57 )
Vadim Yanitskiy29ca8042020-05-09 21:23:37 +070058 parser.add_option("--modem-device", dest="modem_dev", metavar="DEV",
59 help="Serial port of modem for Generic SIM Access (3GPP TS 27.007)",
60 default=None,
61 )
62 parser.add_option("--modem-baud", dest="modem_baud", type="int", metavar="BAUD",
63 help="Baudrate used for modem's port [default: %default]",
64 default=115200,
65 )
Vadim Yanitskiy9f9f5a62018-10-27 02:10:34 +070066 parser.add_option("--osmocon", dest="osmocon_sock", metavar="PATH",
67 help="Socket path for Calypso (e.g. Motorola C1XX) based reader (via OsmocomBB)",
68 default=None,
69 )
Alexander Chemeris6e589142013-07-04 17:34:06 +040070
71 (options, args) = parser.parse_args()
72
73 if args:
74 parser.error("Extraneous arguments")
75
76 return options
77
78
79if __name__ == '__main__':
80
81 # Parse options
82 opts = parse_options()
83
Vadim Yanitskiy588f3ac2018-10-27 06:30:33 +070084 # Init card reader driver
Philipp Maierff84c232020-05-12 17:24:18 +020085 sl = init_reader(opts)
Philipp Maierc8caec22021-02-22 16:07:53 +010086 if sl is None:
87 exit(1)
Alexander Chemeris6e589142013-07-04 17:34:06 +040088
89 # Create command layer
90 scc = SimCardCommands(transport=sl)
91
92 # Wait for SIM card
93 sl.wait_for_card()
94
Supreeth Herle3e6f16d2020-03-23 10:00:50 +010095 # Assuming UICC SIM
96 scc.cla_byte = "00"
97 scc.sel_ctrl = "0004"
98
99 # Testing for Classic SIM or UICC
100 (res, sw) = sl.send_apdu(scc.cla_byte + "a4" + scc.sel_ctrl + "02" + "3f00")
101 if sw == '6e00':
102 # Just a Classic SIM
103 scc.cla_byte = "a0"
104 scc.sel_ctrl = "0000"
105
Alexander Chemeris6e589142013-07-04 17:34:06 +0400106 # Program the card
107 print("Reading ...")
108
Supreeth Herle4c306ab2020-03-18 11:38:00 +0100109 # Initialize Card object by auto detecting the card
110 card = card_detect("auto", scc) or Card(scc)
111
Supreeth Herle3bf43632020-03-20 20:20:27 +0100112 # Read all AIDs on the UICC
113 card.read_aids()
114
Alexander Chemeris6e589142013-07-04 17:34:06 +0400115 # EF.ICCID
Supreeth Herle3566b8e2020-03-18 12:02:34 +0100116 (res, sw) = card.read_iccid()
Alexander Chemeris6e589142013-07-04 17:34:06 +0400117 if sw == '9000':
Supreeth Herle3566b8e2020-03-18 12:02:34 +0100118 print("ICCID: %s" % (res,))
Alexander Chemeris6e589142013-07-04 17:34:06 +0400119 else:
120 print("ICCID: Can't read, response code = %s" % (sw,))
121
122 # EF.IMSI
Supreeth Herlef9762dc2020-03-18 12:05:06 +0100123 (res, sw) = card.read_imsi()
Alexander Chemeris6e589142013-07-04 17:34:06 +0400124 if sw == '9000':
Supreeth Herlef9762dc2020-03-18 12:05:06 +0100125 print("IMSI: %s" % (res,))
Alexander Chemeris6e589142013-07-04 17:34:06 +0400126 else:
127 print("IMSI: Can't read, response code = %s" % (sw,))
128
Supreeth Herleab46d622020-03-05 15:30:22 +0100129 # EF.GID1
130 try:
Supreeth Herle98a69272020-03-18 12:14:48 +0100131 (res, sw) = card.read_gid1()
Supreeth Herleab46d622020-03-05 15:30:22 +0100132 if sw == '9000':
133 print("GID1: %s" % (res,))
134 else:
135 print("GID1: Can't read, response code = %s" % (sw,))
136 except Exception as e:
137 print("GID1: Can't read file -- %s" % (str(e),))
138
Supreeth Herle0e90e6c2020-03-05 15:33:00 +0100139 # EF.GID2
140 try:
Supreeth Herlee573ccb2020-04-01 09:21:20 +0200141 (res, sw) = card.read_binary('GID2')
Supreeth Herle0e90e6c2020-03-05 15:33:00 +0100142 if sw == '9000':
143 print("GID2: %s" % (res,))
144 else:
145 print("GID2: Can't read, response code = %s" % (sw,))
146 except Exception as e:
147 print("GID2: Can't read file -- %s" % (str(e),))
148
Alexander Chemeris6e589142013-07-04 17:34:06 +0400149 # EF.SMSP
Supreeth Herleebe6dba2020-03-19 12:08:20 +0100150 (res, sw) = card.read_record('SMSP', 1)
Alexander Chemeris6e589142013-07-04 17:34:06 +0400151 if sw == '9000':
152 print("SMSP: %s" % (res,))
153 else:
154 print("SMSP: Can't read, response code = %s" % (sw,))
155
Supreeth Herlef8299452019-06-08 07:49:08 +0200156 # EF.SPN
157 try:
Supreeth Herle846cefb2020-03-19 12:11:25 +0100158 (res, sw) = card.read_spn()
Supreeth Herlef8299452019-06-08 07:49:08 +0200159 if sw == '9000':
Supreeth Herle846cefb2020-03-19 12:11:25 +0100160 print("SPN: %s" % (res[0] or "Not available"))
161 print("Display HPLMN: %s" % (res[1],))
162 print("Display OPLMN: %s" % (res[2],))
Supreeth Herlef8299452019-06-08 07:49:08 +0200163 else:
164 print("SPN: Can't read, response code = %s" % (sw,))
165 except Exception as e:
166 print("SPN: Can't read file -- %s" % (str(e),))
167
Philipp Maiera2650492018-07-11 23:05:58 +0200168 # EF.PLMNsel
169 try:
Supreeth Herle9efd8ef2020-03-19 12:14:10 +0100170 (res, sw) = card.read_binary('PLMNsel')
Denis 'GNUtoo' Carikli84d2cb32019-09-12 01:46:25 +0200171 if sw == '9000':
172 print("PLMNsel: %s" % (res))
173 else:
174 print("PLMNsel: Can't read, response code = %s" % (sw,))
Philipp Maiera2650492018-07-11 23:05:58 +0200175 except Exception as e:
Vadim Yanitskiya3bb3342020-01-25 12:45:37 +0700176 print("PLMNsel: Can't read file -- " + str(e))
Philipp Maiera2650492018-07-11 23:05:58 +0200177
178 # EF.PLMNwAcT
Denis 'GNUtoo' Carikli84d2cb32019-09-12 01:46:25 +0200179 try:
Supreeth Herle14084402020-03-19 12:42:10 +0100180 (res, sw) = card.read_plmn_act()
Denis 'GNUtoo' Carikli84d2cb32019-09-12 01:46:25 +0200181 if sw == '9000':
Supreeth Herle14084402020-03-19 12:42:10 +0100182 print("PLMNwAcT:\n%s" % (res))
Denis 'GNUtoo' Carikli84d2cb32019-09-12 01:46:25 +0200183 else:
184 print("PLMNwAcT: Can't read, response code = %s" % (sw,))
Philipp Maiera2650492018-07-11 23:05:58 +0200185 except Exception as e:
Vadim Yanitskiy6727f0c2020-01-22 23:38:24 +0700186 print("PLMNwAcT: Can't read file -- " + str(e))
Philipp Maiera2650492018-07-11 23:05:58 +0200187
188 # EF.OPLMNwAcT
Denis 'GNUtoo' Carikli84d2cb32019-09-12 01:46:25 +0200189 try:
Supreeth Herle1757b262020-03-19 12:43:11 +0100190 (res, sw) = card.read_oplmn_act()
Denis 'GNUtoo' Carikli84d2cb32019-09-12 01:46:25 +0200191 if sw == '9000':
Supreeth Herle1757b262020-03-19 12:43:11 +0100192 print("OPLMNwAcT:\n%s" % (res))
Denis 'GNUtoo' Carikli84d2cb32019-09-12 01:46:25 +0200193 else:
194 print("OPLMNwAcT: Can't read, response code = %s" % (sw,))
Philipp Maiera2650492018-07-11 23:05:58 +0200195 except Exception as e:
Vadim Yanitskiy6727f0c2020-01-22 23:38:24 +0700196 print("OPLMNwAcT: Can't read file -- " + str(e))
Philipp Maiera2650492018-07-11 23:05:58 +0200197
198 # EF.HPLMNAcT
Denis 'GNUtoo' Carikli84d2cb32019-09-12 01:46:25 +0200199 try:
Supreeth Herlea850a472020-03-19 12:44:11 +0100200 (res, sw) = card.read_hplmn_act()
Denis 'GNUtoo' Carikli84d2cb32019-09-12 01:46:25 +0200201 if sw == '9000':
Supreeth Herlea850a472020-03-19 12:44:11 +0100202 print("HPLMNAcT:\n%s" % (res))
Denis 'GNUtoo' Carikli84d2cb32019-09-12 01:46:25 +0200203 else:
204 print("HPLMNAcT: Can't read, response code = %s" % (sw,))
Philipp Maiera2650492018-07-11 23:05:58 +0200205 except Exception as e:
Vadim Yanitskiy6727f0c2020-01-22 23:38:24 +0700206 print("HPLMNAcT: Can't read file -- " + str(e))
Alexander Chemeris6e589142013-07-04 17:34:06 +0400207
208 # EF.ACC
Supreeth Herled1fb6fc2020-03-19 12:45:45 +0100209 (res, sw) = card.read_binary('ACC')
Alexander Chemeris6e589142013-07-04 17:34:06 +0400210 if sw == '9000':
211 print("ACC: %s" % (res,))
212 else:
213 print("ACC: Can't read, response code = %s" % (sw,))
214
215 # EF.MSISDN
Sylvain Munaut9f138972013-07-18 10:36:51 +0200216 try:
Supreeth Herle6d66af62020-03-19 12:49:16 +0100217 (res, sw) = card.read_msisdn()
Sylvain Munaut9f138972013-07-18 10:36:51 +0200218 if sw == '9000':
Supreeth Herle6d66af62020-03-19 12:49:16 +0100219 # (npi, ton, msisdn) = res
220 if res is not None:
221 print("MSISDN (NPI=%d ToN=%d): %s" % res)
Sylvain Munaut9f138972013-07-18 10:36:51 +0200222 else:
223 print("MSISDN: Not available")
Alexander Chemeris6e589142013-07-04 17:34:06 +0400224 else:
Sylvain Munaut9f138972013-07-18 10:36:51 +0200225 print("MSISDN: Can't read, response code = %s" % (sw,))
Philipp Maierea6bdf02018-07-11 23:02:36 +0200226 except Exception as e:
Vadim Yanitskiy6727f0c2020-01-22 23:38:24 +0700227 print("MSISDN: Can't read file -- " + str(e))
Alexander Chemeris6e589142013-07-04 17:34:06 +0400228
Philipp Maieree908ae2019-03-21 16:21:12 +0100229 # EF.AD
Supreeth Herle52ef6752020-03-19 12:50:27 +0100230 (res, sw) = card.read_binary('AD')
Philipp Maieree908ae2019-03-21 16:21:12 +0100231 if sw == '9000':
Vadim Yanitskiydfe3dbb2020-07-28 05:26:02 +0700232 print("Administrative data: %s" % (res,))
233 if res[:2] in EF_AD_mode_map:
234 print("\tMS operation mode: %s" % (EF_AD_mode_map[res[:2]],))
235 else:
236 print("\tMS operation mode: (unknown 0x%s)" % (res[:2],))
237 if int(res[4:6], 16) & 0x01:
238 print("\tCiphering Indicator: enabled")
239 else:
240 print("\tCiphering Indicator: disabled")
Philipp Maieree908ae2019-03-21 16:21:12 +0100241 else:
242 print("AD: Can't read, response code = %s" % (sw,))
243
Supreeth Herlee26331e2020-03-20 18:50:39 +0100244 # EF.SST
Supreeth Herled3b13d02020-04-20 13:30:34 +0200245 (res, sw) = card.read_binary('SST')
Supreeth Herlee26331e2020-03-20 18:50:39 +0100246 if sw == '9000':
Supreeth Herled3b13d02020-04-20 13:30:34 +0200247 print("SIM Service Table: %s" % res)
Supreeth Herlee26331e2020-03-20 18:50:39 +0100248 # Print those which are available
Supreeth Herled3b13d02020-04-20 13:30:34 +0200249 print("%s" % dec_st(res))
Supreeth Herlee26331e2020-03-20 18:50:39 +0100250 else:
251 print("SIM Service Table: Can't read, response code = %s" % (sw,))
252
Supreeth Herle96412992020-03-22 08:20:11 +0100253 # Check whether we have th AID of USIM, if so select it by its AID
254 # EF.UST - File Id in ADF USIM : 6f38
Philipp Maiercba6dbc2021-03-11 13:03:18 +0100255 data, sw = card.select_adf_by_aid(adf="usim")
256 if sw == '9000':
herlesupreethcebf8b12021-01-21 05:57:06 +0100257 # Select USIM profile
258 usim_card = UsimCard(scc)
259
Harald Welteca673942020-06-03 15:19:40 +0200260 # EF.EHPLMN
herlesupreethcebf8b12021-01-21 05:57:06 +0100261 if usim_card.file_exists(EF_USIM_ADF_map['EHPLMN']):
262 (res, sw) = usim_card.read_ehplmn()
Harald Welteca673942020-06-03 15:19:40 +0200263 if sw == '9000':
264 print("EHPLMN:\n%s" % (res))
265 else:
266 print("EHPLMN: Can't read, response code = %s" % (sw,))
herlesupreeth4a3580b2020-09-29 10:11:36 +0200267
Supreeth Herle96412992020-03-22 08:20:11 +0100268 # EF.UST
herlesupreeth4a3580b2020-09-29 10:11:36 +0200269 try:
herlesupreethcebf8b12021-01-21 05:57:06 +0100270 if usim_card.file_exists(EF_USIM_ADF_map['UST']):
herlesupreeth4a3580b2020-09-29 10:11:36 +0200271 # res[0] - EF content of UST
272 # res[1] - Human readable format of services marked available in UST
herlesupreethcebf8b12021-01-21 05:57:06 +0100273 (res, sw) = usim_card.read_ust()
herlesupreeth4a3580b2020-09-29 10:11:36 +0200274 if sw == '9000':
275 print("USIM Service Table: %s" % res[0])
276 print("%s" % res[1])
277 else:
278 print("USIM Service Table: Can't read, response code = %s" % (sw,))
279 except Exception as e:
280 print("USIM Service Table: Can't read file -- " + str(e))
Supreeth Herle96412992020-03-22 08:20:11 +0100281
Supreeth Herleb1634db2020-03-22 10:00:43 +0100282 #EF.ePDGId - Home ePDG Identifier
283 try:
herlesupreethcebf8b12021-01-21 05:57:06 +0100284 if usim_card.file_exists(EF_USIM_ADF_map['ePDGId']):
285 (res, sw) = usim_card.read_epdgid()
herlesupreethf8232db2020-09-29 10:03:06 +0200286 if sw == '9000':
287 print("ePDGId:\n%s" % (len(res) and res or '\tNot available\n',))
288 else:
289 print("ePDGId: Can't read, response code = %s" % (sw,))
Supreeth Herleb1634db2020-03-22 10:00:43 +0100290 except Exception as e:
291 print("ePDGId: Can't read file -- " + str(e))
292
Supreeth Herle99d55552020-03-24 13:03:43 +0100293 #EF.ePDGSelection - ePDG Selection Information
294 try:
herlesupreethcebf8b12021-01-21 05:57:06 +0100295 if usim_card.file_exists(EF_USIM_ADF_map['ePDGSelection']):
296 (res, sw) = usim_card.read_ePDGSelection()
Supreeth Herle99d55552020-03-24 13:03:43 +0100297 if sw == '9000':
298 print("ePDGSelection:\n%s" % (res,))
299 else:
300 print("ePDGSelection: Can't read, response code = %s" % (sw,))
301 except Exception as e:
302 print("ePDGSelection: Can't read file -- " + str(e))
303
Supreeth Herle5ad9aec2020-03-24 17:26:40 +0100304 # Select ISIM application by its AID
Philipp Maiercba6dbc2021-03-11 13:03:18 +0100305 data, sw = card.select_adf_by_aid(adf="isim")
306 if sw == '9000':
herlesupreethcebf8b12021-01-21 05:57:06 +0100307 # Select USIM profile
308 isim_card = IsimCard(scc)
309
Supreeth Herle5ad9aec2020-03-24 17:26:40 +0100310 #EF.P-CSCF - P-CSCF Address
311 try:
herlesupreethcebf8b12021-01-21 05:57:06 +0100312 if isim_card.file_exists(EF_ISIM_ADF_map['PCSCF']):
313 res = isim_card.read_pcscf()
Supreeth Herle5ad9aec2020-03-24 17:26:40 +0100314 print("P-CSCF:\n%s" % (len(res) and res or '\tNot available\n',))
315 except Exception as e:
316 print("P-CSCF: Can't read file -- " + str(e))
317
Supreeth Herle05b28072020-03-25 10:23:48 +0100318 # EF.DOMAIN - Home Network Domain Name e.g. ims.mncXXX.mccXXX.3gppnetwork.org
319 try:
herlesupreethcebf8b12021-01-21 05:57:06 +0100320 if isim_card.file_exists(EF_ISIM_ADF_map['DOMAIN']):
321 (res, sw) = isim_card.read_domain()
Supreeth Herle05b28072020-03-25 10:23:48 +0100322 if sw == '9000':
323 print("Home Network Domain Name: %s" % (len(res) and res or 'Not available',))
324 else:
325 print("Home Network Domain Name: Can't read, response code = %s" % (sw,))
326 except Exception as e:
327 print("Home Network Domain Name: Can't read file -- " + str(e))
328
Supreeth Herle3f67f9c2020-03-25 15:38:02 +0100329 # EF.IMPI - IMS private user identity
330 try:
herlesupreethcebf8b12021-01-21 05:57:06 +0100331 if isim_card.file_exists(EF_ISIM_ADF_map['IMPI']):
332 (res, sw) = isim_card.read_impi()
Supreeth Herle3f67f9c2020-03-25 15:38:02 +0100333 if sw == '9000':
334 print("IMS private user identity: %s" % (len(res) and res or 'Not available',))
335 else:
336 print("IMS private user identity: Can't read, response code = %s" % (sw,))
337 except Exception as e:
338 print("IMS private user identity: Can't read file -- " + str(e))
339
Supreeth Herle0c02d8a2020-03-26 09:00:06 +0100340 # EF.IMPU - IMS public user identity
341 try:
herlesupreethcebf8b12021-01-21 05:57:06 +0100342 if isim_card.file_exists(EF_ISIM_ADF_map['IMPU']):
343 res = isim_card.read_impu()
Supreeth Herle0c02d8a2020-03-26 09:00:06 +0100344 print("IMS public user identity:\n%s" % (len(res) and res or '\tNot available\n',))
345 except Exception as e:
346 print("IMS public user identity: Can't read file -- " + str(e))
347
Supreeth Herlebe3b6412020-06-01 12:53:57 +0200348 # EF.UICCIARI - UICC IARI
349 try:
herlesupreethcebf8b12021-01-21 05:57:06 +0100350 if isim_card.file_exists(EF_ISIM_ADF_map['UICCIARI']):
351 res = isim_card.read_iari()
Supreeth Herlebe3b6412020-06-01 12:53:57 +0200352 print("UICC IARI:\n%s" % (len(res) and res or '\tNot available\n',))
353 except Exception as e:
354 print("UICC IARI: Can't read file -- " + str(e))
355
Supreeth Herleee15c772020-03-22 08:58:33 +0100356 # Check whether we have th AID of ISIM, if so select it by its AID
357 # EF.IST - File Id in ADF ISIM : 6f07
Philipp Maiercba6dbc2021-03-11 13:03:18 +0100358 data, sw = card.select_adf_by_aid(adf="isim")
359 if sw == '9000':
Supreeth Herleee15c772020-03-22 08:58:33 +0100360 # EF.IST
361 (res, sw) = card.read_binary('6f07')
362 if sw == '9000':
363 print("ISIM Service Table: %s" % res)
364 # Print those which are available
365 print("%s" % dec_st(res, table="isim"))
366 else:
367 print("ISIM Service Table: Can't read, response code = %s" % (sw,))
368
Alexander Chemeris6e589142013-07-04 17:34:06 +0400369 # Done for this card and maybe for everything ?
Vadim Yanitskiy6727f0c2020-01-22 23:38:24 +0700370 print("Done !\n")