Windows11下Python-escpos驱动热敏打印机打印图片报错求解决

问题详情 #

环境信息 #

• Python版本：3.11.3
• Python-escpos版本：3.0a9
• 操作系统：Windows11 22H2
• 热敏打印机：OCPP-58E-U

示例代码 #

from escpos.printer import Usb

p = Usb(0x0456, 0x0808, in_ep=0x81, out_ep=0x03, profile='POS-5890')
p.charcode(code='AUTO')
p.codepage = 'WPC1250'
p.text('Image printing...')
p.image('test.png')
p.close()

报错信息 #

Traceback (most recent call last):
  File "F:\Source Code\reward_printer\rewards.py", line 76, in print_something
    p.image('test.png')
  File "C:\Python\Lib\site-packages\escpos\escpos.py", line 210, in image
    self._raw(header + im.to_raster_format())
  File "C:\Python\Lib\site-packages\escpos\printer.py", line 130, in _raw
    self.device.write(self.out_ep, msg, self.timeout)
  File "C:\Python\Lib\site-packages\usb\core.py", line 989, in write
    return fn(
           ^^^
  File "C:\Python\Lib\site-packages\usb\backend\libusb1.py", line 837, in bulk_write
    return self.__write(self.lib.libusb_bulk_transfer,
           ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  File "C:\Python\Lib\site-packages\usb\backend\libusb1.py", line 938, in __write
    _check(retval)
  File "C:\Python\Lib\site-packages\usb\backend\libusb1.py", line 604, in _check
    raise USBError(_strerror(ret), ret, _libusb_errno[ret])
usb.core.USBError: [Errno 32] Pipe error

补充说明 #

• USB ID及厂商信息正确，打印机可正常打印图片前的文本内容。
• 图片文件存在且无损坏，可通过任意图像编辑器正常打开。
• 报错终止前仅打印出图片的一部分。
• 尝试过PNG、BMP、TIFF、静态GIF格式，均出现相同报错。

猜测：是否属于USB缓冲区错误？

问题：该如何解决此问题？

解决方法 #

1. 拆分图片数据分批发送 #

你的猜测是对的，这大概率是USB缓冲区溢出导致的。python-escpos默认一次性发送整张图片的光栅数据，超过USB管道缓冲区容量就会触发Pipe error。可以通过拆分数据分批发送解决：

方法A：修改python-escpos源码

找到C:\Python\Lib\site-packages\escpos\printer.py中的_raw方法，替换为以下代码：

def _raw(self, msg):
    """Print any command sent in raw format"""
    if self.device:
        chunk_size = 512  # 可根据打印机调整，常见值为512或1024
        for i in range(0, len(msg), chunk_size):
            chunk = msg[i:i+chunk_size]
            self.device.write(self.out_ep, chunk, self.timeout)

方法B：封装分批发送函数（无需改源码）

from escpos.printer import Usb
from escpos.image import EscposImage

def send_raw_chunked(printer, data, chunk_size=512):
    """分批发送数据到打印机"""
    for i in range(0, len(data), chunk_size):
        chunk = data[i:i+chunk_size]
        printer.device.write(printer.out_ep, chunk, printer.timeout)

# 初始化打印机
p = Usb(0x0456, 0x0808, in_ep=0x81, out_ep=0x03, profile='POS-5890')
p.charcode(code='AUTO')
p.codepage = 'WPC1250'
p.text('Image printing...')

# 手动处理图片并分批发送
im = EscposImage('test.png')
# 构造图片打印指令头
header = b'\x1B\x2A\x01' + im.width.to_bytes(2, byteorder='little') + im.height.to_bytes(2, byteorder='little')
send_raw_chunked(p, header + im.to_raster_format())

p.close()

2. 缩小图片尺寸/分辨率 #

58mm热敏打印机的最大打印宽度一般为384像素，将图片缩至该宽度内可大幅减少数据量，避免缓冲区溢出：

from PIL import Image
from escpos.printer import Usb

# 预处理图片
img = Image.open('test.png')
max_print_width = 384  # 58mm打印机通用宽度
width_ratio = max_print_width / float(img.size[0])
new_height = int(float(img.size[1]) * width_ratio)
resized_img = img.resize((max_print_width, new_height), Image.Resampling.LANCZOS)
resized_img.save('resized_test.png')

# 打印处理后的图片
p = Usb(0x0456, 0x0808, in_ep=0x81, out_ep=0x03, profile='POS-5890')
p.charcode(code='AUTO')
p.codepage = 'WPC1250'
p.text('Image printing...')
p.image('resized_test.png')
p.close()

3. 更换python-escpos版本 #

3.0a9是预发布版本，可能存在兼容性问题。尝试降级到稳定版：

pip uninstall python-escpos
pip install python-escpos==2.2.0

4. 延长USB超时时间 #

初始化打印机时设置更长的超时时间，给打印机足够时间处理数据：

p = Usb(0x0456, 0x0808, in_ep=0x81, out_ep=0x03, profile='POS-5890', timeout=5000)

内容的提问来源于stack exchange，提问作者BarnardMikey