ch32v307_camera/spec.md at main

zhoujie c347c988f2 📝 docs(dvp): 更新传感器预配置文档并修复行数定义

- 新增 Mini212G2 传感器预配置指南文档，详细说明外部工具配置步骤
- 修复 DVP 头文件中的 SENSOR_TOTAL_LINES 定义，移除冗余行数
- 在 README 和模式配置文档中添加预配置指南的引用链接
- 新增 OpenSpec 变更记录，包含设计文档、提案、规格和任务清单

📦 build(openspec): 新增传感器预配置规范文档结构

- 在 openspec/changes/archive/ 下创建 2026-03-15-dvp-raw-data-pipeline 变更记录
- 包含设计文档、提案、规格说明和任务清单
- 在 openspec/specs/ 下创建 sensor-preconfig-guide 规格文档

2026-03-15 18:03:55 +08:00

2.8 KiB

Raw Permalink Blame History

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 有注释或链接指向预配置指南

2.8 KiB Raw Permalink Blame History Unescape Escape