Velbus

Velbus integration集成将 Home Assistant 与您的设备、服务等连接和集成。 [Learn more] 用于控制 Velbus 模块。它支持 Velbus USB、Velbus 串行和 TCP/IP 网关。

配置

要将 Velbus hub 添加到您的 Home Assistant 实例中,请使用此 My 按钮:

手动配置步骤

如果上述 My 按钮不起作用,您也可以手动执行以下步骤:

配置参数

在设置过程中,您将看到 2 种连接 Velbus 总线的选择:

  • USB
  • TCP/IP

USB

USB 连接是一种连接 Velbus 总线的方法。您需要一个 Velbus USB 接口来连接到总线。USB 接口连接到您的 Home Assistant 设备的 USB 端口。 接口 USB 设备会被自动检测并显示在列表中。 从列表中选择正确的 USB 接口并选择 提交

将进行连接测试以确保连接正常,如果正常,集成将被添加到 Home Assistant 中。

TCP/IP

TCP/IP 连接是一种连接 Velbus 总线的方法。您需要一个可在您的网络中使用的 Velbus TCP/IP 接口。

要连接到 Velbus 总线,您需要填写几个参数:

  • tls
  • host
  • port
  • password

tls 参数是可选的,可以用来启用或禁用 TLS 连接。 host 参数是 Velbus TCP/IP 接口的 IP 地址。 port 参数是 Velbus TCP/IP 接口的端口号。 password 参数是可选的,可以用来对 Velbus TCP/IP 接口进行身份验证。

示例:signum

  • tls: yes
  • host: 您的 signum IP 地址
  • port: 27015
  • password: 您的 signum 密码(如果已配置)

示例:velser

  • tls: no
  • host: 您的 velser IP 地址
  • port: 6000
  • password: 留空

示例:Home Assistant 插件

  • tls: 根据您的配置
  • host: 您的 Home Assistant IP 地址
  • port: 27015 如果您保留了默认值
  • password: 留空

Note

输入模块的推按钮 LED 默认设置为禁用。可以从 Web 界面的 配置 页面中的 设备 面板中启用这些功能。

操作

  • velbus.sync clock: 将 Velbus 时间同步到本地时钟。
  • velbus.scan: 扫描总线以查找新设备。
  • velbus.set_memo_text: 在 Velbus 显示模块上显示备忘文本。
  • velbus.clear_cache: 清除整个 velbuscache 或仅清除一个模块的缓存。

操作 velbus.sync_clock

您可以使用 velbus.sync_clock 操作将 Velbus 模块的时钟与运行 Home Assistant 的机器时钟同步。这和 VelbusLink 软件中的“同步时钟”按钮相同。

数据属性 可选 描述
interface 用于连接总线的端口(与配置过程中使用的相同)。
config_entry 发送命令的 config_entry。

操作 velbus.scan

您可以使用 velbus.scan 操作在总线和 Home Assistant 之间同步模块。这和 VelbusLink 软件中的“扫描”按钮相同。

数据属性 可选 描述
interface 用于连接总线的端口(与配置过程中使用的相同)。
config_entry 发送命令的 config_entry。

操作 velbus.set_memo_text

您可以使用 velbus.set_memo_text 操作提供要在 Velbus 模块(如 VMBGPO(D) 和 VMBELO)上显示的备忘文本。

数据属性 可选 描述
interface 用于连接总线的端口(与配置过程中使用的相同)。
config_entry 发送命令的 config_entry。
address 模块地址(十进制格式),在集成页面的设备列表中显示。
memo_text 要在模块上显示的文本。如果没有提供备忘文本,则将清除备忘文本。

示例:

script:
  trash_memo:
    alias: "Trash memo text"
    sequence:
    - action: velbus.set_memo_text
      data:
        address: 65
        memo_text: "今天是垃圾日"
        config_entry: "01JGE8XB3MNPZFA836TTZ3KZ46"

操作 velbus.clear_cache

您可以使用 velbus.clear_cache 操作清除某个模块或整个缓存的缓存。一旦清除,集成将开始新的扫描。 当您通过 velbuslink 对配置进行更改时使用此操作。

数据属性 可选 描述
interface 用于连接总线的端口(与配置过程中使用的相同)。
config_entry 发送命令的 config_entry。
address 模块地址(十进制格式),在集成页面的设备列表中显示,如果提供,服务将仅清除该模型的缓存,如果没有地址,则将清除整个 velbuscache。

VMB7IN 和能源仪表板

VMB7IN 传感器可以与 Home Assistant 的能源仪表板集成以跟踪您的公用事业消费。

在某些情况下,VMB7IN 传感器没有报告计数器在计数什么。如果计数器与能量设备相关,则一切将开箱即用。 但是,如果 VMB7IN 传感器是水或气体计数器,则需要在您的 configuration.yaml 文件中指定这一点。

homeassistant:
  customize:
    sensor.eau_counter:
      device_class: water

device_class 属性可以有 2 个值:

  • gas: 如果计数器代表气体计
  • water: 如果计数器代表水表

示例自动化

Velbus integration集成将 Home Assistant 与您的设备、服务等连接和集成。 [Learn more] 允许您将 Velbus 按钮(即 VMBGPOD 模块的按钮)链接到 Home Assistant 的可控 entity实体表示 Home Assistant 中的传感器、执行器或功能。实体用于监控物理属性或控制其他实体。实体通常是设备或服务的一部分。 [Learn more]。 实际链接可以通过两个自动化规则实现。一条规则用于使用推按钮控制设备,另一条规则则在 entity实体表示 Home Assistant 中的传感器、执行器或功能。实体用于监控物理属性或控制其他实体。实体通常是设备或服务的一部分。 [Learn more] 状态更改时更新推按钮的 LED 状态。

# 使用 Velbus push_button_10 控制客厅灯光
- alias: "使用 Velbus push_button_10 控制客厅灯光"
  triggers:
    - trigger: state
      entity_id: binary_sensor.push_button_10
      to: "on"
  actions:
    - action: light.toggle
      entity_id: light.living
      

# 保持 push_button_10 的状态 LED 与客厅灯光状态同步
- alias: "更新 push_button_10  LED 状态"
  triggers:
    - trigger: state
      entity_id: light.living
      to: "on"
    - trigger: state
      entity_id: light.living
      to: "off"
  conditions:
    - condition: or
      conditions:
        - condition: and
          conditions:
          - condition: state
            entity_id: light.led_push_button_10
            state: "on"
          - condition: state
            entity_id: light.living
            state: "off"
        - condition: and
          conditions:
            - condition: state
              entity_id: light.led_push_button_10
              state: "off"
            - condition: state
              entity_id: light.living
              state: "on"
  actions:
    - action: light.toggle
      entity_id: light.led_push_button_10
      

移除集成

Velbus 集成及其实体可以通过以下步骤删除:

从Home Assistant中移除集成实例

  1. 前往 设置 > 设备与服务 并选择集成卡片。
  2. 从设备列表中,选择要删除的集成实例。
  3. 在条目旁边,选择三个点 菜单。然后,选择 删除

注意:删除集成将从 Home Assistant 中删除所有 Velbus 设备及其历史记录。