PowerHub ESPHome 統合

PowerHub の ESPHome 統合には、電源チャンネル、測定、インターフェース制御、RTC コンポーネントが含まれます。

1. デバイス概要

項目 情報
製品名 PowerHub
SKU C148 / K148
主な機能 複数電源出力、電力測定、インターフェース制御、RTC
通信インターフェース I2C、UART、CAN、RS485、GPIO
ESPHome コンポーネント powerhub(外部コンポーネント)
必要な ESPHome バージョン /

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

PowerHub 外部コンポーネント

PowerHub は、M5Stack の powerhub 外部コンポーネント を使用して、基板上の STM32 コプロセッサーと通信します。

external_components:
  - source: github://m5stack/esphome-yaml/components@main
    components: [powerhub]
    refresh: 0s

powerhub:

ボタンと状態

binary_sensor Platform は上部 PMU ボタンを提供し、text_sensor Platform は充電状態と外部入力電源の状態を提供します。

binary_sensor:
  - platform: powerhub
    button:
      name: "Top PMU Button"

text_sensor:
  - platform: powerhub
    charge_status:
      name: "Battery Charge Status"
    vin_status:
      name: "External Input Power Status"

電圧・電流・電池残量

sensor Platform で、バッテリーおよび各出力チャンネルの電圧と電流を読み取れます。以下ではバッテリーと Port.A の基本エンティティを示します。Port.C、CAN、RS485、USB も同じ方法で設定できます。

sensor:
  - platform: powerhub
    battery_voltage:
      name: "Battery Voltage"
    battery_current:
      name: "Battery Current"
    battery_level:
      name: "Battery Percentage"
    grove_red_voltage:
      name: "Port.A Voltage"
    grove_red_current:
      name: "Port.A Current"
測定条件
ポートの電圧・電流エンティティを使用する前に、VAMeter Power と対応するチャンネルの電源スイッチをオンにし、実際の負荷を接続してください。電源が入っていない、または負荷が接続されていない場合、測定値は参考になりません。

電源チャンネル

switch Platform で、USB、Port.A、Port.C、RS485/CAN、充電、測定回路などの電源チャンネルを制御します。

switch:
  - platform: powerhub
    channel: USB
    name: "USB Power"

  - platform: powerhub
    channel: GROVE_RED
    name: "Port.A Power"

  - platform: powerhub
    channel: VAMETER
    name: "VAMeter Power"
    restore_mode: RESTORE_DEFAULT_ON

インターフェースパラメータ

USB の動作モードには select Platform を使用し、RS485/CAN の出力電圧と電流制限には number Platform を使用します。

select:
  - platform: powerhub
    usb_mode:
      name: "USB Mode"

number:
  - platform: powerhub
    rs485_can_output_voltage:
      name: "RS485&CAN Output Voltage"
      mode: box
    rs485_can_current_limit:
      name: "RS485&CAN Output Current Limit"
      mode: box
インターフェース電源
RS485/CAN の出力パラメータを変更する前に、負荷が許容する電圧と電流の範囲を確認してください。実際の出力には、対応する RS485&CAN Power チャンネルも有効にする必要があります。

インジケーター

light Platform で、USB、Port.A、Port.C、RS485/CAN、充電、電源状態のインジケーターを個別に制御できます。以下では USB-A の状態ランプを例に示します。

light:
  - platform: powerhub
    channel: USB_A
    name: "USB A Light"

RTC

基板上の RTC は powerhub Time Platform で時刻を提供します。起動時に RTC を読み取り、Home Assistant の時刻同期が完了した後に RTC へ書き戻します。

time:
  - platform: powerhub
    id: powerhub_time
    update_interval: never
  - platform: homeassistant
    on_time_sync:
      then:
        - powerhub.write_time:

3. 参考例

完全なデバイス設定は powerhub.factory.yaml を参照してください。このファイルには、ネットワーク、プロビジョニング、API、すべてのエンティティ、状態インジケーターの連動設定が含まれています。

Home Assistant にデバイスを接続すると、電源チャンネル、測定、インターフェースパラメータなどのエンティティを確認できます。

Home Assistant Dashboard の例:

完全なサンプルでは、各種ランプと電源出力を制御し、USB モードと RS485/CAN の出力制限を設定できます。

4. 関連リンク

5. 関連動画

Page Tools
PDF
On This Page