From f09021d859851b7d1e80075ce07ed8816860eac3 Mon Sep 17 00:00:00 2001
From: Edward Firmo <94725493+edwardtfn@users.noreply.github.com>
Date: Mon, 1 Jan 2024 22:04:51 +0100
Subject: [PATCH] Dual target climate page
- Solves #909
- Partially solves #1486
- Solves #1481
- Solves #1459
- Solves #1006
- Solves #1106
---
ReleaseNotes.md | 15 +-
advanced/esphome/nspanel_esphome_core.yaml | 113 +++++++++-----
advanced/hmi/nspanel_CJK_eu.HMI | Bin 21500183 -> 20030894 bytes
advanced/hmi/nspanel_CJK_eu.tft | Bin 11961668 -> 11956320 bytes
.../hmi/nspanel_CJK_eu_code/Program.s.txt | 2 +-
advanced/hmi/nspanel_CJK_eu_code/boot.txt | 140 +++++-------------
advanced/hmi/nspanel_CJK_eu_code/climate.txt | 99 ++++++-------
advanced/hmi/nspanel_CJK_us.HMI | Bin 21314199 -> 19847225 bytes
advanced/hmi/nspanel_CJK_us.tft | Bin 12035904 -> 12030372 bytes
.../hmi/nspanel_CJK_us_code/Program.s.txt | 2 +-
advanced/hmi/nspanel_CJK_us_code/boot.txt | 137 +++++------------
advanced/hmi/nspanel_CJK_us_code/climate.txt | 95 ++++++------
advanced/hmi/nspanel_CJK_us_land.HMI | Bin 21500183 -> 20032046 bytes
advanced/hmi/nspanel_CJK_us_land.tft | Bin 11961668 -> 11956320 bytes
.../nspanel_CJK_us_land_code/Program.s.txt | 2 +-
.../hmi/nspanel_CJK_us_land_code/boot.txt | 140 +++++-------------
.../hmi/nspanel_CJK_us_land_code/climate.txt | 99 ++++++-------
advanced/hmi/nspanel_eu.HMI | Bin 15033379 -> 15033379 bytes
advanced/hmi/nspanel_eu_code/Program.s.txt | 2 +-
advanced/hmi/nspanel_eu_code/boot.txt | 2 +-
advanced/hmi/nspanel_eu_code/climate.txt | 99 ++++++-------
advanced/hmi/nspanel_us.HMI | Bin 14820802 -> 14820802 bytes
advanced/hmi/nspanel_us_code/boot.txt | 2 +-
advanced/hmi/nspanel_us_code/climate.txt | 95 ++++++------
advanced/hmi/nspanel_us_land.HMI | Bin 14679517 -> 14661719 bytes
.../hmi/nspanel_us_land_code/Program.s.txt | 2 +-
advanced/hmi/nspanel_us_land_code/boot.txt | 140 +++++-------------
advanced/hmi/nspanel_us_land_code/climate.txt | 99 ++++++-------
dev/instructions_for_developers.md | 14 +-
nspanel_blueprint.yaml | 87 ++++++++---
nspanel_eu.tft | Bin 7308612 -> 7303264 bytes
nspanel_us.tft | Bin 7382848 -> 7377316 bytes
nspanel_us_land.tft | Bin 7308612 -> 7303264 bytes
33 files changed, 592 insertions(+), 794 deletions(-)
diff --git a/ReleaseNotes.md b/ReleaseNotes.md
index c001bb2..ff1a704 100644
--- a/ReleaseNotes.md
+++ b/ReleaseNotes.md
@@ -32,7 +32,7 @@ Updates may come with changes on the blueprint inputs and we highly recommend yo
## Breaking changes
1. **The `background` parameter in the `esphome.xxxxx_set_component_color` service is now deprecated.**
-2. With the introduction of additional custom buttons, the **layout of other buttons on the home page has been adjusted**.
+2. **On the home and climate pages, the button layout has changed.** This adjustment was made to incorporate additional custom buttons on the home page and new target temperature indicators on the climate page.
3. **Wi-Fi power save mode has been reset to `NONE` as the default setting.**
This was the standard up to v4.0. We switched it in v4.1 to accommodate Bluetooth components. However, since this feature isn't widely used, we're reverting to the original setting. For Bluetooth usage, you should manually set a different mode, such as `LIGHT`, as shown in the customization example below:
```yaml
##### My customization - Start #####
@@ -78,8 +78,9 @@ wifi:
11. Add swipe control to screensaver page
12. Enhanced control for automation entities on buttons
13. Dual thermostat controller support (add-on)
-14. Enhanced timeout flexibility for Sleep, Page fallback, and Dimming settings
-15. Display time on the `screensaver` page
+14. Dual thermostat display
+15. Enhanced timeout flexibility for Sleep, Page fallback, and Dimming settings
+16. Display time on the `screensaver` page
## Details of noteworthy changes
@@ -184,11 +185,15 @@ Users can configure their heating and cooling settings independently, providing
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.
-### 14. Enhanced timeout flexibility for Sleep, Page fallback, and Dimming settings
+### 14. Enhanced Climate Page for Dual Thermostat Control
+Leveraging the capabilities introduced with the Dual Thermostat Controller add-on, the existing climate page has been upgraded to support systems with dual temperature settings. This enhancement allows users to effectively manage thermostats that require both heating and cooling target temperatures, directly from the NSPanel's interface. While originally developed to complement the new add-on, this refined climate page also seamlessly extends its functionality to existing thermostats with dual set capabilities, offering a more versatile and comprehensive climate control experience.
+
+
+### 15. Enhanced timeout flexibility for Sleep, Page fallback, and Dimming settings
We have improved the functionality of our system by enhancing the timeout flexibility for Sleep, Page Fallback, and Dimming settings. The previous timeout limit of 300 seconds has been significantly expanded, offering users more control and customization options for these specific features. This enhancement allows for a wider range of use cases, catering to the needs of those who require extended periods for these settings, while still maintaining the option for shorter durations.
-### 15. Display time on the `screensaver` page
+### 16. Display time on the `screensaver` page
In this release, we're excited to introduce a new feature that adds a display time function to the Screensaver page. With this update, our screensaver not only serves its primary purpose of saving screen energy but also doubles as an informative display, reflecting our commitment to creating practical, user-friendly solutions.
You can enable this feature on the bueprint settings, at the **CUSTOM CONFIGURATION** section (almost at the end). You also have to set **Display Brightness Sleep** at the device's page (**Settings** > **Devices & Services** > **ESPHome**).
diff --git a/advanced/esphome/nspanel_esphome_core.yaml b/advanced/esphome/nspanel_esphome_core.yaml
index 90869c7..e3ce070 100644
--- a/advanced/esphome/nspanel_esphome_core.yaml
+++ b/advanced/esphome/nspanel_esphome_core.yaml
@@ -14,7 +14,7 @@ substitutions:
ota_password: ${wifi_password}
ap_password: ${wifi_password}
##### DON'T CHANGE THIS ######
- version: "4.2dev.3"
+ version: "4.2dev.4"
##############################
##### External components #####
@@ -359,6 +359,7 @@ api:
embedded_indoor_temperature: bool
temperature_unit_is_fahrenheit: bool
mui_please_confirm: string
+ mui_unavailable: string
screensaver_time: bool
screensaver_time_color: int[]
then:
@@ -370,6 +371,7 @@ api:
embedded_indoor_temperature: !lambda "return embedded_indoor_temperature;"
temperature_unit_is_fahrenheit: !lambda "return temperature_unit_is_fahrenheit;"
mui_please_confirm: !lambda "return mui_please_confirm;"
+ mui_unavailable: !lambda "return mui_unavailable;"
screensaver_time: !lambda "return screensaver_time;"
screensaver_time_color: !lambda "return screensaver_time_color;"
@@ -434,7 +436,11 @@ api:
- service: set_climate
variables:
current_temp: float
+ supported_features: int
+ supported_hvac_modes: int
target_temp: float
+ target_temp_high: float
+ target_temp_low: float
temp_step: int
total_steps: int
temp_offset: int
@@ -447,7 +453,11 @@ api:
- script.execute:
id: set_climate
current_temp: !lambda "return current_temp;"
+ supported_features: !lambda "return supported_features;"
+ supported_hvac_modes: !lambda "return supported_hvac_modes;"
target_temp: !lambda "return target_temp;"
+ target_temp_high: !lambda "return target_temp_high;"
+ target_temp_low: !lambda "return target_temp_low;"
temp_step: !lambda "return temp_step;"
total_steps: !lambda "return total_steps;"
temp_offset: !lambda "return temp_offset;"
@@ -869,6 +879,16 @@ globals:
restore_value: false
initial_value: '{"AM", "PM"}'
+ #### MUI strings ####
+ - id: mui_please_confirm_global
+ type: std::string
+ restore_value: true
+ initial_value: '"Please confirm"'
+ - id: mui_unavailable_global
+ type: std::string
+ restore_value: true
+ initial_value: '"Unavailable"'
+
##### Chips #####
- id: home_chip_font_size
type: uint
@@ -1832,6 +1852,7 @@ script:
embedded_indoor_temperature: bool
temperature_unit_is_fahrenheit: bool
mui_please_confirm: string
+ mui_unavailable: string
screensaver_time: bool
screensaver_time_color: int[]
then:
@@ -1852,9 +1873,9 @@ script:
id(temp_unit_fahrenheit) = temperature_unit_is_fahrenheit;
display_embedded_temp->execute();
- // Confirm page
- ESP_LOGV(TAG, "Setup confirm page");
- display_wrapped_text->execute("confirm.title", mui_please_confirm.c_str(), 15);
+ // MUI strings
+ id(mui_please_confirm_global) = mui_please_confirm;
+ id(mui_unavailable_global) = mui_unavailable;
// Screen saver page (sleep)
ESP_LOGV(TAG, "Setup screensaver page");
@@ -2154,7 +2175,9 @@ script:
- id: page_confirm
mode: restart
- then: # There's nothing here so far
+ then:
+ - lambda: |-
+ if (not id(is_uploading_tft)) display_wrapped_text->execute("confirm.title", id(mui_please_confirm_global).c_str(), 15);
- id: page_cover
mode: restart
@@ -2475,11 +2498,15 @@ script:
disp1->set_backlight_brightness(static_cast(brightness) / 100.0f);
id(display_last_brightness) = brightness;
- - id: set_climate
+ - id: set_climate #DEBUG
mode: restart
parameters:
current_temp: float
+ supported_features: int
+ supported_hvac_modes: int
target_temp: float
+ target_temp_high: float
+ target_temp_low: float
temp_step: uint
total_steps: uint
temp_offset: int
@@ -2487,43 +2514,63 @@ script:
embedded_climate: bool
then:
- lambda: |-
+ if (id(is_uploading_tft)) set_climate->stop();
static const char *const TAG = "script.set_climate";
ESP_LOGV(TAG, "Starting");
- ESP_LOGV(TAG, " current_temp: %f", current_temp);
- ESP_LOGV(TAG, " target_temp: %f", target_temp);
- ESP_LOGV(TAG, " temp_step: %d", temp_step);
- ESP_LOGV(TAG, " total_steps: %d", total_steps);
- ESP_LOGV(TAG, " temp_offset: %i", temp_offset);
- ESP_LOGV(TAG, " climate_icon: %s", climate_icon.c_str());
- ESP_LOGV(TAG, " embedded_climate: %s", embedded_climate ? "True" : "False");
+ ESP_LOGV(TAG, " current_temp: %f", current_temp);
+ ESP_LOGV(TAG, " supported_features: %i", supported_features);
+ ESP_LOGV(TAG, " supported_hvac_modes: %i", supported_hvac_modes);
+ ESP_LOGV(TAG, " target_temp: %f", target_temp);
+ ESP_LOGV(TAG, " target_temp_high: %f", target_temp_high);
+ ESP_LOGV(TAG, " target_temp_low: %f", target_temp_low);
+ ESP_LOGV(TAG, " temp_step: %d", temp_step);
+ ESP_LOGV(TAG, " total_steps: %d", total_steps);
+ ESP_LOGV(TAG, " temp_offset: %i", temp_offset);
+ ESP_LOGV(TAG, " climate_icon: %s", climate_icon.c_str());
+ ESP_LOGV(TAG, " embedded_climate: %s", embedded_climate ? "True" : "False");
if (current_page->state == "climate") {
ESP_LOGV(TAG, "Page climate is visible");
disp1->send_command_printf("climateslider.maxval=%i", total_steps);
disp1->set_component_value("temp_offset", temp_offset);
disp1->set_component_value("temp_step", temp_step);
- disp1->set_component_text_printf("current_temp", "%.1f°", current_temp);
disp1->show_component("current_temp");
disp1->show_component("current_icon");
- if (target_temp > -999)
- {
- float slider_val = round(((10*target_temp) - temp_offset) / temp_step);
- disp1->set_component_value("climateslider", slider_val);
- disp1->set_component_text_printf("target_temp", "%.1f°", target_temp);
- disp1->set_component_text_printf("target_icon", "%s", climate_icon.c_str());
- disp1->show_component("target_icon");
- disp1->show_component("target_temp");
- disp1->show_component("climateslider");
- disp1->show_component("decrease_temp");
- disp1->show_component("increase_temp");
- }
+ if (current_temp > -999)
+ disp1->set_component_text_printf("current_temp", "%.1f°", current_temp);
else
- {
- disp1->hide_component("target_icon");
- disp1->hide_component("target_temp");
- disp1->hide_component("climateslider");
- disp1->hide_component("decrease_temp");
- disp1->hide_component("increase_temp");
- }
+ disp1->set_component_text_printf("current_temp", id(mui_unavailable_global).c_str());
+
+ disp1->set_component_value("hvac_modes", supported_hvac_modes);
+ if (supported_hvac_modes & 1) { // Heat
+ if (target_temp_high <= -999 and target_temp > -999) target_temp_high = target_temp;
+ disp1->set_component_text_printf("target_temp_high", "%.1f°", target_temp_high);
+ disp1->show_component("target_temp_high");
+ disp1->set_component_value("slider_high", round(((10*target_temp_high) - temp_offset) / temp_step));
+ disp1->show_component("slider_high");
+ } else {
+ disp1->hide_component("target_temp_high");
+ disp1->hide_component("slider_high");
+ }
+ if (supported_hvac_modes & 2) { // Cool
+ if (target_temp_low <= -999 and target_temp > -999) target_temp_low = target_temp;
+ disp1->set_component_text_printf("target_temp_low", "%.1f°", target_temp_low);
+ disp1->show_component("target_temp_low");
+ disp1->set_component_value("slider_low", round(((10*target_temp_low) - temp_offset) / temp_step));
+ disp1->show_component("slider_low");
+ } else {
+ disp1->hide_component("target_temp_low");
+ disp1->hide_component("slider_low");
+ }
+ if (supported_hvac_modes > 0) {
+ disp1->set_component_text_printf("target_icon", "%s", climate_icon.c_str());
+ disp1->show_component("target_icon");
+ disp1->show_component("decrease_temp");
+ disp1->show_component("increase_temp");
+ } else {
+ disp1->hide_component("target_icon");
+ disp1->hide_component("decrease_temp");
+ disp1->hide_component("increase_temp");
+ }
disp1->set_component_value("embedded", (embedded_climate) ? 1 : 0);
}
ESP_LOGV(TAG, "Finished");
diff --git a/advanced/hmi/nspanel_CJK_eu.HMI b/advanced/hmi/nspanel_CJK_eu.HMI
index f120b6d8949b0ad46d04920b86380b7fddb91fd8..75ff1fe661720d2873f880e7e65c36834fa950a0 100644
GIT binary patch
delta 58080
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%0D^xsPqzy0w@Jr$3=e
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