Unit Mini TVOC/eCO2 Home Assistant 連携ガイド

このガイドでは、Unit Mini TVOC/eCO2 ガスセンサーユニットを AtomS3R メインコントローラーと組み合わせ、Home Assistant に統合する方法を説明します。これにより、空気中の TVOC（総揮発性有機化合物）および eCO2（推定二酸化炭素濃度）をリアルタイムで監視できるようになります。

1. 準備

ハードウェアリスト

1 x Unit Mini TVOC/eCO2
1 x AtomS3R
1 x HY2.0-4P Grove 接続ケーブル（20cm）
1 x Home Assistant ホスト（サーバー、ミニ PC、NAS など）

ソフトウェアとバージョン

Home Assistant 2026.2.0 以上
ESPHome Device Builder 2026.2.2 以上

2. デバイスの作成

ESPHome Dashboard を開き、初期ガイド画面が表示された場合は CONTINUE をクリックします。

右下の緑色の + ボタンをクリックして、新しいデバイスの作成を開始します。

New Device Setup をクリックして、デバイス作成ウィザードに進みます。

デバイス名を入力し、NEXT をクリックします。

デバイスタイプを選択し、ESP32S3 をクリックします。

SKIP をクリックして、暗号化キーの設定をスキップします。

EDIT をクリックして YAML 設定ページに進み、デバイス機能をカスタマイズします。

3. デバイスの設定

3.1 I2C バスの設定

I2C コンポーネントを追加して、Unit Mini TVOC/eCO2 と AtomS3R 間の通信ピンを設定します。

i2c:
  sda: GPIO2
  scl: GPIO1
  scan: true 

説明

AtomS3R の PORT.A インターフェースは SDA: GPIO2、SCL: GPIO1 に対応しています。他のポートを使用する場合は、実際のピンに合わせて調整してください。

3.2 センサーの設定

Sensor コンポーネントを追加して、SGP30 センサーエンティティを有効化します。

sensor:
  - platform: sgp30
    address: 0x58
    update_interval: 2s
    store_baseline: true
    # Optional
    # baseline:
    #   eco2_baseline: 0x190 #400
    #   tvoc_baseline: 0x0   #0
    eco2:
      name: "eCO2"
    tvoc:
      name: "TVOC" 

主要パラメータの説明：

パラメータ	値	説明
`address`	0x41	Unit Mini TVOC/eCO2 の I2C アドレス。
`update_interval`	2s	Home Assistant へ測定値を更新する時間間隔。
`store_baseline`	true	ベースライン値の保存機能を有効にするかどうか。
`baseline`	オプション設定項目	プリセットのベースライン値。実際の環境に応じて調整することで精度が向上します。
`eco2`	eCO2 センサーエンティティ設定	eCO2 センサーエンティティの名称などの属性を設定します。
`tvoc`	TVOC センサーエンティティ設定	TVOC センサーエンティティの名称などの属性を設定します。