Document the tested Nextion Editor version (1.68.2.3035)

TESTED_EDITOR_VERSION constant, README compatibility section with the
check to run after an Editor update, CLAUDE.md rules for other builds,
canary test on the fixture's version marker.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
mangavalkandClaude Opus 5.5 committed 2026-11-15 15:20:27 +01:00
1 parent 69e22cfb06
commit 82ab4177d1
6 files changed
+35 -3

No files matched your search

+14 -1
View File
@@ -20,7 +20,7 @@ writes; no Nextion software was decompiled.
| Area | Coverage |
|---|---|
| `.HMI` read / write / build from scratch | complete for Basic (T) and Intelligent (P) series projects; output byte-identical to Nextion Editor 1.68 |
| `.HMI` read / write / build from scratch | complete for Basic (T) and Intelligent (P) series projects; output byte-identical to Nextion Editor 1.68.2 |
| Checksums | all three (page, project header, file table) |
| Components | all 31 types, with the Editor's own defaults |
| Readable JSON | enum names and `#rrggbb` colours, still byte-exact on the way back |
@@ -31,6 +31,19 @@ writes; no Nextion software was decompiled.
Details and the full list of gaps: [docs/COVERAGE.md](docs/COVERAGE.md).
## Compatibility
Everything here was reverse-engineered and verified against **Nextion Editor 1.68.2 (build
1.68.2.3035)** on Windows; `nxhmi.TESTED_EDITOR_VERSION` holds that version. Files written by nxhmi
open in that Editor, and the test fixture is a project re-saved by it.
- Older projects (tested with one saved by an older Editor in 2019) read and round-trip fine; when
1.68.2 re-saves them it upgrades a few header bytes (see docs/FORMAT.md).
- **After a Nextion Editor update**: open `demo/demo.HMI` in the new Editor, File > Save As, and
compare it with `tests/fixtures/demo_editor_saved.HMI` (e.g. `python -m nxhmi info` on both, or
replace the fixture and run the tests). If anything differs, the format changed -- please open
an issue with the Editor version.
## Install
Python 3.9+. Pillow is only needed for pictures, font generation and rendering.