sensor-calibration-workbench

用途

Sensor Calibration Workbench 用于传感器“能工作但读数不够可信”的场景。它面向创客，覆盖 CO₂ 传感器、称重传感器、磁力计、颜色传感器以及模拟传感器的校准工作流，涉及预热行为、参考测量、系数存储与漂移检查。

如果传感器完全检测不到，不应使用本技能，而应优先走硬件或总线启动流程。

主要能力

技能提供三份参考资源：

• references/calibration-flow.md：端到端校准工作流与证据清单。
• references/common-failure-patterns.md：预热、缩放、漂移、饱和与环境方面的常见错误。
• references/persistence-and-revalidation.md：如何存储系数，以及何时需要重新校准。

适用请求包括：读数波动或不合常理；“这个传感器怎么校准”；称重传感器系数调整；CO₂、磁力计或颜色传感器校准；把校准系数存入 EEPROM 或 flash；判断问题出在校准、硬件还是环境。

使用方式

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

核心规则

• 没有已知参考的校准只是猜测。
• 预热与稳定时间是校准的一部分，不是附带事项。
• 不要把硬件故障症状与系数调整症状混为一谈。
• 同时保存校准值和足够的元数据，以判断它们何时过期。

验证

• 确认校准后读数向已知参考收敛。
• 确认校准值在重复采样中保持稳定。
• 确认重启后存储的系数能正确重新加载。
• 如果项目有运行阈值，用校准后的输出而不是原始传感器值来验证这些阈值。

集成

• 传感器电气上尚不可信时，配合 i2c-bringup-diagnostician 或 circuit-debugger 使用。
• 用户需要为 sketch 添加持久化或滤波代码时，配合 arduino-code-generator 使用。
• 传感器行为仅在脱离 USB 或现场供电条件下变化时，配合 field-power-and-connectivity-triager 使用。

共享输出约定

使用共享 Arduino 技能约定（../../docs/arduino-skill-contract.md）：说明假设、所需工具与版本、实现步骤、按证明阶段划分的测试/证据、已知限制，以及恢复/安全说明。

限制

官方资料未提供具体的价格、收费方式或平台支持信息。本技能不适用于传感器完全无法检测的情况。具体参考文档内容暂未提供完整正文。