sensor-calibration-workbench

传感器校准工作台

当传感器在技术上可以正常工作，但读数还不够可靠，无法用于项目时，请使用此技能。

资源

• references/calibration-flow.md - 端到端校准工作流和证据检查清单
• references/common-failure-patterns.md - 预热、缩放、漂移、饱和和环境问题
• references/persistence-and-revalidation.md - 存储系数以及判断何时需要重新校准

使用时机

当请求涉及以下情况时，请使用此技能：

• 传感器读数不稳定或不合理
• “如何校准这个传感器？”
• 称重传感器系数调校
• CO2、磁力计或颜色传感器校准
• 将校准系数存入 EEPROM 或闪存
• 判断问题出在校准、硬件还是环境

如果完全检测不到传感器，请勿使用此技能。此时应先通过硬件或总线初始化流程进行排查。

工作流

1. 确认测量问题：
   • 不稳定 -> 打开 references/common-failure-patterns.md
   • 偏移或缩放误差 -> 打开 references/calibration-flow.md
   • 读数起初正常，之后变差 -> 打开 references/persistence-and-revalidation.md
2. 确定校准类别：
   • 单点或零偏校准
   • 两点比例校准
   • 多方向或环境校准
3. 在更改系数前收集参考证据：
   • 已知参考值
   • 预热状态
   • 环境条件
   • 样本稳定性
4. 确定校准值的持久化方式，以及在重启、固件更新或现场漂移后如何触发重新验证。

核心规则

• 没有已知参考值的校准只是猜测。
• 预热和稳定时间是校准的一部分，不是附带说明。
• 不要把硬件故障症状与系数调校症状混为一谈。
• 同时存储校准值及足够的元数据，以便判断这些值何时会过时。

验证

• 确认校准后读数会逐渐接近已知参考值。
• 确认校准值在重复采样时保持稳定。
• 确认重启后能正确重新加载已存储的系数。
• 如果项目设有运行阈值，请根据校准后的输出而非原始传感器值验证这些阈值。

集成

• 当传感器的电气状态尚不可靠时，与 i2c-bringup-diagnostician 或 circuit-debugger 配合使用。
• 当用户需要在草图中添加持久化或滤波代码时，与 arduino-code-generator 配合使用。
• 当传感器行为仅在脱离 USB 或使用现场电源时发生变化，与 field-power-and-connectivity-triager 配合使用。

共享输出约定

请使用共享 Arduino 技能约定：说明假设、所需工具和版本、实现步骤、各证明阶段的测试/证据、已知限制，以及恢复/安全注意事项。