SwitchC6 Home Assistant 集成

本章节介绍将 SwitchC6 单火线开关控制器集成至 Home Assistant 的配置方法与实操步骤。

准备工作

Home Assistant 主机。
在 Home Assistant 中安装并启用 ESPHome Builder。

注意事项

在本教程中，固件使用 ESPHome 2025.12.5 进行编译和上传。如果遇到编译 / 上传问题，请考虑将 ESPHome 切换到此版本。

创建设备

创建新设备。
1.1 点击右下角的绿色按钮创建设备。
创建设备名称。
2.1 点击 CONTINUE。

2.2 点击 New Device Setup。

2.3 输入设备名称并点击 NEXT。
选择设备类型。

提示

这里我们使用 Atom-Lite 作为主控制器来操作 SwitchC6 继电器开关。
3.1 点击 ESP32。

3.2 点击 SKIP。
开始编辑 YAML 文件。点击 EDIT。我们可以通过 YAML 文件自定义设备功能。

设备配置

以下是代码的核心部分，同时提供了相关参考和说明。

外部组件配置

添加 External 组件：

external_components:
  - source: github://m5stack/esphome-yaml/components
    components: m5stack_switchc6
    refresh: 0s 

ESPNOW 配置

添加 ESPNOW 组件：

espnow:
  id: espnow1
  auto_add_peer: true
  peers:
    - XX:XX:XX:XX:XX:XX
  on_broadcast:
    - lambda: |-
        id(sw1).handle_broadcast(data, size); 

提示

您需要在此处输入设备的 espnow 地址 - XX:XX:XX:XX:XX:XX。

开关配置

添加 Switch 组件：

switch:
  - platform: m5stack_switchc6
    id: sw1
    name: "SwitchC6 Device 1"
    espnow_id: espnow1
    mac_address: "XX:XX:XX:XX:XX:XX"
    retry_count: 40
    retry_interval: 300 

提示

要添加多个设备，需要同时更新 ESPNOW 配置和开关条目。例如：

espnow:
  id: espnow1
  auto_add_peer: true
  peers:
    - AA:BB:CC:DD:EE:01
    - AA:BB:CC:DD:EE:02
  on_broadcast:
    - lambda: |-
        id(sw1).handle_broadcast(data, size);
        id(sw2).handle_broadcast(data, size);

switch:
  - platform: espnow_switch
    id: sw1
    name: "SwitchC6 Device 1"
    espnow_id: espnow1
    mac_address: "AA:BB:CC:DD:EE:01"
    retry_count: 40
    retry_interval: 300
  - platform: espnow_switch
    id: sw2
    name: "SwitchC6 Device 2"
    espnow_id: espnow1
    mac_address: "AA:BB:CC:DD:EE:02"
    retry_count: 40
    retry_interval: 300 

下载和烧录固件

完成修改后，点击右上角的 SAVE 和 INSTALL，然后在弹出窗口中选择 Manual Download。
固件编译完成后，点击 Download 并选择 Factory format(Previously Modern)。

提示

点击 SwitchC6 查看完整的示例配置。首次构建可能需要一段时间，具体取决于 Home Assistant 主机的性能和网络质量。
再次点击 INSTALL 进行烧录并等待完成。
通过 USB Type-C 线缆将设备连接到主机。打开 ESPHome Web 并点击 CONNECT 连接设备。
找到对应的串口号。
点击 INSTALL。
选择之前编译的固件进行上传。
烧录完成后重新启动设备。