在天嵌 TQ3568 (Debian) 上配置并添加打印机教程

在嵌入式开发中，有时需要直接在开发板上接 USB 打印机或网络打印机。本文记录了在 天嵌 TQ3568 开发板 (Debian 系统) 上使用 CUPS 配置打印机的完整流程，以及常见问题的解决办法。

---

1. 基础环境确认

1. 确认系统为 Debian：

   lsb_release -a
   

2. 确认打印机接口：

   • USB 打印机

   • 网络打印机 (IPP/Socket)

   • 串口打印机

3. 确认打印机被识别：

   lsusb
   dmesg | grep usb
   lpinfo -v
   

   如果是 USB 打印机，通常会出现 /dev/usb/lp0。

---

2. 安装 CUPS

CUPS (Common Unix Printing System) 是 Linux 下常用的打印系统。

sudo apt-get update
sudo apt-get install cups cups-client

安装完成后，启动并设置开机自启：

sudo systemctl enable cups
sudo systemctl start cups

---

3. 解决“无法添加打印机”问题

默认情况下，只有 root 和 lpadmin 组用户才能在 CUPS Web 界面添加打印机。
在 TQ3568 上通常使用 linaro 用户，因此需要赋予权限。

① 将 linaro 加入 lpadmin 组

sudo usermod -aG lpadmin linaro

退出并重新登录 linaro（或重启）。

② 修改 CUPS 配置 (可选)

编辑配置文件：

sudo nano /etc/cups/cupsd.conf

找到：

<Location /admin>AuthType DefaultRequire user @SYSTEMOrder allow,denyAllow all
</Location>

如果只允许 linaro 管理，可以改成：

Require user @SYSTEM linaro

保存后重启服务：

sudo systemctl restart cups

---

4. Web 界面管理

在浏览器访问：

http://localhost:631

登录 linaro 用户（此时已经有权限），即可点击 [管理] → [添加打印机] 来进行配置。

---

5. 添加打印机示例

USB 打印机

lpadmin -p MyUSBPrinter -E -v usb://HP/DeskJet_2130?serial=xxxx -m everywhere

网络打印机 (IPP)

lpadmin -p NetPrinter -E -v ipp://192.168.1.100/ipp/print -m everywhere

设置默认打印机：

lpoptions -d MyUSBPrinter

测试打印：

echo "Hello from TQ3568" | lp

---

6. 常见问题排查

1. CUPS Web 页面打不开
   检查 /etc/cups/cupsd.conf 中是否启用了：

   WebInterface Yes
   Listen *:631
   

2. USB 打印机未识别
   确认内核加载了 usblp 模块：

   lsmod | grep usblp
   

   如果没有：

   sudo modprobe usblp
   

3. 普通用户权限不足
   确认用户在 lpadmin 组：

   groups linaro
   

---

7. 总结

在 TQ3568 (Debian) 上配置打印机的关键点是：

• 安装并启用 CUPS 服务

• 把使用的账户（如 linaro）加入 lpadmin 组

• 确认内核驱动 usblp 已启用（USB 打印机）

• 使用 http://localhost:631 Web 界面或 lpadmin 命令行添加打印机