Atom Socket Home Assistant 連携ガイド

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

必要なもの

Home Assistant ホスト。
Home Assistant に ESPHome Builder をインストールして有効化しておくこと。

ご注意

本チュートリアルでは、ファームウェアのコンパイルおよびアップロードに ESPHome 2025.12.5 を使用しています。コンパイル／アップロードに問題が発生した場合は、ESPHome のバージョン切り替えをご検討ください。

デバイスの追加

新しいデバイスを作成します。右下の緑色のボタンをクリックしてデバイスを作成します。
デバイス名を作成します。
2.1 CONTINUE をクリックします。

2.2 New Device Setup をクリックします。

2.3 デバイス名を入力し、NEXT をクリックします。
デバイスタイプを選択します。
3.1 ESP32 をクリックします。

3.2 SKIP をクリックします。
YAML ファイルの編集を開始します。EDIT をクリックします。YAML ファイルを使用してデバイスの機能をカスタマイズできます。

デバイス設定

以下はコードの核心部分です。関連する参考情報と説明も合わせて記載しています。

UART 設定

uart コンポーネントを追加します：

uart:
  rx_pin: GPIO22
  baud_rate: 4800
  parity: EVEN 

センサー設定

センサーコンポーネントを追加します：

主要チップモジュールは HLW8032 電力計測チップで、電圧・電流・電力などのセンサーデータの収集と読み取りを担当します。

sensor:
  - platform: hlw8032
    voltage:
      name: HLW8032 Voltage
      id: hlw8032_voltage
    current:
      name: HLW8032 Current
      id: hlw8032_current
    power:
      name: HLW8032 Power
      id: hlw8032_power
    apparent_power:
      name: HLW8032 Apparent Power
      id: hlw8032_apparent_power
    power_factor:
      name: HLW8032 Power Factor
      id: hlw8032_power_factor 

スイッチ設定

スイッチコンポーネントを追加します：

switch:
  - platform: gpio
    name: "Atom Socket"
    pin:
      number: GPIO23
      inverted: False
    restore_mode: ALWAYS_ON 

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

変更が完了したら、右上の SAVE と INSTALL をクリックし、ポップアップウィンドウで Manual Download を選択します。
ファームウェアのコンパイルが完了したら、Download をクリックして Factory format(Previously Modern) を選択します。

ヒント

Atom Socket をクリックして完全なサンプル設定を確認できます。初回コンパイルは、Home Assistant ホストの性能やネットワーク環境によって時間がかかる場合があります。
USB Type-C ケーブルでデバイスをホストに接続します。ESPHome Web を開き、CONNECT をクリックしてデバイスに接続します。
対応するシリアルポート番号を確認します。
INSTALL をクリックします。
先ほどコンパイルしたファームウェアを選択してアップロードします。
書き込みが完了したら、デバイスを再起動します。

使い方

Home Assistant で Settings > Devices & Services の順にクリックして、インテグレーション管理ページに移動します。
Add をクリックして、デバイスを Home Assistant に統合します。
デバイスを追加すると、データが正しく表示されます。
最後に、これらのエンティティをダッシュボードに追加します。以下はその表示結果です。

ヒント

HLW8032 皮相電力 および HLW8032 電力 は、リレースイッチがオンのときのみデータが表示されます。