A native Linux CUPS filter for the Ricoh SP 200 monochrome laser printer, reverse engineered from USB captures of the official Windows driver.

The printer has no official Linux driver and is absent from foo2zjs, OpenPrinting, HPLIP, and Gutenprint. This driver implements the complete print protocol from scratch.

Arch Linux

sudo pacman -S cups ghostscript jbigkit

Debian / Ubuntu

sudo apt install libcups2-dev libcupsimage2-dev libjbig-dev jbigkit-bin gcc ghostscript

Fedora / RHEL

sudo dnf install cups-devel cups-libs jbigkit-devel jbigkit-libs gcc ghostscript

macOS

brew install cups jbigkit
brew services start cups   # run Homebrew CUPS on port 631

Note: macOS System Integrity Protection (SIP) makes the system CUPS filter directory (/usr/libexec/cups/filter/) read-only even for root. Homebrew CUPS installs its own writable filter directory under $(brew --prefix)/libexec/cups/filter/ and runs a full CUPS daemon that replaces the system one on port 631.

# Build and install the filter + PPD
sudo make install

# Register the printer with CUPS (printer must be plugged in via USB)
sudo make register

# Test print
echo "Hello from Linux" | lpr -P Ricoh_SP_200_DDST

# To remove everything
sudo make uninstall

# Compile
gcc -O2 -o rastertoricohjbig rastertoricohjbig.c \
    $(cups-config --libs) -lcupsimage -ljbig

# Install filter and PPD
sudo install -m 755 rastertoricohjbig /usr/lib/cups/filter/rastertoricohjbig
sudo install -m 644 ricoh-sp200.ppd   /usr/share/ppd/cupsfilters/

# Register printer (printer must be plugged in via USB)
sudo lpadmin -p Ricoh_SP_200_DDST \
    -v "$(lpinfo -v | grep -i ricoh | awk '{print $2}' | head -1)" \
    -P /usr/share/ppd/cupsfilters/ricoh-sp200.ppd \
    -E

# Test print
echo "Hello from Linux" | lpr -P Ricoh_SP_200_DDST

BREW=$(brew --prefix)

# Compile (Homebrew provides cups and jbigkit headers/libs)
gcc -O2 -I$BREW/include -o rastertoricohjbig rastertoricohjbig.c \
    -L$BREW/lib -lcups -lcupsimage -ljbig

# Install filter and PPD
sudo install -m 755 rastertoricohjbig $BREW/libexec/cups/filter/rastertoricohjbig
sudo install -m 644 ricoh-sp200.ppd   /Library/Printers/PPDs/Contents/Resources/

# Register printer (printer must be plugged in via USB)
sudo lpadmin -p Ricoh_SP_200_DDST \
    -v "$(lpinfo -v | grep -i ricoh | awk '{print $2}' | head -1)" \
    -P /Library/Printers/PPDs/Contents/Resources/ricoh-sp200.ppd \
    -E

# Test print
echo "Hello from macOS" | lpr -P Ricoh_SP_200_DDST

The printer was passed through to a Windows VM via USB. On the Linux host, usbmon + Wireshark captured all USB bulk transfers while printing a test document.

# Wireshark filter used:
usb.transfer_type == 0x03 && usb.endpoint_address.direction == OUT

A single-page job produced two URB_BULK out packets (~65 KB and ~59 KB). A two-page job produced three packets, revealing that the Windows driver chunks the JBIG stream across as many USB bulk transfers as needed (each ≤ 65 508 bytes).

The first bytes of packet 1 decoded as ASCII:

ESC%-12345X@PJL
@PJL SET COMPRESS=JBIG
@PJL SET PAPERWIDTH=4961
@PJL SET IMAGELEN=65556

This immediately identified the protocol: PJL (Printer Job Language) wrapping JBIG1 (ITU-T T.82) compressed raster data. The initial hypothesis that the printer used HBPL2 (like other foo2zjs Ricoh printers) was wrong — a grep for HBPL found nothing in the stream.

The 20 bytes following the PJL header were initially assumed to be a proprietary Ricoh header. They turned out to be a standard JBIG1 BIE (Bi-level Image Entity) header:

A second capture was made printing a two-page document. Extracting all @PJL tokens from the concatenated USB stream revealed the complete page lifecycle:

[page 1 JBIG data — first chunk]
@PJL SET IMAGELEN=13451          ← second chunk of page 1 (driver splits large pages)
[13451 bytes — continuation of page 1 JBIG stream]
@PJL SET DOTCOUNT=1477935        ← black pixel count for page 1
@PJL SET PAGESTATUS=END          ← eject page 1
@PJL SET PAGESTATUS=START        ← begin page 2
@PJL SET COPIES=1
@PJL SET MEDIASOURCE=TRAY1
@PJL SET MEDIATYPE=PLAINRECYCLE
@PJL SET PAPER=A4                ← page 2 media settings (repeated every page)
@PJL SET PAPERWIDTH=4961
@PJL SET PAPERLENGTH=7016
@PJL SET RESOLUTION=600
@PJL SET IMAGELEN=65556          ← page 2 first chunk
[65556 bytes — page 2 JBIG data, first chunk]
@PJL SET IMAGELEN=10550          ← page 2 second chunk
[10550 bytes — page 2 JBIG continuation]
@PJL SET DOTCOUNT=1266291
@PJL SET PAGESTATUS=END          ← eject page 2
@PJL EOJ
ESC%-12345X

Key findings:

• PAGESTATUS=END is the page eject trigger. Without it the firmware treats every subsequent IMAGELEN as another chunk of the still-open page and never ejects.
• Each page may span multiple IMAGELEN chunks. The driver splits any JBIG stream that exceeds a USB bulk transfer into consecutive @PJL SET IMAGELEN blocks, all belonging to the same page. The Linux filter produces smaller JBIG streams (no chunking needed) but the firmware handles both.
• Every page except the first gets its own PAGESTATUS=START + full media header (COPIES, MEDIASOURCE, MEDIATYPE, PAPER, PAPERWIDTH, PAPERLENGTH, RESOLUTION) before its first IMAGELEN.
• DOTCOUNT reports the total black pixels for the page and is used by the printer for toner life estimation.

── Job header (once) ──────────────────────────────────────────────────────────
ESC%-12345X@PJL\r\n
@PJL SET TIMESTAMP=YYYY/MM/DD HH:MM:SS\r\n
@PJL SET FILENAME=...\r\n
@PJL SET COMPRESS=JBIG\r\n
@PJL SET USERNAME=...\r\n
@PJL SET COVER=OFF\r\n
@PJL SET HOLD=OFF\r\n
@PJL SET PAGESTATUS=START\r\n      ← covers page 1
@PJL SET COPIES=N\r\n
@PJL SET MEDIASOURCE=TRAY1\r\n
@PJL SET MEDIATYPE=PLAINRECYCLE\r\n

── Per-page block (repeat for every page) ─────────────────────────────────────
  [pages 2+ only:]
  @PJL SET PAGESTATUS=START\r\n
  @PJL SET COPIES=N\r\n
  @PJL SET MEDIASOURCE=TRAY1\r\n
  @PJL SET MEDIATYPE=PLAINRECYCLE\r\n

  @PJL SET PAPER=<A4|LETTER>\r\n
  @PJL SET PAPERWIDTH=<px>\r\n
  @PJL SET PAPERLENGTH=<px>\r\n
  @PJL SET RESOLUTION=600\r\n
  @PJL SET IMAGELEN=<N>\r\n
  <N bytes: JBIG1 BIE header + compressed raster>
  @PJL SET DOTCOUNT=<page_black_pixels>\r\n
  @PJL SET PAGESTATUS=END\r\n      ← triggers paper ejection

── End of job (once) ──────────────────────────────────────────────────────────
@PJL EOJ\r\n
ESC%-12345X\r\n

The filter (rastertoricohjbig.c) uses:

• libcups / libcupsimage — reads the CUPS raster stream from stdin
• libjbig (jbigkit 2.1) — encodes each page as a JBIG1 BIE
• The encoded BIE is buffered in memory, its size measured, then emitted to stdout preceded by @PJL SET IMAGELEN=N

The PPD declares *cupsBitsPerColor: 1 and *cupsColorSpace: 3 so CUPS delivers a 1-bit packed K-channel bitmap directly — no conversion needed in the normal path.

Bug 1 — Missing bare @PJL\r\n after UEL The Windows driver emits ESC%-12345X@PJL\r\n before the first SET command. Without the bare @PJL\r\n line the printer silently discards the entire job.

Bug 2 — Missing @PJL SET PAPERLENGTH The printer requires both PAPERWIDTH and PAPERLENGTH. Without PAPERLENGTH the printer initialises its engine (noise + LED blink) but never pulls the page.

Bug 3 — Wrong JBIG BIE options byte jbigkit 2.1 stores the options argument to jbg_enc_options() directly into BIE byte 19 with no bit translation. The Windows driver produces byte 19 = 0x48. Passing 0x08 caused the printer to accept the job, warm up, and then refuse to feed the page. Passing 0x48 fixed it.

Bug 4 — PPD lacked raster format directives Without *cupsBitsPerColor: 1, *cupsColorSpace: 3, and related PPD keys, CUPS delivered 8-bit grayscale to the filter. The stride was calculated as (w+7)/8 (1-bit assumption) but the actual data was 8× wider, producing a malformed JBIG stream.

Bug 5 — Multi-page: only first page printed Discovered by capturing a two-page job from the Windows driver. The firmware uses @PJL SET PAGESTATUS=END as the page eject trigger — not the arrival of the next IMAGELEN. Without PAGESTATUS=END after each page's JBIG data, every subsequent IMAGELEN block was treated as another chunk of the same open page. The printer accumulated all pages' data as one giant page 1 and never ejected it. Three additional omissions were found in the same capture:

• PAGESTATUS=START + full media header (COPIES, MEDIASOURCE, MEDIATYPE, PAPER, PAPERWIDTH, PAPERLENGTH, RESOLUTION) must precede each page except the first.
• DOTCOUNT (black pixel count) must be emitted per page, immediately before PAGESTATUS=END.
• cupsBytesPerLine from the CUPS raster header must be used as the row stride when reading pixel data — a manual (bpp*w+7)/8 calculation can diverge from CUPS's actual row size, misaligning the stream and causing cupsRasterReadHeader2 to fail on page 2.

The CUPS filter runs only on Linux or macOS — it cannot run on Android or other devices directly. Instead, share the printer from the Linux machine over IPP. Android (4.4+) supports IPP natively and requires no extra app.

Edit /etc/cups/cupsd.conf:

# Change:
Listen localhost:631
# To:
Port 631

# Also add:
ServerAlias *

Add Allow @LOCAL to the relevant <Location> blocks:

<Location />
  Order allow,deny
  Allow @LOCAL
</Location>

<Location /admin>
  Order allow,deny
  Allow @LOCAL
</Location>

<Location /printers>
  Order allow,deny
  Allow @LOCAL
</Location>

sudo systemctl restart cups
sudo lpadmin -p Ricoh_SP_200_DDST -o printer-is-shared=true
sudo cupsctl --share-printers

# ufw
sudo ufw allow 631/tcp

# firewalld
sudo firewall-cmd --permanent --add-service=ipp && sudo firewall-cmd --reload

1. Settings → Connected devices → Printing → Default Print Service
2. The printer should auto-discover as Ricoh_SP_200_DDST.
3. If not, tap Add printer and enter the IPP URL manually:

   ipp://<linux-machine-ip>:631/printers/Ricoh_SP_200_DDST
   

Both devices must be on the same local network. Android sends a standard IPP job to CUPS, which runs it through the rastertoricohjbig filter and forwards the PJL+JBIG1 stream to the printer via USB — identical to printing from the Linux machine directly.

Printer not found by lpinfo -v

lsusb | grep -i ricoh

Filter not invoked (job disappears silently)

ls -la /usr/lib/cups/filter/rastertoricohjbig
# Must be: -rwxr-xr-x root root
sudo chmod 755 /usr/lib/cups/filter/rastertoricohjbig
sudo chown root:root /usr/lib/cups/filter/rastertoricohjbig

CUPS shows printer stopped

sudo cupsenable Ricoh_SP_200_DDST
sudo cupsaccept Ricoh_SP_200_DDST

Check CUPS error log

sudo tail -40 /var/log/cups/error_log

Build fails — missing jbig.h

# Arch:   sudo pacman -S jbigkit
# Debian: sudo apt install libjbig-dev
# Fedora: sudo dnf install jbigkit-devel
# macOS:  brew install jbigkit

macOS: filter installs but printer not found by CUPS

# Ensure Homebrew CUPS is running (not the system daemon)
brew services restart cups
lpinfo -v | grep -i ricoh

Reverse engineered May 2026. No proprietary code used or distributed. Protocol wire format documentation is not subject to copyright.