2025.3.4
首页 ▸ Integrations ▸

阀门

Home Assistant 中的 阀门 实体提供了控制水、气或空气阀门等阀门的接口。

Note

构建模块集成

这个 阀门 是一个构建模块集成，无法直接添加到你的 Home Assistant 中，但可以被其他集成使用和提供。

构建模块集成不同于典型的与设备或服务连接的集成。相反，其他将设备或服务集成到 Home Assistant 中的集成使用这个 阀门 构建模块来提供实体、服务和其他你可以在自动化或仪表板中使用的功能。

如果你的某个集成具有这个构建模块，这个页面记录了 阀门 构建模块所提供的功能。

阀门实体的状态

阀门 entity实体表示 Home Assistant 中的传感器、执行器或功能。实体用于监控物理属性或控制其他实体。实体通常是设备或服务的一部分。 [Learn more] 可以有以下状态：

  • 打开: 阀门完全打开。
  • 正在打开: 阀门正在打开的过程中。
  • 关闭: 阀门完全关闭。
  • 正在关闭: 阀门正在关闭的过程中。
  • 停止: 阀门在达到完全打开或关闭位置之前停止移动。
  • 不可用: 实体当前不可用。
  • 未知: 状态尚不清楚。

设备类别

设备类别是 Home Assistant 中的一种测量分类。它影响实体在 仪表板 中的表示方式。这可以在 自定义部分 中进行修改。例如，不同的状态可能会用不同的图标、颜色或文本来表示。

支持以下阀门设备类别：

  • 无: 通用阀门。这是默认值，无需设置。
  • 水: 控制水流通过系统的阀门。
  • 气: 控制气流通过系统的阀门。

操作

阀门控制操作

所有阀门响应 valve.open_valve、valve.close_valve 和 valve.toggle。 允许设置特定位置的阀门也可以使用 valve.set_valve_position 和 valve.stop_valve 来控制。

数据属性 可选 描述
entity_id 是 指向阀门的 entity_id 的字符串或字符串列表。使用 entity_id: all 来针对所有阀门。

自动化示例 

automation:
  triggers:
    - trigger: time
      at: "07:15:00"
  actions:
    - action: valve.close_valve
      target:
        entity_id: valve.demo

操作 valve.set_valve_position

设置一个或多个阀门的位置（如果它们支持设置特定位置）。

数据属性 可选 描述
entity_id 是 指向阀门的 entity_id 的字符串或字符串列表。使用 entity_id: all 来针对所有阀门。
position 否 介于 0（完全关闭）和 100（完全打开）之间的整数。

自动化示例 

automation:
  triggers:
    - trigger: time
      at: "07:15:00"
  actions:
    - action: valve.set_valve_position
      target:
        entity_id: valve.demo
      data:
        position: 50

相关主题