2026-11-15 15:11:02 +01:00
|
|
|
"""Command line interface: ``python -m nxhmi <command> ...``"""
|
|
|
|
|
from __future__ import annotations
|
|
|
|
|
|
|
|
|
|
import argparse
|
|
|
|
|
import json
|
|
|
|
|
import sys
|
|
|
|
|
|
|
|
|
|
from . import checksum, project
|
|
|
|
|
from .container import HMIFile
|
|
|
|
|
from .page import Page
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
def cmd_info(a):
|
2026-11-15 15:27:01 +01:00
|
|
|
if a.json:
|
|
|
|
|
from .mcp_server import t_info
|
|
|
|
|
print(json.dumps(t_info(a.hmi), indent=1, ensure_ascii=False))
|
|
|
|
|
return
|
2026-11-15 15:11:02 +01:00
|
|
|
h = HMIFile.load(a.hmi)
|
|
|
|
|
t0, t1 = h.table_ok()
|
|
|
|
|
print("file table: primary %s, backup %s" % ("ok" if t0 else "BAD", "ok" if t1 else "BAD"))
|
|
|
|
|
for e in h.entries:
|
|
|
|
|
flag = "deleted" if e.deleted else ""
|
|
|
|
|
shown = e.name if not e.deleted else "(%s)" % e.name.encode("latin-1").decode("ascii", "replace").replace("�", "?").replace("\0", "?")
|
|
|
|
|
line = "%-16s %8d bytes @0x%07X %s" % (shown, e.size, e.start, flag)
|
|
|
|
|
if not e.deleted and e.name.endswith(".pa"):
|
|
|
|
|
blob = h.read(e.name)
|
|
|
|
|
ok = checksum.page_crc(blob) == int.from_bytes(blob[:4], "little")
|
|
|
|
|
p = Page.parse(blob, verify=False)
|
|
|
|
|
line += " page %-14s %3d components crc %s" % (p.name, len(p.components), "ok" if ok else "BAD")
|
|
|
|
|
print(line)
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
def cmd_verify(a):
|
|
|
|
|
bad = 0
|
|
|
|
|
for path in a.hmi:
|
|
|
|
|
h = HMIFile.load(path)
|
|
|
|
|
for e in h.live():
|
|
|
|
|
blob = h.read(e.name)
|
|
|
|
|
stored = int.from_bytes(blob[:4], "little")
|
|
|
|
|
if e.name.endswith(".pa") and checksum.page_crc(blob) != stored:
|
|
|
|
|
print("%s: %s page checksum BAD" % (path, e.name)); bad += 1
|
|
|
|
|
if e.name == "main.HMI" and checksum.main_crc(blob) != stored:
|
|
|
|
|
print("%s: main.HMI checksum BAD" % path); bad += 1
|
|
|
|
|
t0, t1 = h.table_ok()
|
|
|
|
|
if not (t0 and t1):
|
|
|
|
|
print("%s: file table checksum BAD (primary %s, backup %s)" % (path, t0, t1)); bad += 1
|
|
|
|
|
if not bad:
|
|
|
|
|
print("%s: ok" % path)
|
|
|
|
|
return 1 if bad else 0
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
def cmd_decode(a):
|
|
|
|
|
m = project.decode(a.hmi, a.out, a.encoding, not a.raw)
|
|
|
|
|
print("decoded %d entries into %s" % (len(m["entries"]), a.out))
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
def cmd_encode(a):
|
|
|
|
|
project.encode(a.folder, a.hmi)
|
|
|
|
|
print("wrote", a.hmi)
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
def cmd_set(a):
|
|
|
|
|
"""Set one attribute in place: nxhmi set file.HMI page objname attr value [-o out]"""
|
|
|
|
|
h = HMIFile.load(a.hmi)
|
|
|
|
|
for e in h.live():
|
|
|
|
|
if not e.name.endswith(".pa"):
|
|
|
|
|
continue
|
|
|
|
|
p = Page.parse(h.read(e.name))
|
|
|
|
|
if p.name != a.page:
|
|
|
|
|
continue
|
|
|
|
|
c = p.component(a.component)
|
|
|
|
|
if c is None:
|
|
|
|
|
sys.exit("no component %r on page %r" % (a.component, a.page))
|
|
|
|
|
kind, _ = c.attr(a.attr).decoded()
|
|
|
|
|
c.set(a.attr, a.value if kind in ("str", "hex") else int(a.value, 0))
|
|
|
|
|
h.write(e.name, p.pack())
|
|
|
|
|
h.save(a.out or a.hmi)
|
|
|
|
|
print("set %s.%s.%s = %s" % (a.page, a.component, a.attr, a.value))
|
|
|
|
|
return
|
|
|
|
|
sys.exit("no page %r" % a.page)
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
def cmd_add(a):
|
|
|
|
|
"""Add a component: nxhmi add file.HMI page kind [name=value ...] [--name obj] [-o out]"""
|
|
|
|
|
from . import components
|
|
|
|
|
h = HMIFile.load(a.hmi)
|
|
|
|
|
for e in h.live():
|
|
|
|
|
if not e.name.endswith(".pa"):
|
|
|
|
|
continue
|
|
|
|
|
p = Page.parse(h.read(e.name))
|
|
|
|
|
if p.name != a.page:
|
|
|
|
|
continue
|
|
|
|
|
kw = {}
|
|
|
|
|
for item in a.attrs:
|
|
|
|
|
k, _, v = item.partition("=")
|
|
|
|
|
try:
|
|
|
|
|
kw[k] = int(v, 0)
|
|
|
|
|
except ValueError:
|
|
|
|
|
kw[k] = v
|
|
|
|
|
c = components.add(p, a.kind, a.name, **kw)
|
|
|
|
|
h.write(e.name, p.pack())
|
|
|
|
|
h.save(a.out or a.hmi)
|
|
|
|
|
print("added %s (%s, id %d) to page %s" % (c.name, a.kind, c.get("id"), p.name))
|
|
|
|
|
return
|
|
|
|
|
sys.exit("no page %r" % a.page)
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
def cmd_new_page(a):
|
|
|
|
|
from . import project
|
|
|
|
|
h = HMIFile.load(a.hmi)
|
|
|
|
|
project.add_page(h, a.name)
|
|
|
|
|
h.save(a.out or a.hmi)
|
|
|
|
|
print("added page", a.name)
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
def cmd_add_font(a):
|
|
|
|
|
from . import fonts, project
|
|
|
|
|
h = HMIFile.load(a.hmi)
|
|
|
|
|
f = fonts.from_ttf(a.ttf, a.height, a.encoding, a.fixed_width)
|
|
|
|
|
fid = project.add_font(h, f)
|
|
|
|
|
h.save(a.out or a.hmi)
|
|
|
|
|
print("added font id %d (%s, %d chars)" % (fid, f.name, len(f.glyphs)))
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
def cmd_add_picture(a):
|
|
|
|
|
from . import project
|
|
|
|
|
h = HMIFile.load(a.hmi)
|
|
|
|
|
with open(a.image, "rb") as f:
|
|
|
|
|
pid = project.add_picture(h, f.read())
|
|
|
|
|
h.save(a.out or a.hmi)
|
|
|
|
|
print("added picture id", pid)
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
def cmd_render(a):
|
|
|
|
|
import os
|
|
|
|
|
from .render import Renderer
|
|
|
|
|
r = Renderer(HMIFile.load(a.hmi))
|
|
|
|
|
names = [k for k in r.pages if isinstance(k, str)]
|
|
|
|
|
todo = names if a.page in (None, "all") else [a.page]
|
|
|
|
|
os.makedirs(a.out, exist_ok=True)
|
|
|
|
|
for n in todo:
|
|
|
|
|
path = os.path.join(a.out, "%s.png" % n)
|
|
|
|
|
r.render(n).save(path)
|
|
|
|
|
print("wrote", path)
|
|
|
|
|
|
|
|
|
|
|
2026-11-15 15:27:01 +01:00
|
|
|
def cmd_schema(a):
|
|
|
|
|
from .mcp_server import t_schema
|
|
|
|
|
print(json.dumps(t_schema(a.kind), indent=1, ensure_ascii=False))
|
|
|
|
|
|
|
|
|
|
|
2026-11-15 15:11:02 +01:00
|
|
|
def cmd_kinds(a):
|
|
|
|
|
from . import components
|
|
|
|
|
for k in components.kinds():
|
|
|
|
|
print(k)
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
def cmd_dump(a):
|
|
|
|
|
h = HMIFile.load(a.hmi)
|
|
|
|
|
for e in h.live():
|
|
|
|
|
if e.name.endswith(".pa"):
|
|
|
|
|
p = Page.parse(h.read(e.name))
|
|
|
|
|
if a.page and p.name != a.page:
|
|
|
|
|
continue
|
|
|
|
|
print(json.dumps(project.page_to_json(e.name, p, a.encoding, not a.raw), indent=1, ensure_ascii=False))
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
def main(argv=None):
|
|
|
|
|
ap = argparse.ArgumentParser(prog="nxhmi", description="Read, verify and write Nextion Editor .HMI projects")
|
|
|
|
|
sub = ap.add_subparsers(dest="cmd", required=True)
|
2026-11-15 15:27:01 +01:00
|
|
|
s = sub.add_parser("info", help="list entries, pages and checksum status"); s.add_argument("hmi")
|
|
|
|
|
s.add_argument("--json", action="store_true", help="machine-readable overview (pages, components, fonts, ...)")
|
|
|
|
|
s.set_defaults(f=cmd_info)
|
|
|
|
|
s = sub.add_parser("schema", help="attributes of a component kind (types, defaults, allowed values)")
|
|
|
|
|
s.add_argument("kind"); s.set_defaults(f=cmd_schema)
|
2026-11-15 15:11:02 +01:00
|
|
|
s = sub.add_parser("verify", help="check every checksum"); s.add_argument("hmi", nargs="+"); s.set_defaults(f=cmd_verify)
|
|
|
|
|
s = sub.add_parser("decode", help="HMI -> folder of JSON/text"); s.add_argument("hmi"); s.add_argument("out")
|
|
|
|
|
s.add_argument("--encoding", default="latin-1"); s.add_argument("--raw", action="store_true", help="numbers instead of names/colours")
|
|
|
|
|
s.set_defaults(f=cmd_decode)
|
|
|
|
|
s = sub.add_parser("encode", help="folder -> new HMI"); s.add_argument("folder"); s.add_argument("hmi"); s.set_defaults(f=cmd_encode)
|
|
|
|
|
s = sub.add_parser("set", help="change one attribute")
|
|
|
|
|
for n in ("hmi", "page", "component", "attr", "value"):
|
|
|
|
|
s.add_argument(n)
|
|
|
|
|
s.add_argument("-o", "--out"); s.set_defaults(f=cmd_set)
|
|
|
|
|
s = sub.add_parser("add", help="add a component to a page (kind: see 'kinds')")
|
|
|
|
|
s.add_argument("hmi"); s.add_argument("page"); s.add_argument("kind")
|
|
|
|
|
s.add_argument("attrs", nargs="*", help="attribute=value, e.g. x=10 y=20 txt=Hi")
|
|
|
|
|
s.add_argument("--name"); s.add_argument("-o", "--out"); s.set_defaults(f=cmd_add)
|
|
|
|
|
s = sub.add_parser("render", help="render pages to PNG like the Editor's canvas (needs Pillow)")
|
|
|
|
|
s.add_argument("hmi"); s.add_argument("out", help="output folder"); s.add_argument("--page", help="page name (default: all)")
|
|
|
|
|
s.set_defaults(f=cmd_render)
|
|
|
|
|
s = sub.add_parser("kinds", help="list component kinds that can be added"); s.set_defaults(f=cmd_kinds)
|
|
|
|
|
s = sub.add_parser("add-font", help="rasterize a .ttf into a new font (needs Pillow)")
|
|
|
|
|
s.add_argument("hmi"); s.add_argument("ttf"); s.add_argument("height", type=int)
|
|
|
|
|
s.add_argument("--encoding", default="ascii", choices=["ascii", "iso-8859-1"])
|
|
|
|
|
s.add_argument("--fixed-width", type=int); s.add_argument("-o", "--out"); s.set_defaults(f=cmd_add_font)
|
|
|
|
|
s = sub.add_parser("add-picture", help="add a picture (png/jpg/bmp; needs Pillow)")
|
|
|
|
|
s.add_argument("hmi"); s.add_argument("image"); s.add_argument("-o", "--out"); s.set_defaults(f=cmd_add_picture)
|
|
|
|
|
s = sub.add_parser("new-page", help="add an empty page"); s.add_argument("hmi"); s.add_argument("name")
|
|
|
|
|
s.add_argument("-o", "--out"); s.set_defaults(f=cmd_new_page)
|
|
|
|
|
s = sub.add_parser("dump", help="print pages as JSON"); s.add_argument("hmi"); s.add_argument("--page")
|
|
|
|
|
s.add_argument("--encoding", default="latin-1"); s.add_argument("--raw", action="store_true"); s.set_defaults(f=cmd_dump)
|
|
|
|
|
a = ap.parse_args(argv)
|
2026-11-15 16:17:23 +01:00
|
|
|
try:
|
|
|
|
|
return a.f(a) or 0
|
|
|
|
|
except (ValueError, KeyError) as e:
|
|
|
|
|
print("error:", e.args[0] if e.args else e, file=sys.stderr)
|
|
|
|
|
return 2
|
2026-11-15 15:11:02 +01:00
|
|
|
|
|
|
|
|
|
|
|
|
|
if __name__ == "__main__":
|
|
|
|
|
sys.exit(main())
|