From 50dba20f04012b38d7a4a6098b0fb51ad9f711e6 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=D0=90=D0=BD=D1=82=D0=BE=D0=BD=20=D0=A2=D1=80=D0=BE=D1=88?= =?UTF-8?q?=D0=B8=D0=BD?= Date: Wed, 28 Oct 2026 12:36:38 +0300 Subject: [PATCH] README: add SIMple as a GSMTAP-SIM source to the diagram SIMple can stream its own ISO 7816 APDUs as GSMTAP-SIM packets (its --gsmtap option), so it belongs beside the sniffers and the sigrok decoder. The diagrams get a compact SIMple block between the SIMtrace2 sniffers and the sigrok_iso7816_stream boxes (they do not move): title SIMple, subtitle "APDU -> GSMTAP", and its own arrow into the UDP :4729 listener. It is deliberately smaller than the primary sniffers, matching its role as a secondary source. The README alt text and the gsmtap capture-mode bullet/comment now list SIMple as a source too (linked to its repository in the bullet). Both languages; 558 Python + 80 Node tests; runtime zip rebuilt with the updated diagrams. --- README.md | 10 +++++----- README_RUS.md | 10 +++++----- architecture_en.svg | 8 +++++++- architecture_ru.svg | 8 +++++++- 4 files changed, 24 insertions(+), 12 deletions(-) diff --git a/README.md b/README.md index dee4d89..12fc264 100644 --- a/README.md +++ b/README.md @@ -13,7 +13,7 @@ GSMTAP into this analyser. ![SIMtrace Analyser UI](frontend.png) -![Capture and analysis: SIMtrace2 hardware is read by simtrace2-pysniff or the original simtrace2-sniff, and FX2 hardware by the sigrok_iso7816_stream decoder; the sniffers and the decoder stream GSMTAP-SIM to the UDP :4729 listener. The server can also read SIMtrace2 hardware directly over USB with the bundled pysniff code in-process, and imports PCAP/COMPRION traces from files. simtrace-analyser-server decodes and stores the traffic in SQLite and serves the web UI](architecture_en.svg) +![Capture and analysis: SIMtrace2 hardware is read by simtrace2-pysniff or the original simtrace2-sniff, and FX2 hardware by the sigrok_iso7816_stream decoder; the sniffers, the decoder and SIMple stream GSMTAP-SIM to the UDP :4729 listener. The server can also read SIMtrace2 hardware directly over USB with the bundled pysniff code in-process, and imports PCAP/COMPRION traces from files. simtrace-analyser-server decodes and stores the traffic in SQLite and serves the web UI](architecture_en.svg) ## Prerequisites @@ -115,8 +115,8 @@ simtrace-analyser-server --capture gsmtap Open **http://127.0.0.1:8081/** in a browser. `Ctrl+C` stops the server. - `--capture gsmtap` (default) — listen for GSMTAP-SIM on UDP 4729, e.g. from - `simtrace2-pysniff`, the original `simtrace2-sniff` or - `sigrok_iso7816_stream`; + `simtrace2-pysniff`, the original `simtrace2-sniff`, + `sigrok_iso7816_stream` or [SIMple](https://github.com/anttro/simple); - `--capture direct` — read SIMtrace2 hardware directly (the bundled sniffer code runs inside the server and talks to the device over USB; needs PyUSB; Windows also needs the driver swap, see [USB Device Access](#usb-device-access)); @@ -135,8 +135,8 @@ bundled into the package on install) on the same origin. Three capture modes: ```sh -# Listen for GSMTAP from simtrace2-pysniff, the original simtrace2-sniff or -# sigrok_iso7816_stream: +# Listen for GSMTAP from simtrace2-pysniff, the original simtrace2-sniff, +# sigrok_iso7816_stream or SIMple: simtrace-analyser-server --capture gsmtap # Capture directly from SIMtrace2 hardware (the bundled sniffer code reads the diff --git a/README_RUS.md b/README_RUS.md index 61b7d89..ee7d425 100644 --- a/README_RUS.md +++ b/README_RUS.md @@ -13,7 +13,7 @@ SIM/UICC из UDP-потока GSMTAP (или импортирует файлы ![Интерфейс SIMtrace Analyser](frontend.png) -![Захват и анализ: оборудование SIMtrace2 читает simtrace2-pysniff или оригинальный simtrace2-sniff, а оборудование FX2 — декодер sigrok_iso7816_stream; оба источника передают GSMTAP-SIM слушателю UDP :4729. Сервер также может читать оборудование SIMtrace2 напрямую по USB встроенным кодом pysniff внутри сервера и импортирует трассы PCAP/COMPRION из файлов. simtrace-analyser-server декодирует и сохраняет трафик в SQLite и раздаёт веб-интерфейс](architecture_ru.svg) +![Захват и анализ: оборудование SIMtrace2 читает simtrace2-pysniff или оригинальный simtrace2-sniff, а оборудование FX2 — декодер sigrok_iso7816_stream; они и SIMple передают GSMTAP-SIM слушателю UDP :4729. Сервер также может читать оборудование SIMtrace2 напрямую по USB встроенным кодом pysniff внутри сервера и импортирует трассы PCAP/COMPRION из файлов. simtrace-analyser-server декодирует и сохраняет трафик в SQLite и раздаёт веб-интерфейс](architecture_ru.svg) ## Требования @@ -117,8 +117,8 @@ simtrace-analyser-server --capture gsmtap сервер. - `--capture gsmtap` (по умолчанию) — слушать GSMTAP-SIM на UDP 4729, - например от `simtrace2-pysniff`, оригинального `simtrace2-sniff` или - `sigrok_iso7816_stream`; + например от `simtrace2-pysniff`, оригинального `simtrace2-sniff`, + `sigrok_iso7816_stream` или [SIMple](https://github.com/anttro/simple); - `--capture direct` — читать оборудование SIMtrace2 напрямую (встроенный код сниффера работает внутри сервера и обращается к устройству по USB; нужен PyUSB; в Windows также нужна замена драйвера, см. @@ -138,8 +138,8 @@ simtrace-analyser-server --capture gsmtap Три режима захвата: ```sh -# Слушать GSMTAP от simtrace2-pysniff, оригинального simtrace2-sniff -# или sigrok_iso7816_stream: +# Слушать GSMTAP от simtrace2-pysniff, оригинального simtrace2-sniff, +# sigrok_iso7816_stream или SIMple: simtrace-analyser-server --capture gsmtap # Захват напрямую с оборудования SIMtrace2 (встроенный код сниффера читает diff --git a/architecture_en.svg b/architecture_en.svg index 2338fbf..b1100e5 100644 --- a/architecture_en.svg +++ b/architecture_en.svg @@ -1,7 +1,7 @@ SIMtrace Analyser: capture and analysis - SIMtrace2 hardware is read by simtrace2-pysniff (bundled) or the original simtrace2-sniff, and FX2 hardware by the sigrok_iso7816_stream decoder; the sniffers and the decoder stream GSMTAP-SIM to the listener on UDP :4729. The server can also read SIMtrace2 hardware directly over USB with the bundled sniffer code, and imports PCAP/COMPRION traces from files. simtrace-analyser-server decodes and stores the traffic in SQLite and serves the web UI. + SIMtrace2 hardware is read by simtrace2-pysniff (bundled) or the original simtrace2-sniff, and FX2 hardware by the sigrok_iso7816_stream decoder; the sniffers, the decoder and SIMple stream GSMTAP-SIM to the listener on UDP :4729. The server can also read SIMtrace2 hardware directly over USB with the bundled sniffer code, and imports PCAP/COMPRION traces from files. simtrace-analyser-server decodes and stores the traffic in SQLite and serves the web UI. @@ -32,7 +32,13 @@ sigrok_iso7816_stream decoder + + + SIMple + APDU → GSMTAP + + diff --git a/architecture_ru.svg b/architecture_ru.svg index 57750c0..5df0bb9 100644 --- a/architecture_ru.svg +++ b/architecture_ru.svg @@ -1,7 +1,7 @@ SIMtrace Analyser: захват и анализ - Оборудование SIMtrace2 читает simtrace2-pysniff (входит в комплект) или оригинальный simtrace2-sniff, а оборудование FX2 — декодер sigrok_iso7816_stream; оба источника передают GSMTAP-SIM слушателю UDP :4729. Сервер также может читать оборудование SIMtrace2 напрямую по USB встроенным кодом сниффера и импортирует трассы PCAP/COMPRION из файлов. simtrace-analyser-server декодирует и сохраняет трафик в SQLite и раздаёт веб-интерфейс. + Оборудование SIMtrace2 читает simtrace2-pysniff (входит в комплект) или оригинальный simtrace2-sniff, а оборудование FX2 — декодер sigrok_iso7816_stream; они и SIMple передают GSMTAP-SIM слушателю UDP :4729. Сервер также может читать оборудование SIMtrace2 напрямую по USB встроенным кодом сниффера и импортирует трассы PCAP/COMPRION из файлов. simtrace-analyser-server декодирует и сохраняет трафик в SQLite и раздаёт веб-интерфейс. @@ -32,7 +32,13 @@ sigrok_iso7816_stream декодер + + + SIMple + APDU → GSMTAP + +