Velbus


The velbus integration is used to control Velbus modules. It supports the Velbus USB, Velbus serial and a TCP/IP gateway.

There is currently support for the following device types within Home Assistant:

  • Binary Sensor
  • Climate
  • Sensor
  • Switch
  • Cover
  • Light

The pushbutton LEDs of input modules are disabled by default. These can be enabled from the Devices panel in the Configuration page of the web interface.

Configuration

There are 2 options in configuring the Velbus integration:

  • Via the Home Assistant user interface where it will let you enter the port string to connect to the Velbus bus.
  • Via the Home Assistant configuration.yaml file.
# Example configuration.yaml entry for a USB or serial interface
velbus:
  port: 'PORT_STRING'

Port String

The port string used in the user interface or the configuration file can have 2 formats:

  • For a serial device: /dev/ttyUSB00
  • For a TCP/IP device: 127.0.0.1:3678

Configuration Variables

port

(string)(Required)

The port where your board is connected to your Home Assistant host.

Example automation

The Velbus integration allows you to link a Velbus button (i.e., a button of a VMBGPOD module) to a controllable entity 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 entity state changes.

# Control light living from Velbus push_button_10
- id: 'Control_light_living_from_Velbus'
  alias: Control light living using Velbus push_button_10
  trigger:
  - entity_id: binary_sensor.push_button_10
    platform: state
    to: 'on'
  condition: []
  action:
  - entity_id: light.living
    service: light.toggle

# Keep status LED push_button_10 in sync to status light living
- id: 'Update LED of push_button_10'
  alias: Update LED state of push_button_10
  trigger:
  - entity_id: light.living
    platform: state
    to: 'on'
  - entity_id: light.living
    platform: state
    to: 'off'
  condition: []
  action:
  - 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'
  - entity_id: light.led_push_button_10
    service: light.toggle