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 