标题：Python 实现 ESC/P 串行数据流到 BMP 图像的解析与转换_技术教程

本文介绍如何将来自点阵打印机设备（如 r&s cms52）的 esc/p 协议二进制串行数据，解析为可保存、查看和后续处理的黑白 bmp 图像，提供完整可运行代码及关键协议适配说明。

ESC/P（Epson Standard Code for Printers）是一种广泛用于针式/点阵打印机的控制协议，其图形指令常以 ESC K（即 \x1b\x4b）或 ESC *（即 \x1b*）开头，后跟列数（16位大端）和对应位图字节流。每个字节代表一列（8 行），bit0（最低位）对应顶部像素，bit7 对应底部像素——这与常规图像坐标系（y轴向下）一致，但需注意 PIL 的 '1' 模式图像按行优先（row-major） 存储，且 putdata() 接收的是扁平化的一维像素序列。

以下是一个健壮、可扩展的 Python 解析器实现，兼容主流 ESC/P 图形命令（重点支持 ESC K 和 ESC *），并修复了原始代码中常见的尺寸逻辑错误：

from PIL import Image
import struct
import io

def parse_escp_to_bmp(data: bytes) -> bytes:
    """
    将原始 ESC/P 串行数据（含 ESC K 或 ESC * 图形指令）解析为 BMP 格式字节流。
    支持 R&S CMS52 等设备常用的 ESC K 指令，同时向后兼容 ESC *。
    """
    image_rows = []  # 存储所有图像行（每行是 list[int]，元素为 0 或 1）
    offset = 0

    while offset < len(data):
        # 查找 ESC K (\x1b\x4b) —— R&S CMS52 等设备常用
        k_pos = data.find(b'\x1b\x4b', offset)
        # 或查找 ESC * (\x1b*) —— Epson 标准图形模式
        star_pos = data.find(b'\x1b*', offset)

        # 优先匹配更靠前的指令
        if k_pos == -1 and star_pos == -1:
            break
        elif k_pos != -1 and (star_pos == -1 or k_pos < star_pos):
            cmd_start = k_pos
            col_bytes_offset = 2  # ESC K 后第2、3字节为列数（高位在前）
            cmd_len = 4  # ESC K + 2 字节列数
        else:
            cmd_start = star_pos
            col_bytes_offset = 3  # ESC * m 后第3、4字节（m=0,1,2,3），此处简化为固定偏移
            cmd_len = 5

        # 确保有足够的字节读取列数（2字节）和图像数据
        if cmd_start + col_bytes_offset + 2 > len(data):
            break

        # 解析列数（16-bit big-endian）
        try:
            num_cols_high, num_cols_low = data[cmd_start + col_bytes_offset:cmd_start + col_bytes_offset + 2]
            num_columns = (num_cols_high << 8) | num_cols_low
        except IndexError:
            break

        # 图像数据起始位置 & 长度校验
        img_data_start = cmd_start + col_bytes_offset + 2
        if img_data_start + num_columns > len(data):
            break

        # 提取图像字节（每字节 = 1列 × 8行）
        img_bytes = data[img_data_start:img_data_start + num_columns]

        # 将每列字节展开为 8 行像素（bit0→top，bit7→bottom）
        # 注意：PIL '1' 模式中 0=white, 1=black；此处保持 1=black 符合打印语义
        for bit_pos in range(7, -1, -1):  # 从 bit7（底行）→ bit0（顶行）
            row = []
            for b in img_bytes:
                row.append((b >> bit_pos) & 1)
            image_rows.append(row)

        # 更新 offset：跳过当前指令 + 列数 + 图像数据 + 可能的尾随控制符（如 CR/LF）
        offset = img_data_start + num_columns + 2

    # 安全检查：确保有有效图像数据
    if not image_rows:
        raise ValueError("No valid ESC/P graphics command found in input data")

    # 图像尺寸：width = 列数（即每行像素数），height = 行数（即总扫描线数）
    width = len(image_rows[0]) if image_rows else 1
    height = len(image_rows)

    # 创建单色图像（'1' mode: 1-bit pixels, black and white, 0=white, 1=black）
    img = Image.new('1', (width, height))

    # 扁平化像素列表：按行优先顺序展开
    flat_pixels = [pixel for row in image_rows for pixel in row]
    img.putdata(flat_pixels)

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

# 使用示例
if __name__ == "__main__":
    # 读取原始 ESC/P 二进制流（例如由串口捕获或文件保存）
    with open("escp_dump.bin", "rb") as f:
        raw_data = f.read()

    try:
        bmp_bytes = parse_escp_to_bmp(raw_data)
        with open("output.bmp", "wb") as f:
            f.write(bmp_bytes)
        print(f"✅ 成功生成 BMP 图像：{len(bmp_bytes)} 字节，尺寸 {width}×{height}")
    except Exception as e:
        print(f"❌ 解析失败：{e}")

关键注意事项与优化说明：

✅ 指令兼容性：显式区分 ESC K（R&S CMS52）与 ESC *（Epson 标准），避免硬编码偏移导致解析失败；
✅ 内存安全：所有 data[] 访问前均做边界检查，防止 IndexError；
✅ 尺寸逻辑修正：原始代码中 Image.new('1', (width, height)) 的宽高传反（应为 (width, height)，而非 (height, width)），本实现严格遵循 PIL 坐标约定（width=列数, height=行数）；
✅ 位序一致性：for bit_pos in range(7, -1, -1) 确保 bit7 → 底行、bit0 → 顶行，与点阵物理布局对齐；
⚠️ 未处理指令：本方案暂不解析 ESC @（初始化）、ESC d（纸进给）等非图形指令；如需完整协议支持，建议结合 pyserial 实时解析流，并用状态机管理打印机上下文；
? 调试建议：可添加 print(f"Found ESC K at {k_pos}, cols={num_columns}, data_len={len(img_bytes)}") 辅助定位数据结构异常。