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 をクリックします。
先ほどコンパイルしたファームウェアを選択してアップロードします。
書き込みが完了したら、デバイスを再起動します。