ESP-HomeKit设备固件升级后配置脚本迁移指南

问题背景

在ESP-HomeKit设备（特别是Sonoff Basics R1型号）从11.7.1版本升级到12.12.8版本后，用户遇到了设备状态显示与实际操作不一致的问题。虽然HomeKit界面显示开关状态变化，但实际设备没有响应。这个问题源于新版本对MEPLHAA脚本格式的重大变更。

新旧脚本格式对比

旧版本脚本格式（11.7.1）

{
  "c": {
    "l": 13,
    "b": [{
      "g": 0,
      "t": 5
    }]
  },
  "a": [{
    "0": {
      "r": [{
        "g": 12
      }]
    },
    "1": {
      "r": [{
        "g": 12,
        "v": 1
      }]
    },
    "b": [{
      "g": 0
    }, {
      "g": 14
    }, {
      "g": 14,
      "t": 0
    }]
  }]
}

新版本脚本格式（12.12.8）

{
  "c": {
    "io": [
      [
        [12, 13], 2
      ],
      [
        [0], 6
      ]
    ],
    "l": 13,
    "b": [
      [0, 5]
    ]
  },
  "a": [{
    "0": {
      "r": [
        [12]
      ]
    },
    "1": {
      "r": [
        [12, 1]
      ]
    },
    "b": [
      [0]
    ]
  }]
}

关键变更点解析

1. IO配置重构：新版本引入了io字段，明确指定GPIO引脚配置模式

   • [12,13],2表示GPIO12和13配置为输出模式
   • [0],6表示GPIO0配置为输入模式

2. 按钮配置简化：按钮配置从对象数组简化为二维数组

   • 旧版：{"g":0,"t":5}
   • 新版：[0,5]

3. 继电器控制优化：继电器控制指令格式变更

   • 旧版使用"g":12指定GPIO
   • 新版使用数组[12]表示

4. 动作绑定简化：动作绑定配置从复杂对象结构简化为数组结构

升级注意事项

1. 脚本兼容性：12.x版本不向下兼容旧版脚本格式，必须按照新格式重写

2. GPIO定义：新版本要求明确定义每个GPIO的输入输出模式

3. 功能验证：升级后需测试所有功能点，包括：

   • 物理按钮操作
   • HomeKit远程控制
   • 状态同步

4. 调试建议：遇到问题时，可通过串口日志检查设备启动状态和错误信息

典型配置示例

对于Sonoff Basics R1设备的标准配置：

{
  "c": {
    "io": [
      [[12], 2],  // GPIO12作为输出(继电器)
      [[13], 2],  // GPIO13作为输出(LED)
      [[0], 6]   // GPIO0作为输入(按钮)
    ],
    "l": 13,     // LED引脚
    "b": [
      [0, 5]     // 按钮配置: GPIO0, 长按5秒恢复出厂
    ]
  },
  "a": [{
    "0": {       // 按钮按下动作
      "r": [
        [12]     // 切换GPIO12(继电器)
      ]
    },
    "1": {       // 按钮释放动作
      "r": [
        [12, 1] // 确保GPIO12状态同步
      ]
    },
    "b": [
      [0]        // 绑定到GPIO0按钮
    ]
  }]
}

常见问题解决方案

1. 设备无响应：检查脚本格式是否符合新版本要求，特别是io配置部分

2. 状态不同步：验证继电器和LED的GPIO编号是否正确

3. 按钮不工作：确认按钮GPIO模式和配置是否正确

4. 设备频繁重启：可能是脚本格式错误导致，检查JSON格式和参数范围

通过理解这些变更点并正确迁移配置脚本，用户可以顺利完成ESP-HomeKit设备的版本升级，确保所有功能正常工作。