<产品/板卡> <功能> Release <版本>

<一句话：平台（Zynq-7000 型号 + 其它处理器）、本版本的功能要点。>

本包内容对应工程 <git 仓库/路径> 的 tag <tag>，<日期> 在 <哪块板> 上实测：<验收结论，逐项>。每个文件的完整 SHA-256 见 00_SHA256SUMS，部署后请逐个读回核对。 <若有发布需求文档（如 Notes/PRxx.md），写明按哪一份制作，以及哪些内容按要求不在包内。>

1. 目录

目录	需求项	内容
`01_petalinux_bsp/`	BSP	<正式系统 .bsp>、<救援系统 .bsp>，PetaLinux <版本>
`02_qspi_flash/`	QSPI 烧写文件	BOOT.BIN、image.ub.qspi、`qspi_full_0x0.bin`、`uboot_scripts/`
`03_emmc_flash/`	eMMC/SD 烧写文件	`p1_boot_fat/`、`emmc_deploy.sh`、`EMMC_SHA256SUMS`、原始已验证脚本
`04_rootfs/`	rootfs	`<名>_rootfs.tar.gz`（最终合成），合成脚本与 spec
`05_pl_bit/`	PL bit	`<top>.bin`（板上加载的）、同次构建 `.bit` / `.hdf`（或 `.xsa`）
`06_ps_runtime/`	PS 运行文件	应用、初始化脚本、配置、内核模块、运行数据
`07_ps_app_src/`	PS app 源码	应用源码 + PetaLinux meta-user 层
`08_<mcu>_app_src/`	其它处理器源码	<可选>
`09_<mcu>_runtime/`	部署所需	<可选>
`10_pc_tools/`	可选	PC 端验证工具
`README.md`	说明	本文件

2. 版本清单

层	文件	板上位置
QSPI	BOOT.BIN（FSBL + U-Boot <配置>）	QSPI 0x0
QSPI	image.ub.qspi（救援）	QSPI <偏移>
启动分区	image.ub	/image.ub
启动分区	.bin（PL）	/
根分区	.tar.gz	/
rootfs	<应用 / 配置，逐个列出>

工具链：PetaLinux <版本>，Vivado <版本>，<交叉编译器>。

3. 存储布局

QSPI（sf）：

偏移	长度	内容
0x000000		BOOT.BIN，CRC32
<环境区>		U-Boot 环境区，保持擦除（全 0xFF），使用默认 bootcmd
<内核区>		image.ub.qspi，CRC32

qspi_full_0x0.bin：上表按偏移拼好的整片镜像，空隙填 0xFF，从 0x0 写入；长度 <>，CRC32 <>。
默认 bootcmd = <...>；救援启动命令：<...>。

eMMC/SD（<设备>，<容量>，<分区表类型>）：

分区	扇区	文件系统	内容

4. 部署步骤（全新 / 出厂状态的板子）

准备：
- 先备份出厂内容（QSPI、eMMC、其它处理器）；
- 串口参数；
- PC 上的 TFTP / HTTP 服务；
- 默认网络地址表。
QSPI：二选一，U-Boot 脚本或编程器写整片镜像。
eMMC：
- 进入救援 Linux，执行 sh emmc_deploy.sh <PC_IP> [--partition]。
- 若该脚本未在板上整体跑过，在此明确写出来。
<其它处理器> 部署。
冷启动与验收：寄存器 / 日志 / 网页 / 业务功能，逐项写出期望值。

5. 现场相关设置（换环境必须改）

<每板唯一值（MAC、序列号、校准/DPD 曲线），以及站点值（IP、接收端 MAC/IP），逐个写出所在文件和处理方法。>

6. <本版本的主要功能说明>

7. 从源码构建

8. 已知限制

<未验证项、只做了部分验证的项、测试环境的异常、工具里的开发机路径等。>

3.5 KiB Raw Blame History Unescape Escape