This allows you to configure your complete NSPanel via Blueprint with UI and without changing anything in the code
This patch addresses a critical compile error related to the captive portal feature, ensuring smooth and successful firmware compilations for users utilizing this feature.
This release ensures that all users, regardless of their use of the captive portal feature, can compile and update their firmware without interruption. We apologize for any inconvenience caused and appreciate your patience as we continue to improve the NSPanel firmware.
This release of v4.3.6 is an urgent patch to address critical issues affecting the functionality of custom buttons on the NSPanel. These fixes ensure that custom buttons properly trigger actions for climate and alarm controls, and correct the integration with external thermostat entities.
Climate Page Accessibility Restored (#2067)
Alarm Control from Custom Button Restored (#2081)
Integration of External Thermostat Entities Fixed (#2080)
This patch release v4.3.6 ensures that custom buttons on the NSPanel are fully operational, addressing urgent issues that impacted user interaction and control of climate and alarm systems. We thank our community for their prompt reporting and patience as we continue to enhance the NSPanel experience.
This patch release v4.3.5 introduces experimental Bluetooth features alongside critical fixes and enhancements. The new Bluetooth capabilities leverage the previously untapped potential of the NSPanel's Bluetooth modem, enabled by the increased memory availability in the ESP-IDF framework.
BLE Tracker Add-on
Bluetooth Proxy Add-on
Temperature Increment Error in Climate Card Resolved (#2076)
Consistent Temperature Unit Display Across Panels (#2056)
Improved Custom Button Response for Dimmable Color Lights (#2072)
Homepage Weather and Climate Control Delay Minimized (#2056)
Consistent Icon Color Display on Home Page (#2043)
Restoration of Webserver Functionality Post-Upgrade (#2054, #2050)
Reliability Improvements for TFT Uploads with Bluetooth Components (#1946, #1815)
This update, v4.3.5, is a significant step towards harnessing the full potential of the NSPanel's hardware capabilities, especially its Bluetooth functionality, while continuing to refine the user experience and system stability. We appreciate the community's active involvement in identifying these issues and thank everyone for their contributions to improving the firmware.
This patch release addresses a critical issue from the v4.3.3 update that affected the touch functionality on the Home screen, specifically impacting the ability to navigate to the climate page.
This update is essential for ensuring that the NSPanel functions correctly, maintaining the quality and reliability expected by our users. We apologize for any inconvenience caused and thank you for your continued support.
With the v4.3.3 update, we're focused on refining the NSPanel's usability and customization capabilities, addressing user feedback to enhance the intuitive interaction with the panel. From streamlining light entity controls to expanding text length for entities on the home page, each change is aimed at improving the user experience. This patch also introduces experimental features, such as prebuilt firmware updates and PSRAM use, pushing the boundaries of what's possible with NSPanel, while also ensuring a smoother, more reliable interface across different languages and configurations.
mdi:void
Icon on Homepage for Blank Display (#2019)mdi:void
icon on the homepage, allowing for a blank display where no icon is preferred. This enhancement provides users with greater customization flexibility, enabling a cleaner and more minimalistic interface by opting not to show any icon.In this patch, we focus on enhancing the NSPanel experience by introducing critical fixes and requested enhancements to improve overall system stability and user interaction. This update addresses key issues, such as the incorrect display of the "boot" page upon wake-up, and optimizes the performance of the Utilities Dashboard to prevent potential overload states. With updates across firmware, user interface, and documentation, v4.3.2 underscores our dedication to delivering a seamless and robust smart home control solution.
[!IMPORTANT] Cleaning build files is a mandatory step for this update to apply successfully. It ensures your NSPanel operates smoothly with the new improvements post-update.
hw_buttons_bar_color_off
input, showcases our commitment to detail and high-quality documentation, enhancing user experience by providing clear and precise instructions.sliding_window_moving_average
filter with a window size of six, the sensor's reporting frequency has been adjusted to every 10 seconds. This methodological enhancement, chiefly proposed and tested by community members @andythomas and @grigi, ensures a smoother temperature curve and faster response to environmental changes such as opening a window. While the adjusted frequency means data is reported more often, ESPHome's efficient data transmission only when changes occur ensures that the impact on Home Assistant's data processing is minimal. This significant improvement, sparked by proactive community involvement, not only enhances the NSPanel's functionality but also broadens the scope for more dynamic and responsive environmental automations.nextion_update_url
substitution. This clarification aims to streamline the TFT update process, ensuring users have a clear understanding of the requirements for successful TFT file downloads and uploads, thereby enhancing the overall setup experience.alarm_control_panel
domain will open its detailed page, aligning with the behavior for climate
and media_player
entities. This update facilitates quicker access to alarm controls directly from the NSPanel, streamlining user interactions. Long clicks continue to open the detailed page for these and other domains, maintaining a consistent and user-friendly experience across various controls.Patch v4.3.1 focuses primarily on ensuring full compatibility with the latest ESPHome v2024.3.0 IP address format changes, crucial for the smooth compilation and operation of the NSPanel project. This timely update addresses critical compatibility issues, alongside implementing key bug fixes and optimizations. It underscores our ongoing commitment to enhancing stability and ensuring a reliable experience for all NSPanel users, keeping pace with the evolving ESPHome ecosystem.
hw_button_state
Updatebutton_mask
parameter. This update simplifies the process of simultaneously updating the visual state of multiple hardware buttons, enhancing user interaction by providing a more intuitive interface for managing button states. Users can now specify the buttons they wish to control using a single button_mask
parameter, offering a streamlined approach for activating or deactivating the on-screen indication bars of the hardware buttons. This change fosters a more flexible and efficient user experience in configuring the visual feedback for button states.device_name
Is Not Provided (#1907)device_name
substitution was not specified by the user.rtttl_play
Service Documentation (#1901 and #1912)rtttl_play
service for custom sounds and alerts.notification_clear
Service Call (#1931)notification_clear
service, enhancing display control.This milestone release is not just about adopting a new technical foundation; it's about enhancing the capabilities and experiences of our users through significant performance improvements, more comprehensive API documentation, customizable user interfaces and improved localization. And with a nice Utilities Dashboard as a bonus!!
Our dedication to refining the user experience and expanding customization options continues, with this release featuring:
As we embrace the ESP-IDF framework, we're excited to explore the new horizons it brings to the NSPanel firmware. Dive into v4.3 and discover the advancements that await.
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:
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.
Please review your settings post-update to ensure compatibility. Refer to the update procedures here.
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:
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.
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.
Now all the services available are listed in a comprehensive documentation, making easier for people who want to customize their systems, integrate to other automations and to encourage new collaborators to our repository. For more details, please visit our API documentation.
Now you can chose the font size for your clock display in the screen saver. There are 3 sizes available:
[!IMPORTANT] For this time to be displayed you must select a brightness higher than 0 on the device's page (under Settings > Devices & Services > ESPHome).
[!WARNING] Some fonts may not support all the languages.
[!WARNING] Bigger fonts may not fit well on your display and the selected time format. Please select a different font in that case.
The hardware button bars, which display the status of entities linked to physical buttons, are now configurable to appear across all pages, including the screensaver, providing a constant visual reference to your system's status. This update introduces a new setting within the blueprint, allowing you to customize the visibility of these bars according to your preferences. Whether you need continuous monitoring on certain pages or want to maintain a cleaner look on others, this flexibility enhances your control.
Additionally, we've introduced the option to personalize the color of these bars, offering further customization to match your panel's aesthetic or to signify different statuses at a glance.
This feature enhances the NSPanel's functionality by ensuring important status indicators are always within view, tailored precisely to how you use your smart home.
You can now select the decimal separator for displaying numbers on your NSPanel. This feature allows for consistency with your regional number format preferences, improving the clarity of numerical information. Simply go to the settings to choose between the dot (.) and comma (,) as your decimal separator for a display that matches your preference.
This update aims to enhance the flexibility and usability of the NSPanel interface for users worldwide.
The page Light has been updated to include a power button, simplifying the process of toggling your light on or off. This intuitive addition allows for quick adjustments directly from the page Light, enhancing the user experience by providing a straightforward control mechanism.
This enhancement streamlines light management, making it more accessible and convenient for everyday use.
The Fan page now features an oscillate button, making it easier to control your fan's oscillation settings. This convenient update enables users to activate or deactivate the oscillation function with a single tap, directly from the Fan page itself. It's designed to improve the user experience by offering a simple and effective control option.
This update simplifies fan operation, enhancing accessibility and usability for all users.
We've improved the NSPanel interface by ensuring that only populated pages are displayed, both for button and entities pages. This update creates a more intuitive and clutter-free experience, automatically hiding any pages without assigned entities. There's no need for additional setup; if a page has no entities linked to it, it simply won't appear on your panel, making navigation smoother and more efficient.
In a significant step towards a more localized user experience, the values displayed on the NSPanel are now translated using Home Assistant's state_translated
function, introduced in HA v2024.3.0. This means that not only are the project's strings translated, but also values provided by Home Assistant, such as those from text sensors or binary sensors. This enhancement simplifies readability and usability for users interacting with the panel in different languages.
[!NOTE] The translations are managed by Home Assistant and will correspond to the language settings specified under Settings > System > General.
With the latest update, we've significantly broadened the range of entities that can be incorporated into the Home and Climate pages, aligning these sections with the extensive capabilities of the Entities pages. This enhancement enables a more versatile and detailed representation of your smart home's metrics directly on your NSPanel, from environmental sensors to energy monitors, offering a tailored view of your home's status at a glance.
When combined with the Translated Values, this expanded entity selection not only allows for a more personalized dashboard but also ensures that the information displayed is accessible and understandable, regardless of your preferred language. Together, these features elevate the NSPanel's functionality, providing you with a richer, more contextually relevant interface that adapts to your specific monitoring needs and preferences.
The "Utilities Dashboard" is a versatile feature tailored to offer a straightforward overview of your chosen utility metrics. It's designed for flexibility, allowing you to customize up to six data points, such as solar production, wind energy, EV charging status, battery levels, water, and gas consumption, according to what's relevant to your home. This customization ensures that the dashboard only displays the utilities you're monitoring, maintaining a clean and uncluttered interface.
We're enhancing the NSPanel's integration capabilities by extending support for "lock" entities to both buttons and chips. This development significantly broadens your ability to interact with and control lock mechanisms directly from the NSPanel. Whether securing your home or managing access to different areas, these updates streamline the control process, integrating seamlessly with your smart home's security setup.
In our continuous effort to enhance the NSPanel's utility and efficiency, we're pleased to announce that the Home page now accommodates a fourth value, complete with its icon. This addition allows for a more comprehensive at-a-glance view of your essential metrics directly from the home screen, ensuring that crucial information is always just a glance away.
We've enhanced the entities pages with an automatic font size adjustment feature to improve the display of values, especially for longer strings or values with lengthy units. This smart adjustment reduces the occurrence of truncated values by dynamically resizing the font based on the string length. While the selection of fonts for the panel remains limited, this automatic resizing significantly enhances readability, ensuring that all displayed information is clear and fully visible at a glance.
For support or more information about this update, visit our GitHub repository or our online documentation.
Discover our upcoming projects in our Milestones.
We extend our heartfelt thanks to the contributors who have played a pivotal role in enhancing the NSPanel's capabilities and documentation in this release:
play_rtttl
Service
Patch v4.2.6 addresses a mix of medium and minor bugs alongside UI enhancements, focusing on streamlining user experiences with the NSPanel Firmware. Key fixes include improving responsiveness in button pages for automation and scenes entities, correcting sensor display issues, and smoothing out TFT uploads. Notable improvements also include syncing with HA core 2024.2 and refining documentation for memory usage during customizations, reflecting a responsive and evolving approach to user feedback and system performance and reliability.
Overview of Changes:
Change | Criticality | Affected Components |
---|---|---|
Buttons pages slow when constructing automation and scene entities (#1746) |
Medium | Blueprint |
Fix Sensors Displaying "None" as Units (#1792 and #1804) | Medium | Blueprint |
Fix compilation error when installing nspanel_esphome_core.yaml without Upload TFT add-on (#1803) |
Medium | ESPHome |
Long Click Action Bug Fix for Hardware Button (#1637) | Minor | Blueprint |
Fix Nextion reported variable name invalid! when uploading TFT (#1794) |
Minor | ESPHome |
Calendar/Schedule icon permanently displayed when using climate entity. #1265 | Minor | Blueprint |
Sync icons with HA core 2024.2 (#1800) | Enhancement | Blueprint |
Improved documentation about memory considerations when using customizations (#1801) | Enhancement | Documentation |
Key Improvements:
automation
and scene
entities: Improved the load times and responsiveness of button pages when constructing automation
and scene
entities, enhancing the user interface's efficiency.nspanel_esphome_core.yaml
without Upload TFT add-on: Addressed a compilation error that occurred when the Upload TFT add-on was not included, streamlining the installation process for users.Nextion reported variable name invalid!
when uploading TFT: Resolved an error message logged during the TFT file upload process, where Nextion displays reported a variable name as invalid. This fix ensures a smoother and error-free update experience for TFT files, enhancing the reliability of display updates.auto
mode, now ensuring icons reflect the current status accurately.bluetooth_proxy
. Special thanks to @illuzn for their contributions to this enhancement.For support, feedback, or detailed information about this update, visit our GitHub repository or our online documentation.
With the 1000-star milestone on GitHub, we're excited to share Patch v4.2.5, enhancing the NSPanel Firmware experience in our spare time. This update refines climate and cover entity interfaces, boosts hardware button responsiveness, and integrates ESPHome's friendly_name
for easier device identification. We've also expanded direct TFT download capabilities from GitHub to Arduino users, previously only available for ESP-IDF users. This achievement, powered by community support, is a significant stride towards simplifying user experience for NSPanel firmware.
We highly recommend all users update their components to this latest version for an optimized and enhanced user experience. While this update is compatible with existing v4.2 components, fully updating ensures the best performance and usability.
Breaking Changes:
${device_name}
in their names, please modify these entities to omit ${device_name}
. ESPHome will now automatically append the friendly_name
or device_name
from your substitutions, simplifying the naming process.Additionally, we have updated our documentation to include comprehensive guidelines on memory requirements for ESPHome, ensuring users are well-informed for successful system setup and operation.
Overview of Changes:
Change | Criticality | Affected Components |
---|---|---|
Long Click Action Bug Fix for Hardware Button (#1637) | Minor | Blueprint |
Fix Display of Climate Icons on Chips (#1675) | Minor | Blueprint |
Fix Icon's Colors on Home Page Values (#1694) | Minor | Blueprint |
Alarm Keypad Arm/Disarm Fix for US Model (#1705) | Minor | TFT file (US model only) |
LocalTuya Fan Speed Controls Fix (#1706) | Minor | Blueprint |
Fix Update of Media Player Icons on Custom Buttons (#1716) | Minor | Blueprint |
Motion Sensor for Display Wake-Up (#1687) | Enhancement | Blueprint |
Enhanced Consistency in Cover Controls (#1688) | Enhancement | Blueprint |
Support ESPHome friendly_name (#1719) |
Enhancement | Blueprint ESPHome |
Improved Blueprint Input Clarity (#1722 and #1782) | Enhancement | Blueprint |
Enhanced Memory Allocation When Uploading TFT (esp-idf only) |
Enhancement | ESPHome |
Expanded Visualization on Chips | Enhancement | Blueprint |
Direct TFT Transfer from GitHub for Arduino Users | Enhancement | ESPHome |
Baud Rate Adjustment for TFT Uploads | Enhancement | ESPHome |
Update docs (install.md) with memory requirements (#1720) | Documentation | Documentation |
Key Improvements:
device_class
to the detailed cover page, ensuring that the icons for opening and closing covers are more accurately representative of the cover type. This update is a step towards our goal of extending context-aware UI enhancements to other supported domains in future updates.friendly_name
feature.
Previously, using friendly_name
could disrupt communication between the Blueprint and ESPHome due to mismatches in entity and service names. This update resolves these issues, ensuring seamless integration. Users can now utilize the friendly_name
substitution in their YAML setup to assign more intuitive and descriptive names to their devices, significantly improving the ease of device identification and overall user experience.esp-idf
framework. This update prevents simultaneous HTTP server connections, allowing for better memory allocation and reducing the risk of system crashes due to memory shortages. It does not affect users on the arduino
framework. Additionally, the log for the upload process now includes detailed memory usage data, providing valuable insights for troubleshooting and system performance enhancement.For support, feedback, or detailed information about this update, visit our GitHub repository or our online documentation.