deconz-rest-plugin 项目：Xiaomi MHO-C401 温湿度传感器集成指南

设备概述

Xiaomi MHO-C401 是一款多功能环境监测设备，原厂固件仅支持蓝牙连接。但通过社区开发的定制 Zigbee 固件，用户可以将该设备接入 Zigbee 网络，实现与 deCONZ 平台的集成。这款设备能够精确测量环境温度和湿度，适用于智能家居环境监测场景。

技术规格

• 制造商：Xiaomi（米家）
• 设备型号：MHO-C401
• 通信协议：Zigbee（需刷写定制固件）
• 传感器类型：温度传感器 + 湿度传感器
• 电源：纽扣电池供电（低功耗设计）

固件刷写说明

要将蓝牙版设备转换为 Zigbee 版本，需要执行以下步骤：

1. 使用 Telink Flasher 工具（专为 MI 恒温器开发的刷机工具）
2. 刷写社区开发的定制 Zigbee 固件
3. 设备将重新启动并进入 Zigbee 配对模式

deCONZ 集成配置

设备在 deCONZ 中会显示以下关键信息：

• 节点信息：包含设备的基本连接状态和网络信息
• 端点：设备使用端点 1 进行所有通信
• 集群：
  • 基础集群（0x0000）
  • 电源配置集群（0x0001）
  • 温度测量集群（0x0402）
  • 湿度测量集群（0x0405）

DDF 配置文件解析

为了实现设备在 deCONZ 中的完整功能，需要创建专用的 DDF（设备描述文件）。以下是关键配置要点：

温度传感器配置

{
  "type": "ZHATemperature",
  "restapi": "/sensors",
  "uuid": ["$address.ext", "0x01", "0x0402"],
  "config": {
    "battery": {
      "parse": {
        "at": "0x0021",
        "cl": "0x0001",
        "eval": "Item.val = Attr.val / 2"
      }
    }
  }
}

湿度传感器配置

{
  "type": "ZHAHumidity",
  "restapi": "/sensors",
  "uuid": ["$address.ext", "0x01", "0x0405"],
  "config": {
    "battery": {
      "parse": {
        "at": "0x0021",
        "cl": "0x0001",
        "eval": "Item.val = Attr.val / 2"
      }
    }
  }
}

绑定配置

为确保设备数据能够定期上报，需要配置以下绑定：

1. 电源配置集群（0x0001）的单播绑定
2. 温度测量集群（0x0402）的单播绑定
3. 湿度测量集群（0x0405）的单播绑定

使用注意事项

1. 电池寿命：设备采用纽扣电池供电，优化后的绑定配置可延长电池寿命
2. 数据更新频率：默认配置下，设备会每隔几分钟更新一次数据
3. 校准：DDF 中包含了 offset 配置项，可用于校准传感器数据
4. 唤醒：设备大部分时间处于睡眠状态，仅在数据传输时短暂唤醒

性能优化建议

1. 根据实际需要调整数据上报频率
2. 定期检查电池状态（通过电源配置集群）
3. 在稳定的 Zigbee 网络环境中使用设备
4. 避免将设备放置在信号干扰严重的区域

通过以上配置，Xiaomi MHO-C401 可以完美融入 deCONZ 生态系统，为用户提供可靠的环境监测数据。这种定制方案不仅扩展了设备的功能性，还保持了 Xiaomi 设备一贯的高精度测量特性。