# <产品/板卡> <功能> 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. 版本清单

| 层 | 文件 | 板上位置 | sha256 前 16 位 |
|---|---|---|---|
| QSPI | BOOT.BIN（FSBL + U-Boot <配置>） | QSPI 0x0 | |
| QSPI | image.ub.qspi（救援） | QSPI <偏移> | |
| 启动分区 | image.ub | /image.ub | |
| 启动分区 | <top>.bin（PL） | / | |
| 根分区 | <rootfs>.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. 部署步骤（全新 / 出厂状态的板子）

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

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

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

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

## 7. 从源码构建

<BSP → petalinux-create -s / build / package --boot；应用单独编译与单元测试；rootfs 重新合成方法；BSP 的 hw-description 与发布 bit 的关系。>

## 8. 已知限制

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