Release 0.1.37 deployment prep

2026-09-06 17:30:30 -05:00
parent 4862e29f57
commit 7f66228b9e
19 changed files with 866 additions and 79 deletions
@@ -0,0 +1,77 @@
+# Classroom printing
+
+The package installs and enables CUPS, its client/filter stack, and Debian's
+compressed Foomatic PPD database. Chrome is configured to open the system
+print dialog, which shows the queues configured in CUPS.
+
+The target Ricoh Aficio MP C3502 supports PCL 5c and PCL 6 as standard;
+PostScript 3 is optional. Debian Trixie does not provide a model-specific
+C3502 PPD in the installed driver set, so the classroom helper uses Trixie's
+recommended generic color PCL 6/PCL XL driver. This works with the printer's
+standard language and does not require a vendor binary.
+
+## Configure the church color printer
+
+Give the helper the printer's IP address or DNS name:
+
+```
+sudo classroom-printer-setup 10.20.30.40
+```
+
+This creates or updates one queue named `Classroom_Color`, points it directly
+to `socket://10.20.30.40:9100`, enables it, accepts jobs, and makes it the
+system default. The printer's address is never stored in the package.
+
+An explicit URI is also accepted when deployment requires another supported
+transport:
+
+```
+sudo classroom-printer-setup ipp://10.20.30.40/ipp/print
+sudo classroom-printer-setup --no-default socket://10.20.30.40:9100
+```
+
+The command is idempotent: running it again updates the same queue. It does not
+contact the printer while configuring CUPS, and an unreachable printer only
+leaves jobs queued; it never affects boot.
+
+Automatic remote queue browsing is disabled. `cups-browsed` is stopped and
+disabled if another package installed it, so unrelated advertised label and
+check-in printers are not turned into local classroom queues.
+
+## Administration
+
+List the available Debian drivers, including the selected PCL path:
+
+```
+lpinfo -m
+lpinfo -m | grep -i -E 'Ricoh|PCL|PostScript|IPP Everywhere'
+```
+
+Show the classroom queue, its URI, and the system default:
+
+```
+lpstat -p Classroom_Color -v
+lpstat -d
+```
+
+Set the default manually:
+
+```
+sudo lpadmin -d Classroom_Color
+```
+
+Print CUPS's test page:
+
+```
+lp -d Classroom_Color /usr/share/cups/data/testprint
+```
+
+Inspect or cancel queued jobs:
+
+```
+lpstat -o Classroom_Color
+cancel -a Classroom_Color
+```
+
+The printer language choice is based on Ricoh's published
+[MP C3002/C3502 specifications](https://assets.ricoh-usa.com/j2jqn9lauv41/1CzJla6qwny2d9oBVHHlID/5bfa366a01cf82162ea24287f99c8af9/aficiompc3002.pdf).