BlueGit

timfa posprint

Document LAN TCP 9100 discovery and settings.

Mark network printing as implemented in PRINTING/HELP/ARCHITECTURE and keep Bluetooth as planned.

Co-authored-by: Cursor <cursoragent@cursor.com>

timfa Tim Falken · pushed by timfa

Authored 2026-07-28 · 3 months ago

Hash
d8a675b1ac0017c65e1332666edc16a93a72a55f
Parent
664b56f2
6 files changed +31 −24
.cursor/rules/architecture.mdc +3 −3
@@ -10,7 +10,7 @@ alwaysApply: true
10 10
11 11 - **Rust only** — no TypeScript/JavaScript frontend.
12 12 - **egui / eframe** for UI (`src/app.rs`, `src/main.rs`).
13 - **Printing:** USB printer-class (`rusb`), Windows spooler (Windows), and USB-serial (`serialport`) via `src/print/`.
13 - **Printing:** USB printer-class (`rusb`), Windows spooler (Windows), USB-serial (`serialport`), and optional LAN raw TCP 9100 via `src/print/`.
14 14
15 15 ## Module responsibilities
16 16
@@ -21,7 +21,7 @@ alwaysApply: true
21 21 | `escpos.rs` | AST → ESC/POS bytes (in-tree; no `escpos` crate) |
22 22 | `preview.rs` | AST → `PreviewModel` for UI canvas |
23 23 | `io/` | `PosFile` JSON load/save |
24 | `print/` | Discovery + transports (USB-direct, spooler, serial, mock) |
24 | `print/` | Discovery + transports (USB-direct, spooler, serial, LAN TCP 9100, mock) |
25 25 | `print_dialog.rs` | Shared print UI |
26 26 | `app.rs` | Full designer egui UI |
27 27
@@ -42,4 +42,4 @@ Do **not** add `escpos`, `nusb`, `tauri`, or a JS toolchain without a deliberate
42 42
43 43 ## Planned features (not in codebase yet)
44 44
45 Bluetooth, network TCP 9100, persisted recent files/parameters, syntax highlighting. Document these only under "Planned" sections — do not implement stubs without a task.
45 Bluetooth SPP (OS-paired devices only), persisted recent files/parameters, syntax highlighting. Document these only under "Planned" sections — do not implement stubs without a task.
@@ -10,7 +10,7 @@ alwaysApply: true
10
10
11- **Rust only** — no TypeScript/JavaScript frontend.
11- **Rust only** — no TypeScript/JavaScript frontend.
12- **egui / eframe** for UI (`src/app.rs`, `src/main.rs`).
12- **egui / eframe** for UI (`src/app.rs`, `src/main.rs`).
13- **Printing:** USB printer-class (`rusb`), Windows spooler (Windows), and USB-serial (`serialport`) via `src/print/`.
13- **Printing:** USB printer-class (`rusb`), Windows spooler (Windows), USB-serial (`serialport`), and optional LAN raw TCP 9100 via `src/print/`.
14
14
15## Module responsibilities
15## Module responsibilities
16
16
@@ -21,7 +21,7 @@ alwaysApply: true
21| `escpos.rs` | AST → ESC/POS bytes (in-tree; no `escpos` crate) |
21| `escpos.rs` | AST → ESC/POS bytes (in-tree; no `escpos` crate) |
22| `preview.rs` | AST → `PreviewModel` for UI canvas |
22| `preview.rs` | AST → `PreviewModel` for UI canvas |
23| `io/` | `PosFile` JSON load/save |
23| `io/` | `PosFile` JSON load/save |
24| `print/` | Discovery + transports (USB-direct, spooler, serial, mock) |
24| `print/` | Discovery + transports (USB-direct, spooler, serial, LAN TCP 9100, mock) |
25| `print_dialog.rs` | Shared print UI |
25| `print_dialog.rs` | Shared print UI |
26| `app.rs` | Full designer egui UI |
26| `app.rs` | Full designer egui UI |
27
27
@@ -42,4 +42,4 @@ Do **not** add `escpos`, `nusb`, `tauri`, or a JS toolchain without a deliberate
42
42
43## Planned features (not in codebase yet)
43## Planned features (not in codebase yet)
44
44
45Bluetooth, network TCP 9100, persisted recent files/parameters, syntax highlighting. Document these only under "Planned" sections — do not implement stubs without a task.
45Bluetooth SPP (OS-paired devices only), persisted recent files/parameters, syntax highlighting. Document these only under "Planned" sections — do not implement stubs without a task.
.cursor/rules/development.mdc +1 −1
@@ -11,7 +11,7 @@ alwaysApply: true
11 11 - Single language: **Rust** with **egui** (eframe) for the UI.
12 12 - Prefer std library and in-house code. Add a crate only when reimplementing would be unreasonable (e.g. `serialport`, `serde`, `image`, UI framework).
13 13 - ESC/POS encoding lives in `src/escpos.rs` — do not add the `escpos` crates.io package.
14 - Printing: USB printer-class (`rusb`), Windows spooler, and USB-serial (`serialport`). Do not add Bluetooth or network printing until explicitly requested.
14 - Printing: USB printer-class (`rusb`), Windows spooler, USB-serial (`serialport`), and optional LAN raw TCP 9100. Do not add Bluetooth until explicitly requested.
15 15
16 16 ## Testing
17 17
@@ -11,7 +11,7 @@ alwaysApply: true
11- Single language: **Rust** with **egui** (eframe) for the UI.
11- Single language: **Rust** with **egui** (eframe) for the UI.
12- Prefer std library and in-house code. Add a crate only when reimplementing would be unreasonable (e.g. `serialport`, `serde`, `image`, UI framework).
12- Prefer std library and in-house code. Add a crate only when reimplementing would be unreasonable (e.g. `serialport`, `serde`, `image`, UI framework).
13- ESC/POS encoding lives in `src/escpos.rs` — do not add the `escpos` crates.io package.
13- ESC/POS encoding lives in `src/escpos.rs` — do not add the `escpos` crates.io package.
14- Printing: USB printer-class (`rusb`), Windows spooler, and USB-serial (`serialport`). Do not add Bluetooth or network printing until explicitly requested.
14- Printing: USB printer-class (`rusb`), Windows spooler, USB-serial (`serialport`), and optional LAN raw TCP 9100. Do not add Bluetooth until explicitly requested.
15
15
16## Testing
16## Testing
17
17
docs/ARCHITECTURE.md +7 −6
@@ -9,7 +9,7 @@ posprint is a **single Rust binary** using **egui** (eframe). No separate fronte
9 9 │ posprint (Rust + egui) │
10 10 │ - Design / Help / Settings │
11 11 │ - DSL parse → AST → preview + ESC/POS │
12 │ - USB-direct / Win spooler / serial printing │
12 │ - USB-direct / Win spooler / serial / LAN TCP printing │
13 13 │ - `.pos` JSON load/save (serde) │
14 14 └──────────────────────────────────────────────────┘
15 15 ```
@@ -39,7 +39,8 @@ src/
39 39 ├── io/mod.rs # PosFile, PosMetadata
40 40 ├── pipeline.rs # Encode / print helpers
41 41 ├── print/
42 │ ├── mod.rs # list_printers, SerialTransport, MockTransport
42 │ ├── mod.rs # list_local_printers, transports, MockTransport
43 │ ├── network.rs # LAN TCP 9100 transport + subnet discovery
43 44 │ ├── usb_direct.rs # USB printer-class (rusb)
44 45 │ └── win_spool.rs # Windows spooler (Windows)
45 46 └── shell_integration.rs # .pos Print verb + posprint:// protocol (Windows)
@@ -72,11 +73,11 @@ ESC/POS generation is **in-tree** (`escpos.rs`), not the `escpos` crates.io pack
72 73 |------|--------|-------------|
73 74 | **Design** | `app.rs` | Editor + side preview |
74 75 | **Help** | `help_view.rs` | `docs/HELP.md` via `include_str!` |
75 | **Settings** | `app.rs` | Default page width; trusted `noconfirm` origins |
76 | **Settings** | `app.rs` | Default page width; LAN printers toggle/cache; trusted `noconfirm` origins |
76 77 | Toolbar | `app.rs` | New, Open, Save, Save As, Insert, Print |
77 78 | Document page width / zoom | `app.rs` | Per-document width (mm), preview zoom |
78 79 | Print dialog | `print_dialog.rs` | Parameters + multi-transport printer picker |
79 | App config | `config.rs` | `%APPDATA%/posprint/config.json` (Windows) / `~/.config/posprint/config.json` (trusted origins, default width, last printer) |
80 | App config | `config.rs` | `%APPDATA%/posprint/config.json` (Windows) / `~/.config/posprint/config.json` (trusted origins, default width, last printer, LAN cache) |
80 81
81 82 While the print dialog is open, the main UI is disabled and editor autocomplete does not steal focus.
82 83
@@ -101,9 +102,9 @@ While the print dialog is open, the main UI is disabled and editor autocomplete
101 102 ### Print
102 103
103 104 1. **Print** → parse → `collect_parameter_names`.
104 2. Dialog: text field per `${Name}`, checkbox per `$[Name]`; `list_printers()` for USB / spooler / serial.
105 2. Dialog: text field per `${Name}`, checkbox per `$[Name]`; local printers plus optional LAN TCP 9100 discovery.
105 106 3. `substitute_document` → `EscPosEncoder` → `open_printer` → `print_bytes`.
106 4. Serial baud is probed (`115200` first, then `9600`, …).
107 4. Serial baud is probed (`115200` first, then `9600`, …). LAN uses TCP connect (default port 9100).
107 108
108 109 ---
109 110
@@ -9,7 +9,7 @@ posprint is a **single Rust binary** using **egui** (eframe). No separate fronte
9│ posprint (Rust + egui) │
9│ posprint (Rust + egui) │
10│ - Design / Help / Settings │
10│ - Design / Help / Settings │
11│ - DSL parse → AST → preview + ESC/POS │
11│ - DSL parse → AST → preview + ESC/POS │
12│ - USB-direct / Win spooler / serial printing │
12│ - USB-direct / Win spooler / serial / LAN TCP printing │
13│ - `.pos` JSON load/save (serde) │
13│ - `.pos` JSON load/save (serde) │
14└──────────────────────────────────────────────────┘
14└──────────────────────────────────────────────────┘
15```
15```
@@ -39,7 +39,8 @@ src/
39├── io/mod.rs # PosFile, PosMetadata
39├── io/mod.rs # PosFile, PosMetadata
40├── pipeline.rs # Encode / print helpers
40├── pipeline.rs # Encode / print helpers
41├── print/
41├── print/
42│ ├── mod.rs # list_printers, SerialTransport, MockTransport
42│ ├── mod.rs # list_local_printers, transports, MockTransport
43│ ├── network.rs # LAN TCP 9100 transport + subnet discovery
43│ ├── usb_direct.rs # USB printer-class (rusb)
44│ ├── usb_direct.rs # USB printer-class (rusb)
44│ └── win_spool.rs # Windows spooler (Windows)
45│ └── win_spool.rs # Windows spooler (Windows)
45└── shell_integration.rs # .pos Print verb + posprint:// protocol (Windows)
46└── shell_integration.rs # .pos Print verb + posprint:// protocol (Windows)
@@ -72,11 +73,11 @@ ESC/POS generation is **in-tree** (`escpos.rs`), not the `escpos` crates.io pack
72|------|--------|-------------|
73|------|--------|-------------|
73| **Design** | `app.rs` | Editor + side preview |
74| **Design** | `app.rs` | Editor + side preview |
74| **Help** | `help_view.rs` | `docs/HELP.md` via `include_str!` |
75| **Help** | `help_view.rs` | `docs/HELP.md` via `include_str!` |
75| **Settings** | `app.rs` | Default page width; trusted `noconfirm` origins |
76| **Settings** | `app.rs` | Default page width; LAN printers toggle/cache; trusted `noconfirm` origins |
76| Toolbar | `app.rs` | New, Open, Save, Save As, Insert, Print |
77| Toolbar | `app.rs` | New, Open, Save, Save As, Insert, Print |
77| Document page width / zoom | `app.rs` | Per-document width (mm), preview zoom |
78| Document page width / zoom | `app.rs` | Per-document width (mm), preview zoom |
78| Print dialog | `print_dialog.rs` | Parameters + multi-transport printer picker |
79| Print dialog | `print_dialog.rs` | Parameters + multi-transport printer picker |
79| App config | `config.rs` | `%APPDATA%/posprint/config.json` (Windows) / `~/.config/posprint/config.json` (trusted origins, default width, last printer) |
80| App config | `config.rs` | `%APPDATA%/posprint/config.json` (Windows) / `~/.config/posprint/config.json` (trusted origins, default width, last printer, LAN cache) |
80
81
81While the print dialog is open, the main UI is disabled and editor autocomplete does not steal focus.
82While the print dialog is open, the main UI is disabled and editor autocomplete does not steal focus.
82
83
@@ -101,9 +102,9 @@ While the print dialog is open, the main UI is disabled and editor autocomplete
101### Print
102### Print
102
103
1031. **Print** → parse → `collect_parameter_names`.
1041. **Print** → parse → `collect_parameter_names`.
1042. Dialog: text field per `${Name}`, checkbox per `$[Name]`; `list_printers()` for USB / spooler / serial.
1052. Dialog: text field per `${Name}`, checkbox per `$[Name]`; local printers plus optional LAN TCP 9100 discovery.
1053. `substitute_document` → `EscPosEncoder` → `open_printer` → `print_bytes`.
1063. `substitute_document` → `EscPosEncoder` → `open_printer` → `print_bytes`.
1064. Serial baud is probed (`115200` first, then `9600`, …).
1074. Serial baud is probed (`115200` first, then `9600`, …). LAN uses TCP connect (default port 9100).
107
108
108---
109---
109
110
docs/DSL-SPEC.md +1 −1
@@ -311,7 +311,7 @@ Full command details: [PRINTING.md](PRINTING.md).
311 311
312 312 - `@table` for columnar line items
313 313 - Numbered lists
314 - Bluetooth / network printer transports
314 - Bluetooth printer transport (after OS pairing; connected devices only)
315 315 - Syntax highlighting in the editor
316 316
317 317 ---
@@ -311,7 +311,7 @@ Full command details: [PRINTING.md](PRINTING.md).
311
311
312- `@table` for columnar line items
312- `@table` for columnar line items
313- Numbered lists
313- Numbered lists
314- Bluetooth / network printer transports
314- Bluetooth printer transport (after OS pairing; connected devices only)
315- Syntax highlighting in the editor
315- Syntax highlighting in the editor
316
316
317---
317---
docs/HELP.md +3 −2
@@ -10,7 +10,7 @@ Built-in reference for the template editor and POS markup language.
10 10 |-----|---------|
11 11 | **Design** | Side-by-side template editor and live preview |
12 12 | **Help** | This documentation |
13 | **Settings** | Default page width for new documents; trusted sites for `noconfirm` |
13 | **Settings** | Default page width; LAN printers (TCP 9100) on/off + cache; trusted sites for `noconfirm` |
14 14
15 15 ## Toolbar actions
16 16
@@ -288,8 +288,9 @@ Printers may appear as:
288 288 - **USB printer-class** devices (direct bulk OUT)
289 289 - **Windows spooler** queues (Windows)
290 290 - **USB-serial** ports with a device attached (`COMx`, `/dev/ttyUSB0`, `/dev/ttyACM0`, …)
291 - **LAN** printers on TCP port **9100** (raw ESC/POS), when enabled under **Settings → LAN network printers** (off by default). Discovery validates the previous LAN cache first, then scans the local subnet.
291 292
292 Empty motherboard serial ports (common on Linux as `/dev/ttyS*`) are hidden. Use **Enter port or queue manually** if you need one of those.
293 Empty motherboard serial ports (common on Linux as `/dev/ttyS*`) are hidden. Use **Enter port, queue, or LAN address manually** for those or for a known `192.168.x.x` / `host:9100`.
293 294
294 295 **Linux serial:** join the `dialout` group.
295 296
@@ -10,7 +10,7 @@ Built-in reference for the template editor and POS markup language.
10|-----|---------|
10|-----|---------|
11| **Design** | Side-by-side template editor and live preview |
11| **Design** | Side-by-side template editor and live preview |
12| **Help** | This documentation |
12| **Help** | This documentation |
13| **Settings** | Default page width for new documents; trusted sites for `noconfirm` |
13| **Settings** | Default page width; LAN printers (TCP 9100) on/off + cache; trusted sites for `noconfirm` |
14
14
15## Toolbar actions
15## Toolbar actions
16
16
@@ -288,8 +288,9 @@ Printers may appear as:
288- **USB printer-class** devices (direct bulk OUT)
288- **USB printer-class** devices (direct bulk OUT)
289- **Windows spooler** queues (Windows)
289- **Windows spooler** queues (Windows)
290- **USB-serial** ports with a device attached (`COMx`, `/dev/ttyUSB0`, `/dev/ttyACM0`, …)
290- **USB-serial** ports with a device attached (`COMx`, `/dev/ttyUSB0`, `/dev/ttyACM0`, …)
291- **LAN** printers on TCP port **9100** (raw ESC/POS), when enabled under **Settings → LAN network printers** (off by default). Discovery validates the previous LAN cache first, then scans the local subnet.
291
292
292Empty motherboard serial ports (common on Linux as `/dev/ttyS*`) are hidden. Use **Enter port or queue manually** if you need one of those.
293Empty motherboard serial ports (common on Linux as `/dev/ttyS*`) are hidden. Use **Enter port, queue, or LAN address manually** for those or for a known `192.168.x.x` / `host:9100`.
293
294
294**Linux serial:** join the `dialout` group.
295**Linux serial:** join the `dialout` group.
295
296
docs/PRINTING.md +16 −11
@@ -1,15 +1,15 @@
1 1 # Printing subsystem
2 2
3 Raw ESC/POS output to POS thermal printers via **USB printer-class**, **Windows spooler** (Windows), or **USB-serial**.
3 Raw ESC/POS output to POS thermal printers via **USB printer-class**, **Windows spooler** (Windows), **USB-serial**, or **LAN TCP 9100** (optional).
4 4
5 5 ---
6 6
7 7 ## Goals
8 8
9 1. Discover printers (USB-direct, Windows spooler, serial ports)
9 1. Discover printers (USB-direct, Windows spooler, serial ports, optional LAN TCP 9100)
10 10 2. Let the user pick a target in the print dialog
11 11 3. Generate ESC/POS bytes from the AST (after parameter substitution)
12 4. Write bytes to the chosen transport (serial baud is probed)
12 4. Write bytes to the chosen transport (serial baud is probed; LAN uses TCP)
13 13
14 14 ---
15 15
@@ -51,7 +51,7 @@ substitute_document()
51 51 EscPosEncoder::encode_document()
52 52 │
53 53 ▼
54 open_printer(target) # USB-direct | Win spooler | serial
54 open_printer(target) # USB-direct | Win spooler | serial | network TCP
55 55 │
56 56 ▼
57 57 print_bytes() → write_all + flush
@@ -71,16 +71,22 @@ pub trait PrinterTransport {
71 71 | USB-direct (`rusb`) | USB printer-class bulk OUT (`usb_direct.rs`) |
72 72 | Windows spooler | Raw jobs via Win32 spooler (`win_spool.rs`, Windows only) |
73 73 | `SerialTransport` | USB-serial / CDC ports via `serialport` |
74 | `NetworkTransport` | Raw ESC/POS over TCP (default port **9100**, `network.rs`) — not CUPS/IPP |
74 75 | `MockTransport` | Tests — records bytes in `written` vec |
75 76
76 77 ### Discovery
77 78
78 `list_printers()` returns, in order:
79 `list_local_printers()` returns, in order:
79 80
80 81 1. USB printer-class devices (`usb_direct`)
81 82 2. Windows spooler queues (Windows)
82 83 3. USB-serial ports only (`SerialPortType::UsbPort` — skips empty PCI/`ttyS*` ports common on Linux)
83 84
85 When **LAN printers** are enabled in Settings (`lan_printers_enabled`, default **off**), the print dialog additionally:
86
87 1. Validates the durable **LAN cache** (`lan_printer_cache` in config) with short TCP probes and shows hits immediately with local devices
88 2. Scans local IPv4 subnets for open TCP **9100** in the background, merges results, and updates the cache
89
84 90 ### Serial baud rates
85 91
86 92 `SerialTransport::open` tries, in order:
@@ -91,19 +97,19 @@ pub trait PrinterTransport {
91 97
92 98 | Field | Example |
93 99 |-------|---------|
94 | `id` | `serial:COM3`, `usb:04b8:0e15:…`, `spool:POS-58` |
100 | `id` | `serial:COM3`, `usb:04b8:0e15:…`, `spool:POS-58`, `net:192.168.1.50:9100` |
95 101 | `display_name` | Human-readable label |
96 | `target` | `Serial` / `UsbDirect` / `WinSpooler` |
102 | `target` | `Serial` / `UsbDirect` / `WinSpooler` / `Network` |
97 103
98 104 ---
99 105
100 106 ## Print dialog (UI)
101 107
102 108 - One field per unique `${Parameter}`.
103 - Printer list: USB printer-class, Windows spooler (Windows), and connected USB-serial devices (Refresh button). Empty motherboard serial ports are omitted; use manual entry for those.
109 - Printer list: USB printer-class, Windows spooler (Windows), connected USB-serial devices, and (if enabled) LAN TCP 9100 printers (Refresh button). Empty motherboard serial ports are omitted; use manual entry for those.
104 110 - **Print** sits next to **Refresh**; close the dialog with the window ✕.
105 111 - The printer list uses a fixed-height scroll area so long lists stay usable.
106 - Optional manual serial port / queue name.
112 - Optional manual serial port / queue name / LAN `host` or `host:9100`.
107 113 - While open, the main Design UI is disabled (including editor autocomplete).
108 114 - Errors shown inline (parse, open, write, barcode validation).
109 115
@@ -184,6 +190,5 @@ On Windows, spooler access uses Win32 APIs (`winreg` / system libs as needed). N
184 190
185 191 | Feature | Notes |
186 192 |---------|-------|
187 | Bluetooth SPP | After OS pairing |
188 | Network TCP 9100 | Future |
193 | Bluetooth SPP | After OS pairing; evaluate already-connected devices only |
189 194 | Printer status read | DLE EOT |
@@ -1,15 +1,15 @@
1# Printing subsystem
1# Printing subsystem
2
2
3Raw ESC/POS output to POS thermal printers via **USB printer-class**, **Windows spooler** (Windows), or **USB-serial**.
3Raw ESC/POS output to POS thermal printers via **USB printer-class**, **Windows spooler** (Windows), **USB-serial**, or **LAN TCP 9100** (optional).
4
4
5---
5---
6
6
7## Goals
7## Goals
8
8
91. Discover printers (USB-direct, Windows spooler, serial ports)
91. Discover printers (USB-direct, Windows spooler, serial ports, optional LAN TCP 9100)
102. Let the user pick a target in the print dialog
102. Let the user pick a target in the print dialog
113. Generate ESC/POS bytes from the AST (after parameter substitution)
113. Generate ESC/POS bytes from the AST (after parameter substitution)
124. Write bytes to the chosen transport (serial baud is probed)
124. Write bytes to the chosen transport (serial baud is probed; LAN uses TCP)
13
13
14---
14---
15
15
@@ -51,7 +51,7 @@ substitute_document()
51EscPosEncoder::encode_document()
51EscPosEncoder::encode_document()
52 │
52 │
53 ▼
53 ▼
54open_printer(target) # USB-direct | Win spooler | serial
54open_printer(target) # USB-direct | Win spooler | serial | network TCP
55 │
55 │
56 ▼
56 ▼
57print_bytes() → write_all + flush
57print_bytes() → write_all + flush
@@ -71,16 +71,22 @@ pub trait PrinterTransport {
71| USB-direct (`rusb`) | USB printer-class bulk OUT (`usb_direct.rs`) |
71| USB-direct (`rusb`) | USB printer-class bulk OUT (`usb_direct.rs`) |
72| Windows spooler | Raw jobs via Win32 spooler (`win_spool.rs`, Windows only) |
72| Windows spooler | Raw jobs via Win32 spooler (`win_spool.rs`, Windows only) |
73| `SerialTransport` | USB-serial / CDC ports via `serialport` |
73| `SerialTransport` | USB-serial / CDC ports via `serialport` |
74| `NetworkTransport` | Raw ESC/POS over TCP (default port **9100**, `network.rs`) — not CUPS/IPP |
74| `MockTransport` | Tests — records bytes in `written` vec |
75| `MockTransport` | Tests — records bytes in `written` vec |
75
76
76### Discovery
77### Discovery
77
78
78`list_printers()` returns, in order:
79`list_local_printers()` returns, in order:
79
80
801. USB printer-class devices (`usb_direct`)
811. USB printer-class devices (`usb_direct`)
812. Windows spooler queues (Windows)
822. Windows spooler queues (Windows)
823. USB-serial ports only (`SerialPortType::UsbPort` — skips empty PCI/`ttyS*` ports common on Linux)
833. USB-serial ports only (`SerialPortType::UsbPort` — skips empty PCI/`ttyS*` ports common on Linux)
83
84
85When **LAN printers** are enabled in Settings (`lan_printers_enabled`, default **off**), the print dialog additionally:
86
871. Validates the durable **LAN cache** (`lan_printer_cache` in config) with short TCP probes and shows hits immediately with local devices
882. Scans local IPv4 subnets for open TCP **9100** in the background, merges results, and updates the cache
89
84### Serial baud rates
90### Serial baud rates
85
91
86`SerialTransport::open` tries, in order:
92`SerialTransport::open` tries, in order:
@@ -91,19 +97,19 @@ pub trait PrinterTransport {
91
97
92| Field | Example |
98| Field | Example |
93|-------|---------|
99|-------|---------|
94| `id` | `serial:COM3`, `usb:04b8:0e15:…`, `spool:POS-58` |
100| `id` | `serial:COM3`, `usb:04b8:0e15:…`, `spool:POS-58`, `net:192.168.1.50:9100` |
95| `display_name` | Human-readable label |
101| `display_name` | Human-readable label |
96| `target` | `Serial` / `UsbDirect` / `WinSpooler` |
102| `target` | `Serial` / `UsbDirect` / `WinSpooler` / `Network` |
97
103
98---
104---
99
105
100## Print dialog (UI)
106## Print dialog (UI)
101
107
102- One field per unique `${Parameter}`.
108- One field per unique `${Parameter}`.
103- Printer list: USB printer-class, Windows spooler (Windows), and connected USB-serial devices (Refresh button). Empty motherboard serial ports are omitted; use manual entry for those.
109- Printer list: USB printer-class, Windows spooler (Windows), connected USB-serial devices, and (if enabled) LAN TCP 9100 printers (Refresh button). Empty motherboard serial ports are omitted; use manual entry for those.
104- **Print** sits next to **Refresh**; close the dialog with the window ✕.
110- **Print** sits next to **Refresh**; close the dialog with the window ✕.
105- The printer list uses a fixed-height scroll area so long lists stay usable.
111- The printer list uses a fixed-height scroll area so long lists stay usable.
106- Optional manual serial port / queue name.
112- Optional manual serial port / queue name / LAN `host` or `host:9100`.
107- While open, the main Design UI is disabled (including editor autocomplete).
113- While open, the main Design UI is disabled (including editor autocomplete).
108- Errors shown inline (parse, open, write, barcode validation).
114- Errors shown inline (parse, open, write, barcode validation).
109
115
@@ -184,6 +190,5 @@ On Windows, spooler access uses Win32 APIs (`winreg` / system libs as needed). N
184
190
185| Feature | Notes |
191| Feature | Notes |
186|---------|-------|
192|---------|-------|
187| Bluetooth SPP | After OS pairing |
193| Bluetooth SPP | After OS pairing; evaluate already-connected devices only |
188| Network TCP 9100 | Future |
189| Printer status read | DLE EOT |
194| Printer status read | DLE EOT |