Printer Debug 2

2026-09-07 11:22:14 +10:00
parent eb986581e4
commit b1a793302d
3 changed files with 123 additions and 1 deletions
@@ -216,6 +216,22 @@ different and only one will suit how you hang them.
 type and the colour option. It is not itself a saved setting — the three fields it fills are what
 get stored, which is why it can appear to "revert" when the same dimensions describe two rolls.

+**Diagnostics from the command line.** When the console is not enough:
+
+```bash
+docker compose exec visitor-signin node scripts/print-test.mjs        # render and print
+docker compose exec visitor-signin node scripts/print-test.mjs --dry  # render only
+docker compose exec visitor-signin node scripts/print-test.mjs --label 62x100
+```
+
+It prints the settings it is using, the exact `brother_ql` command, and the printer's full reply.
+`--label` and `--rotate` override the saved settings for one run, so alternatives can be tried
+without saving anything.
+
+**Continuous versus die-cut matters.** `62` means a continuous roll cut to length; `62x100` means
+pre-cut labels. Sending one id to the other kind of roll is refused as a wrong roll, and this is
+the most common cause of that error after the two-colour setting.
+
 **Diagnostics.** The site card has a **Diagnostics** button showing exactly what would be sent,
 including the `brother_ql` command line, so it can be run by hand on the host. A failed test print
 shows the printer's own words rather than a summary.