嵌入式Linux打印方案：在I.MX8MP平台移植适配CUPS的完整实践

1. 项目概述与核心价值

最近在基于NXP的I.MX8MP平台开发一个工业级HMI设备，其中一个核心需求是集成打印功能，需要直接驱动USB接口的热敏票据打印机。市面上常见的嵌入式Linux打印方案，如直接调用lpr命令或使用厂商提供的闭源SDK，要么灵活性太差，要么存在许可和兼容性问题。经过一番调研和踩坑，最终选择了在I.MX8MP上移植和适配CUPS的方案。CUPS作为类Unix系统上事实标准的打印系统，其模块化设计、广泛的驱动支持以及网络打印能力，为嵌入式设备提供了强大而灵活的打印解决方案。

这个适配过程，远不止是“编译一个软件包然后运行”那么简单。它涉及到交叉编译工具链的配置、依赖库的裁剪、系统服务的集成、权限管理以及针对特定硬件的性能调优。如果你也在为ARM架构的嵌入式Linux设备寻找一个稳定、可靠且功能丰富的打印方案，那么这次在I.MX8MP上适配CUPS的完整实践，或许能为你提供一条清晰的路径。无论是用于零售终端、自助服务设备还是工业控制面板，这套方案都能让你对打印任务拥有从底层驱动到上层管理的完全控制权。

2. 整体方案设计与环境准备

2.1 为什么选择CUPS？

在嵌入式领域，打印功能的实现通常有几个选择：一是使用打印机厂商提供的、针对特定平台的二进制库，但往往限制多、更新慢且可能收费；二是使用最简单的cat命令将打印文件直接发送到/dev/usb/lp0这类设备节点，但这只适用于纯文本或特定格式，无法处理图形、排版和任务队列；三是集成一个完整的打印系统，CUPS正是此类中的佼佼者。

CUPS的优势在于其客户端-服务器架构和PPD驱动模型。服务器后台（cupsd）管理所有打印队列、处理任务过滤（将各种格式如PDF、图像转换为打印机可识别的光栅数据），并通过各种后端（如USB、并行口、网络、IPP）与物理打印机通信。对于I.MX8MP这样的设备，我们可以将其配置为一个独立的打印服务器，不仅可以连接本地USB打印机，未来还能轻松扩展为网络打印服务器。此外，CUPS支持标准的IPP协议，使得从移动设备或其他系统向其提交打印任务成为可能，极大地增强了设备的互联能力。

2.2 开发环境搭建与交叉编译工具链

我们的目标是在x86_64的Ubuntu开发主机上，为ARM64架构的I.MX8MP目标板交叉编译CUPS及其依赖。NXP官方为I.MX8MP提供了Yocto Project构建框架，但为了更精细地控制编译选项和依赖版本，我选择了手动配置交叉编译环境。

首先，需要确认并获取正确的工具链。I.MX8MP采用Cortex-A53/A72核心，属于ARMv8-A架构，应使用aarch64-linux-gnu-工具链。可以从Linaro或ARM官方获取，但最稳妥的是使用NXP官方SDK里提供的工具链，因为它包含了针对该芯片的特定优化和库。

# 假设工具链已解压至 /opt/fsl-imx-xwayland/6.1-langdale/sysroots/x86_64-pokysdk-linux/usr/bin/aarch64-poky-linux/ export CROSS_COMPILE=/opt/fsl-imx-xwayland/6.1-langdale/sysroots/x86_64-pokysdk-linux/usr/bin/aarch64-poky-linux/aarch64-poky-linux- export CC="${CROSS_COMPILE}gcc --sysroot=/opt/fsl-imx-xwayland/6.1-langdale/sysroots/aarch64-poky-linux" export CXX="${CROSS_COMPILE}g++ --sysroot=/opt/fsl-imx-xwayland/6.1-langdale/sysroots/aarch64-poky-linux" export AR="${CROSS_COMPILE}ar" export LD="${CROSS_COMPILE}ld"

注意：--sysroot参数至关重要。它指定了目标板的根文件系统路径，编译器会从这里查找头文件和库。你需要确保这个sysroot目录包含了目标板运行时所需的基本库，如glibc、zlib、libpng等。通常可以从Yocto构建的镜像中提取，或使用NXP SDK中提供的sysroot。

接下来是准备CUPS的源代码和其依赖库。CUPS 2.x版本对依赖的要求相对明确，主要需要：

1. Zlib: 用于压缩数据。
2. LibPNG: 用于处理PNG图像，很多打印任务会涉及。
3. OpenSSL或GnuTLS: 用于支持加密通信（如HTTPS的IPP）。在资源受限的嵌入式环境，如果不需要网络加密，可以禁用TLS支持以减小体积。
4. PAM: 用于用户认证。嵌入式设备通常不需要复杂的用户管理，可以禁用。
5. Avahi: 用于mDNS/DNS-SD服务发现（即Bonjour打印）。非必需，可禁用。

我们的策略是：先交叉编译这些依赖库，安装到工具链的sysroot中，然后再编译CUPS。

2.3 依赖库的交叉编译与裁剪

以zlib和libpng为例，展示如何为嵌入式环境进行交叉编译。

编译Zlib:Zlib的编译系统比较传统，需要通过环境变量指定编译器。

wget https://zlib.net/zlib-1.3.1.tar.gz tar -xzf zlib-1.3.1.tar.gz cd zlib-1.3.1 # 配置为静态库，减小运行时依赖 ./configure --prefix=$SYSROOT/usr --static make CC=$CC sudo make install

这里将库安装到了sysroot的/usr目录下，这样后续CUPS编译时就能自动找到它们。

编译LibPNG:LibPNG依赖Zlib，所以需要先确保Zlib已正确安装。

wget https://download.sourceforge.net/libpng/libpng-1.6.43.tar.gz tar -xzf libpng-1.6.43.tar.gz cd libpng-1.6.43 # 指定交叉编译器和zlib的路径 ./configure --host=aarch64-poky-linux \ --prefix=$SYSROOT/usr \ CPPFLAGS="-I$SYSROOT/usr/include" \ LDFLAGS="-L$SYSROOT/usr/lib" make sudo make install

对于其他库如OpenSSL，过程类似，但配置选项更复杂。关键在于--host参数，它告诉configure脚本我们要为目标平台（aarch64-poky-linux）进行编译。CPPFLAGS和LDFLAGS则确保编译器能找到已安装到sysroot中的头文件和库。

实操心得：在交叉编译依赖库时，务必遵循依赖顺序。一个常见的依赖链是：zlib->libpng->cups。如果顺序错了，编译会报找不到库的错误。建议写一个简单的脚本，按顺序自动化执行各个库的编译和安装。

3. CUPS的交叉编译与配置

3.1 编译配置与关键选项解析

准备好依赖后，就可以开始编译CUPS了。从CUPS官网下载稳定版本源代码（如2.4.7）。

wget https://github.com/OpenPrinting/cups/releases/download/v2.4.7/cups-2.4.7-source.tar.gz tar -xzf cups-2.4.7-source.tar.gz cd cups-2.4.7

CUPS使用自己的构建系统，但提供了熟悉的configure脚本。针对嵌入式环境，我们需要传递大量参数来启用或禁用功能，以平衡功能与体积。

./configure --host=aarch64-poky-linux \ --prefix=/usr \ --sysconfdir=/etc \ --localstatedir=/var \ --with-optim="-Os" \ --disable-shared \ --enable-static \ --disable-gssapi \ --disable-avahi \ --disable-dnssd \ --disable-pam \ --disable-systemd \ --without-java \ --without-perl \ --without-python \ --without-php \ --without-tiff \ --disable-libusb \ --enable-libpaper \ --with-cups-user=lp \ --with-cups-group=lp \ --with-system-groups=lpadmin \ CPPFLAGS="-I$SYSROOT/usr/include" \ LDFLAGS="-L$SYSROOT/usr/lib -Wl,-rpath-link,$SYSROOT/usr/lib"

下面对关键配置选项进行解读：

• --host=aarch64-poky-linux: 指定目标平台。
• --prefix=/usr: 指定安装路径。注意这里指的是目标板上的路径，不是主机路径。编译产生的二进制文件会“认为”自己将被安装到目标板的/usr目录下。
• --disable-shared --enable-static: 强制链接静态库。这会将zlib、libpng等依赖直接打包进CUPS的可执行文件中，生成一个独立的、不依赖外部动态库的cupsd，极大地简化了部署，避免了目标板上库版本不匹配的问题。代价是二进制文件体积会增大。
• --disable-avahi --disable-dnssd --disable-pam --disable-systemd: 禁用嵌入式环境中通常不需要的复杂服务发现、用户认证和系统集成功能。
• --without-java --without-perl ...: 禁用各种脚本语言绑定，减少依赖和体积。
• --with-cups-user/group=lp: 指定CUPS服务运行时使用的用户和组。lp是类Unix系统上传统的打印服务用户。
• CPPFLAGS和LDFLAGS: 再次确保编译器能找到依赖库。-Wl,-rpath-link在链接阶段帮助解析动态库依赖（即使我们用了静态编译，部分系统库可能还是动态的）。

执行make进行编译。如果一切顺利，你将在当前目录下得到针对ARM64架构编译的CUPS可执行文件、库和配置文件。

3.2 文件系统集成与部署策略

编译完成后，我们需要将必要的文件部署到I.MX8MP的目标板根文件系统中。通常有两种方式：

1. 直接安装到sysroot：运行make install DESTDIR=/path/to/rootfs。这会将所有文件（二进制、库、配置文件、数据文件）复制到目标根文件系统的相应位置（如/usr/sbin/cupsd,/etc/cups/,/usr/share/cups/）。
2. 手动挑选文件：对于深度裁剪的嵌入式系统，我们可能只需要最核心的几个文件。至少需要以下内容：
   • /usr/sbin/cupsd: 主服务进程。
   • /usr/lib/cups/目录下的相关过滤器（filter）和后端（backend）。特别是backend/usb（用于USB打印机）和filter目录下的pdftops、imagetops、rastertoxxx等，这取决于你的打印机语言。例如，对于支持PCL或PostScript的打印机，需要对应的rastertopcl或rastertops过滤器。
   • /etc/cups/目录下的配置文件，主要是cupsd.conf和cups-files.conf。
   • /usr/share/cups/目录下的数据文件，如PPD驱动文件（如果需要）。

我推荐使用第一种方式安装到sysroot，然后使用rsync或通过构建系统（如Yocto的do_install任务）将整个sysroot中的变更同步到最终的根文件系统镜像里。这样可以确保文件路径和权限的正确性。

注意事项：静态编译的cupsd虽然部署简单，但体积可能达到几MB。如果存储空间极其紧张，可以考虑只对核心的cupsd进行静态链接，而过滤器使用动态链接。但这会显著增加部署的复杂性，需要确保目标板上有正确版本的libcups等库。对于I.MX8MP这类通常配备数百MB甚至GB级存储的芯片，静态编译是更稳妥的选择。

4. 目标板配置与CUPS服务启动

4.1 系统配置与权限设置

将包含CUPS的文件系统镜像烧录到I.MX8MP开发板并启动后，需要进行一系列配置。

首先，确保存在CUPS运行时所需的用户和组。通常这些已经在根文件系统的/etc/passwd和/etc/group中定义好了（用户lp，组lp和lpadmin）。如果没有，需要手动添加：

# 在目标板上执行 echo "lp:x:7:7:lp:/var/spool/lpd:/sbin/nologin" >> /etc/passwd echo "lp:x:7:" >> /etc/group echo "lpadmin:x:106:" >> /etc/group

其次，创建CUPS运行所需的目录并设置正确的权限：

mkdir -p /var/spool/cups /var/log/cups /var/cache/cups /var/run/cups chown -R lp:lp /var/spool/cups /var/log/cups /var/cache/cups /var/run/cups chmod 755 /var/spool/cups

4.2 关键配置文件cupsd.conf的适配

/etc/cups/cupsd.conf是CUPS服务器的核心配置文件。对于嵌入式设备，我们需要对其进行大幅精简和针对性修改。以下是一个最小化且可用的配置示例：

# 基础设置 LogLevel warn MaxLogSize 0 # 不限制日志大小，或设置为一个较小的值如1m SystemGroup lpadmin User lp Group lp # 只监听本地端口，嵌入式设备通常不需要远程管理 Listen localhost:631 Listen /var/run/cups/cups.sock # 禁止所有来自外部的访问，只允许本地 <Location /> Order allow,deny Allow localhost </Location> # 管理页面也仅限本地访问 <Location /admin> Order allow,deny Allow localhost </Location> # 打印机的状态和作业信息 <Location /printers> Order allow,deny Allow localhost </Location> # 服务器身份信息，可自定义 ServerName I.MX8MP-Printer-Server ServerAdmin root@localhost # 工作目录和缓存 StateDir /var/run/cups CacheDir /var/cache/cups RequestRoot /var/spool/cups TempDir /var/spool/cups/tmp # 数据目录 DataDir /usr/share/cups DocumentRoot /usr/share/cups/doc-root # 允许的加密类型（如果编译时支持TLS） # DefaultEncryption Never # 打印机共享策略（通常不共享） Browsing Off DefaultShared No

这个配置的关键点在于：

1. 安全收紧：只监听localhost:631和本地socket，所有<Location>都只允许localhost访问。这符合嵌入式设备作为独立打印服务器的定位，避免了不必要的网络暴露。
2. 路径正确：确保StateDir、CacheDir等路径与目标板上实际创建的目录一致。
3. 功能精简：关闭了浏览（Browsing Off）和共享（DefaultShared No），因为这些功能在单机单打印机的场景下不需要。

4.3 服务启动与自启动集成

在目标板上，可以直接运行/usr/sbin/cupsd来启动服务。为了调试，首次可以在前台运行并打开调试日志：

/usr/sbin/cupsd -f -l debug

-f表示在前台运行，-l debug会输出详细的调试信息，方便查看启动过程和服务状态。

确认服务能正常启动并监听端口后，需要配置系统开机自启动。根据目标板使用的初始化系统（通常是systemd或busybox init）进行配置。

对于systemd系统，创建一个服务单元文件/etc/systemd/system/cups.service：

[Unit] Description=CUPS Print Service After=network.target local-fs.target [Service] Type=simple ExecStart=/usr/sbin/cupsd -l info ExecReload=/bin/kill -HUP $MAINPID Restart=on-failure User=lp Group=lp [Install] WantedBy=multi-user.target

然后执行：

systemctl daemon-reload systemctl enable cups.service systemctl start cups.service

对于BusyBox init系统，通常在/etc/init.d/下创建启动脚本，并在相应的运行级别（如rcS）中添加链接。

5. 打印机添加、驱动配置与测试

5.1 连接USB打印机与后端识别

将USB热敏打印机连接到I.MX8MP开发板的USB接口。系统内核需要已启用USB打印机驱动（CONFIG_USB_PRINTER）。连接后，使用lsusb命令查看是否识别到打印机设备，并使用dmesg查看内核日志，确认是否生成了/dev/usb/lp0或类似的设备节点。

CUPS通过“后端”与打印机通信。USB后端程序是/usr/lib/cups/backend/usb。你可以手动测试这个后端是否能发现打印机：

/usr/lib/cups/backend/usb

如果一切正常，它会输出类似direct usb://Brand/Model?serial=XXXX "Brand Model" "USB Printer"的信息，其中包含了打印机的URI。

5.2 使用lpadmin命令添加打印机

CUPS提供了命令行工具lpadmin来管理打印机。我们通过它来添加一个打印队列。

假设我们从后端探测到的打印机URI是usb://Brand/Model?serial=12345，并且我们有一个对应的PPD驱动文件thermal-printer.ppd。

1. 准备PPD文件：PPD文件描述了打印机的功能（如分辨率、纸张尺寸、支持的命令集）。对于许多通用热敏打印机，可以使用drv:///sample.drv/generic.ppd这个通用驱动。但对于特定型号，最好从厂商获取或从OpenPrinting数据库查找。将PPD文件放入/usr/share/cups/model/目录，或任何在cupsd.conf中DataDir指定的路径下。

2. 执行添加命令：

   lpadmin -p Thermal_Printer -E -v usb://Brand/Model?serial=12345 -m thermal-printer.ppd

   • -p Thermal_Printer: 指定打印机队列的名称为Thermal_Printer。
   • -E: 在添加后立即启用打印机和打印队列。
   • -v URI: 指定打印机的设备URI。
   • -m PPD: 指定PPD驱动文件的路径。如果文件在标准模型目录下，可以直接写文件名。

3. 设置默认打印机：

   lpadmin -d Thermal_Printer

5.3 打印测试与任务管理

添加完成后，可以使用lpstat命令查看打印机状态：

lpstat -p -d

输出应显示Thermal_Printer打印机是空闲且启用的，并且是默认打印机。

现在进行一个简单的打印测试。CUPS提供lp命令提交打印任务。

# 打印一个文本文件 echo "Hello, I.MX8MP CUPS!" > test.txt lp test.txt # 或者直接打印字符串 echo "Test Page" | lp

使用lpq命令可以查看打印队列中的任务：

lpq

如果需要取消一个任务，先用lpq找到任务ID，然后用cancel命令：

cancel <job-id>

5.4 高级配置：使用脚本与自定义过滤器

对于嵌入式应用，我们通常不是直接让用户调用lp命令，而是在应用程序中生成要打印的内容（如图片、HTML表格、PDF），然后调用打印系统。

一种灵活的方式是编写一个shell脚本或C程序，将数据通过管道传递给lp命令。例如，打印一张PNG图片：

cat receipt.png | lp -o media=Custom.80x300mm -o fit-to-page

这里的-o选项用于指定打印选项，它们来自PPD文件中的定义。media指定纸张尺寸，fit-to-page让图像适应页面。

如果打印机使用特殊的命令语言（例如ESC/POS），而CUPS没有现成的完美过滤器，你可能需要编写自定义过滤器。CUPS的过滤系统是一个管道链，数据从一种格式经过多个过滤器转换为最终打印机可接受的格式。自定义过滤器通常是一个可执行程序（如shell脚本、C程序），放在/usr/lib/cups/filter/目录下，并在PPD文件中通过cupsFilter指令指定。这是一个相对高级的话题，需要对CUPS的MIME类型系统和过滤链有深入理解。

6. 常见问题排查与性能优化

6.1 启动与连接问题排查表

6.2 性能优化与资源管理

在资源受限的嵌入式设备上运行CUPS，需要考虑其内存和CPU占用。

1. 日志管理：生产环境中，将cupsd.conf中的LogLevel从debug改为warn或error，并设置合理的MaxLogSize（例如1m），定期轮转或清理/var/log/cups/下的日志文件，防止日志占满存储空间。

2. 并发连接与进程：在cupsd.conf中，可以通过MaxClients、MaxClientsPerHost和MaxJobsPerPrinter等参数限制并发处理的任务数，防止大量打印请求拖垮系统。

3. 过滤器优化：图像和PDF转换过滤器（如pdftops）可能比较耗资源。如果打印内容固定，可以考虑在应用层预先将内容转换为打印机直接支持的格式（如直接生成PCL或光栅数据），然后通过lp -o raw直接发送，绕过CUPS的过滤链，这能显著降低CPU负载和打印延迟。

4. 使用raw队列：对于只需要打印简单文本或已预处理数据的场景，在添加打印机时使用-m raw，这告诉CUPS不要进行任何格式转换，直接将接收到的数据发送给打印机。这是最高效的模式。

   lpadmin -p Raw_Printer -E -v usb://... -m raw

6.3 稳定性增强实践

1. 看门狗机制：在系统层面，可以编写一个简单的监控脚本，定期检查cupsd进程是否存在，以及cupsd是否在监听631端口。如果服务挂掉，脚本自动重启它。可以将此脚本加入crontab或由systemd watchdog管理。

2. USB热插拔处理：工业环境中打印机可能被频繁插拔。需要确保当打印机断开重连后，CUPS能继续工作。这依赖于USB后端和udev规则的配合。一个健壮的方案是：在udev规则中，当检测到打印机设备出现时，触发一个脚本，该脚本使用lpadmin命令重新启用或修改对应的打印机队列URI。更简单的做法是，在应用程序中捕获打印失败错误，并尝试重新初始化打印队列。

3. 存储保护：/var/spool/cups目录用于假脱机打印任务。确保该目录所在的分区有足够空间。可以考虑将其挂载到具有更大空间或更耐用的存储介质上（如/tmp可能是内存文件系统，不适合）。在cupsd.conf中，可以通过TempDir指定一个非易失性存储的临时目录。

经过以上步骤，一个在I.MX8MP上稳定运行的CUPS打印服务器就搭建完成了。从交叉编译的繁琐到系统集成的细节，每一步都需要耐心调试。最终，当你看到热敏打印机顺畅地吐出“Hello, I.MX8MP CUPS!”的纸条时，这种对复杂开源软件在嵌入式设备上实现深度定制的成就感，是使用现成方案无法比拟的。这套方案不仅解决了当前的打印需求，其模块化和标准化也为未来连接更多类型的打印机或实现网络打印功能预留了清晰、可靠的扩展接口。