Loading...

Cài đặt máy in Epson L310 và Godex 500 lên Linux (Ubuntu)

(Áp dụng cho mọi hình thức cắm trực tiếp USB, in qua mạng Windows LPD & xử lý triệt để lỗi "Filter Failed")

Việc cấu hình in ấn trên các hệ điều hành Linux (đặc biệt là Ubuntu từ bản 22.04 đến 26.04) luôn là một bài toán khó đối với các quản trị viên hệ thống và kỹ thuật viên. Đặc biệt, các dòng máy in tem nhãn dán như Godex G500 thường gặp lỗi im lặng hoặc báo "Filter failed" ngay khi gửi lệnh in.

Tài liệu này sẽ hướng dẫn bạn từ A-Z cách cài đặt hai dòng máy này qua hai phương thức phổ biến nhất: Cắm cáp USB trực tiếpIn qua mạng chia sẻ Windows LPD, đồng thời làm rõ bản chất hệ thống để bạn có thể tự mình làm chủ mọi lỗi phát sinh.

PHẦN I: BẢN CHẤT HỆ THỐNG & ĐỘ TƯƠNG THÍCH DRIVER GODEX

Trước khi đi vào cài đặt, bạn cần hiểu rõ cơ chế phân phối và xử lý lệnh in của máy in mã vạch Godex trên môi trường Linux.

1. Driver Godex có dùng chung được không?

CÓ! Driver này áp dụng được cho gần như TOÀN BỘ các dòng máy in của hãng Godex.

  • Ngôn ngữ chung (EZPL): Tất cả các dòng máy in mã vạch của Godex (từ phân khúc để bàn như G300, G500, DT4x cho đến các dòng máy công nghiệp cỡ lớn như EZ2250i, ZX400i) đều sử dụng chung một ngôn ngữ mô tả trang in gốc là EZPL (EZ Programming Language).

  • Bộ lọc vạn năng (rastertoezpl): Trái tim của driver chính là tệp bộ lọc rastertoezpl mà chúng ta biên dịch thủ công. Nhiệm vụ của nó là dịch hình ảnh thiết kế từ hệ thống CUPS của Ubuntu thành mã lệnh EZPL. Vì mọi máy Godex đều hiểu ngôn ngữ này, nên tệp thực thi này hoàn toàn dùng chung được cho mọi máy.

  • Sự khác biệt nằm ở tệp cấu hình .ppd: Khi bạn cài đặt các model khác nhau (ví dụ G500 vs G530), lõi xử lý dịch lệnh vẫn là một, hệ thống chỉ thay thế tệp mô tả cấu hình .ppd tương ứng. Tệp này định nghĩa cho Ubuntu biết:

    • Độ phân giải đầu in (G500 là 203 DPI, G530 là 300 DPI).

    • Khổ giấy tối đa của máy để hệ thống tự động căn lề.

2. Danh sách các dòng máy Godex chạy chung lõi driver này

Bạn hoàn toàn tự tin áp dụng nguyên văn bài hướng dẫn này cho các dòng máy sau:

  • G-Series: Godex G300, G330, G500, G530.

  • RT-Series: Godex RT700, RT730, RT200.

  • DT-Series (In nhiệt trực tiếp): Godex DT4x, DT200.

  • EZ-Series (Dòng công nghiệp): Godex EZ120, EZ2250i, EZ6250i.

PHẦN II: TẢI VÀ BIÊN DỊCH LÕI DRIVER (PREPARATION)

Hệ thống của bạn bắt buộc phải có lõi driver trước khi tiến hành map cổng (dù là mạng LPD hay cáp USB).

1. Chuẩn bị Driver cho dòng máy Godex

Bạn có thể lựa chọn tải tự động bằng lệnh hoặc tải thủ công qua trình duyệt:

Cách tải thủ công qua trình duyệt:

  1. Truy cập trang chủ quốc tế của Godex: godexintl.com/downloads

  2. Cuộn xuống mục Driver -> Tìm dòng CUPS Printer Driver (For all Linux system).

  3. Tải tệp tin nén định dạng .tar.gz về máy.

Biên dịch driver từ mã nguồn (Terminal):

Sau khi tải tệp nén về máy (giả sử đặt tại thư mục ~/Downloads), thực hiện các lệnh sau để biên dịch:

# Cài đặt các thư viện biên dịch đồ họa bắt buộc
sudo apt update
sudo apt install build-essential libcups2-dev

# Giải nén driver vào một thư mục sạch không có dấu tiếng Việt
tar -xzf ~/Downloads/rastertoezpl-*.tar.gz -C ~/
cd ~/rastertoezpl-*

# Phân quyền thực thi cho các tệp cấu hình
chmod +x configure install-sh

# Biên dịch và nạp lõi lọc rastertoezpl vào hệ thống CUPS
./configure --disable-dependency-tracking
make
sudo make install

Lưu ý: Sau khi chạy xong lệnh sudo make install, hệ thống sẽ tự động nạp các file .ppd cần thiết vào đường dẫn chuẩn /usr/local/share/ppd/godex/.

2. Chuẩn bị Driver cho dòng máy màu Epson L310

Hãng Epson đóng gói driver chính thức dưới dạng gói cài đặt .deb, bạn chỉ cần tải và cài đặt trực tiếp cực kỳ đơn giản:

# Tải trực tiếp gói driver chính hãng từ máy chủ Epson
wget --no-check-certificate -U Mozilla -O ~/Downloads/epson-inkjet-printer-201401w_1.0.1-1_amd64.deb \
  "[https://download-center.epson.com/f/module/fccea047-d7ce-4f47-a58b-3126090293b1/epson-inkjet-printer-201401w_1.0.1-1_amd64.deb](https://download-center.epson.com/f/module/fccea047-d7ce-4f47-a58b-3126090293b1/epson-inkjet-printer-201401w_1.0.1-1_amd64.deb)"

# Cài đặt gói driver vào hệ thống Ubuntu
sudo apt install ~/Downloads/epson-inkjet-printer-201401w_1.0.1-1_amd64.deb

PHẦN III: PHƯƠNG PHÁP 1 - CÀI ĐẶT CẮM CÁP USB TRỰC TIẾP VÀO UBUNTU

Khi máy in kết nối trực tiếp vật lý với máy tính Ubuntu của bạn qua cáp USB.

Bước 1: Kiểm tra kết nối vật lý của máy in

Cắm cáp USB, bật nguồn máy in và chạy lệnh sau trên Terminal để đảm bảo phần cứng đã được Ubuntu nhận diện:

lsusb

Kết quả trả ra phải hiển thị dòng chứa thương hiệu máy in của bạn (ví dụ: Seiko Epson Corp. hoặc Godex). Nếu không thấy, hãy kiểm tra lại dây cáp hoặc cổng USB.

Bước 2: Thiết lập máy in trực tiếp

A. Đối với Epson L310 (Nhận diện tự động)

Do sử dụng driver chuẩn hệ thống, thông thường sau khi bạn cài đặt xong tệp .deb ở Phần II, Ubuntu sẽ tự cấu hình cổng kết nối. Bạn chỉ cần kiểm tra xem thiết bị đã xuất hiện chưa:

lpstat -v

Nếu hệ thống chưa tự nhận diện, bạn có thể ép nạp máy in bằng lệnh sau:

# Tìm đường dẫn USB chính xác của Epson L310
lpinfo -v | grep usb

# Thêm máy in trực tiếp bằng lệnh
sudo lpadmin -p Epson-L310 -E -v usb://Epson/L310?serial=... -m epson-inkjet-printer-201401w

B. Đối với Godex G500 (Cấu hình tay cổng USB)

Sau khi đã chạy biên dịch driver ở Phần II, bạn tiến hành map driver vào cổng USB vật lý như sau:

  1. Quét tìm mã URI định danh cổng cáp USB của máy in:

    lpinfo -v | grep usb
    

    Kết quả sẽ trả ra dạng: direct usb://Godex/G500?serial=xxxxxxx.

  2. Thực hiện lệnh nạp máy in với đường dẫn URI tìm được:

    sudo lpadmin -p Godex-G500 -E \
      -v usb://Godex/G500?serial=xxxxxxx \
      -P /usr/local/share/ppd/godex/godex-g500.ppd
    
  3. Đặt máy in làm mặc định của hệ thống:

    sudo lpoptions -d Godex-G500
    sudo systemctl restart cups
    

PHẦN IV: PHƯƠNG PHÁP 2 - CÀI ĐẶT QUA MẠNG (CHIA SẺ TỪ WINDOWS QUA LPD)

Giao thức LPD (Line Printer Daemon) là phương thức kết nối máy in từ mạng Windows sang Linux có độ ổn định cao nhất, không bị lỗi nghẽn hoặc đòi xác thực tài khoản phức tạp như Samba (SMB).

Bước 1: Bật tính năng LPD trên máy chủ Windows

Trên máy chủ Windows đang kết nối trực tiếp với máy in:

  1. Vào Control Panel -> Chọn Programs and Features.

  2. Chọn mục Turn Windows features on or off ở cột bên trái.

  3. Cuộn tìm thư mục Print and Document Services và tích chọn LPD Print Service. Nhấn OK và khởi động lại Windows nếu được yêu cầu.

  4. Đảm bảo bạn đã bật tính năng "Share" máy in và ghi nhớ chính xác Share Name (ví dụ: Godex-G500 hoặc Epson-L310).

Bước 2: Thiết lập kết nối trên máy Ubuntu khách

A. Đối với máy Godex G500

Chạy lệnh sau trên terminal để tạo kết nối mạng (thay thế 192.168.0.x bằng IP máy Windows và Godex-G500 ở cuối đường dẫn bằng tên hàng đợi share trên Windows):

sudo lpadmin -p Godex-G500 -E \
  -v lpd://192.168.0.x/Godex-G500 \
  -P /usr/local/share/ppd/godex/godex-g500.ppd

sudo lpoptions -d Godex-G500
sudo systemctl restart cups

B. Đối với máy Epson L310

Tương tự như Godex, chạy lệnh map mạng cho Epson L310:

sudo lpadmin -p Epson-L310 -E \
  -v lpd://192.168.0.x/TÊN_SHARE_TRÊN_WINDOWS \
  -m epson-inkjet-printer-201401w

sudo lpoptions -d Epson-L310
sudo systemctl restart cups

PHẦN V: BƯỚC THẦN CHÚ - TIÊU DIỆT TRIỆT ĐỂ LỖI "FILTER FAILED" (APPARMOR)

Đây là bước sống còn quyết định máy in của bạn có chạy được hay không.

1. Tại sao xảy ra lỗi này?

Cơ chế bảo mật AppArmor của các bản Ubuntu đời mới cực kỳ nghiêm ngặt. Khi bạn tự biên dịch driver Godex thủ công (rastertoezpl), tệp tin lọc này không được ký số bởi nhà phát hành Ubuntu, do đó AppArmor lập tức xếp nó vào danh sách nguy hiểm và chặn quyền truy cập (Deny). Lỗi này hiển thị trên CUPS dưới dạng trạng thái "Filter failed".

2. Cách khắc phục hoàn toàn

Giải pháp tạm thời (Chỉ cảnh báo, không chặn):

# Cài đặt bộ công cụ cấu hình AppArmor
sudo apt install apparmor-utils

# Chuyển tiến trình in ấn của CUPS sang chế độ complain (chỉ ghi log cảnh báo, không chặn quyền)
sudo aa-complain /usr/sbin/cupsd
sudo systemctl daemon-reload
sudo systemctl restart cups

Giải pháp vĩnh viễn (Khuyên dùng cho máy in sản xuất hoặc tem nhãn):

Lệnh aa-complain đôi khi sẽ bị reset sau khi bạn cập nhật hệ thống hoặc khởi động lại máy tính. Để khóa hoàn toàn không cho AppArmor can thiệp chặn CUPS:

# Vô hiệu hóa vĩnh viễn kiểm soát bảo mật của AppArmor đối với dịch vụ in ấn
sudo aa-disable /usr/sbin/cupsd
sudo systemctl daemon-reload
sudo systemctl restart cups

PHẦN VI: LỆNH TIỆN ÍCH & DEBUG LỖI NHANH TRÊN TERMINAL

  • Kiểm tra file lỗi chi tiết của hệ thống in (Sử dụng khi gửi lệnh in mà máy không chạy):

    sudo tail -n 50 /var/log/cups/error_log
    
  • Kiểm tra trạng thái sẵn sàng và cổng kết nối của các máy in hiện tại:

    lpstat -p
    lpstat -v
    
  • In thử một đoạn văn bản thô để test kết nối vật lý ngay lập tức:

    echo "Kết nối trực tiếp thành công!" | lp
    
  • Mẹo Đổi Tên Máy In Ngắn Gọn (Xóa cấu hình cũ tên dài dòng, cấu hình lại tên đẹp):

    # 1. Xóa máy in cũ ra khỏi CUPS
    sudo lpadmin -x "TEN_CU_DAI_DONG_RAC_ROI"
    
    # 2. Tạo lại máy in mới cực kỳ gọn gàng
    sudo lpadmin -p "Godex-G500" -E -v usb://Godex/G500?serial=xxxxxxx -P /usr/local/share/ppd/godex/godex-g500.ppd