From d61fd294933b4d74a9d262e3c48da262e462626b Mon Sep 17 00:00:00 2001 From: theobld-ww Date: Mon, 11 May 2026 17:34:48 +0200 Subject: [PATCH 1/8] Add timer mode action to Watts doc --- source/_integrations/watts.markdown | 20 ++++++++++++++++++++ 1 file changed, 20 insertions(+) diff --git a/source/_integrations/watts.markdown b/source/_integrations/watts.markdown index bd4ea7465148..ef516ae00ba6 100644 --- a/source/_integrations/watts.markdown +++ b/source/_integrations/watts.markdown @@ -160,6 +160,26 @@ actions: {% enddetails %} +## Actions + +### Action: Activate timer mode + +The `watts.activate_timer_mode` action sets the thermostat to **Timer** mode with a target temperature and duration. When the timer expires, the thermostat returns to its previous mode. + +- `temperature`: Target temperature to hold while the timer is active. +- `duration`: Duration of the timer in minutes (1–1440). + +Example: + +```yaml +action: watts.activate_timer_mode +target: + entity_id: climate.living_room_thermostat +data: + temperature: 21 + duration: 90 +``` + ## Known limitations - **BRT-WR02-RF devices paired as heaters** are not exposed as separate switch entities in Home Assistant. From 5a29058a0e18947dd3876be9cfb829b0acf67ad9 Mon Sep 17 00:00:00 2001 From: theobld-ww Date: Mon, 11 May 2026 17:38:00 +0200 Subject: [PATCH 2/8] use array for params --- source/_integrations/watts.markdown | 6 ++++-- 1 file changed, 4 insertions(+), 2 deletions(-) diff --git a/source/_integrations/watts.markdown b/source/_integrations/watts.markdown index ef516ae00ba6..923a576cb7ac 100644 --- a/source/_integrations/watts.markdown +++ b/source/_integrations/watts.markdown @@ -166,8 +166,10 @@ actions: The `watts.activate_timer_mode` action sets the thermostat to **Timer** mode with a target temperature and duration. When the timer expires, the thermostat returns to its previous mode. -- `temperature`: Target temperature to hold while the timer is active. -- `duration`: Duration of the timer in minutes (1–1440). +| Data attribute | Optional | Description | +| -------------- | -------- | ----------- | +| `temperature` | No | Target temperature to hold while the timer is active | +| `duration` | No | Duration of the timer in minutes (1–1440) | Example: From b1d077219e1cacca31e29e26b07e2d2c4dfbd9de Mon Sep 17 00:00:00 2001 From: theobld-ww <60600399+theobld-ww@users.noreply.github.com> Date: Mon, 11 May 2026 17:40:59 +0200 Subject: [PATCH 3/8] Potential fix for pull request finding Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com> --- source/_integrations/watts.markdown | 8 +++----- 1 file changed, 3 insertions(+), 5 deletions(-) diff --git a/source/_integrations/watts.markdown b/source/_integrations/watts.markdown index 923a576cb7ac..efca8c038e15 100644 --- a/source/_integrations/watts.markdown +++ b/source/_integrations/watts.markdown @@ -160,14 +160,12 @@ actions: {% enddetails %} -## Actions - -### Action: Activate timer mode +## Activate timer mode action The `watts.activate_timer_mode` action sets the thermostat to **Timer** mode with a target temperature and duration. When the timer expires, the thermostat returns to its previous mode. -| Data attribute | Optional | Description | -| -------------- | -------- | ----------- | +- `temperature`: Target temperature to hold while the timer is active +- `duration`: Duration of the timer in minutes (1–1440) | `temperature` | No | Target temperature to hold while the timer is active | | `duration` | No | Duration of the timer in minutes (1–1440) | From 9ee9e50470b2319f00c375331836cb87c394aa2d Mon Sep 17 00:00:00 2001 From: theobld-ww Date: Mon, 11 May 2026 17:43:17 +0200 Subject: [PATCH 4/8] fix doc --- source/_integrations/watts.markdown | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/source/_integrations/watts.markdown b/source/_integrations/watts.markdown index efca8c038e15..4024f65e9996 100644 --- a/source/_integrations/watts.markdown +++ b/source/_integrations/watts.markdown @@ -160,12 +160,12 @@ actions: {% enddetails %} -## Activate timer mode action +### Action: Activate timer mode The `watts.activate_timer_mode` action sets the thermostat to **Timer** mode with a target temperature and duration. When the timer expires, the thermostat returns to its previous mode. -- `temperature`: Target temperature to hold while the timer is active -- `duration`: Duration of the timer in minutes (1–1440) +| Data attribute | Optional | Description | +| -------------- | -------- | ----------- | | `temperature` | No | Target temperature to hold while the timer is active | | `duration` | No | Duration of the timer in minutes (1–1440) | From 1aa8e2bf007cd8ca3c899804b7a00d38f829fe19 Mon Sep 17 00:00:00 2001 From: theobld-ww Date: Mon, 11 May 2026 20:07:04 +0200 Subject: [PATCH 5/8] improve style --- source/_integrations/watts.markdown | 18 ++++++++++-------- 1 file changed, 10 insertions(+), 8 deletions(-) diff --git a/source/_integrations/watts.markdown b/source/_integrations/watts.markdown index 4024f65e9996..7499dfc95363 100644 --- a/source/_integrations/watts.markdown +++ b/source/_integrations/watts.markdown @@ -107,7 +107,6 @@ All Watts Vision + devices share common functionality: - **Device information**: Manufacturer (Watts), model information, and device identification - **Availability**: Entities show as unavailable when devices are offline or communication fails - ## Data updates The Watts Vision + integration {% term polling polls %} data from the cloud API every 30 seconds. After sending commands (temperature changes, mode changes, or switch operations), the integration waits 7 seconds before refreshing to allow the device to process the change. @@ -160,7 +159,9 @@ actions: {% enddetails %} -### Action: Activate timer mode +## Actions + +### Activate timer mode The `watts.activate_timer_mode` action sets the thermostat to **Timer** mode with a target temperature and duration. When the timer expires, the thermostat returns to its previous mode. @@ -172,12 +173,13 @@ The `watts.activate_timer_mode` action sets the thermostat to **Timer** mode wit Example: ```yaml -action: watts.activate_timer_mode -target: - entity_id: climate.living_room_thermostat -data: - temperature: 21 - duration: 90 +actions: + - action: watts.activate_timer_mode + target: + entity_id: climate.living_room_thermostat + data: + temperature: 21 + duration: 90 ``` ## Known limitations From 2d0434821cda313c2b65b392b65633d468f930a5 Mon Sep 17 00:00:00 2001 From: theobld-ww Date: Mon, 11 May 2026 20:20:50 +0200 Subject: [PATCH 6/8] use standard action title --- source/_integrations/watts.markdown | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/_integrations/watts.markdown b/source/_integrations/watts.markdown index 7499dfc95363..d5c73869bbdf 100644 --- a/source/_integrations/watts.markdown +++ b/source/_integrations/watts.markdown @@ -161,7 +161,7 @@ actions: ## Actions -### Activate timer mode +### Action: Activate timer mode The `watts.activate_timer_mode` action sets the thermostat to **Timer** mode with a target temperature and duration. When the timer expires, the thermostat returns to its previous mode. From f6a863c01735ef1e31ce9f219f0cb492dfd4db34 Mon Sep 17 00:00:00 2001 From: theobld-ww Date: Tue, 12 May 2026 11:11:35 +0200 Subject: [PATCH 7/8] follow new action doc structure --- .../watts.activate_timer_mode.markdown | 117 ++++++++++++++++++ source/_integrations/watts.markdown | 23 +--- 2 files changed, 118 insertions(+), 22 deletions(-) create mode 100644 source/_actions/watts.activate_timer_mode.markdown diff --git a/source/_actions/watts.activate_timer_mode.markdown b/source/_actions/watts.activate_timer_mode.markdown new file mode 100644 index 000000000000..8452ae869445 --- /dev/null +++ b/source/_actions/watts.activate_timer_mode.markdown @@ -0,0 +1,117 @@ +--- +title: "Activate timer mode" +action: watts.activate_timer_mode +domain: watts +description: "Set a thermostat to timer mode with a target temperature and duration." +--- + +The **Activate timer mode** action sets a Watts Vision + thermostat to **Timer** mode with a target temperature and duration. When the timer expires, the thermostat returns to its previous mode. + +Use it when you want a temporary temperature boost, for example, to warm up a bathroom before a shower. + +{% include actions/ui_header.md %} + +To use this action in an automation or script: + +1. Go to {% my automations title="**Settings** > **Automations & scenes**" %}. +2. Open an existing automation or script, or select **Create automation** > **Create new automation**. +3. If you're setting up a new automation, add a trigger in the **When** section. Scripts don't need a trigger. They run when something else calls them. +4. In the **Then do** section, select **Add action**. +5. From the search box, search for and select **Watts Vision +: Activate timer mode**. +6. Select the climate entity you want to control. +7. Set the **Temperature** and **Duration**. +8. Select **Save**. + +### Options in the UI + +{% options_ui %} +Temperature: + description: Target temperature to hold while the timer is active. +Duration: + description: Duration of the timer in minutes (1–1440). +{% endoptions_ui %} + +{% include actions/yaml_header.md %} + +In YAML, refer to this action as `watts.activate_timer_mode`. A basic example looks like this: + +{% example %} +action: | + action: watts.activate_timer_mode + target: + entity_id: climate.living_room_thermostat + data: + temperature: 21 + duration: 90 +{% endexample %} + +This sets the living room thermostat to 21°C for 90 minutes, then returns to its previous mode. + +### Options in YAML + +YAML sometimes provides additional options for more complex use cases that are not available through the UI. + +{% options_yaml %} +temperature: + description: > + Target temperature to hold while the timer is active. + required: true + type: float +duration: + description: > + Duration of the timer in minutes. Accepts a value between 1 and 1440. + required: true + type: integer +{% endoptions_yaml %} + +{% include actions/targets.md %} + +## Good to know + +- When the timer expires, the thermostat automatically returns to its previous mode. +- The maximum duration is 1440 minutes (24 hours). + +{% include actions/try_it.md %} + +{% include actions/more_examples.md %} + +### Automation: warm up the bathroom before a morning shower + +Every weekday morning, boost the bathroom thermostat to a comfortable temperature for 30 minutes. + +- **Trigger**: Time: 06:30 on weekdays +- **Action**: Watts Vision +: Activate timer mode +- **Target**: Bathroom thermostat +- **Temperature**: 23 +- **Duration**: 30 + +{% details "YAML example for a morning bathroom warm-up" %} + +{% example %} +automation: | + alias: "Morning bathroom warm-up" + triggers: + - trigger: time + at: "06:30:00" + conditions: + - condition: time + weekday: + - mon + - tue + - wed + - thu + - fri + actions: + - action: watts.activate_timer_mode + target: + entity_id: climate.bathroom_thermostat + data: + temperature: 23 + duration: 30 +{% endexample %} + +{% enddetails %} + +{% include actions/stuck.md %} + +{% include actions/related.md %} diff --git a/source/_integrations/watts.markdown b/source/_integrations/watts.markdown index d5c73869bbdf..7ede5d322357 100644 --- a/source/_integrations/watts.markdown +++ b/source/_integrations/watts.markdown @@ -159,28 +159,7 @@ actions: {% enddetails %} -## Actions - -### Action: Activate timer mode - -The `watts.activate_timer_mode` action sets the thermostat to **Timer** mode with a target temperature and duration. When the timer expires, the thermostat returns to its previous mode. - -| Data attribute | Optional | Description | -| -------------- | -------- | ----------- | -| `temperature` | No | Target temperature to hold while the timer is active | -| `duration` | No | Duration of the timer in minutes (1–1440) | - -Example: - -```yaml -actions: - - action: watts.activate_timer_mode - target: - entity_id: climate.living_room_thermostat - data: - temperature: 21 - duration: 90 -``` +{% include integrations/actions.md %} ## Known limitations From a15a920157eba8b825ba8285be46efdf702346fd Mon Sep 17 00:00:00 2001 From: theobld-ww Date: Tue, 12 May 2026 14:14:49 +0200 Subject: [PATCH 8/8] Update exemple to use float --- source/_actions/watts.activate_timer_mode.markdown | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/source/_actions/watts.activate_timer_mode.markdown b/source/_actions/watts.activate_timer_mode.markdown index 8452ae869445..068c229af779 100644 --- a/source/_actions/watts.activate_timer_mode.markdown +++ b/source/_actions/watts.activate_timer_mode.markdown @@ -41,11 +41,11 @@ action: | target: entity_id: climate.living_room_thermostat data: - temperature: 21 + temperature: 21.5 duration: 90 {% endexample %} -This sets the living room thermostat to 21°C for 90 minutes, then returns to its previous mode. +This sets the living room thermostat to 21.5°C for 90 minutes, then returns to its previous mode. ### Options in YAML @@ -81,9 +81,9 @@ Every weekday morning, boost the bathroom thermostat to a comfortable temperatur - **Trigger**: Time: 06:30 on weekdays - **Action**: Watts Vision +: Activate timer mode -- **Target**: Bathroom thermostat -- **Temperature**: 23 -- **Duration**: 30 + - **Target**: Bathroom thermostat + - **Temperature**: 23 + - **Duration**: 30 {% details "YAML example for a morning bathroom warm-up" %}