Files
NSPanel_HA_Blueprint/ReleaseNotes.md
Edward Firmo 3c27ec3638 Lint
2024-02-22 23:41:19 +01:00

9.9 KiB
Raw Blame History

v4.3 - TItle to be defined

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

MUST BE UPDATED.

Hello everyone! Our latest update introduces a range of enhancements designed to elevate your experience with the firmware. This update is focused on improving user interaction, featuring a more intuitive TFT upload process and expanded customization options. Key enhancements include upgraded functionality for Alarm Control Panels & Thermostats and new personalization features on the Home page.

We're enthusiastic about our ongoing work to make the NSPanel firmware more user-friendly and accessible. This release marks significant progress in this direction, with improvements such as the streamlined TFT upload process and initial steps towards adopting esp-idf as the default framework. Additionally, our documentation has been revamped for greater clarity and user-friendliness. Expect more user-centric updates coming your way soon!

Dive into the details below to see how these changes can enhance your daily use of NSPanel. We value your feedback and are eager to hear your thoughts!

Upcoming Change: Switching to ESP-IDF Framework by March 2024

We have some important updates for our community by March 2024, we're moving to the ESP-IDF as our standard framework. This shift aims to significantly boost the memory capacity on the ESP, allowing for the addition of new features and broader customizations.

There's ample time before this transition takes place, so no need to hurry. When it's time to switch, flashing your device using a serial cable will be necessary, similar to the initial custom firmware setup.

For those who might need a serial firmware installation before March, trying out esp-idf earlier could be a beneficial move towards adapting to future developments.

If you're unable to switch by March or if serial flashing isn't an option for you, the arduino framework will still be available for Over-The-Air (OTA) updates.

For detailed guidance on framework customization, check out our customization documentation. We're dedicated to facilitating a smooth transition and are here to assist with any queries or concerns.

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.3
  2. nspanel_esphome.yaml - v4.3
  3. nspanel_blueprint.yaml - v4.3

Instructions

You can find the update procedures following here:

Breaking changes

  1. Default framework changed to esp-idf. Please follow instructions bellow for more details on how to proceed.

  2. All services have changed. If you are using the services directly in your automations, please look at our API documentation.

    We understand this change can require substantial work on the exisiting automations with direct calls to the panel's services, however this will significantly improve the future customizations by providing compreensive documentation, standardizing and optimizing services calls.

  3. captive_portal and web_server are back to basic package. If you want to remove those to free-up memory, please look at "Customizations - Remove non-essential components".

  4. 15s hardware button press no longer restarts the device as the benefits of this were too small compared to leaving the button available for other uses. If you still want the 15s restart behaviour, you can look at "Customizations - Restart with 15s button press and, in addition to that, the reset pin in the bottom of your panel can be used.

  5. Relay Fallback Switches Removed: These switches have been deprecated and hidden for some time and are now fully removed from the code. If you have used any customizations to expose these switches, please refer to the updated guide in "Customizations - Expose Relay Fallback Switch", or you can use a call to the service esphome.xxxxx_init_relays to set it accordingly without the additional memory consumption related to creating additional switches.

Overview of noteworthy changes

  1. Transition to ESP-IDF as Default Framework
  2. Performance improvements
  3. New API documentation
  4. Selectable font size for screensaver time display

Details of noteworthy changes

1. Transition to ESP-IDF as Default Framework

As previously announced, we have now transitioned to ESP-IDF as our default framework starting with this release. This change aligns with our commitment to provide a robust and future-ready platform, offering enhanced performance, direct hardware access, and access to the latest developments from Espressif.

For those who have prepared for this transition, we look forward to the new possibilities this brings to your projects.

For users wishing to continue with the Arduino framework, instructions have been provided on explicitly setting your framework preference. We are here to assist through our community support channels for any questions or assistance needed.

For the ones previously using the default framework (without any explicity framework especification on your panel's yaml), remember you have to flash your device using a serial cable this time, otherwise you can face some issues.

More information about this transition can be found in our discussion here: https://github.com/Blackymas/NSPanel_HA_Blueprint/discussions/1756

2. Performance improvements

Some text

Support

For support, feedback, or detailed information about this update, visit our GitHub repository or our online documentation.

What's Next?

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

Special thanks to

Previous releases