Highlights
- A status page for troubleshooting. The boot page becomes the panel's status page. It is a checklist of the startup steps (Wi-Fi, Home Assistant, Blueprint settings, display), each with a mark and its details, such as the versions, the IP address and the baud rate, updated every second. Open it with a long press on the background of the settings page. It replaces the debug page (#818, #829, #832, closes #615).
- The panel asks for its settings. The Blueprint no longer sends the settings on its own after an automation reload or a Home Assistant start. It tells the panel they are stale, and the panel asks for them and knows when they arrived complete. An incomplete send is asked for again, up to 5 times (#819, #826, closes #664).
- Calendar chips. Chips can show
calendarentities, for example one calendar per waste type from Waste Collection Schedule. A new lead time shows them some time before the event starts (#812, related to #447). - Double click on the hardware buttons. Each button can report a double click as its own event, with its own action in the Blueprint. It is opt-in per button, as it delays the single click by the time allowed for a second press (#811).
- The panel asks for the icon names, one block at a time. A block that does not arrive is asked for again. Before, a lost block left some buttons with another icon until the next restart (#830, closes #828).
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). Without automatic updates, press Update TFT display on the panel's device page.
- The values the panel stores by page are sent again once. The page list changed (#818), so the panel discards them after the update, and the Blueprint sends them again.
- After an automation reload or a Home Assistant start, each panel asks for its settings after a random delay of up to 20 seconds, instead of all panels receiving them in turns (#819).
- Buttons with an icon given by name appear once the icon names arrived, a few seconds after Home Assistant connects, instead of showing another icon in between (#830).
- The debug page is gone. The long press on the background of the settings page now opens the status page (#818).
Breaking changes
- The page ids of the display changed. The
debugpage is removed, so the pages fromentitypage01toweather05move down by one. Customizations sending numeric page ids to the display need the new numbers. Customizations using page names orget_page_id()are not affected (#818). - With a firmware downgrade, the TFT has to be downgraded too, as the page ids differ (#818).
- API version 4.0.
api_subscribe_icon_nameshas a new parameter,total, and the panel asks for the names with the eventicon_names_request. This only affects custom automations calling that action (#830).
Bug fixes
- A PID climate keeps a manual setpoint when Home Assistant sends the preset temperature again after reconnecting, instead of going back to the Comfort or Eco value (#822, closes #820). A new Comfort or Eco value moves the setpoint only while that preset is active, and is no longer lost when both presets have the same value (#833).
- The Wi-Fi icon stays red until Wi-Fi connects, also during the boot. A panel without Wi-Fi showed a red icon that turned grey after its automatic restart (#823, closes #821).
- The weather forecast shows pressure and rain with decimals for inHg, kPa, inches and mm. With inHg, the pressure was always 30 (#808, closes #803).
- With the "Display as a light" add-on, the screensaver no longer stays dark for about 5 seconds and blinks when the panel goes to sleep: the light turning off no longer sets the backlight to 0 % on top of the sleep brightness (#827).
- An icon given by name no longer shows another icon until a restart when part of the icon list did not arrive (#830, closes #828).
- With the Bluetooth proxy, a TFT upload no longer ends with a watchdog restart: the Bluetooth scan is stopped during the upload and is not started again by a Home Assistant connection (#837).
- With the double click enabled, two presses where one lasts between
multi_click_pressand the hold threshold are reported as two single clicks in either order, and the second click waits for the first one's action to finish (#838).
New features
- Status page (#818, #829, #832, closes #615): a checklist on a blue background, two values per line, with a mark for each step: done, in progress, failed or not started. It shows the connections to ESPHome and Home Assistant, the Blueprint settings, the display model and its acknowledgement, the TFT version and the baud rate, the home, wake-up and back pages, the brightness values, the embedded thermostat, and the enabled pages. "Wi-Fi: Not connected" is shown in place of the IP address when Wi-Fi is missing. A close button returns to the home page, shown only when ESPHome is connected. The page does not dim, sleep or time out, so it stays readable while troubleshooting.
- Settings requested by the panel (#819, closes #664): the Blueprint marks the end of every send, so the panel knows the settings are complete. Without the end marker, the panel asks again after 30 s, then 60 s, 120 s and 240 s, and gives up after 5 requests, keeping what it received. A display restart or a disconnection from Home Assistant during a send gets the settings again once that send ends, and a failed or aborted OTA during a send no longer stops the wait for its end (#833). Other API clients, such as the ESPHome logs, no longer cause a resend (#838).
- Calendar chips (#812, related to #447): a calendar chip is shown while one of its events is ongoing, with its own icon and colour, on the home page and the screensaver. The new Blueprint input Calendar chips - Lead time also shows it from that time before the next event, for example from 15:00 the day before an all-day event with 9 hours.
- Hardware button double click (#811): new substitutions
hw_button_left_double_clickandhw_button_right_double_click(bothfalse). With one of them, that button reportsdouble_clickin thebutton_clickevent, and the Blueprint has a double click action for each button. The single click then waitsmulti_click_gap(350 ms by default) for a possible second press. A press counts as a click up tomulti_click_press(600 ms). Without the option, the buttons behave as before, with no delay. - Icon names asked for by the panel (#830): new substitutions
api_icon_names_block(400 names per block, from 1 to 1000),api_icon_names_timeout(5 s) andapi_icon_names_retries(3). The number of names received is in the configuration log.
Improvements
- The start screen, shown at power-on until the firmware connects, is at 15 % brightness instead of 10 % (#818).
- The boot log is no longer sent to the display: its messages are in the ESPHome log instead, so the boot sends fewer commands to the display (#818).
Documentation
- Local TFT files: step-by-step instructions to host the TFT files in Home Assistant with
nextion_update_base_url, so each panel gets the file of its model, with when to restart Home Assistant and how often an old TFT is uploaded again (#833, #838). A note under the display model table explains that the file names describe the screen, so the EU panel usesnspanel_landscape.tft(#817, closes #816, related to #814). - Panel startup issues describes the status page and its checklist, when the panel asks for its settings, and what the log shows when it gives up (#818, #819, #832).
- Calendar chips and their lead time in the Blueprint documentation, and how the icon names are asked for in the API subscriptions (#812, #830).
- Hardware button double click: how to enable it, what it costs, and the timing substitutions (#811).
Development
- Issues labelled Resolved: pending confirmation are closed as completed after 7 days without a reply, and issues labelled Missing information are closed as not planned after 7 days. The AI triage says so in its comment when it asks for information, and a re-run no longer adds the label after the author replied to an earlier request for information (#809, #833, #838). The three steps of the workflow get enough operations to finish in one run, as they share the action's saved state (#833).
- The Blueprint and the TFT source on
devcarry the development version9999.99.9. - The ESPHome build takes the C++ component from the commit it builds, so a pull request from a branch older than a C++ change on
devno longer fails (#836).
Thank you
Thank you to everyone who reported, tested and contributed to this release:
- @thomashf for the PID setpoint report (#820).
- @HACS-bank for the Wi-Fi icon report (#821).
- @geoffdavis for the forecast precision report (#803).
- @Maxik933 for the hardware button double click (#811), and for the waste collection idea behind the calendar chips (#447).
- @bkbartk for the icon report and the photos that led to the icon names change (#828).
- @KoKolaj for the reports that improved the local TFT documentation (#814, #816).
What's Changed
Bug Fixes
- fix: Show forecast pressure and rain with decimals for inHg, kPa, inches and mm by @edwardtfn in #808
- fix: Keep a manual PID setpoint when Home Assistant resends the preset temperature by @edwardtfn in #822
- fix: Keep the Wi-Fi icon red when Wi-Fi is still missing during the boot by @edwardtfn in #823
- fix: Mark the Blueprint as ready when its settings are complete by @edwardtfn in #826
- fix: Keep the sleep brightness when the display light turns off at sleep by @edwardtfn in #827
- fix: Break the lines of the status box on the status page by @edwardtfn in #829
- fix: Review findings on the release by @edwardtfn in #833
- fix: Use the int32_t format in the icon names range warning by @edwardtfn in #835
- fix: Close Bluetooth proxy connections before the TFT upload disables Bluetooth by @edwardtfn in #837
- fix: Second round of review findings on the release by @edwardtfn in #838
New Features
- feat: Show calendar entities as chips, with a lead time before the event by @edwardtfn in #812
- feat: Status page for troubleshooting, opened from the settings page by @edwardtfn in #818
- feat: The panel requests its settings and knows when they are complete by @edwardtfn in #819
- feat: Let the panel ask for the icon names, one block at a time by @edwardtfn in #830
- feat: Status page as a checklist, with what the firmware knows by @edwardtfn in #832
- feat: Status page, settings and icon names asked for by the panel, and calendar chips by @edwardtfn in #831
Documentation
- docs: Recommend a local base URL for hosting TFT files by @edwardtfn in #817
CI & Automation
- ci: Close issues automatically when a resolution or a request for information gets no reply by @edwardtfn in #809
- ci: Build the C++ component from the same commit as the YAML by @edwardtfn in #836
Other Changes
New Contributors
Full Changelog: v2026.11.17...v2026.11.18