Qbus

The Qbus integrationIntegrations connect and integrate Home Assistant with your devices, services, and more. [Learn more] allows you to integrate your Qbus Control into Home Assistant. Qbus is a Belgian manufacturer of Home Automation systems.

Prerequisites

This integration communicates with a Qbus controller over an MQTT server.

The controllers cannot communicate directly with MQTT. Therefore, you need to install the Qbus gateway before enabling this integration. The Qbus gateway is a software tool that runs on all Linux platforms. It can be installed by running a script or a Docker container. For detailed instructions, please refer to the Qbus MQTT Gateway documentation.

For information on setting up Home Assistant with a Qbus controller, refer to the Qbus documentation. The documentation is currently only available in Dutch, but translations are planned for the future.

Once the Qbus controller is connected to the MQTT server, you need to set up an MQTT client in Home Assistant to enable communication between Home Assistant and your Qbus system. This client should connect to the same MQTT Server as your Qbus controller. For detailed instructions, refer to the MQTT integration documentation.

Configuration

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

Manual configuration steps

If the above My button doesn’t work, you can also perform the following steps manually:

Supported devices

There is currently support for the following Qbus products within Home Assistant:

  • CTD01E to CTD03E (CTD 3.0): main controllers (yellow).
  • CTD10 to CTDMax (CTD 3.5): main controllers (black).

Available entities

  • Binary sensor: display values from weather stations and controller information.
  • Climate: manage thermostats by setting temperature and choosing presets.
  • Cover: operate covers with support for actions like open, close, stop, position adjustment, and tilt — depending on your setup.
  • Light: control dimmer lights, allowing both on/off functionality and brightness adjustment.
  • Scene: activate predefined scenes.
  • Sensor: display sensor values from devices like gauges, humidity sensors, thermostats, ventilation, and weather stations.
  • Switch: toggle on/off outputs.

Removing the integration

This integration follows standard integration removal. No extra steps are required.

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 dots menu. Then, select Delete.

Data updates

All data from Qbus entities are pushed to Home Assistant over MQTT.

Examples

Automation to activate Qbus scene

This automation will activate the Watching TV Qbus scene when turning on your TV.

Replace media_player.my_tv with your TV entity and scene.ctd_000001_watching_tv with your Qbus scene entity.

alias: Activate TV scene when turning on TV
description: ""
mode: single
triggers:
  - entity_id:
      - media_player.my_tv
    from: "off"
    to: "on"
    trigger: state
conditions: []
actions:
  - target:
      entity_id: scene.ctd_000001_watching_tv
    metadata: {}
    alias: Activate TV scene
    action: scene.turn_on
    data: {}

Qbus scene triggers media player

Automations can also be triggered by Qbus scenes. The following automation will play the Home Assistant Homies playlist on the media player in the living room.

An extra condition has been added to make sure the automation is not triggered when Home Assistant reboots or when the integration reloads.

Replace scene.ctd_111111_play_music with your Qbus scene entity id, media_player.living_room with your media player entity id, and fill in the data element as desired.

alias: Play music in living room
description: ""
mode: single
triggers:
  - trigger: state
    entity_id:
      - scene.ctd_111111_play_music
    from: null
    to: null
conditions:
  - condition: template
    value_template: >-
      {{ trigger.from_state is not none and trigger.from_state.state not in
      ['unavailable', 'unknown'] and trigger.to_state is not none and
      trigger.to_state.state not in ['unavailable', 'unknown'] }}
actions:
  - action: media_player.play_media
    alias: Play media
    target:
      entity_id: media_player.living_room
    data:
      enqueue: replace
      media_content_id: Home Assistant Homies
      media_content_type: playlist

Known limitations

The integration does not provide a way to update the firmware on the devices. This can only be done with the configuration software System Manager.

Troubleshooting

Can’t set up the device

Symptom: “No devices are discovered”

When trying to set up the integration, no devices are discovered.

Description

This means that the integration did not receive a valid configuration from the gateway.

Resolution

To resolve this issue, try the following steps:

  1. Make sure your controller is online and not connected to System Manager.
  2. Make sure you have an MQTT broker running.
  3. Make sure that the gateway software is up and running (see Prerequisites) and connected to the broker.
  4. Make sure you have an MQTT client integration (see Prerequisites) connected to the broker.