tft: firmware files from a local firmware/ folder, checked by SHA-256

Nextion's seven firmware files cannot be in the repo, so the repo now
ships their SHA-256 hashes (src/nxhmi/firmware.sha256, Editor
1.68.2.3035) and every build checks the files against them. The files
live in the git-ignored firmware/ folder; `nxhmi firmware --from
<Editor folder>` copies them, `nxhmi firmware` reports ok / missing /
wrong hash. build-tft and the MCP tool take --firmware-dir /
firmware_dir (also NXHMI_FIRMWARE_DIR) instead of the Editor folder.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
mangavalkandClaude Opus 5.5 committed 2026-11-16 23:47:16 +01:00
1 parent 0287cf21e4
commit 85422a1ef4
14 files changed
+259 -44

No files matched your search

+16 -1
View File
@@ -37,7 +37,22 @@ Every percentage is a count with a stated basis, so it can be checked (details i
Research stage. The goal is output byte-identical to Nextion Editor's; anything not measured is
refused with the reason instead of guessed. Checked against 84 Editor-compiled sample projects.
The firmware files inside every `.tft` are read from your own Editor installation at build time.
**Firmware files (needed once, not in this repo).** Every `.tft` embeds seven of Nextion's own
firmware files (`input.bin`, `asp0.dll`, `cd0.dll`, `qr0.bin`, `syscom.bin`, `h0-0.dll`,
`h1-0.dll`). They are Nextion's property, so this repo cannot include them. Copy them from your
own Nextion Editor installation into the repo's [`firmware/`](firmware/README.md) folder, which git
ignores:
```
python -m nxhmi firmware --from "C:\Program Files (x86)\Nextion Editor"
```
Because the files cannot be shipped, the repo ships their SHA-256 hashes instead
([`src/nxhmi/firmware.sha256`](src/nxhmi/firmware.sha256), from Nextion Editor 1.68.2.3035). Every
build checks the files against these hashes first, and refuses missing files or files from another
Editor version. `python -m nxhmi firmware` shows the state per file. Use `--firmware-dir` or
`NXHMI_FIRMWARE_DIR` to keep them elsewhere.
| Sub-goal | Status | Basis |
|---|---|---|