TSPL / TSPL2 完整指令集中文手册

Part 12 - 最终命令索引与开发速查

目录

• 1. TSPL完整命令索引
• 2. 参数速查表
• 3. 常用打印模板
• 4. 调试流程
• 5. 开发规范
• 6. 生产环境建议

1. TSPL完整命令索引

A

B

C

D

E

F

G

H

I

M

O

P

Q

R

S

T

2. 参数速查表

旋转参数

标签单位

支持：

mm

inch

dot

常见DPI

CODEPAGE

打印模式

3. 常用打印模板

3.1 最小测试模板

SIZE 100 mm,50 mm

CLS

TEXT 50,50,"3",0,1,1,"TEST"

PRINT 1

3.2 商品标签

SIZE 100 mm,60 mm

GAP 3 mm,0


CLS


TEXT 30,30,"3",0,2,2,"商品名称"


TEXT 30,80,"3",0,1,1,"MODEL-A"


BARCODE 30,130,"128",60,1,0,2,2,"123456"


QRCODE 300,130,L,5,A,0,"MODEL-A"


PRINT 1

3.3 仓库标签

SIZE 80 mm,50 mm

CLS


TEXT 20,20,"3",0,1,1,"SKU:A001"

TEXT 20,60,"3",0,1,1,"QTY:100"


BARCODE 20,100,"128",50,1,0,2,2,"A001"


PRINT 1

3.4 RFID标签

SIZE 100 mm,50 mm


CLS


RFID WRITE 0,12,"A001"


TEXT 30,30,"3",0,1,1,"RFID"


BARCODE 30,100,"128",60,1,0,2,2,"A001"


PRINT 1

4. TSPL调试流程

第一步：确认连接

检查：

USB

RS232

Ethernet

第二步：发送测试

发送：

SIZE 100 mm,50 mm

CLS

TEXT 50,50,"3",0,1,1,"TEST"

PRINT 1

第三步：检查状态

发送：

~HS

第四步：校准标签

间隙：

GAPDETECT

黑标：

BLINEDETECT

5. 开发规范

5.1 模板分离

推荐：

业务数据

↓

TSPL模板

↓

打印服务

不要：

业务代码里硬编码全部TSPL

5.2 参数化

例如模板：

{PRODUCT}

{SN}

{DATE}

生成：

TEXT 50,50,"3",0,1,1,"{PRODUCT}"

5.3 错误处理

必须处理：

缺纸

开盖

暂停

通信失败

打印超时

6. 生产环境建议

打印机管理

保存：

IP地址

型号

DPI

状态

最后任务

日志记录

建议：

打印时间

标签编号

用户

结果

错误信息

7. TSPL项目结构建议

PrinterSystem

├── Template

│   └── product.tpl

│

├── Driver

│   └── TsplClient

│

├── Queue

│   └── TaskManager

│

├── Monitor

│   └── StatusService

│

└── Log

8. 最终推荐打印流程

创建任务

↓

加载模板

↓

替换变量

↓

生成TSPL

↓

检查打印机状态

↓

发送数据

↓

等待完成

↓

记录日志

9. TSPL学习路线

建议顺序：

SIZE/GAP

↓

TEXT

↓

BARCODE

↓

QRCODE

↓

图片

↓

文件管理

↓

状态查询

↓

变量

↓

RFID

↓

BASIC

TSPL / TSPL2 中文手册 完

版本：

TSPL2 Reference Guide

整理版本：

2026

END