Add README_RUS.md: Russian translation of the README

Full translation following the otaman README_RUS.md convention (prose and code-block comments translated; commands, flags and paths unchanged). Links back to the English README at the top.
2026-09-11 20:39:31 +03:00
1 parent 823bd25f31
commit c222eecb3c
@@ -0,0 +1,535 @@
 > English version: [README.md](README.md)
 # sigrok_iso7816_stream
 Форк [svenso/sigrok_iso7816](https://github.com/svenso/sigrok_iso7816) с
 **живым GSMTAP-UDP-стримингом**: дешёвый логический анализатор FX2 (клон
 Saleae) ведёт себя как сниффер SIMtrace2:
 ```
 SIM-карта ⇄ ридер (пассивный съём с контактов)
    → логический анализатор FX2 (fx2lafw, 8 каналов, до 24 МГц)
    → sigrok-cli + декодер iso7816
    → GSMTAP UDP :4729  →  [simtrace2-pysniff](https://github.com/anttro/simtrace2-pysniff) / Wireshark
 ```
 [simtrace2-pysniff](https://github.com/anttro/simtrace2-pysniff) —
 рекомендуемый инструмент для визуализации живых трасс и просмотра
 сохранённых записей; он также умеет импортировать и экспортировать
 GSMTAP pcap-файлы (включая PCAP, который этот декодер пишет через опцию
 `pcap_file=<path>`).
 ## Съём на практике
 ![Компоненты](resources/components.jpg)
 *Компоненты, использованные в сборке*
 ![В работе с телефоном](resources/in_action_phone.jpg)
 *Стенд снимает сессию SIM-карты телефона*
 ![В работе](resources/in_action.jpg)
 *Стенд снимает сессию картридера*
 ![Переходник для SIM](resources/sim_adapter.jpg)
 *Переходник для съёма с SIM*
 ![Распиновка переходника](resources/sim_adapter_pinout.jpg)
 *Подключение к контактам SIM*
 ![Короткий кабель](resources/short_cable.jpg)
 *Съём коротким кабелем — меньше площадь контура и артефактов фронта*
 ![Подключение короткого кабеля](resources/short_cable_wiring.jpg)
 *Детали подключения короткого кабеля*
 ![Обвязка короткого кабеля](resources/short_cable_gear.jpg)
 *Короткий кабель с обвязкой*
 ![Подтягивающие резисторы](resources/short_cable_pull_resistors.jpg)
 *Короткий кабель с внешними подтягивающими резисторами — 10 кОм к GND на VCC (тянет вниз, когда питания нет), 47 кОм к VCC на DATA (быстрее фронт вверх)*
 ## Что добавлено поверх upstream
 | Возможность | Описание |
 |---------|-------------|
 | Живой поток GSMTAP | Каждое декодированное событие отправляется как GSMTAP-SIM UDP-пакет (включено по умолчанию, повторяет поведение simtrace2-sniff) |
 | Правильные sub_types | ATR=0x01 и PPS=0x02 теперь корректно помечаются в PCAP (в upstream всё писалось как APDU=0x00) |
 | ATR/PPS в PCAP | ATR и объединённые запрос+ответ PPS выводятся как PCAP-пакеты |
 | Отслеживание RST (опционально) | `rst_detect=true`: события assert/deassert сброса (sub_type 0x10) |
 | Отслеживание VCC (опционально) | `vcc_detect=true`: события включения/выключения питания (sub_type 0x11) |
 | PCAP сразу в файл | `pcap_file=<path>` пишет PCAP без перенаправления вывода оболочки |
 | Деглитч стартового бита | Деглитч в 2 отсчёта в детекторе стартового бита убирает LOW-глитчи короче ETU от артефактов подтяжки FX2LP и предотвращает смещение байтов на быстрых телефонных трассах |
 ## Опции декодера
 | Опция | По умолчанию | Описание |
 |--------|---------|-------------|
 | `clock_option` | `native` | `native`, `detect`, `sample_as_clock` (см. FAQ upstream) |
 | `protocol` | `auto` | `auto`, `T=0`, `T=1` |
 | `gsmtap_enable` | `true` | Живой GSMTAP UDP-стриминг |
 | `gsmtap_host` | `127.0.0.1` | Хост назначения GSMTAP |
 | `gsmtap_port` | `4729` | Порт назначения GSMTAP |
 | `pcap_file` | *(пусто)* | Писать PCAP в этот файл вдобавок к бинарному выводу |
 | `rst_detect` | `false` | Отслеживать события пина RST (требуется назначенный канал `rst`) |
 | `vcc_detect` | `false` | Отслеживать события пина VCC (требуется назначенный канал `vcc`) |
 Каналы: `clk`, `data` (обязательные); `rst`, `vcc` (опциональные —
 назначайте только если соответствующий провод физически подключён).
 ## События GSMTAP
 Заголовок GSMTAP: версия 2, тип SIM (0x04), UDP-порт 4729.
 | sub_type | Имя | Полезная нагрузка |
 |----------|------|---------|
 | 0x00 | APDU | сырые байты пакета T=0/T=1 |
 | 0x01 | ATR | сырые байты ATR |
 | 0x02 | PPS | запрос + ответ PPS, склеенные (отклонение от спеки, см. ниже) |
 | 0x10 | Событие RST (кастомное) | `[direction, level, 0x00]` |
 | 0x11 | Событие VCC (кастомное) | `[direction, level, 0x00]` |
 Семантика байтов полезной нагрузки:
 - RST: `direction` 1 = сброс asserted (высокий→низкий), 0 = deasserted (низкий→высокий);
  `level` = уровень линии после перехода.
 - VCC: `direction` 1 = питание подано (низкий→высокий), 0 = снято (высокий→низкий);
  `level` = уровень линии после перехода.
 0x00/0x01 совпадают с gsmtap.h из libosmocore: стандартные значения и
 полезные нагрузки. 0x02 переиспользует значение `GSMTAP_SIM_PPS_REQ` из
 спеки, но несёт запрос и ответ, склеенные в одном пакете; спека разделяет
 PPS на `PPS_REQ` (0x02) / `PPS_RSP` (0x03), поэтому Wireshark разбирает
 такие пакеты как «PPS request», а `PPS_RSP` (0x03) не отправляется
 никогда. 0x10/0x11 — кастомные расширения, не определённые в gsmtap.h из
 libosmocore.
 Расширения заголовка: флаги вроде `GSMTAP_FLAG_BAD_FCS` пишутся в байт
 `res` заголовка, который официальный gsmtap.h помечает как зарезервированный
 (RFU) — такое использование флагов следует конвенции simtrace2-sniff и не
 является частью спецификации libosmocore.
 ## Использование
 Быстрый старт после клонирования (см. «Установка» ниже):
 ```bash
 ./setup.sh   # проверить sigrok-cli, зарегистрировать симлинк декодера
 ./start.sh   # запись + поток GSMTAP на 127.0.0.1:4729
 ```
 Умолчания `start.sh`: выводы D5=CLK, D0=I/O, D4=RST, D2=VCC, частота
 дискретизации 16 МГц. Переопределяются аргументами:
 ```bash
 ./start.sh --clk=D1 --data=D6          # другое подключение
 ./start.sh --no-rst --no-vcc           # только CLK+I/O
 ./start.sh --host=10.0.28.7            # стримить на удалённый анализатор
 ./start.sh --pcap=session.pcap         # также записать декодированные события в PCAP
 ./start.sh --debug                     # полный вывод декодера и sigrok (все
                                       # строки аннотаций + libsigrok -l 4);
                                       # по умолчанию показываются только
                                       # декодированные APDU и предупреждения/ошибки
 ```
 ### Подключение
 Рекомендуемый способ съёма — короткий кабель с внешними подтягивающими
 резисторами (см. фото выше): 10 кОм к GND на VCC (тянет вниз без питания)
 и 47 кОм к VCC на DATA (быстрее фронт вверх).  Его распиновка **фиксирована
 и известна заранее** — см. таблицу «Распиновка» ниже — и в точности
 совпадает с умолчаниями `start.sh` (`D5`=CLK, `D0`=I/O, `D4`=RST,
 `D2`=VCC).  Автодетект подключения не нужен; выводы не меняются.
 > **Сначала GND.** Сначала подключите GND и проверьте его вручную
 > (мультиметром или заведомо исправным контактом) — отсутствующий или
 > плохой контакт земли маскируется под все остальные неисправности сразу:
 > плавающие линии, фантомные стартовые биты, кадры из одних нулей.
 ### Устойчивость к шумным сигналам
 Живые записи могут глитчить (фантомный стартовый бит при включении питания
 раньше сдвигал весь разбор ATR на единицу). Теперь декодер:
 - проверяет байт TS в ATR (`0x3B`/`0x3F` по TS 102 221 §5.2.2) и
  ресинхронизируется на следующем настоящем спаде, если он неверен;
 - никогда не даёт исключению при декодировании убить запись — ошибки
  логируются, аннотируются, а конечный автомат ресинхронизируется
  (конец потока по-прежнему завершается чисто);
 - ограничивает продолжение цепочки T=1-блоков, чтобы мусор не мог
  зациклиться навсегда.
 После принятого PPS декодер **следует переключению скорости**: в режиме
 native CLK `clock_skip` становится равным F/D тактов CLK на бит (например,
 512/16 = 32), что соответствует новой скорости UART у обеих сторон.  Живая
 запись подтвердила, что сохранение 372 после PPS алиасит весь последующий
 трафик.
 **Тёплый сброс** (ридер заново подаёт RST примерно каждые ~1.6 с) заставляет
 карту ответить свежим ATR на стандартных 372 тактах/бит.  Декодер
 **заново взводит охоту за ATR по deassert RST**: состояние возвращается в
 `FIND START`, native-пропуск сбрасывается в 372, счётчик охоты очищается —
 поэтому повторный ATR разбирается как ATR, а не ошибочно читается как
 TPDU-трафик на скорости, согласованной PPS.  **Защита стартового бита в
 1.5 ETU** дополнительно отбрасывает фантомный `0x00`, который глитч на
 холостом ходу может вставить перед этим ATR.  Требуется `rst_detect=true`
 (назначенный канал `rst`); без него сброс в середине сессии всё равно
 будет прочитан неверно.
 ### Решение проблем при живой записи
 `start.sh` запускает одну `--continuous` запись, пока вы не нажмёте
 **Ctrl+C** (`rc=130`).  stdin отвязан от sigrok-cli, поэтому нажатия
 клавиш/Enter в терминале **не** останавливают запись (приглашение sigrok
 «нажмите любую клавишу для остановки» отключено) — раньше это нажатие
 ошибочно трактовалось как «преждевременный обрыв», хотя никакой
 неисправности устройства не было.
 Большая часть раннего «шума» в записях (ошибки чётности, мусор из-за
 неверного кадрирования, дребезг линии VCC) была следствием плохо
 декодированного конечного автомата, а не железа: переподключение съёма
 ничего не давало, а переписанный декодер полностью это вылечил (re-arm по
 тёплому сбросу, защита стартового бита 1.5 ETU, антидребезг VCC 10 мс,
 сборка обмена T=0).  Чистая запись теперь декодируется с нулём мусора —
 см. проверку `vs_reader.py` ниже.
 Если запись *всё-таки* завершается сама (`rc=0`), устройство действительно
 перестало стримить; обычный подозреваемый — потолок пропускной способности
 USB у FX2 при длительной высокой частоте дискретизации.
 ```bash
 ./start.sh --pcap=s.pcap --log=s.log           # также записать события и лог rc=
 ./start.sh ... --samplerate=24M                # больше запаса по таймингу при необходимости
 ./start.sh ... --klog                          # также записать журнал ядра
 ./start.sh ... --debug                         # полный вывод: все строки аннотаций
                                               # + внутренности libsigrok на -l 4
                                               # (по умолчанию: только APDU + предупреждения)
 ```
 `start.sh` пишет непрерывный поток на настроенной частоте (по умолчанию
 16 МГц) до Ctrl+C (`rc=130`).  Здоровая запись никогда не завершается
 сама; если FX2 роняет USB-передачу в середине сессии (нестабильное
 устройство, `rc=0` «device stopped streaming»), запись автоматически
 перезапускается, чтобы не потерять сессию — она перезапускается при каждом
 `rc=0`, пока вы не нажмёте Ctrl+C или не сработает `--max-restarts=N`
 (по умолчанию 20; `0` = без ограничения), с паузой `--restart-delay=S`
 (по умолчанию 2 с).  При перезапуске с `--pcap=FILE` запись каждой сессии
 пишется в `FILE.<N>.<ext>`, поэтому перезапуск никогда не перезаписывает
 предыдущую, а повторяющаяся строка завершения
 `sr_session_stop: session was NULL` фильтруется из stderr.
 - `--no-loop` отключает авто-перезапуск (только одна запись).
 - `--loop` принудительно включает авто-перезапуск (это поведение по умолчанию).
 - `--max-restarts=N` ограничивает число перезапусков (по умолчанию 20; `0` = без ограничения).
 - `--restart-delay=S` — секунды ожидания между перезапусками (по умолчанию 2).
 - `--log` сохраняет строку вердикта `rc=` для завершения сессии.
 - Декодер пишет `SIGNAL INTEGRITY WARNING`, когда ≥ 8 из последних
  64 кадров не проходят проверку чётности.
 - Десинхронизированные TPDU (обмены с ошибкой кадрирования) сохраняются,
  но помечаются `GSMTAP_FLAG_BAD_FCS` в байте `res` заголовка GSMTAP —
  видно в Wireshark как предупреждение BAD-FCS.
 - Заголовок T=0 со структурно некорректным INS (ISO 7816-4 §12.1.1:
  `0x00`, `0x6x`/`0x9x` или нечётный младший бит) почти всегда сдвинут на
  один байт из-за лишнего ведущего байта (например, дочитанного остатка
  SW2 после PACKETEND).  Вместо молчаливого отбрасывания всего 5-байтового
  окна (из-за чего следующий байт становился фиктивным CLA и проглатывал
  остаток диалога в один CONCAT-пакет) декодер отбрасывает только ведущий
  байт и перекадрирует остальные, восстанавливая настоящую команду.
  Каждый потреблённый, но не выведенный байт явно логируется
  (`discarded byte 0x…: reason`); отбрасывания холостых 0x00/0xFF
  ограничены по частоте, отбрасывания не-холостых байтов всегда дают
  аннотацию декодера.
 Производительность: в режиме native CLK декодер один раз калибрует число
 отсчётов на фронт CLK по первому кадру ATR, а затем продвигает битовую
 синхронизацию одиночными пропусками отсчётов вместо ожидания на каждый
 фронт CLK.  Переключение скорости по PPS отслеживается через
 `clock_skip = F/D`; никакой перекалибровки после PPS или по чётности нет.
 ### Сравнение режимов на железе FX2 (результат A/B)
 - `native` декодировал реальный трафик (ATR, переключение PPS, 100+ валидных
  APDU за 12-секундное окно); единственным устойчивым артефактом был
  «дребезг» линии VCC — звон ~1 кГц, который теперь подавляет антидребезг 10 мс.
 - `detect` ни разу не дал пригодной сессии на этом стенде: он полностью
  пропускал переключение скорости по PPS (обработка PPS не срабатывала) и
  алиасил весь трафик после PPS; вторая попытка поймала мёртвую линию I/O.
 `native` остаётся режимом по умолчанию.  Используйте `--clock=detect`
 только для офлайн-экспериментов без PPS.  Запись, целиком состоящая из
 нулевых кадров, означает, что съём потерял контакт с линией.
 Чётность — **чётная** по TS 102 221 («чётное число битов, установленных в
 '1', включая бит чётности»); кадры, не прошедшие проверку, помечаются
 `CHKSUM ERROR`, но всё равно декодируются.
 Эквивалентные «сырые» команды sigrok-cli:
 ```bash
 # Минимум: только CLK+I/O, живой поток на localhost:4729
 sigrok-cli -d fx2lafw --config samplerate=12M --continuous \
  -P iso7816:clk=D0:data=D1:clock_option=detect -A iso7816
 # Полное подключение: CLK + I/O + RST + VCC с отслеживанием событий линий
 sigrok-cli -d fx2lafw --config samplerate=12M --continuous \
  -P iso7816:clk=D5:data=D0:rst=D4:vcc=D2:clock_option=native:rst_detect=true:vcc_detect=true \
  -A iso7816
 # Поток на удалённый анализатор / отключить стриминг / писать PCAP-файл
 ... -P iso7816:...:gsmtap_host=10.0.28.7 ...
 ... -P iso7816:...:gsmtap_enable=false ...
 ... -P iso7816:...:pcap_file=trace.pcap ...
 # Классический режим upstream: бинарный PCAP в stdout
 sigrok-cli -i capture.sr -P iso7816:clk=2:data=0 -B iso7816=pcap > out.pcap
 ```
 ### Распиновка
 Каналы клона FX2 назначаются через `-P iso7816:clk=N:data=N:rst=N:vcc=N`.
 Рекомендуемый съём коротким кабелем (с внешними подтягивающими резисторами)
 использует фиксированные выводы, которые в точности совпадают с умолчаниями
 `start.sh`; `--clk`/`--data`/`--rst`/`--vcc` переназначают их, если вы
 подключили иначе:
 | Канал FX2 | Контакт SIM | Сигнал |
 |-------------|-------------|--------|
 | D0 | C7 | I/O |
 | D2 | C1 | VCC (только цифровой уровень!) |
 | D4 | C2 | RST |
 | D5 | C3 | CLK |
 | GND | C5 | GND |
 Входной порог FX2 близок к TTL (~1.4 В): карты класса 1.8 В могут читаться
 нестабильно; классы 3 В/5 В — нормально.
 **Частота дискретизации и 8-битный режим (важно):** номинальные 24 МГц FX2
 доступны только при дискретизации в 8-битном режиме, т.е. когда **включены
 только каналы D0–D7**.  Включение 9-го канала (A0/аналоговый на клонах CWAV
 AX) или любого аналогового входа переводит сбор в 16-битный, который
 libsigrok ограничивает 12 МГц.  Поэтому `start.sh`/`start.bat` явно
 передают `-C D0,D1,D2,D3,D4,D5,D6,D7` и по умолчанию используют **16 МГц**
 (с комфортным запасом под потолком USB 24 МГц; ~3.3 отсчёта на такт CLK
 4.8 МГц).  `setup.sh`/`setup.bat` проверяют и сообщают фактический максимум
 вашего железа при том же ограничении.
 ## Установка
 ### Linux
 ```bash
 git clone git@github.com:anttro/sigrok_iso7816_stream.git
 cd sigrok_iso7816_stream
 ./setup.sh
 ```
 `setup.sh` проверяет, что установлены sigrok-cli и пакет прошивки FX2
 (`sigrok-firmware-fx2lafw`), создаёт симлинк репозитория в
 `~/.local/share/libsigrokdecode/decoders/iso7816` (пользовательские
 декодеры перекрывают системные) и опрашивает подключённое устройство на
 предмет максимальной поддерживаемой частоты дискретизации.
 ### Windows
 Предварительные требования:
 1. **sigrok-cli** — установщик для Windows (0.7.2 x86_64) с
   [sigrok.org/wiki/Downloads](https://sigrok.org/wiki/Downloads).
   Если он не запускается с ошибкой `0xc0150002`, установите
   [Visual C++ 2010 Redistributable](https://www.microsoft.com/en-us/download/details.aspx?id=26999)
   (`msvcr100.dll` требуется встроенному Python-рантайму).
 2. Прошивка fx2lafw поставляется вместе с установщиком — отдельно скачивать не нужно.
 Настройка драйвера (донглам FX2 нужен WinUSB, вендорский драйвер не подойдёт):
 - Запустите **Zadig**, который лежит *внутри* каталога установки sigrok-cli
  (также доступен из меню «Пуск»). Выберите устройство FX2 в выпадающем
  списке и установите драйвер **WinUSB**.
 - После загрузки прошивки устройство переподключается с другим VID/PID —
  если оно всё ещё не находится, запустите Zadig **второй раз** для
  переподключившегося устройства.
 - Windows привязывает драйверы к USB-порту, когда нет серийного номера:
  перенос донгла в другой порт может потребовать повторить Zadig.
 Затем:
 ```bat
 git clone git@github.com:anttro/sigrok_iso7816_stream.git
 cd sigrok_iso7816_stream
 setup.bat
 ```
 `setup.bat` проверяет sigrok-cli и встроенную прошивку, регистрирует декодер
 этого репозитория через junction в
 `%LOCALAPPDATA%\libsigrokdecode\decoders\iso7816` (подтверждается тем, что
 `sigrok-cli -L` показывает `iso7816`), и опрашивает устройство на предмет
 поддерживаемых частот дискретизации.
 Запись работает так же, как в Linux:
 ```bat
 start.bat                   rem запись + поток GSMTAP
 ```
 Примечание: bat-файлы требуют переводов строк CRLF; репозиторий следит за
 этим через `.gitattributes`, поэтому свежий клон в Windows уже корректен.
 ## Заметки и ограничения по детектированию RST/VCC
 - События детектируются **асинхронно до первого ATR** (включение питания /
  снятие сброса фиксируются, как только уровень стабилизируется) и **на
  границах пакетов** между T=0/T=1 в дальнейшем.
 - Фронты, происходящие целиком *внутри* передачи пакета, наблюдаются как
  итоговое изменение уровня на следующей границе; короткие импульсы внутри
  пакета могут быть пропущены.
 - VCC — только цифровой: декодер видит «питание есть/нет», но никогда
  не класс напряжения (1.8/3/5 В).
 - **RST и VCC используют гистерезис стабильности уровня в 10 мс**
  (масштабируется от частоты дискретизации): новый уровень сообщается
  только после того, как он непрерывно стабилен ≥ 10 мс — либо потому, что
  он держится так долго, либо потому, что он закончился, продержавшись
  столько.  Это делает включение и выключение питания *симметричными*:
  линия VCC, которая **звенит на фронте** (шумный/плавающий съём), больше
  не теряет событие «VCC on» — оно срабатывает, как только линия
  устанавливается в HIGH, вместо того чтобы быть съеденным дребезгом
  фронта.  RST использует ту же схему, поэтому короткий глитч RST больше
  не вызывает фантомный re-arm по тёплому сбросу.
 - **События VCC в целом ненадёжны — лучше не отслеживать VCC.** Плавающий
  или неподключённый пин съёма VCC всегда читается как HIGH (логическая
  единица без нагрузки), поэтому декодер постоянно видит «питание подано»
  и выдаёт ложные события питания при каждом дребезге.  Если ваш съём не
  берёт VCC с чистого нагруженного источника, лучше **оставить канал `vcc`
  неназначенным** (не передавать `--vcc`) и держать `vcc_detect=false`;
  отслеживания RST обычно достаточно, чтобы видеть сбросы.  Включайте
  отслеживание VCC только на съёме с надёжным измерением VCC (и надёжным
  GND — см. заметки о подключении).
 - Неназначенные опциональные каналы игнорируются, даже если
  `rst_detect`/`vcc_detect` включены (защита через `has_channel()`).
 ## Тестирование
 Проверено на примерах записей из upstream:
 ```bash
 # ATR+PPS+54 APDU из записи ридера test_8 (~19 с декодирования)
 # Поток GSMTAP проверен через tshark (ATR/APDU разбираются нативно),
 # кастомные события 0x10/0x11 — через UDP-слушатель, и сквозным путём
 # в сервер simtrace2-pysniff (POST /api/capture/start → decode → stop).
 ```
 Синтетический генератор VCD, покрывающий краевые случаи RST/VCC, живёт в
 заметках проекта (`projects/SIGROK_ISO7816.md` в родительском рабочем
 пространстве).
 ### Проверка по SDK ридера (`tools/vs_reader.py`)
 На контролируемом стенде (PCSC-ридер под управлением софта) эталонный
 журнал APDU из SDK ридера можно сравнить с декодированным PCAP:
 ```bash
 sigrok-cli -i <trace>.sr \
  -P iso7816:clk=D5:data=D0:rst=D4:vcc=D2:clock_option=native:rst_detect=true:vcc_detect=true:gsmtap_enable=false:pcap_file=out.pcap \
  -A iso7816
 python3 tools/vs_reader.py <reader-log>.log out.pcap
 ```
 `vs_reader.py` выравнивает каждый обмен из журнала ридера с APDU из записи
 (побайтовое LCS-совпадение) и классифицирует остатки как proactive/CAT
 (невидимые для SDK ридера), pre-capture/потерянные или мусор.
 Запись, начатая в середине сессии, тёплые сбросы которой раньше давали
 4 мусорных события, с re-arm и защитой стартового бита декодируется в
 **0 мусора** (`RESULT: OK - capture fully explained`).
 test_7 (4 сброса ATR, фрагментирующих сессию) теперь захватывает все 37/37
 обменов ридера (было 10/37 до исправления деглитча).  Телефонные трассы
 Samsung с 16 CLK/ETU (F=512/D=32) теперь разбираются на 924 отдельных
 обмена T=0 (раньше сливались в 52 APDU завышенного размера).
 Воспроизводимые фикстуры трасс (хранятся локально, вне репозитория)
 покрывают сессии ридера с контролируемого стенда (с эталонными журналами
 SDK ридера), телефонные записи с гейтированным CLK и **записи холодного
 старта**, начинающиеся *до* включения питания (VCC/RST низкие при t=0).
 Четыре фикстуры Samsung — холодные старты, снятые новым коротким кабелем
 (провода 30 мм, внешние подтягивающие резисторы GND→VCC и VCC→DATA), с
 каналами `DATA/VCC/RST/CLK` на битах 0/2/4/5; варианты `sim2` обрезаны до
 окна включения питания.
 ### Записи холодного старта (запись начинается до включения питания)
 Когда запись начинается до включения питания, декодер должен взвести охоту
 за ATR, потому что RST всё ещё низкий на отсчёте 0: он инициализирует
 начальные уровни VCC/RST на первом шаге (вместо того чтобы по умолчанию
 считать их снятыми) и при низком RST на старте входит в `FIND START` с
 очищенным ETU, поэтому переходы DATA при включении питания до ATR не могут
 зафиксировать фиктивную битовую скорость.  Затем он декодирует полный ATR
 (`3b9f96801fc78031e073fe2117574a3382033339001e`) с 0 мусора:
 ```bash
 sigrok-cli -i <coldboot>.sr \
  -P iso7816:clk=CLK:data=DATA:rst=RST:vcc=VCC:clock_option=native:protocol=T=0:rst_detect=true:vcc_detect=true:gsmtap_enable=false:pcap_file=out.pcap \
  -A iso7816
 ```
 Снятие RST (deassert), которое приходит, пока разбор ATR уже идёт, больше не
 перевзводит охоту посреди чтения — оно логирует `RST deasserted (hunt/ATR
 already in progress)` и не трогает разбираемый ATR (test_8/test_7
 CHKSUM 18→0).
 ### Сценарии записи: ридер (постоянный CLK) и телефон (Clock Stop Mode)
 Декодер обрабатывает две физически разные схемы съёма SIM:
 - **Запись ридера / постоянный CLK** — ридер ведёт ровный CLK всю сессию.
  В режиме mid-session запись декодируется в **0 мусора**
  (`RESULT: OK`) относительно эталона из SDK ридера
  (`tools/vs_reader.py <reader-log>.log out.pcap`).
  Записи ридера с тёплыми сбросами используют fallback с синтетическим
  T=0-ATR.
 - **Запись телефона / остановленный CLK** — телефон гейтирует или
  останавливает CLK между передачами (Clock Stop Mode), поэтому ETU не
  равен стандартным 372 тактам и не может быть выведен из CLK.  Запускайте
  с `protocol=T=0`; декодер восстанавливает ETU из линии DATA подсчётом
  фронтов, фиксирует его и декодирует устойчивым к дрейфу edge-list
  читателем битов.  Команды T=0 case 3/4 (например, `80 12`/`80 14`
  STK envelope) объединяются в один APDU команда→ответ.  Деглитч стартового
  бита в 2 отсчёта убирает LOW-глитчи короче ETU, вызванные артефактами
  внутренней подтяжки FX2LP, и предотвращает смещение байтов на быстрых
  телефонных трассах.
 ### Проверенные скорости данных и ETU
 Все трассы декодированы на **частоте дискретизации 16 МГц**, 0 мусора,
 RESULT: OK.  Начиная с v1.5.0 каждая трасса из набора примеров также
 сообщает **0 CONCAT** (перекадрирование по некорректному INS устранило
 последнее семейство проглатывания нескольких обменов на
 4gmodem/A55_sim2/S21p_sim2).
 | Трасса | Режим CLK | ETU (отсчёты) | CLK/ETU | Конвенция | Примечания |
 |-------|----------|---------------|---------|------------|-------|
 | test_8 | постоянный | ~43 | 372 (стандарт) | Direct | PC/SC ридер, ATR+PPS+APDU |
 | test_7 | постоянный | ~43 | 372 (стандарт) | Direct | PC/SC ридер, тёплые сбросы |
 | xiaomi | гейтированный/остановленный | ~53 | восстановлен из DATA | Direct | Телефон, середина сессии |
 | samsung | гейтированный/остановленный | ~72 | 16 (F=512/D=32) | Direct | Телефон, нестандартный F/D, меню STK |
 Декодер автоопределяет ETU по трассе и выбирает подходящий читатель битов
 (CLK-синхронный для постоянного CLK, edge-list для гейтированного/
 остановленного CLK).  Никакой ручной настройки не требуется, кроме
 `clock_option=native` и `protocol=T=0` для телефонных записей.
 Рекомендуемые вызовы:
 ```bash
 # Запись ридера (контролируемый стенд, CLK всегда работает)
 sigrok-cli -i <trace>.sr \
  -P iso7816:clk=CLK:data=DATA:rst=RST:vcc=VCC:clock_option=native:rst_detect=true:vcc_detect=true:gsmtap_enable=false:pcap_file=out.pcap \
  -A iso7816
 python3 tools/vs_reader.py <reader-log>.log out.pcap
 # Запись телефона (середина сессии, гейтированный/остановленный CLK)
 sigrok-cli -i <phone>.sr \
  -P iso7816:clk=CLK:data=DATA:rst=RST:clock_option=native:rst_detect=true:vcc_detect=false:protocol=T=0:gsmtap_enable=false:pcap_file=out.pcap \
  -A iso7816
 ```
 ## Лицензия
 GPL-2.0+, как и upstream.