h3n3/NSPanel_HA_Blueprint
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
Files
b7e4a46476c93c325bddafbe61d8011918cdcd14
NSPanel_HA_Blueprint/ReleaseNotes.md
Edward Firmo b7e4a46476 Move en-docs to docs folder
2023-12-17 17:57:12 +01:00

7.8 KiB
Raw Blame History

v4.2 <= pending update

Support this project

As always, we would like to thank everyone who donated to this project and remind you that every donation helps to support this project - so if you haven't made a donation yet, now would be a good time ;)

Paypal

 

General <= pending update

The focus this time was on making easier to transfer the TFT files.

As this project grows with features, it becomes more hungry of resources from all sides (ESPHome, your Home Assistant server and even the Nextion display) and with that the chances of something going wrong when updating increased.

So at this release we concentrated on cleaning up de code everywhere and shave some unnecessary elements, making the system easier to install and opening some space for future features. But you still can find a couple of nice new things not related to the cleaning.

 

Updating

Updates may come with changes on the blueprint inputs and we highly recommend you review your settings and make sure all fields have the correct selection. We did our best to support your legacy settings and avoid breaking your system, but please double check your settings if you see something not working as expected.

Files that need to be reloaded:

  1. nspanel_eu.tft, nspanel_us.tft or nspanel_us_land.tft - v4.2
  2. nspanel_esphome.yaml - v4.2
  3. nspanel_blueprint.yaml - v4.2

Instructions

You can find the update procedures following here:

 

Breaking changes

  1. Service esphome.xxxxx_set_component_color parameter background is deprecated.
  2. Due to the additional custom buttons, the other buttons on home page changed their positions.
  3. The Wi-Fi power save mode is back to "NONE" as default.
    This was the default until v4.0, but we changed on v4.1 to support Bluetooth components, however as this is not used by the majority of users, we are reverting back to the original setting. You can (and should if you want use Bluetooth) enforce other mode as a customization, like in the example bellow:
##### My customization - Start #####
# Enable Bluetooth proxy
bluetooth_proxy:
# Set Wi-Fi power save mode to "LIGHT" as required for Bluetooth on ESP32
wifi:
  power_save_mode: LIGHT
##### My customization - End #####
  1. Default baud rate for advanced mode is back to 115200 bps, to avoid issues when creating buttons pages.
  2. ESPHome v2023.12.0 is now the minimum required version

 

Overview of noteworthy changes

  1. Standardized entity's icons
  2. Additional custom buttons on Home page
  3. Outdoor temperature selectable font size
  4. Select icon size for button's pages
  5. Support to Chinese (Taiwan) and prepared for other CJK languages
  6. Upload baud rate selectable as substitution

 

Details of noteworthy changes

1. Standardized entity's icons

The engine for defining the icons to be shown and it's color was standardize between all the pages, so now you may see a more consistent User's Interface.

 

2. Additional custom buttons on Home page

It's that simple, now you have 6 buttons where used to be 3. 😉

 

3. Outdoor temperature selectable font size

Now you can select the font size of your outdoor temperature display:

image

Important: Long text with bigger fonts may exceed the limit of space reserved for this with incomplete information shown.

 

4. Select icon size for button's pages

You can also select the size of the icons on the buttos pages:

<> <<add page screenshot (US and EU)>>

 

5. Support to Chinese (Taiwan) and prepared for other CJK languages

You will find 3 new TFT files on the repository for the CJK languages. These files are considerably bigger, as the fonts requires more memory, but it should work fine in your panel. Currently only translations to Chinese (Taiwan) are available, but as soon we get the strings for other languages we will be happy to add to the blueprint selection. << Add screenshots of blueprint >>

 

6. Upload baud rate selectable as substitution

You can select an alternative baud rate for your TFT uploads. This allows faster TFT uploads and also supports displays previously set with baud rates not supported by this project (currently 115200 bps and 921600 bps).

To enable an alternative upload TFT baud rate, add the desired value in your substitutions like this:

  upload_tft_baud_rate: "921600"

If an invalid value is entered or this substitution is not present, the current baud rate will be used.

The system will always fall back to the standard baud rate (115200 bps) if other tentatives fails.

 

What's Next?

Discover what's next and what we are working on right now in our Milestones

 

Special thanks to:

New Contributors

Previous releases

Reference in New Issue View Git Blame Copy Permalink