Zigbee2MQTT项目中Vibration传感器数值解析异常问题分析

问题背景

在Zigbee2MQTT 2.1.1版本中，用户使用Xiaomi Aqara振动传感器（型号DJT11LM）时，Home Assistant核心日志中出现了"Payload is not a Number"的错误提示。该问题主要发生在设备重启或Zigbee2MQTT服务重启时，当传感器"last_seen"时间戳更新时触发。

错误现象分析

错误信息显示Home Assistant的MQTT Number组件无法解析传感器发送的完整JSON数据包。原始数据包包含以下关键信息：

• 三轴加速度数据（angle_x/y/z）
• 设备温度
• 电池状态
• 振动状态
• 灵敏度设置
• 最后可见时间戳

核心问题在于MQTT Number组件期望接收纯数字格式的payload，但实际收到了完整的JSON结构数据。

根本原因

1. 组件类型不匹配：Home Assistant错误地将振动传感器配置为了Number实体，而实际上该设备应被识别为Binary Sensor或Multi-sensor设备。

2. 数据格式冲突：Zigbee2MQTT发送的是结构化数据，但HA尝试将其作为单一数值解析。

3. 自动发现机制：Zigbee2MQTT的自动发现功能可能未能正确识别设备类型。

解决方案

1. 手动修正实体类型：

   • 在Home Assistant配置文件中明确定义设备类型
   • 使用正确的MQTT主题订阅格式

2. 设备重新配置：

   • 修改设备灵敏度设置
   • 触发设备物理动作（如按下按钮或移动设备）
   • 强制设备重新发送状态报告

3. 配置检查：

   • 验证Zigbee2MQTT的设备定义文件
   • 检查HA的MQTT自动发现配置

技术建议

1. 对于复合传感器设备，建议：

   • 使用sensor.mqtt而非number.mqtt
   • 配置value_template提取特定数值字段

2. 在Zigbee2MQTT配置中，可以为特定设备添加显式定义：

   devices:
     '0x1234567890abcdef':
       friendly_name: vibration_sensor
       retain: false
       qos: 0
   

3. 对于时间戳字段，建议：

   • 在HA端使用template sensor处理
   • 或通过Zigbee2MQTT的transformations功能预处理

经验总结

1. 设备类型识别是Zigbee网络中的常见挑战，特别是对于多功能传感器。

2. 自动发现机制虽然方便，但在复杂场景下可能需要手动干预。

3. 设备状态更新时的数据格式一致性很重要，建议在设备配对后执行完整的测试流程。

4. 对于Xiaomi Aqara系列设备，物理交互（按钮操作）往往是解决通信问题的有效手段。

该案例展示了Zigbee设备集成中类型识别的重要性，也提醒开发者在处理复合传感器时需要特别注意数据格式的兼容性问题。