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

Part 5 - 高级变量、计数器、流水号、动态数据

目录

• 1. 高级打印功能概述
• 2. COUNTER 计数器
• 3. SET COUNTER
• 4. 流水号打印
• 5. 自动递增标签
• 6. 日期时间打印
• 7. 变量输入
• 8. 键盘输入
• 9. 批量打印控制
• 10. 动态标签示例

1. 高级打印功能概述

TSPL2 支持部分动态数据功能。

主要用于：

• 产品序列号
• 批次编号
• 条码流水号
• 生产日期
• 计数标签
• 工业追踪标签

典型应用：

产品编号

↓

自动生成序列号

↓

打印二维码

↓

记录生产信息

2. COUNTER 计数器

功能

用于自动递增或递减打印内容。

应用：

• SN编号
• 箱号
• 件号
• 标签序号

3. SET COUNTER

功能

初始化计数器。

语法

SET COUNTER @n start step

参数

示例

初始化：

SET COUNTER @1 1 1

表示：

1
2
3
4
5
...

4. COUNTER

功能

打印当前计数器值。

语法

COUNTER x,y,"font",rotation,xmul,ymul,@n

示例

SET COUNTER @1 1000 1


COUNTER 50,50,"3",0,1,1,@1

打印：

1000

下一张：

1001

5. 流水号打印

应用场景

例如：

产品：

MODEL-A

序列：

MODEL-A000001

MODEL-A000002

MODEL-A000003

示例

初始化：

SET COUNTER @1 1 1

打印：

TEXT 50,50,"3",0,1,1,"SN:"
COUNTER 120,50,"3",0,1,1,@1

PRINT 1

效果：

第一次：

SN:1

第二次：

SN:2

6. 自动递增标签

示例：打印100个编号

SIZE 100 mm,50 mm

CLS


SET COUNTER @1 1 1


TEXT 50,50,"3",0,1,1,"NO:"


COUNTER 150,50,"3",0,1,1,@1


PRINT 100

输出：

NO:1

NO:2

NO:3

...

NO:100

7. 日期时间打印

部分 TSPL2 固件支持系统时间变量。

常用于：

• 生产日期
• 有效期
• 批次日期

日期变量

格式：

DATE
TIME

示例

TEXT 50,50,"3",0,1,1,"DATE"

TEXT 150,50,"3",0,1,1,"DATE"

注意

不同型号对日期变量支持不同。

如果打印机不支持：

推荐：

由上位机生成日期：

例如：

程序生成：

2026-08-05

然后发送：

TEXT 50,50,"3",0,1,1,"2026-08-05"

8. 变量输入

部分 TSPL2 支持 INPUT。

功能

从外部设备输入数据。

语法

INPUT variable

应用

例如：

扫描枪输入：

商品条码

然后打印。

9. 键盘输入

部分带屏幕打印机支持 KEY 功能。

应用：

• 人机输入
• 修改参数
• 现场打印

10. 批量打印控制

固定数量打印

PRINT 100

表示：

打印100张。

流水号批量打印

示例：

SIZE 100 mm,50 mm


CLS


SET COUNTER @1 1 1


TEXT 50,50,"3",0,1,1,"BOX NO:"


COUNTER 180,50,"3",0,1,1,@1


PRINT 50

结果：

BOX NO:1

BOX NO:2

...

BOX NO:50

11. 条码流水号

示例：

生成：

000001

000002

000003

代码：

SIZE 100 mm,50 mm


CLS


SET COUNTER @1 1 1


BARCODE 50,100,"128",80,1,0,2,2,@1


PRINT 100

12. 二维码流水号

示例：

SIZE 100 mm,50 mm


CLS


SET COUNTER @1 1 1


TEXT 50,30,"3",0,1,1,"SN"


QRCODE 50,80,L,5,A,0,@1


PRINT 100

13. 动态标签模板

工业常用结构：

固定内容

+

变量

+

流水号

+

条码

+

二维码

示例：

SIZE 100 mm,60 mm

GAP 3 mm,0


CLS


TEXT 30,30,"3",0,1,1,"产品编号"


TEXT 150,30,"3",0,1,1,"A100"


TEXT 30,80,"3",0,1,1,"SN:"


COUNTER 100,80,"3",0,1,1,@1


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


QRCODE 300,80,L,5,A,0,@1


PRINT 100

14. 开发建议

推荐方式

生产系统中：

数据库

↓

生成TSPL

↓

发送打印机

↓

查询状态

↓

记录结果

不要完全依赖打印机内部变量：

原因：

• 不同型号支持不同
• 固件版本差异
• 调试困难

15. 常见应用

快递面单

使用：

• TEXT
• BARCODE
• QRCODE

工厂追溯标签

使用：

• COUNTER
• QRCode
• 条码

仓库标签

使用：

• 产品编号
• 批次
• 日期
• 数量

Part 5 完

下一部分：

Part 6 - RFID 指令、扩展功能、特殊命令

包含：

• RFID READ
• RFID WRITE
• RFID ERASE
• EPC写入
• UHF标签打印
• Peel模式
• Cutter模式
• Tear模式
• 自动校准
• 高级SET参数