blob: 4dc20a4a90a67f4966807e077ef3928ad0180f0a [file] [log] [blame]
Sylvain Munaut76504e02010-12-07 00:24:32 +01001# -*- coding: utf-8 -*-
2
3""" pySim: Card programmation logic
4"""
5
6#
7# Copyright (C) 2009-2010 Sylvain Munaut <tnt@246tNt.com>
Harald Welte3156d902011-03-22 21:48:19 +01008# Copyright (C) 2011 Harald Welte <laforge@gnumonks.org>
Alexander Chemeriseb6807d2017-07-18 17:04:38 +03009# Copyright (C) 2017 Alexander.Chemeris <Alexander.Chemeris@gmail.com>
Sylvain Munaut76504e02010-12-07 00:24:32 +010010#
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
Vadim Yanitskiy03c67f72021-05-02 02:10:39 +020025from typing import Optional, Dict, Tuple
Vadim Yanitskiy85302d62021-05-02 02:18:42 +020026import abc
Vadim Yanitskiy03c67f72021-05-02 02:10:39 +020027
Robert Falkenbergb07a3e92021-05-07 15:23:20 +020028from pySim.ts_51_011 import EF, DF, EF_AD, EF_SPN
Harald Welteca673942020-06-03 15:19:40 +020029from pySim.ts_31_102 import EF_USIM_ADF_map
Supreeth Herle5ad9aec2020-03-24 17:26:40 +010030from pySim.ts_31_103 import EF_ISIM_ADF_map
Alexander Chemeriseb6807d2017-07-18 17:04:38 +030031from pySim.utils import *
Alexander Chemeris8ad124a2018-01-10 14:17:55 +090032from smartcard.util import toBytes
Supreeth Herle79f43dd2020-03-25 11:43:19 +010033from pytlv.TLV import *
Sylvain Munaut76504e02010-12-07 00:24:32 +010034
Harald Weltec91085e2022-02-10 18:05:45 +010035
36def format_addr(addr: str, addr_type: str) -> str:
37 """
38 helper function to format an FQDN (addr_type = '00') or IPv4
39 (addr_type = '01') address string into a printable string that
40 contains the hexadecimal representation and the original address
41 string (addr)
42 """
43 res = ""
44 if addr_type == '00': # FQDN
45 res += "\t%s # %s\n" % (s2h(addr), addr)
46 elif addr_type == '01': # IPv4
47 octets = addr.split(".")
48 addr_hex = ""
49 for o in octets:
50 addr_hex += ("%02x" % int(o))
51 res += "\t%s # %s\n" % (addr_hex, addr)
52 return res
53
Philipp Maierbe18f2a2021-04-30 15:00:27 +020054
Vadim Yanitskiy04b5d9d2022-07-07 03:05:30 +070055class SimCard:
Sylvain Munaut76504e02010-12-07 00:24:32 +010056
Harald Weltec91085e2022-02-10 18:05:45 +010057 name = 'SIM'
Philipp Maierfc5f28d2021-05-05 12:18:41 +020058
Harald Weltec91085e2022-02-10 18:05:45 +010059 def __init__(self, scc):
60 self._scc = scc
61 self._adm_chv_num = 4
62 self._aids = []
Sylvain Munaut76504e02010-12-07 00:24:32 +010063
Harald Weltec91085e2022-02-10 18:05:45 +010064 def reset(self):
65 rc = self._scc.reset_card()
Vadim Yanitskiyb9544512022-04-21 16:46:03 +030066 if rc == 1:
Harald Weltec91085e2022-02-10 18:05:45 +010067 return self._scc.get_atr()
68 else:
69 return None
Sylvain Munaut76504e02010-12-07 00:24:32 +010070
Harald Weltec91085e2022-02-10 18:05:45 +010071 def erase(self):
72 print("warning: erasing is not supported for specified card type!")
73 return
Philipp Maierd58c6322020-05-12 16:47:45 +020074
Harald Weltec91085e2022-02-10 18:05:45 +010075 def file_exists(self, fid):
76 res_arr = self._scc.try_select_path(fid)
77 for res in res_arr:
78 if res[1] != '9000':
79 return False
80 return True
Harald Welteca673942020-06-03 15:19:40 +020081
Harald Weltec91085e2022-02-10 18:05:45 +010082 def verify_adm(self, key):
83 """Authenticate with ADM key"""
84 (res, sw) = self._scc.verify_chv(self._adm_chv_num, key)
85 return sw
Alexander Chemeriseb6807d2017-07-18 17:04:38 +030086
Harald Weltec91085e2022-02-10 18:05:45 +010087 def read_iccid(self):
88 (res, sw) = self._scc.read_binary(EF['ICCID'])
89 if sw == '9000':
90 return (dec_iccid(res), sw)
91 else:
92 return (None, sw)
Alexander Chemeriseb6807d2017-07-18 17:04:38 +030093
Harald Weltec91085e2022-02-10 18:05:45 +010094 def read_imsi(self):
95 (res, sw) = self._scc.read_binary(EF['IMSI'])
96 if sw == '9000':
97 return (dec_imsi(res), sw)
98 else:
99 return (None, sw)
Alexander Chemeriseb6807d2017-07-18 17:04:38 +0300100
Harald Weltec91085e2022-02-10 18:05:45 +0100101 def update_imsi(self, imsi):
102 data, sw = self._scc.update_binary(EF['IMSI'], enc_imsi(imsi))
103 return sw
Alexander Chemeriseb6807d2017-07-18 17:04:38 +0300104
Harald Weltec91085e2022-02-10 18:05:45 +0100105 def update_acc(self, acc):
106 data, sw = self._scc.update_binary(EF['ACC'], lpad(acc, 4, c='0'))
107 return sw
Alexander Chemeriseb6807d2017-07-18 17:04:38 +0300108
Harald Weltec91085e2022-02-10 18:05:45 +0100109 def read_hplmn_act(self):
110 (res, sw) = self._scc.read_binary(EF['HPLMNAcT'])
111 if sw == '9000':
112 return (format_xplmn_w_act(res), sw)
113 else:
114 return (None, sw)
Supreeth Herlea850a472020-03-19 12:44:11 +0100115
Harald Weltec91085e2022-02-10 18:05:45 +0100116 def update_hplmn_act(self, mcc, mnc, access_tech='FFFF'):
117 """
118 Update Home PLMN with access technology bit-field
Alexander Chemeriseb6807d2017-07-18 17:04:38 +0300119
Harald Weltec91085e2022-02-10 18:05:45 +0100120 See Section "10.3.37 EFHPLMNwAcT (HPLMN Selector with Access Technology)"
121 in ETSI TS 151 011 for the details of the access_tech field coding.
122 Some common values:
123 access_tech = '0080' # Only GSM is selected
124 access_tech = 'FFFF' # All technologies selected, even Reserved for Future Use ones
125 """
126 # get size and write EF.HPLMNwAcT
127 data = self._scc.read_binary(EF['HPLMNwAcT'], length=None, offset=0)
128 size = len(data[0]) // 2
129 hplmn = enc_plmn(mcc, mnc)
130 content = hplmn + access_tech
131 data, sw = self._scc.update_binary(
132 EF['HPLMNwAcT'], content + 'ffffff0000' * (size // 5 - 1))
133 return sw
Alexander Chemeriseb6807d2017-07-18 17:04:38 +0300134
Harald Weltec91085e2022-02-10 18:05:45 +0100135 def read_oplmn_act(self):
136 (res, sw) = self._scc.read_binary(EF['OPLMNwAcT'])
137 if sw == '9000':
138 return (format_xplmn_w_act(res), sw)
139 else:
140 return (None, sw)
Supreeth Herle1757b262020-03-19 12:43:11 +0100141
Harald Weltec91085e2022-02-10 18:05:45 +0100142 def update_oplmn_act(self, mcc, mnc, access_tech='FFFF'):
143 """get size and write EF.OPLMNwAcT, See note in update_hplmn_act()"""
144 data = self._scc.read_binary(EF['OPLMNwAcT'], length=None, offset=0)
145 size = len(data[0]) // 2
146 hplmn = enc_plmn(mcc, mnc)
147 content = hplmn + access_tech
148 data, sw = self._scc.update_binary(
149 EF['OPLMNwAcT'], content + 'ffffff0000' * (size // 5 - 1))
150 return sw
Philipp Maierc8ce82a2018-07-04 17:57:20 +0200151
Harald Weltec91085e2022-02-10 18:05:45 +0100152 def read_plmn_act(self):
153 (res, sw) = self._scc.read_binary(EF['PLMNwAcT'])
154 if sw == '9000':
155 return (format_xplmn_w_act(res), sw)
156 else:
157 return (None, sw)
Supreeth Herle14084402020-03-19 12:42:10 +0100158
Harald Weltec91085e2022-02-10 18:05:45 +0100159 def update_plmn_act(self, mcc, mnc, access_tech='FFFF'):
160 """get size and write EF.PLMNwAcT, See note in update_hplmn_act()"""
161 data = self._scc.read_binary(EF['PLMNwAcT'], length=None, offset=0)
162 size = len(data[0]) // 2
163 hplmn = enc_plmn(mcc, mnc)
164 content = hplmn + access_tech
165 data, sw = self._scc.update_binary(
166 EF['PLMNwAcT'], content + 'ffffff0000' * (size // 5 - 1))
167 return sw
Philipp Maierc8ce82a2018-07-04 17:57:20 +0200168
Harald Weltec91085e2022-02-10 18:05:45 +0100169 def update_plmnsel(self, mcc, mnc):
170 data = self._scc.read_binary(EF['PLMNsel'], length=None, offset=0)
171 size = len(data[0]) // 2
172 hplmn = enc_plmn(mcc, mnc)
173 data, sw = self._scc.update_binary(
174 EF['PLMNsel'], hplmn + 'ff' * (size-3))
175 return sw
Philipp Maier5bf42602018-07-11 23:23:40 +0200176
Harald Weltec91085e2022-02-10 18:05:45 +0100177 def update_smsp(self, smsp):
178 data, sw = self._scc.update_record(EF['SMSP'], 1, rpad(smsp, 84))
179 return sw
Alexander Chemeriseb6807d2017-07-18 17:04:38 +0300180
Philipp Maier284ac102023-01-17 14:26:56 +0100181 def update_ad(self, mnc=None, opmode=None, ofm=None, path=EF['AD']):
Harald Weltec91085e2022-02-10 18:05:45 +0100182 """
183 Update Administrative Data (AD)
Philipp Maieree908ae2019-03-21 16:21:12 +0100184
Harald Weltec91085e2022-02-10 18:05:45 +0100185 See Sec. "4.2.18 EF_AD (Administrative Data)"
186 in 3GPP TS 31.102 for the details of the EF_AD contents.
Philipp Maier7f9f64a2020-05-11 21:28:52 +0200187
Harald Weltec91085e2022-02-10 18:05:45 +0100188 Set any parameter to None to keep old value(s) on card.
Philipp Maier7f9f64a2020-05-11 21:28:52 +0200189
Harald Weltec91085e2022-02-10 18:05:45 +0100190 Parameters:
191 mnc (str): MNC of IMSI
192 opmode (Hex-str, 1 Byte): MS Operation Mode
193 ofm (Hex-str, 1 Byte): Operational Feature Monitor (OFM) aka Ciphering Indicator
Philipp Maier284ac102023-01-17 14:26:56 +0100194 path (optional list with file path e.g. ['3f00', '7f20', '6fad'])
Robert Falkenbergd0505bd2021-02-24 14:06:18 +0100195
Harald Weltec91085e2022-02-10 18:05:45 +0100196 Returns:
197 str: Return code of write operation
198 """
Robert Falkenbergd0505bd2021-02-24 14:06:18 +0100199
Harald Weltec91085e2022-02-10 18:05:45 +0100200 ad = EF_AD()
Robert Falkenbergd0505bd2021-02-24 14:06:18 +0100201
Harald Weltec91085e2022-02-10 18:05:45 +0100202 # read from card
203 raw_hex_data, sw = self._scc.read_binary(
Philipp Maier284ac102023-01-17 14:26:56 +0100204 path, length=None, offset=0)
Harald Weltec91085e2022-02-10 18:05:45 +0100205 abstract_data = ad.decode_hex(raw_hex_data)
Robert Falkenbergd0505bd2021-02-24 14:06:18 +0100206
Harald Weltec91085e2022-02-10 18:05:45 +0100207 # perform updates
208 if mnc and abstract_data['extensions']:
Philipp Maier0a8d9f02022-12-16 16:44:37 +0100209 # Note: Since we derive the length of the MNC by the string length
210 # of the mnc parameter, the caller must ensure that mnc has the
211 # correct length and is padded with zeros (if necessary).
Harald Weltec91085e2022-02-10 18:05:45 +0100212 mnclen = len(str(mnc))
Philipp Maier0a8d9f02022-12-16 16:44:37 +0100213 if mnclen > 3 or mnclen < 2:
214 raise RuntimeError('invalid length of mnc "{}", expecting 2 or 3 digits'.format(mnc))
Harald Weltec91085e2022-02-10 18:05:45 +0100215 abstract_data['extensions']['mnc_len'] = mnclen
216 if opmode:
217 opmode_num = int(opmode, 16)
218 if opmode_num in [int(v) for v in EF_AD.OP_MODE]:
219 abstract_data['ms_operation_mode'] = opmode_num
220 else:
221 raise RuntimeError('invalid opmode "{}"'.format(opmode))
222 if ofm:
223 abstract_data['ofm'] = bool(int(ofm, 16))
Robert Falkenbergd0505bd2021-02-24 14:06:18 +0100224
Harald Weltec91085e2022-02-10 18:05:45 +0100225 # write to card
226 raw_hex_data = ad.encode_hex(abstract_data)
Philipp Maier284ac102023-01-17 14:26:56 +0100227 data, sw = self._scc.update_binary(path, raw_hex_data)
Harald Weltec91085e2022-02-10 18:05:45 +0100228 return sw
Philipp Maieree908ae2019-03-21 16:21:12 +0100229
Harald Weltec91085e2022-02-10 18:05:45 +0100230 def read_spn(self):
231 (content, sw) = self._scc.read_binary(EF['SPN'])
232 if sw == '9000':
233 abstract_data = EF_SPN().decode_hex(content)
234 show_in_hplmn = abstract_data['show_in_hplmn']
235 hide_in_oplmn = abstract_data['hide_in_oplmn']
236 name = abstract_data['spn']
237 return ((name, show_in_hplmn, hide_in_oplmn), sw)
238 else:
239 return (None, sw)
Alexander Chemeriseb6807d2017-07-18 17:04:38 +0300240
Harald Weltec91085e2022-02-10 18:05:45 +0100241 def update_spn(self, name="", show_in_hplmn=False, hide_in_oplmn=False):
242 abstract_data = {
243 'hide_in_oplmn': hide_in_oplmn,
244 'show_in_hplmn': show_in_hplmn,
245 'spn': name,
246 }
247 content = EF_SPN().encode_hex(abstract_data)
248 data, sw = self._scc.update_binary(EF['SPN'], content)
249 return sw
Alexander Chemeriseb6807d2017-07-18 17:04:38 +0300250
Harald Weltec91085e2022-02-10 18:05:45 +0100251 def read_binary(self, ef, length=None, offset=0):
252 ef_path = ef in EF and EF[ef] or ef
253 return self._scc.read_binary(ef_path, length, offset)
Supreeth Herled21349a2020-04-01 08:37:47 +0200254
Harald Weltec91085e2022-02-10 18:05:45 +0100255 def read_record(self, ef, rec_no):
256 ef_path = ef in EF and EF[ef] or ef
257 return self._scc.read_record(ef_path, rec_no)
Supreeth Herlead10d662020-04-01 08:43:08 +0200258
Harald Weltec91085e2022-02-10 18:05:45 +0100259 def read_gid1(self):
260 (res, sw) = self._scc.read_binary(EF['GID1'])
261 if sw == '9000':
262 return (res, sw)
263 else:
264 return (None, sw)
Supreeth Herle98a69272020-03-18 12:14:48 +0100265
Harald Weltec91085e2022-02-10 18:05:45 +0100266 def read_msisdn(self):
267 (res, sw) = self._scc.read_record(EF['MSISDN'], 1)
268 if sw == '9000':
269 return (dec_msisdn(res), sw)
270 else:
271 return (None, sw)
Supreeth Herle6d66af62020-03-19 12:49:16 +0100272
Harald Weltec91085e2022-02-10 18:05:45 +0100273 def read_aids(self):
274 """Fetch all the AIDs present on UICC"""
275 self._aids = []
276 try:
277 # Find out how many records the EF.DIR has
278 # and store all the AIDs in the UICC
279 rec_cnt = self._scc.record_count(EF['DIR'])
280 for i in range(0, rec_cnt):
281 rec = self._scc.read_record(EF['DIR'], i + 1)
282 if (rec[0][0:2], rec[0][4:6]) == ('61', '4f') and len(rec[0]) > 12 \
283 and rec[0][8:8 + int(rec[0][6:8], 16) * 2] not in self._aids:
284 self._aids.append(rec[0][8:8 + int(rec[0][6:8], 16) * 2])
285 except Exception as e:
286 print("Can't read AIDs from SIM -- %s" % (str(e),))
287 self._aids = []
288 return self._aids
Supreeth Herlee4e98312020-03-18 11:33:14 +0100289
Harald Weltec91085e2022-02-10 18:05:45 +0100290 @staticmethod
291 def _get_aid(adf="usim") -> str:
292 aid_map = {}
293 # First (known) halves of the U/ISIM AID
294 aid_map["usim"] = "a0000000871002"
295 aid_map["isim"] = "a0000000871004"
296 adf = adf.lower()
297 if adf in aid_map:
298 return aid_map[adf]
299 return None
Philipp Maier46c61542021-11-16 16:36:50 +0100300
Harald Weltec91085e2022-02-10 18:05:45 +0100301 def _complete_aid(self, aid) -> str:
302 """find the complete version of an ADF.U/ISIM AID"""
303 # Find full AID by partial AID:
304 if is_hex(aid):
305 for aid_known in self._aids:
306 if len(aid_known) >= len(aid) and aid == aid_known[0:len(aid)]:
307 return aid_known
308 return None
Philipp Maier46c61542021-11-16 16:36:50 +0100309
Harald Weltec91085e2022-02-10 18:05:45 +0100310 def select_adf_by_aid(self, adf="usim"):
311 """Select ADF.U/ISIM in the Card using its full AID"""
312 if is_hex(adf):
313 aid = adf
314 else:
315 aid = self._get_aid(adf)
316 if aid:
317 aid_full = self._complete_aid(aid)
318 if aid_full:
319 return self._scc.select_adf(aid_full)
320 else:
321 # If we cannot get the full AID, try with short AID
322 return self._scc.select_adf(aid)
323 return (None, None)
Supreeth Herlef9f3e5e2020-03-22 08:04:59 +0100324
Harald Weltec91085e2022-02-10 18:05:45 +0100325 def erase_binary(self, ef):
326 """Erase the contents of a file"""
327 len = self._scc.binary_size(ef)
328 self._scc.update_binary(ef, "ff" * len, offset=0, verify=True)
Philipp Maier5c2cc662020-05-12 16:27:12 +0200329
Harald Weltec91085e2022-02-10 18:05:45 +0100330 def erase_record(self, ef, rec_no):
331 """Erase the contents of a single record"""
332 len = self._scc.record_size(ef)
333 self._scc.update_record(ef, rec_no, "ff" * len,
334 force_len=False, verify=True)
Philipp Maier5c2cc662020-05-12 16:27:12 +0200335
Harald Weltec91085e2022-02-10 18:05:45 +0100336 def set_apdu_parameter(self, cla, sel_ctrl):
337 """Set apdu parameters (class byte and selection control bytes)"""
338 self._scc.cla_byte = cla
339 self._scc.sel_ctrl = sel_ctrl
Philipp Maier30b225f2021-10-29 16:41:46 +0200340
Harald Weltec91085e2022-02-10 18:05:45 +0100341 def get_apdu_parameter(self):
342 """Get apdu parameters (class byte and selection control bytes)"""
343 return (self._scc.cla_byte, self._scc.sel_ctrl)
344
Philipp Maier30b225f2021-10-29 16:41:46 +0200345
Philipp Maierbb73e512021-05-05 16:14:00 +0200346class UsimCard(SimCard):
Philipp Maierfc5f28d2021-05-05 12:18:41 +0200347
Harald Weltec91085e2022-02-10 18:05:45 +0100348 name = 'USIM'
Philipp Maierfc5f28d2021-05-05 12:18:41 +0200349
Harald Weltec91085e2022-02-10 18:05:45 +0100350 def __init__(self, ssc):
351 super(UsimCard, self).__init__(ssc)
Harald Welteca673942020-06-03 15:19:40 +0200352
Philipp Maierbda52832022-06-14 16:18:12 +0200353 # See also: ETSI TS 102 221, Table 9.3
354 self._adm_chv_num = 0xA0
355
Harald Weltec91085e2022-02-10 18:05:45 +0100356 def read_ehplmn(self):
357 (res, sw) = self._scc.read_binary(EF_USIM_ADF_map['EHPLMN'])
358 if sw == '9000':
359 return (format_xplmn(res), sw)
360 else:
361 return (None, sw)
Harald Welteca673942020-06-03 15:19:40 +0200362
Harald Weltec91085e2022-02-10 18:05:45 +0100363 def update_ehplmn(self, mcc, mnc):
364 data = self._scc.read_binary(
365 EF_USIM_ADF_map['EHPLMN'], length=None, offset=0)
366 size = len(data[0]) // 2
367 ehplmn = enc_plmn(mcc, mnc)
368 data, sw = self._scc.update_binary(EF_USIM_ADF_map['EHPLMN'], ehplmn)
369 return sw
Harald Welteca673942020-06-03 15:19:40 +0200370
Harald Weltec91085e2022-02-10 18:05:45 +0100371 def read_epdgid(self):
372 (res, sw) = self._scc.read_binary(EF_USIM_ADF_map['ePDGId'])
373 if sw == '9000':
374 try:
375 addr, addr_type = dec_addr_tlv(res)
376 except:
377 addr = None
378 addr_type = None
379 return (format_addr(addr, addr_type), sw)
380 else:
381 return (None, sw)
herlesupreethf8232db2020-09-29 10:03:06 +0200382
Harald Weltec91085e2022-02-10 18:05:45 +0100383 def update_epdgid(self, epdgid):
384 size = self._scc.binary_size(EF_USIM_ADF_map['ePDGId']) * 2
385 if len(epdgid) > 0:
386 addr_type = get_addr_type(epdgid)
387 if addr_type == None:
388 raise ValueError(
389 "Unknown ePDG Id address type or invalid address provided")
390 epdgid_tlv = rpad(enc_addr_tlv(epdgid, ('%02x' % addr_type)), size)
391 else:
392 epdgid_tlv = rpad('ff', size)
393 data, sw = self._scc.update_binary(
394 EF_USIM_ADF_map['ePDGId'], epdgid_tlv)
395 return sw
Harald Welteca673942020-06-03 15:19:40 +0200396
Harald Weltec91085e2022-02-10 18:05:45 +0100397 def read_ePDGSelection(self):
398 (res, sw) = self._scc.read_binary(EF_USIM_ADF_map['ePDGSelection'])
399 if sw == '9000':
400 return (format_ePDGSelection(res), sw)
401 else:
402 return (None, sw)
Supreeth Herle99d55552020-03-24 13:03:43 +0100403
Harald Weltec91085e2022-02-10 18:05:45 +0100404 def update_ePDGSelection(self, mcc, mnc):
405 (res, sw) = self._scc.read_binary(
406 EF_USIM_ADF_map['ePDGSelection'], length=None, offset=0)
407 if sw == '9000' and (len(mcc) == 0 or len(mnc) == 0):
408 # Reset contents
409 # 80 - Tag value
410 (res, sw) = self._scc.update_binary(
411 EF_USIM_ADF_map['ePDGSelection'], rpad('', len(res)))
412 elif sw == '9000':
413 (res, sw) = self._scc.update_binary(
414 EF_USIM_ADF_map['ePDGSelection'], enc_ePDGSelection(res, mcc, mnc))
415 return sw
Supreeth Herlef964df42020-03-24 13:15:37 +0100416
Harald Weltec91085e2022-02-10 18:05:45 +0100417 def read_ust(self):
418 (res, sw) = self._scc.read_binary(EF_USIM_ADF_map['UST'])
419 if sw == '9000':
420 # Print those which are available
421 return ([res, dec_st(res, table="usim")], sw)
422 else:
423 return ([None, None], sw)
herlesupreeth4a3580b2020-09-29 10:11:36 +0200424
Harald Weltec91085e2022-02-10 18:05:45 +0100425 def update_ust(self, service, bit=1):
426 (res, sw) = self._scc.read_binary(EF_USIM_ADF_map['UST'])
427 if sw == '9000':
428 content = enc_st(res, service, bit)
429 (res, sw) = self._scc.update_binary(
430 EF_USIM_ADF_map['UST'], content)
431 return sw
432
Harald Welte6ca2fa72022-02-12 16:29:31 +0100433 def update_est(self, service, bit=1):
434 (res, sw) = self._scc.read_binary(EF_USIM_ADF_map['EST'])
435 if sw == '9000':
436 content = enc_st(res, service, bit)
437 (res, sw) = self._scc.update_binary(
438 EF_USIM_ADF_map['EST'], content)
439 return sw
440
441
Supreeth Herleacc222f2020-03-24 13:26:53 +0100442
Philipp Maierbb73e512021-05-05 16:14:00 +0200443class IsimCard(SimCard):
Philipp Maierfc5f28d2021-05-05 12:18:41 +0200444
Harald Weltec91085e2022-02-10 18:05:45 +0100445 name = 'ISIM'
Philipp Maierfc5f28d2021-05-05 12:18:41 +0200446
Harald Weltec91085e2022-02-10 18:05:45 +0100447 def __init__(self, ssc):
448 super(IsimCard, self).__init__(ssc)
herlesupreethecbada92020-12-23 09:24:29 +0100449
Harald Weltec91085e2022-02-10 18:05:45 +0100450 def read_pcscf(self):
451 rec_cnt = self._scc.record_count(EF_ISIM_ADF_map['PCSCF'])
452 pcscf_recs = ""
453 for i in range(0, rec_cnt):
454 (res, sw) = self._scc.read_record(EF_ISIM_ADF_map['PCSCF'], i + 1)
455 if sw == '9000':
456 try:
457 addr, addr_type = dec_addr_tlv(res)
458 except:
459 addr = None
460 addr_type = None
461 content = format_addr(addr, addr_type)
462 pcscf_recs += "%s" % (len(content)
463 and content or '\tNot available\n')
464 else:
465 pcscf_recs += "\tP-CSCF: Can't read, response code = %s\n" % (
466 sw)
467 return pcscf_recs
Supreeth Herle5ad9aec2020-03-24 17:26:40 +0100468
Harald Weltec91085e2022-02-10 18:05:45 +0100469 def update_pcscf(self, pcscf):
470 if len(pcscf) > 0:
471 addr_type = get_addr_type(pcscf)
472 if addr_type == None:
473 raise ValueError(
474 "Unknown PCSCF address type or invalid address provided")
475 content = enc_addr_tlv(pcscf, ('%02x' % addr_type))
476 else:
477 # Just the tag value
478 content = '80'
479 rec_size_bytes = self._scc.record_size(EF_ISIM_ADF_map['PCSCF'])
480 pcscf_tlv = rpad(content, rec_size_bytes*2)
481 data, sw = self._scc.update_record(
482 EF_ISIM_ADF_map['PCSCF'], 1, pcscf_tlv)
483 return sw
Supreeth Herlecf727f22020-03-24 17:32:21 +0100484
Harald Weltec91085e2022-02-10 18:05:45 +0100485 def read_domain(self):
486 (res, sw) = self._scc.read_binary(EF_ISIM_ADF_map['DOMAIN'])
487 if sw == '9000':
488 # Skip the initial tag value ('80') byte and get length of contents
489 length = int(res[2:4], 16)
490 content = h2s(res[4:4+(length*2)])
491 return (content, sw)
492 else:
493 return (None, sw)
Supreeth Herle05b28072020-03-25 10:23:48 +0100494
Harald Weltec91085e2022-02-10 18:05:45 +0100495 def update_domain(self, domain=None, mcc=None, mnc=None):
496 hex_str = ""
497 if domain:
498 hex_str = s2h(domain)
499 elif mcc and mnc:
500 # MCC and MNC always has 3 digits in domain form
501 plmn_str = 'mnc' + lpad(mnc, 3, "0") + '.mcc' + lpad(mcc, 3, "0")
502 hex_str = s2h('ims.' + plmn_str + '.3gppnetwork.org')
Supreeth Herle79f43dd2020-03-25 11:43:19 +0100503
Harald Weltec91085e2022-02-10 18:05:45 +0100504 # Build TLV
505 tlv = TLV(['80'])
506 content = tlv.build({'80': hex_str})
Supreeth Herle79f43dd2020-03-25 11:43:19 +0100507
Harald Weltec91085e2022-02-10 18:05:45 +0100508 bin_size_bytes = self._scc.binary_size(EF_ISIM_ADF_map['DOMAIN'])
509 data, sw = self._scc.update_binary(
510 EF_ISIM_ADF_map['DOMAIN'], rpad(content, bin_size_bytes*2))
511 return sw
Supreeth Herle79f43dd2020-03-25 11:43:19 +0100512
Harald Weltec91085e2022-02-10 18:05:45 +0100513 def read_impi(self):
514 (res, sw) = self._scc.read_binary(EF_ISIM_ADF_map['IMPI'])
515 if sw == '9000':
516 # Skip the initial tag value ('80') byte and get length of contents
517 length = int(res[2:4], 16)
518 content = h2s(res[4:4+(length*2)])
519 return (content, sw)
520 else:
521 return (None, sw)
Supreeth Herle3f67f9c2020-03-25 15:38:02 +0100522
Harald Weltec91085e2022-02-10 18:05:45 +0100523 def update_impi(self, impi=None):
524 hex_str = ""
525 if impi:
526 hex_str = s2h(impi)
527 # Build TLV
528 tlv = TLV(['80'])
529 content = tlv.build({'80': hex_str})
Supreeth Herlea5bd9682020-03-26 09:16:14 +0100530
Harald Weltec91085e2022-02-10 18:05:45 +0100531 bin_size_bytes = self._scc.binary_size(EF_ISIM_ADF_map['IMPI'])
532 data, sw = self._scc.update_binary(
533 EF_ISIM_ADF_map['IMPI'], rpad(content, bin_size_bytes*2))
534 return sw
Supreeth Herlea5bd9682020-03-26 09:16:14 +0100535
Harald Weltec91085e2022-02-10 18:05:45 +0100536 def read_impu(self):
537 rec_cnt = self._scc.record_count(EF_ISIM_ADF_map['IMPU'])
538 impu_recs = ""
539 for i in range(0, rec_cnt):
540 (res, sw) = self._scc.read_record(EF_ISIM_ADF_map['IMPU'], i + 1)
541 if sw == '9000':
542 # Skip the initial tag value ('80') byte and get length of contents
543 length = int(res[2:4], 16)
544 content = h2s(res[4:4+(length*2)])
545 impu_recs += "\t%s\n" % (len(content)
546 and content or 'Not available')
547 else:
548 impu_recs += "IMS public user identity: Can't read, response code = %s\n" % (
549 sw)
550 return impu_recs
Supreeth Herle0c02d8a2020-03-26 09:00:06 +0100551
Harald Weltec91085e2022-02-10 18:05:45 +0100552 def update_impu(self, impu=None):
553 hex_str = ""
554 if impu:
555 hex_str = s2h(impu)
556 # Build TLV
557 tlv = TLV(['80'])
558 content = tlv.build({'80': hex_str})
Supreeth Herlebe7007e2020-03-26 09:27:45 +0100559
Harald Weltec91085e2022-02-10 18:05:45 +0100560 rec_size_bytes = self._scc.record_size(EF_ISIM_ADF_map['IMPU'])
561 impu_tlv = rpad(content, rec_size_bytes*2)
562 data, sw = self._scc.update_record(
563 EF_ISIM_ADF_map['IMPU'], 1, impu_tlv)
564 return sw
Supreeth Herlebe7007e2020-03-26 09:27:45 +0100565
Harald Weltec91085e2022-02-10 18:05:45 +0100566 def read_iari(self):
567 rec_cnt = self._scc.record_count(EF_ISIM_ADF_map['UICCIARI'])
568 uiari_recs = ""
569 for i in range(0, rec_cnt):
570 (res, sw) = self._scc.read_record(
571 EF_ISIM_ADF_map['UICCIARI'], i + 1)
572 if sw == '9000':
573 # Skip the initial tag value ('80') byte and get length of contents
574 length = int(res[2:4], 16)
575 content = h2s(res[4:4+(length*2)])
576 uiari_recs += "\t%s\n" % (len(content)
577 and content or 'Not available')
578 else:
579 uiari_recs += "UICC IARI: Can't read, response code = %s\n" % (
580 sw)
581 return uiari_recs
582
Harald Welte6ca2fa72022-02-12 16:29:31 +0100583 def update_ist(self, service, bit=1):
584 (res, sw) = self._scc.read_binary(EF_ISIM_ADF_map['IST'])
585 if sw == '9000':
586 content = enc_st(res, service, bit)
587 (res, sw) = self._scc.update_binary(
588 EF_ISIM_ADF_map['IST'], content)
589 return sw
590
Sylvain Munaut76504e02010-12-07 00:24:32 +0100591
Philipp Maierbb73e512021-05-05 16:14:00 +0200592class MagicSimBase(abc.ABC, SimCard):
Harald Weltec91085e2022-02-10 18:05:45 +0100593 """
594 Theses cards uses several record based EFs to store the provider infos,
595 each possible provider uses a specific record number in each EF. The
596 indexes used are ( where N is the number of providers supported ) :
597 - [2 .. N+1] for the operator name
598 - [1 .. N] for the programmable EFs
Sylvain Munaut76504e02010-12-07 00:24:32 +0100599
Harald Weltec91085e2022-02-10 18:05:45 +0100600 * 3f00/7f4d/8f0c : Operator Name
Sylvain Munaut76504e02010-12-07 00:24:32 +0100601
Harald Weltec91085e2022-02-10 18:05:45 +0100602 bytes 0-15 : provider name, padded with 0xff
603 byte 16 : length of the provider name
604 byte 17 : 01 for valid records, 00 otherwise
Sylvain Munaut76504e02010-12-07 00:24:32 +0100605
Harald Weltec91085e2022-02-10 18:05:45 +0100606 * 3f00/7f4d/8f0d : Programmable Binary EFs
Sylvain Munaut76504e02010-12-07 00:24:32 +0100607
Harald Weltec91085e2022-02-10 18:05:45 +0100608 * 3f00/7f4d/8f0e : Programmable Record EFs
Sylvain Munaut76504e02010-12-07 00:24:32 +0100609
Harald Weltec91085e2022-02-10 18:05:45 +0100610 """
Sylvain Munaut76504e02010-12-07 00:24:32 +0100611
Harald Weltec91085e2022-02-10 18:05:45 +0100612 _files = {} # type: Dict[str, Tuple[str, int, bool]]
613 _ki_file = None # type: Optional[str]
Vadim Yanitskiy03c67f72021-05-02 02:10:39 +0200614
Harald Weltec91085e2022-02-10 18:05:45 +0100615 @classmethod
616 def autodetect(kls, scc):
617 try:
618 for p, l, t in kls._files.values():
619 if not t:
620 continue
621 if scc.record_size(['3f00', '7f4d', p]) != l:
622 return None
623 except:
624 return None
Sylvain Munaut76504e02010-12-07 00:24:32 +0100625
Harald Weltec91085e2022-02-10 18:05:45 +0100626 return kls(scc)
Sylvain Munaut76504e02010-12-07 00:24:32 +0100627
Harald Weltec91085e2022-02-10 18:05:45 +0100628 def _get_count(self):
629 """
630 Selects the file and returns the total number of entries
631 and entry size
632 """
633 f = self._files['name']
Sylvain Munaut76504e02010-12-07 00:24:32 +0100634
Harald Weltec91085e2022-02-10 18:05:45 +0100635 r = self._scc.select_path(['3f00', '7f4d', f[0]])
636 rec_len = int(r[-1][28:30], 16)
637 tlen = int(r[-1][4:8], 16)
638 rec_cnt = (tlen // rec_len) - 1
Sylvain Munaut76504e02010-12-07 00:24:32 +0100639
Harald Weltec91085e2022-02-10 18:05:45 +0100640 if (rec_cnt < 1) or (rec_len != f[1]):
641 raise RuntimeError('Bad card type')
Sylvain Munaut76504e02010-12-07 00:24:32 +0100642
Harald Weltec91085e2022-02-10 18:05:45 +0100643 return rec_cnt
Sylvain Munaut76504e02010-12-07 00:24:32 +0100644
Harald Weltec91085e2022-02-10 18:05:45 +0100645 def program(self, p):
646 # Go to dir
647 self._scc.select_path(['3f00', '7f4d'])
Sylvain Munaut76504e02010-12-07 00:24:32 +0100648
Harald Weltec91085e2022-02-10 18:05:45 +0100649 # Home PLMN in PLMN_Sel format
650 hplmn = enc_plmn(p['mcc'], p['mnc'])
Sylvain Munaut76504e02010-12-07 00:24:32 +0100651
Harald Weltec91085e2022-02-10 18:05:45 +0100652 # Operator name ( 3f00/7f4d/8f0c )
653 self._scc.update_record(self._files['name'][0], 2,
654 rpad(b2h(p['name']), 32) + ('%02x' %
655 len(p['name'])) + '01'
656 )
Sylvain Munaut76504e02010-12-07 00:24:32 +0100657
Harald Weltec91085e2022-02-10 18:05:45 +0100658 # ICCID/IMSI/Ki/HPLMN ( 3f00/7f4d/8f0d )
659 v = ''
Sylvain Munaut76504e02010-12-07 00:24:32 +0100660
Harald Weltec91085e2022-02-10 18:05:45 +0100661 # inline Ki
662 if self._ki_file is None:
663 v += p['ki']
Sylvain Munaut76504e02010-12-07 00:24:32 +0100664
Harald Weltec91085e2022-02-10 18:05:45 +0100665 # ICCID
666 v += '3f00' + '2fe2' + '0a' + enc_iccid(p['iccid'])
Sylvain Munaut76504e02010-12-07 00:24:32 +0100667
Harald Weltec91085e2022-02-10 18:05:45 +0100668 # IMSI
669 v += '7f20' + '6f07' + '09' + enc_imsi(p['imsi'])
Sylvain Munaut76504e02010-12-07 00:24:32 +0100670
Harald Weltec91085e2022-02-10 18:05:45 +0100671 # Ki
672 if self._ki_file:
673 v += self._ki_file + '10' + p['ki']
Sylvain Munaut76504e02010-12-07 00:24:32 +0100674
Harald Weltec91085e2022-02-10 18:05:45 +0100675 # PLMN_Sel
676 v += '6f30' + '18' + rpad(hplmn, 36)
Sylvain Munaut76504e02010-12-07 00:24:32 +0100677
Harald Weltec91085e2022-02-10 18:05:45 +0100678 # ACC
679 # This doesn't work with "fake" SuperSIM cards,
680 # but will hopefully work with real SuperSIMs.
681 if p.get('acc') is not None:
682 v += '6f78' + '02' + lpad(p['acc'], 4)
Alexander Chemeris21885242013-07-02 16:56:55 +0400683
Harald Weltec91085e2022-02-10 18:05:45 +0100684 self._scc.update_record(self._files['b_ef'][0], 1,
685 rpad(v, self._files['b_ef'][1]*2)
686 )
Sylvain Munaut76504e02010-12-07 00:24:32 +0100687
Harald Weltec91085e2022-02-10 18:05:45 +0100688 # SMSP ( 3f00/7f4d/8f0e )
689 # FIXME
Sylvain Munaut76504e02010-12-07 00:24:32 +0100690
Harald Weltec91085e2022-02-10 18:05:45 +0100691 # Write PLMN_Sel forcefully as well
692 r = self._scc.select_path(['3f00', '7f20', '6f30'])
693 tl = int(r[-1][4:8], 16)
Sylvain Munaut76504e02010-12-07 00:24:32 +0100694
Harald Weltec91085e2022-02-10 18:05:45 +0100695 hplmn = enc_plmn(p['mcc'], p['mnc'])
696 self._scc.update_binary('6f30', hplmn + 'ff' * (tl-3))
Sylvain Munaut76504e02010-12-07 00:24:32 +0100697
Harald Weltec91085e2022-02-10 18:05:45 +0100698 def erase(self):
699 # Dummy
700 df = {}
701 for k, v in self._files.items():
702 ofs = 1
703 fv = v[1] * 'ff'
704 if k == 'name':
705 ofs = 2
706 fv = fv[0:-4] + '0000'
707 df[v[0]] = (fv, ofs)
Sylvain Munaut76504e02010-12-07 00:24:32 +0100708
Harald Weltec91085e2022-02-10 18:05:45 +0100709 # Write
710 for n in range(0, self._get_count()):
711 for k, (msg, ofs) in df.items():
712 self._scc.update_record(['3f00', '7f4d', k], n + ofs, msg)
Sylvain Munaut76504e02010-12-07 00:24:32 +0100713
714
Vadim Yanitskiy85302d62021-05-02 02:18:42 +0200715class SuperSim(MagicSimBase):
Sylvain Munaut76504e02010-12-07 00:24:32 +0100716
Harald Weltec91085e2022-02-10 18:05:45 +0100717 name = 'supersim'
Sylvain Munaut76504e02010-12-07 00:24:32 +0100718
Harald Weltec91085e2022-02-10 18:05:45 +0100719 _files = {
720 'name': ('8f0c', 18, True),
721 'b_ef': ('8f0d', 74, True),
722 'r_ef': ('8f0e', 50, True),
723 }
Sylvain Munaut76504e02010-12-07 00:24:32 +0100724
Harald Weltec91085e2022-02-10 18:05:45 +0100725 _ki_file = None
Sylvain Munaut76504e02010-12-07 00:24:32 +0100726
727
Vadim Yanitskiy85302d62021-05-02 02:18:42 +0200728class MagicSim(MagicSimBase):
Sylvain Munaut76504e02010-12-07 00:24:32 +0100729
Harald Weltec91085e2022-02-10 18:05:45 +0100730 name = 'magicsim'
Sylvain Munaut76504e02010-12-07 00:24:32 +0100731
Harald Weltec91085e2022-02-10 18:05:45 +0100732 _files = {
733 'name': ('8f0c', 18, True),
734 'b_ef': ('8f0d', 130, True),
735 'r_ef': ('8f0e', 102, False),
736 }
Sylvain Munaut76504e02010-12-07 00:24:32 +0100737
Harald Weltec91085e2022-02-10 18:05:45 +0100738 _ki_file = '6f1b'
Sylvain Munaut76504e02010-12-07 00:24:32 +0100739
740
Philipp Maierbb73e512021-05-05 16:14:00 +0200741class FakeMagicSim(SimCard):
Harald Weltec91085e2022-02-10 18:05:45 +0100742 """
743 Theses cards have a record based EF 3f00/000c that contains the provider
744 information. See the program method for its format. The records go from
745 1 to N.
746 """
Sylvain Munaut76504e02010-12-07 00:24:32 +0100747
Harald Weltec91085e2022-02-10 18:05:45 +0100748 name = 'fakemagicsim'
Sylvain Munaut76504e02010-12-07 00:24:32 +0100749
Harald Weltec91085e2022-02-10 18:05:45 +0100750 @classmethod
751 def autodetect(kls, scc):
752 try:
753 if scc.record_size(['3f00', '000c']) != 0x5a:
754 return None
755 except:
756 return None
Sylvain Munaut76504e02010-12-07 00:24:32 +0100757
Harald Weltec91085e2022-02-10 18:05:45 +0100758 return kls(scc)
Sylvain Munaut76504e02010-12-07 00:24:32 +0100759
Harald Weltec91085e2022-02-10 18:05:45 +0100760 def _get_infos(self):
761 """
762 Selects the file and returns the total number of entries
763 and entry size
764 """
Sylvain Munaut76504e02010-12-07 00:24:32 +0100765
Harald Weltec91085e2022-02-10 18:05:45 +0100766 r = self._scc.select_path(['3f00', '000c'])
767 rec_len = int(r[-1][28:30], 16)
768 tlen = int(r[-1][4:8], 16)
769 rec_cnt = (tlen // rec_len) - 1
Sylvain Munaut76504e02010-12-07 00:24:32 +0100770
Harald Weltec91085e2022-02-10 18:05:45 +0100771 if (rec_cnt < 1) or (rec_len != 0x5a):
772 raise RuntimeError('Bad card type')
Sylvain Munaut76504e02010-12-07 00:24:32 +0100773
Harald Weltec91085e2022-02-10 18:05:45 +0100774 return rec_cnt, rec_len
Sylvain Munaut76504e02010-12-07 00:24:32 +0100775
Harald Weltec91085e2022-02-10 18:05:45 +0100776 def program(self, p):
777 # Home PLMN
778 r = self._scc.select_path(['3f00', '7f20', '6f30'])
779 tl = int(r[-1][4:8], 16)
Sylvain Munaut76504e02010-12-07 00:24:32 +0100780
Harald Weltec91085e2022-02-10 18:05:45 +0100781 hplmn = enc_plmn(p['mcc'], p['mnc'])
782 self._scc.update_binary('6f30', hplmn + 'ff' * (tl-3))
Sylvain Munaut76504e02010-12-07 00:24:32 +0100783
Harald Weltec91085e2022-02-10 18:05:45 +0100784 # Get total number of entries and entry size
785 rec_cnt, rec_len = self._get_infos()
Sylvain Munaut76504e02010-12-07 00:24:32 +0100786
Harald Weltec91085e2022-02-10 18:05:45 +0100787 # Set first entry
788 entry = (
789 '81' + # 1b Status: Valid & Active
790 rpad(s2h(p['name'][0:14]), 28) + # 14b Entry Name
791 enc_iccid(p['iccid']) + # 10b ICCID
792 enc_imsi(p['imsi']) + # 9b IMSI_len + id_type(9) + IMSI
793 p['ki'] + # 16b Ki
794 lpad(p['smsp'], 80) # 40b SMSP (padded with ff if needed)
795 )
796 self._scc.update_record('000c', 1, entry)
Sylvain Munaut76504e02010-12-07 00:24:32 +0100797
Harald Weltec91085e2022-02-10 18:05:45 +0100798 def erase(self):
799 # Get total number of entries and entry size
800 rec_cnt, rec_len = self._get_infos()
Sylvain Munaut76504e02010-12-07 00:24:32 +0100801
Harald Weltec91085e2022-02-10 18:05:45 +0100802 # Erase all entries
803 entry = 'ff' * rec_len
804 for i in range(0, rec_cnt):
805 self._scc.update_record('000c', 1+i, entry)
Sylvain Munaut76504e02010-12-07 00:24:32 +0100806
Sylvain Munaut5da8d4e2013-07-02 15:13:24 +0200807
Philipp Maierbb73e512021-05-05 16:14:00 +0200808class GrcardSim(SimCard):
Harald Weltec91085e2022-02-10 18:05:45 +0100809 """
810 Greencard (grcard.cn) HZCOS GSM SIM
811 These cards have a much more regular ISO 7816-4 / TS 11.11 structure,
812 and use standard UPDATE RECORD / UPDATE BINARY commands except for Ki.
813 """
Harald Welte3156d902011-03-22 21:48:19 +0100814
Harald Weltec91085e2022-02-10 18:05:45 +0100815 name = 'grcardsim'
Harald Welte3156d902011-03-22 21:48:19 +0100816
Harald Weltec91085e2022-02-10 18:05:45 +0100817 @classmethod
818 def autodetect(kls, scc):
819 return None
Harald Welte3156d902011-03-22 21:48:19 +0100820
Harald Weltec91085e2022-02-10 18:05:45 +0100821 def program(self, p):
822 # We don't really know yet what ADM PIN 4 is about
823 #self._scc.verify_chv(4, h2b("4444444444444444"))
Harald Welte3156d902011-03-22 21:48:19 +0100824
Harald Weltec91085e2022-02-10 18:05:45 +0100825 # Authenticate using ADM PIN 5
826 if p['pin_adm']:
827 pin = h2b(p['pin_adm'])
828 else:
829 pin = h2b("4444444444444444")
830 self._scc.verify_chv(5, pin)
Harald Welte3156d902011-03-22 21:48:19 +0100831
Harald Weltec91085e2022-02-10 18:05:45 +0100832 # EF.ICCID
833 r = self._scc.select_path(['3f00', '2fe2'])
834 data, sw = self._scc.update_binary('2fe2', enc_iccid(p['iccid']))
Harald Welte3156d902011-03-22 21:48:19 +0100835
Harald Weltec91085e2022-02-10 18:05:45 +0100836 # EF.IMSI
837 r = self._scc.select_path(['3f00', '7f20', '6f07'])
838 data, sw = self._scc.update_binary('6f07', enc_imsi(p['imsi']))
Harald Welte3156d902011-03-22 21:48:19 +0100839
Harald Weltec91085e2022-02-10 18:05:45 +0100840 # EF.ACC
841 if p.get('acc') is not None:
842 data, sw = self._scc.update_binary('6f78', lpad(p['acc'], 4))
Harald Welte3156d902011-03-22 21:48:19 +0100843
Harald Weltec91085e2022-02-10 18:05:45 +0100844 # EF.SMSP
845 if p.get('smsp'):
846 r = self._scc.select_path(['3f00', '7f10', '6f42'])
847 data, sw = self._scc.update_record('6f42', 1, lpad(p['smsp'], 80))
Harald Welte3156d902011-03-22 21:48:19 +0100848
Harald Weltec91085e2022-02-10 18:05:45 +0100849 # Set the Ki using proprietary command
850 pdu = '80d4020010' + p['ki']
851 data, sw = self._scc._tp.send_apdu(pdu)
Harald Welte3156d902011-03-22 21:48:19 +0100852
Harald Weltec91085e2022-02-10 18:05:45 +0100853 # EF.HPLMN
854 r = self._scc.select_path(['3f00', '7f20', '6f30'])
855 size = int(r[-1][4:8], 16)
856 hplmn = enc_plmn(p['mcc'], p['mnc'])
857 self._scc.update_binary('6f30', hplmn + 'ff' * (size-3))
Harald Welte3156d902011-03-22 21:48:19 +0100858
Harald Weltec91085e2022-02-10 18:05:45 +0100859 # EF.SPN (Service Provider Name)
860 r = self._scc.select_path(['3f00', '7f20', '6f30'])
861 size = int(r[-1][4:8], 16)
862 # FIXME
Harald Welte3156d902011-03-22 21:48:19 +0100863
Harald Weltec91085e2022-02-10 18:05:45 +0100864 # FIXME: EF.MSISDN
Harald Welte3156d902011-03-22 21:48:19 +0100865
Sylvain Munaut76504e02010-12-07 00:24:32 +0100866
Harald Weltee10394b2011-12-07 12:34:14 +0100867class SysmoSIMgr1(GrcardSim):
Harald Weltec91085e2022-02-10 18:05:45 +0100868 """
869 sysmocom sysmoSIM-GR1
870 These cards have a much more regular ISO 7816-4 / TS 11.11 structure,
871 and use standard UPDATE RECORD / UPDATE BINARY commands except for Ki.
872 """
873 name = 'sysmosim-gr1'
Harald Weltee10394b2011-12-07 12:34:14 +0100874
Harald Weltec91085e2022-02-10 18:05:45 +0100875 @classmethod
876 def autodetect(kls, scc):
877 try:
878 # Look for ATR
879 if scc.get_atr() == toBytes("3B 99 18 00 11 88 22 33 44 55 66 77 60"):
880 return kls(scc)
881 except:
882 return None
883 return None
884
Sylvain Munaut5da8d4e2013-07-02 15:13:24 +0200885
Harald Welteca673942020-06-03 15:19:40 +0200886class SysmoUSIMgr1(UsimCard):
Harald Weltec91085e2022-02-10 18:05:45 +0100887 """
888 sysmocom sysmoUSIM-GR1
889 """
890 name = 'sysmoUSIM-GR1'
Holger Hans Peter Freyther4d91bf42012-03-22 14:28:38 +0100891
Harald Weltec91085e2022-02-10 18:05:45 +0100892 @classmethod
893 def autodetect(kls, scc):
894 # TODO: Access the ATR
895 return None
Holger Hans Peter Freyther4d91bf42012-03-22 14:28:38 +0100896
Harald Weltec91085e2022-02-10 18:05:45 +0100897 def program(self, p):
898 # TODO: check if verify_chv could be used or what it needs
899 # self._scc.verify_chv(0x0A, [0x33,0x32,0x32,0x31,0x33,0x32,0x33,0x32])
900 # Unlock the card..
901 data, sw = self._scc._tp.send_apdu_checksw(
902 "0020000A083332323133323332")
Holger Hans Peter Freyther4d91bf42012-03-22 14:28:38 +0100903
Harald Weltec91085e2022-02-10 18:05:45 +0100904 # TODO: move into SimCardCommands
905 par = (p['ki'] + # 16b K
906 p['opc'] + # 32b OPC
907 enc_iccid(p['iccid']) + # 10b ICCID
908 enc_imsi(p['imsi']) # 9b IMSI_len + id_type(9) + IMSI
909 )
910 data, sw = self._scc._tp.send_apdu_checksw("0099000033" + par)
Holger Hans Peter Freyther4d91bf42012-03-22 14:28:38 +0100911
Sylvain Munaut053c8952013-07-02 15:12:32 +0200912
Philipp Maierbb73e512021-05-05 16:14:00 +0200913class SysmoSIMgr2(SimCard):
Harald Weltec91085e2022-02-10 18:05:45 +0100914 """
915 sysmocom sysmoSIM-GR2
916 """
Sylvain Munaut2fc205c2013-12-23 17:22:56 +0100917
Harald Weltec91085e2022-02-10 18:05:45 +0100918 name = 'sysmoSIM-GR2'
Sylvain Munaut2fc205c2013-12-23 17:22:56 +0100919
Harald Weltec91085e2022-02-10 18:05:45 +0100920 @classmethod
921 def autodetect(kls, scc):
922 try:
923 # Look for ATR
924 if scc.get_atr() == toBytes("3B 7D 94 00 00 55 55 53 0A 74 86 93 0B 24 7C 4D 54 68"):
925 return kls(scc)
926 except:
927 return None
928 return None
Sylvain Munaut2fc205c2013-12-23 17:22:56 +0100929
Harald Weltec91085e2022-02-10 18:05:45 +0100930 def program(self, p):
Sylvain Munaut2fc205c2013-12-23 17:22:56 +0100931
Harald Weltec91085e2022-02-10 18:05:45 +0100932 # select MF
933 r = self._scc.select_path(['3f00'])
Daniel Willmann5d8cd9b2020-10-19 11:01:49 +0200934
Harald Weltec91085e2022-02-10 18:05:45 +0100935 # authenticate as SUPER ADM using default key
936 self._scc.verify_chv(0x0b, h2b("3838383838383838"))
Sylvain Munaut2fc205c2013-12-23 17:22:56 +0100937
Harald Weltec91085e2022-02-10 18:05:45 +0100938 # set ADM pin using proprietary command
939 # INS: D4
940 # P1: 3A for PIN, 3B for PUK
941 # P2: CHV number, as in VERIFY CHV for PIN, and as in UNBLOCK CHV for PUK
942 # P3: 08, CHV length (curiously the PUK is also 08 length, instead of 10)
943 if p['pin_adm']:
944 pin = h2b(p['pin_adm'])
945 else:
946 pin = h2b("4444444444444444")
Jan Balkec3ebd332015-01-26 12:22:55 +0100947
Harald Weltec91085e2022-02-10 18:05:45 +0100948 pdu = 'A0D43A0508' + b2h(pin)
949 data, sw = self._scc._tp.send_apdu(pdu)
Daniel Willmann5d8cd9b2020-10-19 11:01:49 +0200950
Harald Weltec91085e2022-02-10 18:05:45 +0100951 # authenticate as ADM (enough to write file, and can set PINs)
Jan Balkec3ebd332015-01-26 12:22:55 +0100952
Harald Weltec91085e2022-02-10 18:05:45 +0100953 self._scc.verify_chv(0x05, pin)
Sylvain Munaut2fc205c2013-12-23 17:22:56 +0100954
Harald Weltec91085e2022-02-10 18:05:45 +0100955 # write EF.ICCID
956 data, sw = self._scc.update_binary('2fe2', enc_iccid(p['iccid']))
Sylvain Munaut2fc205c2013-12-23 17:22:56 +0100957
Harald Weltec91085e2022-02-10 18:05:45 +0100958 # select DF_GSM
959 r = self._scc.select_path(['7f20'])
Daniel Willmann5d8cd9b2020-10-19 11:01:49 +0200960
Harald Weltec91085e2022-02-10 18:05:45 +0100961 # write EF.IMSI
962 data, sw = self._scc.update_binary('6f07', enc_imsi(p['imsi']))
Sylvain Munaut2fc205c2013-12-23 17:22:56 +0100963
Harald Weltec91085e2022-02-10 18:05:45 +0100964 # write EF.ACC
965 if p.get('acc') is not None:
966 data, sw = self._scc.update_binary('6f78', lpad(p['acc'], 4))
Sylvain Munaut2fc205c2013-12-23 17:22:56 +0100967
Harald Weltec91085e2022-02-10 18:05:45 +0100968 # get size and write EF.HPLMN
969 r = self._scc.select_path(['6f30'])
970 size = int(r[-1][4:8], 16)
971 hplmn = enc_plmn(p['mcc'], p['mnc'])
972 self._scc.update_binary('6f30', hplmn + 'ff' * (size-3))
Sylvain Munaut2fc205c2013-12-23 17:22:56 +0100973
Harald Weltec91085e2022-02-10 18:05:45 +0100974 # set COMP128 version 0 in proprietary file
975 data, sw = self._scc.update_binary('0001', '001000')
Sylvain Munaut2fc205c2013-12-23 17:22:56 +0100976
Harald Weltec91085e2022-02-10 18:05:45 +0100977 # set Ki in proprietary file
978 data, sw = self._scc.update_binary('0001', p['ki'], 3)
Sylvain Munaut2fc205c2013-12-23 17:22:56 +0100979
Harald Weltec91085e2022-02-10 18:05:45 +0100980 # select DF_TELECOM
981 r = self._scc.select_path(['3f00', '7f10'])
Daniel Willmann5d8cd9b2020-10-19 11:01:49 +0200982
Harald Weltec91085e2022-02-10 18:05:45 +0100983 # write EF.SMSP
984 if p.get('smsp'):
985 data, sw = self._scc.update_record('6f42', 1, lpad(p['smsp'], 80))
Sylvain Munaut2fc205c2013-12-23 17:22:56 +0100986
Sylvain Munaut2fc205c2013-12-23 17:22:56 +0100987
Harald Welteca673942020-06-03 15:19:40 +0200988class SysmoUSIMSJS1(UsimCard):
Harald Weltec91085e2022-02-10 18:05:45 +0100989 """
990 sysmocom sysmoUSIM-SJS1
991 """
Jan Balke3e840672015-01-26 15:36:27 +0100992
Harald Weltec91085e2022-02-10 18:05:45 +0100993 name = 'sysmoUSIM-SJS1'
Jan Balke3e840672015-01-26 15:36:27 +0100994
Harald Weltec91085e2022-02-10 18:05:45 +0100995 def __init__(self, ssc):
996 super(SysmoUSIMSJS1, self).__init__(ssc)
997 self._scc.cla_byte = "00"
998 self._scc.sel_ctrl = "0004" # request an FCP
Jan Balke3e840672015-01-26 15:36:27 +0100999
Harald Weltec91085e2022-02-10 18:05:45 +01001000 @classmethod
1001 def autodetect(kls, scc):
1002 try:
1003 # Look for ATR
1004 if scc.get_atr() == toBytes("3B 9F 96 80 1F C7 80 31 A0 73 BE 21 13 67 43 20 07 18 00 00 01 A5"):
1005 return kls(scc)
1006 except:
1007 return None
1008 return None
Jan Balke3e840672015-01-26 15:36:27 +01001009
Harald Weltec91085e2022-02-10 18:05:45 +01001010 def verify_adm(self, key):
1011 # authenticate as ADM using default key (written on the card..)
1012 if not key:
1013 raise ValueError(
1014 "Please provide a PIN-ADM as there is no default one")
1015 (res, sw) = self._scc.verify_chv(0x0A, key)
1016 return sw
Harald Weltea6704252021-01-08 20:19:11 +01001017
Harald Weltec91085e2022-02-10 18:05:45 +01001018 def program(self, p):
1019 self.verify_adm(h2b(p['pin_adm']))
Jan Balke3e840672015-01-26 15:36:27 +01001020
Harald Weltec91085e2022-02-10 18:05:45 +01001021 # select MF
1022 r = self._scc.select_path(['3f00'])
Jan Balke3e840672015-01-26 15:36:27 +01001023
Harald Weltec91085e2022-02-10 18:05:45 +01001024 # write EF.ICCID
1025 data, sw = self._scc.update_binary('2fe2', enc_iccid(p['iccid']))
Philipp Maiere9604882017-03-21 17:24:31 +01001026
Harald Weltec91085e2022-02-10 18:05:45 +01001027 # select DF_GSM
1028 r = self._scc.select_path(['7f20'])
Jan Balke3e840672015-01-26 15:36:27 +01001029
Harald Weltec91085e2022-02-10 18:05:45 +01001030 # set Ki in proprietary file
1031 data, sw = self._scc.update_binary('00FF', p['ki'])
Jan Balke3e840672015-01-26 15:36:27 +01001032
Harald Weltec91085e2022-02-10 18:05:45 +01001033 # set OPc in proprietary file
1034 if 'opc' in p:
1035 content = "01" + p['opc']
1036 data, sw = self._scc.update_binary('00F7', content)
Jan Balke3e840672015-01-26 15:36:27 +01001037
Harald Weltec91085e2022-02-10 18:05:45 +01001038 # set Service Provider Name
1039 if p.get('name') is not None:
1040 self.update_spn(p['name'], True, True)
Supreeth Herle7947d922019-06-08 07:50:53 +02001041
Harald Weltec91085e2022-02-10 18:05:45 +01001042 if p.get('acc') is not None:
1043 self.update_acc(p['acc'])
Supreeth Herlec8796a32019-12-23 12:23:42 +01001044
Harald Weltec91085e2022-02-10 18:05:45 +01001045 # write EF.IMSI
1046 data, sw = self._scc.update_binary('6f07', enc_imsi(p['imsi']))
Jan Balke3e840672015-01-26 15:36:27 +01001047
Harald Weltec91085e2022-02-10 18:05:45 +01001048 # EF.PLMNsel
1049 if p.get('mcc') and p.get('mnc'):
1050 sw = self.update_plmnsel(p['mcc'], p['mnc'])
1051 if sw != '9000':
1052 print("Programming PLMNsel failed with code %s" % sw)
Philipp Maier2d15ea02019-03-20 12:40:36 +01001053
Harald Weltec91085e2022-02-10 18:05:45 +01001054 # EF.PLMNwAcT
1055 if p.get('mcc') and p.get('mnc'):
1056 sw = self.update_plmn_act(p['mcc'], p['mnc'])
1057 if sw != '9000':
1058 print("Programming PLMNwAcT failed with code %s" % sw)
Philipp Maier2d15ea02019-03-20 12:40:36 +01001059
Harald Weltec91085e2022-02-10 18:05:45 +01001060 # EF.OPLMNwAcT
1061 if p.get('mcc') and p.get('mnc'):
1062 sw = self.update_oplmn_act(p['mcc'], p['mnc'])
1063 if sw != '9000':
1064 print("Programming OPLMNwAcT failed with code %s" % sw)
Philipp Maier2d15ea02019-03-20 12:40:36 +01001065
Harald Weltec91085e2022-02-10 18:05:45 +01001066 # EF.HPLMNwAcT
1067 if p.get('mcc') and p.get('mnc'):
1068 sw = self.update_hplmn_act(p['mcc'], p['mnc'])
1069 if sw != '9000':
1070 print("Programming HPLMNwAcT failed with code %s" % sw)
Supreeth Herlef442fb42020-01-21 12:47:32 +01001071
Harald Weltec91085e2022-02-10 18:05:45 +01001072 # EF.AD
1073 if (p.get('mcc') and p.get('mnc')) or p.get('opmode'):
1074 if p.get('mcc') and p.get('mnc'):
1075 mnc = p['mnc']
1076 else:
1077 mnc = None
1078 sw = self.update_ad(mnc=mnc, opmode=p.get('opmode'))
1079 if sw != '9000':
1080 print("Programming AD failed with code %s" % sw)
Philipp Maier2d15ea02019-03-20 12:40:36 +01001081
Harald Weltec91085e2022-02-10 18:05:45 +01001082 # EF.SMSP
1083 if p.get('smsp'):
1084 r = self._scc.select_path(['3f00', '7f10'])
1085 data, sw = self._scc.update_record(
1086 '6f42', 1, lpad(p['smsp'], 104), force_len=True)
Jan Balke3e840672015-01-26 15:36:27 +01001087
Harald Weltec91085e2022-02-10 18:05:45 +01001088 # EF.MSISDN
1089 # TODO: Alpha Identifier (currently 'ff'O * 20)
1090 # TODO: Capability/Configuration1 Record Identifier
1091 # TODO: Extension1 Record Identifier
1092 if p.get('msisdn') is not None:
1093 msisdn = enc_msisdn(p['msisdn'])
1094 data = 'ff' * 20 + msisdn
Supreeth Herle5a541012019-12-22 08:59:16 +01001095
Harald Weltec91085e2022-02-10 18:05:45 +01001096 r = self._scc.select_path(['3f00', '7f10'])
1097 data, sw = self._scc.update_record('6F40', 1, data, force_len=True)
Supreeth Herle5a541012019-12-22 08:59:16 +01001098
Alexander Chemerise0d9d882018-01-10 14:18:32 +09001099
herlesupreeth4a3580b2020-09-29 10:11:36 +02001100class FairwavesSIM(UsimCard):
Harald Weltec91085e2022-02-10 18:05:45 +01001101 """
1102 FairwavesSIM
Alexander Chemerise0d9d882018-01-10 14:18:32 +09001103
Harald Weltec91085e2022-02-10 18:05:45 +01001104 The SIM card is operating according to the standard.
1105 For Ki/OP/OPC programming the following files are additionally open for writing:
1106 3F00/7F20/FF01 – OP/OPC:
1107 byte 1 = 0x01, bytes 2-17: OPC;
1108 byte 1 = 0x00, bytes 2-17: OP;
1109 3F00/7F20/FF02: Ki
1110 """
Alexander Chemerise0d9d882018-01-10 14:18:32 +09001111
Harald Weltec91085e2022-02-10 18:05:45 +01001112 name = 'Fairwaves-SIM'
1113 # Propriatary files
1114 _EF_num = {
1115 'Ki': 'FF02',
1116 'OP/OPC': 'FF01',
1117 }
1118 _EF = {
1119 'Ki': DF['GSM']+[_EF_num['Ki']],
1120 'OP/OPC': DF['GSM']+[_EF_num['OP/OPC']],
1121 }
Alexander Chemerise0d9d882018-01-10 14:18:32 +09001122
Harald Weltec91085e2022-02-10 18:05:45 +01001123 def __init__(self, ssc):
1124 super(FairwavesSIM, self).__init__(ssc)
1125 self._adm_chv_num = 0x11
1126 self._adm2_chv_num = 0x12
Alexander Chemerise0d9d882018-01-10 14:18:32 +09001127
Harald Weltec91085e2022-02-10 18:05:45 +01001128 @classmethod
1129 def autodetect(kls, scc):
1130 try:
1131 # Look for ATR
1132 if scc.get_atr() == toBytes("3B 9F 96 80 1F C7 80 31 A0 73 BE 21 13 67 44 22 06 10 00 00 01 A9"):
1133 return kls(scc)
1134 except:
1135 return None
1136 return None
Alexander Chemerise0d9d882018-01-10 14:18:32 +09001137
Harald Weltec91085e2022-02-10 18:05:45 +01001138 def verify_adm2(self, key):
1139 '''
1140 Authenticate with ADM2 key.
Alexander Chemerise0d9d882018-01-10 14:18:32 +09001141
Harald Weltec91085e2022-02-10 18:05:45 +01001142 Fairwaves SIM cards support hierarchical key structure and ADM2 key
1143 is a key which has access to proprietary files (Ki and OP/OPC).
1144 That said, ADM key inherits permissions of ADM2 key and thus we rarely
1145 need ADM2 key per se.
1146 '''
1147 (res, sw) = self._scc.verify_chv(self._adm2_chv_num, key)
1148 return sw
Alexander Chemerise0d9d882018-01-10 14:18:32 +09001149
Harald Weltec91085e2022-02-10 18:05:45 +01001150 def read_ki(self):
1151 """
1152 Read Ki in proprietary file.
Alexander Chemerise0d9d882018-01-10 14:18:32 +09001153
Harald Weltec91085e2022-02-10 18:05:45 +01001154 Requires ADM1 access level
1155 """
1156 return self._scc.read_binary(self._EF['Ki'])
Alexander Chemerise0d9d882018-01-10 14:18:32 +09001157
Harald Weltec91085e2022-02-10 18:05:45 +01001158 def update_ki(self, ki):
1159 """
1160 Set Ki in proprietary file.
Alexander Chemerise0d9d882018-01-10 14:18:32 +09001161
Harald Weltec91085e2022-02-10 18:05:45 +01001162 Requires ADM1 access level
1163 """
1164 data, sw = self._scc.update_binary(self._EF['Ki'], ki)
1165 return sw
Alexander Chemerise0d9d882018-01-10 14:18:32 +09001166
Harald Weltec91085e2022-02-10 18:05:45 +01001167 def read_op_opc(self):
1168 """
1169 Read Ki in proprietary file.
Alexander Chemerise0d9d882018-01-10 14:18:32 +09001170
Harald Weltec91085e2022-02-10 18:05:45 +01001171 Requires ADM1 access level
1172 """
1173 (ef, sw) = self._scc.read_binary(self._EF['OP/OPC'])
1174 type = 'OP' if ef[0:2] == '00' else 'OPC'
1175 return ((type, ef[2:]), sw)
Alexander Chemerise0d9d882018-01-10 14:18:32 +09001176
Harald Weltec91085e2022-02-10 18:05:45 +01001177 def update_op(self, op):
1178 """
1179 Set OP in proprietary file.
Alexander Chemerise0d9d882018-01-10 14:18:32 +09001180
Harald Weltec91085e2022-02-10 18:05:45 +01001181 Requires ADM1 access level
1182 """
1183 content = '00' + op
1184 data, sw = self._scc.update_binary(self._EF['OP/OPC'], content)
1185 return sw
Alexander Chemerise0d9d882018-01-10 14:18:32 +09001186
Harald Weltec91085e2022-02-10 18:05:45 +01001187 def update_opc(self, opc):
1188 """
1189 Set OPC in proprietary file.
Alexander Chemerise0d9d882018-01-10 14:18:32 +09001190
Harald Weltec91085e2022-02-10 18:05:45 +01001191 Requires ADM1 access level
1192 """
1193 content = '01' + opc
1194 data, sw = self._scc.update_binary(self._EF['OP/OPC'], content)
1195 return sw
Alexander Chemerise0d9d882018-01-10 14:18:32 +09001196
Harald Weltec91085e2022-02-10 18:05:45 +01001197 def program(self, p):
1198 # For some reason the card programming only works when the card
1199 # is handled as a classic SIM, even though it is an USIM, so we
1200 # reconfigure the class byte and the select control field on
1201 # the fly. When the programming is done the original values are
1202 # restored.
1203 cla_byte_orig = self._scc.cla_byte
1204 sel_ctrl_orig = self._scc.sel_ctrl
1205 self._scc.cla_byte = "a0"
1206 self._scc.sel_ctrl = "0000"
Alexander Chemerise0d9d882018-01-10 14:18:32 +09001207
Harald Weltec91085e2022-02-10 18:05:45 +01001208 try:
1209 self._program(p)
1210 finally:
1211 # restore original cla byte and sel ctrl
1212 self._scc.cla_byte = cla_byte_orig
1213 self._scc.sel_ctrl = sel_ctrl_orig
Alexander Chemerise0d9d882018-01-10 14:18:32 +09001214
Harald Weltec91085e2022-02-10 18:05:45 +01001215 def _program(self, p):
1216 # authenticate as ADM1
1217 if not p['pin_adm']:
1218 raise ValueError(
1219 "Please provide a PIN-ADM as there is no default one")
1220 self.verify_adm(h2b(p['pin_adm']))
Alexander Chemerise0d9d882018-01-10 14:18:32 +09001221
Harald Weltec91085e2022-02-10 18:05:45 +01001222 # TODO: Set operator name
1223 if p.get('smsp') is not None:
1224 sw = self.update_smsp(p['smsp'])
1225 if sw != '9000':
1226 print("Programming SMSP failed with code %s" % sw)
1227 # This SIM doesn't support changing ICCID
1228 if p.get('mcc') is not None and p.get('mnc') is not None:
1229 sw = self.update_hplmn_act(p['mcc'], p['mnc'])
1230 if sw != '9000':
1231 print("Programming MCC/MNC failed with code %s" % sw)
1232 if p.get('imsi') is not None:
1233 sw = self.update_imsi(p['imsi'])
1234 if sw != '9000':
1235 print("Programming IMSI failed with code %s" % sw)
1236 if p.get('ki') is not None:
1237 sw = self.update_ki(p['ki'])
1238 if sw != '9000':
1239 print("Programming Ki failed with code %s" % sw)
1240 if p.get('opc') is not None:
1241 sw = self.update_opc(p['opc'])
1242 if sw != '9000':
1243 print("Programming OPC failed with code %s" % sw)
1244 if p.get('acc') is not None:
1245 sw = self.update_acc(p['acc'])
1246 if sw != '9000':
1247 print("Programming ACC failed with code %s" % sw)
Alexander Chemerise0d9d882018-01-10 14:18:32 +09001248
1249
Philipp Maierbb73e512021-05-05 16:14:00 +02001250class OpenCellsSim(SimCard):
Harald Weltec91085e2022-02-10 18:05:45 +01001251 """
1252 OpenCellsSim
Todd Neal9eeadfc2018-04-25 15:36:29 -05001253
Harald Weltec91085e2022-02-10 18:05:45 +01001254 """
Todd Neal9eeadfc2018-04-25 15:36:29 -05001255
Harald Weltec91085e2022-02-10 18:05:45 +01001256 name = 'OpenCells-SIM'
Todd Neal9eeadfc2018-04-25 15:36:29 -05001257
Harald Weltec91085e2022-02-10 18:05:45 +01001258 def __init__(self, ssc):
1259 super(OpenCellsSim, self).__init__(ssc)
1260 self._adm_chv_num = 0x0A
Todd Neal9eeadfc2018-04-25 15:36:29 -05001261
Harald Weltec91085e2022-02-10 18:05:45 +01001262 @classmethod
1263 def autodetect(kls, scc):
1264 try:
1265 # Look for ATR
1266 if scc.get_atr() == toBytes("3B 9F 95 80 1F C3 80 31 E0 73 FE 21 13 57 86 81 02 86 98 44 18 A8"):
1267 return kls(scc)
1268 except:
1269 return None
1270 return None
Todd Neal9eeadfc2018-04-25 15:36:29 -05001271
Harald Weltec91085e2022-02-10 18:05:45 +01001272 def program(self, p):
1273 if not p['pin_adm']:
1274 raise ValueError(
1275 "Please provide a PIN-ADM as there is no default one")
1276 self._scc.verify_chv(0x0A, h2b(p['pin_adm']))
Todd Neal9eeadfc2018-04-25 15:36:29 -05001277
Harald Weltec91085e2022-02-10 18:05:45 +01001278 # select MF
1279 r = self._scc.select_path(['3f00'])
Todd Neal9eeadfc2018-04-25 15:36:29 -05001280
Harald Weltec91085e2022-02-10 18:05:45 +01001281 # write EF.ICCID
1282 data, sw = self._scc.update_binary('2fe2', enc_iccid(p['iccid']))
Todd Neal9eeadfc2018-04-25 15:36:29 -05001283
Harald Weltec91085e2022-02-10 18:05:45 +01001284 r = self._scc.select_path(['7ff0'])
Todd Neal9eeadfc2018-04-25 15:36:29 -05001285
Harald Weltec91085e2022-02-10 18:05:45 +01001286 # set Ki in proprietary file
1287 data, sw = self._scc.update_binary('FF02', p['ki'])
Todd Neal9eeadfc2018-04-25 15:36:29 -05001288
Harald Weltec91085e2022-02-10 18:05:45 +01001289 # set OPC in proprietary file
1290 data, sw = self._scc.update_binary('FF01', p['opc'])
Todd Neal9eeadfc2018-04-25 15:36:29 -05001291
Harald Weltec91085e2022-02-10 18:05:45 +01001292 # select DF_GSM
1293 r = self._scc.select_path(['7f20'])
Todd Neal9eeadfc2018-04-25 15:36:29 -05001294
Harald Weltec91085e2022-02-10 18:05:45 +01001295 # write EF.IMSI
1296 data, sw = self._scc.update_binary('6f07', enc_imsi(p['imsi']))
Todd Neal9eeadfc2018-04-25 15:36:29 -05001297
Todd Neal9eeadfc2018-04-25 15:36:29 -05001298
herlesupreeth4a3580b2020-09-29 10:11:36 +02001299class WavemobileSim(UsimCard):
Harald Weltec91085e2022-02-10 18:05:45 +01001300 """
1301 WavemobileSim
Philipp Maierc8ce82a2018-07-04 17:57:20 +02001302
Harald Weltec91085e2022-02-10 18:05:45 +01001303 """
Philipp Maierc8ce82a2018-07-04 17:57:20 +02001304
Harald Weltec91085e2022-02-10 18:05:45 +01001305 name = 'Wavemobile-SIM'
Philipp Maierc8ce82a2018-07-04 17:57:20 +02001306
Harald Weltec91085e2022-02-10 18:05:45 +01001307 def __init__(self, ssc):
1308 super(WavemobileSim, self).__init__(ssc)
1309 self._adm_chv_num = 0x0A
1310 self._scc.cla_byte = "00"
1311 self._scc.sel_ctrl = "0004" # request an FCP
Philipp Maierc8ce82a2018-07-04 17:57:20 +02001312
Harald Weltec91085e2022-02-10 18:05:45 +01001313 @classmethod
1314 def autodetect(kls, scc):
1315 try:
1316 # Look for ATR
1317 if scc.get_atr() == toBytes("3B 9F 95 80 1F C7 80 31 E0 73 F6 21 13 67 4D 45 16 00 43 01 00 8F"):
1318 return kls(scc)
1319 except:
1320 return None
1321 return None
Philipp Maierc8ce82a2018-07-04 17:57:20 +02001322
Harald Weltec91085e2022-02-10 18:05:45 +01001323 def program(self, p):
1324 if not p['pin_adm']:
1325 raise ValueError(
1326 "Please provide a PIN-ADM as there is no default one")
1327 self.verify_adm(h2b(p['pin_adm']))
Philipp Maierc8ce82a2018-07-04 17:57:20 +02001328
Harald Weltec91085e2022-02-10 18:05:45 +01001329 # EF.ICCID
1330 # TODO: Add programming of the ICCID
1331 if p.get('iccid'):
1332 print(
1333 "Warning: Programming of the ICCID is not implemented for this type of card.")
Philipp Maierc8ce82a2018-07-04 17:57:20 +02001334
Philipp Maierde0cf162023-01-03 13:29:45 +01001335 # KI (Presumably a proprietary file)
Harald Weltec91085e2022-02-10 18:05:45 +01001336 # TODO: Add programming of KI
1337 if p.get('ki'):
1338 print(
1339 "Warning: Programming of the KI is not implemented for this type of card.")
Philipp Maierc8ce82a2018-07-04 17:57:20 +02001340
Philipp Maierde0cf162023-01-03 13:29:45 +01001341 # OPc (Presumably a proprietary file)
Harald Weltec91085e2022-02-10 18:05:45 +01001342 # TODO: Add programming of OPc
1343 if p.get('opc'):
1344 print(
1345 "Warning: Programming of the OPc is not implemented for this type of card.")
Philipp Maierc8ce82a2018-07-04 17:57:20 +02001346
Harald Weltec91085e2022-02-10 18:05:45 +01001347 # EF.SMSP
1348 if p.get('smsp'):
1349 sw = self.update_smsp(p['smsp'])
1350 if sw != '9000':
1351 print("Programming SMSP failed with code %s" % sw)
Philipp Maierc8ce82a2018-07-04 17:57:20 +02001352
Harald Weltec91085e2022-02-10 18:05:45 +01001353 # EF.IMSI
1354 if p.get('imsi'):
1355 sw = self.update_imsi(p['imsi'])
1356 if sw != '9000':
1357 print("Programming IMSI failed with code %s" % sw)
Philipp Maierc8ce82a2018-07-04 17:57:20 +02001358
Harald Weltec91085e2022-02-10 18:05:45 +01001359 # EF.ACC
1360 if p.get('acc'):
1361 sw = self.update_acc(p['acc'])
1362 if sw != '9000':
1363 print("Programming ACC failed with code %s" % sw)
Philipp Maierc8ce82a2018-07-04 17:57:20 +02001364
Harald Weltec91085e2022-02-10 18:05:45 +01001365 # EF.PLMNsel
1366 if p.get('mcc') and p.get('mnc'):
1367 sw = self.update_plmnsel(p['mcc'], p['mnc'])
1368 if sw != '9000':
1369 print("Programming PLMNsel failed with code %s" % sw)
Philipp Maierc8ce82a2018-07-04 17:57:20 +02001370
Harald Weltec91085e2022-02-10 18:05:45 +01001371 # EF.PLMNwAcT
1372 if p.get('mcc') and p.get('mnc'):
1373 sw = self.update_plmn_act(p['mcc'], p['mnc'])
1374 if sw != '9000':
1375 print("Programming PLMNwAcT failed with code %s" % sw)
Philipp Maierc8ce82a2018-07-04 17:57:20 +02001376
Harald Weltec91085e2022-02-10 18:05:45 +01001377 # EF.OPLMNwAcT
1378 if p.get('mcc') and p.get('mnc'):
1379 sw = self.update_oplmn_act(p['mcc'], p['mnc'])
1380 if sw != '9000':
1381 print("Programming OPLMNwAcT failed with code %s" % sw)
Philipp Maierc8ce82a2018-07-04 17:57:20 +02001382
Harald Weltec91085e2022-02-10 18:05:45 +01001383 # EF.AD
1384 if (p.get('mcc') and p.get('mnc')) or p.get('opmode'):
1385 if p.get('mcc') and p.get('mnc'):
1386 mnc = p['mnc']
1387 else:
1388 mnc = None
1389 sw = self.update_ad(mnc=mnc, opmode=p.get('opmode'))
1390 if sw != '9000':
1391 print("Programming AD failed with code %s" % sw)
Philipp Maier6e507a72019-04-01 16:33:48 +02001392
Harald Weltec91085e2022-02-10 18:05:45 +01001393 return None
Philipp Maierc8ce82a2018-07-04 17:57:20 +02001394
Todd Neal9eeadfc2018-04-25 15:36:29 -05001395
herlesupreethb0c7d122020-12-23 09:25:46 +01001396class SysmoISIMSJA2(UsimCard, IsimCard):
Harald Weltec91085e2022-02-10 18:05:45 +01001397 """
1398 sysmocom sysmoISIM-SJA2
1399 """
Philipp Maier0ad5bcf2019-12-31 17:55:47 +01001400
Harald Weltec91085e2022-02-10 18:05:45 +01001401 name = 'sysmoISIM-SJA2'
Philipp Maier0ad5bcf2019-12-31 17:55:47 +01001402
Harald Weltec91085e2022-02-10 18:05:45 +01001403 def __init__(self, ssc):
1404 super(SysmoISIMSJA2, self).__init__(ssc)
1405 self._scc.cla_byte = "00"
1406 self._scc.sel_ctrl = "0004" # request an FCP
Philipp Maier0ad5bcf2019-12-31 17:55:47 +01001407
Harald Weltec91085e2022-02-10 18:05:45 +01001408 @classmethod
1409 def autodetect(kls, scc):
1410 try:
1411 # Try card model #1
1412 atr = "3B 9F 96 80 1F 87 80 31 E0 73 FE 21 1B 67 4A 4C 75 30 34 05 4B A9"
1413 if scc.get_atr() == toBytes(atr):
1414 return kls(scc)
Philipp Maier0ad5bcf2019-12-31 17:55:47 +01001415
Harald Weltec91085e2022-02-10 18:05:45 +01001416 # Try card model #2
1417 atr = "3B 9F 96 80 1F 87 80 31 E0 73 FE 21 1B 67 4A 4C 75 31 33 02 51 B2"
1418 if scc.get_atr() == toBytes(atr):
1419 return kls(scc)
Philipp Maierb3e11ea2020-03-11 12:32:44 +01001420
Harald Weltec91085e2022-02-10 18:05:45 +01001421 # Try card model #3
1422 atr = "3B 9F 96 80 1F 87 80 31 E0 73 FE 21 1B 67 4A 4C 52 75 31 04 51 D5"
1423 if scc.get_atr() == toBytes(atr):
1424 return kls(scc)
1425 except:
1426 return None
1427 return None
Philipp Maier0ad5bcf2019-12-31 17:55:47 +01001428
Harald Weltec91085e2022-02-10 18:05:45 +01001429 def verify_adm(self, key):
1430 # authenticate as ADM using default key (written on the card..)
1431 if not key:
1432 raise ValueError(
1433 "Please provide a PIN-ADM as there is no default one")
1434 (res, sw) = self._scc.verify_chv(0x0A, key)
1435 return sw
Harald Weltea6704252021-01-08 20:19:11 +01001436
Harald Weltec91085e2022-02-10 18:05:45 +01001437 def program(self, p):
1438 self.verify_adm(h2b(p['pin_adm']))
Philipp Maier0ad5bcf2019-12-31 17:55:47 +01001439
Harald Weltec91085e2022-02-10 18:05:45 +01001440 # This type of card does not allow to reprogram the ICCID.
1441 # Reprogramming the ICCID would mess up the card os software
1442 # license management, so the ICCID must be kept at its factory
1443 # setting!
1444 if p.get('iccid'):
1445 print(
1446 "Warning: Programming of the ICCID is not implemented for this type of card.")
Philipp Maier0ad5bcf2019-12-31 17:55:47 +01001447
Harald Weltec91085e2022-02-10 18:05:45 +01001448 # select DF_GSM
1449 self._scc.select_path(['7f20'])
Philipp Maier0ad5bcf2019-12-31 17:55:47 +01001450
Harald Weltec91085e2022-02-10 18:05:45 +01001451 # set Service Provider Name
1452 if p.get('name') is not None:
1453 self.update_spn(p['name'], True, True)
Robert Falkenberg54595362021-04-06 12:04:34 +02001454
Harald Weltec91085e2022-02-10 18:05:45 +01001455 # write EF.IMSI
1456 if p.get('imsi'):
1457 self._scc.update_binary('6f07', enc_imsi(p['imsi']))
Philipp Maier0ad5bcf2019-12-31 17:55:47 +01001458
Harald Weltec91085e2022-02-10 18:05:45 +01001459 # EF.PLMNsel
1460 if p.get('mcc') and p.get('mnc'):
1461 sw = self.update_plmnsel(p['mcc'], p['mnc'])
1462 if sw != '9000':
1463 print("Programming PLMNsel failed with code %s" % sw)
Philipp Maier0ad5bcf2019-12-31 17:55:47 +01001464
Harald Weltec91085e2022-02-10 18:05:45 +01001465 # EF.PLMNwAcT
1466 if p.get('mcc') and p.get('mnc'):
1467 sw = self.update_plmn_act(p['mcc'], p['mnc'])
1468 if sw != '9000':
1469 print("Programming PLMNwAcT failed with code %s" % sw)
Philipp Maier0ad5bcf2019-12-31 17:55:47 +01001470
Harald Weltec91085e2022-02-10 18:05:45 +01001471 # EF.OPLMNwAcT
1472 if p.get('mcc') and p.get('mnc'):
1473 sw = self.update_oplmn_act(p['mcc'], p['mnc'])
1474 if sw != '9000':
1475 print("Programming OPLMNwAcT failed with code %s" % sw)
Philipp Maier0ad5bcf2019-12-31 17:55:47 +01001476
Harald Weltec91085e2022-02-10 18:05:45 +01001477 # EF.HPLMNwAcT
1478 if p.get('mcc') and p.get('mnc'):
1479 sw = self.update_hplmn_act(p['mcc'], p['mnc'])
1480 if sw != '9000':
1481 print("Programming HPLMNwAcT failed with code %s" % sw)
Harald Welte32f0d412020-05-05 17:35:57 +02001482
Harald Weltec91085e2022-02-10 18:05:45 +01001483 # EF.AD
1484 if (p.get('mcc') and p.get('mnc')) or p.get('opmode'):
1485 if p.get('mcc') and p.get('mnc'):
1486 mnc = p['mnc']
1487 else:
1488 mnc = None
1489 sw = self.update_ad(mnc=mnc, opmode=p.get('opmode'))
1490 if sw != '9000':
1491 print("Programming AD failed with code %s" % sw)
Philipp Maier0ad5bcf2019-12-31 17:55:47 +01001492
Harald Weltec91085e2022-02-10 18:05:45 +01001493 # EF.SMSP
1494 if p.get('smsp'):
1495 r = self._scc.select_path(['3f00', '7f10'])
1496 data, sw = self._scc.update_record(
1497 '6f42', 1, lpad(p['smsp'], 104), force_len=True)
Philipp Maier0ad5bcf2019-12-31 17:55:47 +01001498
Harald Weltec91085e2022-02-10 18:05:45 +01001499 # EF.MSISDN
1500 # TODO: Alpha Identifier (currently 'ff'O * 20)
1501 # TODO: Capability/Configuration1 Record Identifier
1502 # TODO: Extension1 Record Identifier
1503 if p.get('msisdn') is not None:
1504 msisdn = enc_msisdn(p['msisdn'])
1505 content = 'ff' * 20 + msisdn
Supreeth Herlec6019232020-03-26 10:00:45 +01001506
Harald Weltec91085e2022-02-10 18:05:45 +01001507 r = self._scc.select_path(['3f00', '7f10'])
1508 data, sw = self._scc.update_record(
1509 '6F40', 1, content, force_len=True)
Supreeth Herlec6019232020-03-26 10:00:45 +01001510
Harald Weltec91085e2022-02-10 18:05:45 +01001511 # EF.ACC
1512 if p.get('acc'):
1513 sw = self.update_acc(p['acc'])
1514 if sw != '9000':
1515 print("Programming ACC failed with code %s" % sw)
Supreeth Herlea97944b2020-03-26 10:03:25 +01001516
Harald Weltec91085e2022-02-10 18:05:45 +01001517 # Populate AIDs
1518 self.read_aids()
Supreeth Herle80164052020-03-23 12:06:29 +01001519
Harald Weltec91085e2022-02-10 18:05:45 +01001520 # update EF-SIM_AUTH_KEY (and EF-USIM_AUTH_KEY_2G, which is
1521 # hard linked to EF-USIM_AUTH_KEY)
1522 self._scc.select_path(['3f00'])
1523 self._scc.select_path(['a515'])
1524 if p.get('ki'):
1525 self._scc.update_binary('6f20', p['ki'], 1)
1526 if p.get('opc'):
1527 self._scc.update_binary('6f20', p['opc'], 17)
Philipp Maier0ad5bcf2019-12-31 17:55:47 +01001528
Harald Weltec91085e2022-02-10 18:05:45 +01001529 # update EF-USIM_AUTH_KEY in ADF.ISIM
1530 data, sw = self.select_adf_by_aid(adf="isim")
1531 if sw == '9000':
1532 if p.get('ki'):
1533 self._scc.update_binary('af20', p['ki'], 1)
1534 if p.get('opc'):
1535 self._scc.update_binary('af20', p['opc'], 17)
Philipp Maier0ad5bcf2019-12-31 17:55:47 +01001536
Harald Weltec91085e2022-02-10 18:05:45 +01001537 # update EF.P-CSCF in ADF.ISIM
1538 if self.file_exists(EF_ISIM_ADF_map['PCSCF']):
1539 if p.get('pcscf'):
1540 sw = self.update_pcscf(p['pcscf'])
1541 else:
1542 sw = self.update_pcscf("")
1543 if sw != '9000':
1544 print("Programming P-CSCF failed with code %s" % sw)
Supreeth Herlecf727f22020-03-24 17:32:21 +01001545
Harald Weltec91085e2022-02-10 18:05:45 +01001546 # update EF.DOMAIN in ADF.ISIM
1547 if self.file_exists(EF_ISIM_ADF_map['DOMAIN']):
1548 if p.get('ims_hdomain'):
1549 sw = self.update_domain(domain=p['ims_hdomain'])
1550 else:
1551 sw = self.update_domain()
Supreeth Herlecf727f22020-03-24 17:32:21 +01001552
Harald Weltec91085e2022-02-10 18:05:45 +01001553 if sw != '9000':
1554 print(
1555 "Programming Home Network Domain Name failed with code %s" % sw)
Supreeth Herle79f43dd2020-03-25 11:43:19 +01001556
Harald Weltec91085e2022-02-10 18:05:45 +01001557 # update EF.IMPI in ADF.ISIM
1558 # TODO: Validate IMPI input
1559 if self.file_exists(EF_ISIM_ADF_map['IMPI']):
1560 if p.get('impi'):
1561 sw = self.update_impi(p['impi'])
1562 else:
1563 sw = self.update_impi()
1564 if sw != '9000':
1565 print("Programming IMPI failed with code %s" % sw)
Supreeth Herle79f43dd2020-03-25 11:43:19 +01001566
Harald Weltec91085e2022-02-10 18:05:45 +01001567 # update EF.IMPU in ADF.ISIM
1568 # TODO: Validate IMPU input
1569 # Support multiple IMPU if there is enough space
1570 if self.file_exists(EF_ISIM_ADF_map['IMPU']):
1571 if p.get('impu'):
1572 sw = self.update_impu(p['impu'])
1573 else:
1574 sw = self.update_impu()
1575 if sw != '9000':
1576 print("Programming IMPU failed with code %s" % sw)
Supreeth Herlea5bd9682020-03-26 09:16:14 +01001577
Harald Weltec91085e2022-02-10 18:05:45 +01001578 data, sw = self.select_adf_by_aid(adf="usim")
1579 if sw == '9000':
Philipp Maier284ac102023-01-17 14:26:56 +01001580 # EF.AD in ADF.USIM
1581 if (p.get('mcc') and p.get('mnc')) or p.get('opmode'):
1582 if p.get('mcc') and p.get('mnc'):
1583 mnc = p['mnc']
1584 else:
1585 mnc = None
1586 sw = self.update_ad(mnc=mnc, opmode=p.get('opmode'),
1587 path=EF_USIM_ADF_map['AD'])
1588 if sw != '9000':
1589 print("Programming AD failed with code %s" % sw)
1590
Harald Weltec91085e2022-02-10 18:05:45 +01001591 # update EF-USIM_AUTH_KEY in ADF.USIM
1592 if p.get('ki'):
1593 self._scc.update_binary('af20', p['ki'], 1)
1594 if p.get('opc'):
1595 self._scc.update_binary('af20', p['opc'], 17)
Supreeth Herlebe7007e2020-03-26 09:27:45 +01001596
Harald Weltec91085e2022-02-10 18:05:45 +01001597 # update EF.EHPLMN in ADF.USIM
1598 if self.file_exists(EF_USIM_ADF_map['EHPLMN']):
1599 if p.get('mcc') and p.get('mnc'):
1600 sw = self.update_ehplmn(p['mcc'], p['mnc'])
1601 if sw != '9000':
1602 print("Programming EHPLMN failed with code %s" % sw)
Philipp Maier0ad5bcf2019-12-31 17:55:47 +01001603
Harald Weltec91085e2022-02-10 18:05:45 +01001604 # update EF.ePDGId in ADF.USIM
1605 if self.file_exists(EF_USIM_ADF_map['ePDGId']):
1606 if p.get('epdgid'):
1607 sw = self.update_epdgid(p['epdgid'])
1608 else:
1609 sw = self.update_epdgid("")
1610 if sw != '9000':
1611 print("Programming ePDGId failed with code %s" % sw)
Supreeth Herle8e0fccd2020-03-23 12:10:56 +01001612
Harald Weltec91085e2022-02-10 18:05:45 +01001613 # update EF.ePDGSelection in ADF.USIM
1614 if self.file_exists(EF_USIM_ADF_map['ePDGSelection']):
1615 if p.get('epdgSelection'):
1616 epdg_plmn = p['epdgSelection']
1617 sw = self.update_ePDGSelection(
1618 epdg_plmn[:3], epdg_plmn[3:])
1619 else:
1620 sw = self.update_ePDGSelection("", "")
1621 if sw != '9000':
1622 print("Programming ePDGSelection failed with code %s" % sw)
Supreeth Herle8e0fccd2020-03-23 12:10:56 +01001623
Harald Weltec91085e2022-02-10 18:05:45 +01001624 # After successfully programming EF.ePDGId and EF.ePDGSelection,
1625 # Set service 106 and 107 as available in EF.UST
1626 # Disable service 95, 99, 115 if ISIM application is present
1627 if self.file_exists(EF_USIM_ADF_map['UST']):
1628 if p.get('epdgSelection') and p.get('epdgid'):
1629 sw = self.update_ust(106, 1)
1630 if sw != '9000':
1631 print("Programming UST failed with code %s" % sw)
1632 sw = self.update_ust(107, 1)
1633 if sw != '9000':
1634 print("Programming UST failed with code %s" % sw)
Supreeth Herlef964df42020-03-24 13:15:37 +01001635
Harald Weltec91085e2022-02-10 18:05:45 +01001636 sw = self.update_ust(95, 0)
1637 if sw != '9000':
1638 print("Programming UST failed with code %s" % sw)
1639 sw = self.update_ust(99, 0)
1640 if sw != '9000':
1641 print("Programming UST failed with code %s" % sw)
1642 sw = self.update_ust(115, 0)
1643 if sw != '9000':
1644 print("Programming UST failed with code %s" % sw)
Supreeth Herlef964df42020-03-24 13:15:37 +01001645
Harald Weltec91085e2022-02-10 18:05:45 +01001646 return
Philipp Maier0ad5bcf2019-12-31 17:55:47 +01001647
Philipp Maier0ad5bcf2019-12-31 17:55:47 +01001648
Todd Neal9eeadfc2018-04-25 15:36:29 -05001649# In order for autodetection ...
Harald Weltec91085e2022-02-10 18:05:45 +01001650_cards_classes = [FakeMagicSim, SuperSim, MagicSim, GrcardSim,
1651 SysmoSIMgr1, SysmoSIMgr2, SysmoUSIMgr1, SysmoUSIMSJS1,
1652 FairwavesSIM, OpenCellsSim, WavemobileSim, SysmoISIMSJA2]
1653
Alexander Chemeris8ad124a2018-01-10 14:17:55 +09001654
Supreeth Herle4c306ab2020-03-18 11:38:00 +01001655def card_detect(ctype, scc):
Harald Weltec91085e2022-02-10 18:05:45 +01001656 # Detect type if needed
1657 card = None
1658 ctypes = dict([(kls.name, kls) for kls in _cards_classes])
Supreeth Herle4c306ab2020-03-18 11:38:00 +01001659
Harald Weltec91085e2022-02-10 18:05:45 +01001660 if ctype == "auto":
1661 for kls in _cards_classes:
1662 card = kls.autodetect(scc)
1663 if card:
1664 print("Autodetected card type: %s" % card.name)
1665 card.reset()
1666 break
Supreeth Herle4c306ab2020-03-18 11:38:00 +01001667
Harald Weltec91085e2022-02-10 18:05:45 +01001668 if card is None:
1669 print("Autodetection failed")
1670 return None
Supreeth Herle4c306ab2020-03-18 11:38:00 +01001671
Harald Weltec91085e2022-02-10 18:05:45 +01001672 elif ctype in ctypes:
1673 card = ctypes[ctype](scc)
Supreeth Herle4c306ab2020-03-18 11:38:00 +01001674
Harald Weltec91085e2022-02-10 18:05:45 +01001675 else:
1676 raise ValueError("Unknown card type: %s" % ctype)
Supreeth Herle4c306ab2020-03-18 11:38:00 +01001677
Harald Weltec91085e2022-02-10 18:05:45 +01001678 return card