Merge branch 'next' into frenck-2026-0414

Author: frenck

source/_integrations/duco.markdown

@@ -15,6 +15,7 @@ ha_platforms:
   - sensor
 ha_integration_type: hub
 ha_quality_scale: bronze
+ha_dhcp: true
 ha_zeroconf: true
 ---
 
@@ -37,16 +38,31 @@ Compatible DucoBox models:
 - DucoBox Energy Comfort / Energy Comfort Plus
 - DucoBox Energy Premium
 
+### Supported sensor modules
+
+The following sensor module types are supported:
+
+- **BOX**: The main ventilation box; provides fan control, ventilation state, and Wi-Fi signal strength.
+- **UCCO2**: Wall-mounted CO₂ sensor unit; provides CO₂ concentration and CO₂ air quality index.
+- **BSRH**: Humidity sensor module installed in the duct inlet of the DucoBox, wired directly to the PCB via cable; provides relative humidity and humidity air quality index.
+- **UCRH**: Wireless humidity sensor module; provides relative humidity and humidity air quality index.
+
+### Unsupported sensor modules
+
+The following sensor module types are discovered but not yet supported:
+
+- **UC**: Universal control unit (no sensor data exposed)
+- **UCBAT**: Battery-powered sensor module
+- **VLV**: Valve actuator
+
+When Home Assistant discovers a node with an unsupported type, it logs a warning and skips that node. All other nodes continue to work normally.
+
 ## Prerequisites
 
 - A Duco ventilation box with a DUCO Connectivity Board connected to your local network.
 
 {% include integrations/config_flow.md %}
 
-Your Duco ventilation box can be automatically discovered on your network when the device is connected and powered on. When Home Assistant discovers a new Duco device, it appears as a notification in the UI. Select the notification to complete the setup.
-
-If automatic discovery does not work, you can manually add the integration by providing the IP address or hostname.
-
 {% configuration_basic %}
 Host:
   description: "The IP address or hostname of your DUCO Connectivity Board on the local network, for example `192.168.1.10`. Only needed when setting up the integration manually."
@@ -56,9 +72,10 @@ 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)
-- **UCCO2** — a wireless CO₂ sensor module
-- **BSRH** — a humidity sensor module installed inside the DucoBox
+- **BOX**: The main DucoBox (fan control, ventilation state)
+- **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
 
 ### Fan
 
@@ -74,7 +91,7 @@ The following actions are available:
 - **Speed 100%**: High speed manual override.
 - **Auto preset**: Same as speed 0%; hands control back to Duco.
 
-When an external device (for example a CO₂ sensor or an RF wall switch) 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).
+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).
 
 ### Sensors
 
@@ -94,7 +111,7 @@ Available for CO₂ sensor modules. Shows the current CO₂ concentration in par
 
 #### Humidity
 
-Available for humidity sensor modules (BSRH). Shows the current relative humidity in percent.
+Available for humidity sensor modules (BSRH, UCRH). Shows the current relative humidity in percent.
 
 #### CO₂ air quality index
 
@@ -109,7 +126,7 @@ Indoor air quality ranges for CO₂:
 
 #### Humidity air quality index
 
-Available for humidity sensor modules (BSRH). Shows the humidity air quality score as a percentage (0–100%). This entity is disabled by default.
+Available for humidity sensor modules (BSRH, UCRH). Shows the humidity air quality score as a percentage (0–100%). This entity is disabled by default.
 
 Indoor air quality ranges for humidity:
 
@@ -228,8 +245,8 @@ The integration {% term polling polls %} the Duco box every 30 seconds. If you a
 
 ## Known limitations
 
-- The Duco box enforces a rate limit of approximately 200 write requests per day (HTTP 429, error code 18). The integration handles this gracefully, and the firmware resets the quota automatically around midnight.
-- Timed speed overrides set by external devices (such as an RF wall switch or a CO₂ sensor) cannot be triggered from Home Assistant. They are read-only: the current ventilation level is shown as a percentage, but setting a speed from Home Assistant always uses the permanent manual mode (a continuous override with no time limit).
+- The Duco box enforces a rate limit of 200 write requests per day. When the limit is reached, the integration shows a notification and stops sending write requests until the quota resets automatically around midnight.
+- Timed speed overrides set by a connected wall unit (such as a UCCO2) cannot be triggered from Home Assistant. They are read-only: the current ventilation level is shown as a percentage, but setting a speed from Home Assistant always uses the permanent manual mode (a continuous override with no time limit).
 - When you deregister a sensor module via the Duco app or firmware, the node disappears from the Duco API and Home Assistant removes it automatically on the next data update. However, a BSRH humidity sensor that is physically disconnected from the box PCB (rather than deregistered via software) is not treated as deregistered by the firmware. Its node remains in the API indefinitely, so its entities will stay in Home Assistant until you deregister it through the Duco app.
 
 ## Troubleshooting
@@ -239,7 +256,7 @@ The integration {% term polling polls %} the Duco box every 30 seconds. If you a
 If your Duco ventilation box is not automatically discovered:
 
 - Ensure the device is powered on and connected to the same network as Home Assistant.
-- Check that mDNS/Bonjour traffic is not blocked by your router or firewall.
+- Check that mDNS/Bonjour traffic is not blocked by your router or firewall. If it is, the integration can still discover the device automatically via DHCP the next time the device renews its IP address lease.
 - Verify the device name shows as "DUCO [MAC address]" in your router's device list or network scanner.
 - Manually add the integration using the device's IP address if discovery continues to fail.
 
@@ -264,15 +281,13 @@ Home Assistant cannot reach the Duco box at the configured address. This can hap
 
 #### Symptom
 
-Setting the fan speed or preset mode fails with an error like:
+Setting the fan speed or preset mode fails with a notification in the Home Assistant UI:
 
-```text
-Failed to set ventilation state: DucoError('Duco API error (429): {"Code":18,"Result":"FAILED"}')
-```
+> The Duco device has reached its daily write limit. Try again tomorrow.
 
 #### Description
 
-The Duco box enforces a write rate limit of 200 write requests per day. When the limit is reached, the box rejects further write requests with a 429 error until the quota resets around midnight.
+The Duco box enforces a write rate limit of 200 write requests per day. When the limit is reached, the box rejects further write requests until the quota resets around midnight.
 
 #### Resolution
 

source/_integrations/html5.markdown

@@ -213,18 +213,29 @@ When using a relative path for an image or icon URL, the path is resolved relati
 
 {% endnote %}
 
-### Dismiss
+### Action: Dismiss message
 
-You can dismiss notifications by using `html5.dismiss` action like so:
+You can dismiss notifications using the `html5.dismiss_message` action.
+
+- **Data attribute**: `tag`
+  - **Description**: The tag of the notifications to dismiss. If not specified, all notifications to the selected devices will be dismissed.
+  - **Optional**: Yes
+
+{% details "Example YAML configuration" %}
+
+{% raw %}
 
 ```yaml
-target: ['my phone']
+action: html5.dismiss_message
 data:
-  tag: notification_tag
+  tag: message-group-1
+target:
+  entity_id: notify.my_desktop
 ```
 
-If no target is provided, it dismisses for all.
-If no tag is provided, it dismisses all notifications.
+{% endraw %}
+
+{% enddetails %}
 
 ## Automating notification events
 

source/_integrations/knx.markdown

@@ -617,7 +617,9 @@ type:
 
 ### Entity exposures
 
-Expose Home Assistant entities to share their state or attributes with the KNX bus. Home Assistant automatically sends the current value whenever it changes and responds to read requests on the KNX bus.
+Expose Home Assistant entities to share their state or attributes with the KNX bus. Home Assistant automatically sends the current value whenever it changes and responds to read requests on the KNX bus. This can be configured from the frontend in the KNX panel or via YAML.
+
+{% details "Configuration of entity exposures via YAML" %}
 
 {% raw %}
 
@@ -710,6 +712,8 @@ respond_to_read:
   default: true
 {% endconfiguration %}
 
+{% enddetails %}
+
 ## Entity platforms
 
 ### Common entity configuration options

source/_integrations/melcloud.markdown

@@ -93,13 +93,35 @@ The system cannot be turned on/off through the `climate` entities.
 
 The following attributes are available for `sensor` platform entities:
 
-- Room temperature for each zone
-- Tank water temperature
-- Outside temperature - 1°C precision, polled every 1-2 hours.
+**Zone sensors** (per radiator zone):
+
+- Room temperature
 - Zone flow temperature, polled every 1-2 hours
-- Zone flow return temperature, polled every 1-2 hours
+- Zone return temperature, polled every 1-2 hours
 
-Unlike air-to-air devices, air-to-water devices do not report energy consumption in an easily accessible manner.
+**Device sensors:**
+
+- Tank water temperature
+- Outside temperature – 1°C precision, polled every 1-2 hours
+- System flow temperature
+- System return temperature
+- Boiler flow temperature
+- Boiler return temperature
+- Mixing tank temperature
+- Condensing temperature
+- Heat pump frequency (compressor frequency in Hz)
+- Demand percentage
+- Daily heating energy:
+  - Consumed
+  - Produced
+- Daily cooling energy:
+  - Consumed
+  - Produced
+- Daily hot water energy:
+  - Consumed
+  - Produced
+
+The daily energy sensors use the state class `total_increasing` and are compatible with the Energy Dashboard. Values reset at midnight in the MELCloud service timezone.
 
 ### Binary sensor
 

source/_integrations/onedrive.markdown

@@ -94,17 +94,36 @@ This integration provides the following actions:
 
 ### Action `onedrive.upload`
 
-You can use the `onedrive.upload` action to upload files from Home Assistant
-to OneDrive. For example, to upload `camera` snapshots.
+You can use the `onedrive.upload` action to upload one or more files from Home Assistant to OneDrive. For example, to upload `camera` snapshots.
 
 {% details "Upload action details" %}
 
 | Data attribute | Optional | Description | Example |
 | ---------------------- | -------- | ----------- | --------|
-| `filename` | no | Path to the file to upload. | /media/image.jpg |
-| `destination_folder` | no | Folder inside your `Apps/Home Assistant` app folder that is the destination for the uploaded content. Will be created if it does not exist. Supports subfolders. | Snapshots/2025 |
+| `filename` | no | One or more local file paths to upload. Accepts a single string or a list of strings. | /media/image.jpg |
+| `destination_folder` | no | Folder inside your `Apps/Home Assistant` app folder that is the destination for the uploaded files. Will be created if it does not exist. Supports subfolders. | Snapshots/2025 |
 | `config_entry_id` | no | The ID of the OneDrive config entry (the OneDrive you want to upload to). | a1bee602deade2b09bc522749bbce48e |
 
+{% raw %}
+
+```yaml
+# Upload a single file
+action: onedrive.upload
+data:
+  filename: /media/image.jpg
+  destination_folder: Snapshots/2025
+
+# Upload multiple files
+action: onedrive.upload
+data:
+  filename:
+    - /media/image_1.jpg
+    - /media/image_2.jpg
+  destination_folder: Snapshots/2025
+```
+
+{% endraw %}
+
 {% enddetails %}
 
 ## Automations

source/_integrations/portainer.markdown

@@ -53,6 +53,9 @@ There is currently support for the following device types within Home Assistant:
 ### Buttons
 
 - **Restart container**: Restarts the container.
+- **Pause container**: Pauses the container.
+- **Resume container**: Resumes the container.
+- **Recreate container**: Recreates the container by pulling the latest tagged image.
 - **Prune unused images**: Removes unused Docker images from the endpoint.
 
 ### Sensors