From 5eeebc0abb4277dd23e3e16a8764a7275f430a29 Mon Sep 17 00:00:00 2001 From: Ronald van der Meer Date: Mon, 27 Apr 2026 16:46:33 +0200 Subject: [PATCH 1/3] Add sensor documentation to Duco integration --- source/_integrations/duco.markdown | 14 +++++++++++++- 1 file changed, 13 insertions(+), 1 deletion(-) diff --git a/source/_integrations/duco.markdown b/source/_integrations/duco.markdown index 02836afaf814..92cf3585a4e7 100644 --- a/source/_integrations/duco.markdown +++ b/source/_integrations/duco.markdown @@ -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 time remaining, 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. @@ -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: @@ -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 time remaining + +Available for the main ventilation box (BOX). Shows the number of seconds remaining in the current timed ventilation mode. When no timer is active, the value is 0. + #### CO₂ concentration Available for CO₂ sensor modules. Shows the current CO₂ concentration in parts per million (ppm). From c6c7907eaf4adefcd8acfa475f41ec04b893c1a8 Mon Sep 17 00:00:00 2001 From: Ronald van der Meer Date: Tue, 28 Apr 2026 08:50:23 +0200 Subject: [PATCH 2/3] Update BOX description in Supported functionality to include new sensors --- source/_integrations/duco.markdown | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/_integrations/duco.markdown b/source/_integrations/duco.markdown index 92cf3585a4e7..54e53e243e8c 100644 --- a/source/_integrations/duco.markdown +++ b/source/_integrations/duco.markdown @@ -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 time remaining) - **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 From f4fa92a019a1677bf24a38fd064bae46626ce738 Mon Sep 17 00:00:00 2001 From: Ronald van der Meer Date: Thu, 30 Apr 2026 12:48:49 +0200 Subject: [PATCH 3/3] Rename 'Mode time remaining' to 'Mode end time' in Duco docs The sensor was renamed in the core PR from a countdown sensor (seconds remaining) to a timestamp sensor (when the mode ends). Update all three occurrences in the docs and revise the description to reflect the new behavior. Addresses review feedback from c0ffeeca7. --- source/_integrations/duco.markdown | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/source/_integrations/duco.markdown b/source/_integrations/duco.markdown index 54e53e243e8c..63f2726f861c 100644 --- a/source/_integrations/duco.markdown +++ b/source/_integrations/duco.markdown @@ -42,7 +42,7 @@ Compatible DucoBox models: The following sensor module types are supported: -- **BOX**: The main ventilation box; provides fan control, ventilation state, target flow level, mode time remaining, 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. @@ -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, target flow level, mode time remaining) +- **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 @@ -113,9 +113,9 @@ Available for the main ventilation box (BOX). Shows the current ventilation stat - Continuous high speed - Manual low speed (15 min) -#### Mode time remaining +#### Mode end time -Available for the main ventilation box (BOX). Shows the number of seconds remaining in the current timed ventilation mode. When no timer is active, the value is 0. +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