HDL Buspro

The HDL Buspro integration allows you to control your HDL Buspro system from Home Assistant.

Installation

Under HACS -> Integrations, add custom repository "https://github.com/eyesoft/home_assistant_buspro/" with Category "Integration". Select the integration named "HDL Buspro" and download it.

Restart Home Assistant.

Go to Settings > Integrations and Add Integration "HDL Buspro". Type in IP address and port number of the gateway.

Configuration

Light platform

To use your Buspro light in your installation, add the following to your configuration.yaml file:

light:
  - platform: buspro
    running_time: 3
    devices:
      1.89.1:
        name: Living Room Light
        running_time: 5
      1.89.2:
        name: Front Door Light
        dimmable: False

• running_time (int) (Optional): Default running time in seconds for all devices. Running time is 0 seconds if not set.
• devices (Required): A list of devices to set up
  • X.X.X (Required): The address of the device on the format <subnet ID>.<device ID>.<channel number>
    • name (string) (Required): The name of the device
    • running_time (int) (Optional): The running time in seconds for the device. If omitted, the default running time for all devices is used.
    • dimmable (boolean) (Optional): Is the device dimmable? Default is True.

Switch platform

To use your Buspro switch in your installation, add the following to your configuration.yaml file:

switch:
  - platform: buspro
    devices:
      1.89.1:
        name: Living Room Switch
      1.89.2:
        name: Front Door Switch

• devices (Required): A list of devices to set up
  • X.X.X (Required): The address of the device on the format <subnet ID>.<device ID>.<channel number>
    • name (string) (Required): The name of the device

Sensor platform

To use your Buspro sensor in your installation, add the following to your configuration.yaml file:

sensor:
  - platform: buspro
    devices:
      - address: 1.74
        name: Living Room
        type: temperature
        unit_of_measurement: °C
        device_class: temperature
        device: dlp
      - address: 1.74
        name: Front Door
        type: illuminance
        unit_of_measurement: lux

• devices (Required): A list of devices to set up
  • address (string) (Required): The address of the sensor device on the format <subnet ID>.<device ID>
  • name (string) (Required): The name of the device
  • type (string) (Required): Type of sensor to monitor.
    • Available sensors:
    • temperature
    • illuminance
  • unit_of_measurement (string) (Optional): text to be displayed as unit of measurement
  • device_class (string) (Optional): HASS device class e.g., "temperature" (https://www.home-assistant.io/components/sensor/)
  • device (string) (Optional): The type of sensor device:
    • dlp

Binary sensor platform

To use your Buspro binary sensor in your installation, add the following to your configuration.yaml file:

binary_sensor:
  - platform: buspro
    devices:
      - address: 1.74
        name: Living Room
        type: motion
        device_class: motion
      - address: 1.74.100
        name: Front Door
        type: universal_switch
      - address: 1.75.3
        name: Kitchen switch
        type: single_channel

• devices (Required): A list of devices to set up
  • address (string) (Required): The address of the sensor device on the format <subnet ID>.<device ID>. If 'type' = 'universal_switch' universal switch number must be appended to the address.
  • name (string) (Required): The name of the device
  • type (string) (Required): Type of sensor to monitor.
    • Available sensors:
      • motion
      • dry_contact_1
      • dry_contact_2
      • universal_switch
      • single_channel
  • device_class (string) (Optional): HASS device class e.g., "motion" (https://www.home-assistant.io/components/binary_sensor/)

Climate platform

To use your Buspro panel climate control in your installation, add the following to your configuration.yaml file:

climate:
  - platform: buspro
    devices:
      - address: 1.74
        name: Living Room
        preset_modes: 
          - none
          - away
          - home
          - sleep
      - address: 1.74
        name: Front Door

• devices (Required): A list of devices to set up
  • address (string) (Required): The address of the sensor device on the format <subnet ID>.<device ID>
  • name (string) (Required): The name of the device
  • preset_modes (list) (Optional): List of supported preset modes. Preset mode selection is disabled if not set. Possible values are shown in table below. Corresponding modes must be enabled in HDL (Floor Heating > Working Settings > Mode).

HA preset mode	HDL mode
none	Normal
away	Away
home	Day
sleep	Night

---

Services

Sending an arbitrary message:

Domain: buspro
Service: send_message
Service Data: {"address": [1,74], "operate_code": [4,78], "payload": [1,100,0,3]}

Activating a scene:

Domain: buspro
Service: activate_scene
Service Data: {"address": [1,74], "scene_address": [3,5]}

Setting an universal switch:

Domain: buspro
Service: set_universal_switch
Service Data: {"address": [1,74], "switch_number": 100, "status": 1}