blob: c6bb194956fffe1f1f2b4d47ddca7b60c57f8695 [file] [log] [blame]
Alexander Chemeris067f69c2017-07-18 16:44:26 +03001# -*- coding: utf-8 -*-
2
Harald Welte14105dc2021-05-31 08:48:51 +02003# without this, pylint will fail when inner classes are used
4# within the 'nested' kwarg of our TlvMeta metaclass on python 3.7 :(
5# pylint: disable=undefined-variable
6
Harald Welteb2edd142021-01-08 23:29:35 +01007""" Various constants from ETSI TS 151.011 +
8Representation of the GSM SIM/USIM/ISIM filesystem hierarchy.
9
10The File (and its derived classes) uses the classes of pySim.filesystem in
11order to describe the files specified in the relevant ETSI + 3GPP specifications.
Alexander Chemeris067f69c2017-07-18 16:44:26 +030012"""
13
14#
15# Copyright (C) 2017 Alexander.Chemeris <Alexander.Chemeris@gmail.com>
Harald Welteb2edd142021-01-08 23:29:35 +010016# Copyright (C) 2021 Harald Welte <laforge@osmocom.org>
Alexander Chemeris067f69c2017-07-18 16:44:26 +030017#
18# This program is free software: you can redistribute it and/or modify
19# it under the terms of the GNU General Public License as published by
20# the Free Software Foundation, either version 2 of the License, or
21# (at your option) any later version.
22#
23# This program is distributed in the hope that it will be useful,
24# but WITHOUT ANY WARRANTY; without even the implied warranty of
25# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
26# GNU General Public License for more details.
27#
28# You should have received a copy of the GNU General Public License
29# along with this program. If not, see <http://www.gnu.org/licenses/>.
30#
31
Harald Weltec91085e2022-02-10 18:05:45 +010032from pySim.profile import match_sim
33from pySim.profile import CardProfile
34from pySim.filesystem import *
Harald Welte228ae8e2022-07-17 22:01:04 +020035from pySim.ts_31_102_telecom import DF_PHONEBOOK, DF_MULTIMEDIA, DF_MCS, DF_V2X
Harald Weltec91085e2022-02-10 18:05:45 +010036import enum
37from pySim.construct import *
38from construct import Optional as COptional
39from construct import *
40from struct import pack, unpack
41from typing import Tuple
42from pySim.tlv import *
43from pySim.utils import *
Alexander Chemeris067f69c2017-07-18 16:44:26 +030044MF_num = '3F00'
45
46DF_num = {
Harald Weltec91085e2022-02-10 18:05:45 +010047 'TELECOM': '7F10',
Alexander Chemeris067f69c2017-07-18 16:44:26 +030048
Harald Weltec91085e2022-02-10 18:05:45 +010049 'GSM': '7F20',
50 'IS-41': '7F22',
51 'FP-CTS': '7F23',
Alexander Chemeris067f69c2017-07-18 16:44:26 +030052
Harald Weltec91085e2022-02-10 18:05:45 +010053 'GRAPHICS': '5F50',
Alexander Chemeris067f69c2017-07-18 16:44:26 +030054
Harald Weltec91085e2022-02-10 18:05:45 +010055 'IRIDIUM': '5F30',
56 'GLOBST': '5F31',
57 'ICO': '5F32',
58 'ACeS': '5F33',
Alexander Chemeris067f69c2017-07-18 16:44:26 +030059
Harald Weltec91085e2022-02-10 18:05:45 +010060 'EIA/TIA-553': '5F40',
61 'CTS': '5F60',
62 'SOLSA': '5F70',
Alexander Chemeris067f69c2017-07-18 16:44:26 +030063
Harald Weltec91085e2022-02-10 18:05:45 +010064 'MExE': '5F3C',
Alexander Chemeris067f69c2017-07-18 16:44:26 +030065}
66
67EF_num = {
Harald Weltec91085e2022-02-10 18:05:45 +010068 # MF
69 'ICCID': '2FE2',
70 'ELP': '2F05',
71 'DIR': '2F00',
Alexander Chemeris067f69c2017-07-18 16:44:26 +030072
Harald Weltec91085e2022-02-10 18:05:45 +010073 # DF_TELECOM
74 'ADN': '6F3A',
75 'FDN': '6F3B',
76 'SMS': '6F3C',
77 'CCP': '6F3D',
78 'MSISDN': '6F40',
79 'SMSP': '6F42',
80 'SMSS': '6F43',
81 'LND': '6F44',
82 'SMSR': '6F47',
83 'SDN': '6F49',
84 'EXT1': '6F4A',
85 'EXT2': '6F4B',
86 'EXT3': '6F4C',
87 'BDN': '6F4D',
88 'EXT4': '6F4E',
89 'CMI': '6F58',
90 'ECCP': '6F4F',
Alexander Chemeris067f69c2017-07-18 16:44:26 +030091
Harald Weltec91085e2022-02-10 18:05:45 +010092 # DF_GRAPHICS
93 'IMG': '4F20',
Alexander Chemeris067f69c2017-07-18 16:44:26 +030094
Harald Weltec91085e2022-02-10 18:05:45 +010095 # DF_SoLSA
96 'SAI': '4F30',
97 'SLL': '4F31',
Alexander Chemeris067f69c2017-07-18 16:44:26 +030098
Harald Weltec91085e2022-02-10 18:05:45 +010099 # DF_MExE
100 'MExE-ST': '4F40',
101 'ORPK': '4F41',
102 'ARPK': '4F42',
103 'TPRPK': '4F43',
Alexander Chemeris067f69c2017-07-18 16:44:26 +0300104
Harald Weltec91085e2022-02-10 18:05:45 +0100105 # DF_GSM
106 'LP': '6F05',
107 'IMSI': '6F07',
108 'Kc': '6F20',
109 'DCK': '6F2C',
110 'PLMNsel': '6F30',
111 'HPPLMN': '6F31',
112 'CNL': '6F32',
113 'ACMmax': '6F37',
114 'SST': '6F38',
115 'ACM': '6F39',
116 'GID1': '6F3E',
117 'GID2': '6F3F',
118 'PUCT': '6F41',
119 'CBMI': '6F45',
120 'SPN': '6F46',
121 'CBMID': '6F48',
122 'BCCH': '6F74',
123 'ACC': '6F78',
124 'FPLMN': '6F7B',
125 'LOCI': '6F7E',
126 'AD': '6FAD',
127 'PHASE': '6FAE',
128 'VGCS': '6FB1',
129 'VGCSS': '6FB2',
130 'VBS': '6FB3',
131 'VBSS': '6FB4',
132 'eMLPP': '6FB5',
133 'AAeM': '6FB6',
134 'ECC': '6FB7',
135 'CBMIR': '6F50',
136 'NIA': '6F51',
137 'KcGPRS': '6F52',
138 'LOCIGPRS': '6F53',
139 'SUME': '6F54',
140 'PLMNwAcT': '6F60',
141 'OPLMNwAcT': '6F61',
142 # Figure 8 names it HPLMNAcT, but in the text it's names it HPLMNwAcT
143 'HPLMNAcT': '6F62',
144 'HPLMNwAcT': '6F62',
145 'CPBCCH': '6F63',
146 'INVSCAN': '6F64',
147 'PNN': '6FC5',
148 'OPL': '6FC6',
149 'MBDN': '6FC7',
150 'EXT6': '6FC8',
151 'MBI': '6FC9',
152 'MWIS': '6FCA',
153 'CFIS': '6FCB',
154 'EXT7': '6FCC',
155 'SPDI': '6FCD',
156 'MMSN': '6FCE',
157 'EXT8': '6FCF',
158 'MMSICP': '6FD0',
159 'MMSUP': '6FD1',
160 'MMSUCP': '6FD2',
Alexander Chemeris067f69c2017-07-18 16:44:26 +0300161}
162
163DF = {
Harald Weltec91085e2022-02-10 18:05:45 +0100164 'TELECOM': [MF_num, DF_num['TELECOM']],
Alexander Chemeris067f69c2017-07-18 16:44:26 +0300165
Harald Weltec91085e2022-02-10 18:05:45 +0100166 'GSM': [MF_num, DF_num['GSM']],
167 'IS-41': [MF_num, DF_num['IS-41']],
168 'FP-CTS': [MF_num, DF_num['FP-CTS']],
Alexander Chemeris067f69c2017-07-18 16:44:26 +0300169
Harald Weltec91085e2022-02-10 18:05:45 +0100170 'GRAPHICS': [MF_num, DF_num['GRAPHICS']],
Alexander Chemeris067f69c2017-07-18 16:44:26 +0300171
Harald Weltec91085e2022-02-10 18:05:45 +0100172 'IRIDIUM': [MF_num, DF_num['IRIDIUM']],
173 'GLOBST': [MF_num, DF_num['GLOBST']],
174 'ICO': [MF_num, DF_num['ICO']],
175 'ACeS': [MF_num, DF_num['ACeS']],
Alexander Chemeris067f69c2017-07-18 16:44:26 +0300176
Harald Weltec91085e2022-02-10 18:05:45 +0100177 'EIA/TIA-553': [MF_num, DF_num['EIA/TIA-553']],
178 'CTS': [MF_num, DF_num['CTS']],
179 'SoLSA': [MF_num, DF_num['SOLSA']],
Alexander Chemeris067f69c2017-07-18 16:44:26 +0300180
Harald Weltec91085e2022-02-10 18:05:45 +0100181 'MExE': [MF_num, DF_num['MExE']],
Alexander Chemeris067f69c2017-07-18 16:44:26 +0300182}
183
184
185EF = {
Harald Weltec91085e2022-02-10 18:05:45 +0100186 'ICCID': [MF_num, EF_num['ICCID']],
187 'ELP': [MF_num, EF_num['ELP']],
188 'DIR': [MF_num, EF_num['DIR']],
Alexander Chemeris067f69c2017-07-18 16:44:26 +0300189
Harald Weltec91085e2022-02-10 18:05:45 +0100190 'ADN': DF['TELECOM']+[EF_num['ADN']],
191 'FDN': DF['TELECOM']+[EF_num['FDN']],
192 'SMS': DF['TELECOM']+[EF_num['SMS']],
193 'CCP': DF['TELECOM']+[EF_num['CCP']],
194 'MSISDN': DF['TELECOM']+[EF_num['MSISDN']],
195 'SMSP': DF['TELECOM']+[EF_num['SMSP']],
196 'SMSS': DF['TELECOM']+[EF_num['SMSS']],
197 'LND': DF['TELECOM']+[EF_num['LND']],
198 'SMSR': DF['TELECOM']+[EF_num['SMSR']],
199 'SDN': DF['TELECOM']+[EF_num['SDN']],
200 'EXT1': DF['TELECOM']+[EF_num['EXT1']],
201 'EXT2': DF['TELECOM']+[EF_num['EXT2']],
202 'EXT3': DF['TELECOM']+[EF_num['EXT3']],
203 'BDN': DF['TELECOM']+[EF_num['BDN']],
204 'EXT4': DF['TELECOM']+[EF_num['EXT4']],
205 'CMI': DF['TELECOM']+[EF_num['CMI']],
206 'ECCP': DF['TELECOM']+[EF_num['ECCP']],
Alexander Chemeris067f69c2017-07-18 16:44:26 +0300207
Harald Weltec91085e2022-02-10 18:05:45 +0100208 'IMG': DF['GRAPHICS']+[EF_num['IMG']],
Alexander Chemeris067f69c2017-07-18 16:44:26 +0300209
Harald Weltec91085e2022-02-10 18:05:45 +0100210 'SAI': DF['SoLSA']+[EF_num['SAI']],
211 'SLL': DF['SoLSA']+[EF_num['SLL']],
Alexander Chemeris067f69c2017-07-18 16:44:26 +0300212
Harald Weltec91085e2022-02-10 18:05:45 +0100213 'MExE-ST': DF['MExE']+[EF_num['MExE-ST']],
214 'ORPK': DF['MExE']+[EF_num['ORPK']],
215 'ARPK': DF['MExE']+[EF_num['ARPK']],
216 'TPRPK': DF['MExE']+[EF_num['TPRPK']],
Alexander Chemeris067f69c2017-07-18 16:44:26 +0300217
Harald Weltec91085e2022-02-10 18:05:45 +0100218 'LP': DF['GSM']+[EF_num['LP']],
219 'IMSI': DF['GSM']+[EF_num['IMSI']],
220 'Kc': DF['GSM']+[EF_num['Kc']],
221 'DCK': DF['GSM']+[EF_num['DCK']],
222 'PLMNsel': DF['GSM']+[EF_num['PLMNsel']],
223 'HPPLMN': DF['GSM']+[EF_num['HPPLMN']],
224 'CNL': DF['GSM']+[EF_num['CNL']],
225 'ACMmax': DF['GSM']+[EF_num['ACMmax']],
226 'SST': DF['GSM']+[EF_num['SST']],
227 'ACM': DF['GSM']+[EF_num['ACM']],
228 'GID1': DF['GSM']+[EF_num['GID1']],
229 'GID2': DF['GSM']+[EF_num['GID2']],
230 'PUCT': DF['GSM']+[EF_num['PUCT']],
231 'CBMI': DF['GSM']+[EF_num['CBMI']],
232 'SPN': DF['GSM']+[EF_num['SPN']],
233 'CBMID': DF['GSM']+[EF_num['CBMID']],
234 'BCCH': DF['GSM']+[EF_num['BCCH']],
235 'ACC': DF['GSM']+[EF_num['ACC']],
236 'FPLMN': DF['GSM']+[EF_num['FPLMN']],
237 'LOCI': DF['GSM']+[EF_num['LOCI']],
238 'AD': DF['GSM']+[EF_num['AD']],
239 'PHASE': DF['GSM']+[EF_num['PHASE']],
240 'VGCS': DF['GSM']+[EF_num['VGCS']],
241 'VGCSS': DF['GSM']+[EF_num['VGCSS']],
242 'VBS': DF['GSM']+[EF_num['VBS']],
243 'VBSS': DF['GSM']+[EF_num['VBSS']],
244 'eMLPP': DF['GSM']+[EF_num['eMLPP']],
245 'AAeM': DF['GSM']+[EF_num['AAeM']],
246 'ECC': DF['GSM']+[EF_num['ECC']],
247 'CBMIR': DF['GSM']+[EF_num['CBMIR']],
248 'NIA': DF['GSM']+[EF_num['NIA']],
249 'KcGPRS': DF['GSM']+[EF_num['KcGPRS']],
250 'LOCIGPRS': DF['GSM']+[EF_num['LOCIGPRS']],
251 'SUME': DF['GSM']+[EF_num['SUME']],
252 'PLMNwAcT': DF['GSM']+[EF_num['PLMNwAcT']],
253 'OPLMNwAcT': DF['GSM']+[EF_num['OPLMNwAcT']],
254 # Figure 8 names it HPLMNAcT, but in the text it's names it HPLMNwAcT
255 'HPLMNAcT': DF['GSM']+[EF_num['HPLMNAcT']],
256 'HPLMNwAcT': DF['GSM']+[EF_num['HPLMNAcT']],
257 'CPBCCH': DF['GSM']+[EF_num['CPBCCH']],
258 'INVSCAN': DF['GSM']+[EF_num['INVSCAN']],
259 'PNN': DF['GSM']+[EF_num['PNN']],
260 'OPL': DF['GSM']+[EF_num['OPL']],
261 'MBDN': DF['GSM']+[EF_num['MBDN']],
262 'EXT6': DF['GSM']+[EF_num['EXT6']],
263 'MBI': DF['GSM']+[EF_num['MBI']],
264 'MWIS': DF['GSM']+[EF_num['MWIS']],
265 'CFIS': DF['GSM']+[EF_num['CFIS']],
266 'EXT7': DF['GSM']+[EF_num['EXT7']],
267 'SPDI': DF['GSM']+[EF_num['SPDI']],
268 'MMSN': DF['GSM']+[EF_num['MMSN']],
269 'EXT8': DF['GSM']+[EF_num['EXT8']],
270 'MMSICP': DF['GSM']+[EF_num['MMSICP']],
271 'MMSUP': DF['GSM']+[EF_num['MMSUP']],
272 'MMSUCP': DF['GSM']+[EF_num['MMSUCP']],
Alexander Chemeris067f69c2017-07-18 16:44:26 +0300273}
Supreeth Herlebf5d6022020-03-20 15:18:27 +0100274
275# Mapping between SIM Service Number and its description
276EF_SST_map = {
Harald Weltec91085e2022-02-10 18:05:45 +0100277 1: 'CHV1 disable function',
278 2: 'Abbreviated Dialling Numbers (ADN)',
279 3: 'Fixed Dialling Numbers (FDN)',
280 4: 'Short Message Storage (SMS)',
281 5: 'Advice of Charge (AoC)',
282 6: 'Capability Configuration Parameters (CCP)',
283 7: 'PLMN selector',
284 8: 'RFU',
285 9: 'MSISDN',
286 10: 'Extension1',
287 11: 'Extension2',
288 12: 'SMS Parameters',
289 13: 'Last Number Dialled (LND)',
290 14: 'Cell Broadcast Message Identifier',
291 15: 'Group Identifier Level 1',
292 16: 'Group Identifier Level 2',
293 17: 'Service Provider Name',
294 18: 'Service Dialling Numbers (SDN)',
295 19: 'Extension3',
296 20: 'RFU',
297 21: 'VGCS Group Identifier List (EFVGCS and EFVGCSS)',
298 22: 'VBS Group Identifier List (EFVBS and EFVBSS)',
299 23: 'enhanced Multi-Level Precedence and Pre-emption Service',
300 24: 'Automatic Answer for eMLPP',
301 25: 'Data download via SMS-CB',
302 26: 'Data download via SMS-PP',
303 27: 'Menu selection',
304 28: 'Call control',
305 29: 'Proactive SIM',
306 30: 'Cell Broadcast Message Identifier Ranges',
307 31: 'Barred Dialling Numbers (BDN)',
308 32: 'Extension4',
309 33: 'De-personalization Control Keys',
310 34: 'Co-operative Network List',
311 35: 'Short Message Status Reports',
312 36: 'Network\'s indication of alerting in the MS',
313 37: 'Mobile Originated Short Message control by SIM',
314 38: 'GPRS',
315 39: 'Image (IMG)',
316 40: 'SoLSA (Support of Local Service Area)',
317 41: 'USSD string data object supported in Call Control',
318 42: 'RUN AT COMMAND command',
319 43: 'User controlled PLMN Selector with Access Technology',
320 44: 'Operator controlled PLMN Selector with Access Technology',
321 45: 'HPLMN Selector with Access Technology',
322 46: 'CPBCCH Information',
323 47: 'Investigation Scan',
324 48: 'Extended Capability Configuration Parameters',
325 49: 'MExE',
326 50: 'Reserved and shall be ignored',
327 51: 'PLMN Network Name',
328 52: 'Operator PLMN List',
329 53: 'Mailbox Dialling Numbers',
330 54: 'Message Waiting Indication Status',
331 55: 'Call Forwarding Indication Status',
332 56: 'Service Provider Display Information',
333 57: 'Multimedia Messaging Service (MMS)',
334 58: 'Extension 8',
335 59: 'MMS User Connectivity Parameters',
Vadim Yanitskiydfe3dbb2020-07-28 05:26:02 +0700336}
337
Harald Welteb2edd142021-01-08 23:29:35 +0100338
339######################################################################
340# DF.TELECOM
341######################################################################
342
343# TS 51.011 Section 10.5.1
344class EF_ADN(LinFixedEF):
Harald Welte6169c722022-02-12 09:05:15 +0100345 def __init__(self, fid='6f3a', sfid=None, name='EF.ADN', desc='Abbreviated Dialing Numbers', **kwargs):
346 super().__init__(fid, sfid=sfid, name=name, desc=desc, rec_len={14, 30}, **kwargs)
Harald Welte1e73d222022-02-13 11:32:50 +0100347 self._construct = Struct('alpha_id'/COptional(GsmStringAdapter(Rpad(Bytes(this._.total_len-14)), codec='ascii')),
348 'len_of_bcd'/Int8ub,
349 'ton_npi'/TonNpi,
350 'dialing_nr'/BcdAdapter(Rpad(Bytes(10))),
351 'cap_conf_id'/Int8ub,
352 'ext1_record_id'/Int8ub)
Harald Welteb2edd142021-01-08 23:29:35 +0100353
354# TS 51.011 Section 10.5.5
Harald Welteec7d0da2021-04-02 22:01:19 +0200355class EF_SMS(LinFixedEF):
Harald Welte6169c722022-02-12 09:05:15 +0100356 def __init__(self, fid='6f3c', sfid=None, name='EF.SMS', desc='Short messages', **kwargs):
357 super().__init__(fid, sfid=sfid, name=name, desc=desc, rec_len={176, 176}, **kwargs)
Harald Weltec91085e2022-02-10 18:05:45 +0100358
Harald Welteec7d0da2021-04-02 22:01:19 +0200359 def _decode_record_bin(self, raw_bin_data):
360 def decode_status(status):
361 if status & 0x01 == 0x00:
362 return (None, 'free_space')
363 elif status & 0x07 == 0x01:
364 return ('mt', 'message_read')
365 elif status & 0x07 == 0x03:
366 return ('mt', 'message_to_be_read')
367 elif status & 0x07 == 0x07:
368 return ('mo', 'message_to_be_sent')
369 elif status & 0x1f == 0x05:
370 return ('mo', 'sent_status_not_requested')
371 elif status & 0x1f == 0x0d:
372 return ('mo', 'sent_status_req_but_not_received')
373 elif status & 0x1f == 0x15:
374 return ('mo', 'sent_status_req_rx_not_stored_smsr')
375 elif status & 0x1f == 0x1d:
376 return ('mo', 'sent_status_req_rx_stored_smsr')
377 else:
378 return (None, 'rfu')
379
380 status = decode_status(raw_bin_data[0])
381 remainder = raw_bin_data[1:]
382 return {'direction': status[0], 'status': status[1], 'remainder': b2h(remainder)}
383
384
385# TS 51.011 Section 10.5.5
Harald Welteb2edd142021-01-08 23:29:35 +0100386class EF_MSISDN(LinFixedEF):
Harald Welte6169c722022-02-12 09:05:15 +0100387 def __init__(self, fid='6f40', sfid=None, name='EF.MSISDN', desc='MSISDN', **kwargs):
388 super().__init__(fid, sfid=sfid, name=name, desc=desc, rec_len={15, 34}, **kwargs)
Harald Weltec91085e2022-02-10 18:05:45 +0100389
Harald Welteb2edd142021-01-08 23:29:35 +0100390 def _decode_record_hex(self, raw_hex_data):
391 return {'msisdn': dec_msisdn(raw_hex_data)}
Harald Weltec91085e2022-02-10 18:05:45 +0100392
Harald Welteb2edd142021-01-08 23:29:35 +0100393 def _encode_record_hex(self, abstract):
Philipp Maierf9cbe092021-04-23 19:37:36 +0200394 msisdn = abstract['msisdn']
395 if type(msisdn) == str:
396 encoded_msisdn = enc_msisdn(msisdn)
397 else:
Harald Weltec91085e2022-02-10 18:05:45 +0100398 encoded_msisdn = enc_msisdn(msisdn[2], msisdn[0], msisdn[1])
399 alpha_identifier = (list(self.rec_len)[
400 0] - len(encoded_msisdn) // 2) * "ff"
Philipp Maierb46cb3f2021-04-20 22:38:21 +0200401 return alpha_identifier + encoded_msisdn
Harald Welteb2edd142021-01-08 23:29:35 +0100402
403# TS 51.011 Section 10.5.6
404class EF_SMSP(LinFixedEF):
Harald Weltebc0e2092022-02-13 10:54:58 +0100405 class ValidityPeriodAdapter(Adapter):
406 def _decode(self, obj, context, path):
407 if obj <= 143:
408 return obj + 1 * 5
409 elif obj <= 167:
410 return 12 * 60 + ((obj - 143) * 30)
411 elif obj <= 196:
412 return (obj - 166) * (24 * 60)
413 elif obj <= 255:
414 return (obj - 192) * (7 * 24 * 60)
415 else:
416 raise ValueError
417 def _encode(self, obj, context, path):
418 if obj <= 12*60:
419 return obj/5 - 1
420 elif obj <= 24*60:
421 return 143 + ((obj - (12 * 60)) / 30)
422 elif obj <= 30 * 24 * 60:
423 return 166 + (obj / (24 * 60))
424 elif obj <= 63 * 7 * 24 * 60:
425 return 192 + (obj / (7 * 24 * 60))
426 else:
427 raise ValueError
428
Harald Welte6169c722022-02-12 09:05:15 +0100429 def __init__(self, fid='6f42', sfid=None, name='EF.SMSP', desc='Short message service parameters', **kwargs):
430 super().__init__(fid, sfid=sfid, name=name, desc=desc, rec_len={28, None}, **kwargs)
Harald Weltebc0e2092022-02-13 10:54:58 +0100431 ScAddr = Struct('length'/Int8ub, 'ton_npi'/TonNpi, 'call_number'/BcdAdapter(Rpad(Bytes(10))))
432 self._construct = Struct('alpha_id'/COptional(GsmStringAdapter(Rpad(Bytes(this._.total_len-28)))),
433 'parameter_indicators'/InvertAdapter(FlagsEnum(Byte, tp_dest_addr=1, tp_sc_addr=2,
434 tp_pid=3, tp_dcs=4, tp_vp=5)),
435 'tp_dest_addr'/ScAddr,
436 'tp_sc_addr'/ScAddr,
437
438 'tp_pid'/HexAdapter(Bytes(1)),
439 'tp_dcs'/HexAdapter(Bytes(1)),
440 'tp_vp_minutes'/EF_SMSP.ValidityPeriodAdapter(Byte))
Harald Welteb2edd142021-01-08 23:29:35 +0100441
Harald Welte790b2702021-04-11 00:01:35 +0200442# TS 51.011 Section 10.5.7
443class EF_SMSS(TransparentEF):
444 class MemCapAdapter(Adapter):
445 def _decode(self, obj, context, path):
446 return False if obj & 1 else True
Harald Weltec91085e2022-02-10 18:05:45 +0100447
Harald Welte790b2702021-04-11 00:01:35 +0200448 def _encode(self, obj, context, path):
449 return 0 if obj else 1
Harald Weltec91085e2022-02-10 18:05:45 +0100450
Harald Welte6169c722022-02-12 09:05:15 +0100451 def __init__(self, fid='6f43', sfid=None, name='EF.SMSS', desc='SMS status', size={2, 8}, **kwargs):
452 super().__init__(fid, sfid=sfid, name=name, desc=desc, size=size, **kwargs)
Harald Weltec91085e2022-02-10 18:05:45 +0100453 self._construct = Struct(
454 'last_used_tpmr'/Int8ub, 'memory_capacity_exceeded'/self.MemCapAdapter(Int8ub))
Harald Welte790b2702021-04-11 00:01:35 +0200455
456# TS 51.011 Section 10.5.8
457class EF_SMSR(LinFixedEF):
Harald Welte6169c722022-02-12 09:05:15 +0100458 def __init__(self, fid='6f47', sfid=None, name='EF.SMSR', desc='SMS status reports', rec_len={30, 30}, **kwargs):
459 super().__init__(fid, sfid=sfid, name=name, desc=desc, rec_len=rec_len, **kwargs)
Harald Weltec91085e2022-02-10 18:05:45 +0100460 self._construct = Struct(
461 'sms_record_id'/Int8ub, 'sms_status_report'/HexAdapter(Bytes(29)))
462
Harald Welte790b2702021-04-11 00:01:35 +0200463
464class EF_EXT(LinFixedEF):
Harald Welte6169c722022-02-12 09:05:15 +0100465 def __init__(self, fid, sfid=None, name='EF.EXT', desc='Extension', rec_len={13, 13}, **kwargs):
466 super().__init__(fid=fid, sfid=sfid, name=name, desc=desc, rec_len=rec_len, **kwargs)
Harald Weltec91085e2022-02-10 18:05:45 +0100467 self._construct = Struct(
468 'record_type'/Int8ub, 'extension_data'/HexAdapter(Bytes(11)), 'identifier'/Int8ub)
Harald Welte790b2702021-04-11 00:01:35 +0200469
470# TS 51.011 Section 10.5.16
471class EF_CMI(LinFixedEF):
Harald Weltec91085e2022-02-10 18:05:45 +0100472 def __init__(self, fid='6f58', sfid=None, name='EF.CMI', rec_len={2, 21},
Harald Welte6169c722022-02-12 09:05:15 +0100473 desc='Comparison Method Information', **kwargs):
474 super().__init__(fid, sfid=sfid, name=name, desc=desc, rec_len=rec_len, **kwargs)
Harald Weltec91085e2022-02-10 18:05:45 +0100475 self._construct = Struct(
Harald Welte540adb02022-02-13 11:33:21 +0100476 'alpha_id'/GsmStringAdapter(Rpad(Bytes(this._.total_len-1))), 'comparison_method_id'/Int8ub)
Harald Weltec91085e2022-02-10 18:05:45 +0100477
Harald Welte790b2702021-04-11 00:01:35 +0200478
Harald Welteb2edd142021-01-08 23:29:35 +0100479class DF_TELECOM(CardDF):
Harald Welte6169c722022-02-12 09:05:15 +0100480 def __init__(self, fid='7f10', name='DF.TELECOM', desc=None, **kwargs):
481 super().__init__(fid=fid, name=name, desc=desc, **kwargs)
Harald Welteb2edd142021-01-08 23:29:35 +0100482 files = [
Harald Weltec91085e2022-02-10 18:05:45 +0100483 EF_ADN(),
484 EF_ADN(fid='6f3b', name='EF.FDN', desc='Fixed dialling numbers'),
485 EF_SMS(),
486 LinFixedEF(fid='6f3d', name='EF.CCP',
487 desc='Capability Configuration Parameters', rec_len={14, 14}),
488 LinFixedEF(fid='6f4f', name='EF.ECCP',
489 desc='Extended Capability Configuration Parameters', rec_len={15, 32}),
490 EF_MSISDN(),
491 EF_SMSP(),
492 EF_SMSS(),
493 # LND, SDN
494 EF_EXT('6f4a', None, 'EF.EXT1', 'Extension1 (ADN/SSC)'),
495 EF_EXT('6f4b', None, 'EF.EXT2', 'Extension2 (FDN/SSC)'),
496 EF_EXT('6f4c', None, 'EF.EXT3', 'Extension3 (SDN)'),
497 EF_ADN(fid='6f4d', name='EF.BDN', desc='Barred Dialling Numbers'),
498 EF_EXT('6f4e', None, 'EF.EXT4', 'Extension4 (BDN/SSC)'),
499 EF_SMSR(),
500 EF_CMI(),
Harald Weltede4c14c2022-07-16 11:53:59 +0200501 # not really part of 51.011 but something that TS 31.102 specifies may exist here.
502 DF_PHONEBOOK(),
Harald Weltea0452212022-07-17 21:23:21 +0200503 DF_MULTIMEDIA(),
Harald Welte650f6122022-07-17 21:42:50 +0200504 DF_MCS(),
Harald Welte228ae8e2022-07-17 22:01:04 +0200505 DF_V2X(),
Harald Weltec91085e2022-02-10 18:05:45 +0100506 ]
Harald Welteb2edd142021-01-08 23:29:35 +0100507 self.add_files(files)
508
Harald Welteb2edd142021-01-08 23:29:35 +0100509######################################################################
510# DF.GSM
511######################################################################
512
513# TS 51.011 Section 10.3.1
514class EF_LP(TransRecEF):
Harald Weltec91085e2022-02-10 18:05:45 +0100515 def __init__(self, fid='6f05', sfid=None, name='EF.LP', size={1, None}, rec_len=1,
Harald Welteb2edd142021-01-08 23:29:35 +0100516 desc='Language Preference'):
517 super().__init__(fid, sfid=sfid, name=name, desc=desc, size=size, rec_len=rec_len)
Harald Weltec91085e2022-02-10 18:05:45 +0100518
Harald Welteb2edd142021-01-08 23:29:35 +0100519 def _decode_record_bin(self, in_bin):
520 return b2h(in_bin)
Harald Weltec91085e2022-02-10 18:05:45 +0100521
Harald Welteb2edd142021-01-08 23:29:35 +0100522 def _encode_record_bin(self, in_json):
523 return h2b(in_json)
524
525# TS 51.011 Section 10.3.2
526class EF_IMSI(TransparentEF):
Harald Weltec91085e2022-02-10 18:05:45 +0100527 def __init__(self, fid='6f07', sfid=None, name='EF.IMSI', desc='IMSI', size={9, 9}):
Harald Welteb2edd142021-01-08 23:29:35 +0100528 super().__init__(fid, sfid=sfid, name=name, desc=desc, size=size)
Bjoern Riemere91405e2021-12-17 15:16:35 +0100529 # add those commands to the general commands of a TransparentEF
530 self.shell_commands += [self.AddlShellCommands(self)]
Harald Weltec91085e2022-02-10 18:05:45 +0100531
Harald Welteb2edd142021-01-08 23:29:35 +0100532 def _decode_hex(self, raw_hex):
533 return {'imsi': dec_imsi(raw_hex)}
Harald Weltec91085e2022-02-10 18:05:45 +0100534
Harald Welteb2edd142021-01-08 23:29:35 +0100535 def _encode_hex(self, abstract):
536 return enc_imsi(abstract['imsi'])
Harald Weltec91085e2022-02-10 18:05:45 +0100537
Bjoern Riemere91405e2021-12-17 15:16:35 +0100538 @with_default_category('File-Specific Commands')
539 class AddlShellCommands(CommandSet):
Harald Weltec91085e2022-02-10 18:05:45 +0100540 def __init__(self, ef: TransparentEF):
Bjoern Riemere91405e2021-12-17 15:16:35 +0100541 super().__init__()
Harald Weltec91085e2022-02-10 18:05:45 +0100542 self._ef = ef
Bjoern Riemere91405e2021-12-17 15:16:35 +0100543
544 def do_update_imsi_plmn(self, arg: str):
545 """Change the plmn part of the IMSI"""
546 plmn = arg.strip()
547 if len(plmn) == 5 or len(plmn) == 6:
Harald Weltea6c0f882022-07-17 14:23:17 +0200548 (data, sw) = self._cmd.lchan.read_binary_dec()
Bjoern Riemere91405e2021-12-17 15:16:35 +0100549 if sw == '9000' and len(data['imsi'])-len(plmn) == 10:
550 imsi = data['imsi']
551 msin = imsi[len(plmn):]
Harald Weltea6c0f882022-07-17 14:23:17 +0200552 (data, sw) = self._cmd.lchan.update_binary_dec(
Harald Weltec91085e2022-02-10 18:05:45 +0100553 {'imsi': plmn+msin})
Bjoern Riemere91405e2021-12-17 15:16:35 +0100554 if sw == '9000' and data:
Harald Weltec91085e2022-02-10 18:05:45 +0100555 self._cmd.poutput_json(
Harald Weltea6c0f882022-07-17 14:23:17 +0200556 self._cmd.lchan.selected_file.decode_hex(data))
Bjoern Riemere91405e2021-12-17 15:16:35 +0100557 else:
558 raise ValueError("PLMN length does not match IMSI length")
559 else:
560 raise ValueError("PLMN has wrong length!")
561
Harald Welteb2edd142021-01-08 23:29:35 +0100562
563# TS 51.011 Section 10.3.4
564class EF_PLMNsel(TransRecEF):
565 def __init__(self, fid='6f30', sfid=None, name='EF.PLMNsel', desc='PLMN selector',
Harald Welte6169c722022-02-12 09:05:15 +0100566 size={24, None}, rec_len=3, **kwargs):
567 super().__init__(fid, name=name, sfid=sfid, desc=desc, size=size, rec_len=rec_len, **kwargs)
Harald Weltec91085e2022-02-10 18:05:45 +0100568
Harald Welteb2edd142021-01-08 23:29:35 +0100569 def _decode_record_hex(self, in_hex):
570 if in_hex[:6] == "ffffff":
571 return None
572 else:
573 return dec_plmn(in_hex)
Harald Weltec91085e2022-02-10 18:05:45 +0100574
Harald Welteb2edd142021-01-08 23:29:35 +0100575 def _encode_record_hex(self, in_json):
576 if in_json == None:
577 return "ffffff"
578 else:
579 return enc_plmn(in_json['mcc'], in_json['mnc'])
580
Harald Welte790b2702021-04-11 00:01:35 +0200581# TS 51.011 Section 10.3.6
582class EF_ACMmax(TransparentEF):
Harald Weltec91085e2022-02-10 18:05:45 +0100583 def __init__(self, fid='6f37', sfid=None, name='EF.ACMmax', size={3, 3},
Harald Welte6169c722022-02-12 09:05:15 +0100584 desc='ACM maximum value', **kwargs):
585 super().__init__(fid, sfid=sfid, name=name, desc=desc, size=size, **kwargs)
Harald Welte790b2702021-04-11 00:01:35 +0200586 self._construct = Struct('acm_max'/Int24ub)
587
Harald Welteb2edd142021-01-08 23:29:35 +0100588# TS 51.011 Section 10.3.7
589class EF_ServiceTable(TransparentEF):
590 def __init__(self, fid, sfid, name, desc, size, table):
591 super().__init__(fid, sfid=sfid, name=name, desc=desc, size=size)
592 self.table = table
Harald Weltec91085e2022-02-10 18:05:45 +0100593
Harald Welte7a8aa862021-10-14 20:46:19 +0200594 @staticmethod
Harald Weltec91085e2022-02-10 18:05:45 +0100595 def _bit_byte_offset_for_service(service: int) -> Tuple[int, int]:
Harald Welte7a8aa862021-10-14 20:46:19 +0200596 i = service - 1
597 byte_offset = i//4
598 bit_offset = (i % 4) * 2
599 return (byte_offset, bit_offset)
Harald Weltec91085e2022-02-10 18:05:45 +0100600
Harald Welteb2edd142021-01-08 23:29:35 +0100601 def _decode_bin(self, raw_bin):
602 ret = {}
603 for i in range(0, len(raw_bin)*4):
604 service_nr = i+1
605 byte = int(raw_bin[i//4])
606 bit_offset = (i % 4) * 2
607 bits = (byte >> bit_offset) & 3
608 ret[service_nr] = {
Harald Weltec91085e2022-02-10 18:05:45 +0100609 'description': self.table[service_nr] if service_nr in self.table else None,
610 'allocated': True if bits & 1 else False,
611 'activated': True if bits & 2 else False,
612 }
Harald Welteb2edd142021-01-08 23:29:35 +0100613 return ret
Harald Weltec91085e2022-02-10 18:05:45 +0100614
Harald Welte7a8aa862021-10-14 20:46:19 +0200615 def _encode_bin(self, in_json):
616 # compute the required binary size
617 bin_len = 0
618 for srv in in_json.keys():
619 service_nr = int(srv)
Harald Weltec91085e2022-02-10 18:05:45 +0100620 (byte_offset, bit_offset) = EF_ServiceTable._bit_byte_offset_for_service(
621 service_nr)
Harald Welte7a8aa862021-10-14 20:46:19 +0200622 if byte_offset >= bin_len:
623 bin_len = byte_offset+1
624 # encode the actual data
625 out = bytearray(b'\x00' * bin_len)
626 for srv in in_json.keys():
627 service_nr = int(srv)
Harald Weltec91085e2022-02-10 18:05:45 +0100628 (byte_offset, bit_offset) = EF_ServiceTable._bit_byte_offset_for_service(
629 service_nr)
Harald Welte7a8aa862021-10-14 20:46:19 +0200630 bits = 0
631 if in_json[srv]['allocated'] == True:
632 bits |= 1
633 if in_json[srv]['activated'] == True:
634 bits |= 2
635 out[byte_offset] |= ((bits & 3) << bit_offset)
636 return out
Harald Welteb2edd142021-01-08 23:29:35 +0100637
638# TS 51.011 Section 10.3.11
639class EF_SPN(TransparentEF):
Harald Welte6169c722022-02-12 09:05:15 +0100640 def __init__(self, fid='6f46', sfid=None, name='EF.SPN',
641 desc='Service Provider Name', size={17, 17}, **kwargs):
642 super().__init__(fid, sfid=sfid, name=name, desc=desc, size=size, **kwargs)
Robert Falkenbergb07a3e92021-05-07 15:23:20 +0200643 self._construct = BitStruct(
644 # Byte 1
645 'rfu'/BitsRFU(6),
646 'hide_in_oplmn'/Flag,
647 'show_in_hplmn'/Flag,
648 # Bytes 2..17
649 'spn'/Bytewise(GsmString(16))
650 )
Harald Welteb2edd142021-01-08 23:29:35 +0100651
652# TS 51.011 Section 10.3.13
653class EF_CBMI(TransRecEF):
Harald Weltec91085e2022-02-10 18:05:45 +0100654 def __init__(self, fid='6f45', sfid=None, name='EF.CBMI', size={2, None}, rec_len=2,
Harald Welte6169c722022-02-12 09:05:15 +0100655 desc='Cell Broadcast message identifier selection', **kwargs):
656 super().__init__(fid, sfid=sfid, name=name, desc=desc, size=size, rec_len=rec_len, **kwargs)
Harald Welte14105dc2021-05-31 08:48:51 +0200657 self._construct = GreedyRange(Int16ub)
Harald Welteb2edd142021-01-08 23:29:35 +0100658
659# TS 51.011 Section 10.3.15
660class EF_ACC(TransparentEF):
Harald Welte6169c722022-02-12 09:05:15 +0100661 def __init__(self, fid='6f78', sfid=None, name='EF.ACC',
662 desc='Access Control Class', size={2, 2}, **kwargs):
663 super().__init__(fid, sfid=sfid, name=name, desc=desc, size=size, **kwargs)
Harald Welte1e73d222022-02-13 11:32:50 +0100664 self._construct = HexAdapter(Bytes(2))
Harald Welteb2edd142021-01-08 23:29:35 +0100665
Harald Welte790b2702021-04-11 00:01:35 +0200666# TS 51.011 Section 10.3.16
667class EF_LOCI(TransparentEF):
Harald Weltec91085e2022-02-10 18:05:45 +0100668 def __init__(self, fid='6f7e', sfid=None, name='EF.LOCI', desc='Location Information', size={11, 11}):
Harald Welte790b2702021-04-11 00:01:35 +0200669 super().__init__(fid, sfid=sfid, name=name, desc=desc, size=size)
Harald Welte3c98d5e2022-07-20 07:40:05 +0200670 self._construct = Struct('tmsi'/HexAdapter(Bytes(4)), 'lai'/HexAdapter(Bytes(5)), 'tmsi_time'/Int8ub,
Harald Welte790b2702021-04-11 00:01:35 +0200671 'lu_status'/Enum(Byte, updated=0, not_updated=1, plmn_not_allowed=2,
672 location_area_not_allowed=3))
673
Harald Welteb2edd142021-01-08 23:29:35 +0100674# TS 51.011 Section 10.3.18
675class EF_AD(TransparentEF):
Robert Falkenberg9d16fbc2021-04-12 11:43:22 +0200676 class OP_MODE(enum.IntEnum):
Harald Weltec91085e2022-02-10 18:05:45 +0100677 normal = 0x00
678 type_approval = 0x80
679 normal_and_specific_facilities = 0x01
680 type_approval_and_specific_facilities = 0x81
681 maintenance_off_line = 0x02
682 cell_test = 0x04
Robert Falkenberg9d16fbc2021-04-12 11:43:22 +0200683 #OP_MODE_DICT = {int(v) : str(v) for v in EF_AD.OP_MODE}
684 #OP_MODE_DICT_REVERSED = {str(v) : int(v) for v in EF_AD.OP_MODE}
685
Harald Weltec91085e2022-02-10 18:05:45 +0100686 def __init__(self, fid='6fad', sfid=None, name='EF.AD', desc='Administrative Data', size={3, 4}):
Harald Welteb2edd142021-01-08 23:29:35 +0100687 super().__init__(fid, sfid=sfid, name=name, desc=desc, size=size)
Robert Falkenberg9d16fbc2021-04-12 11:43:22 +0200688 self._construct = BitStruct(
689 # Byte 1
690 'ms_operation_mode'/Bytewise(Enum(Byte, EF_AD.OP_MODE)),
691 # Byte 2
692 'rfu1'/Bytewise(ByteRFU),
693 # Byte 3
694 'rfu2'/BitsRFU(7),
695 'ofm'/Flag,
696 # Byte 4 (optional),
697 'extensions'/COptional(Struct(
698 'rfu3'/BitsRFU(4),
699 'mnc_len'/BitsInteger(4),
700 # Byte 5..N-4 (optional, RFU)
701 'extensions'/Bytewise(GreedyBytesRFU)
702 ))
703 )
Harald Welteb2edd142021-01-08 23:29:35 +0100704
Harald Welte790b2702021-04-11 00:01:35 +0200705# TS 51.011 Section 10.3.20 / 10.3.22
706class EF_VGCS(TransRecEF):
Harald Weltec91085e2022-02-10 18:05:45 +0100707 def __init__(self, fid='6fb1', sfid=None, name='EF.VGCS', size={4, 200}, rec_len=4,
Harald Welte6169c722022-02-12 09:05:15 +0100708 desc='Voice Group Call Service', **kwargs):
709 super().__init__(fid, sfid=sfid, name=name, desc=desc, size=size, rec_len=rec_len, **kwargs)
Harald Welte790b2702021-04-11 00:01:35 +0200710 self._construct = BcdAdapter(Bytes(4))
711
712# TS 51.011 Section 10.3.21 / 10.3.23
713class EF_VGCSS(TransparentEF):
Harald Weltec91085e2022-02-10 18:05:45 +0100714 def __init__(self, fid='6fb2', sfid=None, name='EF.VGCSS', size={7, 7},
Harald Welte6169c722022-02-12 09:05:15 +0100715 desc='Voice Group Call Service Status', **kwargs):
716 super().__init__(fid, sfid=sfid, name=name, desc=desc, size=size, **kwargs)
Harald Weltec91085e2022-02-10 18:05:45 +0100717 self._construct = BitStruct(
718 'flags'/Bit[50], Padding(6, pattern=b'\xff'))
Harald Welte790b2702021-04-11 00:01:35 +0200719
720# TS 51.011 Section 10.3.24
721class EF_eMLPP(TransparentEF):
Harald Weltec91085e2022-02-10 18:05:45 +0100722 def __init__(self, fid='6fb5', sfid=None, name='EF.eMLPP', size={2, 2},
Harald Welte6169c722022-02-12 09:05:15 +0100723 desc='enhanced Multi Level Pre-emption and Priority', **kwargs):
724 super().__init__(fid, sfid=sfid, name=name, desc=desc, size=size, **kwargs)
Harald Weltec91085e2022-02-10 18:05:45 +0100725 FlagsConstruct = FlagsEnum(
726 Byte, A=1, B=2, zero=4, one=8, two=16, three=32, four=64)
727 self._construct = Struct(
728 'levels'/FlagsConstruct, 'fast_call_setup_cond'/FlagsConstruct)
Harald Welte790b2702021-04-11 00:01:35 +0200729
730# TS 51.011 Section 10.3.25
731class EF_AAeM(TransparentEF):
Harald Weltec91085e2022-02-10 18:05:45 +0100732 def __init__(self, fid='6fb6', sfid=None, name='EF.AAeM', size={1, 1},
Harald Welte6169c722022-02-12 09:05:15 +0100733 desc='Automatic Answer for eMLPP Service', **kwargs):
734 super().__init__(fid, sfid=sfid, name=name, desc=desc, size=size, **kwargs)
Harald Weltec91085e2022-02-10 18:05:45 +0100735 FlagsConstruct = FlagsEnum(
736 Byte, A=1, B=2, zero=4, one=8, two=16, three=32, four=64)
Harald Welte790b2702021-04-11 00:01:35 +0200737 self._construct = Struct('auto_answer_prio_levels'/FlagsConstruct)
738
739# TS 51.011 Section 10.3.26
Harald Welteb2edd142021-01-08 23:29:35 +0100740class EF_CBMID(EF_CBMI):
Harald Weltec91085e2022-02-10 18:05:45 +0100741 def __init__(self, fid='6f48', sfid=None, name='EF.CBMID', size={2, None}, rec_len=2,
Harald Welte6169c722022-02-12 09:05:15 +0100742 desc='Cell Broadcast Message Identifier for Data Download', **kwargs):
743 super().__init__(fid, sfid=sfid, name=name, desc=desc, size=size, rec_len=rec_len, **kwargs)
Harald Welte14105dc2021-05-31 08:48:51 +0200744 self._construct = GreedyRange(Int16ub)
Harald Welteb2edd142021-01-08 23:29:35 +0100745
Harald Welte89e59542021-04-02 21:33:13 +0200746# TS 51.011 Section 10.3.27
747class EF_ECC(TransRecEF):
Harald Weltec91085e2022-02-10 18:05:45 +0100748 def __init__(self, fid='6fb7', sfid=None, name='EF.ECC', size={3, 15}, rec_len=3,
Harald Welte6169c722022-02-12 09:05:15 +0100749 desc='Emergency Call Codes', **kwargs):
750 super().__init__(fid, sfid=sfid, name=name, desc=desc, size=size, rec_len=rec_len, **kwargs)
Harald Welte14105dc2021-05-31 08:48:51 +0200751 self._construct = GreedyRange(BcdAdapter(Bytes(3)))
Harald Welteb2edd142021-01-08 23:29:35 +0100752
753# TS 51.011 Section 10.3.28
754class EF_CBMIR(TransRecEF):
Harald Weltec91085e2022-02-10 18:05:45 +0100755 def __init__(self, fid='6f50', sfid=None, name='EF.CBMIR', size={4, None}, rec_len=4,
Harald Welte6169c722022-02-12 09:05:15 +0100756 desc='Cell Broadcast message identifier range selection', **kwargs):
757 super().__init__(fid, sfid=sfid, name=name, desc=desc, size=size, rec_len=rec_len, **kwargs)
Harald Welte14105dc2021-05-31 08:48:51 +0200758 self._construct = GreedyRange(Struct('lower'/Int16ub, 'upper'/Int16ub))
Harald Welteb2edd142021-01-08 23:29:35 +0100759
Harald Welte790b2702021-04-11 00:01:35 +0200760# TS 51.011 Section 10.3.29
761class EF_DCK(TransparentEF):
Harald Weltec91085e2022-02-10 18:05:45 +0100762 def __init__(self, fid='6f2c', sfid=None, name='EF.DCK', size={16, 16},
Harald Welte6169c722022-02-12 09:05:15 +0100763 desc='Depersonalisation Control Keys', **kwargs):
764 super().__init__(fid, sfid=sfid, name=name, desc=desc, size=size, **kwargs)
Harald Welte790b2702021-04-11 00:01:35 +0200765 self._construct = Struct('network'/BcdAdapter(Bytes(4)),
766 'network_subset'/BcdAdapter(Bytes(4)),
767 'service_provider'/BcdAdapter(Bytes(4)),
768 'corporate'/BcdAdapter(Bytes(4)))
769# TS 51.011 Section 10.3.30
770class EF_CNL(TransRecEF):
Harald Weltec91085e2022-02-10 18:05:45 +0100771 def __init__(self, fid='6f32', sfid=None, name='EF.CNL', size={6, None}, rec_len=6,
Harald Welte6169c722022-02-12 09:05:15 +0100772 desc='Co-operative Network List', **kwargs):
773 super().__init__(fid, sfid=sfid, name=name, desc=desc, size=size, rec_len=rec_len, **kwargs)
Harald Weltec91085e2022-02-10 18:05:45 +0100774
Harald Welte790b2702021-04-11 00:01:35 +0200775 def _decode_record_hex(self, in_hex):
776 (in_plmn, sub, svp, corp) = unpack('!3sBBB', h2b(in_hex))
777 res = dec_plmn(b2h(in_plmn))
778 res['network_subset'] = sub
779 res['service_provider_id'] = svp
780 res['corporate_id'] = corp
781 return res
Harald Weltec91085e2022-02-10 18:05:45 +0100782
Harald Welte790b2702021-04-11 00:01:35 +0200783 def _encode_record_hex(self, in_json):
784 plmn = enc_plmn(in_json['mcc'], in_json['mnc'])
Vadim Yanitskiy1a95d2b2021-05-02 01:42:09 +0200785 return b2h(pack('!3sBBB',
786 h2b(plmn),
787 in_json['network_subset'],
788 in_json['service_provider_id'],
789 in_json['corporate_id']))
Harald Welte790b2702021-04-11 00:01:35 +0200790
791# TS 51.011 Section 10.3.31
792class EF_NIA(LinFixedEF):
Harald Weltec91085e2022-02-10 18:05:45 +0100793 def __init__(self, fid='6f51', sfid=None, name='EF.NIA', rec_len={1, 32},
Harald Welte6169c722022-02-12 09:05:15 +0100794 desc='Network\'s Indication of Alerting', **kwargs):
795 super().__init__(fid, sfid=sfid, name=name, desc=desc, rec_len=rec_len, **kwargs)
Harald Weltec91085e2022-02-10 18:05:45 +0100796 self._construct = Struct(
797 'alerting_category'/Int8ub, 'category'/GreedyBytes)
Harald Welte790b2702021-04-11 00:01:35 +0200798
799# TS 51.011 Section 10.3.32
800class EF_Kc(TransparentEF):
Harald Welted90ceb82022-07-17 22:10:58 +0200801 def __init__(self, fid='6f20', sfid=None, name='EF.Kc', desc='Ciphering key Kc', size={9, 9}, **kwargs):
802 super().__init__(fid, sfid=sfid, name=name, desc=desc, size=size, **kwargs)
Harald Welte790b2702021-04-11 00:01:35 +0200803 self._construct = Struct('kc'/HexAdapter(Bytes(8)), 'cksn'/Int8ub)
804
805# TS 51.011 Section 10.3.33
806class EF_LOCIGPRS(TransparentEF):
Harald Weltec91085e2022-02-10 18:05:45 +0100807 def __init__(self, fid='6f53', sfid=None, name='EF.LOCIGPRS', desc='GPRS Location Information', size={14, 14}):
Harald Welte790b2702021-04-11 00:01:35 +0200808 super().__init__(fid, sfid=sfid, name=name, desc=desc, size=size)
Harald Welte3c98d5e2022-07-20 07:40:05 +0200809 self._construct = Struct('ptmsi'/HexAdapter(Bytes(4)), 'ptmsi_sig'/Int8ub, 'rai'/HexAdapter(Bytes(6)),
Harald Welte790b2702021-04-11 00:01:35 +0200810 'rau_status'/Enum(Byte, updated=0, not_updated=1, plmn_not_allowed=2,
811 routing_area_not_allowed=3))
Harald Welteb2edd142021-01-08 23:29:35 +0100812
813# TS 51.011 Section 10.3.35..37
814class EF_xPLMNwAcT(TransRecEF):
Harald Welte6169c722022-02-12 09:05:15 +0100815 def __init__(self, fid, sfid=None, name=None, desc=None, size={40, None}, rec_len=5, **kwargs):
816 super().__init__(fid, sfid=sfid, name=name, desc=desc, size=size, rec_len=rec_len, **kwargs)
Harald Weltec91085e2022-02-10 18:05:45 +0100817
Harald Welteb2edd142021-01-08 23:29:35 +0100818 def _decode_record_hex(self, in_hex):
819 if in_hex[:6] == "ffffff":
820 return None
821 else:
822 return dec_xplmn_w_act(in_hex)
Harald Weltec91085e2022-02-10 18:05:45 +0100823
Harald Welteb2edd142021-01-08 23:29:35 +0100824 def _encode_record_hex(self, in_json):
825 if in_json == None:
826 return "ffffff0000"
827 else:
828 hplmn = enc_plmn(in_json['mcc'], in_json['mnc'])
829 act = self.enc_act(in_json['act'])
830 return hplmn + act
Harald Weltec91085e2022-02-10 18:05:45 +0100831
Harald Welteb2edd142021-01-08 23:29:35 +0100832 @staticmethod
833 def enc_act(in_list):
834 u16 = 0
835 # first the simple ones
836 if 'UTRAN' in in_list:
837 u16 |= 0x8000
838 if 'NG-RAN' in in_list:
839 u16 |= 0x0800
840 if 'GSM COMPACT' in in_list:
841 u16 |= 0x0040
842 if 'cdma2000 HRPD' in in_list:
843 u16 |= 0x0020
844 if 'cdma2000 1xRTT' in in_list:
845 u16 |= 0x0010
846 # E-UTRAN
Philipp Maiere7d41792021-04-29 16:20:07 +0200847 if 'E-UTRAN' in in_list:
848 u16 |= 0x4000
Vadim Yanitskiy5452d642021-03-07 21:45:34 +0100849 if 'E-UTRAN WB-S1' in in_list:
850 u16 |= 0x6000
851 if 'E-UTRAN NB-S1' in in_list:
852 u16 |= 0x5000
Harald Welteb2edd142021-01-08 23:29:35 +0100853 # GSM mess
854 if 'GSM' in in_list and 'EC-GSM-IoT' in in_list:
855 u16 |= 0x008C
856 elif 'GSM' in in_list:
857 u16 |= 0x0084
858 elif 'EC-GSM-IuT' in in_list:
859 u16 |= 0x0088
Harald Weltec91085e2022-02-10 18:05:45 +0100860 return '%04X' % (u16)
Harald Welteb2edd142021-01-08 23:29:35 +0100861
Harald Welte790b2702021-04-11 00:01:35 +0200862# TS 51.011 Section 10.3.38
863class EF_CPBCCH(TransRecEF):
Harald Weltec91085e2022-02-10 18:05:45 +0100864 def __init__(self, fid='6f63', sfid=None, name='EF.CPBCCH', size={2, 14}, rec_len=2,
Harald Welted90ceb82022-07-17 22:10:58 +0200865 desc='CPBCCH Information', **kwargs):
866 super().__init__(fid, sfid=sfid, name=name, desc=desc, size=size, rec_len=rec_len, **kwargs)
Harald Welte790b2702021-04-11 00:01:35 +0200867 self._construct = Struct('cpbcch'/Int16ub)
868
869# TS 51.011 Section 10.3.39
870class EF_InvScan(TransparentEF):
Harald Weltec91085e2022-02-10 18:05:45 +0100871 def __init__(self, fid='6f64', sfid=None, name='EF.InvScan', size={1, 1},
Harald Welted90ceb82022-07-17 22:10:58 +0200872 desc='IOnvestigation Scan', **kwargs):
873 super().__init__(fid, sfid=sfid, name=name, desc=desc, size=size, **kwargs)
Harald Weltec91085e2022-02-10 18:05:45 +0100874 self._construct = FlagsEnum(
875 Byte, in_limited_service_mode=1, after_successful_plmn_selection=2)
Harald Welte790b2702021-04-11 00:01:35 +0200876
Harald Welte14105dc2021-05-31 08:48:51 +0200877# TS 51.011 Section 4.2.58
878class EF_PNN(LinFixedEF):
879 class FullNameForNetwork(BER_TLV_IE, tag=0x43):
880 # TS 24.008 10.5.3.5a
Harald Welte857f1102022-07-20 07:44:25 +0200881 # TODO: proper decode
882 _construct = HexAdapter(GreedyBytes)
Harald Weltec91085e2022-02-10 18:05:45 +0100883
Harald Welte14105dc2021-05-31 08:48:51 +0200884 class ShortNameForNetwork(BER_TLV_IE, tag=0x45):
885 # TS 24.008 10.5.3.5a
Harald Welte857f1102022-07-20 07:44:25 +0200886 # TODO: proper decode
887 _construct = HexAdapter(GreedyBytes)
Harald Weltec91085e2022-02-10 18:05:45 +0100888
Harald Welte14105dc2021-05-31 08:48:51 +0200889 class NetworkNameCollection(TLV_IE_Collection, nested=[FullNameForNetwork, ShortNameForNetwork]):
890 pass
Harald Weltec91085e2022-02-10 18:05:45 +0100891
Harald Welte6169c722022-02-12 09:05:15 +0100892 def __init__(self, fid='6fc5', sfid=None, name='EF.PNN', desc='PLMN Network Name', **kwargs):
893 super().__init__(fid, sfid=sfid, name=name, desc=desc, **kwargs)
Harald Welte14105dc2021-05-31 08:48:51 +0200894 self._tlv = EF_PNN.NetworkNameCollection
895
Harald Welte790b2702021-04-11 00:01:35 +0200896# TS 51.011 Section 10.3.42
897class EF_OPL(LinFixedEF):
Harald Welte6169c722022-02-12 09:05:15 +0100898 def __init__(self, fid='6fc6', sfid=None, name='EF.OPL', rec_len={8, 8}, desc='Operator PLMN List', **kwargs):
899 super().__init__(fid, sfid=sfid, name=name, desc=desc, rec_len=rec_len, **kwargs)
Harald Welte3c98d5e2022-07-20 07:40:05 +0200900 self._construct = Struct('lai'/Struct('mcc_mnc'/BcdAdapter(Bytes(3)),
901 'lac_min'/HexAdapter(Bytes(2)), 'lac_max'/HexAdapter(Bytes(2))), 'pnn_record_id'/Int8ub)
Harald Welte790b2702021-04-11 00:01:35 +0200902
903# TS 51.011 Section 10.3.44 + TS 31.102 4.2.62
904class EF_MBI(LinFixedEF):
Harald Welte6169c722022-02-12 09:05:15 +0100905 def __init__(self, fid='6fc9', sfid=None, name='EF.MBI', rec_len={4, 5}, desc='Mailbox Identifier', **kwargs):
906 super().__init__(fid, sfid=sfid, name=name, desc=desc, rec_len=rec_len, **kwargs)
Harald Welte790b2702021-04-11 00:01:35 +0200907 self._construct = Struct('mbi_voicemail'/Int8ub, 'mbi_fax'/Int8ub, 'mbi_email'/Int8ub,
908 'mbi_other'/Int8ub, 'mbi_videocall'/COptional(Int8ub))
909
910# TS 51.011 Section 10.3.45 + TS 31.102 4.2.63
911class EF_MWIS(LinFixedEF):
Harald Weltec91085e2022-02-10 18:05:45 +0100912 def __init__(self, fid='6fca', sfid=None, name='EF.MWIS', rec_len={5, 6},
Harald Welte6169c722022-02-12 09:05:15 +0100913 desc='Message Waiting Indication Status', **kwargs):
914 super().__init__(fid, sfid=sfid, name=name, desc=desc, rec_len=rec_len, **kwargs)
Harald Welte790b2702021-04-11 00:01:35 +0200915 self._construct = Struct('mwi_status'/FlagsEnum(Byte, voicemail=1, fax=2, email=4, other=8, videomail=16),
916 'num_waiting_voicemail'/Int8ub,
917 'num_waiting_fax'/Int8ub, 'num_waiting_email'/Int8ub,
918 'num_waiting_other'/Int8ub, 'num_waiting_videomail'/COptional(Int8ub))
919
Harald Welte14105dc2021-05-31 08:48:51 +0200920# TS 51.011 Section 10.3.66
921class EF_SPDI(TransparentEF):
922 class ServiceProviderPLMN(BER_TLV_IE, tag=0x80):
923 # flexible numbers of 3-byte PLMN records
924 _construct = GreedyRange(BcdAdapter(Bytes(3)))
Harald Weltec91085e2022-02-10 18:05:45 +0100925
Harald Welte14105dc2021-05-31 08:48:51 +0200926 class SPDI(BER_TLV_IE, tag=0xA3, nested=[ServiceProviderPLMN]):
927 pass
928 def __init__(self, fid='6fcd', sfid=None, name='EF.SPDI',
Harald Welte6169c722022-02-12 09:05:15 +0100929 desc='Service Provider Display Information', **kwargs):
930 super().__init__(fid, sfid=sfid, name=name, desc=desc, **kwargs)
Harald Welte14105dc2021-05-31 08:48:51 +0200931 self._tlv = EF_SPDI.SPDI
932
Harald Welte790b2702021-04-11 00:01:35 +0200933# TS 51.011 Section 10.3.51
934class EF_MMSN(LinFixedEF):
Harald Welte6169c722022-02-12 09:05:15 +0100935 def __init__(self, fid='6fce', sfid=None, name='EF.MMSN', rec_len={4, 20}, desc='MMS Notification', **kwargs):
936 super().__init__(fid, sfid=sfid, name=name, desc=desc, rec_len=rec_len, **kwargs)
Harald Welte3c98d5e2022-07-20 07:40:05 +0200937 self._construct = Struct('mms_status'/HexAdapter(Bytes(2)), 'mms_implementation'/HexAdapter(Bytes(1)),
938 'mms_notification'/HexAdapter(Bytes(this._.total_len-4)), 'ext_record_nr'/Byte)
Harald Welte790b2702021-04-11 00:01:35 +0200939
Harald Welte14105dc2021-05-31 08:48:51 +0200940# TS 51.011 Annex K.1
941class MMS_Implementation(BER_TLV_IE, tag=0x80):
942 _construct = FlagsEnum(Byte, WAP=1)
943
Harald Welte790b2702021-04-11 00:01:35 +0200944# TS 51.011 Section 10.3.53
945class EF_MMSICP(TransparentEF):
Harald Welte14105dc2021-05-31 08:48:51 +0200946 class MMS_Relay_Server(BER_TLV_IE, tag=0x81):
947 # 3GPP TS 23.140
948 pass
Harald Weltec91085e2022-02-10 18:05:45 +0100949
Harald Welte14105dc2021-05-31 08:48:51 +0200950 class Interface_to_CN(BER_TLV_IE, tag=0x82):
951 # 3GPP TS 23.140
952 pass
Harald Weltec91085e2022-02-10 18:05:45 +0100953
Harald Welte14105dc2021-05-31 08:48:51 +0200954 class Gateway(BER_TLV_IE, tag=0x83):
955 # Address, Type of address, Port, Service, AuthType, AuthId, AuthPass / 3GPP TS 23.140
956 pass
Harald Weltec91085e2022-02-10 18:05:45 +0100957
Harald Welte14105dc2021-05-31 08:48:51 +0200958 class MMS_ConnectivityParamters(TLV_IE_Collection,
Harald Weltec91085e2022-02-10 18:05:45 +0100959 nested=[MMS_Implementation, MMS_Relay_Server, Interface_to_CN, Gateway]):
Harald Welte14105dc2021-05-31 08:48:51 +0200960 pass
Harald Weltec91085e2022-02-10 18:05:45 +0100961 def __init__(self, fid='6fd0', sfid=None, name='EF.MMSICP', size={1, None},
Harald Welte6169c722022-02-12 09:05:15 +0100962 desc='MMS Issuer Connectivity Parameters', **kwargs):
963 super().__init__(fid, sfid=sfid, name=name, desc=desc, size=size, **kwargs)
Harald Welte14105dc2021-05-31 08:48:51 +0200964 self._tlv = EF_MMSICP.MMS_ConnectivityParamters
Harald Welte790b2702021-04-11 00:01:35 +0200965
966# TS 51.011 Section 10.3.54
967class EF_MMSUP(LinFixedEF):
Harald Welte14105dc2021-05-31 08:48:51 +0200968 class MMS_UserPref_ProfileName(BER_TLV_IE, tag=0x81):
969 pass
Harald Weltec91085e2022-02-10 18:05:45 +0100970
Harald Welte14105dc2021-05-31 08:48:51 +0200971 class MMS_UserPref_Info(BER_TLV_IE, tag=0x82):
972 pass
Harald Weltec91085e2022-02-10 18:05:45 +0100973
Harald Welte14105dc2021-05-31 08:48:51 +0200974 class MMS_User_Preferences(TLV_IE_Collection,
Harald Weltec91085e2022-02-10 18:05:45 +0100975 nested=[MMS_Implementation, MMS_UserPref_ProfileName, MMS_UserPref_Info]):
Harald Welte14105dc2021-05-31 08:48:51 +0200976 pass
Harald Weltec91085e2022-02-10 18:05:45 +0100977 def __init__(self, fid='6fd1', sfid=None, name='EF.MMSUP', rec_len={1, None},
Harald Welte6169c722022-02-12 09:05:15 +0100978 desc='MMS User Preferences', **kwargs):
979 super().__init__(fid, sfid=sfid, name=name, desc=desc, rec_len=rec_len, **kwargs)
Harald Welte6113fe92022-01-21 15:51:35 +0100980 self._tlv = EF_MMSUP.MMS_User_Preferences
Harald Welte790b2702021-04-11 00:01:35 +0200981
982# TS 51.011 Section 10.3.55
983class EF_MMSUCP(TransparentEF):
Harald Weltec91085e2022-02-10 18:05:45 +0100984 def __init__(self, fid='6fd2', sfid=None, name='EF.MMSUCP', size={1, None},
Harald Welte6169c722022-02-12 09:05:15 +0100985 desc='MMS User Connectivity Parameters', **kwargs):
986 super().__init__(fid, sfid=sfid, name=name, desc=desc, size=size, **kwargs)
Harald Welte790b2702021-04-11 00:01:35 +0200987
Harald Welteb2edd142021-01-08 23:29:35 +0100988
989class DF_GSM(CardDF):
990 def __init__(self, fid='7f20', name='DF.GSM', desc='GSM Network related files'):
991 super().__init__(fid=fid, name=name, desc=desc)
992 files = [
Harald Weltec91085e2022-02-10 18:05:45 +0100993 EF_LP(),
994 EF_IMSI(),
995 EF_Kc(),
996 EF_PLMNsel(),
997 TransparentEF('6f31', None, 'EF.HPPLMN',
998 'Higher Priority PLMN search period'),
999 EF_ACMmax(),
1000 EF_ServiceTable('6f38', None, 'EF.SST',
1001 'SIM service table', table=EF_SST_map, size={2, 16}),
1002 CyclicEF('6f39', None, 'EF.ACM',
1003 'Accumulated call meter', rec_len={3, 3}),
1004 TransparentEF('6f3e', None, 'EF.GID1', 'Group Identifier Level 1'),
1005 TransparentEF('6f3f', None, 'EF.GID2', 'Group Identifier Level 2'),
1006 EF_SPN(),
1007 TransparentEF('6f41', None, 'EF.PUCT',
1008 'Price per unit and currency table', size={5, 5}),
1009 EF_CBMI(),
1010 TransparentEF('6f7f', None, 'EF.BCCH',
1011 'Broadcast control channels', size={16, 16}),
1012 EF_ACC(),
1013 EF_PLMNsel('6f7b', None, 'EF.FPLMN',
1014 'Forbidden PLMNs', size={12, 12}),
1015 EF_LOCI(),
1016 EF_AD(),
1017 TransparentEF('6fa3', None, 'EF.Phase',
1018 'Phase identification', size={1, 1}),
1019 EF_VGCS(),
1020 EF_VGCSS(),
1021 EF_VGCS('6fb3', None, 'EF.VBS', 'Voice Broadcast Service'),
1022 EF_VGCSS('6fb4', None, 'EF.VBSS',
1023 'Voice Broadcast Service Status'),
1024 EF_eMLPP(),
1025 EF_AAeM(),
1026 EF_CBMID(),
1027 EF_ECC(),
1028 EF_CBMIR(),
1029 EF_DCK(),
1030 EF_CNL(),
1031 EF_NIA(),
1032 EF_Kc('6f52', None, 'EF.KcGPRS', 'GPRS Ciphering key KcGPRS'),
1033 EF_LOCIGPRS(),
1034 TransparentEF('6f54', None, 'EF.SUME', 'SetUpMenu Elements'),
1035 EF_xPLMNwAcT('6f60', None, 'EF.PLMNwAcT',
1036 'User controlled PLMN Selector with Access Technology'),
1037 EF_xPLMNwAcT('6f61', None, 'EF.OPLMNwAcT',
1038 'Operator controlled PLMN Selector with Access Technology'),
1039 EF_xPLMNwAcT('6f62', None, 'EF.HPLMNwAcT',
1040 'HPLMN Selector with Access Technology'),
1041 EF_CPBCCH(),
1042 EF_InvScan(),
1043 EF_PNN(),
1044 EF_OPL(),
1045 EF_ADN('6fc7', None, 'EF.MBDN', 'Mailbox Dialling Numbers'),
1046 EF_MBI(),
1047 EF_MWIS(),
1048 EF_ADN('6fcb', None, 'EF.CFIS',
1049 'Call Forwarding Indication Status'),
1050 EF_EXT('6fc8', None, 'EF.EXT6', 'Externsion6 (MBDN)'),
1051 EF_EXT('6fcc', None, 'EF.EXT7', 'Externsion7 (CFIS)'),
1052 EF_SPDI(),
1053 EF_MMSN(),
1054 EF_EXT('6fcf', None, 'EF.EXT8', 'Extension8 (MMSN)'),
1055 EF_MMSICP(),
1056 EF_MMSUP(),
1057 EF_MMSUCP(),
1058 ]
Harald Welteb2edd142021-01-08 23:29:35 +01001059 self.add_files(files)
1060
Harald Weltec91085e2022-02-10 18:05:45 +01001061
Philipp Maierc8387dc2021-10-29 17:59:50 +02001062class CardProfileSIM(CardProfile):
Philipp Maiera028c7d2021-11-08 16:12:03 +01001063
1064 ORDER = 2
1065
Philipp Maierc8387dc2021-10-29 17:59:50 +02001066 def __init__(self):
Philipp Maiera4df9422021-11-10 17:13:40 +01001067 sw = {
Harald Weltec91085e2022-02-10 18:05:45 +01001068 'Normal': {
1069 '9000': 'Normal ending of the command',
1070 '91xx': 'normal ending of the command, with extra information from the proactive SIM containing a command for the ME',
1071 '9exx': 'length XX of the response data given in case of a SIM data download error',
1072 '9fxx': 'length XX of the response data',
Philipp Maiera4df9422021-11-10 17:13:40 +01001073 },
Harald Weltec91085e2022-02-10 18:05:45 +01001074 'Postponed processing': {
1075 '9300': 'SIM Application Toolkit is busy. Command cannot be executed at present, further normal commands are allowed',
Philipp Maiera4df9422021-11-10 17:13:40 +01001076 },
Harald Weltec91085e2022-02-10 18:05:45 +01001077 'Memory management': {
1078 '920x': 'command successful but after using an internal update retry routine X times',
1079 '9240': 'memory problem',
Philipp Maiera4df9422021-11-10 17:13:40 +01001080 },
Harald Weltec91085e2022-02-10 18:05:45 +01001081 'Referencing management': {
1082 '9400': 'no EF selected',
1083 '9402': 'out of range (invalid address)',
1084 '9404': 'file ID not found or pattern not found',
1085 '9408': 'file is inconsistent with the command',
Philipp Maiera4df9422021-11-10 17:13:40 +01001086 },
Harald Weltec91085e2022-02-10 18:05:45 +01001087 'Security management': {
1088 '9802': 'no CHV initialized',
1089 '9804': 'access condition not fulfilled, unsuccessful CHV verification or authentication failed',
1090 '9808': 'in contradiction with CHV status',
1091 '9810': 'in contradiction with invalidation status',
1092 '9840': 'unsuccessful verification, CHV blocked, UNBLOCK CHV blocked',
1093 '9850': 'increase cannot be performed, Max value reached',
Philipp Maiera4df9422021-11-10 17:13:40 +01001094 },
Harald Weltec91085e2022-02-10 18:05:45 +01001095 'Application independent errors': {
1096 '67xx': 'incorrect parameter P3',
1097 '6bxx': 'incorrect parameter P1 or P2',
1098 '6dxx': 'unknown instruction code given in the command',
1099 '6exx': 'wrong instruction class given in the command',
1100 '6fxx': 'technical problem with no diagnostic given',
Philipp Maiera4df9422021-11-10 17:13:40 +01001101 },
Harald Weltec91085e2022-02-10 18:05:45 +01001102 }
Philipp Maiera4df9422021-11-10 17:13:40 +01001103
Harald Weltec91085e2022-02-10 18:05:45 +01001104 super().__init__('SIM', desc='GSM SIM Card', cla="a0",
1105 sel_ctrl="0000", files_in_mf=[DF_TELECOM(), DF_GSM()], sw=sw)
Philipp Maier4ab971c2021-11-11 11:53:49 +01001106
Philipp Maier5998a3a2021-11-16 15:16:39 +01001107 @staticmethod
Harald Weltec91085e2022-02-10 18:05:45 +01001108 def decode_select_response(resp_hex: str) -> object:
Philipp Maier4ab971c2021-11-11 11:53:49 +01001109 resp_bin = h2b(resp_hex)
1110 struct_of_file_map = {
1111 0: 'transparent',
1112 1: 'linear_fixed',
1113 3: 'cyclic'
Harald Weltec91085e2022-02-10 18:05:45 +01001114 }
Philipp Maier4ab971c2021-11-11 11:53:49 +01001115 type_of_file_map = {
1116 1: 'mf',
1117 2: 'df',
1118 4: 'working_ef'
Harald Weltec91085e2022-02-10 18:05:45 +01001119 }
Philipp Maier4ab971c2021-11-11 11:53:49 +01001120 ret = {
Harald Welte747a9782022-02-13 17:52:28 +01001121 'file_descriptor': {
1122 'file_descriptor_byte': {},
1123 },
Philipp Maier4ab971c2021-11-11 11:53:49 +01001124 'proprietary_info': {},
Harald Weltec91085e2022-02-10 18:05:45 +01001125 }
Philipp Maier4ab971c2021-11-11 11:53:49 +01001126 ret['file_id'] = b2h(resp_bin[4:6])
Harald Weltec91085e2022-02-10 18:05:45 +01001127 ret['proprietary_info']['available_memory'] = int.from_bytes(
1128 resp_bin[2:4], 'big')
1129 file_type = type_of_file_map[resp_bin[6]
1130 ] if resp_bin[6] in type_of_file_map else resp_bin[6]
Harald Welte747a9782022-02-13 17:52:28 +01001131 ret['file_descriptor']['file_descriptor_byte']['file_type'] = file_type
Philipp Maier4ab971c2021-11-11 11:53:49 +01001132 if file_type in ['mf', 'df']:
1133 ret['file_characteristics'] = b2h(resp_bin[13:14])
1134 ret['num_direct_child_df'] = resp_bin[14]
1135 ret['num_direct_child_ef'] = resp_bin[15]
1136 ret['num_chv_unblock_adm_codes'] = int(resp_bin[16])
1137 # CHV / UNBLOCK CHV stats
1138 elif file_type in ['working_ef']:
Harald Weltec91085e2022-02-10 18:05:45 +01001139 file_struct = struct_of_file_map[resp_bin[13]
1140 ] if resp_bin[13] in struct_of_file_map else resp_bin[13]
Harald Welte747a9782022-02-13 17:52:28 +01001141 ret['file_descriptor']['file_descriptor_byte']['structure'] = file_struct
Philipp Maier4ab971c2021-11-11 11:53:49 +01001142 ret['access_conditions'] = b2h(resp_bin[8:10])
1143 if resp_bin[11] & 0x01 == 0:
1144 ret['life_cycle_status_int'] = 'operational_activated'
1145 elif resp_bin[11] & 0x04:
1146 ret['life_cycle_status_int'] = 'operational_deactivated'
1147 else:
1148 ret['life_cycle_status_int'] = 'terminated'
1149 return ret
Philipp Maiera028c7d2021-11-08 16:12:03 +01001150
1151 @staticmethod
Harald Weltec91085e2022-02-10 18:05:45 +01001152 def match_with_card(scc: SimCardCommands) -> bool:
Philipp Maiera028c7d2021-11-08 16:12:03 +01001153 return match_sim(scc)