Velbus

The Velbus integrationIntegrations connect and integrate Home Assistant with your devices, services, and more. [Learn more] is used to control Velbus modules. It supports the Velbus USB, Velbus serial and a TCP/IP gateway.

Configuration

To add the Velbus hub to your Home Assistant instance, use this My button:

Configuration parameters

The port string used in the user interface or the configuration file can have different formats depending on the type of connection:

• For a serial or USB devices: /dev/ttyUSB00
• For a TCP/IP devices: 127.0.0.1:3678
• For Signum devices without authentication: tls://192.168.1.9:27015
• For Signum devices with authentication: tls://[email protected]:27015

Actions

• velbus.sync clock: Synchronize Velbus time to local clock.
• velbus.scan: Scan the bus for new devices.
• velbus.set_memo_text: Show memo text on Velbus display modules.
• velbus.clear_cache: Clear the full velbuscache or the cache for one module only.

Action velbus.sync_clock

You can use the velbus.sync_clock action to synchronize the clock of the Velbus modules to the clock of the machine running Home Assistant. This is the same as the ‘sync clock’ button at the VelbusLink software.

Action velbus.scan

You can use the velbus.scan action to synchronize the modules between the bus and Home Assistant. This is the same as the ‘scan’ button at the VelbusLink software.

Action velbus.set_memo_text

You can use the velbus.set_memo_text action to provide the memo text to be displayed at Velbus modules like VMBGPO(D) and VMBELO.

Example:

script:
  trash_memo:
    alias: "Trash memo text"
    sequence:
    - action: velbus.set_memo_text
      data:
        address: 65
        memo_text: "It's trash day"
        interface: "tls://192.168.1.9:27015"

Action velbus.clear_cache

You can use the velbus.clear_cache action to clear the cache of one module or the full cache. Once the clear happens, the integration will start a new scan. Use this action when you make changes to your configuration via velbuslink.

VMB7IN and the Energy dashboard

The VMB7IN sensor can be integrated with Home Assistant’s Energy dashboard to track your utility consumption.

In some cases, the VMB7IN sensor does not report what the counter is counting. If the counter is related to an energy device, everything will work out of the box. But if the VMB7IN sensor is a water or gas counter, you will need to specify this in your configuration.yaml file.

homeassistant:
  customize:
    sensor.eau_counter:
      device_class: water

The device_class attribute can have 2 values:

• gas: if the counter represents a gas meter
• water: if the counter represents a water meter

Example automation

The Velbus integrationIntegrations connect and integrate Home Assistant with your devices, services, and more. [Learn more] allows you to link a Velbus button (i.e., a button of a VMBGPOD module) to a controllable entityAn entity represents a sensor, actor, or function in Home Assistant. Entities are used to monitor physical properties or to control other entities. An entity is usually part of a device or a service. [Learn more] of Home Assistant. The actual linking can be realized by two automation rules. One rule to control the device using the push button and a second rule to update the LED state of the push button as soon as the entityAn entity represents a sensor, actor, or function in Home Assistant. Entities are used to monitor physical properties or to control other entities. An entity is usually part of a device or a service. [Learn more] state changes.

# Control light living from Velbus push_button_10
- alias: "Control light living using Velbus push_button_10"
  triggers:
    - trigger: state
      entity_id: binary_sensor.push_button_10
      to: "on"
  actions:
    - action: light.toggle
      entity_id: light.living
      

# Keep status LED push_button_10 in sync to status light living
- alias: "Update LED state of push_button_10"
  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
      

Removing the integration

The Velbus integration and its entities can be removed by following these steps:

To remove an integration instance from Home Assistant

1. Go to Settings > Devices & services and select the integration card.
2. From the list of devices, select the integration instance you want to remove.
3. Next to the entry, select the three-dot menu. Then, select Delete.

Note: Removing the integration will delete all Velbus devices and their history from Home Assistant.