Skip to content

Add sensor documentation to Duco integration #45039

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
c0ffeeca7 merged 3 commits into from
Apr 30, 2026
Merged

Add sensor documentation to Duco integration #45039

Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
5eeebc0
Add sensor documentation to Duco integration
ronaldvdmeer Apr 27, 2026
c6c7907
Update BOX description in Supported functionality to include new sensors
ronaldvdmeer Apr 28, 2026
f4fa92a
Rename 'Mode time remaining' to 'Mode end time' in Duco docs
ronaldvdmeer Apr 30, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
16 changes: 14 additions & 2 deletions source/_integrations/duco.markdown
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -42,7 +42,7 @@ Compatible DucoBox models:

The following sensor module types are supported:

- **BOX**: The main ventilation box; provides fan control, ventilation state, Wi-Fi signal strength, and temperature (measured inside the housing; disabled by default).
- **BOX**: The main ventilation box; provides fan control, ventilation state, target flow level, mode end time, Wi-Fi signal strength, and temperature (measured inside the housing; disabled by default).
- **UCCO2**: Wall-mounted CO₂ sensor unit; provides CO₂ concentration, CO₂ air quality index, and temperature.
- **BSRH**: Humidity sensor module installed in the duct inlet of the DucoBox, wired directly to the PCB via cable; provides relative humidity, humidity air quality index, and temperature.
- **UCRH**: Wireless humidity sensor module; provides relative humidity, humidity air quality index, and temperature.
Expand Down Expand Up @@ -72,7 +72,7 @@ Host:

The Duco system consists of multiple nodes. Each node appears as a separate device in Home Assistant, connected to the main ventilation box:

- **BOX**: The main DucoBox (fan control, ventilation state)
- **BOX**: The main DucoBox (fan control, ventilation state, target flow level, mode end time)
- **UCCO2**: A wall-mounted control unit with a built-in CO₂ sensor
- **BSRH**: A humidity sensor module installed in the duct inlet of the DucoBox
- **UCRH**: A wireless humidity sensor module
Expand All @@ -93,10 +93,18 @@ The following actions are available:

When a connected wall unit (such as a UCCO2) triggers a timed speed override on the Duco box, Home Assistant reflects the current ventilation level as a percentage. These timed states cannot be set from Home Assistant; writing a speed always uses the permanent manual mode (a continuous override with no time limit).

{% note %}
The percentages 33%, 66%, and 100% are abstract speed levels used in the Home Assistant fan UI and do not match the actual airflow percentages configured in the Duco firmware. To see the real airflow target, use the **Target flow level** sensor.
{% endnote %}

### Sensors

The following sensor entities are created per node, depending on the node type:

#### Target flow level

Available for the main ventilation box (BOX). Shows the actual airflow target as reported by the Duco box, as a percentage (0–100%). This value reflects the real airflow configured in the Duco firmware and differs from the abstract speed levels (33%, 66%, or 100%) shown in the fan entity. For example, if your Duco system is configured with manual speed levels of 15%, 30%, and 100%, this sensor shows those values.

#### Ventilation state

Available for the main ventilation box (BOX). Shows the current ventilation state, for example:
Expand All @@ -105,6 +113,10 @@ Available for the main ventilation box (BOX). Shows the current ventilation stat
- Continuous high speed
- Manual low speed (15 min)

#### Mode end time

Available for the main ventilation box (BOX). Shows the time at which the current timed ventilation mode ends. When no timer is active, this sensor is unavailable.

#### CO₂ concentration

Available for CO₂ sensor modules. Shows the current CO₂ concentration in parts per million (ppm).
Expand Down