HLW8032 功率传感器

hlw8032 传感器平台允许您在 ESPHome 中使用 HLW8032 电压/电流和功率传感器 （数据手册）。此传感器常见于 M5Stack 模块中。

WARNING

安全隐患：某些设备的数字 GND 直接连接到市电 电压，因此GPIO 在正常运行期间会带电。我们的建议是标记这些电路板以阻止 使用危险的数字引脚。UART TX 引脚通常通过光耦连接到 MCU。

HLW8032 芯片测量单相电压（使用分压器）和电流（使用分流器）， 此外还提供有功功率、视在功率和功率因数测量。

由于与 HLW8032 的通信通过 UART 完成，您需要在配置中 设置一个 UART 总线，并将 rx_pin 连接到 HLW8032。 此外，您需要将波特率设置为 4800，校验方式为 EVEN。设备每秒发送多个 更新，因此您可能希望对传感器使用某种平均或节流过滤器。

# Example configuration entry
uart:
   rx_pin: GPIOXX
   baud_rate: 4800
   parity: EVEN

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

配置变量

• current (可选): 以安培为单位使用传感器的电流值。 来自 Sensor 的所有选项。
• power (可选): 以瓦特为单位使用传感器的（有功）功率值。 来自 Sensor 的所有选项。
• voltage (可选): 以 V（RMS）为单位使用传感器的电压值。 来自 Sensor 的所有选项。
• apparent_power (可选): 以伏安为单位使用传感器的视在功率值。 来自 Sensor 的所有选项。
• power_factor (可选): 使用传感器的功率因数值。 来自 Sensor 的所有选项。
• uart_id (可选，ID): 如果您想 使用多个 UART 总线，可手动指定 UART 组件 的 ID。

高级选项

• current_resistor (可选，float): 电流测量分流电阻的值。 默认值为 0.001 ohm。
• voltage_divider (可选，float): 板上分压器的值， 格式为 R_upstream / (R_downstream * 1000)。默认值为 1.72。

能量测量

HLW8032 有一个 PF（脉冲频率）输出引脚，可产生与有功能耗成正比的脉冲。 可与 Pulse Meter 组件配合进行能量追踪。

或者，您可以使用功率传感器的软件积分功能：

sensor:
  - platform: hlw8032
    power:
      name: HLW8032 Power
      id: hlw8032_power
  - platform: total_daily_energy
    name: "Daily Energy"
    power_id: hlw8032_power

参见

• Sensor Filters
• Pulse Meter Sensor
• Total Daily Energy Sensor
• API 参考：hlw8032.h