Initial support to addon_climate_dual

2023-12-18 22:38:32 +01:00
parent e8e483a92a
commit 346897ac94
12 changed files with 75 additions and 18 deletions
--- a/ReleaseNotes.md
+++ b/ReleaseNotes.md
@@ -77,6 +77,7 @@ wifi:
 10. Chips can be inverted
 11. Add swipe control to screensaver page
 12. Enhanced control for automation entities on buttons
+13. Dual thermostat controller support (add-on)

 &nbsp;
 ## Details of noteworthy changes
@@ -161,6 +162,25 @@ We're pleased to announce a new feature that offers users enhanced control over
 1. Apply the setting. This will then be effective across all relevant entities.

 This update is specially designed to cater to diverse user needs, ensuring a more intuitive and responsive smart home experience.
+
+&nbsp;
+### 13. Dual thermostat controller support (add-on)
+This new add-on enables the NSPanel to manage both heating and cooling systems simultaneously, utilizing its dual relay functionality.
+
+#### Key Benefits:
+- **Versatility:** Users can now configure their NSPanel to control both a heater and a cooler, offering increased flexibility in home temperature management.
+- **Efficiency:** With the ability to control both heating and cooling systems, the NSPanel can more effectively maintain desired temperatures, potentially leading to energy savings.
+- **User Experience:** This update simplifies the user interface by integrating control of both systems into one panel, making it easier to manage home climate.
+
+#### Implementation Details:
+- The dual thermostat controller functionality allows the NSPanel to utilize both of its relays for separate heating and cooling control.<br>
+Users can configure their heating and cooling settings independently, providing a tailored climate control experience.
+- The update is designed to be intuitive and user-friendly, ensuring a seamless transition for existing NSPanel users.
+- Additional Documentation: For detailed instructions and configurations, refer to the updated [add-on climate documentation](docs/addon_climate.md).
+
+#### Note to Users:
+This feature enhances the capabilities of the NSPanel without compromising its existing functionalities. Users who previously used the NSPanel for single-mode (either heating or cooling) control can now explore dual-mode options for a more comprehensive climate control solution.
+
 &nbsp;
 ## What's Next?
 Discover what's next and what we are working on right now in our [Milestones](https://github.com/Blackymas/NSPanel_HA_Blueprint/milestones?direction=asc&sort=due_date)
--- a/advanced/esphome/nspanel_esphome_addon_climate_base.yaml
+++ b/advanced/esphome/nspanel_esphome_addon_climate_base.yaml
@@ -6,7 +6,6 @@
 #####################################################################################################
 ##### ATTENTION: This will add climate elements to the core system and requires the core part.  #####
 #####################################################################################################
-
 ---
 substitutions:
  ### Local thermostat defaults ###
@@ -24,6 +23,7 @@ substitutions:
  ##### DO NOT CHANGE THIS #####
  addon_climate_cool: "false"
  addon_climate_heat: "false"
+  addon_climate_dual: "false"
  ##############################

 climate:
--- a/advanced/esphome/nspanel_esphome_addon_upload_tft.yaml
+++ b/advanced/esphome/nspanel_esphome_addon_upload_tft.yaml
@@ -6,7 +6,6 @@
 #####################################################################################################
 ##### ATTENTION: This will add advanced elements to the core system and requires the core part. #####
 #####################################################################################################
-
 ---
 substitutions:
  ################## Defaults ##################
--- a/advanced/esphome/nspanel_esphome_advanced.yaml
+++ b/advanced/esphome/nspanel_esphome_advanced.yaml
@@ -6,7 +6,6 @@
 #####################################################################################################
 ##### ATTENTION: This will add advanced elements to the core system and requires the core part. #####
 #####################################################################################################
-
 ---
 button:
  ##### EXIT REPARSE TFT DISPLAY #####
--- a/advanced/esphome/nspanel_esphome_core.yaml
+++ b/advanced/esphome/nspanel_esphome_core.yaml
@@ -4,7 +4,6 @@
 ##### PLEASE only make changes if it is necessary and also the required knowledge is available. #####
 ##### For normal use with the Blueprint, no changes are necessary.                              #####
 #####################################################################################################
-
 ---
 substitutions:
  ##### DON'T CHANGE THIS #####
--- a/docs/addon_climate.md
+++ b/docs/addon_climate.md
@@ -9,12 +9,11 @@ This add-on enables the use of your panel's relays to act as a thermostat (eithe
    - 300W/220V/Gang, 600W/220V/Total<br>
  - More details on the [Sonoff NSPanel's page](https://sonoff.tech/product/central-control-panel/nspanel/) and the [product specifications document](https://sonoff.tech/wp-content/uploads/2021/11/%E4%BA%A7%E5%93%81%E5%8F%82%E6%95%B0%E8%A1%A8-NSPanel-20210831.pdf).

-2. At this moment you have to choose between `heat` or `cool`. The dual/simultaneous operation is not supported at this moment.
-3. A target temperature must be set on the climate entity in Home Assistant or the page Climate in your panel.
+2. A target temperature must be set on the climate entity in Home Assistant or the page Climate in your panel.

 &nbsp;
 ## Installation
-You will need to add the reference to `addon_climate_heat` or `addon_climate_cool` files on your ESPHome settings in the `package` section and after te `remote_package` (base code), as shown bellow (for `heat` in this example):
+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):

 ```yaml
 substitutions:
@@ -101,6 +100,7 @@ packages:
      - nspanel_esphome.yaml # Core package
      - nspanel_esphome_addon_climate_cool.yaml # activate for local climate (cooling) control
      # - nspanel_esphome_addon_climate_heat.yaml # activate for local climate (heater) control
+      # - nspanel_esphome_addon_climate_dual.yaml # activate for local climate (dual) control
    refresh: 300s

 esp32:
--- a/docs/customization.md
+++ b/docs/customization.md
@@ -73,6 +73,7 @@ packages:
      - nspanel_esphome.yaml # Core package
      # - nspanel_esphome_addon_climate_cool.yaml # activate for local climate (cooling) control
      # - nspanel_esphome_addon_climate_heat.yaml # activate for local climate (heater) control
+      # - nspanel_esphome_addon_climate_dual.yaml # activate for local climate (dual) control
    refresh: 300s

 esp32:
--- a/docs/install.md
+++ b/docs/install.md
@@ -84,7 +84,8 @@ packages:
      # - advanced/esphome/nspanel_esphome_advanced.yaml # activate advanced (legacy) elements - can be useful for troubleshooting
      # - nspanel_esphome_addon_climate_cool.yaml # activate for local climate (cooling) control
      # - nspanel_esphome_addon_climate_heat.yaml # activate for local climate (heater) control
-    refresh: 1s
+      # - nspanel_esphome_addon_climate_dual.yaml # activate for local climate (dual) control
+    refresh: 300s

 esp32:
  framework:
@@ -164,5 +165,3 @@ esp32:
 * Blueprint file _**"nspanel_blueprint.yaml "**_ can also be installed manually.
 * There is also the possibility to upload the TFT file _**"nspanel_us.tft "**_ manually. The whole thing can also be combined with a _**"Folder Watcher "**_.
 * additionally we provide the HMI files _**"nspanel_xx.HMI "**_ for the Nextion Editor to customize graphics and programming if needed.
-
-&nbsp;  
--- a/docs/nspanel_blank.md
+++ b/docs/nspanel_blank.md
@@ -39,6 +39,7 @@ packages:
      - nspanel_esphome.yaml # Core package
      # - nspanel_esphome_addon_climate_cool.yaml # activate for local climate (cooling) control
      # - nspanel_esphome_addon_climate_heat.yaml # activate for local climate (heater) control
+      # - nspanel_esphome_addon_climate_dual.yaml # activate for local climate (dual) control
    refresh: 300s

 esp32:
--- a/nspanel_esphome_addon_climate_cool.yaml
+++ b/nspanel_esphome_addon_climate_cool.yaml
@@ -6,7 +6,6 @@
 #####################################################################################################
 ##### ATTENTION: This will add climate elements to the core system and requires the core part.  #####
 #####################################################################################################
-
 ---
 substitutions:
  ### Local thermostat defaults ###
@@ -18,7 +17,6 @@ substitutions:

  ##### DO NOT CHANGE THIS #####
  addon_climate_cool: "true"
-  addon_climate_heat: "false"
  ##############################

 climate:
@@ -29,10 +27,10 @@ climate:
      - switch.turn_on: relay_${cooler_relay}
    preset:
      - name: "Off"
-        default_target_temperature_high: ${temp_min} ${temp_units}
+        default_target_temperature_high: ${temp_max} ${temp_units}
        mode: "off"
      - name: Home
-        default_target_temperature_high: 21 ${temp_units}
+        default_target_temperature_high: 24 ${temp_units}

 packages:
  climate_base_package: !include advanced/esphome/nspanel_esphome_addon_climate_base.yaml
--- a/nspanel_esphome_addon_climate_dual.yaml
+++ b/nspanel_esphome_addon_climate_dual.yaml
@@ -0,0 +1,43 @@
+#####################################################################################################
+##### NSPANEL ESPHOME created by Blackymas - https://github.com/Blackymas/NSPanel_HA_Blueprint  #####
+##### ESPHome Add-on for Climate control - Dual                                                 #####
+##### PLEASE only make changes if it is necessary and also the required knowledge is available. #####
+##### For normal use with the Blueprint, no changes are necessary.                              #####
+#####################################################################################################
+##### ATTENTION: This will add climate elements to the core system and requires the core part.  #####
+#####################################################################################################
+---
+substitutions:
+  ### Local thermostat defaults ###
+  # https://esphome.io/components/climate/thermostat.html
+  heater_relay: "0"  # Select 1 for "Relay 1", 2 for "Relay 2" or "0" to a dummy switch/disabled
+  cooler_relay: "0"  # Select 1 for "Relay 1", 2 for "Relay 2" or "0" to a dummy switch/disabled
+  # https://esphome.io/components/climate/index.html#base-climate-configuration
+  temp_min: "5"
+  temp_max: "25"
+
+  ##### DO NOT CHANGE THIS #####
+  addon_climate_dual: "true"
+  ##############################
+
+climate:
+  - id: !extend thermostat_embedded
+    min_cooling_off_time: ${min_off_time}s
+    min_heating_off_time: ${min_off_time}s
+    min_cooling_run_time: ${min_run_time}s
+    min_heating_run_time: ${min_run_time}s
+    cool_action:
+      - switch.turn_on: relay_${cooler_relay}
+    heat_action:
+      - switch.turn_on: relay_${heater_relay}
+    preset:
+      - name: "Off"
+        default_target_temperature_high: ${temp_max} ${temp_units}
+        default_target_temperature_low: ${temp_min} ${temp_units}
+        mode: "off"
+      - name: Home
+        default_target_temperature_high: 24 ${temp_units}
+        default_target_temperature_low: 18 ${temp_units}
+
+packages:
+  climate_base_package: !include advanced/esphome/nspanel_esphome_addon_climate_base.yaml
--- a/nspanel_esphome_addon_climate_heat.yaml
+++ b/nspanel_esphome_addon_climate_heat.yaml
@@ -6,7 +6,6 @@
 #####################################################################################################
 ##### ATTENTION: This will add climate elements to the core system and requires the core part.  #####
 #####################################################################################################
-
 ---
 substitutions:
  ### Local thermostat defaults ###
@@ -14,10 +13,9 @@ substitutions:
  heater_relay: "0"  # Select 1 for "Relay 1", 2 for "Relay 2" or "0" to a dummy switch/disabled
  # https://esphome.io/components/climate/index.html#base-climate-configuration
  temp_min: "5"
-  temp_max: "25"
+  temp_max: "45"

  ##### DO NOT CHANGE THIS #####
-  addon_climate_cool: "false"
  addon_climate_heat: "true"
  ##############################

@@ -32,7 +30,7 @@ climate:
        default_target_temperature_low: ${temp_min} ${temp_units}
        mode: "off"
      - name: Home
-        default_target_temperature_low: 21 ${temp_units}
+        default_target_temperature_low: 18 ${temp_units}

 packages:
  climate_base_package: !include advanced/esphome/nspanel_esphome_addon_climate_base.yaml