SwitchC6 Home Assistant 集成

简介

SwitchC6 是一款物联网单火线开关控制器。它集成了 ESP32-C6-MINI-1 核心控制器和磁保持继电器，支持连接 AC 100 ~ 230V 的电气负载电路，帮助快速构建物联网智能家居。该控制器预装了 ESP-NOW 控制固件，并提供相关的控制协议和 SDK，允许用户使用任何 ESP32 设备进行无线控制。背面采用导轨夹设计，便于安装在 DIN 导轨上，适用于嵌入式智能家居控制、升级单火线照明电路等应用场景。

准备工作

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

提示

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

步骤 1. 创建新设备

点击右下角的绿色按钮创建设备。

步骤 2. 创建设备名称

点击 CONTINUE。

点击 New Device Setup。

输入设备名称并点击 NEXT。

步骤 3. 选择设备类型

提示

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

点击 ESP32。

点击 SKIP。

步骤 4. 开始编辑 YAML 文件

点击 EDIT。我们可以通过 YAML 文件自定义设备功能。

设备设置

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

外部组件配置

添加 External 组件

external_components:
  - source: github://m5stack/esphome-yaml/components
    components: espnow_switch
    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: espnow_switch
    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 