Files
NSPanel_HA_Blueprint/ReleaseNotes.md
Edward Firmo d94e98ee63 Lint
2024-02-26 19:24:22 +01:00

9.6 KiB

v4.3 - TItle to be defined

General

To be updated.

Hello everyone! We're excited to introduce enhancements in this update, focusing on improving user interaction and expanding customization options. This release features an intuitive TFT upload process, enhanced Alarm Control Panels & Thermostats functionality, and new personalization options.

We're committed to making NSPanel firmware more user-friendly. This release marks significant progress, including a streamlined TFT upload process and steps towards adopting esp-idf as the default framework. Our documentation has been revamped for clarity and ease of use. Stay tuned for more updates!

Learn more about our efforts.

ESP-IDF Framework Transition

With this release, we've officially transitioned to the ESP-IDF framework. This move is part of our ongoing efforts to enhance the memory capacity and expand the features available on the ESP, facilitating broader customization and new functionalities.

For users updating to this version:

  • Flashing Required: To adopt the ESP-IDF framework, flashing your device using a serial cable is necessary. This step mirrors the initial custom firmware setup process.
  • Arduino Framework Still Available: For those who prefer the arduino framework or require Over-The-Air (OTA) updates, it remains an option. Detailed guidance on how to choose your framework is provided in our customization documentation.

This transition is a significant milestone for us, promising a robust platform for our community. We're here to help with any questions or assistance needed during this change. For more details and support, visit our community discussion.

Updating

Please review your settings post-update to ensure compatibility. Refer to the update procedures here.

Breaking Changes and Guidance

With this release, we're implementing several important changes. While we strive to improve the panel, we understand that changes can affect your setups. Here's a detailed overview and guidance for a smooth transition:

  1. Transition to ESP-IDF Framework: This release marks the official switch to the ESP-IDF framework, enhancing performance and allowing for more complex features.

    • What to Do: You'll need to flash your device with the new firmware using a serial connection. Detailed instructions are available in our installation guide.
    • Support for Arduino Framework: If you're not ready to make the switch or prefer the Arduino framework, it's still supported for OTA updates. See our framework customization documentation for details on how to select your preferred framework.
  2. Several Services Changed: In our pursuit to enhance integration capabilities and future-proof our services, we've undertaken a comprehensive restructuring of our API. This change is aimed at improving functionality and compatibility but may require adjustments to your current automations.

    • What to Do: We strongly encourage you to review our updated API documentation. This resource has been meticulously updated to assist you in updating your automation scripts accordingly. Pay special attention to the examples section, which offers valuable insights and practical guidance for adapting your existing setups seamlessly.
  3. 15s Hardware Button Press No Longer Restarts the Device: This feature was removed to repurpose the hardware button for more versatile uses.

    • What to Do: If you relied on this feature, see our customization guide for alternatives. Additionally, the reset pin remains an option for manual resets.
  4. Relay Fallback Switches Removed: These switches were deprecated and have now been removed to streamline the firmware and reduce memory usage.

    • What to Do: For users who utilized customizations to expose these switches, refer to our updated customization guide. Alternatively, use the esphome.xxxxx_init_hardware service for a similar functionality without the memory overhead.

We appreciate your understanding and patience during this transition. Our goal is to ensure NSPanel continues to evolve in a way that enhances your experience and meets future needs. Our community and support channels are open for any questions or assistance you may require.

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
  5. Hardware buttons bars visible on all pages

Details of noteworthy changes

1. Transition to ESP-IDF as Default Framework

We've transitioned to ESP-IDF, enhancing our platform's performance and capabilities. This change promises new possibilities for your projects. Those continuing with the Arduino framework can find instructions for setting framework preferences.

For more information, visit our discussion.

2. Performance improvements

Details to be added.

3. New API documentation

Details to be added.

4. Selectable font size for screensaver time display

Details to be added.

5. The hardware buttons bars visible in all pages

Bars indicating statuses of entities controlled by hardware buttons are now visible on all pages, including screensaver. Color customization for these bars is also available.

Support

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

What's Next?

Discover our upcoming projects in our Milestones.

Special Thanks

Details to be added.

Previous releases