ATC_MiThermometer固件升级后设置丢失问题分析与解决

问题背景

在使用ATC_MiThermometer项目中的LYWSD03MMC-z温湿度传感器时，用户遇到了固件升级后设备设置丢失的问题。具体表现为：

1. 设备校准设置被重置
2. 显示屏图标（笑脸）被重新启用
3. 无法通过Zigbee2MQTT修改任何设置参数

错误现象分析

用户在尝试通过Zigbee2MQTT修改显示屏图标设置时，系统返回了以下关键错误信息：

ZCL command failed: Cannot write USE_DATA_TYPE without dataType option specified

这个错误表明Zigbee通信协议层在尝试写入配置参数时遇到了数据类型不匹配的问题。错误发生在HVAC用户界面配置(hvacUserInterfaceCfg)的写入操作中。

问题根源

经过深入分析，发现问题主要由以下两个因素导致：

1. 过时的转换器使用：用户之前使用了为旧版本固件设计的转换器(converter)，这些转换器与新固件版本不兼容。

2. 固件版本升级路径：从3001-0120或3001-0121版本升级到3001-0123版本时，如果不移除旧转换器，会导致配置接口不兼容。

解决方案

1. 移除旧版转换器：

   • 删除为旧版固件(pvvx/ZigbeeTLc v0.1.2.1或devbis-Firmware)设计的转换器
   • 使用新版固件自带的原生配置接口

2. 正确的固件升级步骤：

   • 对于运行3001-0120或3001-0121版本的设备：
     • 先移除转换器
     • 再升级到3001-0123版本
   • 升级完成后，建议重新插拔电池以确保设备完全重置

3. 验证操作：

   • 升级后，通过Zigbee2MQTT界面验证能否正常修改显示屏图标设置
   • 检查温湿度校准功能是否正常工作

技术建议

1. 固件升级注意事项：

   • 在升级前备份当前设备配置
   • 一次只升级一个设备作为测试
   • 确保升级过程中不断电

2. Zigbee2MQTT配置优化：

   • 定期检查并更新设备转换器
   • 对于标准ZCL(Zigbee Cluster Library)设备，优先使用原生支持而非外部转换器

3. 设备恢复方法：

   • 如遇升级失败，可尝试以下步骤：
     1. 移除电池等待30秒
     2. 重新插入电池
     3. 检查设备是否重新加入网络

总结

通过移除过时的转换器并采用正确的固件升级流程，用户成功解决了LYWSD03MMC-z设备在升级后设置丢失的问题。这一案例提醒我们，在物联网设备固件升级过程中，兼容性检查和适当的准备工作至关重要。对于使用Zigbee2MQTT管理的设备，保持转换器与固件版本的同步是确保功能正常的关键因素。