From e1c6a1b67aa2246289ad7129a685d3bd104070f4 Mon Sep 17 00:00:00 2001 From: Brandon Harvey <8107750+bharvey88@users.noreply.github.com> Date: Fri, 26 Jun 2026 11:35:07 -0500 Subject: [PATCH] Add TEMP-1 hot water recirculation use-case page and fix broken doc links (#980) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit New page under TEMP-1 > Examples, "Hot Water Recirculation with TEMP-1" (contributed by Donovan): an SVG plumbing schematic, a Mermaid control-logic diagram, a parts list, and the ESPHome probe config (3s update + heartbeat). Also fixes broken links flagged by mkdocs build: - ESPHome Starter Kit URL-style links now point at the .md source (anchors kept) - PLT-1B battery images use root-absolute /assets so they resolve in the Homey snippet include too - AIR-1 and general co2-calibration relative links corrected (depth + .md) 🤖 Generated with [Claude Code](https://claude.com/claude-code) --- docs/assets/temp1-hot-water-recirculation.svg | 83 ++++++++++++++++ .../homey/products/air1/setup/general-tips.md | 2 +- .../automations/button-controlled-leds.md | 10 +- .../how-esphome-talks-to-home-assistant.md | 2 +- .../modules/apollo-breakout-module.md | 4 +- .../modules/button-module.md | 4 +- .../modules/motion-module.md | 4 +- .../modules/rgb-buzzer-module.md | 4 +- .../modules/temperature-humidity-module.md | 4 +- .../ESPHome-Starter-Kit/setup/first-steps.md | 2 +- .../tutorials/light-effects.md | 6 +- docs/products/air1/faq.md | 2 +- docs/products/air1/setup/general-tips.md | 2 +- .../co2-calibration-quick.md | 2 +- .../plt1b/additional-info/insert-battery.md | 12 +-- .../temp1/examples/hot-water-recirculation.md | 99 +++++++++++++++++++ mkdocs.yml | 1 + 17 files changed, 213 insertions(+), 30 deletions(-) create mode 100644 docs/assets/temp1-hot-water-recirculation.svg create mode 100644 docs/products/temp1/examples/hot-water-recirculation.md diff --git a/docs/assets/temp1-hot-water-recirculation.svg b/docs/assets/temp1-hot-water-recirculation.svg new file mode 100644 index 0000000000..fce280af41 --- /dev/null +++ b/docs/assets/temp1-hot-water-recirculation.svg @@ -0,0 +1,83 @@ + + + + + + + + + + Hot Water Recirculation with TEMP-1 + + + + WALL (house side ◀ | ▶ under-sink) + + + + + + + + + + + + + + + + + + + + + + House + Water Heater + (main, unlimited) + + + + Circulator + Pump + + + + + + + Apollo TEMP-1 + reads wall-hot temp + + + + + Bosch + Mini Tank + 2.5 gal, instant + + + + + 3-way + motorized + valve + + + + + Bathroom Sinks + hot + cold to taps + + + powered → wall · off → Bosch + + + + Hot + Cold + Recirculation flow + Switched smart-strip outlet + + diff --git a/docs/homey/products/air1/setup/general-tips.md b/docs/homey/products/air1/setup/general-tips.md index 9d97d0e762..f7b52e7226 100755 --- a/docs/homey/products/air1/setup/general-tips.md +++ b/docs/homey/products/air1/setup/general-tips.md @@ -145,7 +145,7 @@ The latest AIR-1 firmware keeps the SCD40 calibrated automatically. The sensor a !!! warning "Auto calibration needs regular fresh air" - If your AIR-1 sits in a space that rarely gets fresh air (a sealed office, a basement, a grow room), automatic self-calibration will slowly drag the CO2 readings down. Turn off the **CO2 Auto Calibration** switch in your device's settings and follow the [manual calibration guide](../../../general/calibrating-and-updating/co2-calibration/) every 1 to 2 years instead. + If your AIR-1 sits in a space that rarely gets fresh air (a sealed office, a basement, a grow room), automatic self-calibration will slowly drag the CO2 readings down. Turn off the **CO2 Auto Calibration** switch in your device's settings and follow the [manual calibration guide](../../general/calibrating-and-updating/co2-calibration.md) every 1 to 2 years instead. ![](/assets/co2-levels-drop-after-hvac-on.png) diff --git a/docs/products/ESPHome-Starter-Kit/automations/button-controlled-leds.md b/docs/products/ESPHome-Starter-Kit/automations/button-controlled-leds.md index 829f452556..86b16fbf56 100644 --- a/docs/products/ESPHome-Starter-Kit/automations/button-controlled-leds.md +++ b/docs/products/ESPHome-Starter-Kit/automations/button-controlled-leds.md @@ -14,15 +14,15 @@ This tutorial uses the Button module and the RGB & Buzzer module connected to th Work through these pages first. This tutorial assumes your device is flashed and both modules are connected: - * [First Steps](/products/ESPHome-Starter-Kit/setup/first-steps/) to create your starter kit device in ESPHome Device Builder. - * [Adding the Button Module](/products/ESPHome-Starter-Kit/modules/button-module/) to wire up the input. - * [Adding the LED & Buzzer Module](/products/ESPHome-Starter-Kit/modules/rgb-buzzer-module/) to wire up the RGB output. + * [First Steps](/products/ESPHome-Starter-Kit/setup/first-steps.md) to create your starter kit device in ESPHome Device Builder. + * [Adding the Button Module](/products/ESPHome-Starter-Kit/modules/button-module.md) to wire up the input. + * [Adding the LED & Buzzer Module](/products/ESPHome-Starter-Kit/modules/rgb-buzzer-module.md) to wire up the RGB output. ## Build the automation ESPHome Device Builder has a new GUI for building automations, so you can wire a trigger to an action without hand-writing YAML. The trigger is the *when* of the automation, the thing that makes it fire. The action is the *then do*, what happens when it fires. If you've built automations in Home Assistant, this is the same mental model. -1. Open your starter kit device in ESPHome Device Builder and click **Edit**. If you need a refresher on the editor, see the [Device Builder Tour](/products/ESPHome-Starter-Kit/learning-the-basics/device-builder-tour/#editor). +1. Open your starter kit device in ESPHome Device Builder and click **Edit**. If you need a refresher on the editor, see the [Device Builder Tour](/products/ESPHome-Starter-Kit/learning-the-basics/device-builder-tour.md#editor). 2. In the editor's left pane, expand the **Automations** dropdown and click **Add Automation**. ![](../../../assets/esphome-device-builder-add-automation.gif) @@ -72,7 +72,7 @@ ESPHome Device Builder has a new GUI for building Back - What is secrets.yaml? Tutorial - Connect to Home Assistant diff --git a/docs/products/ESPHome-Starter-Kit/modules/apollo-breakout-module.md b/docs/products/ESPHome-Starter-Kit/modules/apollo-breakout-module.md index 42fde7e20a..628724c7e1 100644 --- a/docs/products/ESPHome-Starter-Kit/modules/apollo-breakout-module.md +++ b/docs/products/ESPHome-Starter-Kit/modules/apollo-breakout-module.md @@ -16,8 +16,8 @@ The Breakout Module gives your starter kit room to grow. It breaks the ESP32-C6' Work through the two prerequisites first: - * [Start Here](/products/ESPHome-Starter-Kit/start-here/) to snap the module off the panel. - * [First Steps](/products/ESPHome-Starter-Kit/setup/first-steps/) to install ESPHome Device Builder and create your starter kit device. + * [Start Here](/products/ESPHome-Starter-Kit/start-here.md) to snap the module off the panel. + * [First Steps](/products/ESPHome-Starter-Kit/setup/first-steps.md) to install ESPHome Device Builder and create your starter kit device. #### Prerequisite diff --git a/docs/products/ESPHome-Starter-Kit/modules/button-module.md b/docs/products/ESPHome-Starter-Kit/modules/button-module.md index 8fadc3e3ee..76e9518244 100644 --- a/docs/products/ESPHome-Starter-Kit/modules/button-module.md +++ b/docs/products/ESPHome-Starter-Kit/modules/button-module.md @@ -12,8 +12,8 @@ The button module is the first input your starter kit gets, and the fastest way Work through the two prerequisites first: - * [Start Here](/products/ESPHome-Starter-Kit/start-here/) to snap the button module off the panel. - * [First Steps](/products/ESPHome-Starter-Kit/setup/first-steps/) to install ESPHome Device Builder and create your starter kit device. + * [Start Here](/products/ESPHome-Starter-Kit/start-here.md) to snap the button module off the panel. + * [First Steps](/products/ESPHome-Starter-Kit/setup/first-steps.md) to install ESPHome Device Builder and create your starter kit device. #### Prerequisite diff --git a/docs/products/ESPHome-Starter-Kit/modules/motion-module.md b/docs/products/ESPHome-Starter-Kit/modules/motion-module.md index a20e13f81b..d5e5f20fdc 100755 --- a/docs/products/ESPHome-Starter-Kit/modules/motion-module.md +++ b/docs/products/ESPHome-Starter-Kit/modules/motion-module.md @@ -12,8 +12,8 @@ The Motion Module turns your starter kit into a motion sensor. By the end of thi Work through the two prerequisites first: - * [Start Here](/products/ESPHome-Starter-Kit/start-here/) to snap the motion module off the panel. - * [First Steps](/products/ESPHome-Starter-Kit/setup/first-steps/) to install ESPHome Device Builder and create your starter kit device. + * [Start Here](/products/ESPHome-Starter-Kit/start-here.md) to snap the motion module off the panel. + * [First Steps](/products/ESPHome-Starter-Kit/setup/first-steps.md) to install ESPHome Device Builder and create your starter kit device. #### Prerequisite diff --git a/docs/products/ESPHome-Starter-Kit/modules/rgb-buzzer-module.md b/docs/products/ESPHome-Starter-Kit/modules/rgb-buzzer-module.md index 1499ffade7..91c47eec7f 100755 --- a/docs/products/ESPHome-Starter-Kit/modules/rgb-buzzer-module.md +++ b/docs/products/ESPHome-Starter-Kit/modules/rgb-buzzer-module.md @@ -12,8 +12,8 @@ The LED & Buzzer is the starter kit's notification module, a strip of ten addres Work through the two prerequisites first: - * [Start Here](/products/ESPHome-Starter-Kit/start-here/) to snap the RGB & Buzzer module off the panel. - * [First Steps](/products/ESPHome-Starter-Kit/setup/first-steps/) to install ESPHome Device Builder and create your starter kit device. + * [Start Here](/products/ESPHome-Starter-Kit/start-here.md) to snap the RGB & Buzzer module off the panel. + * [First Steps](/products/ESPHome-Starter-Kit/setup/first-steps.md) to install ESPHome Device Builder and create your starter kit device. #### Prerequisite diff --git a/docs/products/ESPHome-Starter-Kit/modules/temperature-humidity-module.md b/docs/products/ESPHome-Starter-Kit/modules/temperature-humidity-module.md index 26e5fa06d9..12e23ee706 100755 --- a/docs/products/ESPHome-Starter-Kit/modules/temperature-humidity-module.md +++ b/docs/products/ESPHome-Starter-Kit/modules/temperature-humidity-module.md @@ -13,8 +13,8 @@ The temperature and humidity module is your starter kit's first environmental se Work through the two prerequisites first: - * [Start Here](/products/ESPHome-Starter-Kit/start-here/) to snap the temperature and humidity module off the panel. - * [First Steps](/products/ESPHome-Starter-Kit/setup/first-steps/) to install ESPHome Device Builder and create your starter kit device. + * [Start Here](/products/ESPHome-Starter-Kit/start-here.md) to snap the temperature and humidity module off the panel. + * [First Steps](/products/ESPHome-Starter-Kit/setup/first-steps.md) to install ESPHome Device Builder and create your starter kit device. #### Prerequisite diff --git a/docs/products/ESPHome-Starter-Kit/setup/first-steps.md b/docs/products/ESPHome-Starter-Kit/setup/first-steps.md index f7831d0e1a..722136f275 100755 --- a/docs/products/ESPHome-Starter-Kit/setup/first-steps.md +++ b/docs/products/ESPHome-Starter-Kit/setup/first-steps.md @@ -222,7 +222,7 @@ Before we continue, confirm that you installed the ESPHome Device Builder, confi ### Test your LED -Your kit's default project includes the [**Web Server**](../../learning-the-basics/core-components/#web-server) component, which lets you navigate to the IP address of your device or the hostname.local such as http://esphome-starter-kit.local/ +Your kit's default project includes the [**Web Server**](../learning-the-basics/core-components.md#web-server) component, which lets you navigate to the IP address of your device or the hostname.local such as http://esphome-starter-kit.local/ !!! warning "Use http:// not https://" diff --git a/docs/products/ESPHome-Starter-Kit/tutorials/light-effects.md b/docs/products/ESPHome-Starter-Kit/tutorials/light-effects.md index 2696ea5ddd..726c2a043c 100644 --- a/docs/products/ESPHome-Starter-Kit/tutorials/light-effects.md +++ b/docs/products/ESPHome-Starter-Kit/tutorials/light-effects.md @@ -12,8 +12,8 @@ Out of the box, your RGB module turns on, turns off, and changes color. ESPHome Work through these pages first. This tutorial assumes your device is flashed and has an addressable RGB light component already configured (either the **Onboard RGB LED** or the **RGB LEDs** from the LED & Buzzer module): - * [First Steps](/products/ESPHome-Starter-Kit/setup/first-steps/) to create your starter kit device in ESPHome Device Builder. - * [Adding the LED & Buzzer Module](/products/ESPHome-Starter-Kit/modules/rgb-buzzer-module/) if you're using the LED & Buzzer module. + * [First Steps](/products/ESPHome-Starter-Kit/setup/first-steps.md) to create your starter kit device in ESPHome Device Builder. + * [Adding the LED & Buzzer Module](/products/ESPHome-Starter-Kit/modules/rgb-buzzer-module.md) if you're using the LED & Buzzer module. ## Add the effects @@ -57,7 +57,7 @@ With the device back online, open the local web page at `http://esphome-starter- ![](../../../assets/esphome-device-builder-test-effects-web-server.gif) -If you've already followed [Connect to Home Assistant](/products/ESPHome-Starter-Kit/tutorials/connect-to-home-assistant/), the same **Effect** dropdown shows up on the light entity card in Home Assistant. +If you've already followed [Connect to Home Assistant](/products/ESPHome-Starter-Kit/tutorials/connect-to-home-assistant.md), the same **Effect** dropdown shows up on the light entity card in Home Assistant. !!! success "You just edited YAML!" diff --git a/docs/products/air1/faq.md b/docs/products/air1/faq.md index 79a795bee3..864d2ddd46 100755 --- a/docs/products/air1/faq.md +++ b/docs/products/air1/faq.md @@ -61,7 +61,7 @@ description: Frequently asked questions about the AIR-1 environmental sensor, in 15\. **How do I calibrate the CO2 sensor?** -* You usually don't need to. The latest AIR-1 firmware enables automatic self-calibration, which keeps the SCD40 accurate as long as the sensor sees fresh air (about 420 ppm) at least once a week. If your AIR-1 sits in a space that rarely gets fresh air (a sealed office, a basement, a grow room), turn off the **CO2 Auto Calibration** switch on the device page and follow the [manual calibration guide](../../general/calibrating-and-updating/co2-calibration/) every 1 to 2 years instead. +* You usually don't need to. The latest AIR-1 firmware enables automatic self-calibration, which keeps the SCD40 accurate as long as the sensor sees fresh air (about 420 ppm) at least once a week. If your AIR-1 sits in a space that rarely gets fresh air (a sealed office, a basement, a grow room), turn off the **CO2 Auto Calibration** switch on the device page and follow the [manual calibration guide](../general/calibrating-and-updating/co2-calibration.md) every 1 to 2 years instead. 16\. **Does the AIR-1 work outdoors?** diff --git a/docs/products/air1/setup/general-tips.md b/docs/products/air1/setup/general-tips.md index 89252fb28b..10b223ca9a 100755 --- a/docs/products/air1/setup/general-tips.md +++ b/docs/products/air1/setup/general-tips.md @@ -150,7 +150,7 @@ The latest AIR-1 firmware keeps the SCD40 calibrated automatically. The sensor a !!! warning "Auto calibration needs regular fresh air" - If your AIR-1 sits in a space that rarely gets fresh air (a sealed office, a basement, a grow room), automatic self-calibration will slowly drag the CO2 readings down. Turn off the **CO2 Auto Calibration** switch on the device page and follow the [manual calibration guide](../../../general/calibrating-and-updating/co2-calibration/) every 1 to 2 years instead. + If your AIR-1 sits in a space that rarely gets fresh air (a sealed office, a basement, a grow room), automatic self-calibration will slowly drag the CO2 readings down. Turn off the **CO2 Auto Calibration** switch on the device page and follow the [manual calibration guide](../../general/calibrating-and-updating/co2-calibration.md) every 1 to 2 years instead. ![](/assets/co2-levels-drop-after-hvac-on.png) diff --git a/docs/products/general/calibrating-and-updating/co2-calibration-quick.md b/docs/products/general/calibrating-and-updating/co2-calibration-quick.md index d5f2e3f2d6..55fe79992b 100755 --- a/docs/products/general/calibrating-and-updating/co2-calibration-quick.md +++ b/docs/products/general/calibrating-and-updating/co2-calibration-quick.md @@ -6,7 +6,7 @@ description: Step by step guide for re-calibrating your SCD40 CO2 sensor !!! info "Your sensor calibrates itself" - The latest Apollo firmware enables the SCD40's automatic self-calibration by default on every device with the CO2 sensor (AIR-1, R-PRO-1, MSR-2, and MTR-1), so you only need this guide if you turned the **CO2 Auto Calibration** switch off. See the [full calibration guide](../co2-calibration/) for how auto calibration works and when to turn it off. + The latest Apollo firmware enables the SCD40's automatic self-calibration by default on every device with the CO2 sensor (AIR-1, R-PRO-1, MSR-2, and MTR-1), so you only need this guide if you turned the **CO2 Auto Calibration** switch off. See the [full calibration guide](co2-calibration.md) for how auto calibration works and when to turn it off. !!! tip "Calibrate manually every 1 to 2 years when auto calibration is off" diff --git a/docs/products/plt1b/additional-info/insert-battery.md b/docs/products/plt1b/additional-info/insert-battery.md index f16e0c6a9c..2e16013b50 100644 --- a/docs/products/plt1b/additional-info/insert-battery.md +++ b/docs/products/plt1b/additional-info/insert-battery.md @@ -10,28 +10,28 @@ description: How to Insert Battery on PLT-1B. 1\. Gently press your thumb on the case above the stake and the lid should pop off. -![](../../../assets/plt-1b-remove-case-lid.webp) +![](/assets/plt-1b-remove-case-lid.webp) 2\. Hold the case and push the stake down a bit, then gently lift it out of the bottom case section. -![](../../../assets/plt-1b-lift-pcb-out-of-case.webp) +![](/assets/plt-1b-lift-pcb-out-of-case.webp) 3\. Flip the PLT-1B over and identify the `+` and `-` markings. The `+` is on the left side and the `-` is on the right side. Double check before going any further. 4\. The top of the battery (the positive end, marked with a `+` and a small ring around the terminal) goes on the left side, matching the `+` on the PLT-1B. -![](../../../assets/plt-1b-identify-top-of-18650-battery.webp) +![](/assets/plt-1b-identify-top-of-18650-battery.webp) 5\. Hold the PCB. You'll need to use a bit of force to push in the battery. Start with the right `-` side, then push in the left `+` side. -![](../../../assets/plt-1b-insert-battery.webp) +![](/assets/plt-1b-insert-battery.webp) 6\. Flip the sensor back over and lay the PCB inside the case so it sits flat. -![](../../../assets/plt-1b-place-pcb-in-case.webp) +![](/assets/plt-1b-place-pcb-in-case.webp) 7\. Line up the notch in the top left of the lid, then gently press down until the lid snaps into place. -![](../../../assets/plt-1b-replace-case-lid.webp) +![](/assets/plt-1b-replace-case-lid.webp) You have now installed or reinstalled the battery! \ No newline at end of file diff --git a/docs/products/temp1/examples/hot-water-recirculation.md b/docs/products/temp1/examples/hot-water-recirculation.md new file mode 100644 index 0000000000..d2299df4c5 --- /dev/null +++ b/docs/products/temp1/examples/hot-water-recirculation.md @@ -0,0 +1,99 @@ +--- +title: Hot Water Recirculation with TEMP-1 +description: How a community member uses an Apollo TEMP-1 to drive a hot water recirculation loop, blending an instant mini tank with the main house heater and wasting no water down the drain. +--- +# Hot Water Recirculation with TEMP-1 + +!!! info "Contributed by Donovan" + + This is a real setup shared by Donovan, an Apollo community member. We will flesh out the Home Assistant side once he shares his automations. + +There are two normal ways to get hot water at a sink, and each has a catch. A small under-sink tank gives you instant hot water with very little energy, but it runs out after a gallon or two. The main house water heater never runs out, but you either wait while cold water runs down the drain, or you get a cold-water sandwich when the tank water hands off to the line water. + +Donovan's setup uses an Apollo TEMP-1 to get both. Small draws come from a 2.5 gallon Bosch mini tank. When he knows he needs more, a button starts a recirculation loop that pulls hot water up from the house heater without running the tap, and the TEMP-1 tells Home Assistant the moment that line is hot enough to switch over. No water goes down the drain, and there is no cold-water sandwich. + +## How it works + +The TEMP-1 probe is zip-tied to the hot-water angle stop, so it reads the temperature of the hot line coming from the house heater. Everything else, the Bosch tank, the circulator pump, the motorized valve, and the TEMP-1 itself, plugs into a Kasa smart power strip that Home Assistant controls. + +1. **Idle.** The 3-way valve is unpowered, so the sinks are fed by the Bosch mini tank. Instant hot water, low energy. +2. **Request hot water.** Donovan presses an Aqara Zigbee button when he knows he'll use more than a gallon or two. +3. **Recirculate.** Home Assistant switches the circulator pump on. It pumps the cooled water from the hot line back into the cold line, pulling fresh hot water up from the house heater. Nothing runs down the drain. +4. **Watch the line.** The TEMP-1 reports the angle-stop temperature every few seconds. The pump also has its own temperature sensor, and the smart strip watches its energy use, so the system knows when the pump finishes. +5. **Switch over.** Once the line is hot, Home Assistant powers the valve so the sinks draw from the house heater, and shuts the pump outlet off so it won't run again when the water cools. Alexa announces "The hot water is ready." +6. **Revert.** When the TEMP-1 sees the line drop below a set temperature, Home Assistant cuts power to the valve. A capacitor inside the valve stores just enough energy to rotate it back, so the sinks return to the Bosch tank. + +### Physical layout + +![Hot water recirculation plumbing: the house heater feeds wall hot and cold lines, a circulator pump recirculates the loop, the TEMP-1 reads the wall hot line, a Bosch mini tank supplies instant hot water, and a 3-way valve selects which source feeds the sinks.](/assets/temp1-hot-water-recirculation.svg) + +### Control logic + +```mermaid +flowchart LR + IDLE["Idle:
Bosch feeds the sinks
(valve off)"] + PUMP["Pump ON:
recirculate the wall loop,
no water wasted"] + Q1{"Wall line
up to temp?"} + WALL["Valve powered:
house heater feeds the sinks
(Alexa: hot water ready)"] + Q2{"Wall line
cooled off?"} + + IDLE -->|press Aqara button| PUMP --> Q1 + Q1 -->|no| PUMP + Q1 -->|yes| WALL --> Q2 + Q2 -->|no| WALL + Q2 -->|"yes: valve off, back to Bosch"| IDLE + + classDef bosch fill:#4379AA,stroke:#2d5a8a,color:#fff; + classDef wall fill:#d64545,stroke:#a83232,color:#fff; + classDef temp fill:#2e7d46,stroke:#1f5630,color:#fff; + class IDLE bosch; + class WALL wall; + class Q1,Q2 temp; +``` + +## Parts + +| Part | Role in the loop | +| --- | --- | +| Apollo TEMP-1 + short temperature probe | Reads the hot line at the angle stop and reports it to Home Assistant | +| Bosch ES2.5 mini tank (2.5 gal, 120 V) | Instant hot water for small draws | +| AquaMotion AMH3K-7N circulator pump | Recirculates the loop to pull hot water up from the house heater | +| US Solid 1/2" 3-way L-type motorized ball valve | Selects the hot source: unpowered feeds the Bosch, powered feeds the house heater | +| TP-Link Kasa smart power strip | Switches the pump, valve, Bosch, and TEMP-1 outlets, and monitors energy use | +| Aqara wireless mini switch (Zigbee) | The "I want hot water" button | +| Alexa speaker | Announces when the line is ready | + +## TEMP-1 configuration + +For this to react quickly, the probe needs to report faster than its 60 second default. Donovan reports it every 3 seconds and keeps a 60 second heartbeat, so Home Assistant reacts fast while you can still tell at a glance that the probe is alive. Two guards keep the data clean: the `85.0` reading a DS18B20 sends at power-on is dropped, and readings are ignored when the **Select Probe** option is set to `Food`. + +For the full walkthrough of overriding probe YAML in the ESPHome Builder, including the simpler delta-plus-heartbeat pattern, see [How To Change The Temperature Probe Update Interval](../setup/temp1-change-temp-probe-update-interval.md). + +```yaml +sensor: + - platform: dallas_temp + id: !extend temp_probe + update_interval: 3s + filters: + - lambda: |- + if (isnan(x)) { + return NAN; + } + if (x == 85.0) { + return NAN; + } + auto selected_probe = id(temp_probe_select).current_option(); + if (selected_probe == "Food") { + return NAN; + } + return x - id(dallas_temperature_offset).state; + - or: + - delta: 1.1 # ~2°F; change to 2.0 for 2°C (~3.6°F) instead + - heartbeat: 60s +``` + +## Home Assistant automations + +!!! note "Work in progress" + + The whole cycle is driven by Home Assistant automations. The button press starts the pump, a TEMP-1 threshold flips the valve and triggers the Alexa announcement, and a lower threshold reverts the valve. We'll add Donovan's actual automation YAML here once he shares it. diff --git a/mkdocs.yml b/mkdocs.yml index bc6ce18df6..9a66175baf 100755 --- a/mkdocs.yml +++ b/mkdocs.yml @@ -369,6 +369,7 @@ nav: - Alert Outside Range: products/temp1/examples/temp1-alert-example.md - Use Cases: products/temp1/examples/use-cases.md - Automations: products/temp1/examples/temp1-automation-examples.md + - Hot Water Recirculation: products/temp1/examples/hot-water-recirculation.md - Troubleshooting: - TEMP-1 Boot Mode: products/temp1/troubleshooting/temp1-boot-mode.md - Factory Re-Flash TEMP-1: products/temp1/troubleshooting/temp1-code.md