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