github edwardtfn/NSPanel-Easy v2026.11.17
v2026.11.17 - feat: Faster start on the screensaver, home values drawn by the panel, and the TFT aligned with the release

latest releases: latest, stable
one hour ago

Highlights

  • A faster start. The display now starts on the screensaver with a dimmed "NSPanel Easy" and opens the wake-up page as soon as ESPHome connects to it, with what is stored on the panel, while Wi-Fi, Home Assistant and the Blueprint are awaited in the background. The boot page is only shown when ESPHome does not connect (#774, #775, #800, #801).
  • The TFT carries the release version, like the firmware and the Blueprint, and is updated automatically whenever its version differs from the firmware's (#791).
  • The home page values are drawn by the panel, from Home Assistant state subscriptions: their state changes no longer start the Blueprint automation (#781).
  • More room for the subscriptions. They are now stored in a compact format, about a third of the previous size, so they also fit on panels with the small storage area of older installations (#793). Those panels can also get the current partition table over the air, without a USB cable (#796).
  • New on the pages: climate presets as buttons, the fan mode of a climate, the current light effect and fan preset mode, a white button for lights without colour temperature, and a display model for the US panel in landscape with the buttons on the left.

Update notes

Update the firmware, the Blueprint and the TFT together. The firmware requires this Blueprint and the TFT of this release, and the Blueprint requires this firmware.

  • The TFT is updated automatically after the firmware update, on every panel with automatic TFT updates enabled (the default), as the current TFT carries an older version format. Without automatic updates, press Update TFT display on the panel's device page.
  • A custom TFT uploaded manually with the default TFT URL is replaced once by the official TFT of this release. To keep it, disable automatic TFT updates (upload_tft_automatically: false) before updating the firmware (#791).
  • Expect one extra restart after the update. The subscriptions are stored in a new format and the home page values use new subscriptions, so the panel discards the stored ones once and restarts when the Blueprint sends them again. This happens only once (#781, #793).
  • The home page values show text states as Home Assistant reports them, not translated, except on, off, unavailable and unknown, which are shown in the language of the panel. A door sensor, for example, shows on where it showed "Open". Numbers are shown as before, with the display precision and the unit of the entity (#781).
  • Home page - Update in the background has no effect anymore: the home page values are always kept up to date. The input is kept, marked as no longer used, so existing automations are not affected (#781).
  • Until Home Assistant connects after a restart, the values from Home Assistant are empty or greyed out, and the connection icon stays grey. It turns red only if the boot completes without Home Assistant, or when a connection drops later. The time the start took is logged at the first connection (Home Assistant connected <s>s after the start), as the network log can only connect after it (#800).
  • The display stays dimmed until a user action. What the panel does on its own (the return to the home page after the page timeout, the wake-up page after a restart) no longer sets the regular brightness on a dimmed display. A touch, a hardware button, the wake-up sensor, the wake_up action or a page opened by Home Assistant still do (#759, #805).

Breaking changes

  • The page ids of the display changed. The graph page moved to its place by name in the page list (id 19), and the pages from keyb_num to weather05 moved up by one. Customizations sending numeric page ids to the display (for example back_page_id=<number>) need the new numbers. Customizations using page names or get_page_id() are not affected (#758).
  • With a firmware downgrade, the TFT has to be downgraded too. An older firmware does not ask the display for its settings, so it cannot read them from this TFT (#774).

Bug fixes

  • After a restart while Home Assistant is unreachable, the panel completes its boot with the settings it has stored, instead of waiting for the Blueprint forever with a dimmed display. With Home Assistant connected but no answer from the Blueprint, the boot completes after 2 minutes (#757, closes #516).
  • The graph page uses the colors chosen in the Blueprint for its Home page value, for the current value and the icon (#787, closes #786).
  • An entity details page no longer shows the entity it was showing before, when a late update for that entity arrives after the page moved to another entity of the same kind (#765).
  • A page id reported by the display that is not a page of the firmware is now ignored, instead of being used to look up a page name, which could restart the panel (#789).
  • Tapping an unassigned custom button of the climate page no longer logs errors in Home Assistant. Thanks @bfs2021 (#795, closes #794).
  • The Blueprint settings are requested as soon as the display is set up, so a panel is fully available a few seconds after Home Assistant connects, instead of 30 to 60 seconds later with a TFT that starts on the screensaver (#804).
  • The display no longer reloads the page while booting (the theme is applied once), and a page reloaded for a theme change keeps the dimmed brightness (#806).
  • With wifi_icon_colors: false, the connection icon turns red again when Wi-Fi, the API or Home Assistant drops after the boot. It stayed grey once the Blueprint had been ready (#800).
  • A home page value no longer keeps the text from before when only ESPHome restarted while the display kept running (#800).
  • TFT versions are compared as versions instead of numbers, which also fixes comparisons like 22.10 against 22.3 (#791).
  • A TFT that never matches the firmware (a custom TFT, or nextion_update_url) is no longer uploaded at every boot: an update for a version difference runs at most 3 times per firmware version. A TFT below the minimum version is always updated, as before (#791).

New features

  • Climate presets as buttons. A Home Assistant climate with up to 5 presets shows them in the row of the HVAC mode buttons, when they fit together: one tap to change the preset, and the active one is highlighted. A tap on the active preset goes back to none (#772, closes #609).
  • Fan mode of a climate. The climate page gets a fan mode button for climates with fan modes, showing the active mode and opening a picker to change it (#762, closes #292).
  • Current effect and preset mode. The light page shows the active effect under the effect button, and the fan page the active preset mode under the mode button (#761, closes #274).
  • White for lights without colour temperature. Lights with a single white (white colour mode) get a button on the light page to go back to white, as the W button in Home Assistant (#768, closes #767).
  • NSPanel US Landscape (buttons on the left). A new display model for a US panel mounted in landscape the other way around, with its own TFT file. To change between the two US Landscape models, select the model and press Update TFT display (#773, closes #396).
  • Relay entity override. New optional Blueprint inputs, Relay 1 - Entity override and Relay 2 - Entity override, tell which entity is the panel's relay when its entity ID was renamed, or when the button uses an entity created from the relay. With it, a hardware button keeps toggling its relay on the panel itself, also without Home Assistant (#766, closes #577).
  • Embedded thermostat entity override. A new optional Blueprint input, Embedded thermostat - Entity override, tells which entity is the panel's own thermostat when its entity ID was renamed or localized (#769, closes #640).
  • Erase the preferences when the subscriptions cannot be stored. A new opt-in substitution, api_subscribe_wipe_nvs_on_failure, makes the panel erase its stored preferences and restart once when the subscriptions cannot be stored. It is off by default, as it erases every setting stored on the panel; enable it only with API encryption (#785).

Improvements

  • The subscriptions are stored packed, without the unused bytes of their fields: a binding takes 64 bytes instead of 191, and the stored chunks of the old format are erased at boot. This fixes Could not persist ... binding(s) on panels with a small storage area (#793, closes #790).
  • The subscriptions stored on the panel are loaded complete or not at all: a write interrupted by a failure or a power loss can no longer leave a mixed set behind (#760, closes #374).
  • The display no longer pushes its settings to ESPHome with a timer on the boot page: ESPHome asks for them when it connects (#774).
  • The graph page is sorted by name in the page list, like every other page (#758, closes #714).

Documentation

  • Updating the partition table over the air: how to give an older panel the current partition table without a USB cable, also from the ESPHome add-on in Home Assistant, the optional bootloader update, and when sram1_as_iram is safe to enable (#796).
  • The "Could not persist" section of the API subscriptions documentation explains the small storage area of older installations, the factory reset and the new opt-in erase (#785, #793, #796).
  • The API documentation no longer describes the value action, which the firmware does not have, and shows how to drive a home page value from your own automation (#778).
  • The dead links to documents on the Sonoff site are removed (#782, closes #780).
  • Panel startup issues describes the new start, what is shown until Home Assistant connects, and when the boot page is shown (#775, #800).

Development

  • The release workflow sets the release version in the HMI source and builds the TFT files with the pre-built firmware, so each release tag carries its own TFT files. On dev, the TFT carries the development version 9999.99.9, which is never replaced by the automatic update (#791).
  • Pull requests are labelled automatically by the areas they change and by the type in their title, and the release notes are grouped by those labels (#776, #777).
  • Branches named test/** build and commit the display files, to test changes to the TFT on a panel before merging (#779).
  • The ESPHome build sizes are reported from the build output (#764, closes #763).
  • mikefarah/yq updated in the workflows (#802).
  • New workflows for AI issue triage, with possible duplicates labelled, and for fixes started by a maintainer on an issue (#788).

Thank you

Thank you to everyone who reported, tested and contributed to this release:

  • @bartbakels and @AbeltjeNL for the logs that found the storage problem of older panels (#790), for testing the partition table update over the air, and for sharing how to do it from the ESPHome add-on.
  • @bkbartk for the report on the subscriptions that could not be stored (#784).
  • @bfs2021 for the climate page fix (#795), and @fear for the detailed report (#794).
  • @HACS-bank for the graph page colors (#786).
  • @magicus for the local relay control report (#577).
  • @Protoncek for the landscape model with the buttons on the left (#396).
  • @sztupy for the white button of lights without colour temperature (#767).
  • @Heronidas for the climate presets as buttons (#609).
  • @BlackS34N for the fan mode of climates (#292).

Generated by Claude Code

What's Changed

Bug Fixes

  • fix: Complete the boot when Home Assistant is not available by @panel-easy-assistant[bot] in #757
  • fix: Ignore the entity snapshot of an entity the page is not showing by @panel-easy-assistant[bot] in #765
  • fix: Ignore page ids that are not pages of the firmware by @panel-easy-assistant[bot] in #789
  • fix: Use the colors of the Home page value on its graph page by @panel-easy-assistant[bot] in #787
  • fix: Keep the start screen until the boot opens a page by @edwardtfn in #800
  • fix: Request the Blueprint settings when the display is set up by @edwardtfn in #804
  • fix: Keep the early wake-up page dimmed while booting by @edwardtfn in #805
  • fix: Avoid reloading the page twice while booting by @edwardtfn in #806

New Features

  • feat: Add an option to erase the preferences when the subscriptions cannot be stored by @panel-easy-assistant[bot] in #785
  • feat: Restore the regular brightness only on user actions by @panel-easy-assistant[bot] in #759
  • feat: Show the current effect and preset mode on the light and fan pages by @panel-easy-assistant[bot] in #761
  • feat: Set the fan mode of a climate entity from the climate page by @panel-easy-assistant[bot] in #762
  • feat: Show the presets of a climate as buttons on the climate page by @panel-easy-assistant[bot] in #772
  • feat: Add a white button to the light page for lights without colour temperature by @panel-easy-assistant[bot] in #768
  • feat: Add a display model for the US panel in landscape with the buttons on the left by @panel-easy-assistant[bot] in #773
  • feat: Add an optional override to select the panel's relay entity by @panel-easy-assistant[bot] in #766
  • feat: Add an optional override to select the panel's own thermostat by @panel-easy-assistant[bot] in #769
  • feat: Align the TFT version with the release version by @panel-easy-assistant[bot] in #791
  • feat: Ask the display for its settings instead of having it push them by @panel-easy-assistant[bot] in #774
  • feat: Start on the screensaver and open the wake-up page when ESPHome connects by @panel-easy-assistant[bot] in #775
  • feat: Show a dimmed watermark on the start screen by @edwardtfn in #801
  • feat: Faster start on the screensaver, home values drawn by the panel, and the TFT aligned with the release by @edwardtfn in #799

Improvements

  • improve: Verify the subscriptions stored on the panel after an interrupted write by @panel-easy-assistant[bot] in #760
  • improve: Store the subscriptions packed, to fit small NVS partitions by @panel-easy-assistant[bot] in #793
  • improve: Draw the home page values on the panel from state subscriptions by @panel-easy-assistant[bot] in #781

Documentation

  • docs: Remove the dead links to documents on the Sonoff site by @panel-easy-assistant[bot] in #782
  • docs: Remove the value action and show how to drive a home page value by @panel-easy-assistant[bot] in #778
  • docs: Update the partition table over the air by @edwardtfn in #796

CI & Automation

  • ci: Label pull requests by the type in their title by @panel-easy-assistant[bot] in #777
  • ci: Build and commit the display files on test branches by @panel-easy-assistant[bot] in #779
  • ci: bump mikefarah/yq from 4.54.2 to 4.54.3 in the actions-versioning group by @dependabot[bot] in #802
  • ci: Require the landscape-left TFT in the release by @edwardtfn in #807

Refactoring

  • refactor: Sort the graph page by name in the page list by @panel-easy-assistant[bot] in #758

Other Changes

  • ci: Report the ESPHome build sizes from the build output instead of the job logs by @panel-easy-assistant[bot] in #764
  • ci: Label pull requests by the areas they change by @panel-easy-assistant[bot] in #776
  • ci: Add AI issue triage and maintainer-started issue fix workflows by @panel-easy-assistant[bot] in #788
  • fix: Skip climate short click when the custom button has no entity by @bfs2021 in #795

New Contributors

Full Changelog: v2026.11.16...v2026.11.17

Don't miss a new NSPanel-Easy release

NewReleases is sending notifications on new releases.