SwitchC6 Home Assistant 集成

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

1. 准备工作

环境准备

参考 Home Assistant 官方文档安装 Home Assistant。
参考 ESPHome 官方文档完成 ESPHome Device Builder 插件安装。（注意：本教程基于 ESPHome 2025.12.5 版本编写，如遇编译错误，建议先切换至该版本进行验证。）

硬件产品

SwitchC6

2. 固件编译 & 烧录

本小节将说明如何基于 yaml 配置文件重新编译项目，便于二次开发、功能修改或新增功能。

构建时长

首次构建可能需要一段时间，具体取决于 Home Assistant 主机的性能和网络质量。

创建设备

创建新设备。

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 