daru/nelko-p21-print
Watch
1
0
Fork
You've already forked nelko-p21-print
 0
Code Issues 5 Pull requests Projects Releases Packages Wiki Activity Actions

docs: README — web UI section and BEEP/TIMER command framing #5

New issue
Open
opened 2026-10-19 03:42:41 +00:00 by time · 0 comments
time commented 2026-10-19 03:42:41 +00:00
Collaborator
Copy link

Two README gaps surfaced while building the web UI:

  1. Web UI section: document webui/ — how to run it (webui/run.sh start --mac <MAC>, Flask on 127.0.0.1:8091), the caddy reverse-proxy snippet for label.cryogen.cc, the endpoints (/status, /preview, /print, /fonts, /emoji), the browser-side persistence of the last print settings, and the raw-socket transport (no root needed, unlike the CLI's /dev/rfcomm0 path).
  2. BEEP/TIMER framing: the settings table says the argument "is the raw byte 0x00/0x01, not an ASCII digit" but doesn't mention the required space separator. The working form is BEEP \x00\r\n / TIMER \x00\r\n (as sent by p21_print.py). Sending BEEP\x00\r\n without the space is silently misparsed — observed corrupting the timer config byte to 0xff. Add the exact byte sequences to the table.

Reported 2026-10-18 during web UI development (branch webui).

Two README gaps surfaced while building the web UI: 1. **Web UI section**: document `webui/` — how to run it (`webui/run.sh start --mac <MAC>`, Flask on 127.0.0.1:8091), the caddy reverse-proxy snippet for `label.cryogen.cc`, the endpoints (`/status`, `/preview`, `/print`, `/fonts`, `/emoji`), the browser-side persistence of the last print settings, and the raw-socket transport (no root needed, unlike the CLI's `/dev/rfcomm0` path). 2. **BEEP/TIMER framing**: the settings table says the argument "is the raw byte `0x00`/`0x01`, not an ASCII digit" but doesn't mention the required space separator. The working form is `BEEP \x00\r\n` / `TIMER \x00\r\n` (as sent by `p21_print.py`). Sending `BEEP\x00\r\n` without the space is silently misparsed — observed corrupting the timer config byte to `0xff`. Add the exact byte sequences to the table. Reported 2026-10-18 during web UI development (branch `webui`).
Sign in to join this conversation.
No Branch/Tag specified
Branches Tags
webui
main
No results found.
Labels
Clear labels   
bug

   
docs
No labels
bug
docs
Milestone
Clear milestone
No items
No milestone
Projects
Clear projects
No items
No project
Assignees
Clear assignees
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set

Reference
daru/nelko-p21-print#5
No description provided.