AWTRIX-LIGHT温度传感器偏移值配置问题解析

问题背景

在AWTRIX-LIGHT智能像素时钟项目中，用户反馈温度传感器读数存在偏差问题。主要表现为：

1. 原始温度读数比实际值低约9°C（这是硬件设计导致的固有偏差）
2. 用户尝试通过dev.json配置文件中的temp_offset参数进行校准，但出现异常情况

技术原理

AWTRIX-LIGHT设备使用内置温度传感器进行环境监测，但由于硬件特性，原始读数存在系统性偏差。项目设计了temp_offset参数用于软件校准，其工作特点是：

• 默认预设值为+9，用于补偿硬件固有偏差
• 最终显示温度 = 原始读数 + temp_offset值
• 参数通过dev.json配置文件进行修改

典型问题现象

1. 校准值理解错误：用户误以为偏移值是相对于当前显示的差值，实际上是对原始读数的补偿
2. 配置文件未生效：常见于JSON格式错误或设备未重启
3. 数值突变：当用户设置temp_offset=1时，实际显示增加10°C，这是因为默认9°C补偿叠加导致

解决方案

1. 正确计算偏移值：

   • 若当前显示29°C而实际为21°C
   • 需要设置 temp_offset = 21 - (29 - 9) = 1
   • 即：temp_offset = 实际温度 - (显示温度 - 默认偏移9)

2. 配置文件规范：

{
  "temp_offset": 1,
  "hum_offset": 0
}

3. 操作要点：
   • 使用纯文本编辑器修改dev.json
   • 确保无多余空格或格式错误
   • 修改后必须重启设备生效
   • 可通过MQTT页面执行"重启ESP"操作

进阶建议

1. 建议先测量实际环境温度作为基准
2. 进行多次校准测试，逐步调整offset值
3. 考虑环境因素对传感器的影响（如设备发热）
4. 新版本(v0.96+)已优化配置加载机制

总结

AWTRIX-LIGHT的温度校准需要理解其"原始读数+偏移值"的工作机制。通过正确配置dev.json文件，用户可以准确补偿硬件偏差，获得可靠的环境温度数据。遇到配置不生效的情况时，应重点检查JSON格式规范性和设备重启流程。