本文详解如何用 python 解析 esc/p 协议中的点阵图像指令（如 \x1b* 或 \x1bk），将原始串行字节流转换为标准黑白 bmp 图像，适用于无打印机场景下的嵌入式设备图像捕获与存档。

ESC/P（Epson Standard Code for Printers）是一种广泛用于针式/点阵打印机的控制协议，其图像打印指令（如 ESC * 和 ESC K）以紧凑的位图格式传输逐列点阵数据。尽管现代应用中已少用物理打印机，但部分测试设备（如罗德与施瓦茨 CMS52 频谱监测仪）、工业终端或旧式 POS 设备仍通过串口输出 ESC/P 图像流。本文提供一套轻量、可扩展的 Python 解析方案，无需第三方 ESC/P 专用库，仅依赖标准库与 Pillow（PIL）即可完成从原始字节到 BMP 文件的端到端转换。

核心原理：ESC/P 图像指令结构

ESC/P 中最常用的位图指令有两种常见变体：

• *`ESC m nL nH [data]**（m=0表示 8-bit 单色模式）： 指令起始为\x1b\x2a（即ESC *），后跟模式字节m，再紧接两个字节nL（低字节）和nH（高字节）表示列数N = nH

• ESC K nL nH [data]（常见于 R&S CMS52 等设备）：
  起始为 \x1b\x4b，省略模式字节，直接以 nL+nH 指定列数，后续 N 字节为图像数据。

每字节代表一列（column）的 8 行像素（MSB 对应第 0 行，即顶部），bit 值为 1 表示该位置“有墨点”。因此，解析时需对每个字节执行 位展开（bit unpacking），并按行优先顺序重组像素矩阵。

完整可运行解析函数（兼容双指令）

以下代码统一支持 ESC * 与 ESC K 指令，并修复了原方案中宽高误置、指令偏移错误及边界处理缺陷：

from PIL import Image
import struct
import io

def parse_escp_to_bmp(data: bytes) -> bytes:
    """
    将 ESC/P 串行字节流（含 ESC * 或 ESC K 图像指令）解析为 BMP 二进制数据。

    支持两种主流格式：
      - ESC * 0 nL nH [N bytes] → 起始索引 +3 处读取列数
      - ESC K nL nH [N bytes] → 起始索引 +2 处读取列数

    返回：BMP 格式字节流（可用于保存或传输）
    """
    image_rows = []  # 存储所有行（每行是 list[int]，元素为 0/1）
    pos = 0

    while pos < len(data):
        # 查找 ESC * (\x1b\x2a) 或 ESC K (\x1b\x4b)
        star_pos = data.find(b'\x1b\x2a', pos)
        k_pos = data.find(b'\x1b\x4b', pos)

        # 优先匹配更靠前的指令
        if star_pos == -1 and k_pos == -1:
            break
        elif star_pos == -1:
            cmd_start = k_pos
            mode_offset = 0  # ESC K 无模式字节
            col_bytes_offset = 2  # nL/nH 紧跟在 \x1b\x4b 后
        elif k_pos == -1:
            cmd_start = star_pos
            mode_offset = 1  # ESC * 后第 1 字节为模式（通常为 0）
            col_bytes_offset = 3  # nL/nH 在模式字节之后
        else:
            cmd_start = min(star_pos, k_pos)
            mode_offset = 1 if cmd_start == star_pos else 0
            col_bytes_offset = 3 if cmd_start == star_pos else 2

        # 提取列数（nL + nH，大端）
        col_bytes_start = cmd_start + col_bytes_offset
        if col_bytes_start + 2 > len(data):
            break
        nL, nH = data[col_bytes_start:col_bytes_start + 2]
        num_columns = (nH << 8) | nL

        # 提取图像数据（num_columns 字节）
        data_start = col_bytes_start + 2
        data_end = data_start + num_columns
        if data_end > len(data):
            break

        column_bytes = data[data_start:data_end]

        # 将每列字节展开为 8 行像素（从顶行 MSB 开始 → 行索引 0~7）
        for bit_pos in range(7, -1, -1):  # 从 bit7（最高位）到 bit0（最低位）
            row = []
            for b in column_bytes:
                row.append((b >> bit_pos) & 1)
            image_rows.append(row)

        # 更新搜索起始位置：跳过当前指令 + 数据 + 可能的校验/终止符（+2 是保守跳过 CR/LF 等）
        pos = data_end + 2

    if not image_rows:
        raise ValueError("No valid ESC/P image data found in input stream.")

    # 注意：image_rows 是 [行][列] 结构 → width = 列数，height = 行数
    height = len(image_rows)
    width = len(image_rows[0]) if height > 0 else 0

    # 创建 1-bit 黑白图像（'1' 模式），注意 PIL 的尺寸参数是 (width, height)
    img = Image.new('1', (width, height), color=1)  # 白底（1 = white, 0 = black）
    pixels = [pixel for row in image_rows for pixel in row]
    img.putdata(pixels)

    # 输出为 BMP 字节流
    buf = io.BytesIO()
    img.save(buf, format='BMP')
    return buf.getvalue()

# 使用示例
if __name__ == "__main__":
    # 读取原始串口捕获文件（二进制）
    with open("ESCP.bin", "rb") as f:
        raw = f.read()

    try:
        bmp_data = parse_escp_to_bmp(raw)
        with open("output.bmp", "wb") as f:
            f.write(bmp_data)
        print(f"✅ BMP saved successfully: {len(bmp_data)} bytes")
    except Exception as e:
        print(f"❌ Parsing failed: {e}")

关键注意事项与优化建议

• ✅ 指令兼容性：本实现自动识别 ESC * 与 ESC K，适配 Epson 标准设备与 R&S CMS52 等非标设备；若遇其他指令（如 ESC L），可依协议扩展分支逻辑。
• ✅ 内存安全：严格校验字节边界（data_end
• ✅ 图像方向正确性：原问题中 Image.new('1', (height, width)) 是典型错误——PIL 要求 (width, height)，且 ESC/P 的“列”对应图像宽度，“行”对应高度，必须严格区分。
• ⚠️ 多图像支持：当前版本按顺序提取所有图像块并纵向拼接（适合连续打印帧）。如需分离多张独立图像，可在每次解析后清空 image_rows 并分别保存。
• ⚙️ 性能提示：对超长数据流（>1MB），建议改用生成器分块处理，避免内存峰值；高频实时串口接收时，推荐结合 pyserial 的 read_until() 捕获完整指令块。
• ? 协议延伸：ESC/P 还支持压缩（如 ESC * m 1）、多密度（n=1/2/3 表示 8/24/32 行/列）、灰度（需 ESC .）等，进阶需求可参考 Epson ESC/P Reference。

通过本方案，开发者可快速构建 ESC/P 图像采集网关，将老旧设备输出转化为可编程处理的数字图像资源，为自动化测试、日志归档或 UI 模拟提供坚实基础。