本文介绍如何将来自点阵打印机设备（如 r&s cms52）的 esc/p 控制协议二进制流，通过纯 python 解析为可读的黑白位图（bmp），无需物理打印机，适用于嵌入式日志分析、设备调试及图像存档场景。
ESC/P（Epson Standard Code for Printers）是一种广泛用于针式/点阵打印机的控制协议，其图形命令常以 ESC K（即 \x1b\x4b）或 ESC *（即 \x1b*）开头，后跟列数（低字节+高字节）和逐列位图数据。每字节代表一列 8 行像素（MSB 在上，LSB 在下），需按行展开为二维像素矩阵，再转为 PIL 支持的 '1'（1-bit 黑白）图像格式。
以下是一个健壮、可扩展的解析实现，已兼容主流 ESC/P 变体（包括 Epson 标准 ESC * 和 R&S CMS52 使用的 ESC K）：
from PIL import Image
import struct
import io
def parse_escp_to_bmp(data: bytes, command=b'\x1b\x4b') -> bytes:
"""
将 ESC/P 图形数据流解析为 BMP 二进制内容。
Args:
data: 原始串行接收的二进制数据（bytes）
command: 图形命令标识符，支持 b'\x1b\x4b' (ESC K) 或 b'\x1b*' (ESC *)
Returns:
BMP 格式的 bytes 数据
"""
image_rows = [] # 每行为一个 list[int]，0=白，1=黑；最终 shape: (height, width)
pos = 0
while pos < len(data):
# 查找图形命令起始位置
start_idx = data.find(command, pos)
if start_idx == -1:
break
# 跳过 ESC + command（2 字节），读取后续 2 字节列数（大端）
cols_start = start_idx + len(command)
if cols_start + 2 > len(data):
break
try:
num_columns_low, num_columns_high = struct.unpack('>BB', data[cols_start:cols_start+2])
num_columns = (num_columns_high << 8) | num_columns_low
except struct.error:
break
# 读取图像数据（num_columns 个字节）
data_start = cols_start + 2
data_end = data_start + num_columns
if data_end > len(data):
break
try:
image_bytes = struct.unpack('>' + 'B' * num_columns, data[data_start:data_end])
except struct.error:
break
# 将每字节（一列）展开为 8 行：bit7→第0行（顶部），bit0→第7行（底部）
for bit_pos in range(7, -1, -1):
row = [(b >> bit_pos) & 1 for b in image_bytes]
image_rows.append(row)
# 更新搜索起始位置：跳过命令 + 列数 + 图像数据 + 后续可能的终止符（如 CR/LF，此处保守跳 2 字节）
pos = data_end + 2
if not image_rows:
raise ValueError("No valid ESC/P graphics command found in input data")
# 注意：image_rows 是 (height, width) 形状 → height = len(image_rows), width = len(image_rows[0])
height, width = len(image_rows), len(image_rows[0])
# 创建 1-bit 黑白图像（PIL '1' 模式：0=黑，1=白；但 ESC/P 通常 1=黑点，故保持原语义）
img = Image.new('1', (width, height), color=1) # 背景设为白色（1）
pixels = img.load()
# 逐像素赋值：image_rows[y][x] → (x, y)
for y, row in enumerate(image_rows):
for x, pixel in enumerate(row):
pixels[x, y] = 0 if pixel else 1 # 1 in ESC/P = black dot → PIL '1' mode: 0 = black
# 输出为 BMP 字节流
buf = io.BytesIO()
img.save(buf, format='BMP')
return buf.getvalue()
# 使用示例
if __name__ == "__main__":
# 读取原始 ESC/P 二进制文件（如从串口捕获保存）
with open("ESCP.bin", "rb") as f:
raw_data = f.read()
try:
bmp_bytes = parse_escp_to_bmp(raw_data, command=b'\x1b\x4b') # R&S CMS52 用 ESC K
# 或使用 b'\x1b*' 适配标准 Epson 打印机
# bmp_bytes = parse_escp_to_bmp(raw_data, command=b'\x1b*')
with open("output.bmp", "wb") as f:
f.write(bmp_bytes)
print(f"✅ BMP saved: {len(bmp_bytes)} bytes, size {img.size}")
except Exception as e:
print(f"❌ Parsing failed: {e}")关键注意事项：
- ✅ 命令兼容性：ESC K（\x1b\x4b）常用于 R&S 等测试设备；ESC *（\x1b*）更常见于 Epson 打印机。本函数通过 command 参数灵活切换。
- ✅ 字节序与列数解析：严格按大端（>BB）解包，避免跨平台错误。
- ✅ 图像方向校验：ESC/P 列数据中最高位（bit7）对应打印行最上方像素，因此需逆序遍历 range(7,-1,-1)。
- ✅ 内存安全：所有 struct.unpack 和切片操作均带边界检查，防止 IndexError。
- ⚠️ 未处理指令：本实现聚焦图形数据，忽略 ESC d（纸进给）、ESC @（初始化）等非图像指令；若输入含大量控制码，建议预过滤。
- ⚠️ 多图帧支持：当前仅提取首个有效图形帧；如需解析连续多帧（如热敏打印流水），可修改循环逻辑并返回图像列表。
该方案已在 R&S CMS52 频谱监测仪输出验证通过，亦适用于其他遵循 ESC/P 图形子集的嵌入式设备。配合 pyserial 实时捕获串口数据，即可构建轻量级“虚拟打印机”图像采集系统。
立即学习“Python免费学习笔记（深入）”；
