Войти Подписаться

Установка sigrok_iso7816_stream

Установка и запуск

Оба способа ставят один и тот же декодер — выберите один:

  • Скачать (рекомендуется) — архив релиза. Не нужно ничего клонировать и нет истории git: распакуйте, запустите setup, затем start. Лучший вариант, если нужен только съём.
  • Из исходников — git clone. Тот же рантайм плюс материал для разработки: tests/ и инструменты трасс и базовой линии (tools/capture_baseline.sh, tools/compare_baseline.sh, tools/vs_reader.py). Трассы примеров (examples/) исключены из git и остаются локальными. В архивах релиза нет tests/, dev-инструментов и examples/.

Скачать (рекомендуется)

Скачайте последний архив со страницы Releases:

  • sigrok_iso7816_stream-<version>.tar.gz — Linux
  • sigrok_iso7816_stream-<version>.zip — Windows

К каждому релизу прилагается SHA256SUMS — в нём оба архива. Положите файл рядом со скачанным архивом и проверьте:

sha256sum -c --ignore-missing SHA256SUMS   # GNU coreutils (Linux)

В Windows выполните certutil -hashfile sigrok_iso7816_stream-<version>.zip SHA256 и сравните вывод со строкой .zip в SHA256SUMS.

Linux (скачать)

tar xzf sigrok_iso7816_stream-<version>.tar.gz
cd sigrok_iso7816_stream-<version>
./setup.sh
./start.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 — протестированная версия. На этой же странице публикуются ночные сборки для Windows; они могут менять синтаксис sigrok-cli или API декодеров, поэтому поддерживаемой остаётся версия из релизного установщика 0.7.2. Если sigrok-cli не запускается с ошибкой 0xc0150002, установите Visual C++ 2010 Redistributable (msvcr100.dll требуется встроенному Python-рантайму).
  2. Прошивка fx2lafw поставляется вместе с установщиком — отдельно скачивать не нужно.

Настройка драйвера (донглам FX2 нужен WinUSB, вендорский драйвер не подойдёт):

  • Запустите Zadig, который лежит внутри каталога установки sigrok-cli (также доступен из меню «Пуск»). Выберите устройство FX2 в выпадающем списке и установите драйвер WinUSB.
  • После загрузки прошивки устройство переподключается с другим VID/PID — если оно всё ещё не находится, запустите Zadig второй раз для переподключившегося устройства.
  • Windows привязывает драйверы к USB-порту, когда нет серийного номера: перенос донгла в другой порт может потребовать повторить Zadig.

Затем распакуйте архив .zip (в Проводнике: правой кнопкой → «Извлечь все») и запустите в распакованном каталоге:

setup.bat
start.bat

setup.bat проверяет sigrok-cli и встроенную прошивку, регистрирует декодер этого проекта через junction в %LOCALAPPDATA%\libsigrokdecode\decoders\iso7816 (подтверждается тем, что sigrok-cli -L показывает iso7816), и опрашивает устройство на предмет поддерживаемых частот дискретизации. В zip-архиве релиза bat-файлы уже с переводами строк CRLF, поэтому преобразование не требуется. start.bat --help перечисляет его опции (основное подмножество start.sh: каналы, частота дискретизации, clock, host/port, pcap, protocol, debug).

Из исходников

Linux (из исходников)

git clone git@github.com:anttro/sigrok_iso7816_stream.git
cd sigrok_iso7816_stream
./setup.sh
./start.sh

setup.sh выполняет те же проверки и создаёт тот же симлинк, что и выше.

Windows (из исходников)

Предварительные требования Windows (sigrok-cli и Visual C++ 2010 Redistributable, встроенная прошивка fx2lafw и настройка драйвера Zadig/WinUSB) — те же, что в разделе Windows (скачать) выше.

git clone git@github.com:anttro/sigrok_iso7816_stream.git
cd sigrok_iso7816_stream
setup.bat
start.bat

setup.bat выполняет те же проверки и регистрацию junction, что и выше. start.bat поддерживает основное подмножество опций; основной формат — с пробелом, --clk=CH тоже работает (start.bat --help перечисляет опции):

start.bat --clk D1 --data D6

Примечание: bat-файлы требуют переводов строк CRLF; репозиторий следит за этим через .gitattributes, поэтому свежий клон в Windows уже корректен (zip-архив релиза содержит те же файлы с CRLF).

Использование

start.sh пишет непрерывный поток на частоте 16 МГц до Ctrl+C (rc=130) и стримит GSMTAP на 127.0.0.1:4729. Умолчания: выводы D5=CLK, D0=I/O, D4=RST, D2=VCC. Переопределяются аргументами:

./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 и предупреждения/ошибки

В Windows start.bat принимает то же основное подмножество опций (форма с пробелом; форма --opt=value тоже работает) — см. заметки по установке Windows выше.

Полный README_RUS.md в репозитории