ATC_MiThermometer设备固件升级指南：从旧版Zigbee迁移到新版

背景介绍

ATC_MiThermometer项目中的YWSD03MMC设备存在两种不同的Zigbee固件版本分支。部分设备出厂时搭载的是较新的0.1.28-3.0.01版本固件，而另一些则运行着较旧的1.1.00-3.0.01版本。这两种固件来自不同的开发者分支，导致OTA升级路径存在差异。

固件分支差异

旧版1.1.00-3.0.01固件是由开发者devbis创建的，而新版固件则是由pvvx维护的ZigbeeTLc分支。这两个固件分支在功能特性和设备参数定义上都有所不同，因此无法通过常规的OTA升级路径直接跨分支更新。

升级步骤详解

1. 准备升级文件

首先需要获取devbis固件到ZigbeeTLc固件的过渡文件。这个过渡固件版本为db15-0203-79993001-Z03MMC_v01NN.zigbee，专门设计用于将devbis的1.1.0版本迁移到ZigbeeTLc分支。

2. 执行OTA升级

通过Zigbee2MQTT的本地OTA功能进行固件升级。升级完成后，设备版本号将变为7.9.99-3.0.01，这是一个中间过渡版本。

3. 设备重新注册

升级完成后，必须执行以下关键步骤：

• 停止Zigbee2MQTT服务
• 删除设备在数据库中的IEEE地址记录（位于/zigbee2mqtt/database.db）
• 重新启动Zigbee2MQTT服务
• 重新发现并配对设备

4. 验证升级结果

成功升级后，设备应显示为1.2.7版本，并采用新版固件的参数定义和命名规范（显示为[Xiaomi]-[LYWSD03MMC-z]）。如果仍显示为[Custom devices (DiY)]-[LYWSD03MMC]，说明设备参数未被正确更新，需要检查重新注册步骤是否执行完整。

常见问题解决

1. 升级后版本显示异常：通常是由于未正确执行设备重新注册步骤导致，建议完整删除设备记录后重新配对。

2. 参数未更新：确保使用的是最新版的Zigbee2MQTT，并检查OTA索引文件是否包含最新固件信息。

3. 升级失败：检查设备电量是否充足，Zigbee网络信号强度是否足够，必要时尝试将设备靠近协调器进行升级。

技术建议

对于开发者而言，跨固件分支升级时需要注意：

• 不同分支固件的参数定义可能完全不同
• 设备信息数据库需要完全重置才能正确识别新固件特性
• 建议在升级前备份设备配置，以防意外情况发生

通过以上步骤，用户可以顺利将旧版devbis固件迁移到新版ZigbeeTLc分支，享受更完善的功能和更好的兼容性。