ESPHome Bluetooth Proxy for Seeed XIAO ESP32C3

Seeed XIAO ESP32C3をHome AssistantのBluetooth Proxyとして動作させるためのESPHome設定です。

必要なもの

1. Seeed XIAO ESP32C3
2. Home Assistant: インストール済み環境
3. Docker or Python: ESPHome

動作確認環境

• Windows 11
• WSL2
• Chromium系ブラウザ（Chrome/Edgeなど）

セットアップ手順

1. ESPHomeのインストール

Dockerの場合

docker pull esphome/esphome:stable

Pythonの場合

pip3 install esphome

※環境によっては pip が Python 2 を指す場合があるため、pip3 の使用を推奨します。

2. 設定ファイルの編集

secrets.sample.yamlファイルをコピーします。

cp secrets.sample.yaml secrets.yaml

secrets.yamlファイルを開いて、実際の値に書き換えてください。

# ESPHome Secrets File
# Replace the values below with your actual credentials

# WiFi Configuration
wifi_ssid: "あなたのWiFi SSID"
wifi_password: "あなたのWiFiパスワード"

# API Encryption Key (generate with: esphome config.yaml logs and copy the key)
# Or use: openssl rand -base64 32
api_key: "32バイトのランダムなBase64文字列（例: openssl rand -base64 32 で生成）"

# OTA Password
ota_password: "OTA更新用パスワード"

# Fallback AP Password
ap_password: "フォールバックAPパスワード"

api_keyは下記のコマンドで生成します。

openssl rand -base64 32

3. 設定ファイルをコンパイル

Dockerの場合

docker run --rm -v "${PWD}":/config -it esphome/esphome:stable compile esphome-config.yaml

Pythonの場合

esphome compile esphome-config.yaml

コンパイルが成功すると、以下の場所にファームウェアが生成されます。

.esphome/build/xiao-esp32c3-bluetooth-proxy/.pioenvs/xiao-esp32c3-bluetooth-proxy/firmware.factory.bin

4. ESPHome Web Toolsで書き込み

1. ChromeやEdgeなどのブラウザを開きます（Web Serial API対応のブラウザが必要です）

2. ESPHome Web Toolsにアクセスします

3. ESP32C3をPCに接続します

4. 「CONNECT」をクリックします

5. シリアルポートの選択画面が表示されるので、ESP32C3のポートを選択します

6. 「INSTALL」をクリックします

7. 「ファイルを選択」をクリックして、firmware.factory.binを選択します

8. 「INSTALL」をクリックして書き込みを開始します

9. 書き込みが完了したら、「LOGS」をクリックしてデバイスのログを確認します

5. Home Assistantへの追加

1. Home Assistantの「設定」→「デバイスとサービス」→「統合を追加」
2. ESPHomeを選択します
3. ホストにデバイスのIPアドレスを手動または自動で入力します（※ポートは変更していなければデフォルトの6053のままでOK）
4. デバイスが追加されます

参考リンク

• ESPHome Documentation
• ESPHome Web Tools
• Bluetooth Proxy
• ESP32 Platform
• Seeed XIAO ESP32C3