Update climate addon docs

Include a concrete example with data.
This commit is contained in:
Andy Thomas
2024-03-07 12:44:01 +01:00
parent 9f24df32c4
commit 33c3d55879
2 changed files with 36 additions and 4 deletions

View File

@@ -21,6 +21,9 @@ Don't use it for directly power your cooler/heater if exceeding the panel specif
You will need to add the reference to `addon_climate_heat`, `addon_climate_cool` or `addon_climate_dual` files on your ESPHome settings in the `package` section You will need to add the reference to `addon_climate_heat`, `addon_climate_cool` or `addon_climate_dual` files on your ESPHome settings in the `package` section
and after the `remote_package` (base code), as shown bellow (for `heat` in this example): and after the `remote_package` (base code), as shown bellow (for `heat` in this example):
> [!NOTE]
> From time to time, there are changes in ESPHome that lead to an added `_2` for the embedded thermostats. If you encounter this issue, please have a look at this [entry](https://community.home-assistant.io/t/esphome-devices-all-renamed-with-2-added/388146) in the Home Assistent Forum.
```yaml ```yaml
substitutions: substitutions:
# Settings - Editable values # Settings - Editable values
@@ -81,9 +84,9 @@ heat_overrun|Optional|Number representing a temperature hysteresis in the select
- For more details on the keys, please take a look at [ESPHome Base Climate Configurations](https://esphome.io/components/climate/index.html#base-climate-configuration) - For more details on the keys, please take a look at [ESPHome Base Climate Configurations](https://esphome.io/components/climate/index.html#base-climate-configuration)
and [ESPHome Climate Thermostat - Additional actions behavior](https://esphome.io/components/climate/thermostat.html#additional-actions-behavior). and [ESPHome Climate Thermostat - Additional actions behavior](https://esphome.io/components/climate/thermostat.html#additional-actions-behavior).
### Examples ## Examples
#### Cooler ### Cooler
```yaml ```yaml
substitutions: substitutions:
@@ -122,7 +125,7 @@ packages:
refresh: 300s refresh: 300s
``` ```
#### Heater ### Heater
```yaml ```yaml
substitutions: substitutions:
@@ -161,7 +164,7 @@ packages:
refresh: 300s refresh: 300s
``` ```
#### Dual ### Dual
```yaml ```yaml
substitutions: substitutions:
@@ -202,3 +205,32 @@ packages:
- nspanel_esphome_addon_climate_dual.yaml - nspanel_esphome_addon_climate_dual.yaml
refresh: 300s refresh: 300s
``` ```
### Concrete example: (Water) underfloor heating
The NSPanel is particularly nice as a replacement for existing water underfloor heating controllers. They are installed at approximately eye level and (often) supplied by 230V. In my case, the valve is type 'normally closed,' i.e. an open relay corresponds to 'no heating.' I am using relay #1. Please note that this is _not_ a PID controller, but simply on-off. At a certain value, the heating starts and at another value it switches off again. These value were set to `0.3°C` below and `0.1°C` above the setpoint, respectively. It turned out that `0.3`and `0.1` worked well for all off our 4 rooms. The minimum settable value is `15°C`, the maximum `22°C` and the granularity (step size) is `0.1°C`. In addition, I chose to set the default temperature to `21.2°C`.
```yaml
##### addon-configuration #####
## addon_climate ##
heater_relay: "1" #Use relay 1
temp_min: "15"
temp_max: "22"
temp_step: "0.1"
cold_tolerance: "0.3"
hot_tolerance: "0.1"
##### CHANGE ME END #####
climate:
- id: !extend thermostat_embedded
preset:
- name: Home
default_target_temperature_low: 21.2
mode: "heat"
```
Please note, that any filter that smoothes the temperature readings (e.g. averaging) is discouraged since it slows the response times of the already slow underwater floor heater. The temperature stability is quite nice which can be seen in the following viewgraph.
![temperature vs time](pics/addon_underfloor.png)
Mar 5 at approx. 9.30am, the window was opened and all heaters were set to 'off.'

Binary file not shown.

After

Width:  |  Height:  |  Size: 109 KiB