要将小米网关（例如小米多功能网关）接入 Apple HomeKit，通常需要借助第三方桥接软件，如 HomeAssistant 或 Homebridge。以下是具体步骤和代码示例（使用 HomeAssistant）：

方法一：通过 HomeAssistant (推荐)

1. 安装 HomeAssistant
   在树莓派、NAS 或服务器上部署 HomeAssistant。

2. 配置小米网关

   • 打开 HomeAssistant 的 configuration.yaml 文件，添加以下代码：

     # 启用 Xiaomi Gateway 组件
     xiaomi_aqara:
     discovery_retry: 5
     gateways:
      - key: 你的网关KEY  # 在米家APP中获取（需开启开发者模式）

   • 获取网关 KEY：

     1. 打开米家APP → 选择网关 → 右上角“...” → 关于 → 快速点击版本号进入“开发者模式”。
     2. 在开发者选项中查看 通信密钥。

3. 添加 HomeKit 桥接
   在 configuration.yaml 中继续添加：

   homekit:
    filter:
      include_entities:
        - binary_sensor.gateway_light  # 网关指示灯
        - alarm_control_panel.alarm    # 网关报警器
        - light.gateway_light          # 网关夜灯
    entity_config:
      binary_sensor.gateway_light:
        name: "网关指示灯"
      alarm_control_panel.alarm:
        name: "安防报警"
      light.gateway_light:
        name: "夜灯"

4. 重启 HomeAssistant
   重启后，在 通知 中会生成 HomeKit 配对二维码，用 iOS 家庭 APP 扫描即可接入。

方法二：通过 Homebridge

1. 安装 Homebridge
   参考官方教程 homebridge.io。

2. 安装小米插件
   在 Homebridge 中搜索插件 homebridge-xiaomi 并安装。

3. 配置插件
   在 Homebridge 的 config.json 中添加：

   {
    "platform": "XiaoMiPlatform",
    "gateways": {
        "你的网关MAC地址": "你的网关KEY"  // 格式如 "A1:B2:C3:D4:E5:F6": "abcdef1234567890"
    }
   }

   • 获取MAC地址：在米家APP → 网关设置 → 网络信息中查看。

4. 重启 Homebridge
   重启后通过家庭 APP 扫描二维码配对。

常见问题

• 如何获取网关KEY？
  需要先开启网关的开发者模式（在米家APP中快速点击网关版本号），然后在网关设置里找到通信密钥。

• 设备未显示？
  检查 YAML/JSON 中的实体名称是否正确，或尝试清除 HomeAssistant/Homebridge 缓存。

• 安全性提醒
  网关 KEY 是敏感信息，确保仅用于本地网络，避免泄露。

通过上述步骤，即可将小米网关的灯光、报警器等功能接入 HomeKit 控制。