Files
STM32F4-Base/test/run_boot_test.ps1
T

175 lines
6.2 KiB
PowerShell

<#
run_boot_test.ps1 - Automated boot-log capture + verify in one call.
Uses the repo's Python serial assistant (tools/serial_tool/serial_tool.py,
resident daemon on 127.0.0.1:18765, auto-started on first call):
1. open COM port + clear log (fresh generation for this run)
2. flash via -FlashCmd (download.bat: download + Reset & Run)
3. wait-idle: until RX silence >= SettleMs, or MaxWaitMs timeout
4. extract [RX] payload lines from the log file (prefix/timestamp stripped)
5. verify_log.ps1 marker check
The capture is armed (port open, log cleared) BEFORE flashing, and the
resident daemon buffers everything in tools/serial_tool/state/serial.log -
no capture-window timing ritual, no first-byte wait, no EOF retries.
Usage:
powershell -ExecutionPolicy Bypass -File run_boot_test.ps1 `
[-Port COM6] [-BaudRate 115200] `
[-SettleMs 8000] [-MaxWaitMs 30000] `
[-FlashCmd "D:\...\download.bat"] `
[-Required "App init OK;Network Init;net init: OK"] `
[-Forbidden "FAIL;ERROR;HardFault"] `
[-OutDir C:\temp] [-ShowTailLines 15]
-Port default: .opencode/serial_config.json "portName" entry.
-SettleMs: RX silence that ends the capture (default 8000 - boot has a
natural 3~4s silent gap between tasks; 2000 would truncate the log).
Exit codes:
0 = PASS (captured + all required markers + no forbidden)
1 = FAIL (marker miss / forbidden hit)
2 = capture or flash error
3 = usage / preflight error
NOTE: ASCII-only on purpose - project source files contain Chinese and must
never be rewritten by encoding-sensitive PowerShell. Keep this script ASCII.
#>
[CmdletBinding()]
param(
[string]$Port = "",
[int]$BaudRate = 115200,
[int]$SettleMs = 8000,
[int]$MaxWaitMs = 30000,
[string]$FlashCmd = "",
[string]$Required = "App init OK;Network Init;net init: OK",
[string]$Forbidden = "FAIL;ERROR;HardFault",
[string]$OutDir = "$env:TEMP\opencode",
[int]$ShowTailLines = 15
)
$ErrorActionPreference = 'Stop'
$scriptDir = Split-Path -Parent $MyInvocation.MyCommand.Path
$repoRoot = Split-Path -Parent $scriptDir
$py = Join-Path $repoRoot ".venv\Scripts\python.exe"
$tool = Join-Path $repoRoot "tools\serial_tool\serial_tool.py"
$verifyScript = Join-Path $scriptDir "verify_log.ps1"
$cfgFile = Join-Path $repoRoot ".opencode\serial_config.json"
# -Port default: the single source of truth is .opencode/serial_config.json
if (-not $Port) {
if (Test-Path -LiteralPath $cfgFile) {
$Port = (Get-Content -LiteralPath $cfgFile -Raw -Encoding UTF8 | ConvertFrom-Json).portName
}
}
if (-not $Port) {
Write-Output "RUN_TEST_ERROR: no -Port given and no portName in $cfgFile"
exit 3
}
# Default flash command: resolve relative to the repo (no stale absolute paths)
if (-not $FlashCmd) {
$FlashCmd = Join-Path $repoRoot "MDK-ARM\download.bat"
}
foreach ($p in @($py, $tool, $verifyScript)) {
if (-not (Test-Path -LiteralPath $p)) {
Write-Output "RUN_TEST_ERROR: missing $p"
exit 3
}
}
if (-not (Test-Path -LiteralPath $FlashCmd)) {
Write-Output "RUN_TEST_ERROR: flash command not found: $FlashCmd"
exit 3
}
if (-not (Test-Path -LiteralPath $OutDir)) {
New-Item -ItemType Directory -Path $OutDir -Force | Out-Null
}
$stamp = Get-Date -Format "yyyyMMdd_HHmmss"
$bootTxt = Join-Path $OutDir "boot_log_$stamp.txt"
function Invoke-Tool {
param(
[Parameter(Position = 0)][string]$Command,
[Parameter(ValueFromRemainingArguments = $true)][string[]]$Rest
)
$script:toolOut = (& $py $tool $Command @Rest 2>$null) -join "`n"
$script:toolRc = $LASTEXITCODE
}
Write-Output "=== Boot test $stamp ==="
Write-Output "Port: $Port @ ${BaudRate} settle=${SettleMs}ms max=${MaxWaitMs}ms"
# 1. open port (auto-starts the serial daemon if it is not running)
Invoke-Tool "open" "--port" $Port "--baud" $BaudRate "--timeout" 15
if ($script:toolRc -ne 0) {
Write-Output "RUN_TEST_ERROR: open failed: $($script:toolOut)"
exit 2
}
# 2. clear log (fresh generation; only data after this belongs to the run)
Invoke-Tool "clear" "--timeout" 15
if ($script:toolRc -ne 0) {
Write-Output "RUN_TEST_ERROR: clear failed: $($script:toolOut)"
exit 2
}
# 3. flash (download + Reset & Run). A failed flash does not abort: the
# board may still have reset; capture + marker check will judge the result.
Write-Output "FLASH_START: $FlashCmd"
$sw = [System.Diagnostics.Stopwatch]::StartNew()
& $FlashCmd
$flashRc = $LASTEXITCODE
$sw.Stop()
Write-Output ("FLASH_RC: {0} elapsed_ms={1}" -f $flashRc, $sw.ElapsedMilliseconds)
if ($flashRc -ne 0) {
Write-Output "RUN_TEST_WARN: flash rc=$flashRc (continuing: board may still have reset)"
}
# 4. wait for RX silence (settle) or the overall timeout
$waitTimeoutS = [int]($MaxWaitMs / 1000) + 20
Invoke-Tool "wait-idle" "--settle-ms" $SettleMs "--max-ms" $MaxWaitMs "--timeout" $waitTimeoutS
if ($script:toolRc -ne 0) {
Write-Output "RUN_TEST_ERROR: wait-idle failed: $($script:toolOut)"
exit 2
}
$wait = $script:toolOut | ConvertFrom-Json
Write-Output ("WAIT: reason={0} rx_bytes={1} waited_ms={2}" -f $wait.reason, $wait.rx_bytes, $wait.waited_ms)
if ($wait.reason -eq "no_data") {
Write-Output "RUN_TEST_ERROR: no RX data at all (check port / board power / flash)"
exit 2
}
# 5. extract [RX] payload lines (strip the "[RX] <iso-timestamp> " prefix)
Invoke-Tool "log" "--tail" 0 "--timeout" 15
if ($script:toolRc -ne 0) {
Write-Output "RUN_TEST_ERROR: log read failed: $($script:toolOut)"
exit 2
}
$logJson = $script:toolOut | ConvertFrom-Json
$rx = New-Object System.Collections.Generic.List[string]
foreach ($l in $logJson.lines) {
if ($l -is [string] -and $l.StartsWith("[RX] ")) {
$rest = $l.Substring(5)
$sp = $rest.IndexOf(" ")
if ($sp -ge 0) { $rx.Add($rest.Substring($sp + 1)) } else { $rx.Add($rest) }
}
}
if ($rx.Count -eq 0) {
Write-Output "RUN_TEST_ERROR: no [RX] lines in log (device silent?)"
exit 2
}
[System.IO.File]::WriteAllLines($bootTxt, $rx, (New-Object System.Text.UTF8Encoding($false)))
Write-Output "Boot log: $bootTxt (lines=$($rx.Count) gen=$($logJson.gen))"
# 6. marker verification
& $verifyScript -LogPath $bootTxt -Required $Required -Forbidden $Forbidden `
-ShowTailLines $ShowTailLines
$verifyRc = $LASTEXITCODE
Write-Output "RUN_TEST_RC=$verifyRc"
exit $verifyRc