Skip to main content

XIAO ESP32-C5 を Home Assistant に接続

このwikiチュートリアルでは、Seeed Studio XIAO ESP32-C5をHome Assistantに接続する方法、およびXIAO ESP32-C5にGroveモジュールを接続した後にデバイスを制御したりデータを送信したりする方法を説明します。それでは始めましょう！

Home Assistant の紹介​

Home Assistantは、単一の統合インターフェースからスマートホームデバイスを制御・監視できる強力なオープンソースホームオートメーションプラットフォームです。スマートホームの中央ハブとして機能し、ルーチンの自動化、センサーの監視、より知的な生活空間の構築を可能にします。

詳細を見る 🖱️

ESPHome 統合​

ESPHomeは、ESP8266 / ESP32デバイス専用に設計されたオープンソースファームウェア作成ツールです。シンプルなYAML設定ファイルを使用してカスタムファームウェアを作成し、デバイスにフラッシュできます。


詳細を見る 🖱️

方法1：ESPHomeを使用​

この例では、ESPHome経由でHome Assistantに接続します。

ハードウェアの準備​

表に記載されているアイテムを準備する必要があります。

Seeed Studio XIAO ESP32-C5Seeed Studio Grove Base for XIAOGrove - Red LED
今すぐ入手 🖱️
今すぐ入手🖱️
詳細を見る 🖱️

ファームウェアのインストール​

Home Assistantをまだセットアップしていない場合は、このリンクをクリックして公式のHome Assistantチュートリアルに従ってセットアップを完了してください。Home Assistant Installation

ステップ1. ESPhomeをインストール

すでにESPHomeをインストールしている場合は、このステップをスキップできます。

  • Settings -> Add-ons に移動
  • ADD-ON STORE -> Search ESPHome
  • ESPhomeを開始
tip

インストールしたESPHomeのバージョンが25.11.5以上であることを確認してください。そうでないと、XIAO ESP32-C5をサポートしない可能性があります。

ステップ2. 新しいデバイスを追加

ESPHomeに移動し、右下のAdd New Deviceボタンをクリックします。


新しいデバイスを追加し、XIAO ESP32-C5と名前を付けます。



ステップ3. ファームウェアをインストール

参考YAMLファイル設定
tip

APIキー、SSID、パスワードなど、デバイスに合わせてパラメータを変更する必要があります。さらに、XIAO ESP32-C5はデュアルバンドWiFi（2.4 GHz & 5 GHz）をサポートしているため、自宅の5 GHzルーターに接続できます。

esphome:
  name: xiao-esp32-c5
  friendly_name: XIAO ESP32-C5

esp32:
  board: esp32-c5-devkitc-1
  variant: esp32c5
  framework:
    type: esp-idf

# Enable logging
logger:

# Enable Home Assistant API
api:
  encryption:
    key: 

ota:
  - platform: esphome
    password: 

wifi:
  ssid: !secret wifi_ssid
  password: !secret wifi_password

  # Enable fallback hotspot (captive portal) in case wifi connection fails
  ap:
    ssid: "Xiao-Esp32-C5 Fallback Hotspot"
    password: 

captive_portal:
  # Example configuration entry
output:
  - platform: gpio
    pin: GPIO1
    id: led_gpio_output
    inverted: false

switch:
  - platform: output
    name: "LED Switch"
    output: led_gpio_output
    id: dev_board_led

INSTALLをクリックしてコードをデバイスにインストールすると、次の画像が表示されます。

tip

Home Assistantホスト（Raspberry PI/Green/Yellowなど）が遠くにある場合は、この方法をお勧めします。手元にあるコンピュータでインストールできます。

まず、Manual downloadをクリックしてコンパイル済みファームウェアをダウンロードする必要があります。

XIAO ESP32-C5にファームウェアをアップロードするこのウェブサイトを開きます。
ESPHome dashboard_install


ESPHomeに戻ってファームウェアをダウンロードします。


Factory formatを選択します。

USBケーブルを使用してデバイスをコンピュータに接続し、CONNECTをクリックします。
ESPHome dashboard_install


usbmodemxxx（WindowsではCOMxxx）を選択してconnectをクリックします。

INSTALLをクリックして、先ほどダウンロードしたファームウェアを選択します。

ステップ 4. デバイスの追加

  • Settings → Devices & servicesに移動します

  • ESPHome Device -> Add。

  • シークレットキーの追加を選択した場合は、作成したYAMLファイルで確認できるキーを入力する必要があります。

  • 追加が成功すると、以下の画面が表示されます。

ダッシュボードでの表示​

ステップ 1. Overview を開く -> 右上角の Edit をクリック

ステップ 2. セクションを作成し、LED Controlと名前を付ける -> カードを追加

ステップ 3. Add by entity -> XIAO ESP32-C5を検索 -> Continue

ステップ 4. ポップアップウィンドウでAdd to dashboardを選択 -> 右上角のDoneをクリックして追加を完了します。

  • 効果は以下の通りです：

方法 2: Seeed Home Assistant Discovery​

  • Seeed HA Discoveryは、Seeed Studioが提供する、ESP32/nRF52840デバイスをHome Assistantに簡単に接続するための完全なソリューションです。
  • XIAOシリーズ開発ボード用のArduino IDEまたはPlatformIOでわずか数行のコードを書くだけで、WiFiまたはBLE経由でHome Assistantに接続できます。
  • ここでは、温室の温湿度センサーを読み取る例を使用して、Seeed Home Assistant DiscoveryでXIAO ESP32-C5をHome Assistantに接続する方法を説明します。

ハードウェアの準備​

Seeed Studio XIAO ESP32-C5Seeed Studio Grove Base for XIAOGrove - Temperature & Humidity Sensor (DHT11)
今すぐ入手 🖱️
今すぐ入手🖱️
詳細を確認 🖱️

HACS インストール​

Seeed Home Assistant Discovery統合を追加する前に、まずHACSをインストールする必要があります。

インストール手順：

  1. Settings -> Devices & services -> Add integration -> HACSを検索
  1. すべてのオプションを選択 -> Submit

  1. ハイパーリンクをクリックし、その中のアクティベーションコードをコピーします。

  2. 先ほどのアクティベーションコードを入力します

  3. HomeAssistantに戻る -> Developer tools -> Reboot system

  1. 左のナビゲーションバーにHACSが表示されます

統合のインストール​

  • HACS経由でのワンクリックインストール（推奨）

  1. HACS -> Integrations を開く：

  2. 右上角の**⋮**アイコンをクリック -> Custom repositories

  3. https://github.com/limengdu/Seeed-Homeassistant-Discoveryを入力し、カテゴリIntegrationを選択

  4. Addをクリックし、Seeed HA Discoveryを検索してインストール

  5. Home Assistantを再起動

Arduinoライブラリのインストール​

WiFi依存ライブラリのインストール​

  • Arduino IDE用
  1. arduino/SeeedHADiscoveryフォルダをダウンロード
ライブラリをダウンロード

  1. C:\Users\yourname\Documents\Arduino\libraries\ にコピーします

  2. ArduinoJson (by Benoit Blanchon)

  1. WebSockets (by Markus Sattler)
  • PlatformIO の場合
lib_deps =
    bblanchon/ArduinoJson@^7.0.0
    links2004/WebSockets@^2.4.0

BLE 依存ライブラリのインストール​

  • Arduino IDE の場合

  1. arduino/SeeedHADiscoveryBLE フォルダをダウンロードします

  2. C:\Users\yourname\Documents\Arduino\libraries\ にコピーします

ライブラリをダウンロード

  1. NimBLE-Arduino
  • PlatformIO の場合
lib_deps =
    h2zero/NimBLE-Arduino@^1.4.0

Arduino プログラムの作成​

実際のニーズに応じて対応するバージョンを選択してください。

#include <SeeedHADiscovery.h>

const char* WIFI_SSID = "Your WiFi Name";
const char* WIFI_PASSWORD = "Your WiFi Password";

SeeedHADiscovery ha;
SeeedHASensor* tempSensor;
SeeedHASensor* humiditySensor;

void setup() {
    Serial.begin(115200);
    ha.setDeviceInfo("Living Room Sensor", "ESP32-C5", "1.0.0");
    ha.enableDebug(true);

    if (!ha.begin(WIFI_SSID, WIFI_PASSWORD)) {
        Serial.println("WiFi connection failed!");
        while (1) delay(1000);
    }

    tempSensor = ha.addSensor("temperature", "Temperature", "temperature", "°C");
    tempSensor->setPrecision(1);

    humiditySensor = ha.addSensor("humidity", "Humidity", "humidity", "%");
    humiditySensor->setPrecision(0);
}

void loop() {
    ha.handle();

    static unsigned long lastUpdate = 0;
    if (millis() - lastUpdate > 5000) {
        lastUpdate = millis();
        tempSensor->setValue(25.5);
        humiditySensor->setValue(55);
    }
}

コードをアップロードした後、シリアルモニターを開きます。WiFi 接続が成功すると、対応する IP アドレスが出力されます。

tip

XIAO ESP-C5 はデュアルバンド WiFi（2.4 GHz & 5 GHz）をサポートしています。
手動でのネットワーク設定が面倒だと感じる場合は、私たちが開発したファームウェア書き込みウェブページも利用できます：Web Firmware Flasher

Home Assistant でのデバイス追加​

自動的に検出されます！または手動で追加：

  1. Settings -> Devices & Services に移動します

  2. Add Integration をクリックします

  3. Seeed HA Discovery を検索します

  4. ESP32 の IP アドレスを入力します

効果のデモンストレーション​


おめでとうございます！これで、XIAO ESP32-C5 を Home Assistant に接続する 2 つの方法をマスターしたはずです。皆様の素晴らしいプロジェクトを楽しみにしており、ぜひ私たちと共有していただければと思います！

技術サポート & 製品ディスカッション​

私たちの製品をお選びいただき、ありがとうございます！私たちは、お客様の製品体験ができるだけスムーズになるよう、さまざまなサポートを提供しています。異なる好みやニーズに対応するため、複数のコミュニケーションチャンネルを用意しています。

Loading Comments...