PM2.5 Air Quality 套件 (SHT30) Home Assistant 連携ガイド

本章では、PM2.5 Air Quality Kit-SHT30 空气质量监测套件を Home Assistant に連携し、LCD 画面にデータを出力する方法について説明します。

必要なもの

本チュートリアルでは、キットを ESPHome 2025.9.0 でコンパイルおよびアップロードしています。コンパイル・アップロードに問題が発生した場合は、ESPHome をこのバージョンに切り替えることをご検討ください。

ESPHome Builder を開き、右下の NEW DEVICE をクリックして新しいデバイスを作成します。
ダイアログで CONTINUE をクリックします。
New Device Setup を選択して、新しい設定ファイルを作成します。
設定ファイル名を入力します。
デバイスタイプを選択します。まず Use recommended settings のチェックを外し、ESP32 をクリックして M5Stack Core ESP32 を選択します。
Encryption Key をコピーして保存し、SKIP をクリックします。

生成された設定ファイルのカードにある EDIT をクリックして編集します。
ファイルの末尾に以下を追加します：
yaml
1 2
```
packages:
  m5stack.pm2_5-air-quality-kit: github://m5stack/esphome-yaml/common/pm2_5-air-quality-kit-base.yaml@main
```
右上の SAVE、INSTALL をクリックし、インストール方法の選択画面で Manual download を選択します。

ヒント：

初回コンパイルには時間がかかる場合があります。コンパイル時間は Home Assistant ホストの性能とネットワーク品質によって異なります。
コンパイル完了後、Download ボタンをクリックし、Factory Format を選択してファームウェアをダウンロードします。

ファームウェアのダウンロード：ESPHome Builder の Manual download 機能を使用して Factory Format ファームウェアをダウンロードします。
Web ツールを使用してファームウェアを書き込みます：
- キットを USB-C ケーブルでホストに接続し、ESPHome Web を開いて CONNECT をクリックしてデバイスに接続します。
- 続いて INSTALL をクリックし、先ほどコンパイルしたファームウェアを選択してアップロードします。
- 再度 INSTALL をクリックして書き込みを実行し、完了まで待ちます。

ファームウェアの書き込みが完了すると、デバイスの起動時に自動的に Wi-Fi 接続が行われます。Home Assistant はネットワーク上の新しいデバイスを自動検出します。Notifications に表示された新しいデバイスを選択し、Check it out -> CONFIGURE をクリックして、ダイアログの手順に従ってデバイスを指定のエリアに追加すれば設定完了です。
新しいデバイスの通知が表示されない場合は、Settings -> Device & services からデバイスの状況を確認できます。Add をクリックしてデバイスを Home Assistant に追加してください。
Dashboard の表示例：
また、Basic ホスト上のボタンでページを切り替えて、さらに多くの情報を表示することができます。

ヒント

LCD スクリーンに表示される時刻は Home Assistant から取得されており、Home Assistant に接続すると自動的に同期されます。センサーデータはサンプリングに一定の時間がかかるため、その後にスクリーンへ反映されます。