Files
catarrh 1cbafe715c
release / release (push) Waiting to run
Release packaging: archives, workflow, download-first docs, Windows notes
- tools/build_release.sh: builds the Linux tar.gz and Windows zip from a
  git ref (default HEAD) using an explicit `git archive` pathspec
  allowlist: decoder (__init__.py, pd.py, gsmtap_stream.py), setup/start
  scripts, tools/vs_reader.py, READMEs, LICENSE and the README-referenced
  resources/ images.  v* tags must match pd.py VERSION.  Both archives
  are listed and extracted and checked for VERSION, py_compile, bash -n,
  .bat CRLF / .sh LF and tar exec bits; SHA256SUMS uses sha256sum or
  shasum.  Builds into a staging dir and only then replaces dist/.
- .github/workflows/release.yml: on a v* tag push run the unit tests,
  verify tag == pd.py VERSION, build, then upload into an existing
  release or create a draft and publish it; release-<tag> concurrency.
- README/RUS: Installation documents both ways (release download
  recommended; source checkout for development), SHA256SUMS verification,
  and the Windows prerequisites verified against sigrok.org (0.7.2
  release installer as the tested version, nightly caveat, VC++ 2010
  redist, bundled fx2lafw firmware and Zadig, per-port driver binding).
- start.bat: accept --opt=value alongside the original --opt value form
  (the usage text advertised the = form while the parser required a
  space); usage corrected and notes the core subset.
- .gitignore: dist/.
- AGENTS: release packaging, build verification and release process
  (commit docs/workflow first, then tag and push, auto-generated notes).

No decoder behavior change; VERSION stays 1.9.7.
2026-10-20 23:32:05 +03:00

135 lines
6.5 KiB
Batchfile

@echo off
rem sigrok_iso7816_stream launcher (Windows): capture ISO 7816 and stream
rem GSMTAP to :4729. Mirrors the core start.sh flags (channel/samplerate/
rem clock/gsmtap/pcap/protocol/debug); start.sh has the full flag set.
setlocal EnableExtensions EnableDelayedExpansion
set "CLK=D5"
set "DATA=D0"
set "RST=D4"
set "VCC=D2"
set "SAMPLERATE=16M"
set "CLOCK=native"
set "HOST=127.0.0.1"
set "PORT=4729"
set "PCAP="
set "DEBUG="
rem Annotation rows (multi-spec form is sigrok-cli 0.7.x syntax; pin on upgrade)
set "ANNOT=iso7816=apdus,iso7816=warnings"
set "PROTOCOL=T=0"
:argloop
if "%~1"=="" goto :argsdone
if /i "%~1"=="--clk" ( set "CLK=%~2" & shift & shift & goto :argloop )
if /i "%~1"=="--data" ( set "DATA=%~2" & shift & shift & goto :argloop )
if /i "%~1"=="--rst" ( set "RST=%~2" & shift & shift & goto :argloop )
if /i "%~1"=="--vcc" ( set "VCC=%~2" & shift & shift & goto :argloop )
if /i "%~1"=="--samplerate" ( set "SAMPLERATE=%~2" & shift & shift & goto :argloop )
if /i "%~1"=="--clock" ( set "CLOCK=%~2" & shift & shift & goto :argloop )
if /i "%~1"=="--host" ( set "HOST=%~2" & shift & shift & goto :argloop )
if /i "%~1"=="--port" ( set "PORT=%~2" & shift & shift & goto :argloop )
if /i "%~1"=="--pcap" ( set "PCAP=%~2" & shift & shift & goto :argloop )
if /i "%~1"=="--debug" ( set "DEBUG=1" & set "ANNOT=iso7816" & shift & goto :argloop )
if /i "%~1"=="--protocol" ( set "PROTOCOL=%~2" & shift & shift & goto :argloop )
if /i "%~1"=="--no-rst" ( set "RST=" & shift & goto :argloop )
if /i "%~1"=="--no-vcc" ( set "VCC=" & shift & goto :argloop )
if /i "%~1"=="-h" ( goto :usage )
if /i "%~1"=="--help" ( goto :usage )
rem Value options also accept the --opt=value form (usage shows the space form).
for /f "tokens=1,* delims==" %%A in ("%~1") do (
if /i "%%A"=="--clk" ( set "CLK=%%B" & shift & goto :argloop )
if /i "%%A"=="--data" ( set "DATA=%%B" & shift & goto :argloop )
if /i "%%A"=="--rst" ( set "RST=%%B" & shift & goto :argloop )
if /i "%%A"=="--vcc" ( set "VCC=%%B" & shift & goto :argloop )
if /i "%%A"=="--samplerate" ( set "SAMPLERATE=%%B" & shift & goto :argloop )
if /i "%%A"=="--clock" ( set "CLOCK=%%B" & shift & goto :argloop )
if /i "%%A"=="--host" ( set "HOST=%%B" & shift & goto :argloop )
if /i "%%A"=="--port" ( set "PORT=%%B" & shift & goto :argloop )
if /i "%%A"=="--pcap" ( set "PCAP=%%B" & shift & goto :argloop )
if /i "%%A"=="--protocol" ( set "PROTOCOL=%%B" & shift & goto :argloop )
)
echo Unknown option: %~1
exit /b 1
:usage
echo Usage: %~n0 [OPTIONS]
echo --clk CH CLK channel default: %CLK%
echo --data CH I/O channel default: %DATA%
echo --rst CH RST channel default: %RST%
echo --vcc CH VCC channel default: %VCC%
echo --samplerate SR Sample rate default: %SAMPLERATE%
echo --clock MODE native/detect/sample_as_clock
echo --host IP GSMTAP destination default: 127.0.0.1
echo --port N GSMTAP port default: 4729
echo --pcap FILE Also write decoded events to FILE (no spaces in path)
echo --debug Full decoder + sigrok output (all annotation rows + -l 4).
echo
echo By default only decoded APDUs and decoder warnings/errors are shown.
echo --protocol MODE T=0 (default), T=1, or auto (mid-session decode)
echo --no-rst Disable RST tracking
echo --no-vcc Disable VCC tracking
echo.
echo The --clk=CH form also works. start.bat supports this core subset;
echo start.sh has the full option set.
echo.
echo To log output on Windows use redirection: %~n0 ... ^> capture.log 2^>^&1
exit /b 0
:argsdone
set "SIGROK_EXE="
rem Try known install locations (order: 64-bit, 32-bit, then PATH)
if not defined SIGROK_EXE if exist "%ProgramFiles%\sigrok\sigrok-cli\sigrok-cli.exe" set "SIGROK_EXE=%ProgramFiles%\sigrok\sigrok-cli\sigrok-cli.exe"
if not defined SIGROK_EXE if exist "%ProgramFiles(x86)%\sigrok\sigrok-cli\sigrok-cli.exe" set "SIGROK_EXE=%ProgramFiles(x86)%\sigrok\sigrok-cli\sigrok-cli.exe"
if not defined SIGROK_EXE if exist "%ProgramFiles%\sigrok\PulseView\sigrok-cli.exe" set "SIGROK_EXE=%ProgramFiles%\sigrok\PulseView\sigrok-cli.exe"
if not defined SIGROK_EXE if exist "%ProgramFiles(x86)%\sigrok\PulseView\sigrok-cli.exe" set "SIGROK_EXE=%ProgramFiles(x86)%\sigrok\PulseView\sigrok-cli.exe"
if not defined SIGROK_EXE where sigrok-cli >nul 2>&1 && for /f "delims=" %%i in ('where sigrok-cli') do set "SIGROK_EXE=%%i"
if not defined SIGROK_EXE goto :notfound
for %%i in ("!SIGROK_EXE!") do set "SIGROK_DIR=%%~dpi"
if "!SIGROK_DIR:~-1!"=="\" set "SIGROK_DIR=!SIGROK_DIR:~0,-1!"
set "PATH=!SIGROK_DIR!;!PATH!"
goto :found
:notfound
echo [X] sigrok-cli not found.
echo Searched:
echo %ProgramFiles%\sigrok\sigrok-cli
echo %ProgramFiles(x86)%\sigrok\sigrok-cli
echo %ProgramFiles%\sigrok\PulseView
echo %ProgramFiles(x86)%\sigrok\PulseView
echo PATH
echo Install from https://sigrok.org/wiki/Downloads
exit /b 1
:found
rem Normalize --protocol to the decoder's accepted form (T=0 / T=1 / auto).
if /i "%PROTOCOL%"=="T0" set "PROTOCOL=T=0"
if /i "%PROTOCOL%"=="T1" set "PROTOCOL=T=1"
if /i "%PROTOCOL%"=="AUTO" set "PROTOCOL=auto"
set "OPTS=clk=%CLK%:data=%DATA%:clock_option=%CLOCK%"
set "OPTS=%OPTS%:gsmtap_host=%HOST%:gsmtap_port=%PORT%"
if defined RST set "OPTS=%OPTS%:rst=%RST%:rst_detect=true"
if defined VCC set "OPTS=%OPTS%:vcc=%VCC%:vcc_detect=true"
if defined PCAP set "OPTS=%OPTS%:pcap_file=%PCAP%"
set "OPTS=%OPTS%:protocol=%PROTOCOL%"
set "CMDLINE=sigrok-cli -d fx2lafw --config samplerate=%SAMPLERATE% --continuous -C D0,D1,D2,D3,D4,D5,D6,D7"
if defined DEBUG set "CMDLINE=%CMDLINE% -l 4"
set "CMDLINE=%CMDLINE% -P iso7816:%OPTS% -A %ANNOT%"
echo ISO 7816 streamer - clk=%CLK% data=%DATA% clock=%CLOCK%
if defined RST echo RST tracking on channel %RST%
if defined VCC echo VCC tracking on channel %VCC%
if defined PCAP echo PCAP output: %PCAP%
echo Samplerate: %SAMPLERATE% ^| GSMTAP -^> %HOST%:%PORT%
echo Capture runs until you press Ctrl+C.
echo.
rem <NUL detaches stdin (best-effort to disable sigrok's "press any key
rem to stop acquisition" prompt); not verified on Windows, where the
rem prompt may read the console rather than stdin.
%CMDLINE% <NUL
exit /b %errorlevel%