为什么值得关注

它通过重建 Canon 的持久 USB 守护进程架构解决了长期存在的“第 5 个作业引擎卡死”错误，并包含针对 CUPS 竞态条件和 USB 后端挂起的自动补丁。

适合谁使用

拥有 Canon LBP2900/LBP2900B 的 Ubuntu 和 Linux Mint 用户
在 Linux 网络上管理老旧打印机的系统管理员
想要在 Windows 和 Linux 机器之间共享 USB 打印机的家庭用户
需要可靠脚本化打印机安装的开发者或高级用户

典型使用场景

通过一条命令安装打印机驱动（开源或官方 Canon）
通过 CUPS 后端补丁修复复杂打印作业导致的打印机挂起
网络共享打印机，使 Windows 和其他 Linux 客户端无需驱动程序即可打印
通过软件 USB 重置从打印机通信故障中恢复

项目优势

单个 bash 脚本，带有交互式菜单并自动处理依赖关系
通过模拟 Canon 的守护进程架构永久修复关键的第 5 个作业引擎卡死问题
同时支持维护良好的开源驱动和官方 Canon 驱动，并自动处理互斥冲突
包含回滚功能、调试日志和 Windows 客户端脚本，实现无缝多操作系统共享

使用前须知

仅官方支持 Canon LBP2900/LBP2900B（USB ID 硬编码）
需要 root/sudo 权限并保持与 Ubuntu/Mint 软件仓库的网络连接（仅减少 GitHub 依赖，不能完全离线）
脚本为 Ubuntu noble 24.04 或 Linux Mint 设计，其他发行版未经测试

README 快速开始

🖨️ Canon LBP2900 CAPT Toolkit — LBP2900 / LBP2900B trên Ubuntu & Linux Mint

Repo: github.com/brucenguyen1102/Canon-LBP2900-CAPT-Toolkit

Bộ công cụ tự động cài đặt, sửa lỗi và chia sẻ máy in Canon LBP2900/2900B (giao thức CAPT độc quyền) trên các bản Linux hiện đại — dùng driver mã nguồn mở thay thế thay vì driver Canon chính hãng đã cũ và khó cài.

Toàn bộ thao tác được gói gọn trong một script bash duy nhất, có menu tương tác, tự backup trước khi sửa hệ thống, và có thể giảm phụ thuộc GitHub khi cài đặt.

✨ Tính năng chính

Cài driver thay thế: dùng bản ValdikSS/captdriver (nhánh val, có page-streaming) thay cho driver Canon chính hãng — build và cài tự động, không cần thư viện 32-bit (i386) cũ.
Hoặc cài driver Canon chính hãng v2.71: mục 1 cho phép chọn cài driver chính hãng từ gói linux-capt-drv-v271-uken.tar.gz đặt cạnh script — tự động cài thư viện 32-bit (i386) cần thiết, bật daemon ccpd, khôi phục module usblp. Hai loại driver loại trừ lẫn nhau: chọn cài driver nào thì script tự gỡ sạch driver kia trước (cài chính hãng → gỡ captdriver; cài custom → gỡ cndrvcups-*/ccpd).
Tự vá lỗi treo máy khi in tài liệu phức tạp: vá lỗi race condition trong CUPS USB backend (OpenPrinting/cups#1461) khiến job in bị treo im lặng khi in tài liệu nhiều hình ảnh.
Sửa dứt điểm lỗi kẹt engine ở job thứ 5 (captd): đây là lỗi nặng nhất của driver mã nguồn mở — cứ đến đúng job thứ 5 kể từ lúc bật máy in là engine kẹt cứng (ReserveUnit failed 0x8c), phải tắt/bật nguồn máy in mới in tiếp được. Nguyên nhân: rastertocapt là filter của CUPS, còn CUPS USB backend mở rồi đóng lại kết nối USB cho từng job; driver Canon thật (cả Windows lẫn Linux) không bao giờ bị vì chúng giữ một phiên USB liên tục qua mọi job (Canon dùng daemon ccpd). Toolkit này dựng lại đúng kiến trúc đó bằng captd (daemon giữ phiên USB) + capt-backend (CUPS backend capt: thay cho usb://), kèm 4 file nguồn captdriver đã vá giao thức cho khớp driver Canon Linux thật (nhịp heartbeat SetJobInfo2, GetExtendedStatus ×2 trước mỗi ReserveUnit, sửa vài byte payload, và đọc đủ byte phản hồi thay vì chấp nhận short read). Bắt buộc đủ cả 4 phần — thiếu bất kỳ phầ

项目描述

Fix Print Canon LBP2900 for Linux

Canon-LBP2900-CAPT-Toolkit