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>
- five more Basic types in tft_types (default variants; others refused)
- the page RAM image starts with 4 x FF + one FF per component (padded to 4)
- README: .tft status split into sub-goals with a stated basis each
- sample generator: display direction and gradient pictures; regression test
walks sub-folders (84 Editor samples reproduced)
Co-Authored-By: Claude Fable 5.2 <noreply@anthropic.com>
build-tft now reproduces 35 Editor-made samples byte for byte: assignments,
arithmetic, 27 commands, system variables and colours, attribute references,
Program.s globals, all page/hotspot/timer events, if/else/while/for.
Co-Authored-By: Claude Fable 5.2 <noreply@anthropic.com>
Byte-identical to Nextion Editor 1.68.2 for NX4832T035 projects made of pages,
hotspots and int variables with any pictures and fonts. Firmware files are read
from the user's Editor folder at build time. FORMAT.md section 7 documents the
header, resource area, code blob, attribute records, page table and objects.
Co-Authored-By: Claude Fable 5.2 <noreply@anthropic.com>
0x44 = CRC of the resource area, 0xC4 = CRC of header [0,0xC4), 0x18C = CRC of
[0xC8,0x18C); trailer = CRC of the whole file ^ (len & 0xFF) ^ 0x56. tft.seal()
recomputes all of them. Verified against 24 Editor-made files of 8 lengths.
Co-Authored-By: Claude Fable 5.2 <noreply@anthropic.com>
- 15 more models (Discovery, Enhanced, Edge, NX8048P043): ids and series bytes 1/6/100 from the
Editor; native orientation per series; Discovery/Enhanced/Edge use the Basic templates
- per series picture format and storage direction: Enhanced like Basic, Edge format 4,
Discovery format 3 (20 zero bytes + raw RGB565) always stored row by row; fonts likewise
- component colours are scaled (v*255//31) on every series -- exact against the canvas with zero
tolerance; format-0 pictures stay bit-replicated
- format-4 encoder: literal pixels when the next 8 runs cover <= 10 pixels (7+ runs), 8 pixels at
a time -- reproduces the Editor on 12 designed patterns plus the 28 earlier samples
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Integer radius (h-1)//2 with fixed sub-pixel offsets, 4 sub-rows x 1/8 px spans, 1/32 coverage
in linear light; closer to the simulator than the previous distance model on the knob test page.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Font Creator output decoded (lead/trail ranges and gaps in the header, map codes = bytes as
little-endian u16 or Unicode code points) and round-tripped byte for byte; from_ttf(chars=)
builds them; the renderer splits text like the simulator (any byte >= 0x81 starts a pair,
missing characters advance one space) -- pixel-exact for all five encodings.
Intelligent glyph data is 8-byte aligned (was 4). CLI add-font --chars/--chars-file, MCP chars.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Header byte 1 = quality; data type 0 = baseline JPEG of the picture padded with black to
multiples of 16 and then rotated for the display direction (libjpeg/Pillow, 4:2:0, 96 dpi),
byte-identical to the Editor for opaque pictures (18/18); alpha runs cover the padded picture.
add_picture(quality=), CLI add-picture -q, MCP add_picture quality; decoder in to_image.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
The Font Creator's anti-aliased fonts are 1-bit glyphs with header flag 0x1E (the simulator draws
them with two colours). Map bytes 3/4 are extra columns left/right of the advance width; glyphs
are drawn starting 'left' px early. Editor-generated fonts now round-trip byte for byte.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Value lists read from the Editor's attribute notes with an Intelligent model: drag, load effect
(page has two more), transparency background, switch direction, ComboBox arrow/expansion,
TextSelect lines, scroll bars, DataRecord options, media source/state/looping.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
- SLText, TextSelect, DataRecord, FileBrowser pixel-exact against the Intelligent simulator;
ComboBox and Switch with approximate anti-aliased edges; media/file components draw nothing
- fonts: header byte 3 = 0x0A + direction, glyphs in the direction's pixel order, Intelligent
glyph data 4-byte aligned -- reproduces the Editor's own font conversion byte for byte
- Intelligent 3D frames: left edge drawn over the bottom edge
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Format 4 decoded from Editor output: control words of eight 4-bit ops
(runs up to 13, 12-bit long runs, literal blocks) over 8 colour slots,
plus a run-length 7-bit alpha section. The encoder reproduces all 28
Editor samples byte for byte and the Editor keeps our pictures as is.
Pictures are stored rotated by the display direction, byte 0 of N.i is
0x0A + direction; this applies to format 0 too. add_picture now writes
the right format and order for the project; the renderer decodes format
4 and blends alpha.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Byte 12 is the display direction (90-degree steps) and byte 13 the
character encoding -- the docs had them swapped. Basic panels are
portrait at 0 degrees, Intelligent ones landscape, so new Intelligent
projects used to open in portrait. new_project takes portrait= and
encoding=; all 24 Editor encodings are mapped; parse_main reports both.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
nxhmi.qr is a dependency-free QR encoder. Measured in the Editor
simulator: numeric/alphanumeric/byte mode by content, level L, mask 0,
smallest version; scaled to w - 2*dis by width (not clipped to h), last
column run one pixel narrower, logo centred, nothing when too small.
Basic rendering is now 20/20 pixel-exact.
Also: unknown component kinds give a clean CLI error instead of a
traceback.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
The needle is the display's own routine, measured on 112 needles in the
Editor simulator: tip from quadrant-reduced sin/cos, truncated; line from
tip to centre with a biased DDA; wider needles stamp wid x wid squares
along a line shortened by wid - 1. Length follows the height.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Harvested the cir/cirs output for every radius 1..159 from Nextion
Editor's simulator and derived the incremental midpoint rule that
reproduces all of them; radio = width-sized circle clipped to the box,
dot radius r//2. Basic rendering coverage 18/20.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
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>
Black-box reverse-engineered .HMI format (container, three checksums,
pages, all 31 component types, pictures, fonts), readable JSON, page
renderer matching Nextion Editor, demo project built from code and a
test suite (66 tests). See docs/COVERAGE.md for status.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>