Unit TMOS PIR Home Assistant 連携ガイド

このガイドでは、Unit TMOS PIR センサーを AtomS3R メインコントローラーと組み合わせ、Home Assistant に統合することで、人体の存在および活動状態をリアルタイムで監視・表示する方法について説明します。

必要なもの

ハードウェアリスト。

1 x Unit TMOS PIR。
1 x AtomS3R。
1 x HY2.0-4P Grove 接続ケーブル（20cm）。
1 x Home Assistant ホスト。

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

Home Assistant 2026.2.0 以上。
ESPHome Device Builder 2026.2.2 以上。

デバイスの追加

ESPHome Dashboard を開き、初期ガイド画面が表示された場合は CONTINUE をクリックします。
右下の緑色の + ボタンをクリックし、新しいデバイスの作成を開始します。
New Device Setup をクリックし、デバイス作成ウィザードに進みます。
デバイス名を入力し、NEXT をクリックします。
デバイスタイプを選択し、ESP32S3 をクリックします。
SKIP をクリックし、暗号化キーの設定をスキップします。
EDIT をクリックし、YAML 設定ページに進んでデバイス機能をカスタマイズします。

デバイス設定

外部コンポーネントの設定

YAML ファイルに External Components の設定を追加し、STHS34PF80 センサードライバーを読み込みます。

external_components:
  - source: github://m5stack/esphome-yaml/components
    components: sths34pf80
    refresh: 0s 

I2C バスの設定

I2C コンポーネントを追加し、Unit TMOS PIR と AtomS3R 間の通信ピンを設定します。

i2c:
  sda: GPIO2
  scl: GPIO1
  scan: true 

説明

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

センサーの設定

Sensor コンポーネントを追加し、存在検知および動作検知機能を設定します。

sensor:
  - platform: sths34pf80
    pres_flag:
      name: "TMOS Presence Detected"
    mot_flag:
      name: "TMOS Motion Detected"
    presence_threshold: 200
    presence_hysteresis: 50
    motion_hysteresis: 50
    odr: 8
    update_interval: 1s 

主なパラメータの説明：

パラメータ	値	説明
`presence_threshold`	200	存在検知のしきい値。値が大きいほど感度が低下します。
`presence_hysteresis`	50	存在検知のヒステリシス値。状態の頻繁な切り替えを防止します。
`motion_hysteresis`	50	動作検知のヒステリシス値。
`odr`	8	出力データレート（Hz）。0.25 / 0.5 / 1 / 2 / 4 / 8 / 15 / 30 に対応。
`update_interval`	1s	Home Assistant におけるセンサー状態の更新間隔。

ファームウェアのダウンロードと書き込み

ファームウェアのコンパイル

YAML の編集が完了したら、右上の SAVE をクリックして設定を保存し、INSTALL をクリックします。
ポップアップウィンドウで Manual Download を選択します。
ファームウェアのコンパイル完了後、Download をクリックし、Factory format (Previously Modern) を選択してファームウェアをローカルに保存します。

ヒント

Unit TMOS をクリックして完全なサンプル設定を確認できます。初回ビルドは、Home Assistant ホストの性能とネットワーク環境によっては時間がかかる場合があります。

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

USB Type-C ケーブルで AtomS3R をパソコンに接続します。ESPHome Web を開き、CONNECT をクリックします。
ポップアップのシリアルポート選択ウィンドウで、対応するポート番号を見つけて選択します。
INSTALL をクリックします。
手順 3 でダウンロードしたファームウェアファイルを選択してアップロードします。

注意

書き込み完了後は必ずデバイスをリセットしてください。リセットしない場合、ファームウェアが正常に起動しない可能性があります。

使い方

Home Assistant で Settings > Devices & Services の順にクリックし、インテグレーション管理ページに移動します。
Discovered エリアでオンラインになった Unit TMOS PIR デバイスを見つけ、CONFIGURE をクリックして画面の指示に従い追加を完了します。
追加が完了すると、デバイスページに pres_flag（存在検知）と mot_flag（動作検知）の 2 つのセンサーエンティティとそのリアルタイム状態が表示されます。
最後に、センサーエンティティをダッシュボードに追加すると、人体の存在状態と動作状態をリアルタイムで確認できます。