前置条件与资源准备：硬件环境、软件版本、工具链清单、网络条件

适用场景

以下场景必须执行本章前置条件检查流程：

• 实验室首次搭建：新采购或新组装的硬件平台首次用于OTA升级验证。
• 新项目启动：产品基线变更（芯片平台、通信模组、存储分区方案变化）后的首次边界验证。
• 硬件平台切换：从开发板切换至量产板，或从A供应商模组切换至B供应商模组。
• 回归环境重建：因服务器搬迁、网络重构、工具链升级等原因需要重建验证环境。
• 外部评审前检查：在提交TR2/TR3评审前，需输出环境就绪报告作为评审附件。

前置条件

在执行本章资源准备工作之前，必须已达成以下条件：

操作步骤

按照以下5个步骤依次执行，每步完成后须在《资源准备检查清单》中标记状态。

1. 确认硬件环境
   核对目标设备型号、数量、硬件版本、存储分区布局是否与需求文档一致。重点确认：
   
   • 设备是否处于出厂默认状态或已知基线状态；
   • 串口/JTAG/SWD调试接口可正常连接；
   • 测试夹具（如电源工装、信号注入工装）已就位。
2. 核对软件版本
   读取设备当前固件版本，与版本发布说明中的基线版本号比对。所有依赖组件（Bootloader、TrustZone、文件系统、AT固件）必须使用锁定的版本号。
   版本一致性记录格式示例：

   {
     "device_id": "EVB-OTA-2024-001",
     "current_firmware": "v2.1.3+build20241105",
     "target_firmware": "v2.2.0-rc1+build20241201",
     "bootloader": "bl_v1.4.2",
     "trustzone": "tz_v3.0.1",
     "filesystem": "ubifs_2024.10",
     "modem_fw": "MDM_6.2.8"
   }

3. 准备工具链清单
   根据项目技术栈准备以下工具，并记录版本号：
   
   • 编译工具链：gcc-arm-none-eabi / riscv64-unknown-elf-gcc 等，版本需与CI/CD流水线一致；
   • 烧录/调试工具：OpenOCD、JLinkExe、STM32CubeProgrammer 等；
   • 验证脚本套件：OTA升级压力脚本、异常注入脚本、日志解析脚本。所有脚本需通过代码审查并纳入Git管理。
4. 检查网络条件
   执行以下验证项，确保OTA升级链路通畅：
   
   • 目标设备与OTA服务器之间的路由可达；
   • 防火墙已放行升级端口（默认443/8080，以项目实际为准）；
   • 带宽 ≥ 升级包大小 × 2 的实测吞吐量，测试命令：

   # 检查网络连通性
   ping -c 10 ota-update.internal.company.com
   
   # 测试HTTP下载速度（模拟升级包下载）
   curl -o /dev/null -w "Speed: %{speed_download} bytes/sec\n" \
     http://ota-update.internal.company.com/test_10mb.bin
   
   # 检查MTU是否适配（避免分包导致升级失败）
   ping -M do -s 1472 ota-update.internal.company.com

5. 签署环境就绪报告
   汇总以上四类检查结果，生成《环境就绪报告》，由测试负责人、硬件负责人、DevOps 三方签字确认。

输入输出物

责任边界

记录材料

本章执行过程中必须同步填写以下记录表，作为环境就绪的客观证据：

• 《资源准备检查清单》（R-P-CKL-002）—— 涵盖硬件、版本、工具链、网络四类共20项检查条目，每项标记 Pass/Fail/NA；
• 《软件版本一致性确认表》（R-VER-003）—— 记录设备当前版本、目标版本、所有依赖组件的版本哈希值；
• 《网络条件测试记录》（R-NET-001）—— 包含ping延迟、下载速度、MTU测试、防火墙规则验证结果；
• 《环境就绪报告》（R-ENV-001）—— 汇总以上所有记录，包含三方签字和日期。

异常处理

验收标准

本章全部工作完成时，必须同时满足以下验收条件：

1. 全项通过：《资源准备检查清单》20项检查条目100%标记为 Pass（NA项需在备注中说明原因并获测试负责人批准）；
2. 版本一致：设备当前固件版本、目标固件版本、所有依赖组件版本与《版本发布说明》完全一致，SHA256校验和均匹配；
3. 工具链可用：编译工具链可正常编译最小固件工程，烧录工具可成功烧录目标设备，验证脚本可无错误运行一次全量回归；
4. 网络达标：OTA服务器连通性100%成功，下载速度 ≥ 2 MB/s（或项目规定阈值），防火墙规则无冗余拦截；
5. 签字完整：《环境就绪报告》已获得硬件工程师、版本管理员、DevOps工程师、网络管理员、测试负责人五方签字，日期均在本章工作完成当天。

关键检查清单速查

以下表格汇总了四类资源中最容易被遗漏的检查项，建议打印张贴在工位：