catarrh
747974460e
- Only update the selected-file state on a successful SELECT (SW1 in 61/62/63/90/91/92/9E/9F); a failed SELECT (e.g. 6A82) leaves the current file unchanged. - Track the file structure from the FCP (GET RESPONSE after SELECT). - Skip file decoding for record ops (READ/UPDATE/SEARCH RECORD) when the selected file is transparent/DF, marking the result 'stale' instead of decoding garbage — this catches silently-dropped SELECTs.
1032 lines
47 KiB
Python
1032 lines
47 KiB
Python
"""Tests for server APDU/CAT decoding."""
|
||
|
||
import unittest
|
||
|
||
from simtrace2_pysniff.server.decode import (
|
||
decode_message,
|
||
decode_sniff_msg,
|
||
CAT_COMMAND_TYPES,
|
||
ENVELOPE_TYPES,
|
||
parse_tlv,
|
||
)
|
||
|
||
|
||
class TestParseTlv(unittest.TestCase):
|
||
def test_simple(self):
|
||
data = bytes.fromhex('8103010500')
|
||
self.assertEqual(parse_tlv(data), [(0x81, 3, bytes.fromhex('010500'))])
|
||
|
||
def test_multiple(self):
|
||
data = bytes.fromhex('810301050082028182')
|
||
self.assertEqual(parse_tlv(data), [
|
||
(0x81, 3, bytes.fromhex('010500')),
|
||
(0x82, 2, bytes.fromhex('8182')),
|
||
])
|
||
|
||
def test_empty(self):
|
||
self.assertEqual(parse_tlv(b''), [])
|
||
|
||
def test_long_form_length(self):
|
||
# D0 81 BC … — a proactive command whose length is 0xBC (188),
|
||
# encoded in BER-TLV long form.
|
||
inner = bytes.fromhex('8103012500') + b'\x82\x02\x81\x82'
|
||
data = b'\xd0' + b'\x81' + bytes([len(inner)]) + inner
|
||
self.assertEqual(parse_tlv(data), [(0xD0, len(inner), inner)])
|
||
|
||
def test_long_form_two_byte(self):
|
||
# 0x82 followed by two length bytes.
|
||
value = b'\x00' * 300
|
||
data = b'\x70' + b'\x82\x01\x2c' + value
|
||
self.assertEqual(parse_tlv(data), [(0x70, 300, value)])
|
||
|
||
|
||
class TestAuthenticateNaming(unittest.TestCase):
|
||
def test_ins_88(self):
|
||
r = decode_message(bytes.fromhex('0088008122' + '00' * 34 + '6135'))
|
||
self.assertEqual(r['ins_name'], 'AUTHENTICATE')
|
||
|
||
def test_ins_89(self):
|
||
r = decode_message(bytes.fromhex('0089008122' + '00' * 34 + '6135'))
|
||
self.assertEqual(r['ins_name'], 'AUTHENTICATE')
|
||
|
||
|
||
class TestCatDecoding(unittest.TestCase):
|
||
def test_fetch_setup_menu(self):
|
||
r = decode_message(bytes.fromhex(
|
||
'8012000030D02E810301250082028182050B416C6661204D6F62696C65'
|
||
'8F16808112089DB0C1C2C0BEB9BAB82F53657474696E67739000'))
|
||
self.assertEqual(r['ins_name'], 'FETCH')
|
||
self.assertEqual(r['cat_command'], 'SET UP MENU')
|
||
|
||
def test_fetch_setup_event_list(self):
|
||
r = decode_message(bytes.fromhex(
|
||
'801200000FD00D810301050082028182990203129000'))
|
||
self.assertEqual(r['cat_command'], 'SET UP EVENT LIST')
|
||
|
||
def test_fetch_poll_interval(self):
|
||
r = decode_message(bytes.fromhex(
|
||
'801200000FD00D8103010300820281820402011E9000'))
|
||
self.assertEqual(r['cat_command'], 'POLL INTERVAL')
|
||
|
||
def test_fetch_provide_local_info(self):
|
||
r = decode_message(bytes.fromhex(
|
||
'801200000BD0098103012600820281829000'))
|
||
self.assertEqual(r['cat_command'],
|
||
'PROVIDE LOCAL INFORMATION — Location Info (MCC, MNC, LAC/TAC, Cell ID)')
|
||
|
||
def test_envelope_event_download(self):
|
||
r = decode_message(bytes.fromhex(
|
||
'80C200000CD60A190103020282811B01029000'))
|
||
self.assertEqual(r['ins_name'], 'ENVELOPE')
|
||
self.assertEqual(r['cat_command'], 'EVENT DOWNLOAD')
|
||
|
||
def test_tr_has_response_to(self):
|
||
r = decode_message(bytes.fromhex(
|
||
'801400000C8103010500020282810301009130'))
|
||
self.assertEqual(r['ins_name'], 'TERMINAL RESPONSE')
|
||
self.assertNotIn('cat_command', r)
|
||
self.assertEqual(r['response_to'], 'SET UP EVENT LIST')
|
||
|
||
def test_select_no_cat(self):
|
||
r = decode_message(bytes.fromhex('a0a40000023f009000'))
|
||
self.assertEqual(r['ins_name'], 'SELECT')
|
||
self.assertNotIn('cat_command', r)
|
||
|
||
def test_envelope_sms_pp_download(self):
|
||
r = decode_message(bytes.fromhex(
|
||
'80C2000022D120020283810607919740430900F40B1104038154F50004'
|
||
'260812143000210248699000'))
|
||
self.assertEqual(r['ins_name'], 'ENVELOPE')
|
||
self.assertEqual(r['cat_command'], 'SMS-PP DOWNLOAD')
|
||
cmd = r['cmd']
|
||
self.assertEqual(cmd['smsc'], '+79043490004')
|
||
self.assertEqual(cmd['device_ids'], '8381')
|
||
t = cmd['tpdu']
|
||
self.assertEqual(t['mti'], 'SMS-DELIVER')
|
||
self.assertEqual(t['oa'], '455')
|
||
self.assertEqual(t['text'], 'Hi')
|
||
self.assertEqual(t['scts'], '2026-08-12 14:30:00 (UTC+03:00)')
|
||
|
||
|
||
class TestCommandTypeTables(unittest.TestCase):
|
||
def test_known_values(self):
|
||
self.assertEqual(CAT_COMMAND_TYPES[0x03], 'POLL INTERVAL')
|
||
self.assertEqual(CAT_COMMAND_TYPES[0x05], 'SET UP EVENT LIST')
|
||
self.assertEqual(CAT_COMMAND_TYPES[0x25], 'SET UP MENU')
|
||
self.assertEqual(CAT_COMMAND_TYPES[0x21], 'DISPLAY TEXT')
|
||
self.assertEqual(CAT_COMMAND_TYPES[0x24], 'SELECT ITEM')
|
||
self.assertEqual(CAT_COMMAND_TYPES[0x26], 'PROVIDE LOCAL INFORMATION')
|
||
|
||
def test_envelope_known_values(self):
|
||
self.assertEqual(ENVELOPE_TYPES[0xD3], 'MENU SELECTION')
|
||
self.assertEqual(ENVELOPE_TYPES[0xD6], 'EVENT DOWNLOAD')
|
||
|
||
|
||
class TestChangeAndFidiDecoding(unittest.TestCase):
|
||
def test_change_reset_assert(self):
|
||
r = decode_sniff_msg(b'', 'change', flags=1 << 2)
|
||
self.assertEqual(r['type'], 'change')
|
||
self.assertEqual(r['flags'], ['Reset asserted'])
|
||
|
||
def test_change_card_insert(self):
|
||
r = decode_sniff_msg(b'', 'change', flags=1 << 0)
|
||
self.assertEqual(r['flags'], ['Card inserted'])
|
||
|
||
def test_change_multiple_flags(self):
|
||
r = decode_sniff_msg(b'', 'change', flags=(1 << 2) | (1 << 3))
|
||
self.assertEqual(r['flags'], ['Reset asserted', 'Reset de-asserted'])
|
||
|
||
def test_change_no_flags(self):
|
||
r = decode_sniff_msg(b'', 'change', flags=0)
|
||
self.assertEqual(r['flags'], ['no changes'])
|
||
|
||
def test_fidi(self):
|
||
r = decode_sniff_msg(b'\x97', 'fidi')
|
||
self.assertEqual(r['type'], 'fidi')
|
||
self.assertEqual(r['fi'], 9)
|
||
self.assertEqual(r['di'], 7)
|
||
self.assertEqual(r['fi_val'], 512)
|
||
self.assertEqual(r['di_val'], 64)
|
||
|
||
|
||
class TestTerminalResponse(unittest.TestCase):
|
||
def test_tr_setup_event_list(self):
|
||
r = decode_message(bytes.fromhex(
|
||
'801400000C8103010500020282810301009130'))
|
||
self.assertEqual(r['ins_name'], 'TERMINAL RESPONSE')
|
||
self.assertEqual(r['response_to'], 'SET UP EVENT LIST')
|
||
|
||
def test_tr_setup_menu(self):
|
||
r = decode_message(bytes.fromhex(
|
||
'801400000C810301250002028281830100910F'))
|
||
self.assertEqual(r['response_to'], 'SET UP MENU')
|
||
|
||
def test_tr_poll_interval(self):
|
||
r = decode_message(bytes.fromhex(
|
||
'80140000108103010300020282810301000402011E9000'))
|
||
self.assertEqual(r['response_to'], 'POLL INTERVAL')
|
||
|
||
|
||
class TestPliQualifier(unittest.TestCase):
|
||
def test_tr_pli_imei(self):
|
||
r = decode_message(bytes.fromhex(
|
||
'8014000016810301260102028281030106130952F0991EC57A68009F'))
|
||
self.assertEqual(r['response_to'], 'PROVIDE LOCAL INFORMATION — IMEI')
|
||
|
||
def test_fetch_pli_location(self):
|
||
r = decode_message(bytes.fromhex(
|
||
'801200000BD0098103012600820281829000'))
|
||
self.assertEqual(r['cat_command'],
|
||
'PROVIDE LOCAL INFORMATION — Location Info (MCC, MNC, LAC/TAC, Cell ID)')
|
||
|
||
def test_fetch_pli_date_time(self):
|
||
r = decode_message(bytes.fromhex(
|
||
'801200000BD0098103012603820281829000'))
|
||
self.assertEqual(r['cat_command'],
|
||
'PROVIDE LOCAL INFORMATION — Date, time and time zone')
|
||
|
||
def test_non_pli_no_qualifier(self):
|
||
r = decode_message(bytes.fromhex(
|
||
'801400000C810301250002028281830100910F'))
|
||
self.assertEqual(r['response_to'], 'SET UP MENU')
|
||
|
||
|
||
class TestGetResponseContext(unittest.TestCase):
|
||
GET_RESPONSE = bytes.fromhex('00C000002962278202782183023F00A50A800171')
|
||
|
||
def test_with_prev_select(self):
|
||
r = decode_message(self.GET_RESPONSE, prev={'ins_name': 'SELECT', 'sw1': '61'})
|
||
self.assertEqual(r['response_for'], 'SELECT')
|
||
|
||
def test_with_prev_non_61(self):
|
||
r = decode_message(self.GET_RESPONSE, prev={'ins_name': 'SELECT', 'sw1': '90'})
|
||
self.assertIsNone(r['response_for'])
|
||
|
||
def test_orphaned(self):
|
||
r = decode_message(self.GET_RESPONSE, prev=None)
|
||
self.assertIsNone(r['response_for'])
|
||
|
||
|
||
class TestFcpResponse(unittest.TestCase):
|
||
GET_RESPONSE = bytes.fromhex(
|
||
'00C000002962278202782183023F00A50A8001718302F9628701018A01058B032F0601C60990014083010183010A9000')
|
||
|
||
def test_select_response_fcp(self):
|
||
r = decode_message(self.GET_RESPONSE, prev={'ins': 0xA4, 'ins_name': 'SELECT', 'sw1': '61'})
|
||
self.assertEqual(r['response_for'], 'SELECT')
|
||
resp = r['response']
|
||
self.assertEqual(resp['template'], 'FCP')
|
||
self.assertEqual(resp['file_id'], '3F00')
|
||
self.assertEqual(resp['file_id_name'], 'MF')
|
||
self.assertEqual(resp['file_descriptor']['file_type'], 'DF or ADF')
|
||
self.assertEqual(resp['file_descriptor']['shareable'], 'shareable')
|
||
self.assertEqual(resp['life_cycle'], 'operational state (activated)')
|
||
|
||
def test_ef_descriptor_transparent(self):
|
||
from simtrace2_pysniff.server.decode import _decode_file_descriptor
|
||
fd = _decode_file_descriptor(bytes.fromhex('0121'))
|
||
self.assertEqual(fd['file_type'], 'Working EF')
|
||
self.assertEqual(fd['structure'], 'transparent')
|
||
|
||
def test_ef_descriptor_linear_fixed(self):
|
||
from simtrace2_pysniff.server.decode import _decode_file_descriptor
|
||
fd = _decode_file_descriptor(bytes.fromhex('0221'))
|
||
self.assertEqual(fd['file_type'], 'Working EF')
|
||
self.assertEqual(fd['structure'], 'linear fixed')
|
||
|
||
def test_fcp_file_size(self):
|
||
from simtrace2_pysniff.server.decode import _decode_fcp
|
||
# FCP: file descriptor (transparent EF) + FID 6F07 + file size 9 + total 9
|
||
fcp = _decode_fcp(bytes.fromhex('8202012183026f07800109810109'))
|
||
self.assertEqual(fcp['file_descriptor']['file_type'], 'Working EF')
|
||
self.assertEqual(fcp['file_descriptor']['structure'], 'transparent')
|
||
self.assertEqual(fcp['file_id_name'], 'EF_IMSI')
|
||
self.assertEqual(fcp['file_size'], 9)
|
||
self.assertEqual(fcp['total_file_size'], 9)
|
||
|
||
def test_fcp_summary_transparent(self):
|
||
# GET RESPONSE (FCP) for a transparent EF of 9 bytes
|
||
gr = bytes.fromhex('00c000000c') + bytes.fromhex('620c8202012183026f07800109810109') + bytes.fromhex('9000')
|
||
r = decode_message(gr, prev={'ins': 0xA4, 'ins_name': 'SELECT', 'sw1': '61'})
|
||
self.assertEqual(r['summary'], 'response for SELECT, Working EF, transparent, 9 B')
|
||
|
||
def test_fcp_summary_linear_fixed(self):
|
||
# linear fixed EF, 3 records x 64 bytes
|
||
gr = bytes.fromhex('00c000000e') + bytes.fromhex('620e8205022100400383026f07800109') + bytes.fromhex('9000')
|
||
r = decode_message(gr, prev={'ins': 0xA4, 'ins_name': 'SELECT', 'sw1': '61'})
|
||
self.assertEqual(r['summary'], 'response for SELECT, Working EF, linear fixed, 3 rec × 64 B')
|
||
|
||
def test_fcp_summary_df(self):
|
||
r = decode_message(self.GET_RESPONSE, prev={'ins': 0xA4, 'ins_name': 'SELECT', 'sw1': '61'})
|
||
self.assertEqual(r['summary'], 'response for SELECT, DF or ADF (MF)')
|
||
|
||
|
||
class TestAuthResponse(unittest.TestCase):
|
||
def test_3g_success(self):
|
||
from simtrace2_pysniff.server.decode import _decode_auth
|
||
data = bytes.fromhex('DB084CFA9017FD0DD85A101A2622F60E8ABD2C2497B9A8EFAF55E510CAA393329FF97868B9537369D5266A4F084D417B05ABFAFAEE')
|
||
r = _decode_auth(data)
|
||
self.assertEqual(r['type'], '3G')
|
||
self.assertEqual(r['status'], 'success')
|
||
self.assertEqual(r['res'], '4CFA9017FD0DD85A')
|
||
self.assertEqual(r['ck'], '1A2622F60E8ABD2C2497B9A8EFAF55E5')
|
||
self.assertEqual(r['ik'], 'CAA393329FF97868B9537369D5266A4F')
|
||
|
||
def test_3g_sync_fail(self):
|
||
from simtrace2_pysniff.server.decode import _decode_auth
|
||
data = bytes.fromhex('DC0E' + '00' * 14)
|
||
r = _decode_auth(data)
|
||
self.assertEqual(r['type'], '3G')
|
||
self.assertEqual(r['status'], 'sync fail')
|
||
self.assertEqual(r['auts'], '00' * 14)
|
||
|
||
def test_gsm(self):
|
||
from simtrace2_pysniff.server.decode import _decode_auth
|
||
sres = bytes.fromhex('AABBCCDD')
|
||
kc = bytes.fromhex('0011223344556677')
|
||
r = _decode_auth(sres + kc)
|
||
self.assertEqual(r['type'], 'GSM')
|
||
self.assertEqual(r['sres'], 'AABBCCDD')
|
||
self.assertEqual(r['kc'], '0011223344556677')
|
||
|
||
|
||
class TestTrResult(unittest.TestCase):
|
||
def test_success(self):
|
||
r = decode_message(bytes.fromhex('801400000C8103010500020282810301009130'))
|
||
self.assertEqual(r['response']['code'], '0x00')
|
||
self.assertEqual(r['response']['name'], 'Command performed successfully')
|
||
|
||
def test_session_terminated(self):
|
||
from simtrace2_pysniff.server.decode import _decode_tr_result
|
||
r = _decode_tr_result(bytes.fromhex('81030105000202828103010A'))
|
||
self.assertEqual(r['code'], '0x0A')
|
||
self.assertEqual(r['name'], 'Proactive UICC session terminated by the user')
|
||
|
||
|
||
class TestTrAdditionalInfo(unittest.TestCase):
|
||
def test_poll_interval_duration(self):
|
||
r = decode_message(bytes.fromhex(
|
||
'80140000108103010300020282810301000402011E9000'))
|
||
self.assertEqual(r['response_to'], 'POLL INTERVAL')
|
||
self.assertEqual(r['response']['duration'], {'value': 30, 'unit': 'seconds'})
|
||
|
||
def test_pli_location_info(self):
|
||
r = decode_message(bytes.fromhex(
|
||
'8014000017810301260002028281030106130952F0991EC57A43C09F9000'))
|
||
self.assertEqual(
|
||
r['response']['local_info']['Location'],
|
||
'MCC 250 MNC 99 · LAC 0x1EC5 · Cell 0x7A43C09F')
|
||
|
||
def test_pli_imei(self):
|
||
r = decode_message(bytes.fromhex(
|
||
'801400001681030126010202828103010014088A763201652428089000'))
|
||
self.assertEqual(r['response']['local_info']['IMEI'],
|
||
'867231056428280')
|
||
|
||
def test_pli_datetime(self):
|
||
from simtrace2_pysniff.server.decode import _decode_datetime
|
||
self.assertEqual(
|
||
_decode_datetime(bytes.fromhex('26081214300021')),
|
||
'2026-08-12 14:30:00 (UTC+03:00)')
|
||
self.assertEqual(
|
||
_decode_datetime(bytes.fromhex('260812143000FF')),
|
||
'2026-08-12 14:30:00 (UTCunknown)')
|
||
|
||
def test_datetime_invalid_bcd(self):
|
||
from simtrace2_pysniff.server.decode import _decode_datetime
|
||
self.assertIsNone(_decode_datetime(bytes.fromhex('A505326C333939')))
|
||
|
||
def test_datetime_invalid_semantics(self):
|
||
from simtrace2_pysniff.server.decode import _decode_datetime
|
||
self.assertIsNone(_decode_datetime(bytes.fromhex('02209121654021')))
|
||
|
||
def test_pli_language(self):
|
||
from simtrace2_pysniff.server.decode import _decode_local_info, PLI_LANGUAGE
|
||
self.assertEqual(_decode_local_info(PLI_LANGUAGE, b'en'),
|
||
{'label': 'Language', 'value': 'en'})
|
||
|
||
def test_pli_battery(self):
|
||
from simtrace2_pysniff.server.decode import _decode_local_info, PLI_BATTERY
|
||
self.assertEqual(_decode_local_info(PLI_BATTERY, b'\x05'),
|
||
{'label': 'Battery', 'value': 'full'})
|
||
|
||
def test_pli_access_tech(self):
|
||
from simtrace2_pysniff.server.decode import _decode_local_info, PLI_ACCESS_TECH
|
||
self.assertEqual(_decode_local_info(PLI_ACCESS_TECH, bytes([0x03, 0x07])),
|
||
{'label': 'Access technology', 'value': 'UTRAN, E-UTRAN'})
|
||
|
||
|
||
class TestAuthCommand(unittest.TestCase):
|
||
def test_3g_rand_autn(self):
|
||
r = decode_message(bytes.fromhex(
|
||
'0088008122104A75BA425D438C549EF35BA5E3DD53051065E04D80E4DC8000A5C7FD842F41395E6135'))
|
||
cmd = r['cmd']
|
||
self.assertEqual(cmd['context'], '3G (UMTS)')
|
||
self.assertEqual(cmd['rand'], '4A75BA425D438C549EF35BA5E3DD5305')
|
||
self.assertEqual(cmd['autn'], '65E04D80E4DC8000A5C7FD842F41395E')
|
||
|
||
def test_gsm_rand_only(self):
|
||
from simtrace2_pysniff.server.decode import _decode_auth_cmd
|
||
r = _decode_auth_cmd(bytes.fromhex('10' + '00' * 16), 0x00)
|
||
self.assertEqual(r['context'], 'GSM')
|
||
self.assertEqual(r['rand'], '00' * 16)
|
||
self.assertNotIn('autn', r)
|
||
|
||
|
||
class TestEventDownload(unittest.TestCase):
|
||
def test_location_status(self):
|
||
r = decode_message(bytes.fromhex(
|
||
'80C2000017D615190103020282811B0100130952F0991EC57A43C09F9000'))
|
||
cmd = r['cmd']
|
||
self.assertEqual(cmd['type'], 'EVENT DOWNLOAD')
|
||
self.assertEqual(cmd['events'], ['Location status'])
|
||
self.assertEqual(cmd['location_status'], 'Normal service')
|
||
|
||
def test_event_no_service(self):
|
||
r = decode_message(bytes.fromhex(
|
||
'80C200000CD60A190103020282811B01029000'))
|
||
self.assertEqual(r['cmd']['events'], ['Location status'])
|
||
self.assertEqual(r['cmd']['location_status'], 'No service')
|
||
|
||
def test_location_status_with_info(self):
|
||
r = decode_message(bytes.fromhex(
|
||
'80C2000017D615190103020282811B0100130952F02026ADBC51A16F9000'))
|
||
cmd = r['cmd']
|
||
self.assertEqual(cmd['location_status'], 'Normal service')
|
||
self.assertEqual(cmd['location_info'],
|
||
'MCC 250 MNC 02 · LAC 0x26AD · Cell 0xBC51A16F')
|
||
|
||
def test_mt_call(self):
|
||
r = decode_message(bytes.fromhex(
|
||
'80C2000014D612190100020283811C010586069121436587099000'))
|
||
cmd = r['cmd']
|
||
self.assertEqual(cmd['events'], ['MT call'])
|
||
self.assertEqual(cmd['transaction_id'], 5)
|
||
self.assertEqual(cmd['caller'], '+1234567890')
|
||
|
||
def test_cell_broadcast(self):
|
||
cbp = ('4C511002F211' +
|
||
'040000313A0103035E047FFB0F31303238322A333036343835363234' +
|
||
'0D' * 54)
|
||
r = decode_message(bytes.fromhex(
|
||
'80C2000060D25E020283810C58' + cbp + '9000'))
|
||
cmd = r['cmd']
|
||
self.assertEqual(cmd['type'], 'CELL BROADCAST DOWNLOAD')
|
||
self.assertEqual(cmd['cb_page']['serial'], '4C51')
|
||
self.assertEqual(cmd['cb_page']['message_id'], '0x1002')
|
||
self.assertEqual(cmd['cb_page']['page'], '1/1')
|
||
self.assertEqual(cmd['cb_page']['content'],
|
||
'040000313A0103035E047FFB0F31303238322A333036343835363234' + '0D' * 54)
|
||
|
||
|
||
class TestSmTpdu(unittest.TestCase):
|
||
def _bcd(self, number):
|
||
d = [int(c) for c in number]
|
||
out = bytearray()
|
||
for i in range(0, len(d), 2):
|
||
lo = d[i]
|
||
hi = d[i + 1] if i + 1 < len(d) else 0xF
|
||
out.append((hi << 4) | lo)
|
||
return bytes(out)
|
||
|
||
def test_deliver_gsm7(self):
|
||
from simtrace2_pysniff.server.decode import _decode_sm_tpdu
|
||
oa = b'\x91' + self._bcd('79031234567')
|
||
tpdu = (b'\x00' + bytes([11]) + oa + b'\x00\x00' + b'\x00' * 7 +
|
||
b'\x05' + bytes.fromhex('E8329BFD06'))
|
||
r = _decode_sm_tpdu(tpdu)
|
||
self.assertEqual(r['mti'], 'SMS-DELIVER')
|
||
self.assertEqual(r['oa'], '+79031234567')
|
||
self.assertEqual(r['encoding'], 'GSM 7-bit')
|
||
self.assertEqual(r['text'], 'hello')
|
||
|
||
def test_deliver_ucs2(self):
|
||
from simtrace2_pysniff.server.decode import _decode_sm_tpdu
|
||
oa = b'\x91' + self._bcd('79031234567')
|
||
ucs2 = '\u041f\u0440\u0438\u0432\u0435\u0442'.encode('utf-16-be')
|
||
tpdu = (b'\x00' + bytes([11]) + oa + b'\x00\x08' + b'\x00' * 7 +
|
||
bytes([len(ucs2)]) + ucs2)
|
||
r = _decode_sm_tpdu(tpdu)
|
||
self.assertEqual(r['encoding'], 'UCS2')
|
||
self.assertEqual(r['text'], '\u041f\u0440\u0438\u0432\u0435\u0442')
|
||
|
||
def test_8bit_no_text(self):
|
||
from simtrace2_pysniff.server.decode import _decode_sm_tpdu
|
||
oa = b'\x91' + self._bcd('79031234567')
|
||
# Mixed low/high bytes are treated as binary → no text decode.
|
||
payload = bytes.fromhex('00018081A0FF07')
|
||
tpdu = (b'\x00' + bytes([11]) + oa + b'\x00\x04' + b'\x00' * 7 +
|
||
bytes([len(payload)]) + payload)
|
||
r = _decode_sm_tpdu(tpdu)
|
||
self.assertEqual(r['encoding'], '8-bit data')
|
||
self.assertNotIn('text', r)
|
||
self.assertEqual(r['payload'], '00018081A0FF07')
|
||
|
||
def test_sim_data_download(self):
|
||
from simtrace2_pysniff.server.decode import _decode_sm_tpdu
|
||
oa = b'\x91' + self._bcd('79031234567')
|
||
tpdu = (b'\x00' + bytes([11]) + oa + b'\x7f\x04' + b'\x00' * 7 +
|
||
b'\x10' + bytes(range(16)))
|
||
r = _decode_sm_tpdu(tpdu)
|
||
self.assertEqual(r['pid_name'], 'SIM data download (secured packet)')
|
||
self.assertEqual(r['payload'], '000102030405060708090A0B0C0D0E0F')
|
||
|
||
def test_deliver_scts(self):
|
||
from simtrace2_pysniff.server.decode import _decode_sm_tpdu
|
||
oa = b'\x91' + self._bcd('79031234567')
|
||
scts = bytes.fromhex('26081214300021')
|
||
tpdu = (b'\x00' + bytes([11]) + oa + b'\x00\x00' + scts + b'\x00')
|
||
r = _decode_sm_tpdu(tpdu)
|
||
self.assertEqual(r['scts'], '2026-08-12 14:30:00 (UTC+03:00)')
|
||
|
||
def test_deliver_pid_name(self):
|
||
from simtrace2_pysniff.server.decode import _decode_sm_tpdu
|
||
oa = b'\x91' + self._bcd('79031234567')
|
||
tpdu = (b'\x00' + bytes([11]) + oa + b'\x48\x00' + b'\x00' * 7 + b'\x00')
|
||
r = _decode_sm_tpdu(tpdu)
|
||
self.assertEqual(r['pid_name'], 'Device Triggering Short Message')
|
||
|
||
def test_deliver_dcs_info(self):
|
||
from simtrace2_pysniff.server.decode import _decode_sm_tpdu
|
||
oa = b'\x91' + self._bcd('79031234567')
|
||
tpdu = (b'\x00' + bytes([11]) + oa + b'\x00\x11' + b'\x00' * 7 + b'\x00')
|
||
r = _decode_sm_tpdu(tpdu)
|
||
self.assertEqual(r['dcs_info']['group'], 'Message Marked for Automatic Deletion')
|
||
self.assertEqual(r['dcs_info']['has_class'], True)
|
||
self.assertEqual(r['dcs_info']['msg_class'], 1)
|
||
|
||
def test_dcs_mwi(self):
|
||
from simtrace2_pysniff.server.decode import _decode_dcs_full
|
||
d = _decode_dcs_full(0xD0)
|
||
self.assertEqual(d['group'], 'Message Waiting Indication')
|
||
self.assertEqual(d['action'], 'store')
|
||
self.assertEqual(d['sense'], 'inactive')
|
||
self.assertEqual(d['indication'], 'voicemail')
|
||
|
||
def test_udh_concat_8bit(self):
|
||
from simtrace2_pysniff.server.decode import _decode_udh
|
||
el = _decode_udh(bytes.fromhex('0003A10201'))
|
||
self.assertEqual(el[0]['name'], 'Concatenated short messages, 8-bit reference number')
|
||
self.assertEqual(el[0]['data'], {'reference': 0xA1, 'max': 2, 'seq': 1})
|
||
|
||
def test_udh_concat_16bit(self):
|
||
from simtrace2_pysniff.server.decode import _decode_udh
|
||
el = _decode_udh(bytes.fromhex('080403000201'))
|
||
self.assertEqual(el[0]['name'], 'Concatenated short message, 16-bit reference number')
|
||
self.assertEqual(el[0]['data'], {'reference': 0x0300, 'max': 2, 'seq': 1})
|
||
|
||
def test_udh_app_port_8bit(self):
|
||
from simtrace2_pysniff.server.decode import _decode_udh
|
||
el = _decode_udh(bytes.fromhex('0402B5A5'))
|
||
self.assertEqual(el[0]['data'], {'dest_port': 0xB5, 'orig_port': 0xA5})
|
||
|
||
def test_udh_app_port_16bit(self):
|
||
from simtrace2_pysniff.server.decode import _decode_udh
|
||
el = _decode_udh(bytes.fromhex('05040B8423F0'))
|
||
self.assertEqual(el[0]['data'], {'dest_port': 0x0B84, 'orig_port': 0x23F0})
|
||
|
||
def test_udh_special_sms(self):
|
||
from simtrace2_pysniff.server.decode import _decode_udh
|
||
el = _decode_udh(bytes.fromhex('01028102'))
|
||
self.assertEqual(el[0]['data'], {'store': True, 'indication': 'fax', 'count': 2})
|
||
|
||
def test_deliver_udh_ucs2(self):
|
||
from simtrace2_pysniff.server.decode import _decode_sm_tpdu
|
||
oa = b'\x91' + self._bcd('79031234567')
|
||
ud = bytes.fromhex('050003A10201') + 'Hi'.encode('utf-16-be')
|
||
tpdu = (b'\x40' + bytes([11]) + oa + b'\x00\x08' + b'\x00' * 7 +
|
||
bytes([len(ud)]) + ud)
|
||
r = _decode_sm_tpdu(tpdu)
|
||
self.assertEqual(r['udh'][0]['data'], {'reference': 0xA1, 'max': 2, 'seq': 1})
|
||
self.assertEqual(r['text'], 'Hi')
|
||
|
||
def test_submit_vp_relative(self):
|
||
from simtrace2_pysniff.server.decode import _decode_sm_tpdu
|
||
da = b'\x81' + self._bcd('999')
|
||
tpdu = b'\x09' + b'\x2A' + bytes([len(da)]) + da + b'\x00\x00' + b'\x8F' + b'\x00'
|
||
r = _decode_sm_tpdu(tpdu)
|
||
self.assertEqual(r['mti'], 'SMS-SUBMIT')
|
||
self.assertEqual(r['vp'], '720 min')
|
||
|
||
def test_submit_vp_absolute(self):
|
||
from simtrace2_pysniff.server.decode import _decode_sm_tpdu
|
||
da = b'\x81' + self._bcd('999')
|
||
scts = bytes.fromhex('26081214300021')
|
||
tpdu = b'\x11' + b'\x2A' + bytes([len(da)]) + da + b'\x00\x00' + scts + b'\x00'
|
||
r = _decode_sm_tpdu(tpdu)
|
||
self.assertEqual(r['vp'], '2026-08-12 14:30:00 (UTC+03:00)')
|
||
|
||
def test_submit_no_ud_encoding(self):
|
||
# Real capture: absolute VP with non-BCD bytes, no TP-UD.
|
||
from simtrace2_pysniff.server.decode import _decode_sm_tpdu
|
||
tpdu = bytes.fromhex('11FF038154F50004A505326C333939')
|
||
r = _decode_sm_tpdu(tpdu)
|
||
self.assertEqual(r['da'], '455')
|
||
self.assertEqual(r['encoding'], '8-bit data')
|
||
self.assertEqual(r['msg_class'], 0)
|
||
self.assertEqual(r['vp'], 'A505326C333939')
|
||
|
||
def test_8bit_ascii_text(self):
|
||
from simtrace2_pysniff.server.decode import _decode_sm_tpdu
|
||
oa = b'\x91' + self._bcd('79031234567')
|
||
payload = b'Hello World'
|
||
tpdu = (b'\x00' + bytes([11]) + oa + b'\x00\x04' + b'\x00' * 7 +
|
||
bytes([len(payload)]) + payload)
|
||
r = _decode_sm_tpdu(tpdu)
|
||
self.assertEqual(r['encoding'], '8-bit data')
|
||
self.assertEqual(r['text'], 'Hello World')
|
||
|
||
def test_8bit_ascii_ctrl_replaced(self):
|
||
from simtrace2_pysniff.server.decode import _decode_sm_tpdu
|
||
oa = b'\x91' + self._bcd('79031234567')
|
||
payload = b'Hi\x00There'
|
||
tpdu = (b'\x00' + bytes([11]) + oa + b'\x00\x04' + b'\x00' * 7 +
|
||
bytes([len(payload)]) + payload)
|
||
r = _decode_sm_tpdu(tpdu)
|
||
self.assertEqual(r['text'], 'Hi\u00b7There')
|
||
|
||
def test_8bit_high_text(self):
|
||
from simtrace2_pysniff.server.decode import _decode_sm_tpdu
|
||
oa = b'\x91' + self._bcd('79031234567')
|
||
payload = '\u00e9\u00fc\u00f1'.encode('latin-1')
|
||
tpdu = (b'\x00' + bytes([11]) + oa + b'\x00\x04' + b'\x00' * 7 +
|
||
bytes([len(payload)]) + payload)
|
||
r = _decode_sm_tpdu(tpdu)
|
||
self.assertEqual(r['text'], '\u00e9\u00fc\u00f1')
|
||
|
||
def test_8bit_mixed_no_text(self):
|
||
from simtrace2_pysniff.server.decode import _decode_sm_tpdu
|
||
oa = b'\x91' + self._bcd('79031234567')
|
||
payload = b'\x00\x01\xff\xfe'
|
||
tpdu = (b'\x00' + bytes([11]) + oa + b'\x00\x04' + b'\x00' * 7 +
|
||
bytes([len(payload)]) + payload)
|
||
r = _decode_sm_tpdu(tpdu)
|
||
self.assertNotIn('text', r)
|
||
self.assertEqual(r['payload'], '0001FFFE')
|
||
|
||
|
||
class TestBcdAddress(unittest.TestCase):
|
||
def test_international(self):
|
||
from simtrace2_pysniff.server.decode import _decode_bcd_address
|
||
self.assertEqual(_decode_bcd_address(bytes.fromhex('912143658709')), '+1234567890')
|
||
|
||
def test_national(self):
|
||
from simtrace2_pysniff.server.decode import _decode_bcd_address
|
||
self.assertEqual(_decode_bcd_address(bytes.fromhex('A12143658709')), '1234567890')
|
||
|
||
def test_odd_digits(self):
|
||
from simtrace2_pysniff.server.decode import _decode_bcd_address
|
||
self.assertEqual(_decode_bcd_address(bytes.fromhex('9121436587F9')), '+123456789')
|
||
|
||
|
||
class TestProactiveDecode(unittest.TestCase):
|
||
def test_setup_menu(self):
|
||
r = decode_message(bytes.fromhex(
|
||
'8012000030D02E810301250082028182050B416C6661204D6F62696C'
|
||
'658F16808112089DB0C1C2C0BEB9BAB82F53657474696E67739000'))
|
||
cmd = r['cmd']
|
||
self.assertEqual(cmd['type'], 'SET UP MENU')
|
||
self.assertEqual(cmd['title'], 'Alfa Mobile')
|
||
self.assertEqual(cmd['items'], [{'id': 0x80, 'text': 'Настройки/Settings'}])
|
||
|
||
def test_setup_event_list(self):
|
||
r = decode_message(bytes.fromhex(
|
||
'801200000FD00D810301050082028182990203129000'))
|
||
self.assertEqual(r['cmd']['events'], ['Location status', 'Network Rejection'])
|
||
|
||
def test_poll_interval_duration(self):
|
||
r = decode_message(bytes.fromhex(
|
||
'801200000FD00D8103010300820281820402011E9000'))
|
||
self.assertEqual(r['cmd']['duration'], {'value': 30, 'unit': 'seconds'})
|
||
|
||
def test_send_short_message_tpdu(self):
|
||
r = decode_message(bytes.fromhex(
|
||
'801200004AD04881030113008202818305000B3B11FF038199F90004A531'
|
||
'494D45492038363732333130353634323832383020494D53492032353031'
|
||
'3937373030313932373935204556454E5420319000'))
|
||
self.assertEqual(r['cmd']['type'], 'SEND SHORT MESSAGE')
|
||
self.assertEqual(r['cmd']['tpdu']['mti'], 'SMS-SUBMIT')
|
||
self.assertEqual(r['cmd']['tpdu']['da'], '999')
|
||
|
||
def test_send_short_message_rich_tpdu(self):
|
||
r = decode_message(bytes.fromhex(
|
||
'801200001AD01881030113008202818305000B0B0101038199F9000402'
|
||
'48699000'))
|
||
t = r['cmd']['tpdu']
|
||
self.assertEqual(r['cmd']['type'], 'SEND SHORT MESSAGE')
|
||
self.assertEqual(t['mti'], 'SMS-SUBMIT')
|
||
self.assertEqual(t['da'], '999')
|
||
self.assertEqual(t['pid_name'], 'SME-to-SME (implicit)')
|
||
self.assertEqual(t['encoding'], '8-bit data')
|
||
self.assertEqual(t['text'], 'Hi')
|
||
|
||
def test_setup_menu_long_form_length(self):
|
||
# Real Mi A1 startup trace: D0 length encoded as 0x81 0xBC (188 bytes).
|
||
r = decode_message(bytes.fromhex(
|
||
'80120000BFD081BC810301250082028182051580004D0065006700610046'
|
||
'006F006E00500052004F8F100180041C0435043304300424043E043D8F18'
|
||
'02800420043004370432043B043504470435043D0438044F8F0C03800421'
|
||
'043F043E044004428F100480041D043E0432043E0441044204388F100580'
|
||
'04240438043D0430043D0441044B8F1006800421043F044004300432043A'
|
||
'04308F100780041E043104490435043D043804358F188080041A0430043B'
|
||
'043504390434043E0441043A043E043F9000'))
|
||
self.assertEqual(r['cat_command'], 'SET UP MENU')
|
||
self.assertEqual(r['cmd']['title'], 'MegaFonPRO')
|
||
self.assertEqual(r['cmd']['items'][0], {'id': 1, 'text': 'МегаФон'})
|
||
|
||
|
||
class TestAnnexA(unittest.TestCase):
|
||
def test_gsm_default(self):
|
||
from simtrace2_pysniff.server.decode import _decode_annex_a
|
||
self.assertEqual(_decode_annex_a(b'Alfa Mobile'), 'Alfa Mobile')
|
||
|
||
def test_ucs2_variant1(self):
|
||
from simtrace2_pysniff.server.decode import _decode_annex_a
|
||
self.assertEqual(_decode_annex_a(b'\x80' + 'Привет'.encode('utf_16_be')), 'Привет')
|
||
|
||
def test_ucs2_variant2_base_ptr(self):
|
||
from simtrace2_pysniff.server.decode import _decode_annex_a
|
||
# 'Н' = U+041D, base 0x08<<7 = 0x400, offset 0x1D
|
||
self.assertEqual(_decode_annex_a(bytes.fromhex('8101089D')), 'Н')
|
||
|
||
|
||
class TestDcsText(unittest.TestCase):
|
||
def test_gsm7(self):
|
||
from simtrace2_pysniff.server.decode import _decode_dcs_text
|
||
self.assertEqual(_decode_dcs_text(b'\x00Alfa'), 'Alfa')
|
||
|
||
def test_ucs2(self):
|
||
from simtrace2_pysniff.server.decode import _decode_dcs_text
|
||
self.assertEqual(_decode_dcs_text(b'\x08' + 'OK'.encode('utf_16_be')), 'OK')
|
||
|
||
def test_latin1(self):
|
||
from simtrace2_pysniff.server.decode import _decode_dcs_text
|
||
self.assertEqual(_decode_dcs_text(b'\x04caf\xe9'), 'café')
|
||
|
||
|
||
class TestAtrPps(unittest.TestCase):
|
||
def test_atr_simple_t0_only(self):
|
||
from simtrace2_pysniff.server.decode import _decode_atr
|
||
# 3B 00: direct, T0=00, no interface bytes, 0 historical bytes, only T=0 → no TCK
|
||
r = _decode_atr(bytes.fromhex('3B00'))
|
||
self.assertEqual(r['convention'], 'direct')
|
||
self.assertEqual(r['t0'], '00')
|
||
self.assertEqual(r['historical_len'], 0)
|
||
self.assertNotIn('tck', r)
|
||
|
||
def test_atr_ta1(self):
|
||
from simtrace2_pysniff.server.decode import _decode_atr
|
||
# 3B 12 11 00 00: TA1=11 (Fi=1,Di=1), 2 historical bytes, T=0 → no TCK
|
||
r = _decode_atr(bytes.fromhex('3B12110000'))
|
||
self.assertEqual(r['convention'], 'direct')
|
||
self.assertEqual(r['interface'][0]['name'], 'TA1')
|
||
self.assertEqual(r['interface'][0]['f'], 372)
|
||
self.assertEqual(r['interface'][0]['d'], 1)
|
||
self.assertEqual(r['historical_len'], 2)
|
||
self.assertNotIn('tck', r)
|
||
|
||
def test_atr_td1_t1_has_tck(self):
|
||
from simtrace2_pysniff.server.decode import _decode_atr
|
||
# 3B 80 01 80 31 80 66 ... : construct T=1 with TCK
|
||
# T0=80 → TD1 present, 0 historical; TD1=01 (T=1, no more interface); then TCK
|
||
# bytes: 3B 80 01 xx where xx = XOR(80,01) = 81
|
||
r = _decode_atr(bytes.fromhex('3B800181'))
|
||
self.assertEqual(r['protocols'], ['T=1'])
|
||
self.assertIn('tck', r)
|
||
self.assertTrue(r['tck_valid'])
|
||
self.assertEqual(r['tck'], '81')
|
||
|
||
def test_atr_inverse_convention(self):
|
||
from simtrace2_pysniff.server.decode import _decode_atr
|
||
# Inverse: TS=3F, then inverted bytes. Take direct ATR "3B 00" and invert body.
|
||
# Inverted 0x00 is 0x00, so ATR = 3F 00 → convention inverse, T0=00.
|
||
r = _decode_atr(bytes.fromhex('3F00'))
|
||
self.assertEqual(r['convention'], 'inverse')
|
||
self.assertEqual(r['t0'], '00')
|
||
|
||
def test_atr_historical_life_cycle(self):
|
||
from simtrace2_pysniff.server.decode import _decode_atr
|
||
# T0 = 0x03 (3 historical bytes); historical = 80 00 05 (life cycle: operational)
|
||
r = _decode_atr(bytes.fromhex('3B03800005'))
|
||
self.assertEqual(r['historical_len'], 3)
|
||
self.assertEqual(r['historical']['category'], 'status information (life cycle)')
|
||
self.assertEqual(r['historical']['life_cycle'], 'operational state (activated)')
|
||
|
||
def test_pps(self):
|
||
from simtrace2_pysniff.server.decode import _decode_pps
|
||
# FF 10 11 xx: PPS0=10 (T=0, PPS1 present), PPS1=11 (Fi=1,Di=1), PCK=XOR(FF,10,11)=FE
|
||
r = _decode_pps(bytes.fromhex('FF1011FE'))
|
||
self.assertEqual(r['protocol'], 'T=0')
|
||
self.assertEqual(r['fi_di']['f'], 372)
|
||
self.assertEqual(r['fi_di']['d'], 1)
|
||
self.assertTrue(r['pck_valid'])
|
||
self.assertEqual(r['pck'], 'FE')
|
||
|
||
|
||
class TestSummary(unittest.TestCase):
|
||
def test_select_path_from_mf(self):
|
||
r = decode_message(bytes.fromhex('a0a40804022fe29000'))
|
||
self.assertEqual(r['summary'], 'Path from MF: 2FE2 (EF_ICCID), Return FCI template')
|
||
|
||
def test_select_by_file_id(self):
|
||
r = decode_message(bytes.fromhex('a0a40000023f009000'))
|
||
self.assertEqual(r['summary'], 'DF/EF/MF by file ID: 3F00 (MF)')
|
||
|
||
def test_read_record(self):
|
||
r = decode_message(bytes.fromhex('a0b2010400'))
|
||
self.assertEqual(r['summary'], 'Record number: 1, use record number from P1')
|
||
|
||
def test_verify_pin_no_leak(self):
|
||
r = decode_message(bytes.fromhex('0020000000'))
|
||
self.assertEqual(r['summary'], 'Verify PIN1')
|
||
|
||
def test_fetch_setup_menu(self):
|
||
r = decode_message(bytes.fromhex(
|
||
'8012000030D02E810301250082028182050B416C6661204D6F62696C'
|
||
'658F16808112089DB0C1C2C0BEB9BAB82F53657474696E67739000'))
|
||
self.assertEqual(r['summary'], 'Alfa Mobile, 1 item')
|
||
|
||
def test_envelope_sms_pp(self):
|
||
r = decode_message(bytes.fromhex(
|
||
'80C2000022D120020283810607919740430900F40B1104038154F50004'
|
||
'260812143000210248699000'))
|
||
self.assertEqual(r['summary'], 'SMSC +79043490004, SMS-DELIVER from 455 «Hi»')
|
||
|
||
def test_terminal_response(self):
|
||
r = decode_message(bytes.fromhex(
|
||
'80140000108103010300020282810301000402011E9000'))
|
||
self.assertEqual(r['summary'], '→ POLL INTERVAL, Command performed successfully')
|
||
|
||
def test_get_response_for(self):
|
||
r = decode_message(bytes.fromhex('a0c000000f'),
|
||
prev={'ins_name': 'SELECT', 'sw1': '61'})
|
||
self.assertEqual(r['summary'], 'response for SELECT')
|
||
|
||
|
||
class TestSelectPath(unittest.TestCase):
|
||
def test_path_adf_alias(self):
|
||
# 7FFF = current ADF; 6F05 after it → EF_LI (USIM).
|
||
r = decode_message(bytes.fromhex('a0a40804047fff6f059000'))
|
||
self.assertEqual(r['body']['note'], 'current ADF/EF_LI')
|
||
self.assertEqual(r['summary'],
|
||
'Path from MF: 7FFF6F05 (current ADF/EF_LI), Return FCI template')
|
||
|
||
def test_path_full(self):
|
||
r = decode_message(bytes.fromhex('a0a40804067f107f206f079000'))
|
||
self.assertEqual(r['body']['note'], 'DF_TELECOM/DF_GSM/EF_IMSI')
|
||
|
||
def test_path_current_df(self):
|
||
# P1 = 0x09 → 'Path from current DF' (no 7FFF/3F00 prefix).
|
||
r = decode_message(bytes.fromhex('a0a40904046f076f049000'))
|
||
self.assertEqual(r['p1']['name'], 'Path from current DF')
|
||
self.assertEqual(r['body']['note'], 'EF_IMSI/EF_IMPU')
|
||
|
||
def test_path_isim_adf_alias(self):
|
||
# 7FFF 6F04 → EF_IMPU (ISIM).
|
||
r = decode_message(bytes.fromhex('a0a40804047fff6f049000'))
|
||
self.assertEqual(r['body']['note'], 'current ADF/EF_IMPU')
|
||
|
||
def test_path_df_child(self):
|
||
# 7FFF 5F3B 4F20 → current ADF / DF_GSM_ACCESS / EF_Kc.
|
||
r = decode_message(bytes.fromhex('a0a40804067fff5f3b4f209000'))
|
||
self.assertEqual(r['body']['note'], 'current ADF/DF_GSM_ACCESS/EF_Kc')
|
||
|
||
def test_path_df_child_disambiguates_fid(self):
|
||
# 7F10 5F3B 4F47 → DF_TELECOM / DF_MULTIMEDIA / EF_MML (5F3B is
|
||
# DF_MULTIMEDIA here, not DF_GSM_ACCESS).
|
||
r = decode_message(bytes.fromhex('a0a40804067f105f3b4f479000'))
|
||
self.assertEqual(r['body']['note'], 'DF_TELECOM/DF_MULTIMEDIA/EF_MML')
|
||
|
||
def test_path_phonebook(self):
|
||
r = decode_message(bytes.fromhex('a0a40804067f105f3a4f229000'))
|
||
self.assertEqual(r['body']['note'], 'DF_TELECOM/DF_PHONEBOOK/EF_PSC')
|
||
|
||
def test_path_5gs(self):
|
||
r = decode_message(bytes.fromhex('a0a40804067fff5fc04f019000'))
|
||
self.assertEqual(r['body']['note'], 'current ADF/DF_5GS/EF_5GS3GPPLOCI')
|
||
|
||
|
||
class TestFileDecoders(unittest.TestCase):
|
||
def test_imsi(self):
|
||
from simtrace2_pysniff.server.decode import _decode_file_data
|
||
f = _decode_file_data('6f07', bytes.fromhex('0f52001132547698f0'))
|
||
self.assertEqual(f['imsi'], '250011234567890')
|
||
|
||
def test_iccid(self):
|
||
from simtrace2_pysniff.server.decode import _decode_file_data
|
||
f = _decode_file_data('2fe2', bytes.fromhex('98891020000000460012'))
|
||
self.assertEqual(f['iccid'], '89980102000000640021')
|
||
|
||
def test_li(self):
|
||
from simtrace2_pysniff.server.decode import _decode_file_data
|
||
f = _decode_file_data('6f05', b'enru')
|
||
self.assertEqual(f['languages'], ['en', 'ru'])
|
||
|
||
def test_adn(self):
|
||
from simtrace2_pysniff.server.decode import _decode_file_data
|
||
f = _decode_file_data('6f3a', bytes.fromhex(
|
||
'42204841203120536963FFFFFFFFFFFF06810628560810FFFFFFFFFFFFFF'))
|
||
self.assertEqual(f['name'], 'B HA 1 Sic')
|
||
self.assertEqual(f['number'], '6082658001')
|
||
|
||
def test_adn_ber_tlv_fallback(self):
|
||
# Non-ADN data (BER-TLV) must not be decoded as a name/number.
|
||
from simtrace2_pysniff.server.decode import _decode_file_data
|
||
raw = bytes.fromhex(
|
||
'A0348001078120E823FF53C3E271754A644ED63DEFCF24A916387E3C585F'
|
||
'0820CF3E27841852F7820400000000830400000000840102'
|
||
'FFFFFFFFFFFFFFFFFFFFFFFFFFFF')
|
||
f = _decode_file_data('6fc7', raw)
|
||
self.assertNotIn('name', f)
|
||
self.assertIn('raw', f)
|
||
|
||
def test_ust(self):
|
||
from simtrace2_pysniff.server.decode import _decode_file_data
|
||
f = _decode_file_data('6f38', bytes.fromhex('07'))
|
||
self.assertEqual([s['n'] for s in f['services']], [1, 2, 3])
|
||
self.assertEqual(f['services'][0]['name'], 'Local Phone Book')
|
||
|
||
def test_plmn_list(self):
|
||
from simtrace2_pysniff.server.decode import _decode_file_data
|
||
f = _decode_file_data('6f30', bytes.fromhex('42f095'))
|
||
self.assertEqual(len(f['plmns']), 1)
|
||
self.assertIn('mcc', f['plmns'][0])
|
||
self.assertIn('mnc', f['plmns'][0])
|
||
|
||
def test_dir(self):
|
||
from simtrace2_pysniff.server.decode import _decode_file_data
|
||
f = _decode_file_data('2f00', bytes.fromhex(
|
||
'612b4f10a0000000871002fffff00189000001ff50074d656761466f6e'
|
||
'730ea00c80011781025f408203454150ffffffffffffffffffffffffffffffffffffff'))
|
||
self.assertEqual(f['applications'][0]['label'], 'MegaFon')
|
||
self.assertEqual(f['applications'][0]['aid'], 'A0000000871002FFFFF00189000001FF')
|
||
|
||
def test_plmn_wact(self):
|
||
from simtrace2_pysniff.server.decode import _decode_file_data
|
||
# TS 51.011 §10.3.35: 5-byte entries (3 PLMN + 2 access tech).
|
||
f = _decode_file_data('6f60', bytes.fromhex('52f020400052f0208000'))
|
||
self.assertEqual(f['plmns'][0]['mcc'], '250')
|
||
self.assertEqual(f['plmns'][0]['mnc'], '02')
|
||
self.assertEqual(f['plmns'][0]['access_tech'], 'E-UTRAN NB-S1, E-UTRAN WB-S1')
|
||
self.assertEqual(f['plmns'][1]['access_tech'], 'UTRAN')
|
||
|
||
def test_sms_record(self):
|
||
from simtrace2_pysniff.server.decode import _decode_file_data
|
||
# status 0x07 (MO, to be sent) + empty SMSC (len 0) + SMS-SUBMIT TPDU
|
||
rec = bytes.fromhex('0700') + bytes.fromhex('01ff038199f90004024869')
|
||
f = _decode_file_data('6f3c', rec)
|
||
self.assertEqual(f['direction'], 'MO')
|
||
self.assertEqual(f['status'], 'message to be sent')
|
||
self.assertEqual(f['tpdu']['mti'], 'SMS-SUBMIT')
|
||
self.assertEqual(f['tpdu']['da'], '999')
|
||
self.assertEqual(f['tpdu']['text'], 'Hi')
|
||
|
||
def test_read_binary_direct(self):
|
||
# SELECT EF_IMSI then READ BINARY → file decoded in body.
|
||
r = decode_message(bytes.fromhex('00b0000009') +
|
||
bytes.fromhex('0f52001132547698f0') + bytes.fromhex('9000'),
|
||
prev={'sel': {'fid': '6f07', 'name': 'EF_IMSI'}})
|
||
self.assertEqual(r['file']['imsi'], '250011234567890')
|
||
self.assertIn('IMSI 250011234567890', r['summary'])
|
||
|
||
def test_read_binary_offset_skip(self):
|
||
r = decode_message(bytes.fromhex('00b00100') +
|
||
bytes.fromhex('0f52001132547698f0') + bytes.fromhex('9000'),
|
||
prev={'sel': {'fid': '6f07'}})
|
||
self.assertNotIn('file', r)
|
||
|
||
def test_read_via_get_response(self):
|
||
iccid = bytes.fromhex('98891020000000460012')
|
||
gr = bytes.fromhex('00c00000') + bytes([len(iccid)]) + iccid + bytes.fromhex('9000')
|
||
r = decode_message(gr, prev={'ins': 0xB0, 'ins_name': 'READ BINARY', 'sw1': '61',
|
||
'sel': {'fid': '2fe2'}, 'file_ok': True})
|
||
self.assertEqual(r['file']['iccid'], '89980102000000640021')
|
||
|
||
def test_get_response_file_ok_false(self):
|
||
iccid = bytes.fromhex('98891020000000460012')
|
||
gr = bytes.fromhex('00c00000') + bytes([len(iccid)]) + iccid + bytes.fromhex('9000')
|
||
r = decode_message(gr, prev={'ins': 0xB0, 'ins_name': 'READ BINARY', 'sw1': '61',
|
||
'sel': {'fid': '2fe2'}, 'file_ok': False})
|
||
self.assertNotIn('file', r)
|
||
|
||
def test_search_record_numbers(self):
|
||
# SEARCH RECORD returns 61xx; GET RESPONSE carries the record numbers.
|
||
numbers = bytes(range(3, 21)) # 3..20
|
||
gr = bytes.fromhex('00c00000') + bytes([len(numbers)]) + numbers + bytes.fromhex('9000')
|
||
r = decode_message(gr, prev={'ins': 0xA2, 'ins_name': 'SEARCH RECORD', 'sw1': '61',
|
||
'sel': {'fid': '6f3a'}, 'file_ok': True})
|
||
self.assertEqual(r['file']['record_numbers'], list(range(3, 21)))
|
||
self.assertIn('18 record(s)', r['summary'])
|
||
|
||
def test_select_target_fid(self):
|
||
from simtrace2_pysniff.server.decode import select_target_fid
|
||
self.assertEqual(select_target_fid({'p1': {'raw': '00'}, 'body': {'hex': '6f07'}}), '6f07')
|
||
self.assertEqual(select_target_fid({'p1': {'raw': '08'}, 'body': {'hex': '7fff6f05'}}), '6f05')
|
||
self.assertIsNone(select_target_fid({'p1': {'raw': '04'}, 'body': {'hex': 'a0000000871002'}}))
|
||
self.assertIsNone(select_target_fid({'p1': {'raw': '08'}, 'body': {'hex': '7fff'}}))
|
||
|
||
|
||
class TestSelectionTracking(unittest.TestCase):
|
||
def test_select_then_read(self):
|
||
import tempfile
|
||
from simtrace2_pysniff.server.database import Database
|
||
with tempfile.NamedTemporaryFile(suffix='.db') as tmp:
|
||
db = Database(tmp.name)
|
||
sid = db.create_session('capture')
|
||
db.insert_message(sid, 0.0, 'atr', b'\x3b\x00')
|
||
db.insert_message(sid, 0.1, 'tpdu', bytes.fromhex('a0a40804047fff6f079000'))
|
||
db.insert_message(sid, 0.2, 'tpdu',
|
||
bytes.fromhex('00b0000009') + bytes.fromhex('0f52001132547698f0') + bytes.fromhex('9000'))
|
||
msgs = db.get_messages(sid)
|
||
read = msgs[2]
|
||
self.assertEqual(read['decoded']['file']['imsi'], '250011234567890')
|
||
|
||
def test_atr_resets_selection(self):
|
||
import tempfile
|
||
from simtrace2_pysniff.server.database import Database
|
||
with tempfile.NamedTemporaryFile(suffix='.db') as tmp:
|
||
db = Database(tmp.name)
|
||
sid = db.create_session('capture')
|
||
db.insert_message(sid, 0.0, 'tpdu', bytes.fromhex('a0a40804047fff6f079000'))
|
||
db.insert_message(sid, 0.1, 'atr', b'\x3b\x00')
|
||
db.insert_message(sid, 0.2, 'tpdu',
|
||
bytes.fromhex('00b0000009') + bytes.fromhex('0f52001132547698f0') + bytes.fromhex('9000'))
|
||
msgs = db.get_messages(sid)
|
||
self.assertNotIn('file', msgs[2]['decoded'])
|
||
|
||
def test_failed_select_keeps_selection(self):
|
||
# A SELECT that fails (6A82) must not change the current file.
|
||
import tempfile
|
||
from simtrace2_pysniff.server.database import Database
|
||
with tempfile.NamedTemporaryFile(suffix='.db') as tmp:
|
||
db = Database(tmp.name)
|
||
sid = db.create_session('capture')
|
||
db.insert_message(sid, 0.0, 'tpdu', bytes.fromhex('a0a40804047fff6f079000'))
|
||
db.insert_message(sid, 0.1, 'tpdu', bytes.fromhex('a0a40804047fff6f136a82'))
|
||
db.insert_message(sid, 0.2, 'tpdu',
|
||
bytes.fromhex('00b0000009') + bytes.fromhex('0f52001132547698f0') + bytes.fromhex('9000'))
|
||
msgs = db.get_messages(sid)
|
||
read = msgs[2]
|
||
self.assertEqual(read['decoded']['file']['imsi'], '250011234567890')
|
||
|
||
def test_record_op_on_transparent_is_stale(self):
|
||
# SELECT a transparent EF, then READ RECORD → selection is stale, so
|
||
# we must not decode garbage.
|
||
import tempfile
|
||
from simtrace2_pysniff.server.database import Database
|
||
with tempfile.NamedTemporaryFile(suffix='.db') as tmp:
|
||
db = Database(tmp.name)
|
||
sid = db.create_session('capture')
|
||
db.insert_message(sid, 0.0, 'tpdu', bytes.fromhex('a0a40804047fff6f056123'))
|
||
db.insert_message(sid, 0.1, 'tpdu',
|
||
bytes.fromhex('00c000000a') + bytes.fromhex('62088202012183026f05') + bytes.fromhex('9000'))
|
||
db.insert_message(sid, 0.2, 'tpdu',
|
||
bytes.fromhex('00b2010408') + bytes.fromhex('800101a010a4068301019501') + bytes.fromhex('9000'))
|
||
msgs = db.get_messages(sid)
|
||
read = msgs[2]
|
||
self.assertTrue(read['decoded']['file']['stale'])
|
||
|
||
|
||
if __name__ == '__main__':
|
||
unittest.main()
|