zhoujie
c347c988f2
- 新增 Mini212G2 传感器预配置指南文档，详细说明外部工具配置步骤
- 修复 DVP 头文件中的 SENSOR_TOTAL_LINES 定义，移除冗余行数
- 在 README 和模式配置文档中添加预配置指南的引用链接
- 新增 OpenSpec 变更记录，包含设计文档、提案、规格和任务清单
📦 build(openspec): 新增传感器预配置规范文档结构
- 在 openspec/changes/archive/ 下创建 2026-03-15-dvp-raw-data-pipeline 变更记录
- 包含设计文档、提案、规格说明和任务清单
- 在 openspec/specs/ 下创建 sensor-preconfig-guide 规格文档
46 lines
2.8 KiB
Markdown
46 lines
2.8 KiB
Markdown
## ADDED Requirements
|
||
|
||
### Requirement: 提供 Mini212G2 传感器预配置操作指南
|
||
操作指南文档（`Doc/Mini212G2预配置指南.md`）SHALL 明确说明在使用 MCU 固件采集前，必须通过外部工具完成的所有 Mini212G2 参数配置步骤、对应串口命令 HEX 及原因说明。
|
||
|
||
#### Scenario: 工程师查阅配置步骤
|
||
- **WHEN** 工程师准备部署传感器时
|
||
- **THEN** 文档 SHALL 提供编号的步骤列表，包含每步的操作内容和串口命令
|
||
|
||
#### Scenario: 工程师查找特定参数的命令 HEX
|
||
- **WHEN** 工程师需要向传感器发送配置命令时
|
||
- **THEN** 文档 SHALL 包含完整的命令 HEX 汇总表，包含参数名称、命令 HEX、说明三列
|
||
|
||
### Requirement: 强制配置 CMOS 内容为 TMP 模式
|
||
指南 SHALL 要求 CMOS 内容配置为 **TMP**（不是 Y16），并说明原因：MCU 代码将像素值直接当温度使用（0.1°C/LSB），这是 TMP 模式输出的格式，而非 Y16 原始 ADC 值。
|
||
|
||
#### Scenario: 工程师理解为何必须选 TMP 而非 Y16
|
||
- **WHEN** 工程师阅读 CMOS 内容配置步骤时
|
||
- **THEN** 文档 SHALL 解释：TMP 输出的 16-bit 值直接是温度（传感器内部已完成定标），Y16 是原始 ADC 计数值需另行温度解算；代码假设的 0.1°C/LSB 就是 TMP 格式
|
||
|
||
#### Scenario: 工程师误选了 Y16 模式
|
||
- **WHEN** 工程师将传感器 CMOS 内容配置为 Y16 时
|
||
- **THEN** 所有温度判断将得到错误结果（原始 ADC 值被当做温度），但系统不会报错；文档 SHALL 以 ⛔ 警告标注此风险
|
||
|
||
### Requirement: 提供 TMP 模式温度格式联调验证方法
|
||
指南 SHALL 提供至少一种可操作的现场验证方法，使工程师能确认 TMP 模式输出的 16-bit 值就是 0.1°C/LSB 格式。
|
||
|
||
#### Scenario: 验证 TMP 输出格式正确
|
||
- **WHEN** 工程师首次联调时
|
||
- **THEN** 文档 SHALL 提供通过已知温度目标对比中心像素原始值的验证步骤，预期中心像素均值约等于实际温度 × 10（如 25°C 对应 250）
|
||
|
||
#### Scenario: 验证结果与预期不符
|
||
- **WHEN** 工程师发现像素值不符合 0.1°C/LSB 预期时
|
||
- **THEN** 文档 SHALL 列出常见错误值对应的可能原因（如配置为 Y16 模式，或 MSB 字节序错误）并说明如何排查
|
||
|
||
### Requirement: 从入口文档链接至预配置指南
|
||
`README.md` 和 `Doc/模式配置与功能说明.md` SHALL 包含指向 `Doc/Mini212G2预配置指南.md` 的可导航链接。
|
||
|
||
#### Scenario: 工程师从 README 进入预配置指南
|
||
- **WHEN** 工程师阅读 README 参考文档章节时
|
||
- **THEN** 文档列表中 SHALL 存在指向预配置指南的条目
|
||
|
||
#### Scenario: 工程师从模式配置文档进入预配置指南
|
||
- **WHEN** 工程师阅读模式配置文档的传感器相关章节时
|
||
- **THEN** 相关位置 SHALL 有注释或链接指向预配置指南
|