QBHA stands for Qbus Bridge for Home Assistant and can be pronounced as "cuba". QBHA will create MQTT topics for Home Assistant based on your Qbus configuration, making all supported entities available in Home Assistant.
The application runs as a Docker container. It is also available as a Home Assistant add-on: https://github.com/thomasddn/home-assistant-addons.
- Full interoperability between Qbus and Home Assistant for the supported entities.
- Automatic firmware update of your Qbus controller (if required).
- New Qbus entities are automatically added to Home Assistant.
- Entities get a persistent ID in Home Assistant, even when changing the Qbus entity names in Serial Manager or when Qbus MQTT rebuilds.
- Climate entity in Home Assistant reflects current temperature, requested temperature and preset, regardless of whether you change the temperature by preset or manually.
- Climate entity in Home Assistant automatically sets its mode to either
heat
,cool
oroff
. - Hard-coded 2 deg hysteresis to switch between cooling and heating or to turn tthe heating/cooling device off.
- When Home Assistant restarts, all Qbus entities will report their current state.
- Supports multiple controllers.
All customizations are optional.
- Automatically create sensors for climate entities so you can show a nice graph on your dashboard.
- Choose which climate presets you want to make available in Home Assistant.
- Define on/off entities that should be created as a binary sensor.
Qbus | Home Assistant |
---|---|
Dimmer | Light |
On/Off | Switch |
Shutter | Cover |
Thermostat | Climate |
Scene | Scene |
- Qbus home automation system (hardware).
- Qbus MQTT gateway. Choose one of these installation methods:
- Docker version: thomasddn/qbusmqtt (Docker Hub | source)
- Bare metal: https://github.com/QbusKoen/qbusMqtt. Be sure to only install the gateway (qbusMqttGw) and optionally Mosquitto. You can also use an installer script.
- MQTT broker (e.g. https://hub.docker.com/_/eclipse-mosquitto).
- Home Assistant MQTT integration (https://www.home-assistant.io/integrations/mqtt/)
- Create docker-compose.yaml
- Adjust environment variables as needed
- Start the container:
docker compose up -d
Example docker-compose.yaml:
version: '3.4'
services:
qbha:
image: thomasddn/qbha:latest
container_name: qbha
restart: unless-stopped
volumes:
- ./data:/data # Optional
environment:
MQTT_HOST: 192.168.0.123
TZ: Europe/Brussels
Check the wiki for more examples.
Key | Required | Default value | Description |
---|---|---|---|
MQTT_HOST | Y | <empty> | The IP or host name of the MQTT broker. |
MQTT_PORT | N | 1883 | The port of the MQTT broker. |
MQTT_USER | N | <empty> | The username to connect to the MQTT broker. |
MQTT_PWD | N | <empty> | The password to connect to the MQTT broker. |
BINARY_SENSORS | N | <empty> | Comma separated list of on/off entities to be created as binary sensors. You can use either the Qbus entity_id , ref_id or name to define an on/off entity. |
CLIMATE_PRESETS | N | MANUEEL, VORST, NACHT, ECONOMY, COMFORT | Comma separated list of climate presets you want to have available in HA. Also useful if your controller is set to another language. Applies to all climate entities. |
CLIMATE_SENSORS | N | False | Create sensors for climate entities, having the current temperature as state. |
QBUS_CAPTURE | N | False | Log all Qbus topic messages to a file, regardless of LOG_LEVEL. Used for debugging purposes. |
LOG_LEVEL | N | INFO | The log level to use. Can be one of the following: CRITICAL, ERROR, WARNING, INFO, DEBUG. |
Optionally, you can mount the /data
folder. It will contain log files and Qbus configuration files.
This project was inspired by https://github.com/QbusKoen/qbusMqtt and https://github.com/wk275/qbTools-v2.