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: 