Skip to main content

通过 XIAO ESP32C6 的 Zigbee 连接到 Home Assistant

note

本文档由 AI 翻译。如您发现内容有误或有改进建议，欢迎通过页面下方的评论区，或在以下 Issue 页面中告诉我们：https://github.com/Seeed-Studio/wiki-documents/issues

将 Zigbee 设备集成到智能家居生态系统中越来越受欢迎，因为 Zigbee 具有低功耗、高可靠性和易用性。在本教程中，我们将指导您通过 XIAO ESP32C6 的 Zigbee 功能连接到 Home Assistant。完成本教程后，您将能够实现一个演示，其中 XIAO ESP32C6 作为一个 Zigbee 设备，可以直接从 Home Assistant 的仪表盘进行控制。

本教程重点介绍了 Espressif 的 Zigbee SDK (Arduino)，并演示如何开发和集成您自己的 Zigbee 设备到 Home Assistant。

所需材料​

要完成本教程，您需要以下物品：

  1. Home Assistant Green：用于管理智能家居的专用 Home Assistant 硬件设备。
  2. Home Assistant Connect ZBT-1：一个 Zigbee 协调器，用于创建 Zigbee 网络并实现通信。
  3. XIAO ESP32C6：一个开发板，通过 Espressif 的 SDK 启用了 Zigbee 功能。
Home Assistant Connect ZBT-1XIAO ESP32C6Home Assistant Green
立即购买 🖱️
立即购买 🖱️
立即购买 🖱️

分步指南​

tip

前两步参考 Home Assistant Connect ZBT-1 的官方教程，您也可以通过以下链接阅读其教程内容。

Home Assistant Connect ZBT-1 教程

第一步：在 Home Assistant Green 上安装 Connect ZBT-1​

将 Home Assistant Connect ZBT-1 插入 USB 延长线。然后将延长线插入您的 Home Assistant Green。

caution

USB 3.0 端口和 USB 3.0 驱动器可能会干扰 2.4 GHz 协议，包括 Home Assistant Connect ZBT-1 提供的协议。因此，务必使用 USB 延长线，并将 Home Assistant Connect ZBT-1 远离可能的干扰源。

  1. 在 Home Assistant 界面中导航到 Settings。
  2. 转到 Devices & Services 并找到 Zigbee 集成。
  3. Connect ZBT-1 应该已经被发现。
  1. 选择 ADD。
  2. 在对话框中选择 Zigbee。
  1. 选择 Submit 完成 Connect ZBT-1 集成的设置。
  1. 您的 Connect ZBT-1 现在是一个 Zigbee 协调器。

第二步：使用 Connect ZBT-1 创建一个新的 Zigbee 网络​

  1. 在 Home Assistant 界面中导航到 Settings。
  2. 转到 Devices & Services 并找到 Zigbee 集成。
  3. Connect ZBT-1 将显示在您的 Zigbee Home Automation 集成中。选择 ADD。
  1. 确认后选择 Submit。
  1. 选择 Create network。
  1. 按照提示初始化 Zigbee 协调器，并准备与 Zigbee 设备配对。

第三步：使用 Zigbee 示例程序刷写 XIAO ESP32C6​

  1. 设置 Arduino IDE：
  • 安装最新版本的 Arduino IDE，并通过添加 Espressif 板包支持 XIAO ESP32C6。
note

如果您是第一次使用 XIAO ESP32C6，请阅读以下链接中的教程以正确添加开发板。

入门指南：XIAO ESP32C6​

2. 加载 Zigbee_On_Off_Light 示例​

  • 请选择正确的开发板型号：XIAO_ESP32C6。
  • 在 Arduino IDE 中打开 Zigbee_On_Off_Light 示例。

我们建议您使用最新的 esp32-arduino 板载包，以获取最新和最稳定的 Zigbee 示例程序。 :::

  • 在此示例中，我们将使用 XIAO ESP32C6 上的板载 LED 单色灯，因此需要对程序中的 LED 引脚进行修改。将代码中的 RGB_BUILTIN 替换为 LED_BUILTIN，以使用板载 LED 指示灯。

3. 配置 Zigbee 设置​

  • 将 Zigbee 模式设置为 ZIGBEE_MODE_ED（终端设备）。
  • 调整 Zigbee 的分区方案：
    进入 Tools -> Partition Scheme，选择 Zigbee 4MB with spiffs。

4. 上传程序​

  • 使用 USB-C 数据线将 XIAO ESP32C6 连接到您的计算机。
  • 编译并上传修改后的示例程序到 XIAO ESP32C6。
  • 如果 XIAO 正常工作，您将看到如下所示的串口消息。如果设备不断重启，请检查 Zigbee 设置是否正确，或者更新开发板的板载包版本。

第四步：在 Home Assistant 中发现 XIAO ESP32C6​

  1. 在 Home Assistant 界面中，导航到 Settings -> Devices & Services。
  2. 选择 Zigbee 集成（名称：ZHA）。
  1. 点击 Nabu Casa HA Connect ZBT-1。
  1. 在 Connect ZBT-1 的设备详情页面中，您可以看到 ADD DEVICE VIA THIS DEVICE，点击它进入 Zigbee 的设备发现和配对页面。
  1. 等待片刻，XIAO ESP32C6 将出现在发现的 Zigbee 设备列表中。

您可以在此页面为设备设置名称和位置。

  1. 然后，您可以在 ZHA 的设备页面找到此设备，并将其实体添加到仪表板中。

第五步：将 XIAO ESP32C6 添加到 仪表板​

  1. 一旦 XIAO ESP32C6 被发现，将其添加到您的 Home Assistant 仪表板中。
  2. 您现在可以直接从 Home Assistant 控制 XIAO ESP32C6（例如，切换板载 LED）。

结论​

Espressif 提供了多种 Zigbee 设备类型和丰富的 Zigbee SDK，使开发者能够轻松创建自己的 Zigbee 设备。通过本教程，您已经学习了如何使用 Zigbee 将 XIAO ESP32C6 集成到 Home Assistant 中，为您的智能家居生态系统添加自定义设备。

借助 Espressif 的 Zigbee SDK 的灵活性，您可以开始为各种应用和功能构建自己的 Zigbee 设备，并将它们无缝添加到 Home Assistant 中进行集中控制。祝您开发愉快！

技术支持与产品讨论​

感谢您选择我们的产品！我们为您提供多种支持渠道，以确保您使用我们的产品时体验顺畅。我们提供多种沟通方式，以满足不同的偏好和需求。

Loading Comments...