本文介绍如何使用 python 解析 esc/p（epson standard code for printers）协议中的位图打印指令（如 esc * 或 esc k），将其还原为可保存的黑白 bmp 图像，适用于无打印机场景下的嵌入式设备图像捕获与可视化。
ESC/P 是爱普生（Epson）定义的一套广泛用于针式/热敏打印机的控制协议，其中 ESC *（即 \x1b*）和 ESC K（即 \x1bK）是两种常见的单向位图打印命令，用于逐列发送 8 点阵（8-bit per column）的二值图像数据。当设备（如频谱分析仪 R&S CMS52、POS 打印终端等）通过串口输出 ESC/P 流而非连接真实打印机时，我们可以将其“重定向”为数字图像——这正是本教程的核心目标。
? 协议关键点解析
-
*`ESC 命令格式（标准 Epson）**： ESC * m nL nH [data...]`
- m = 0 表示 8-dot 单密度模式（最常用）；
- nL, nH 是低位/高位字节，共同表示列数（num_columns = nH << 8 | nL）；
- 后续 num_columns 个字节即为图像数据，每字节代表一列（bit7→bit0 对应该列从上到下 8 个像素）。
-
ESC K 命令格式（部分设备如 R&S CMS52 使用）：
ESC K nL nH [data...]- 无 m 参数，直接跟两字节列数；
- 数据结构相同：每字节 = 一列，bit7 为顶点像素。
⚠️ 注意：原始代码中 data.find(b'\x1b*') 假设设备使用 ESC *，但实际设备（如 R&S CMS52）可能使用 ESC K，需根据硬件手册确认并调整起始标识符及参数偏移。
✅ 改进版健壮解析函数
以下为融合两种命令、增强容错性的 Python 实现（依赖 Pillow 和 struct）：
from PIL import Image
import struct
def escp_to_bmp(data: bytes) -> bytes:
"""
将原始 ESC/P 串口数据（含 ESC * 或 ESC K 命令）解析为 BMP 二进制数据。
支持多图块拼接（连续 ESC/P 位图指令）。
"""
image_rows = [] # 存储所有行（每行是布尔列表，True=黑点）
pos = 0
data_len = len(data)
while pos < data_len:
# 尝试匹配 ESC *（\x1b\x2a）或 ESC K（\x1b\x4b）
if pos + 2 <= data_len and data[pos:pos+2] == b'\x1b*':
cmd_type = 'star'
header_end = pos + 5 # ESC * m nL nH → 共5字节头
elif pos + 2 <= data_len and data[pos:pos+2] == b'\x1bK':
cmd_type = 'k'
header_end = pos + 4 # ESC K nL nH → 共4字节头
else:
pos += 1
continue
# 检查 header 长度是否足够
if header_end > data_len:
break
# 提取列数
try:
if cmd_type == 'star':
# ESC * m nL nH → nL/nH 在 offset 3,4
nL, nH = data[header_end-2], data[header_end-1]
else: # 'k'
# ESC K nL nH → nL/nH 在 offset 2,3
nL, nH = data[pos+2], data[pos+3]
num_cols = (nH << 8) | nL
except IndexError:
break
# 检查图像数据长度是否足够
data_start = header_end if cmd_type == 'star' else pos + 4
data_end = data_start + num_cols
if data_end > data_len:
break
# 解析每列：每个字节 → 8 行（MSB 在上）
col_bytes = data[data_start:data_end]
for bit_pos in range(7, -1, -1): # 从 bit7（顶部）到 bit0（底部）
row = [(b >> bit_pos) & 1 for b in col_bytes]
image_rows.append(row)
# 更新读取位置：跳过整个指令（含命令+参数+数据）
pos = data_end + (2 if cmd_type == 'star' else 2) # ESC + * 或 ESC + K 占2字节
if not image_rows:
raise ValueError("No valid ESC/P bitmap command found in input data")
# 构建 PIL 图像：注意尺寸为 (width, height) = (列数, 行数)
width = len(image_rows[0]) if image_rows else 0
height = len(image_rows)
img = Image.new('1', (width, height)) # '1' mode = 1-bit black & white
# 展平为一维像素序列（行优先）
pixels = [pixel for row in image_rows for pixel in row]
img.putdata(pixels)
# 输出为 BMP 格式字节流
from io import BytesIO
buf = BytesIO()
img.save(buf, format='BMP')
return buf.getvalue()
# ✅ 使用示例
if __name__ == "__main__":
# 读取原始串口捕获文件（如用 PySerial 保存的 .bin）
with open("escp_capture.bin", "rb") as f:
raw = f.read()
try:
bmp_data = 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}")⚠️ 注意事项与调试建议
- 字节序与 unpack 陷阱：原始代码使用 struct.unpack('>BB', ...) 处理高低字节，但直接索引 data[i] 更简洁安全（避免 struct 对齐问题），推荐改用 nH << 8 | nL。
- 图像方向校验：ESC/P 列数据默认 top-to-bottom，因此 for bit_pos in range(7,-1,-1) 是正确的；若图像倒置，请检查 bit 解析顺序或调用 img.transpose(Image.FLIP_TOP_BOTTOM)。
- 多图块支持：本实现自动处理连续多个 ESC * / ESC K 命令，适用于长条码、分页报表等场景。
- 空白/控制字符过滤：真实串口流可能含 ESC d（纸退行）、ESC J（进纸）等非图像指令，当前逻辑自动跳过——仅识别并解析位图命令。
- 性能优化：对超大数据（如千列图像），可考虑使用 numpy 加速位操作，但 Pillow + 原生 Python 已满足大多数嵌入式日志解析需求。
? 总结
将 ESC/P 串口流转为 BMP 并非黑盒难题，核心在于精准识别命令标识、正确解释列数与位映射关系。本文提供了一套可直接运行、兼容主流设备（Epson 兼容机 & R&S CMS52）的健壮解析方案。开发者只需根据实际硬件文档微调命令前缀（* vs K），即可快速集成至数据采集系统、自动化测试平台或 Web 可视化后端中——让“打印机协议”真正成为“图像接口”。
