83 lines
3.5 KiB
Markdown
83 lines
3.5 KiB
Markdown
# <产品/板卡> <功能> 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. 已知限制
|
||
|
||
<未验证项、只做了部分验证的项、测试环境的异常、工具里的开发机路径等。>
|