# 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).