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 

ファームウェアのダウンロードと書き込み

編集が完了したら、右上の SAVE と INSTALL をクリックし、ポップアップウィンドウで Manual download を選択します。
ファームウェアのコンパイルが完了したら、Download をクリックして Factory format (Previously Modern) を選択します。

ヒント

SwitchC6 をクリックして完全なサンプル設定を参照できます。
再度 INSTALL をクリックして書き込みを開始し、完了するまで待ちます。
USB Type-C ケーブルでデバイスをホストに接続します。ESPHome Web を開き、CONNECT をクリックしてデバイスに接続します。
対応するシリアルポート番号を確認します。
INSTALL をクリックします。
先ほどコンパイルしたファームウェアを選択してアップロードします。
書き込みが完了したら、デバイスを再起動します。