NOTES

模块 005：板级构建、采集与归档

这一层把 HLS/Vitis 产物与 PS 应用组织成可在 ZCU106 上启动和观察的工作流。它不计算模型数值；它负责构建物、串口、报告目录和归档文件。

Qwen2.5/modules/005_board_execution.md 2026-07-13 约 3 分钟阅读

职责

这一层把 HLS/Vitis 产物与 PS 应用组织成可在 ZCU106 上启动和观察的工作流。它不计算模型数值；它负责构建物、串口、报告目录和归档文件。

主要接口

脚本/目录	输入	输出	功能
`ZCU106/hls//hls_config.cfg`	kernel、testbench、Vitis HLS 配置	CSim/cosim/csynth 工作目录	配置独立 kernel 的 HLS 运行。
`ZCU106/vitis/`	XSA、PS app source、BSP 配置	A53 ELF	生成 bare-metal 应用构建物。
`ZCU106/scripts/prepare_q25_nl_board_bundle.ps1`	ELF、XSA、模型/tokenizer 载荷	board bundle	准备给板级流程使用的文件集合。
`ZCU106/scripts/prepare_q25_nl_boot_image.ps1`	FSBL、PMUFW、bitstream、应用	boot image	组装启动映像。
`ZCU106/scripts/capture_q25_nl_uart.ps1`	COM 端口、输出文件	transcript 文本	采集串口数据。
`ZCU106/scripts/validate_nl_uart_transcript.py`	transcript、模式	validation JSON	验证协议标记。
`ZCU106/scripts/archive_q25_nl_board_acceptance.ps1`	transcript、bundle、SD 目录	archive	归档一次板级运行。
`ZCU106/scripts/run_q25_nl_board_acceptance.ps1`	参数集	runner manifest	串接 preflight、采集、归档和归档验证。

Board acceptance runner 流程

flowchart TD
    A[ReportDir] --> B{SkipPreflight?}
    B -->|否| C[run_q25_nl_board_preflight.ps1]
    B -->|是| D[选择 transcript]
    C --> D
    D --> E{Capture?}
    E -->|是| F[capture_q25_nl_uart.ps1]
    E -->|否| G[使用 -Transcript 文件]
    F --> H[archive_q25_nl_board_acceptance.ps1]
    G --> H
    H --> I[verify_q25_nl_accepted_archive.ps1]
    I --> J[board_acceptance_runner_manifest.json]

流程或关系图。

UART transcript 验证

验证器提供三种模式。

模式	必需标记
`token`	`NL_INFO`、`NL_PROMPT_IDS`、`NL_GENERATE`、`NL_RESULT_IDS`
`text`	`TEXT_PROMPT`、`TEXT_GENERATE`、`TEXT_RESULT`
`both`	两组标记的并集

验证器还记录 TEMPLATE_ONLY 和 SYNTHETIC_HOST_ONLY 标记。没有相应 allow 参数时，这两种 transcript 不作为板级 transcript 通过。