diff --git a/README.md b/README.md index f95c8da..d2edccd 100644 --- a/README.md +++ b/README.md @@ -15,17 +15,24 @@ GSMTAP into this analyser. ## Prerequisites -- **Python 3.9+** -- **PyUSB** — `pip install pyusb` (needed only for capture from SIMtrace2 - hardware; GSMTAP/UDP capture and PCAP import work without it) +**Required** + +- **Python 3.9+** — GSMTAP capture, PCAP import and browsing use only the + standard library. + +**Only for capturing from Osmocom SIMtrace2 hardware** (`--capture direct`, and +the bundled `simtrace2-pysniff` capture utility): + +- **PyUSB** — `pip install pyusb` - **libusb** — system library, present by default on Linux; on Windows the SIMtrace2 driver must be swapped (see [USB Device Access](#usb-device-access)) -- **SIMtrace2 hardware** running firmware in *trace* mode (only for direct - capture; VID `1d50`, PID `60e3`, USB class `ff`, subclass `01`). For - building and flashing trace firmware, see the +- **SIMtrace2 hardware** running firmware in *trace* mode (VID `1d50`, PID + `60e3`, USB class `ff`, subclass `01`); building and flashing trace firmware + is described in the [upstream SIMtrace2 project](https://gitea.osmocom.org/sim-card/simtrace2). -No other dependencies. PCAP, GSMTAP, and hex dump output use only Python stdlib. +The analyser needs none of this for `--capture gsmtap` (the GSMTAP source may +even run on another machine), `--capture disabled`, or PCAP imports. ## Quick start diff --git a/README_RUS.md b/README_RUS.md index cb9216a..296814e 100644 --- a/README_RUS.md +++ b/README_RUS.md @@ -15,19 +15,25 @@ SIM/UICC из UDP-потока GSMTAP (или импортирует файлы ## Требования -- **Python 3.9+** -- **PyUSB** — `pip install pyusb` (нужен только для захвата с оборудования - SIMtrace2; захват GSMTAP/UDP и импорт PCAP работают без него) +**Обязательно** + +- **Python 3.9+** — для захвата GSMTAP, импорта PCAP и просмотра достаточно + стандартной библиотеки. + +**Только для захвата с оборудования Osmocom SIMtrace2** (`--capture direct` и +встроенная утилита `simtrace2-pysniff`): + +- **PyUSB** — `pip install pyusb` - **libusb** — системная библиотека, обычно уже есть в Linux; в Windows нужно заменить драйвер SIMtrace2 (см. [Доступ к USB-устройству](#доступ-к-usb-устройству)) -- **Оборудование SIMtrace2** с прошивкой в режиме *trace* (только для - прямого захвата; VID `1d50`, PID `60e3`, USB class `ff`, subclass `01`). - О сборке и прошивке trace-прошивки см. - [проект SIMtrace2](https://gitea.osmocom.org/sim-card/simtrace2). +- **Оборудование SIMtrace2** с прошивкой в режиме *trace* (VID `1d50`, PID + `60e3`, USB class `ff`, subclass `01`); сборка и прошивка trace-прошивки + описаны в + [проекте SIMtrace2](https://gitea.osmocom.org/sim-card/simtrace2). -Других зависимостей нет. Вывод PCAP, GSMTAP и hex dump использует только -стандартную библиотеку Python. +Для `--capture gsmtap` (источник GSMTAP может быть даже на другой машине), +`--capture disabled` и импорта PCAP анализатору ничего из этого не нужно. ## Быстрый старт