StamPLC Home Assistant 統合

StamPLC は産業オートメーションとリモート監視向けに設計された IoT プログラマブルロジックコントローラです。製品は Stamp-S3A コントロールモジュールを採用しており、高い処理能力と効率的な無線接続を提供します。本稿では StamPLC を Home Assistant に統合する手順を説明します。

注意

ESPHome コミュニティの貢献者 @Beormund による設定ファイルをご提供いただきました。詳細や参考は https://github.com/Beormund/esphome-m5stamplc を参照してください。

準備

Home Assistant ホスト
Home Assistant に ESPHome Builder アドオンをインストールして有効化

ヒント

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

Home Assistant の ESPHome Builder を開き、空の構成ファイルを作成します。

右下の NEW DEVICE ボタンをクリック
ダイアログで CONTINUE をクリック

Empty Configuration を選択

（任意）ファイル名を入力

新規作成された構成ファイルで EDIT をクリック

次に、サンプルリポジトリの configuration.yaml の内容を構成ファイルにコピーします。

必要に応じてネットワークや API 情報を修正します。例えば、認証用の API Encryption Key を作成する場合：

yaml 
api:
  encryption:
    key: "Your_Encryption_Key"

ヒント

Key が必要な場合は native api で生成できます（encryption のセクション）。

タイムゾーン設定を変更することも可能です。たとえば：

yaml

timezone: Japan

編集後、右上の SAVE をクリックし INSTALL で Manual download を選択します。

これによりコードが生成され、プロジェクトがコンパイルされます。

ヒント

初回のコンパイルは時間がかかる場合があります（Home Assistant ホストの性能とネットワークに依存）。

コンパイルが完了したら Factory format を選択してファームウェアをダウンロードします。

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

ブラウザで ESPHome Web を開き、ファームウェアをアップロードします。

USB-C ケーブルで StamPLC をホストに接続し、CONNECT をクリックしてデバイスを選択します。

その後 INSTALL をクリックし、先ほどダウンロードしたファームウェアを選択して再度 INSTALL を押すと書き込みが開始されます。

書き込みが完了するとデバイスは自動的にリセットして起動します。

Home Assistant への統合

デバイスが起動すると、設定した Wi‑Fi に接続し、Settings -> Devices & services でデバイスが検出されるはずです。

Add をクリックして StamPLC を Home Assistant に追加します。API Encryption Key を設定している場合はここで入力が必要になることがあります。

StamPLC のダッシュボード例：

実機の様子:

拡張

StamPLCは拡張性をサポートしており、右側の16ピンコネクタを介して他の拡張デバイスを接続できます。

StamPLC AC

StamPLC AC は、StamPLC ホストに適合する AC リレー拡張モジュールです。モジュールは交流負荷制御および機器の電源供給機能を統合し、アプリケーションの配線を効果的に簡素化します。接点式リレー（単極単投 - 常開型）を採用し、最大 AC 240V@10A のラインのオン / オフをサポートします。内蔵の AC-DC 絶縁変換回路により、AC 100〜240V 入力をサポートし、リレー負荷への電力供給と同時に DC 12V に降圧して機器に電力供給が可能です。基板上のプログラム可能な RGB LED は動作状態を表示するために使用されます。StamPLC コントローラは I2C プロトコルの IO 拡張チップを介してリレーおよび RGB LED をプログラム制御し、IO リソースを節約します。交流負荷装置のスイッチ制御、電磁弁制御などの産業用途に適しています。

StamPLC AC の構成

以前の StamPLC 構成を基に、YAML 構成ではいくつかのコンポーネントを追加する必要があります。

IO エクスパンダーの追加

pi4ioe5v6408:
  - id: pi4ioe5v6408_1
    address: 0x43
  # Configuration of i2c GPIO Expander 2
  # on the StamPLC AC expansion
  - id: pi4ioe5v6408_2
    address: 0x44 

ACリレースイッチを追加

switch:
  ...
  - platform: gpio
    restore_mode: RESTORE_DEFAULT_OFF
    name: "StamPLC AC Relay"
    id: ac_r1
    pin:
      pi4ioe5v6408: pi4ioe5v6408_2
      number: 2
      mode:
        output: true
    on_state: 
      - component.update: vdu 

ACリレーの上部にLEDカラーコントロールを追加しました

switch:
  ...
  # led indicator on StamPLC AC expansion
  - platform: gpio
    restore_mode: ALWAYS_OFF  
    id: "ac_relay_led_red"
    pin:
      pi4ioe5v6408: pi4ioe5v6408_2
      number: 5
      inverted: true
      mode:
        output: true

  - platform: gpio
    restore_mode: ALWAYS_OFF  
    id: "ac_relay_led_green"
    pin:
      pi4ioe5v6408: pi4ioe5v6408_2
      number: 6
      inverted: true
      mode:
        output: true

  - platform: gpio
    restore_mode: ALWAYS_OFF  
    id: "ac_relay_led_blue"
    pin:
      pi4ioe5v6408: pi4ioe5v6408_2
      number: 7
      inverted: true
      mode:
        output: true 

ディスプレイコンポーネントにACリレーUIを追加しました

display:
  ...
  lambda: |-
    ...
    it.print(5, 80, id(font1), Color(orange), "Relays 1-4");
    it.filled_rectangle(5, 99, 25, 25, id(r1).state ? id(red) : id(grey));
    it.filled_rectangle(34, 99, 25, 25, id(r2).state ? id(red) : id(grey));
    it.filled_rectangle(63, 99, 25, 25, id(r3).state ? id(red) : id(grey));
    it.filled_rectangle(92, 99, 25, 25, id(r4).state ? id(red) : id(grey));
    it.print(141, 80, id(font1), Color(orange), "AC Expansion");    // The AC Relay Expansion
    it.filled_rectangle(141, 99, 25, 25, id(ac_r1).state ? id(red) : id(grey));
  ... 

設定が完了したら、ファームウェアを再コンパイルしてアップロードし、デバイスを Home Assistant に追加して、追加のスイッチを介して AC リレーを制御します。