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)
|
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
|
APDU trace analyser for the GSMTAP-SIM format — captures SIM/UICC
|
||||||
communication from a UDP GSMTAP stream (or imports PCAP/PCAPNG files),
|
communication from a UDP GSMTAP stream (or imports PCAP/PCAPNG files),
|
||||||
decodes it, and serves an installable web app for browsing. The repository
|
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
|
`simtrace2-sniff` that captures from Osmocom SIMtrace2 hardware and can feed
|
||||||
GSMTAP into this analyser.
|
GSMTAP into this analyser.
|
||||||
|
|
||||||
📢 Project news and updates: [atroshin.ru](https://atroshin.ru) | [Telegram channel](https://t.me/youeyeseesee)
|
|
||||||
|
|
||||||

|

|
||||||
|
|
||||||
## Prerequisites
|
## 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
|
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)
|
(shorter than the header, the invalid CLA `FF` or an ISO-reserved class)
|
||||||
is skipped and counted (`skipped`) — a character-level or mis-sampled
|
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`.
|
tunable via `--log-interval SECONDS`.
|
||||||
|
|
||||||
The GSMTAP listener also accepts the **sigrok-iso7816-stream** decoder
|
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
|
- Installable **PWA** (progressive web app: installs to the desktop or home
|
||||||
screen and works offline), dark theme, English/Russian UI
|
screen and works offline), dark theme, English/Russian UI
|
||||||
|
|
||||||
## Related
|
## Related tools
|
||||||
|
|
||||||
- **[simtrace2](https://gitea.osmocom.org/sim-card/simtrace2)** — the upstream
|
SIMple, SIMtrace Analyser and sigrok_iso7816_stream are three standalone
|
||||||
SIMtrace2 hardware/firmware project that the capture utility sniffs from.
|
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)** —
|
- **[sigrok_iso7816_stream](https://github.com/anttro/sigrok_iso7816_stream)** —
|
||||||
FX2LP-based passive ISO 7816 sniffer that emits the same GSMTAP-SIM stream
|
a passive ISO 7816 sniffer built on a cheap FX2 logic analyser.
|
||||||
on UDP 4729 (accepted by this project's GSMTAP listener).
|
|
||||||
|
The bundled capture utility also sniffs from the upstream
|
||||||
|
[simtrace2](https://gitea.osmocom.org/sim-card/simtrace2) hardware/firmware
|
||||||
|
project.
|
||||||
|
|
||||||
## License
|
## License
|
||||||
|
|
||||||
|
|||||||
+19
-10
@@ -1,7 +1,9 @@
|
|||||||
# SIMtrace Analyser
|
# SIMtrace Analyser — анализатор APDU-трассировок GSMTAP-SIM
|
||||||
|
|
||||||
[English](README.md) | Русский
|
[English](README.md) | Русский
|
||||||
|
|
||||||
|
📢 Новости и обновления проекта: [сайт](https://atroshin.ru) · [Telegram-канал](https://t.me/youeyeseesee)
|
||||||
|
|
||||||
Анализатор APDU-трассировок в формате GSMTAP-SIM — захватывает обмен с
|
Анализатор APDU-трассировок в формате GSMTAP-SIM — захватывает обмен с
|
||||||
SIM/UICC из UDP-потока GSMTAP (или импортирует файлы PCAP/PCAPNG),
|
SIM/UICC из UDP-потока GSMTAP (или импортирует файлы PCAP/PCAPNG),
|
||||||
декодирует его и отдаёт устанавливаемое веб-приложение для просмотра.
|
декодирует его и отдаёт устанавливаемое веб-приложение для просмотра.
|
||||||
@@ -9,8 +11,6 @@ SIM/UICC из UDP-потока GSMTAP (или импортирует файлы
|
|||||||
на Python, которая захватывает трафик с оборудования Osmocom SIMtrace2
|
на Python, которая захватывает трафик с оборудования Osmocom SIMtrace2
|
||||||
и может передавать GSMTAP этому анализатору.
|
и может передавать 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 (короче заголовка,
|
убивают захват; `tpdu`-пакет, вовсе не похожий на APDU (короче заголовка,
|
||||||
недопустимый CLA `FF` или зарезервированный ISO класс `001x`),
|
недопустимый CLA `FF` или зарезервированный ISO класс `001x`),
|
||||||
пропускается и считается (`skipped`) — посимвольный или миссемплированный
|
пропускается и считается (`skipped`) — посимвольный или миссемплированный
|
||||||
поток больше не засоряет декодирование. Интервал heartbeat по умолчанию
|
поток не засоряет декодирование. Интервал heartbeat по умолчанию
|
||||||
60 с, настраивается через `--log-interval SECONDS`.
|
60 с, настраивается через `--log-interval SECONDS`.
|
||||||
|
|
||||||
GSMTAP-листенер также принимает декодер **sigrok-iso7816-stream**
|
GSMTAP-листенер также принимает декодер **sigrok-iso7816-stream**
|
||||||
@@ -568,14 +568,23 @@ Python 3 должен быть в `PATH` (проверьте `python --version`
|
|||||||
- **PWA** (progressive web app): устанавливается на рабочий стол или домашний
|
- **PWA** (progressive web app): устанавливается на рабочий стол или домашний
|
||||||
экран и работает офлайн; тёмная тема, интерфейс на английском/русском
|
экран и работает офлайн; тёмная тема, интерфейс на английском/русском
|
||||||
|
|
||||||
## Связанные проекты
|
## Связанные инструменты
|
||||||
|
|
||||||
- **[simtrace2](https://gitea.osmocom.org/sim-card/simtrace2)** — вышестоящий
|
SIMple, SIMtrace Analyser и sigrok_iso7816_stream — три автономных
|
||||||
проект оборудования/прошивки SIMtrace2, с которого утилита захвата
|
инструмента для работы с 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)** —
|
- **[sigrok_iso7816_stream](https://github.com/anttro/sigrok_iso7816_stream)** —
|
||||||
пассивный ISO 7816 сниффер на базе FX2LP, выдающий такой же поток
|
пассивный ISO 7816-сниффер на дешёвом логическом анализаторе FX2.
|
||||||
GSMTAP-SIM на UDP 4729 (принимается GSMTAP-листенером этого проекта).
|
|
||||||
|
Встроенная утилита захвата также снимает трафик с вышестоящего проекта
|
||||||
|
оборудования/прошивки [simtrace2](https://gitea.osmocom.org/sim-card/simtrace2).
|
||||||
|
|
||||||
## Лицензия
|
## Лицензия
|
||||||
|
|
||||||
|
|||||||
Reference in new issue
Block a user