diff --git a/README.md b/README.md index 61f4114..9930d48 100644 --- a/README.md +++ b/README.md @@ -1,7 +1,9 @@ -# SIMtrace Analyser +# SIMtrace Analyser — an APDU trace analyser for GSMTAP-SIM captures English | [Русский](README_RUS.md) +📢 Project news and updates: [website](https://atroshin.ru) · [Telegram channel](https://t.me/youeyeseesee) + APDU trace analyser for the GSMTAP-SIM format — captures SIM/UICC communication from a UDP GSMTAP stream (or imports PCAP/PCAPNG files), decodes it, and serves an installable web app for browsing. The repository @@ -9,8 +11,6 @@ also bundles **simtrace2-pysniff**, a Python replacement for `simtrace2-sniff` that captures from Osmocom SIMtrace2 hardware and can feed GSMTAP into this analyser. -📢 Project news and updates: [atroshin.ru](https://atroshin.ru) | [Telegram channel](https://t.me/youeyeseesee) - ![SIMtrace Analyser UI](frontend.png) ## Prerequisites @@ -171,7 +171,7 @@ datagram is dropped and counted (`dropped`) rather than silently killing the capture; a `tpdu` packet that is not APDU-shaped at all (shorter than the header, the invalid CLA `FF` or an ISO-reserved class) is skipped and counted (`skipped`) — a character-level or mis-sampled -stream no longer pollutes the decode. The heartbeat interval defaults to 60 s and is +stream does not pollute the decode. The heartbeat interval defaults to 60 s and is tunable via `--log-interval SECONDS`. The GSMTAP listener also accepts the **sigrok-iso7816-stream** decoder @@ -553,13 +553,23 @@ prompt). - Installable **PWA** (progressive web app: installs to the desktop or home screen and works offline), dark theme, English/Russian UI -## Related +## Related tools -- **[simtrace2](https://gitea.osmocom.org/sim-card/simtrace2)** — the upstream - SIMtrace2 hardware/firmware project that the capture utility sniffs from. +SIMple, SIMtrace Analyser and sigrok_iso7816_stream are three standalone +tools for working with SIM/UICC cards, published together on the same +[website](https://atroshin.ru) and [news channel](https://t.me/youeyeseesee). +Each one is fully independent — install only the tools you need: + +- **[SIMple](https://github.com/anttro/simple)** — a UICC workbench: APDU + construction, SCP80/SCP81 OTA, SIM Toolkit simulation and card profiling. +- **[SIMtrace Analyser](https://github.com/anttro/simtrace-analyser)** — an + APDU trace analyser for GSMTAP-SIM captures. - **[sigrok_iso7816_stream](https://github.com/anttro/sigrok_iso7816_stream)** — - FX2LP-based passive ISO 7816 sniffer that emits the same GSMTAP-SIM stream - on UDP 4729 (accepted by this project's GSMTAP listener). + a passive ISO 7816 sniffer built on a cheap FX2 logic analyser. + +The bundled capture utility also sniffs from the upstream +[simtrace2](https://gitea.osmocom.org/sim-card/simtrace2) hardware/firmware +project. ## License diff --git a/README_RUS.md b/README_RUS.md index a861494..9eb4082 100644 --- a/README_RUS.md +++ b/README_RUS.md @@ -1,7 +1,9 @@ -# SIMtrace Analyser +# SIMtrace Analyser — анализатор APDU-трассировок GSMTAP-SIM [English](README.md) | Русский +📢 Новости и обновления проекта: [сайт](https://atroshin.ru) · [Telegram-канал](https://t.me/youeyeseesee) + Анализатор APDU-трассировок в формате GSMTAP-SIM — захватывает обмен с SIM/UICC из UDP-потока GSMTAP (или импортирует файлы PCAP/PCAPNG), декодирует его и отдаёт устанавливаемое веб-приложение для просмотра. @@ -9,8 +11,6 @@ SIM/UICC из UDP-потока GSMTAP (или импортирует файлы на Python, которая захватывает трафик с оборудования Osmocom SIMtrace2 и может передавать GSMTAP этому анализатору. -📢 Новости и обновления проекта: [atroshin.ru](https://atroshin.ru) | [Telegram-канал](https://t.me/youeyeseesee) - ![Интерфейс SIMtrace Analyser](frontend.png) ## Требования @@ -174,7 +174,7 @@ heartbeat `Capture alive: session=N messages=M bytes=B dropped=D skipped=S` убивают захват; `tpdu`-пакет, вовсе не похожий на APDU (короче заголовка, недопустимый CLA `FF` или зарезервированный ISO класс `001x`), пропускается и считается (`skipped`) — посимвольный или миссемплированный -поток больше не засоряет декодирование. Интервал heartbeat по умолчанию +поток не засоряет декодирование. Интервал heartbeat по умолчанию 60 с, настраивается через `--log-interval SECONDS`. GSMTAP-листенер также принимает декодер **sigrok-iso7816-stream** @@ -568,14 +568,23 @@ Python 3 должен быть в `PATH` (проверьте `python --version` - **PWA** (progressive web app): устанавливается на рабочий стол или домашний экран и работает офлайн; тёмная тема, интерфейс на английском/русском -## Связанные проекты +## Связанные инструменты -- **[simtrace2](https://gitea.osmocom.org/sim-card/simtrace2)** — вышестоящий - проект оборудования/прошивки SIMtrace2, с которого утилита захвата - снимает трафик. +SIMple, SIMtrace Analyser и sigrok_iso7816_stream — три автономных +инструмента для работы с SIM/UICC-картами, представленные на одном +[сайте](https://atroshin.ru) и в одном [Telegram-канале](https://t.me/youeyeseesee). +Каждый полностью независим — устанавливайте только нужные вам: + +- **[SIMple](https://github.com/anttro/simple)** — мастерская для UICC/SIM: + конструкторы APDU, OTA SCP80/SCP81, симуляция SIM Toolkit и профилирование + карт. +- **[SIMtrace Analyser](https://github.com/anttro/simtrace-analyser)** — + анализатор APDU-трассировок GSMTAP-SIM. - **[sigrok_iso7816_stream](https://github.com/anttro/sigrok_iso7816_stream)** — - пассивный ISO 7816 сниффер на базе FX2LP, выдающий такой же поток - GSMTAP-SIM на UDP 4729 (принимается GSMTAP-листенером этого проекта). + пассивный ISO 7816-сниффер на дешёвом логическом анализаторе FX2. + +Встроенная утилита захвата также снимает трафик с вышестоящего проекта +оборудования/прошивки [simtrace2](https://gitea.osmocom.org/sim-card/simtrace2). ## Лицензия