README: expand the title, move the news line up, update Related tools
The heading now names the tool and what it analyses instead of just the
product name, and the news/website line sits right under the language switch
so it is visible before the description.
The Related section became "Related tools" with the same family block the
sibling projects use (SIMple, SIMtrace Analyser, sigrok_iso7816_stream on one
website and news channel), and simtrace2 is mentioned as the upstream
hardware/firmware the bundled capture utility sniffs from. One wording tweak:
the capture-liveness paragraph states the current behaviour ("does not
pollute") instead of describing it as a change ("no longer pollutes").
Both languages; docs only, 557 Python + 80 Node tests.
This commit is contained in:
1 parent
5a7768e6a9
commit
9a661f5ab2
2 files changed
+38
-19
No files matched your search
@@ -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)
|
||||
|
||||

|
||||
|
||||
## 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
|
||||
|
||||
|
||||
+19
-10
@@ -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)
|
||||
|
||||

|
||||
|
||||
## Требования
|
||||
@@ -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).
|
||||
|
||||
## Лицензия
|
||||
|
||||
|
||||
Reference in new issue
Block a user