README: mark the SIMtrace2 USB prerequisites as conditional
The prerequisites read as if PyUSB, libusb and SIMtrace2 hardware were needed generally. They are only for `--capture direct` (and the bundled `simtrace2-pysniff` utility): the analyser starts and captures GSMTAP with just Python 3.9+ - verified in a fresh venv without PyUSB, where the server served the PWA and a GSMTAP ATR+APDU landed in the session (2 messages). Both READMEs split the list into "Required" (Python 3.9+) and "Only for capturing from Osmocom SIMtrace2 hardware", and state that GSMTAP capture (the source may even run on another machine), --capture disabled and PCAP imports need none of it. No code change; 557 Python + 80 Node tests.
This commit is contained in:
1 parent
a863f66860
commit
9872913965
2 files changed
+29
-16
No files matched your search
@@ -15,17 +15,24 @@ GSMTAP into this analyser.
|
|||||||
|
|
||||||
## Prerequisites
|
## Prerequisites
|
||||||
|
|
||||||
- **Python 3.9+**
|
**Required**
|
||||||
- **PyUSB** — `pip install pyusb` (needed only for capture from SIMtrace2
|
|
||||||
hardware; GSMTAP/UDP capture and PCAP import work without it)
|
- **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
|
- **libusb** — system library, present by default on Linux; on Windows the
|
||||||
SIMtrace2 driver must be swapped (see [USB Device Access](#usb-device-access))
|
SIMtrace2 driver must be swapped (see [USB Device Access](#usb-device-access))
|
||||||
- **SIMtrace2 hardware** running firmware in *trace* mode (only for direct
|
- **SIMtrace2 hardware** running firmware in *trace* mode (VID `1d50`, PID
|
||||||
capture; VID `1d50`, PID `60e3`, USB class `ff`, subclass `01`). For
|
`60e3`, USB class `ff`, subclass `01`); building and flashing trace firmware
|
||||||
building and flashing trace firmware, see the
|
is described in the
|
||||||
[upstream SIMtrace2 project](https://gitea.osmocom.org/sim-card/simtrace2).
|
[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
|
## Quick start
|
||||||
|
|
||||||
|
|||||||
+15
-9
@@ -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
|
- **libusb** — системная библиотека, обычно уже есть в Linux; в Windows
|
||||||
нужно заменить драйвер SIMtrace2
|
нужно заменить драйвер SIMtrace2
|
||||||
(см. [Доступ к USB-устройству](#доступ-к-usb-устройству))
|
(см. [Доступ к USB-устройству](#доступ-к-usb-устройству))
|
||||||
- **Оборудование SIMtrace2** с прошивкой в режиме *trace* (только для
|
- **Оборудование SIMtrace2** с прошивкой в режиме *trace* (VID `1d50`, PID
|
||||||
прямого захвата; VID `1d50`, PID `60e3`, USB class `ff`, subclass `01`).
|
`60e3`, USB class `ff`, subclass `01`); сборка и прошивка trace-прошивки
|
||||||
О сборке и прошивке trace-прошивки см.
|
описаны в
|
||||||
[проект SIMtrace2](https://gitea.osmocom.org/sim-card/simtrace2).
|
[проекте SIMtrace2](https://gitea.osmocom.org/sim-card/simtrace2).
|
||||||
|
|
||||||
Других зависимостей нет. Вывод PCAP, GSMTAP и hex dump использует только
|
Для `--capture gsmtap` (источник GSMTAP может быть даже на другой машине),
|
||||||
стандартную библиотеку Python.
|
`--capture disabled` и импорта PCAP анализатору ничего из этого не нужно.
|
||||||
|
|
||||||
## Быстрый старт
|
## Быстрый старт
|
||||||
|
|
||||||
|
|||||||
Reference in new issue
Block a user