blob: b48a80cfb4585c93ed04140021ea5574a6f604ee [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
Philipp Maier84902402023-02-10 18:23:36 +0100310 def adf_present(self, adf="usim") -> bool:
311 """Check if the AID of the specified ADF is present in EF.DIR (call read_aids before use)"""
312 aid = self._get_aid(adf)
313 if aid:
314 aid_full = self._complete_aid(aid)
315 if aid_full:
316 return True
317 return False
318
Harald Weltec91085e2022-02-10 18:05:45 +0100319 def select_adf_by_aid(self, adf="usim"):
320 """Select ADF.U/ISIM in the Card using its full AID"""
321 if is_hex(adf):
322 aid = adf
323 else:
324 aid = self._get_aid(adf)
325 if aid:
326 aid_full = self._complete_aid(aid)
327 if aid_full:
328 return self._scc.select_adf(aid_full)
329 else:
330 # If we cannot get the full AID, try with short AID
331 return self._scc.select_adf(aid)
332 return (None, None)
Supreeth Herlef9f3e5e2020-03-22 08:04:59 +0100333
Harald Weltec91085e2022-02-10 18:05:45 +0100334 def erase_binary(self, ef):
335 """Erase the contents of a file"""
336 len = self._scc.binary_size(ef)
337 self._scc.update_binary(ef, "ff" * len, offset=0, verify=True)
Philipp Maier5c2cc662020-05-12 16:27:12 +0200338
Harald Weltec91085e2022-02-10 18:05:45 +0100339 def erase_record(self, ef, rec_no):
340 """Erase the contents of a single record"""
341 len = self._scc.record_size(ef)
342 self._scc.update_record(ef, rec_no, "ff" * len,
343 force_len=False, verify=True)
Philipp Maier5c2cc662020-05-12 16:27:12 +0200344
Harald Weltec91085e2022-02-10 18:05:45 +0100345 def set_apdu_parameter(self, cla, sel_ctrl):
346 """Set apdu parameters (class byte and selection control bytes)"""
347 self._scc.cla_byte = cla
348 self._scc.sel_ctrl = sel_ctrl
Philipp Maier30b225f2021-10-29 16:41:46 +0200349
Harald Weltec91085e2022-02-10 18:05:45 +0100350 def get_apdu_parameter(self):
351 """Get apdu parameters (class byte and selection control bytes)"""
352 return (self._scc.cla_byte, self._scc.sel_ctrl)
353
Philipp Maier30b225f2021-10-29 16:41:46 +0200354
Philipp Maierbb73e512021-05-05 16:14:00 +0200355class UsimCard(SimCard):
Philipp Maierfc5f28d2021-05-05 12:18:41 +0200356
Harald Weltec91085e2022-02-10 18:05:45 +0100357 name = 'USIM'
Philipp Maierfc5f28d2021-05-05 12:18:41 +0200358
Harald Weltec91085e2022-02-10 18:05:45 +0100359 def __init__(self, ssc):
360 super(UsimCard, self).__init__(ssc)
Harald Welteca673942020-06-03 15:19:40 +0200361
Philipp Maierbda52832022-06-14 16:18:12 +0200362 # See also: ETSI TS 102 221, Table 9.3
363 self._adm_chv_num = 0xA0
364
Harald Weltec91085e2022-02-10 18:05:45 +0100365 def read_ehplmn(self):
366 (res, sw) = self._scc.read_binary(EF_USIM_ADF_map['EHPLMN'])
367 if sw == '9000':
368 return (format_xplmn(res), sw)
369 else:
370 return (None, sw)
Harald Welteca673942020-06-03 15:19:40 +0200371
Harald Weltec91085e2022-02-10 18:05:45 +0100372 def update_ehplmn(self, mcc, mnc):
373 data = self._scc.read_binary(
374 EF_USIM_ADF_map['EHPLMN'], length=None, offset=0)
375 size = len(data[0]) // 2
376 ehplmn = enc_plmn(mcc, mnc)
377 data, sw = self._scc.update_binary(EF_USIM_ADF_map['EHPLMN'], ehplmn)
378 return sw
Harald Welteca673942020-06-03 15:19:40 +0200379
Harald Weltec91085e2022-02-10 18:05:45 +0100380 def read_epdgid(self):
381 (res, sw) = self._scc.read_binary(EF_USIM_ADF_map['ePDGId'])
382 if sw == '9000':
383 try:
384 addr, addr_type = dec_addr_tlv(res)
385 except:
386 addr = None
387 addr_type = None
388 return (format_addr(addr, addr_type), sw)
389 else:
390 return (None, sw)
herlesupreethf8232db2020-09-29 10:03:06 +0200391
Harald Weltec91085e2022-02-10 18:05:45 +0100392 def update_epdgid(self, epdgid):
393 size = self._scc.binary_size(EF_USIM_ADF_map['ePDGId']) * 2
394 if len(epdgid) > 0:
395 addr_type = get_addr_type(epdgid)
396 if addr_type == None:
397 raise ValueError(
398 "Unknown ePDG Id address type or invalid address provided")
399 epdgid_tlv = rpad(enc_addr_tlv(epdgid, ('%02x' % addr_type)), size)
400 else:
401 epdgid_tlv = rpad('ff', size)
402 data, sw = self._scc.update_binary(
403 EF_USIM_ADF_map['ePDGId'], epdgid_tlv)
404 return sw
Harald Welteca673942020-06-03 15:19:40 +0200405
Harald Weltec91085e2022-02-10 18:05:45 +0100406 def read_ePDGSelection(self):
407 (res, sw) = self._scc.read_binary(EF_USIM_ADF_map['ePDGSelection'])
408 if sw == '9000':
409 return (format_ePDGSelection(res), sw)
410 else:
411 return (None, sw)
Supreeth Herle99d55552020-03-24 13:03:43 +0100412
Harald Weltec91085e2022-02-10 18:05:45 +0100413 def update_ePDGSelection(self, mcc, mnc):
414 (res, sw) = self._scc.read_binary(
415 EF_USIM_ADF_map['ePDGSelection'], length=None, offset=0)
416 if sw == '9000' and (len(mcc) == 0 or len(mnc) == 0):
417 # Reset contents
418 # 80 - Tag value
419 (res, sw) = self._scc.update_binary(
420 EF_USIM_ADF_map['ePDGSelection'], rpad('', len(res)))
421 elif sw == '9000':
422 (res, sw) = self._scc.update_binary(
423 EF_USIM_ADF_map['ePDGSelection'], enc_ePDGSelection(res, mcc, mnc))
424 return sw
Supreeth Herlef964df42020-03-24 13:15:37 +0100425
Harald Weltec91085e2022-02-10 18:05:45 +0100426 def read_ust(self):
427 (res, sw) = self._scc.read_binary(EF_USIM_ADF_map['UST'])
428 if sw == '9000':
429 # Print those which are available
430 return ([res, dec_st(res, table="usim")], sw)
431 else:
432 return ([None, None], sw)
herlesupreeth4a3580b2020-09-29 10:11:36 +0200433
Harald Weltec91085e2022-02-10 18:05:45 +0100434 def update_ust(self, service, bit=1):
435 (res, sw) = self._scc.read_binary(EF_USIM_ADF_map['UST'])
436 if sw == '9000':
437 content = enc_st(res, service, bit)
438 (res, sw) = self._scc.update_binary(
439 EF_USIM_ADF_map['UST'], content)
440 return sw
441
Harald Welte6ca2fa72022-02-12 16:29:31 +0100442 def update_est(self, service, bit=1):
443 (res, sw) = self._scc.read_binary(EF_USIM_ADF_map['EST'])
444 if sw == '9000':
445 content = enc_st(res, service, bit)
446 (res, sw) = self._scc.update_binary(
447 EF_USIM_ADF_map['EST'], content)
448 return sw
449
450
Supreeth Herleacc222f2020-03-24 13:26:53 +0100451
Philipp Maierbb73e512021-05-05 16:14:00 +0200452class IsimCard(SimCard):
Philipp Maierfc5f28d2021-05-05 12:18:41 +0200453
Harald Weltec91085e2022-02-10 18:05:45 +0100454 name = 'ISIM'
Philipp Maierfc5f28d2021-05-05 12:18:41 +0200455
Harald Weltec91085e2022-02-10 18:05:45 +0100456 def __init__(self, ssc):
457 super(IsimCard, self).__init__(ssc)
herlesupreethecbada92020-12-23 09:24:29 +0100458
Harald Weltec91085e2022-02-10 18:05:45 +0100459 def read_pcscf(self):
460 rec_cnt = self._scc.record_count(EF_ISIM_ADF_map['PCSCF'])
461 pcscf_recs = ""
462 for i in range(0, rec_cnt):
463 (res, sw) = self._scc.read_record(EF_ISIM_ADF_map['PCSCF'], i + 1)
464 if sw == '9000':
465 try:
466 addr, addr_type = dec_addr_tlv(res)
467 except:
468 addr = None
469 addr_type = None
470 content = format_addr(addr, addr_type)
471 pcscf_recs += "%s" % (len(content)
472 and content or '\tNot available\n')
473 else:
474 pcscf_recs += "\tP-CSCF: Can't read, response code = %s\n" % (
475 sw)
476 return pcscf_recs
Supreeth Herle5ad9aec2020-03-24 17:26:40 +0100477
Harald Weltec91085e2022-02-10 18:05:45 +0100478 def update_pcscf(self, pcscf):
479 if len(pcscf) > 0:
480 addr_type = get_addr_type(pcscf)
481 if addr_type == None:
482 raise ValueError(
483 "Unknown PCSCF address type or invalid address provided")
484 content = enc_addr_tlv(pcscf, ('%02x' % addr_type))
485 else:
486 # Just the tag value
487 content = '80'
488 rec_size_bytes = self._scc.record_size(EF_ISIM_ADF_map['PCSCF'])
489 pcscf_tlv = rpad(content, rec_size_bytes*2)
490 data, sw = self._scc.update_record(
491 EF_ISIM_ADF_map['PCSCF'], 1, pcscf_tlv)
492 return sw
Supreeth Herlecf727f22020-03-24 17:32:21 +0100493
Harald Weltec91085e2022-02-10 18:05:45 +0100494 def read_domain(self):
495 (res, sw) = self._scc.read_binary(EF_ISIM_ADF_map['DOMAIN'])
496 if sw == '9000':
497 # Skip the initial tag value ('80') byte and get length of contents
498 length = int(res[2:4], 16)
499 content = h2s(res[4:4+(length*2)])
500 return (content, sw)
501 else:
502 return (None, sw)
Supreeth Herle05b28072020-03-25 10:23:48 +0100503
Harald Weltec91085e2022-02-10 18:05:45 +0100504 def update_domain(self, domain=None, mcc=None, mnc=None):
505 hex_str = ""
506 if domain:
507 hex_str = s2h(domain)
508 elif mcc and mnc:
509 # MCC and MNC always has 3 digits in domain form
510 plmn_str = 'mnc' + lpad(mnc, 3, "0") + '.mcc' + lpad(mcc, 3, "0")
511 hex_str = s2h('ims.' + plmn_str + '.3gppnetwork.org')
Supreeth Herle79f43dd2020-03-25 11:43:19 +0100512
Harald Weltec91085e2022-02-10 18:05:45 +0100513 # Build TLV
514 tlv = TLV(['80'])
515 content = tlv.build({'80': hex_str})
Supreeth Herle79f43dd2020-03-25 11:43:19 +0100516
Harald Weltec91085e2022-02-10 18:05:45 +0100517 bin_size_bytes = self._scc.binary_size(EF_ISIM_ADF_map['DOMAIN'])
518 data, sw = self._scc.update_binary(
519 EF_ISIM_ADF_map['DOMAIN'], rpad(content, bin_size_bytes*2))
520 return sw
Supreeth Herle79f43dd2020-03-25 11:43:19 +0100521
Harald Weltec91085e2022-02-10 18:05:45 +0100522 def read_impi(self):
523 (res, sw) = self._scc.read_binary(EF_ISIM_ADF_map['IMPI'])
524 if sw == '9000':
525 # Skip the initial tag value ('80') byte and get length of contents
526 length = int(res[2:4], 16)
527 content = h2s(res[4:4+(length*2)])
528 return (content, sw)
529 else:
530 return (None, sw)
Supreeth Herle3f67f9c2020-03-25 15:38:02 +0100531
Harald Weltec91085e2022-02-10 18:05:45 +0100532 def update_impi(self, impi=None):
533 hex_str = ""
534 if impi:
535 hex_str = s2h(impi)
536 # Build TLV
537 tlv = TLV(['80'])
538 content = tlv.build({'80': hex_str})
Supreeth Herlea5bd9682020-03-26 09:16:14 +0100539
Harald Weltec91085e2022-02-10 18:05:45 +0100540 bin_size_bytes = self._scc.binary_size(EF_ISIM_ADF_map['IMPI'])
541 data, sw = self._scc.update_binary(
542 EF_ISIM_ADF_map['IMPI'], rpad(content, bin_size_bytes*2))
543 return sw
Supreeth Herlea5bd9682020-03-26 09:16:14 +0100544
Harald Weltec91085e2022-02-10 18:05:45 +0100545 def read_impu(self):
546 rec_cnt = self._scc.record_count(EF_ISIM_ADF_map['IMPU'])
547 impu_recs = ""
548 for i in range(0, rec_cnt):
549 (res, sw) = self._scc.read_record(EF_ISIM_ADF_map['IMPU'], i + 1)
550 if sw == '9000':
551 # Skip the initial tag value ('80') byte and get length of contents
552 length = int(res[2:4], 16)
553 content = h2s(res[4:4+(length*2)])
554 impu_recs += "\t%s\n" % (len(content)
555 and content or 'Not available')
556 else:
557 impu_recs += "IMS public user identity: Can't read, response code = %s\n" % (
558 sw)
559 return impu_recs
Supreeth Herle0c02d8a2020-03-26 09:00:06 +0100560
Harald Weltec91085e2022-02-10 18:05:45 +0100561 def update_impu(self, impu=None):
562 hex_str = ""
563 if impu:
564 hex_str = s2h(impu)
565 # Build TLV
566 tlv = TLV(['80'])
567 content = tlv.build({'80': hex_str})
Supreeth Herlebe7007e2020-03-26 09:27:45 +0100568
Harald Weltec91085e2022-02-10 18:05:45 +0100569 rec_size_bytes = self._scc.record_size(EF_ISIM_ADF_map['IMPU'])
570 impu_tlv = rpad(content, rec_size_bytes*2)
571 data, sw = self._scc.update_record(
572 EF_ISIM_ADF_map['IMPU'], 1, impu_tlv)
573 return sw
Supreeth Herlebe7007e2020-03-26 09:27:45 +0100574
Harald Weltec91085e2022-02-10 18:05:45 +0100575 def read_iari(self):
576 rec_cnt = self._scc.record_count(EF_ISIM_ADF_map['UICCIARI'])
577 uiari_recs = ""
578 for i in range(0, rec_cnt):
579 (res, sw) = self._scc.read_record(
580 EF_ISIM_ADF_map['UICCIARI'], i + 1)
581 if sw == '9000':
582 # Skip the initial tag value ('80') byte and get length of contents
583 length = int(res[2:4], 16)
584 content = h2s(res[4:4+(length*2)])
585 uiari_recs += "\t%s\n" % (len(content)
586 and content or 'Not available')
587 else:
588 uiari_recs += "UICC IARI: Can't read, response code = %s\n" % (
589 sw)
590 return uiari_recs
591
Harald Welte6ca2fa72022-02-12 16:29:31 +0100592 def update_ist(self, service, bit=1):
593 (res, sw) = self._scc.read_binary(EF_ISIM_ADF_map['IST'])
594 if sw == '9000':
595 content = enc_st(res, service, bit)
596 (res, sw) = self._scc.update_binary(
597 EF_ISIM_ADF_map['IST'], content)
598 return sw
599
Sylvain Munaut76504e02010-12-07 00:24:32 +0100600
Philipp Maierbb73e512021-05-05 16:14:00 +0200601class MagicSimBase(abc.ABC, SimCard):
Harald Weltec91085e2022-02-10 18:05:45 +0100602 """
603 Theses cards uses several record based EFs to store the provider infos,
604 each possible provider uses a specific record number in each EF. The
605 indexes used are ( where N is the number of providers supported ) :
606 - [2 .. N+1] for the operator name
607 - [1 .. N] for the programmable EFs
Sylvain Munaut76504e02010-12-07 00:24:32 +0100608
Harald Weltec91085e2022-02-10 18:05:45 +0100609 * 3f00/7f4d/8f0c : Operator Name
Sylvain Munaut76504e02010-12-07 00:24:32 +0100610
Harald Weltec91085e2022-02-10 18:05:45 +0100611 bytes 0-15 : provider name, padded with 0xff
612 byte 16 : length of the provider name
613 byte 17 : 01 for valid records, 00 otherwise
Sylvain Munaut76504e02010-12-07 00:24:32 +0100614
Harald Weltec91085e2022-02-10 18:05:45 +0100615 * 3f00/7f4d/8f0d : Programmable Binary EFs
Sylvain Munaut76504e02010-12-07 00:24:32 +0100616
Harald Weltec91085e2022-02-10 18:05:45 +0100617 * 3f00/7f4d/8f0e : Programmable Record EFs
Sylvain Munaut76504e02010-12-07 00:24:32 +0100618
Harald Weltec91085e2022-02-10 18:05:45 +0100619 """
Sylvain Munaut76504e02010-12-07 00:24:32 +0100620
Harald Weltec91085e2022-02-10 18:05:45 +0100621 _files = {} # type: Dict[str, Tuple[str, int, bool]]
622 _ki_file = None # type: Optional[str]
Vadim Yanitskiy03c67f72021-05-02 02:10:39 +0200623
Harald Weltec91085e2022-02-10 18:05:45 +0100624 @classmethod
625 def autodetect(kls, scc):
626 try:
627 for p, l, t in kls._files.values():
628 if not t:
629 continue
630 if scc.record_size(['3f00', '7f4d', p]) != l:
631 return None
632 except:
633 return None
Sylvain Munaut76504e02010-12-07 00:24:32 +0100634
Harald Weltec91085e2022-02-10 18:05:45 +0100635 return kls(scc)
Sylvain Munaut76504e02010-12-07 00:24:32 +0100636
Harald Weltec91085e2022-02-10 18:05:45 +0100637 def _get_count(self):
638 """
639 Selects the file and returns the total number of entries
640 and entry size
641 """
642 f = self._files['name']
Sylvain Munaut76504e02010-12-07 00:24:32 +0100643
Harald Weltec91085e2022-02-10 18:05:45 +0100644 r = self._scc.select_path(['3f00', '7f4d', f[0]])
645 rec_len = int(r[-1][28:30], 16)
646 tlen = int(r[-1][4:8], 16)
647 rec_cnt = (tlen // rec_len) - 1
Sylvain Munaut76504e02010-12-07 00:24:32 +0100648
Harald Weltec91085e2022-02-10 18:05:45 +0100649 if (rec_cnt < 1) or (rec_len != f[1]):
650 raise RuntimeError('Bad card type')
Sylvain Munaut76504e02010-12-07 00:24:32 +0100651
Harald Weltec91085e2022-02-10 18:05:45 +0100652 return rec_cnt
Sylvain Munaut76504e02010-12-07 00:24:32 +0100653
Harald Weltec91085e2022-02-10 18:05:45 +0100654 def program(self, p):
655 # Go to dir
656 self._scc.select_path(['3f00', '7f4d'])
Sylvain Munaut76504e02010-12-07 00:24:32 +0100657
Harald Weltec91085e2022-02-10 18:05:45 +0100658 # Home PLMN in PLMN_Sel format
659 hplmn = enc_plmn(p['mcc'], p['mnc'])
Sylvain Munaut76504e02010-12-07 00:24:32 +0100660
Harald Weltec91085e2022-02-10 18:05:45 +0100661 # Operator name ( 3f00/7f4d/8f0c )
662 self._scc.update_record(self._files['name'][0], 2,
663 rpad(b2h(p['name']), 32) + ('%02x' %
664 len(p['name'])) + '01'
665 )
Sylvain Munaut76504e02010-12-07 00:24:32 +0100666
Harald Weltec91085e2022-02-10 18:05:45 +0100667 # ICCID/IMSI/Ki/HPLMN ( 3f00/7f4d/8f0d )
668 v = ''
Sylvain Munaut76504e02010-12-07 00:24:32 +0100669
Harald Weltec91085e2022-02-10 18:05:45 +0100670 # inline Ki
671 if self._ki_file is None:
672 v += p['ki']
Sylvain Munaut76504e02010-12-07 00:24:32 +0100673
Harald Weltec91085e2022-02-10 18:05:45 +0100674 # ICCID
675 v += '3f00' + '2fe2' + '0a' + enc_iccid(p['iccid'])
Sylvain Munaut76504e02010-12-07 00:24:32 +0100676
Harald Weltec91085e2022-02-10 18:05:45 +0100677 # IMSI
678 v += '7f20' + '6f07' + '09' + enc_imsi(p['imsi'])
Sylvain Munaut76504e02010-12-07 00:24:32 +0100679
Harald Weltec91085e2022-02-10 18:05:45 +0100680 # Ki
681 if self._ki_file:
682 v += self._ki_file + '10' + p['ki']
Sylvain Munaut76504e02010-12-07 00:24:32 +0100683
Harald Weltec91085e2022-02-10 18:05:45 +0100684 # PLMN_Sel
685 v += '6f30' + '18' + rpad(hplmn, 36)
Sylvain Munaut76504e02010-12-07 00:24:32 +0100686
Harald Weltec91085e2022-02-10 18:05:45 +0100687 # ACC
688 # This doesn't work with "fake" SuperSIM cards,
689 # but will hopefully work with real SuperSIMs.
690 if p.get('acc') is not None:
691 v += '6f78' + '02' + lpad(p['acc'], 4)
Alexander Chemeris21885242013-07-02 16:56:55 +0400692
Harald Weltec91085e2022-02-10 18:05:45 +0100693 self._scc.update_record(self._files['b_ef'][0], 1,
694 rpad(v, self._files['b_ef'][1]*2)
695 )
Sylvain Munaut76504e02010-12-07 00:24:32 +0100696
Harald Weltec91085e2022-02-10 18:05:45 +0100697 # SMSP ( 3f00/7f4d/8f0e )
698 # FIXME
Sylvain Munaut76504e02010-12-07 00:24:32 +0100699
Harald Weltec91085e2022-02-10 18:05:45 +0100700 # Write PLMN_Sel forcefully as well
701 r = self._scc.select_path(['3f00', '7f20', '6f30'])
702 tl = int(r[-1][4:8], 16)
Sylvain Munaut76504e02010-12-07 00:24:32 +0100703
Harald Weltec91085e2022-02-10 18:05:45 +0100704 hplmn = enc_plmn(p['mcc'], p['mnc'])
705 self._scc.update_binary('6f30', hplmn + 'ff' * (tl-3))
Sylvain Munaut76504e02010-12-07 00:24:32 +0100706
Harald Weltec91085e2022-02-10 18:05:45 +0100707 def erase(self):
708 # Dummy
709 df = {}
710 for k, v in self._files.items():
711 ofs = 1
712 fv = v[1] * 'ff'
713 if k == 'name':
714 ofs = 2
715 fv = fv[0:-4] + '0000'
716 df[v[0]] = (fv, ofs)
Sylvain Munaut76504e02010-12-07 00:24:32 +0100717
Harald Weltec91085e2022-02-10 18:05:45 +0100718 # Write
719 for n in range(0, self._get_count()):
720 for k, (msg, ofs) in df.items():
721 self._scc.update_record(['3f00', '7f4d', k], n + ofs, msg)
Sylvain Munaut76504e02010-12-07 00:24:32 +0100722
723
Vadim Yanitskiy85302d62021-05-02 02:18:42 +0200724class SuperSim(MagicSimBase):
Sylvain Munaut76504e02010-12-07 00:24:32 +0100725
Harald Weltec91085e2022-02-10 18:05:45 +0100726 name = 'supersim'
Sylvain Munaut76504e02010-12-07 00:24:32 +0100727
Harald Weltec91085e2022-02-10 18:05:45 +0100728 _files = {
729 'name': ('8f0c', 18, True),
730 'b_ef': ('8f0d', 74, True),
731 'r_ef': ('8f0e', 50, True),
732 }
Sylvain Munaut76504e02010-12-07 00:24:32 +0100733
Harald Weltec91085e2022-02-10 18:05:45 +0100734 _ki_file = None
Sylvain Munaut76504e02010-12-07 00:24:32 +0100735
736
Vadim Yanitskiy85302d62021-05-02 02:18:42 +0200737class MagicSim(MagicSimBase):
Sylvain Munaut76504e02010-12-07 00:24:32 +0100738
Harald Weltec91085e2022-02-10 18:05:45 +0100739 name = 'magicsim'
Sylvain Munaut76504e02010-12-07 00:24:32 +0100740
Harald Weltec91085e2022-02-10 18:05:45 +0100741 _files = {
742 'name': ('8f0c', 18, True),
743 'b_ef': ('8f0d', 130, True),
744 'r_ef': ('8f0e', 102, False),
745 }
Sylvain Munaut76504e02010-12-07 00:24:32 +0100746
Harald Weltec91085e2022-02-10 18:05:45 +0100747 _ki_file = '6f1b'
Sylvain Munaut76504e02010-12-07 00:24:32 +0100748
749
Philipp Maierbb73e512021-05-05 16:14:00 +0200750class FakeMagicSim(SimCard):
Harald Weltec91085e2022-02-10 18:05:45 +0100751 """
752 Theses cards have a record based EF 3f00/000c that contains the provider
753 information. See the program method for its format. The records go from
754 1 to N.
755 """
Sylvain Munaut76504e02010-12-07 00:24:32 +0100756
Harald Weltec91085e2022-02-10 18:05:45 +0100757 name = 'fakemagicsim'
Sylvain Munaut76504e02010-12-07 00:24:32 +0100758
Harald Weltec91085e2022-02-10 18:05:45 +0100759 @classmethod
760 def autodetect(kls, scc):
761 try:
762 if scc.record_size(['3f00', '000c']) != 0x5a:
763 return None
764 except:
765 return None
Sylvain Munaut76504e02010-12-07 00:24:32 +0100766
Harald Weltec91085e2022-02-10 18:05:45 +0100767 return kls(scc)
Sylvain Munaut76504e02010-12-07 00:24:32 +0100768
Harald Weltec91085e2022-02-10 18:05:45 +0100769 def _get_infos(self):
770 """
771 Selects the file and returns the total number of entries
772 and entry size
773 """
Sylvain Munaut76504e02010-12-07 00:24:32 +0100774
Harald Weltec91085e2022-02-10 18:05:45 +0100775 r = self._scc.select_path(['3f00', '000c'])
776 rec_len = int(r[-1][28:30], 16)
777 tlen = int(r[-1][4:8], 16)
778 rec_cnt = (tlen // rec_len) - 1
Sylvain Munaut76504e02010-12-07 00:24:32 +0100779
Harald Weltec91085e2022-02-10 18:05:45 +0100780 if (rec_cnt < 1) or (rec_len != 0x5a):
781 raise RuntimeError('Bad card type')
Sylvain Munaut76504e02010-12-07 00:24:32 +0100782
Harald Weltec91085e2022-02-10 18:05:45 +0100783 return rec_cnt, rec_len
Sylvain Munaut76504e02010-12-07 00:24:32 +0100784
Harald Weltec91085e2022-02-10 18:05:45 +0100785 def program(self, p):
786 # Home PLMN
787 r = self._scc.select_path(['3f00', '7f20', '6f30'])
788 tl = int(r[-1][4:8], 16)
Sylvain Munaut76504e02010-12-07 00:24:32 +0100789
Harald Weltec91085e2022-02-10 18:05:45 +0100790 hplmn = enc_plmn(p['mcc'], p['mnc'])
791 self._scc.update_binary('6f30', hplmn + 'ff' * (tl-3))
Sylvain Munaut76504e02010-12-07 00:24:32 +0100792
Harald Weltec91085e2022-02-10 18:05:45 +0100793 # Get total number of entries and entry size
794 rec_cnt, rec_len = self._get_infos()
Sylvain Munaut76504e02010-12-07 00:24:32 +0100795
Harald Weltec91085e2022-02-10 18:05:45 +0100796 # Set first entry
797 entry = (
798 '81' + # 1b Status: Valid & Active
799 rpad(s2h(p['name'][0:14]), 28) + # 14b Entry Name
800 enc_iccid(p['iccid']) + # 10b ICCID
801 enc_imsi(p['imsi']) + # 9b IMSI_len + id_type(9) + IMSI
802 p['ki'] + # 16b Ki
803 lpad(p['smsp'], 80) # 40b SMSP (padded with ff if needed)
804 )
805 self._scc.update_record('000c', 1, entry)
Sylvain Munaut76504e02010-12-07 00:24:32 +0100806
Harald Weltec91085e2022-02-10 18:05:45 +0100807 def erase(self):
808 # Get total number of entries and entry size
809 rec_cnt, rec_len = self._get_infos()
Sylvain Munaut76504e02010-12-07 00:24:32 +0100810
Harald Weltec91085e2022-02-10 18:05:45 +0100811 # Erase all entries
812 entry = 'ff' * rec_len
813 for i in range(0, rec_cnt):
814 self._scc.update_record('000c', 1+i, entry)
Sylvain Munaut76504e02010-12-07 00:24:32 +0100815
Sylvain Munaut5da8d4e2013-07-02 15:13:24 +0200816
Philipp Maierbb73e512021-05-05 16:14:00 +0200817class GrcardSim(SimCard):
Harald Weltec91085e2022-02-10 18:05:45 +0100818 """
819 Greencard (grcard.cn) HZCOS GSM SIM
820 These cards have a much more regular ISO 7816-4 / TS 11.11 structure,
821 and use standard UPDATE RECORD / UPDATE BINARY commands except for Ki.
822 """
Harald Welte3156d902011-03-22 21:48:19 +0100823
Harald Weltec91085e2022-02-10 18:05:45 +0100824 name = 'grcardsim'
Harald Welte3156d902011-03-22 21:48:19 +0100825
Harald Weltec91085e2022-02-10 18:05:45 +0100826 @classmethod
827 def autodetect(kls, scc):
828 return None
Harald Welte3156d902011-03-22 21:48:19 +0100829
Harald Weltec91085e2022-02-10 18:05:45 +0100830 def program(self, p):
831 # We don't really know yet what ADM PIN 4 is about
832 #self._scc.verify_chv(4, h2b("4444444444444444"))
Harald Welte3156d902011-03-22 21:48:19 +0100833
Harald Weltec91085e2022-02-10 18:05:45 +0100834 # Authenticate using ADM PIN 5
835 if p['pin_adm']:
836 pin = h2b(p['pin_adm'])
837 else:
838 pin = h2b("4444444444444444")
839 self._scc.verify_chv(5, pin)
Harald Welte3156d902011-03-22 21:48:19 +0100840
Harald Weltec91085e2022-02-10 18:05:45 +0100841 # EF.ICCID
842 r = self._scc.select_path(['3f00', '2fe2'])
843 data, sw = self._scc.update_binary('2fe2', enc_iccid(p['iccid']))
Harald Welte3156d902011-03-22 21:48:19 +0100844
Harald Weltec91085e2022-02-10 18:05:45 +0100845 # EF.IMSI
846 r = self._scc.select_path(['3f00', '7f20', '6f07'])
847 data, sw = self._scc.update_binary('6f07', enc_imsi(p['imsi']))
Harald Welte3156d902011-03-22 21:48:19 +0100848
Harald Weltec91085e2022-02-10 18:05:45 +0100849 # EF.ACC
850 if p.get('acc') is not None:
851 data, sw = self._scc.update_binary('6f78', lpad(p['acc'], 4))
Harald Welte3156d902011-03-22 21:48:19 +0100852
Harald Weltec91085e2022-02-10 18:05:45 +0100853 # EF.SMSP
854 if p.get('smsp'):
855 r = self._scc.select_path(['3f00', '7f10', '6f42'])
856 data, sw = self._scc.update_record('6f42', 1, lpad(p['smsp'], 80))
Harald Welte3156d902011-03-22 21:48:19 +0100857
Harald Weltec91085e2022-02-10 18:05:45 +0100858 # Set the Ki using proprietary command
859 pdu = '80d4020010' + p['ki']
860 data, sw = self._scc._tp.send_apdu(pdu)
Harald Welte3156d902011-03-22 21:48:19 +0100861
Harald Weltec91085e2022-02-10 18:05:45 +0100862 # EF.HPLMN
863 r = self._scc.select_path(['3f00', '7f20', '6f30'])
864 size = int(r[-1][4:8], 16)
865 hplmn = enc_plmn(p['mcc'], p['mnc'])
866 self._scc.update_binary('6f30', hplmn + 'ff' * (size-3))
Harald Welte3156d902011-03-22 21:48:19 +0100867
Harald Weltec91085e2022-02-10 18:05:45 +0100868 # EF.SPN (Service Provider Name)
869 r = self._scc.select_path(['3f00', '7f20', '6f30'])
870 size = int(r[-1][4:8], 16)
871 # FIXME
Harald Welte3156d902011-03-22 21:48:19 +0100872
Harald Weltec91085e2022-02-10 18:05:45 +0100873 # FIXME: EF.MSISDN
Harald Welte3156d902011-03-22 21:48:19 +0100874
Sylvain Munaut76504e02010-12-07 00:24:32 +0100875
Harald Weltee10394b2011-12-07 12:34:14 +0100876class SysmoSIMgr1(GrcardSim):
Harald Weltec91085e2022-02-10 18:05:45 +0100877 """
878 sysmocom sysmoSIM-GR1
879 These cards have a much more regular ISO 7816-4 / TS 11.11 structure,
880 and use standard UPDATE RECORD / UPDATE BINARY commands except for Ki.
881 """
882 name = 'sysmosim-gr1'
Harald Weltee10394b2011-12-07 12:34:14 +0100883
Harald Weltec91085e2022-02-10 18:05:45 +0100884 @classmethod
885 def autodetect(kls, scc):
886 try:
887 # Look for ATR
888 if scc.get_atr() == toBytes("3B 99 18 00 11 88 22 33 44 55 66 77 60"):
889 return kls(scc)
890 except:
891 return None
892 return None
893
Sylvain Munaut5da8d4e2013-07-02 15:13:24 +0200894
Harald Welteca673942020-06-03 15:19:40 +0200895class SysmoUSIMgr1(UsimCard):
Harald Weltec91085e2022-02-10 18:05:45 +0100896 """
897 sysmocom sysmoUSIM-GR1
898 """
899 name = 'sysmoUSIM-GR1'
Holger Hans Peter Freyther4d91bf42012-03-22 14:28:38 +0100900
Harald Weltec91085e2022-02-10 18:05:45 +0100901 @classmethod
902 def autodetect(kls, scc):
903 # TODO: Access the ATR
904 return None
Holger Hans Peter Freyther4d91bf42012-03-22 14:28:38 +0100905
Harald Weltec91085e2022-02-10 18:05:45 +0100906 def program(self, p):
907 # TODO: check if verify_chv could be used or what it needs
908 # self._scc.verify_chv(0x0A, [0x33,0x32,0x32,0x31,0x33,0x32,0x33,0x32])
909 # Unlock the card..
910 data, sw = self._scc._tp.send_apdu_checksw(
911 "0020000A083332323133323332")
Holger Hans Peter Freyther4d91bf42012-03-22 14:28:38 +0100912
Harald Weltec91085e2022-02-10 18:05:45 +0100913 # TODO: move into SimCardCommands
914 par = (p['ki'] + # 16b K
915 p['opc'] + # 32b OPC
916 enc_iccid(p['iccid']) + # 10b ICCID
917 enc_imsi(p['imsi']) # 9b IMSI_len + id_type(9) + IMSI
918 )
919 data, sw = self._scc._tp.send_apdu_checksw("0099000033" + par)
Holger Hans Peter Freyther4d91bf42012-03-22 14:28:38 +0100920
Sylvain Munaut053c8952013-07-02 15:12:32 +0200921
Philipp Maierbb73e512021-05-05 16:14:00 +0200922class SysmoSIMgr2(SimCard):
Harald Weltec91085e2022-02-10 18:05:45 +0100923 """
924 sysmocom sysmoSIM-GR2
925 """
Sylvain Munaut2fc205c2013-12-23 17:22:56 +0100926
Harald Weltec91085e2022-02-10 18:05:45 +0100927 name = 'sysmoSIM-GR2'
Sylvain Munaut2fc205c2013-12-23 17:22:56 +0100928
Harald Weltec91085e2022-02-10 18:05:45 +0100929 @classmethod
930 def autodetect(kls, scc):
931 try:
932 # Look for ATR
933 if scc.get_atr() == toBytes("3B 7D 94 00 00 55 55 53 0A 74 86 93 0B 24 7C 4D 54 68"):
934 return kls(scc)
935 except:
936 return None
937 return None
Sylvain Munaut2fc205c2013-12-23 17:22:56 +0100938
Harald Weltec91085e2022-02-10 18:05:45 +0100939 def program(self, p):
Sylvain Munaut2fc205c2013-12-23 17:22:56 +0100940
Harald Weltec91085e2022-02-10 18:05:45 +0100941 # select MF
942 r = self._scc.select_path(['3f00'])
Daniel Willmann5d8cd9b2020-10-19 11:01:49 +0200943
Harald Weltec91085e2022-02-10 18:05:45 +0100944 # authenticate as SUPER ADM using default key
945 self._scc.verify_chv(0x0b, h2b("3838383838383838"))
Sylvain Munaut2fc205c2013-12-23 17:22:56 +0100946
Harald Weltec91085e2022-02-10 18:05:45 +0100947 # set ADM pin using proprietary command
948 # INS: D4
949 # P1: 3A for PIN, 3B for PUK
950 # P2: CHV number, as in VERIFY CHV for PIN, and as in UNBLOCK CHV for PUK
951 # P3: 08, CHV length (curiously the PUK is also 08 length, instead of 10)
952 if p['pin_adm']:
953 pin = h2b(p['pin_adm'])
954 else:
955 pin = h2b("4444444444444444")
Jan Balkec3ebd332015-01-26 12:22:55 +0100956
Harald Weltec91085e2022-02-10 18:05:45 +0100957 pdu = 'A0D43A0508' + b2h(pin)
958 data, sw = self._scc._tp.send_apdu(pdu)
Daniel Willmann5d8cd9b2020-10-19 11:01:49 +0200959
Harald Weltec91085e2022-02-10 18:05:45 +0100960 # authenticate as ADM (enough to write file, and can set PINs)
Jan Balkec3ebd332015-01-26 12:22:55 +0100961
Harald Weltec91085e2022-02-10 18:05:45 +0100962 self._scc.verify_chv(0x05, pin)
Sylvain Munaut2fc205c2013-12-23 17:22:56 +0100963
Harald Weltec91085e2022-02-10 18:05:45 +0100964 # write EF.ICCID
965 data, sw = self._scc.update_binary('2fe2', enc_iccid(p['iccid']))
Sylvain Munaut2fc205c2013-12-23 17:22:56 +0100966
Harald Weltec91085e2022-02-10 18:05:45 +0100967 # select DF_GSM
968 r = self._scc.select_path(['7f20'])
Daniel Willmann5d8cd9b2020-10-19 11:01:49 +0200969
Harald Weltec91085e2022-02-10 18:05:45 +0100970 # write EF.IMSI
971 data, sw = self._scc.update_binary('6f07', enc_imsi(p['imsi']))
Sylvain Munaut2fc205c2013-12-23 17:22:56 +0100972
Harald Weltec91085e2022-02-10 18:05:45 +0100973 # write EF.ACC
974 if p.get('acc') is not None:
975 data, sw = self._scc.update_binary('6f78', lpad(p['acc'], 4))
Sylvain Munaut2fc205c2013-12-23 17:22:56 +0100976
Harald Weltec91085e2022-02-10 18:05:45 +0100977 # get size and write EF.HPLMN
978 r = self._scc.select_path(['6f30'])
979 size = int(r[-1][4:8], 16)
980 hplmn = enc_plmn(p['mcc'], p['mnc'])
981 self._scc.update_binary('6f30', hplmn + 'ff' * (size-3))
Sylvain Munaut2fc205c2013-12-23 17:22:56 +0100982
Harald Weltec91085e2022-02-10 18:05:45 +0100983 # set COMP128 version 0 in proprietary file
984 data, sw = self._scc.update_binary('0001', '001000')
Sylvain Munaut2fc205c2013-12-23 17:22:56 +0100985
Harald Weltec91085e2022-02-10 18:05:45 +0100986 # set Ki in proprietary file
987 data, sw = self._scc.update_binary('0001', p['ki'], 3)
Sylvain Munaut2fc205c2013-12-23 17:22:56 +0100988
Harald Weltec91085e2022-02-10 18:05:45 +0100989 # select DF_TELECOM
990 r = self._scc.select_path(['3f00', '7f10'])
Daniel Willmann5d8cd9b2020-10-19 11:01:49 +0200991
Harald Weltec91085e2022-02-10 18:05:45 +0100992 # write EF.SMSP
993 if p.get('smsp'):
994 data, sw = self._scc.update_record('6f42', 1, lpad(p['smsp'], 80))
Sylvain Munaut2fc205c2013-12-23 17:22:56 +0100995
Sylvain Munaut2fc205c2013-12-23 17:22:56 +0100996
Harald Welteca673942020-06-03 15:19:40 +0200997class SysmoUSIMSJS1(UsimCard):
Harald Weltec91085e2022-02-10 18:05:45 +0100998 """
999 sysmocom sysmoUSIM-SJS1
1000 """
Jan Balke3e840672015-01-26 15:36:27 +01001001
Harald Weltec91085e2022-02-10 18:05:45 +01001002 name = 'sysmoUSIM-SJS1'
Jan Balke3e840672015-01-26 15:36:27 +01001003
Harald Weltec91085e2022-02-10 18:05:45 +01001004 def __init__(self, ssc):
1005 super(SysmoUSIMSJS1, self).__init__(ssc)
1006 self._scc.cla_byte = "00"
1007 self._scc.sel_ctrl = "0004" # request an FCP
Jan Balke3e840672015-01-26 15:36:27 +01001008
Harald Weltec91085e2022-02-10 18:05:45 +01001009 @classmethod
1010 def autodetect(kls, scc):
1011 try:
1012 # Look for ATR
1013 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"):
1014 return kls(scc)
1015 except:
1016 return None
1017 return None
Jan Balke3e840672015-01-26 15:36:27 +01001018
Harald Weltec91085e2022-02-10 18:05:45 +01001019 def verify_adm(self, key):
1020 # authenticate as ADM using default key (written on the card..)
1021 if not key:
1022 raise ValueError(
1023 "Please provide a PIN-ADM as there is no default one")
1024 (res, sw) = self._scc.verify_chv(0x0A, key)
1025 return sw
Harald Weltea6704252021-01-08 20:19:11 +01001026
Harald Weltec91085e2022-02-10 18:05:45 +01001027 def program(self, p):
1028 self.verify_adm(h2b(p['pin_adm']))
Jan Balke3e840672015-01-26 15:36:27 +01001029
Harald Weltec91085e2022-02-10 18:05:45 +01001030 # select MF
1031 r = self._scc.select_path(['3f00'])
Jan Balke3e840672015-01-26 15:36:27 +01001032
Harald Weltec91085e2022-02-10 18:05:45 +01001033 # write EF.ICCID
1034 data, sw = self._scc.update_binary('2fe2', enc_iccid(p['iccid']))
Philipp Maiere9604882017-03-21 17:24:31 +01001035
Harald Weltec91085e2022-02-10 18:05:45 +01001036 # select DF_GSM
1037 r = self._scc.select_path(['7f20'])
Jan Balke3e840672015-01-26 15:36:27 +01001038
Harald Weltec91085e2022-02-10 18:05:45 +01001039 # set Ki in proprietary file
1040 data, sw = self._scc.update_binary('00FF', p['ki'])
Jan Balke3e840672015-01-26 15:36:27 +01001041
Harald Weltec91085e2022-02-10 18:05:45 +01001042 # set OPc in proprietary file
1043 if 'opc' in p:
1044 content = "01" + p['opc']
1045 data, sw = self._scc.update_binary('00F7', content)
Jan Balke3e840672015-01-26 15:36:27 +01001046
Harald Weltec91085e2022-02-10 18:05:45 +01001047 # set Service Provider Name
1048 if p.get('name') is not None:
1049 self.update_spn(p['name'], True, True)
Supreeth Herle7947d922019-06-08 07:50:53 +02001050
Harald Weltec91085e2022-02-10 18:05:45 +01001051 if p.get('acc') is not None:
1052 self.update_acc(p['acc'])
Supreeth Herlec8796a32019-12-23 12:23:42 +01001053
Harald Weltec91085e2022-02-10 18:05:45 +01001054 # write EF.IMSI
1055 data, sw = self._scc.update_binary('6f07', enc_imsi(p['imsi']))
Jan Balke3e840672015-01-26 15:36:27 +01001056
Harald Weltec91085e2022-02-10 18:05:45 +01001057 # EF.PLMNsel
1058 if p.get('mcc') and p.get('mnc'):
1059 sw = self.update_plmnsel(p['mcc'], p['mnc'])
1060 if sw != '9000':
1061 print("Programming PLMNsel failed with code %s" % sw)
Philipp Maier2d15ea02019-03-20 12:40:36 +01001062
Harald Weltec91085e2022-02-10 18:05:45 +01001063 # EF.PLMNwAcT
1064 if p.get('mcc') and p.get('mnc'):
1065 sw = self.update_plmn_act(p['mcc'], p['mnc'])
1066 if sw != '9000':
1067 print("Programming PLMNwAcT failed with code %s" % sw)
Philipp Maier2d15ea02019-03-20 12:40:36 +01001068
Harald Weltec91085e2022-02-10 18:05:45 +01001069 # EF.OPLMNwAcT
1070 if p.get('mcc') and p.get('mnc'):
1071 sw = self.update_oplmn_act(p['mcc'], p['mnc'])
1072 if sw != '9000':
1073 print("Programming OPLMNwAcT failed with code %s" % sw)
Philipp Maier2d15ea02019-03-20 12:40:36 +01001074
Harald Weltec91085e2022-02-10 18:05:45 +01001075 # EF.HPLMNwAcT
1076 if p.get('mcc') and p.get('mnc'):
1077 sw = self.update_hplmn_act(p['mcc'], p['mnc'])
1078 if sw != '9000':
1079 print("Programming HPLMNwAcT failed with code %s" % sw)
Supreeth Herlef442fb42020-01-21 12:47:32 +01001080
Harald Weltec91085e2022-02-10 18:05:45 +01001081 # EF.AD
1082 if (p.get('mcc') and p.get('mnc')) or p.get('opmode'):
1083 if p.get('mcc') and p.get('mnc'):
1084 mnc = p['mnc']
1085 else:
1086 mnc = None
1087 sw = self.update_ad(mnc=mnc, opmode=p.get('opmode'))
1088 if sw != '9000':
1089 print("Programming AD failed with code %s" % sw)
Philipp Maier2d15ea02019-03-20 12:40:36 +01001090
Harald Weltec91085e2022-02-10 18:05:45 +01001091 # EF.SMSP
1092 if p.get('smsp'):
1093 r = self._scc.select_path(['3f00', '7f10'])
1094 data, sw = self._scc.update_record(
1095 '6f42', 1, lpad(p['smsp'], 104), force_len=True)
Jan Balke3e840672015-01-26 15:36:27 +01001096
Harald Weltec91085e2022-02-10 18:05:45 +01001097 # EF.MSISDN
1098 # TODO: Alpha Identifier (currently 'ff'O * 20)
1099 # TODO: Capability/Configuration1 Record Identifier
1100 # TODO: Extension1 Record Identifier
1101 if p.get('msisdn') is not None:
1102 msisdn = enc_msisdn(p['msisdn'])
1103 data = 'ff' * 20 + msisdn
Supreeth Herle5a541012019-12-22 08:59:16 +01001104
Harald Weltec91085e2022-02-10 18:05:45 +01001105 r = self._scc.select_path(['3f00', '7f10'])
1106 data, sw = self._scc.update_record('6F40', 1, data, force_len=True)
Supreeth Herle5a541012019-12-22 08:59:16 +01001107
Alexander Chemerise0d9d882018-01-10 14:18:32 +09001108
herlesupreeth4a3580b2020-09-29 10:11:36 +02001109class FairwavesSIM(UsimCard):
Harald Weltec91085e2022-02-10 18:05:45 +01001110 """
1111 FairwavesSIM
Alexander Chemerise0d9d882018-01-10 14:18:32 +09001112
Harald Weltec91085e2022-02-10 18:05:45 +01001113 The SIM card is operating according to the standard.
1114 For Ki/OP/OPC programming the following files are additionally open for writing:
1115 3F00/7F20/FF01 – OP/OPC:
1116 byte 1 = 0x01, bytes 2-17: OPC;
1117 byte 1 = 0x00, bytes 2-17: OP;
1118 3F00/7F20/FF02: Ki
1119 """
Alexander Chemerise0d9d882018-01-10 14:18:32 +09001120
Harald Weltec91085e2022-02-10 18:05:45 +01001121 name = 'Fairwaves-SIM'
1122 # Propriatary files
1123 _EF_num = {
1124 'Ki': 'FF02',
1125 'OP/OPC': 'FF01',
1126 }
1127 _EF = {
1128 'Ki': DF['GSM']+[_EF_num['Ki']],
1129 'OP/OPC': DF['GSM']+[_EF_num['OP/OPC']],
1130 }
Alexander Chemerise0d9d882018-01-10 14:18:32 +09001131
Harald Weltec91085e2022-02-10 18:05:45 +01001132 def __init__(self, ssc):
1133 super(FairwavesSIM, self).__init__(ssc)
1134 self._adm_chv_num = 0x11
1135 self._adm2_chv_num = 0x12
Alexander Chemerise0d9d882018-01-10 14:18:32 +09001136
Harald Weltec91085e2022-02-10 18:05:45 +01001137 @classmethod
1138 def autodetect(kls, scc):
1139 try:
1140 # Look for ATR
1141 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"):
1142 return kls(scc)
1143 except:
1144 return None
1145 return None
Alexander Chemerise0d9d882018-01-10 14:18:32 +09001146
Harald Weltec91085e2022-02-10 18:05:45 +01001147 def verify_adm2(self, key):
1148 '''
1149 Authenticate with ADM2 key.
Alexander Chemerise0d9d882018-01-10 14:18:32 +09001150
Harald Weltec91085e2022-02-10 18:05:45 +01001151 Fairwaves SIM cards support hierarchical key structure and ADM2 key
1152 is a key which has access to proprietary files (Ki and OP/OPC).
1153 That said, ADM key inherits permissions of ADM2 key and thus we rarely
1154 need ADM2 key per se.
1155 '''
1156 (res, sw) = self._scc.verify_chv(self._adm2_chv_num, key)
1157 return sw
Alexander Chemerise0d9d882018-01-10 14:18:32 +09001158
Harald Weltec91085e2022-02-10 18:05:45 +01001159 def read_ki(self):
1160 """
1161 Read Ki in proprietary file.
Alexander Chemerise0d9d882018-01-10 14:18:32 +09001162
Harald Weltec91085e2022-02-10 18:05:45 +01001163 Requires ADM1 access level
1164 """
1165 return self._scc.read_binary(self._EF['Ki'])
Alexander Chemerise0d9d882018-01-10 14:18:32 +09001166
Harald Weltec91085e2022-02-10 18:05:45 +01001167 def update_ki(self, ki):
1168 """
1169 Set 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 data, sw = self._scc.update_binary(self._EF['Ki'], ki)
1174 return sw
Alexander Chemerise0d9d882018-01-10 14:18:32 +09001175
Harald Weltec91085e2022-02-10 18:05:45 +01001176 def read_op_opc(self):
1177 """
1178 Read Ki in proprietary file.
Alexander Chemerise0d9d882018-01-10 14:18:32 +09001179
Harald Weltec91085e2022-02-10 18:05:45 +01001180 Requires ADM1 access level
1181 """
1182 (ef, sw) = self._scc.read_binary(self._EF['OP/OPC'])
1183 type = 'OP' if ef[0:2] == '00' else 'OPC'
1184 return ((type, ef[2:]), sw)
Alexander Chemerise0d9d882018-01-10 14:18:32 +09001185
Harald Weltec91085e2022-02-10 18:05:45 +01001186 def update_op(self, op):
1187 """
1188 Set OP in proprietary file.
Alexander Chemerise0d9d882018-01-10 14:18:32 +09001189
Harald Weltec91085e2022-02-10 18:05:45 +01001190 Requires ADM1 access level
1191 """
1192 content = '00' + op
1193 data, sw = self._scc.update_binary(self._EF['OP/OPC'], content)
1194 return sw
Alexander Chemerise0d9d882018-01-10 14:18:32 +09001195
Harald Weltec91085e2022-02-10 18:05:45 +01001196 def update_opc(self, opc):
1197 """
1198 Set OPC in proprietary file.
Alexander Chemerise0d9d882018-01-10 14:18:32 +09001199
Harald Weltec91085e2022-02-10 18:05:45 +01001200 Requires ADM1 access level
1201 """
1202 content = '01' + opc
1203 data, sw = self._scc.update_binary(self._EF['OP/OPC'], content)
1204 return sw
Alexander Chemerise0d9d882018-01-10 14:18:32 +09001205
Harald Weltec91085e2022-02-10 18:05:45 +01001206 def program(self, p):
1207 # For some reason the card programming only works when the card
1208 # is handled as a classic SIM, even though it is an USIM, so we
1209 # reconfigure the class byte and the select control field on
1210 # the fly. When the programming is done the original values are
1211 # restored.
1212 cla_byte_orig = self._scc.cla_byte
1213 sel_ctrl_orig = self._scc.sel_ctrl
1214 self._scc.cla_byte = "a0"
1215 self._scc.sel_ctrl = "0000"
Alexander Chemerise0d9d882018-01-10 14:18:32 +09001216
Harald Weltec91085e2022-02-10 18:05:45 +01001217 try:
1218 self._program(p)
1219 finally:
1220 # restore original cla byte and sel ctrl
1221 self._scc.cla_byte = cla_byte_orig
1222 self._scc.sel_ctrl = sel_ctrl_orig
Alexander Chemerise0d9d882018-01-10 14:18:32 +09001223
Harald Weltec91085e2022-02-10 18:05:45 +01001224 def _program(self, p):
1225 # authenticate as ADM1
1226 if not p['pin_adm']:
1227 raise ValueError(
1228 "Please provide a PIN-ADM as there is no default one")
1229 self.verify_adm(h2b(p['pin_adm']))
Alexander Chemerise0d9d882018-01-10 14:18:32 +09001230
Harald Weltec91085e2022-02-10 18:05:45 +01001231 # TODO: Set operator name
1232 if p.get('smsp') is not None:
1233 sw = self.update_smsp(p['smsp'])
1234 if sw != '9000':
1235 print("Programming SMSP failed with code %s" % sw)
1236 # This SIM doesn't support changing ICCID
1237 if p.get('mcc') is not None and p.get('mnc') is not None:
1238 sw = self.update_hplmn_act(p['mcc'], p['mnc'])
1239 if sw != '9000':
1240 print("Programming MCC/MNC failed with code %s" % sw)
1241 if p.get('imsi') is not None:
1242 sw = self.update_imsi(p['imsi'])
1243 if sw != '9000':
1244 print("Programming IMSI failed with code %s" % sw)
1245 if p.get('ki') is not None:
1246 sw = self.update_ki(p['ki'])
1247 if sw != '9000':
1248 print("Programming Ki failed with code %s" % sw)
1249 if p.get('opc') is not None:
1250 sw = self.update_opc(p['opc'])
1251 if sw != '9000':
1252 print("Programming OPC failed with code %s" % sw)
1253 if p.get('acc') is not None:
1254 sw = self.update_acc(p['acc'])
1255 if sw != '9000':
1256 print("Programming ACC failed with code %s" % sw)
Alexander Chemerise0d9d882018-01-10 14:18:32 +09001257
1258
Philipp Maierbb73e512021-05-05 16:14:00 +02001259class OpenCellsSim(SimCard):
Harald Weltec91085e2022-02-10 18:05:45 +01001260 """
1261 OpenCellsSim
Todd Neal9eeadfc2018-04-25 15:36:29 -05001262
Harald Weltec91085e2022-02-10 18:05:45 +01001263 """
Todd Neal9eeadfc2018-04-25 15:36:29 -05001264
Harald Weltec91085e2022-02-10 18:05:45 +01001265 name = 'OpenCells-SIM'
Todd Neal9eeadfc2018-04-25 15:36:29 -05001266
Harald Weltec91085e2022-02-10 18:05:45 +01001267 def __init__(self, ssc):
1268 super(OpenCellsSim, self).__init__(ssc)
1269 self._adm_chv_num = 0x0A
Todd Neal9eeadfc2018-04-25 15:36:29 -05001270
Harald Weltec91085e2022-02-10 18:05:45 +01001271 @classmethod
1272 def autodetect(kls, scc):
1273 try:
1274 # Look for ATR
1275 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"):
1276 return kls(scc)
1277 except:
1278 return None
1279 return None
Todd Neal9eeadfc2018-04-25 15:36:29 -05001280
Harald Weltec91085e2022-02-10 18:05:45 +01001281 def program(self, p):
1282 if not p['pin_adm']:
1283 raise ValueError(
1284 "Please provide a PIN-ADM as there is no default one")
1285 self._scc.verify_chv(0x0A, h2b(p['pin_adm']))
Todd Neal9eeadfc2018-04-25 15:36:29 -05001286
Harald Weltec91085e2022-02-10 18:05:45 +01001287 # select MF
1288 r = self._scc.select_path(['3f00'])
Todd Neal9eeadfc2018-04-25 15:36:29 -05001289
Harald Weltec91085e2022-02-10 18:05:45 +01001290 # write EF.ICCID
1291 data, sw = self._scc.update_binary('2fe2', enc_iccid(p['iccid']))
Todd Neal9eeadfc2018-04-25 15:36:29 -05001292
Harald Weltec91085e2022-02-10 18:05:45 +01001293 r = self._scc.select_path(['7ff0'])
Todd Neal9eeadfc2018-04-25 15:36:29 -05001294
Harald Weltec91085e2022-02-10 18:05:45 +01001295 # set Ki in proprietary file
1296 data, sw = self._scc.update_binary('FF02', p['ki'])
Todd Neal9eeadfc2018-04-25 15:36:29 -05001297
Harald Weltec91085e2022-02-10 18:05:45 +01001298 # set OPC in proprietary file
1299 data, sw = self._scc.update_binary('FF01', p['opc'])
Todd Neal9eeadfc2018-04-25 15:36:29 -05001300
Harald Weltec91085e2022-02-10 18:05:45 +01001301 # select DF_GSM
1302 r = self._scc.select_path(['7f20'])
Todd Neal9eeadfc2018-04-25 15:36:29 -05001303
Harald Weltec91085e2022-02-10 18:05:45 +01001304 # write EF.IMSI
1305 data, sw = self._scc.update_binary('6f07', enc_imsi(p['imsi']))
Todd Neal9eeadfc2018-04-25 15:36:29 -05001306
Todd Neal9eeadfc2018-04-25 15:36:29 -05001307
herlesupreeth4a3580b2020-09-29 10:11:36 +02001308class WavemobileSim(UsimCard):
Harald Weltec91085e2022-02-10 18:05:45 +01001309 """
1310 WavemobileSim
Philipp Maierc8ce82a2018-07-04 17:57:20 +02001311
Harald Weltec91085e2022-02-10 18:05:45 +01001312 """
Philipp Maierc8ce82a2018-07-04 17:57:20 +02001313
Harald Weltec91085e2022-02-10 18:05:45 +01001314 name = 'Wavemobile-SIM'
Philipp Maierc8ce82a2018-07-04 17:57:20 +02001315
Harald Weltec91085e2022-02-10 18:05:45 +01001316 def __init__(self, ssc):
1317 super(WavemobileSim, self).__init__(ssc)
1318 self._adm_chv_num = 0x0A
1319 self._scc.cla_byte = "00"
1320 self._scc.sel_ctrl = "0004" # request an FCP
Philipp Maierc8ce82a2018-07-04 17:57:20 +02001321
Harald Weltec91085e2022-02-10 18:05:45 +01001322 @classmethod
1323 def autodetect(kls, scc):
1324 try:
1325 # Look for ATR
1326 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"):
1327 return kls(scc)
1328 except:
1329 return None
1330 return None
Philipp Maierc8ce82a2018-07-04 17:57:20 +02001331
Harald Weltec91085e2022-02-10 18:05:45 +01001332 def program(self, p):
1333 if not p['pin_adm']:
1334 raise ValueError(
1335 "Please provide a PIN-ADM as there is no default one")
1336 self.verify_adm(h2b(p['pin_adm']))
Philipp Maierc8ce82a2018-07-04 17:57:20 +02001337
Harald Weltec91085e2022-02-10 18:05:45 +01001338 # EF.ICCID
1339 # TODO: Add programming of the ICCID
1340 if p.get('iccid'):
1341 print(
1342 "Warning: Programming of the ICCID is not implemented for this type of card.")
Philipp Maierc8ce82a2018-07-04 17:57:20 +02001343
Philipp Maierde0cf162023-01-03 13:29:45 +01001344 # KI (Presumably a proprietary file)
Harald Weltec91085e2022-02-10 18:05:45 +01001345 # TODO: Add programming of KI
1346 if p.get('ki'):
1347 print(
1348 "Warning: Programming of the KI is not implemented for this type of card.")
Philipp Maierc8ce82a2018-07-04 17:57:20 +02001349
Philipp Maierde0cf162023-01-03 13:29:45 +01001350 # OPc (Presumably a proprietary file)
Harald Weltec91085e2022-02-10 18:05:45 +01001351 # TODO: Add programming of OPc
1352 if p.get('opc'):
1353 print(
1354 "Warning: Programming of the OPc is not implemented for this type of card.")
Philipp Maierc8ce82a2018-07-04 17:57:20 +02001355
Harald Weltec91085e2022-02-10 18:05:45 +01001356 # EF.SMSP
1357 if p.get('smsp'):
1358 sw = self.update_smsp(p['smsp'])
1359 if sw != '9000':
1360 print("Programming SMSP failed with code %s" % sw)
Philipp Maierc8ce82a2018-07-04 17:57:20 +02001361
Harald Weltec91085e2022-02-10 18:05:45 +01001362 # EF.IMSI
1363 if p.get('imsi'):
1364 sw = self.update_imsi(p['imsi'])
1365 if sw != '9000':
1366 print("Programming IMSI failed with code %s" % sw)
Philipp Maierc8ce82a2018-07-04 17:57:20 +02001367
Harald Weltec91085e2022-02-10 18:05:45 +01001368 # EF.ACC
1369 if p.get('acc'):
1370 sw = self.update_acc(p['acc'])
1371 if sw != '9000':
1372 print("Programming ACC failed with code %s" % sw)
Philipp Maierc8ce82a2018-07-04 17:57:20 +02001373
Harald Weltec91085e2022-02-10 18:05:45 +01001374 # EF.PLMNsel
1375 if p.get('mcc') and p.get('mnc'):
1376 sw = self.update_plmnsel(p['mcc'], p['mnc'])
1377 if sw != '9000':
1378 print("Programming PLMNsel failed with code %s" % sw)
Philipp Maierc8ce82a2018-07-04 17:57:20 +02001379
Harald Weltec91085e2022-02-10 18:05:45 +01001380 # EF.PLMNwAcT
1381 if p.get('mcc') and p.get('mnc'):
1382 sw = self.update_plmn_act(p['mcc'], p['mnc'])
1383 if sw != '9000':
1384 print("Programming PLMNwAcT failed with code %s" % sw)
Philipp Maierc8ce82a2018-07-04 17:57:20 +02001385
Harald Weltec91085e2022-02-10 18:05:45 +01001386 # EF.OPLMNwAcT
1387 if p.get('mcc') and p.get('mnc'):
1388 sw = self.update_oplmn_act(p['mcc'], p['mnc'])
1389 if sw != '9000':
1390 print("Programming OPLMNwAcT failed with code %s" % sw)
Philipp Maierc8ce82a2018-07-04 17:57:20 +02001391
Harald Weltec91085e2022-02-10 18:05:45 +01001392 # EF.AD
1393 if (p.get('mcc') and p.get('mnc')) or p.get('opmode'):
1394 if p.get('mcc') and p.get('mnc'):
1395 mnc = p['mnc']
1396 else:
1397 mnc = None
1398 sw = self.update_ad(mnc=mnc, opmode=p.get('opmode'))
1399 if sw != '9000':
1400 print("Programming AD failed with code %s" % sw)
Philipp Maier6e507a72019-04-01 16:33:48 +02001401
Harald Weltec91085e2022-02-10 18:05:45 +01001402 return None
Philipp Maierc8ce82a2018-07-04 17:57:20 +02001403
Todd Neal9eeadfc2018-04-25 15:36:29 -05001404
herlesupreethb0c7d122020-12-23 09:25:46 +01001405class SysmoISIMSJA2(UsimCard, IsimCard):
Harald Weltec91085e2022-02-10 18:05:45 +01001406 """
1407 sysmocom sysmoISIM-SJA2
1408 """
Philipp Maier0ad5bcf2019-12-31 17:55:47 +01001409
Harald Weltec91085e2022-02-10 18:05:45 +01001410 name = 'sysmoISIM-SJA2'
Philipp Maier0ad5bcf2019-12-31 17:55:47 +01001411
Harald Weltec91085e2022-02-10 18:05:45 +01001412 def __init__(self, ssc):
1413 super(SysmoISIMSJA2, self).__init__(ssc)
1414 self._scc.cla_byte = "00"
1415 self._scc.sel_ctrl = "0004" # request an FCP
Philipp Maier0ad5bcf2019-12-31 17:55:47 +01001416
Harald Weltec91085e2022-02-10 18:05:45 +01001417 @classmethod
1418 def autodetect(kls, scc):
1419 try:
1420 # Try card model #1
1421 atr = "3B 9F 96 80 1F 87 80 31 E0 73 FE 21 1B 67 4A 4C 75 30 34 05 4B A9"
1422 if scc.get_atr() == toBytes(atr):
1423 return kls(scc)
Philipp Maier0ad5bcf2019-12-31 17:55:47 +01001424
Harald Weltec91085e2022-02-10 18:05:45 +01001425 # Try card model #2
1426 atr = "3B 9F 96 80 1F 87 80 31 E0 73 FE 21 1B 67 4A 4C 75 31 33 02 51 B2"
1427 if scc.get_atr() == toBytes(atr):
1428 return kls(scc)
Philipp Maierb3e11ea2020-03-11 12:32:44 +01001429
Harald Weltec91085e2022-02-10 18:05:45 +01001430 # Try card model #3
1431 atr = "3B 9F 96 80 1F 87 80 31 E0 73 FE 21 1B 67 4A 4C 52 75 31 04 51 D5"
1432 if scc.get_atr() == toBytes(atr):
1433 return kls(scc)
1434 except:
1435 return None
1436 return None
Philipp Maier0ad5bcf2019-12-31 17:55:47 +01001437
Harald Weltec91085e2022-02-10 18:05:45 +01001438 def verify_adm(self, key):
1439 # authenticate as ADM using default key (written on the card..)
1440 if not key:
1441 raise ValueError(
1442 "Please provide a PIN-ADM as there is no default one")
1443 (res, sw) = self._scc.verify_chv(0x0A, key)
1444 return sw
Harald Weltea6704252021-01-08 20:19:11 +01001445
Harald Weltec91085e2022-02-10 18:05:45 +01001446 def program(self, p):
1447 self.verify_adm(h2b(p['pin_adm']))
Philipp Maier0ad5bcf2019-12-31 17:55:47 +01001448
Philipp Maier84902402023-02-10 18:23:36 +01001449 # Populate AIDs
1450 self.read_aids()
1451
Harald Weltec91085e2022-02-10 18:05:45 +01001452 # This type of card does not allow to reprogram the ICCID.
1453 # Reprogramming the ICCID would mess up the card os software
1454 # license management, so the ICCID must be kept at its factory
1455 # setting!
1456 if p.get('iccid'):
1457 print(
1458 "Warning: Programming of the ICCID is not implemented for this type of card.")
Philipp Maier0ad5bcf2019-12-31 17:55:47 +01001459
Harald Weltec91085e2022-02-10 18:05:45 +01001460 # select DF_GSM
1461 self._scc.select_path(['7f20'])
Philipp Maier0ad5bcf2019-12-31 17:55:47 +01001462
Harald Weltec91085e2022-02-10 18:05:45 +01001463 # set Service Provider Name
1464 if p.get('name') is not None:
1465 self.update_spn(p['name'], True, True)
Robert Falkenberg54595362021-04-06 12:04:34 +02001466
Harald Weltec91085e2022-02-10 18:05:45 +01001467 # write EF.IMSI
1468 if p.get('imsi'):
1469 self._scc.update_binary('6f07', enc_imsi(p['imsi']))
Philipp Maier0ad5bcf2019-12-31 17:55:47 +01001470
Harald Weltec91085e2022-02-10 18:05:45 +01001471 # EF.PLMNsel
1472 if p.get('mcc') and p.get('mnc'):
1473 sw = self.update_plmnsel(p['mcc'], p['mnc'])
1474 if sw != '9000':
1475 print("Programming PLMNsel failed with code %s" % sw)
Philipp Maier0ad5bcf2019-12-31 17:55:47 +01001476
Harald Weltec91085e2022-02-10 18:05:45 +01001477 # EF.PLMNwAcT
1478 if p.get('mcc') and p.get('mnc'):
1479 sw = self.update_plmn_act(p['mcc'], p['mnc'])
1480 if sw != '9000':
1481 print("Programming PLMNwAcT failed with code %s" % sw)
Philipp Maier0ad5bcf2019-12-31 17:55:47 +01001482
Harald Weltec91085e2022-02-10 18:05:45 +01001483 # EF.OPLMNwAcT
1484 if p.get('mcc') and p.get('mnc'):
1485 sw = self.update_oplmn_act(p['mcc'], p['mnc'])
1486 if sw != '9000':
1487 print("Programming OPLMNwAcT failed with code %s" % sw)
Philipp Maier0ad5bcf2019-12-31 17:55:47 +01001488
Harald Weltec91085e2022-02-10 18:05:45 +01001489 # EF.HPLMNwAcT
1490 if p.get('mcc') and p.get('mnc'):
1491 sw = self.update_hplmn_act(p['mcc'], p['mnc'])
1492 if sw != '9000':
1493 print("Programming HPLMNwAcT failed with code %s" % sw)
Harald Welte32f0d412020-05-05 17:35:57 +02001494
Harald Weltec91085e2022-02-10 18:05:45 +01001495 # EF.AD
1496 if (p.get('mcc') and p.get('mnc')) or p.get('opmode'):
1497 if p.get('mcc') and p.get('mnc'):
1498 mnc = p['mnc']
1499 else:
1500 mnc = None
1501 sw = self.update_ad(mnc=mnc, opmode=p.get('opmode'))
1502 if sw != '9000':
1503 print("Programming AD failed with code %s" % sw)
Philipp Maier0ad5bcf2019-12-31 17:55:47 +01001504
Harald Weltec91085e2022-02-10 18:05:45 +01001505 # EF.SMSP
1506 if p.get('smsp'):
1507 r = self._scc.select_path(['3f00', '7f10'])
1508 data, sw = self._scc.update_record(
1509 '6f42', 1, lpad(p['smsp'], 104), force_len=True)
Philipp Maier0ad5bcf2019-12-31 17:55:47 +01001510
Harald Weltec91085e2022-02-10 18:05:45 +01001511 # EF.MSISDN
1512 # TODO: Alpha Identifier (currently 'ff'O * 20)
1513 # TODO: Capability/Configuration1 Record Identifier
1514 # TODO: Extension1 Record Identifier
1515 if p.get('msisdn') is not None:
1516 msisdn = enc_msisdn(p['msisdn'])
1517 content = 'ff' * 20 + msisdn
Supreeth Herlec6019232020-03-26 10:00:45 +01001518
Harald Weltec91085e2022-02-10 18:05:45 +01001519 r = self._scc.select_path(['3f00', '7f10'])
1520 data, sw = self._scc.update_record(
1521 '6F40', 1, content, force_len=True)
Supreeth Herlec6019232020-03-26 10:00:45 +01001522
Harald Weltec91085e2022-02-10 18:05:45 +01001523 # EF.ACC
1524 if p.get('acc'):
1525 sw = self.update_acc(p['acc'])
1526 if sw != '9000':
1527 print("Programming ACC failed with code %s" % sw)
Supreeth Herlea97944b2020-03-26 10:03:25 +01001528
Harald Weltec91085e2022-02-10 18:05:45 +01001529 # update EF-SIM_AUTH_KEY (and EF-USIM_AUTH_KEY_2G, which is
1530 # hard linked to EF-USIM_AUTH_KEY)
1531 self._scc.select_path(['3f00'])
1532 self._scc.select_path(['a515'])
1533 if p.get('ki'):
1534 self._scc.update_binary('6f20', p['ki'], 1)
1535 if p.get('opc'):
1536 self._scc.update_binary('6f20', p['opc'], 17)
Philipp Maier0ad5bcf2019-12-31 17:55:47 +01001537
Harald Weltec91085e2022-02-10 18:05:45 +01001538 # update EF-USIM_AUTH_KEY in ADF.ISIM
Philipp Maier84902402023-02-10 18:23:36 +01001539 if self.adf_present("isim"):
1540 self.select_adf_by_aid(adf="isim")
1541
Harald Weltec91085e2022-02-10 18:05:45 +01001542 if p.get('ki'):
1543 self._scc.update_binary('af20', p['ki'], 1)
1544 if p.get('opc'):
1545 self._scc.update_binary('af20', p['opc'], 17)
Philipp Maier0ad5bcf2019-12-31 17:55:47 +01001546
Harald Weltec91085e2022-02-10 18:05:45 +01001547 # update EF.P-CSCF in ADF.ISIM
1548 if self.file_exists(EF_ISIM_ADF_map['PCSCF']):
1549 if p.get('pcscf'):
1550 sw = self.update_pcscf(p['pcscf'])
1551 else:
1552 sw = self.update_pcscf("")
1553 if sw != '9000':
1554 print("Programming P-CSCF failed with code %s" % sw)
Supreeth Herlecf727f22020-03-24 17:32:21 +01001555
Harald Weltec91085e2022-02-10 18:05:45 +01001556 # update EF.DOMAIN in ADF.ISIM
1557 if self.file_exists(EF_ISIM_ADF_map['DOMAIN']):
1558 if p.get('ims_hdomain'):
1559 sw = self.update_domain(domain=p['ims_hdomain'])
1560 else:
1561 sw = self.update_domain()
Supreeth Herlecf727f22020-03-24 17:32:21 +01001562
Harald Weltec91085e2022-02-10 18:05:45 +01001563 if sw != '9000':
1564 print(
1565 "Programming Home Network Domain Name failed with code %s" % sw)
Supreeth Herle79f43dd2020-03-25 11:43:19 +01001566
Harald Weltec91085e2022-02-10 18:05:45 +01001567 # update EF.IMPI in ADF.ISIM
1568 # TODO: Validate IMPI input
1569 if self.file_exists(EF_ISIM_ADF_map['IMPI']):
1570 if p.get('impi'):
1571 sw = self.update_impi(p['impi'])
1572 else:
1573 sw = self.update_impi()
1574 if sw != '9000':
1575 print("Programming IMPI failed with code %s" % sw)
Supreeth Herle79f43dd2020-03-25 11:43:19 +01001576
Harald Weltec91085e2022-02-10 18:05:45 +01001577 # update EF.IMPU in ADF.ISIM
1578 # TODO: Validate IMPU input
1579 # Support multiple IMPU if there is enough space
1580 if self.file_exists(EF_ISIM_ADF_map['IMPU']):
1581 if p.get('impu'):
1582 sw = self.update_impu(p['impu'])
1583 else:
1584 sw = self.update_impu()
1585 if sw != '9000':
1586 print("Programming IMPU failed with code %s" % sw)
Supreeth Herlea5bd9682020-03-26 09:16:14 +01001587
Philipp Maier84902402023-02-10 18:23:36 +01001588 if self.adf_present("usim"):
1589 self.select_adf_by_aid(adf="usim")
1590
Philipp Maier284ac102023-01-17 14:26:56 +01001591 # EF.AD in ADF.USIM
1592 if (p.get('mcc') and p.get('mnc')) or p.get('opmode'):
1593 if p.get('mcc') and p.get('mnc'):
1594 mnc = p['mnc']
1595 else:
1596 mnc = None
1597 sw = self.update_ad(mnc=mnc, opmode=p.get('opmode'),
1598 path=EF_USIM_ADF_map['AD'])
1599 if sw != '9000':
1600 print("Programming AD failed with code %s" % sw)
1601
Harald Weltec91085e2022-02-10 18:05:45 +01001602 # update EF-USIM_AUTH_KEY in ADF.USIM
1603 if p.get('ki'):
1604 self._scc.update_binary('af20', p['ki'], 1)
1605 if p.get('opc'):
1606 self._scc.update_binary('af20', p['opc'], 17)
Supreeth Herlebe7007e2020-03-26 09:27:45 +01001607
Harald Weltec91085e2022-02-10 18:05:45 +01001608 # update EF.EHPLMN in ADF.USIM
1609 if self.file_exists(EF_USIM_ADF_map['EHPLMN']):
1610 if p.get('mcc') and p.get('mnc'):
1611 sw = self.update_ehplmn(p['mcc'], p['mnc'])
1612 if sw != '9000':
1613 print("Programming EHPLMN failed with code %s" % sw)
Philipp Maier0ad5bcf2019-12-31 17:55:47 +01001614
Harald Weltec91085e2022-02-10 18:05:45 +01001615 # update EF.ePDGId in ADF.USIM
1616 if self.file_exists(EF_USIM_ADF_map['ePDGId']):
1617 if p.get('epdgid'):
1618 sw = self.update_epdgid(p['epdgid'])
1619 else:
1620 sw = self.update_epdgid("")
1621 if sw != '9000':
1622 print("Programming ePDGId failed with code %s" % sw)
Supreeth Herle8e0fccd2020-03-23 12:10:56 +01001623
Harald Weltec91085e2022-02-10 18:05:45 +01001624 # update EF.ePDGSelection in ADF.USIM
1625 if self.file_exists(EF_USIM_ADF_map['ePDGSelection']):
1626 if p.get('epdgSelection'):
1627 epdg_plmn = p['epdgSelection']
1628 sw = self.update_ePDGSelection(
1629 epdg_plmn[:3], epdg_plmn[3:])
1630 else:
1631 sw = self.update_ePDGSelection("", "")
1632 if sw != '9000':
1633 print("Programming ePDGSelection failed with code %s" % sw)
Supreeth Herle8e0fccd2020-03-23 12:10:56 +01001634
Harald Weltec91085e2022-02-10 18:05:45 +01001635 # After successfully programming EF.ePDGId and EF.ePDGSelection,
1636 # Set service 106 and 107 as available in EF.UST
1637 # Disable service 95, 99, 115 if ISIM application is present
1638 if self.file_exists(EF_USIM_ADF_map['UST']):
1639 if p.get('epdgSelection') and p.get('epdgid'):
1640 sw = self.update_ust(106, 1)
1641 if sw != '9000':
1642 print("Programming UST failed with code %s" % sw)
1643 sw = self.update_ust(107, 1)
1644 if sw != '9000':
1645 print("Programming UST failed with code %s" % sw)
Supreeth Herlef964df42020-03-24 13:15:37 +01001646
Harald Weltec91085e2022-02-10 18:05:45 +01001647 sw = self.update_ust(95, 0)
1648 if sw != '9000':
1649 print("Programming UST failed with code %s" % sw)
1650 sw = self.update_ust(99, 0)
1651 if sw != '9000':
1652 print("Programming UST failed with code %s" % sw)
1653 sw = self.update_ust(115, 0)
1654 if sw != '9000':
1655 print("Programming UST failed with code %s" % sw)
Supreeth Herlef964df42020-03-24 13:15:37 +01001656
Harald Weltec91085e2022-02-10 18:05:45 +01001657 return
Philipp Maier0ad5bcf2019-12-31 17:55:47 +01001658
Philipp Maier0ad5bcf2019-12-31 17:55:47 +01001659
Todd Neal9eeadfc2018-04-25 15:36:29 -05001660# In order for autodetection ...
Harald Weltec91085e2022-02-10 18:05:45 +01001661_cards_classes = [FakeMagicSim, SuperSim, MagicSim, GrcardSim,
1662 SysmoSIMgr1, SysmoSIMgr2, SysmoUSIMgr1, SysmoUSIMSJS1,
1663 FairwavesSIM, OpenCellsSim, WavemobileSim, SysmoISIMSJA2]
1664
Alexander Chemeris8ad124a2018-01-10 14:17:55 +09001665
Supreeth Herle4c306ab2020-03-18 11:38:00 +01001666def card_detect(ctype, scc):
Harald Weltec91085e2022-02-10 18:05:45 +01001667 # Detect type if needed
1668 card = None
1669 ctypes = dict([(kls.name, kls) for kls in _cards_classes])
Supreeth Herle4c306ab2020-03-18 11:38:00 +01001670
Harald Weltec91085e2022-02-10 18:05:45 +01001671 if ctype == "auto":
1672 for kls in _cards_classes:
1673 card = kls.autodetect(scc)
1674 if card:
1675 print("Autodetected card type: %s" % card.name)
1676 card.reset()
1677 break
Supreeth Herle4c306ab2020-03-18 11:38:00 +01001678
Harald Weltec91085e2022-02-10 18:05:45 +01001679 if card is None:
1680 print("Autodetection failed")
1681 return None
Supreeth Herle4c306ab2020-03-18 11:38:00 +01001682
Harald Weltec91085e2022-02-10 18:05:45 +01001683 elif ctype in ctypes:
1684 card = ctypes[ctype](scc)
Supreeth Herle4c306ab2020-03-18 11:38:00 +01001685
Harald Weltec91085e2022-02-10 18:05:45 +01001686 else:
1687 raise ValueError("Unknown card type: %s" % ctype)
Supreeth Herle4c306ab2020-03-18 11:38:00 +01001688
Harald Weltec91085e2022-02-10 18:05:45 +01001689 return card