Files
simtrace-analyser/simtrace2_pysniff/server/capture.py
T
catarrh 7eaf7e9b53 Decode sigrok-iso7816-stream RST/VCC line events (GSMTAP 0x10/0x11)
Support the sigrok-iso7816-stream decoder (FX2 logic-analyzer passive
SIM sniffer, github.com/anttro/sigrok_iso7816_stream) which streams
GSMTAP-SIM on UDP 4729 and adds two custom sub-types for line events.

- gsmtap.py: GSMTAP_SIM_RST_EVENT (0x10) / GSMTAP_SIM_VCC_EVENT (0x11).
- capture.py: gsmtap_msg_type() maps 0x10→'rst', 0x11→'vcc' (shared by
  the listener and tests); pcap.py _SUB_TYPE_NAMES gains the same
  entries so PCAP re-imports of these captures preserve the events.
- decode.py: decode_line_event() decodes [direction, level, reserved]
  into reset asserted/de-asserted or power applied/removed + level;
  routed through decode_sniff_msg.
- database.py: reset-assert and power-removal invalidate the per-channel
  file selection (card-level transition); de-assert / power-on are
  markers only.
- frontend: RST/VCC labels (RESET ASSERTED / VCC OFF, …), a detail-view
  branch (Event + Level + raw), and list styling (.apdu-type.rst/.vcc).

README notes the custom sub-type compatibility. Tests: +8 (line-event
vectors, sniff routing, subtype + PCAP round-trip mappings) — 359
total. Version 1.21.0, SW cache simtrace-analyser-v31.
2026-08-26 17:29:36 +03:00

147 lines
4.0 KiB
Python

"""Capture backends: GSMTAP listener and direct SIMtrace2 sniffer."""
import time
import threading
from ..gsmtap import (GsmtapReceiver, GSMTAP_SIM_ATR,
GSMTAP_SIM_RST_EVENT, GSMTAP_SIM_VCC_EVENT)
def gsmtap_msg_type(sub_type):
"""Map a GSMTAP-SIM sub_type to a stored message type.
Custom sigrok-iso7816-stream line events (0x10/0x11) become 'rst'/'vcc';
everything except ATR defaults to 'tpdu'.
"""
return {
GSMTAP_SIM_ATR: 'atr',
GSMTAP_SIM_RST_EVENT: 'rst',
GSMTAP_SIM_VCC_EVENT: 'vcc',
}.get(sub_type, 'tpdu')
class GsmtapListener:
def __init__(self, bind_port=4729):
self._receiver = GsmtapReceiver(bind_port=bind_port)
self._running = False
def start(self):
self._running = True
def stop(self):
self._running = False
self._receiver.close()
def iter_messages(self):
while self._running:
sub_type, data = self._receiver.read_packet()
if sub_type is None:
continue
yield gsmtap_msg_type(sub_type), data, 0
class DirectSniffer:
def __init__(self):
from ..device import SniffSession
self._session = SniffSession(
reconnect=True,
reconnect_delay_min=1.0,
reconnect_delay_max=10.0,
inactivity_timeout=0.0,
)
self._running = False
@property
def connected(self):
"""True while the USB sniffer device is open."""
return self._session.connected
def start(self):
self._running = True
def stop(self):
self._running = False
self._session.close()
def iter_messages(self):
from ..device import DeviceDisconnected
try:
for msg in self._session.iter_messages():
if not self._running:
break
yield msg.type, msg.data, msg.flags
except DeviceDisconnected:
return
class CaptureManager:
def __init__(self, backend, db):
self._backend = backend
self._db = db
self._session_id = None
self._thread = None
self._start_time = 0.0
self._latest_msg_id = 0
@property
def active(self):
return self._session_id is not None
@property
def session_id(self):
return self._session_id
@property
def start_time(self):
return self._start_time
@property
def latest_msg_id(self):
return self._latest_msg_id
@property
def device_connected(self):
"""True while the capture device is connected, or None when the
backend has no device concept (gsmtap)."""
if isinstance(self._backend, DirectSniffer):
return self._backend.connected
return None
def start_session(self):
if self._session_id is not None:
self.stop_session()
mode = 'gsmtap' if isinstance(self._backend, GsmtapListener) else 'direct'
self._session_id = self._db.create_session(mode)
self._start_time = time.monotonic()
self._latest_msg_id = 0
self._backend.start()
self._thread = threading.Thread(target=self._capture_loop, daemon=True)
self._thread.start()
return self._session_id
def stop_session(self):
if self._session_id is None:
return None
self._backend.stop()
if self._thread is not None:
self._thread.join(timeout=2.0)
sid = self._session_id
self._session_id = None
self._start_time = 0.0
if self._db.count_messages(sid) == 0:
self._db.delete_session(sid)
return None
self._db.close_session(sid)
return sid
def _capture_loop(self):
for msg_type, data, flags in self._backend.iter_messages():
if self._session_id is None:
break
elapsed = round(time.monotonic() - self._start_time, 3)
mid = self._db.insert_message(self._session_id, elapsed, msg_type, data, flags)
self._latest_msg_id = mid