2025.3.4
首页 ▸ Integrations ▸

Qbus

The Qbus integration集成将 Home Assistant 与您的设备、服务等连接和集成。 [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.

配置

要将 Qbus hub 添加到您的 Home Assistant 实例中，请使用此 My 按钮：

手动配置步骤

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

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).
  • Toggle: toggle outputs on controllers.

Available entities

  • Switch: toggles on/off outputs.
  • Light: controls dimmer lights, allowing both on/off functionality and brightness adjustment.

Removing the integration

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

从Home Assistant中移除集成实例

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

Data updates

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

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.