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:
catarrh committed 2026-10-27 10:49:45 +03:00
1 parent a863f66860
commit 9872913965
2 files changed
+29 -16

No files matched your search

+15 -9
View File
@@ -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 анализатору ничего из этого не нужно.
## Быстрый старт