Max Gramser
3e959b3df9
Everything a user sees or reads is now English: both boards' labels, status replies and logs, the ESP Screens editor and Alerts cheatsheet, and the README and guides (docs/TILES.md, CALIBRATING.md, ACCEPTANCE.md and TROUBLESHOOTING.md replace the Dutch file names). Labels follow Home Assistant's own English names (Heat/Cool modes, Heating/Cooling actions, Away, Returning to dock, weather conditions), dates use English abbreviations and the top bar writes numbers the English way. Docs use HA 2026.9's menu names (Settings -> Apps, App store, Settings -> Tools). Unused legacy files (home-like.yaml, buttons.yaml, a.out) are removed. Firmware 0.2.34 names its entities in English. Home Assistant registers a renamed ESPHome entity under a new entity ID, so the inbox text.<screen>_tegelinstellingen becomes text.<screen>_tile_settings and the layout stored under the old ID would be lost. The manager now recognises the screen by its device, during a run or after a restart, and moves its layout and update history along; the Update button and the nightly round follow the screen through the rename. Screens that still run 0.2.33 or older keep working: both languages are matched. Main is the only release branch from now on. Tested on a Home Assistant Yellow (HA 2026.9.1) with both bench boards: see docs/TEST_RESULTS_0240.md. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
67 lines
3.5 KiB
Markdown
67 lines
3.5 KiB
Markdown
# Upgrading an existing CYD panel to runtime 0.2.7
|
||
|
||
Board: ESP32-2432S028, ESP32-D0WD-V3; MAC b0:cb:d8:e7:bd:7c.
|
||
Kept the existing identity CYD 2.8in Display / cyd-2432s028. The USB port was
|
||
identified beforehand with esptool; the Guition was on a different USB port.
|
||
|
||
Own profile: gitignored easy-cyd-device.yaml, with the existing local
|
||
calibration.yaml and API/OTA/Wi-Fi secret references. A backup of the first
|
||
64 KiB (partition/configuration space) is stored locally. A full fast
|
||
read gave a serial error; the full slow read was aborted.
|
||
So this is not a complete old-firmware backup. USB upload at 115200 succeeded;
|
||
further correction via the verified OTA host.
|
||
|
||
The existing affine calibration was written once into preference key 0x43594403.
|
||
After that, the final profile uses the standard boot and existing NVS.
|
||
|
||
## Found during the upgrade
|
||
|
||
A temporary on_boot list in the local migration profile replaced the package's
|
||
on_boot object. As a result, the normal UI initialization was missing and
|
||
the start of the render diagnostic crashed. The temporary import was removed after the
|
||
calibration had been saved. In the final generated C++, runtime-bind,
|
||
light_controls::setup, and screen_calibration::setup are present again. The full
|
||
render diagnostic then passes (ten page checks and fifty overlays).
|
||
Don't use this temporary migration profile for future flashes.
|
||
|
||
HA discovered the new Tegelinstellingen entity without a new API key. The old
|
||
ten entities were carried over; the user then changed the layout.
|
||
That current layout is preserved. Swipe is on, standby 600 seconds. With six
|
||
tiles or fewer, pagination stays hidden.
|
||
|
||
Final build: ESPHome 2026.6.2, 2026-09-12 17:50:49 +0200,
|
||
config_hash=0x0a15a59f, source commit a14a66f.
|
||
|
||
## Verification
|
||
|
||
- Final build and OTA upload succeeded; identity and firmware version checked
|
||
via the encrypted API.
|
||
- Render diagnostic: ten successful page checks, fifty overlay cycles, and
|
||
`Light sliders: PASS`. The diagnostic used the two tiles configured at the time;
|
||
this is not a physical swipe check of four pages.
|
||
- Home Assistant and ESP Screen Manager report the panel online with version 0.2.7.
|
||
The user's changes to the tile layout are preserved.
|
||
- Existing calibration reused; no new independent physical calibration
|
||
measurement was performed during this upgrade.
|
||
|
||
The 0.2.7 observation ran for fifteen minutes complete, with a live API response every
|
||
thirty seconds, with no restart or connection loss. Free memory around
|
||
111–119 kB. Because of physical use, ten minutes of uninterrupted inactivity
|
||
was not reached; standby/wake was not confirmed in this observation.
|
||
|
||
## Follow-up: text layout 0.2.8
|
||
|
||
The owner then reported titles running off the edge, subtitles truncated too early,
|
||
and an overlapping mini-slider. So stability alone doesn't confirm the
|
||
layout's usability. The titles had no explicit width, and the
|
||
subtitle inherited the title's content width. The compact card also had
|
||
insufficient vertical space for the extra slider.
|
||
|
||
Runtime 0.2.8 bounds both lines to the available content width, expands that
|
||
when an icon is hidden, and reserves separate space for the slider on the CYD.
|
||
The render diagnostic now checks the real LVGL coordinates for clipping outside the
|
||
box and overlap between text lines/slider. With the current four tiles, including
|
||
a light with a mini-slider: ten page checks and fifty overlay cycles passed.
|
||
The slider test also passes. Physical confirmation of the new layout is still open.
|
||
The fifteen minutes above apply to 0.2.7, not to this follow-up build.
|