跳转到内容
ESPHome - 让智能家居更简单2026.7.0

UFM-01 流量计

ufm01 组件允许你将 UFM-01 流量计 (数据手册, 制造商页面) 集成到你的 ESPHome 设备中。该组件通过 UART 从 UFM-01 设备读取累积流量（体积）、当前流量和水温。 它还提供了多个诊断二进制传感器，用于监视设备状态。

UFM-01 流量计使用 2400 波特、偶校验和 1 个停止位的特定 UART 协议进行通信。

UFM-01 超声波流量计
UFM-01 流量计

配置

Section titled “配置”

ufm01 组件要求配置一个 UART 总线。确保你的 UART 总线设置为 baud_rate: 2400、 parity: EVEN 和 stop_bits: 1。

# UART 配置示例
uart:
  - id: uart_bus
    tx_pin: GPIOXX
    rx_pin: GPIOXX
    baud_rate: 2400
    parity: EVEN
    stop_bits: 1

组件/中心

Section titled “组件/中心”

要使用 UFM-01 组件，请将以下内容添加到你的配置中：

# 基础 UFM-01 配置
ufm01:
  - id: ufm01_component
    uart_id: uart_bus # 你的 UART 总线的 ID

配置变量

Section titled “配置变量”
  • id (可选, ID): 用于 UFM-01 组件的 ID。
  • uart_id (可选, ID): 要使用的 UART 总线的 ID。

传感器

Section titled “传感器”

ufm01 传感器平台允许你从 UFM-01 设备读取累积流量、当前流量和水温。

# 传感器配置
sensor:
  - platform: ufm01
    ufm01_id: ufm01_component # 你的 UFM-01 组件的 ID
    accumulated_flow:
      name: "UFM01 Accumulated Flow"
    flow:
      name: "UFM01 Flow Rate"
    temperature:
      name: "UFM01 Water Temperature"

配置变量

Section titled “配置变量”

  • platform: ufm01

  • ufm01_id (可选, ID): 此传感器所属的 ufm01 组件的 ID。

  • accumulated_flow (可选): 累积流量（体积）传感器。

    • 所有选项来自 Sensor。

  • flow (可选): 当前流量传感器。

    • 所有选项来自 Sensor。

  • temperature (可选): 水温传感器。

    • 所有选项来自 Sensor。

当 empty_tube 处于活动状态时，flow 和 temperature 会作为未知值（NaN）发布。accumulated_flow 会持续 更新。

二进制传感器

Section titled “二进制传感器”

UFM-01 组件还暴露了多个诊断二进制传感器，用于报告设备状态。

# 二进制传感器配置
binary_sensor:
  - platform: ufm01
    ufm01_id: ufm01_component # 你的 UFM-01 组件的 ID
    ufc_chip_error:
      name: "UFM01 UFC Chip Error"
    flow_direction_wrong:
      name: "UFM01 Flow Direction Wrong"
    empty_tube:
      name: "UFM01 Empty Tube"
    flow_rate_out_of_range:
      name: "UFM01 Flow Rate Out of Range"

配置变量

Section titled “配置变量”

  • platform: ufm01

  • ufm01_id (可选, ID): 此二进制传感器所属的 ufm01 组件的 ID。

  • ufc_chip_error (可选): 报告 UFC 芯片（超声波流量转换器；数据手册 ST2 位 5）是否有错误。

  • flow_direction_wrong (可选): 报告流量方向是否正确。

  • empty_tube (可选): 报告管道是否为空。

  • flow_rate_out_of_range (可选): 报告流量是否在可测范围之外。

完整配置示例

Section titled “完整配置示例”
uart:
  - id: uart_bus
    tx_pin: GPIOXX
    rx_pin: GPIOXX
    baud_rate: 2400
    parity: EVEN
    stop_bits: 1


ufm01:
  - id: ufm01_component
    uart_id: uart_bus


sensor:
  - platform: ufm01
    ufm01_id: ufm01_component
    accumulated_flow:
      name: "UFM01 Accumulated Flow"
    flow:
      name: "UFM01 Flow Rate"
    temperature:
      name: "UFM01 Water Temperature"


binary_sensor:
  - platform: ufm01
    ufm01_id: ufm01_component
    ufc_chip_error:
      name: "UFM01 UFC Chip Error"
    flow_direction_wrong:
      name: "UFM01 Flow Direction Wrong"
    empty_tube:
      name: "UFM01 Empty Tube"
    flow_rate_out_of_range:
      name: "UFM01 Flow Rate Out of Range"

参见

Section titled “参见”