hp1010-airprint-cups:基于 CUPS 的 HP LaserJet 1010 AirPrint 共享项目

hp1010-airprint-cups

Branch1Tags0
FilesLast commitLast update
5 months ago
5 months ago
5 months ago
5 months ago
5 months ago
5 months ago

HP LaserJet 1010 AirPrint 配置

概述

在 Ubuntu 22.04 上通过 CUPS 将 HP LaserJet 1010(USB 连接)共享为 AirPrint 打印机。

核心架构

iPhone/iPad (AirPrint)
     │ PDF via IPP (port 631)
     ▼
CUPS 2.4.1 (Avahi mDNS 广播)
     │
     ├─ pdftopdf       (PDF 预处理)
     ├─ gstoraster     (PDF → CUPS raster)
     ├─ rastertohp     (CUPS raster → PCL 4/5)
     └─ usb backend    (USB 发送)
     │
     ▼
HP LaserJet 1010 (原生支持 PCL 4/5)

关键发现

驱动 结果 原因
PCL 4/5 (laserjet.ppd) ✅ 正常工作 HP 1010 原生支持 PCL 4/5
PCL 6 / PCL XL (pxlmono) ❌ Unsupported personality 1010 不认 PCL XL
ZjStream (foo2zjs) ❌ 乱码/一直出纸 固件下载服务已停服
Raw socket ✅ 简单的 PCL 转义序列 基本指令集

文件说明

文件 说明
setup.sh 一键配置脚本
cupsd.conf CUPS 配置文件
ppd/HP_LaserJet_1010.ppd PCL 4/5 驱动 PPD
printers.conf 打印机配置参考
ssl/gen_cert.sh SSL 证书生成脚本

快速安装

sudo apt-get update
sudo apt-get install -y cups cups-client cups-filters avahi-daemon avahi-utils

# 复制配置
sudo cp cupsd.conf /etc/cups/cupsd.conf
sudo cp ppd/HP_LaserJet_1010.ppd /etc/cups/ppd/

# 生成 SSL 证书
sudo bash ssl/gen_cert.sh

# 设置打印机
sudo lpadmin -p HP_LaserJet_1010 \
  -E \
  -v "usb://HP/LaserJet%201010?serial=00CNFG803610" \
  -m "drv:///sample.drv/laserjet.ppd" \
  -o printer-is-shared=true \
  -o PageSize=A4 \
  -o Resolution=300dpi

sudo cupsenable HP_LaserJet_1010
sudo cupsaccept HP_LaserJet_1010
sudo systemctl restart cups

验证

# 检查打印机状态
lpstat -t

# 检查 mDNS 广播(应看到 AirPrint TXT 记录)
avahi-browse -rt _ipp._tcp | grep -A 20 "HP_LaserJet"

# 测试打印
lp -d HP_LaserJet_1010 /path/to/test.pdf

故障排查

  • iPhone 搜索不到打印机: 检查 Avahi 运行状态 systemctl status avahi-daemon
  • iPhone 能搜索到但打印失败: 查看 CUPS 日志 sudo tail -f /var/log/cups/error_log
  • "Unsupported personality": 说明用了 PCL XL 驱动,切换到 PCL 4/5
  • 乱码/一直出纸: 用了不支持的驱动格式,切换到 PCL 4/5

Introduction

hp1010-airprint-cups

Customize your domain