StamPLC ESPHome 統合

StamPLC の ESPHome 統合には、本体および AC/PoE 拡張の入力、リレー、測定、ディスプレイ、Ethernet コンポーネントが含まれます。

謝辞

設定ファイルを提供した ESPHome コミュニティの @Beormund に感謝します。詳細は esphome-m5stamplc を参照してください。

1. デバイス概要

項目	情報
製品名	StamPLC
SKU	K141
主な機能	デジタル入出力、リレー、アナログ値の取得、ディスプレイ、RTC、Ethernet 拡張
通信インターフェース	I2C、SPI、GPIO、Ethernet
ESPHome コンポーネント	`aw9523`（外部コンポーネント）、`pi4ioe5v6408`、`ina226`、`lm75b`、`rx8130`、`mipi_spi`、`rtttl`、`ethernet`
必要な ESPHome バージョン	`2025.8.0` 以降

2. コンポーネントの説明

AW9523 外部コンポーネント

StamPLC は、コミュニティリポジトリの aw9523 外部コンポーネントを使用してデジタル入力とリレーを駆動します。

external_components:
  - source: github://Beormund/esphome-m5stamplc
    components: [aw9523] 

IO エキスパンダーの初期化

2 つの IO エキスパンダーが初期化される前に、GPIO3 を High に保持する必要があります。power_supply、PI4IOE5V6408、aw9523 の宣言順序は変更しないでください。

power_supply:
  id: pin3_output_high
  pin:
    number: GPIO3
    ignore_strapping_warning: true
  enable_on_boot: true

pi4ioe5v6408:
  - id: pi4ioe5v6408_1
    address: 0x43

aw9523:
  - id: aw9523_1
    address: 0x59 

初期化順序

GPIO3 をあらかじめ High にしないと、AW9523 と PI4IOE5V6408 が正常に初期化できない場合があります。

デジタル入力とリレー

AW9523 は 8 系統のデジタル入力と 4 系統のリレー出力を提供します。以下では最小構成として各 1 系統を示します。その他のチャンネルはエキスパンダーのピン番号だけ変更してください。

binary_sensor:
  - platform: gpio
    name: "Input 1"
    pin:
      aw9523: aw9523_1
      number: 4
      mode:
        input: true

switch:
  - platform: gpio
    name: "Relay 1"
    restore_mode: RESTORE_DEFAULT_OFF
    pin:
      aw9523: aw9523_1
      number: 0
      mode:
        output: true 

電気・温度測定

入力電圧、電流、電力には公式の INA226 Platform を使用し、基板上の温度には LM75B Platform を使用します。

sensor:
  - platform: ina226
    shunt_resistance: 0.01
    max_current: 8.192
    current:
      name: "Current"
    power:
      name: "Power"
    bus_voltage:
      name: "Bus Voltage"

  - platform: lm75b
    name: "Temperature"
    update_interval: 60s 

LCD とブザー

LCD には公式の MIPI SPI Display Platform を使用します。最小構成ではテスト画面で表示ドライバーを確認します。ブザーには LEDC Output と RTTTL を使用します。

display:
  platform: mipi_spi
  model: ST7789V
  dimensions:
    width: 240
    height: 240
    offset_width: 42
    offset_height: 55
  dc_pin: GPIO6
  cs_pin: GPIO12
  invert_colors: true
  show_test_card: true

output:
  - platform: ledc
    pin: GPIO44
    id: buzzer

rtttl:
  output: buzzer 

StamPLC AC 拡張

StamPLC AC は 2 個目の PI4IOE5V6408 エキスパンダーで、AC リレーと 3 色インジケーターを制御します。以下では 1 系統のリレーと 3 系統の LED の基本 GPIO 設定を示します。

pi4ioe5v6408:
  - id: pi4ioe5v6408_1
    address: 0x43
  - id: pi4ioe5v6408_2
    address: 0x44

switch:
  - platform: gpio
    name: "StamPLC AC Relay"
    restore_mode: RESTORE_DEFAULT_OFF
    pin:
      pi4ioe5v6408: pi4ioe5v6408_2
      number: 2
      mode:
        output: true

  - platform: gpio
    name: "StamPLC AC LED Red"
    restore_mode: ALWAYS_OFF
    pin:
      pi4ioe5v6408: pi4ioe5v6408_2
      number: 5
      inverted: true
      mode:
        output: true

  - platform: gpio
    name: "StamPLC AC LED Green"
    restore_mode: ALWAYS_OFF
    pin:
      pi4ioe5v6408: pi4ioe5v6408_2
      number: 6
      inverted: true
      mode:
        output: true

  - platform: gpio
    name: "StamPLC AC LED Blue"
    restore_mode: ALWAYS_OFF
    pin:
      pi4ioe5v6408: pi4ioe5v6408_2
      number: 7
      inverted: true
      mode:
        output: true 

高電圧に関する安全上の注意

StamPLC AC は最大 AC 240V の負荷を制御できます。配線やデバッグの前に AC 入力を切断し、負荷の電圧、電流、絶縁条件が製品仕様を満たしていることを確認してください。

StamPLC PoE 拡張

StamPLC PoE は、ESPHome 公式の Ethernet コンポーネントで W5500 を駆動します。

ethernet:
  id: ethernet_1
  type: W5500
  clk_pin: GPIO7
  mosi_pin: GPIO8
  miso_pin: GPIO9
  cs_pin: GPIO11
  clock_speed: 20MHz 

リソース競合

StamPLC PoE と基板上の LCD は SPI ハードウェアリソースを共有するため、同時には有効にできません。Ethernet を使用する場合は wifi も無効にする必要があります。2 つのネットワークコンポーネントは同時に設定できません。

RTC

基板上の RTC には RX8130 Platform を使用します。起動時に RTC を読み取り、SNTP の同期完了後に RTC へ書き戻します。

time:
  - platform: rx8130
    id: rx8130_time
    update_interval: 30min
  - platform: sntp
    id: sntp_time
    timezone: Europe/London
    on_time_sync:
      then:
        - rx8130.write_time:
            id: rx8130_time 