PM2.5 Air Quality キット (SHT30) Home Assistant 連携ガイド

本章では、PM2.5 Air Quality Kit-SHT30 空気質モニタリングキットを Home Assistant に連携し、LCD 画面にデータを表示する方法について説明します。

1. 準備

環境準備

1. Home Assistant 公式ドキュメントを参照して、Home Assistant をインストールします。
2. ESPHome 公式ドキュメントを参照して、ESPHome Device Builder アドオンをインストールします。（注：本チュートリアルは ESPHome 2025.9.0 を基に作成されています。コンパイルまたはアップロードに問題が発生した場合は、まずこのバージョンに切り替えて確認してください。）

ハードウェア製品

• PM2.5 Air Quality Kit-SHT30
• Home Assistant ホスト。

参考資料

• センサーデータシート：
  • SHT30 Datasheet
  • PMSA003 Datasheet

2. オンライン書き込み

下の オンライン書き込み ボタンをクリックし、画面の案内に従ってファームウェアの書き込みと Wi-Fi 設定を完了すると、PM2.5 Air Quality Kit-SHT30 と Home Assistant の連携をすぐに試すことができます。

書き込みと設定の詳細な手順については、ESPHome ファームウェアのオンライン書き込みと設定を参照してください。

オンライン書き込み

オンライン書き込みが完了した場合は、「ファームウェアのコンパイル & 書き込み」の手順は不要です。4. 使い方に進んでください。

3. ファームウェアのコンパイル & 書き込み

本節では、yaml 設定ファイルを基にプロジェクトを再コンパイルし、二次開発、機能変更、または新機能の追加を行う方法について説明します。

デバイスの追加

1. ESPHome Builder を開き、右下の NEW DEVICE をクリックして新しいデバイスを作成します。

   

2. ダイアログで CONTINUE をクリックします。

   

3. New Device Setup を選択して、新しい設定ファイルを作成します。

   

4. 設定ファイル名を入力します。

   

5. デバイスタイプを選択します。まず Use recommended settings のチェックを外し、ESP32 をクリックして M5Stack Core ESP32 を選択します。

   

6. API Encryption Key をコピーして保存し、SKIP をクリックします。

   

設定の変更

1. 生成された設定ファイルのカードにある EDIT をクリックして編集します。

   

2. ファイルの末尾に以下を追加します：

   yaml packages: m5stack.pm2_5-air-quality-kit: github://m5stack/esphome-yaml/common/pm2_5-air-quality-kit-base.yaml@main

   1 2

   packages:
     m5stack.pm2_5-air-quality-kit: github://m5stack/esphome-yaml/common/pm2_5-air-quality-kit-base.yaml@main

   

3. 右上の SAVE と INSTALL をクリックし、インストール方法の選択画面で Manual download を選択します。

   

4. コンパイル完了後、Download ボタンをクリックし、Factory Format を選択してファームウェアをダウンロードします。

   

ファームウェアの書き込み

1. ファームウェアのダウンロード：ESPHome Builder の Manual download 機能を使用して Factory Format ファームウェアをダウンロードします。

2. ESPHome Web を使用してファームウェアを書き込みます：

   • USB Type-C ケーブルでキットをパソコンに接続し、ESPHome Webを開いて CONNECT をクリックしてデバイスに接続します。

     

   • INSTALL をクリックし、先ほどコンパイルしたファームウェアを選択してアップロードします。

     

   • 再度 INSTALL をクリックして書き込みを実行し、完了まで待ちます。

     

4. 使い方

1. ファームウェアの書き込みが完了すると、デバイスの起動時に自動的に Wi-Fi 接続が行われます。Home Assistant はネットワーク上の新しいデバイスを自動検出します。Notifications に表示された新しいデバイスを選択し、Check it out -> CONFIGURE をクリックして、ダイアログの手順に従ってデバイスを指定のエリアに追加すれば設定完了です。

   

2. 新しいデバイスの通知が表示されない場合は、Settings > Devices & Services からデバイスの状況を確認できます。Add をクリックしてデバイスを Home Assistant に追加してください。

   

3. Dashboard の表示例：

   

4. また、Basic ホスト上のボタンでページを切り替えて、さらに多くの情報を表示することができます。

5. 関連動画