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

Part 11 - 工业应用案例合集

目录

• 1. 工业标签系统架构
• 2. 仓库物流标签
• 3. 快递面单
• 4. 生产追溯标签
• 5. 医疗标签
• 6. RFID标签应用
• 7. 自动贴标机
• 8. PLC联动打印
• 9. MES系统集成
• 10. 批量打印系统设计

1. 工业标签系统架构

一个完整工业打印系统通常：

业务系统

↓

数据库

↓

打印服务

↓

TSPL生成模块

↓

打印机

↓

状态反馈

2. 仓库物流标签

应用场景

用于：

• SKU管理
• 库位管理
• 入库标签
• 出库标签

标签内容

通常包含：

商品名称

SKU

批次

数量

条码

二维码

示例

SIZE 100 mm,70 mm

GAP 3 mm,0


CLS


TEXT 30,30,"3",0,2,2,"仓库标签"


TEXT 30,80,"3",0,1,1,"SKU:A10001"


TEXT 30,120,"3",0,1,1,"QTY:500"


BARCODE 30,170,"128",70,1,0,2,2,"A10001"


QRCODE 350,120,L,5,A,0,"A10001"


PRINT 1

3. 快递面单

应用场景

包括：

• 收件信息
• 运单号
• 条码
• 二维码

典型结构

+-----------------------+

寄件信息

收件信息


=======================


条码


二维码


+-----------------------+

示例

SIZE 100 mm,150 mm


GAP 3 mm,0


CLS


TEXT 30,30,"3",0,2,2,"快递面单"


BLOCK 30,80,400,100,"3",0,1,1,"收件人:张三 地址:上海"


BARCODE 30,220,"128",100,1,0,2,2,"SF123456789"


QRCODE 300,220,L,5,A,0,"SF123456789"


PRINT 1

4. 生产追溯标签

应用场景

制造业：

• 零件追踪
• 产品序列号
• 工序记录

数据结构

产品编号

↓

生产批次

↓

流水号

↓

二维码

↓

数据库绑定

示例

SIZE 80 mm,50 mm


GAP 3 mm,0


CLS


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


TEXT 20,60,"3",0,1,1,"LOT:20260805"


BARCODE 20,100,"128",60,1,0,2,2,"SN000001"


QRCODE 250,100,L,5,A,0,"SN000001"


PRINT 1

5. 医疗标签

应用场景

例如：

• 样本标签
• 试管标签
• 药品标签

特点

要求：

• 小尺寸
• 高可靠条码
• 清晰打印

示例

SIZE 50 mm,30 mm


GAP 2 mm,0


CLS


TEXT 10,10,"2",0,1,1,"SAMPLE"


BARCODE 10,50,"128",40,1,0,2,2,"20260805001"


PRINT 1

6. RFID标签应用

应用流程

读取任务

↓

写EPC

↓

验证

↓

打印表面信息

↓

输出

示例

SIZE 100 mm,50 mm


CLS


RFID WRITE 0,12,"PRODUCT001"


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


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


PRINT 1

7. 自动贴标机

系统结构

PLC

↓

打印机

↓

剥标模块

↓

机械手

↓

产品

打印模式

开启：

SET PEEL ON

示例

SIZE 100 mm,50 mm


SET PEEL ON


CLS


TEXT 30,30,"3",0,2,2,"AUTO LABEL"


PRINT 1

8. PLC联动打印

通讯方式

常见：

• RS232
• Ethernet
• TCP Socket

流程

PLC触发

↓

发送产品数据

↓

生成TSPL

↓

打印

↓

返回状态

示例数据

PLC发送：

MODEL=A100
SN=000001

生成：

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


TEXT 30,70,"3",0,1,1,"000001"


PRINT 1

9. MES系统集成

MES结构

MES

↓

打印接口服务

↓

TSPL模板

↓

打印机

推荐设计

数据库保存：

模板编号

↓

字段映射

↓

TSPL生成

示例模板

模板：

产品:{PRODUCT}

批次:{LOT}

SN:{SERIAL}

生成：

TEXT 50,50,"3",0,1,1,"产品:A001"

TEXT 50,90,"3",0,1,1,"批次:B001"

TEXT 50,130,"3",0,1,1,"SN:00001"

10. 批量打印系统设计

推荐架构

任务队列

↓

打印服务

↓

打印机池

↓

状态监控

打印队列数据

示例：

{
 "printer":"192.168.1.100",
 "template":"product_label",
 "qty":100,
 "data":{
   "sku":"A001",
   "batch":"B20260805"
 }
}

11. 多打印机管理

建议：

打印服务器

├── Printer01

├── Printer02

├── Printer03

管理：

• IP
• 型号
• 状态
• 当前任务

12. 工业现场注意事项

标签材料

根据环境选择：

打印参数

普通：

SPEED 4

DENSITY 8

小字体：

SPEED 3

DENSITY 10

13. 生产稳定性建议

建议加入：

打印前

查询：

~HS

确认：

READY

打印后

记录：

• 标签编号
• 时间
• 操作员
• 打印结果

Part 11 完

下一部分：

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

包含：

• 全指令索引
• 参数快速查询
• 常用模板集合
• 调试清单
• TSPL开发规范

Part 10 - TSPL2 BASIC完整语法参考

目录

• 1. TSPL2 BASIC简介
• 2. 程序结构
• 3. 变量类型
• 4. 变量赋值
• 5. 字符串操作
• 6. 数值运算
• 7. 条件判断
• 8. 循环控制
• 9. 输入功能
• 10. 时间函数
• 11. 打印控制
• 12. 文件操作
• 13. 完整案例

1. TSPL2 BASIC简介

TSPL2部分机型支持内置 BASIC 解释器。

用途：

• 存储打印逻辑
• 独立运行打印任务
• 减少主机压力
• 实现简单自动化

基本结构：

程序启动

↓

变量初始化

↓

读取数据

↓

生成标签

↓

打印

↓

循环等待

2. 程序结构

一个基本TSPL2程序：

REM PROGRAM START


A=100


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


PRINT 1


END

3. 变量类型

TSPL2 BASIC常见变量：

3.1 数字变量

示例：

A=100

B=200

C=A+B

结果：

C=300

3.2 字符串变量

字符串需要：

$

示例：

NAME$="PRODUCT"


TEXT 50,50,"3",0,1,1,NAME$

输出：

PRODUCT

4. 变量赋值

格式：

变量=值

示例：

COUNT=10

字符串：

CODE$="A001"

5. 字符串操作

字符串连接

示例：

A$="SN"

B$="001"


C$=A$+B$

结果：

SN001

STR$

数字转字符串。

示例：

A=100


TEXT 50,50,"3",0,1,1,STR$(A)

打印：

100

VAL

字符串转数字。

示例：

A$="100"


B=VAL(A$)

6. 数值运算

支持：

示例：

A=10

B=5

C=A*B

结果：

50

7. 条件判断

IF

格式：

IF 条件 THEN 语句

示例：

A=10


IF A>5 THEN PRINT 1

多条件

AND：

IF A>0 AND A<100 THEN PRINT 1

OR：

IF A=1 OR A=2 THEN PRINT 1

8. 循环控制

FOR循环

格式：

FOR 变量=开始 TO 结束

...

NEXT

示例：

FOR I=1 TO 10


PRINT 1


NEXT

结果：

打印10次。

WHILE循环

格式：

WHILE 条件

...

WEND

示例：

A=1


WHILE A<10


A=A+1


WEND

9. 输入功能

INPUT

功能：

接收外部输入。

来源：

• 键盘
• 扫描枪
• 外部设备

语法：

INPUT "提示",变量

示例：

INPUT "SN:",SN$

输入：

ABC001

变量：

SN$="ABC001"

10. 时间函数

部分TSPL2支持RTC。

系统变量：

示例：

DATE$=STR$(YEAR)+"-"+STR$(MONTH)


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

11. 打印控制

PRINT

打印：

PRINT 1

FEED

走纸：

FEED

CLS

清缓存：

CLS

PAUSE

暂停：

PAUSE

12. 文件操作

TSPL2支持内部文件。

常见：

OPEN

示例：

OPEN "DATA.TXT"

READ

示例：

READ A$

WRITE

示例：

WRITE "TEST"

CLOSE

示例：

CLOSE

13. 自动打印程序案例

需求

实现：

• 输入产品编号
• 生成二维码
• 打印标签

程序：

REM PRODUCT LABEL


INPUT "PRODUCT:",CODE$


CLS


SIZE 100 mm,50 mm


TEXT 30,30,"3",0,1,1,CODE$


QRCODE 50,80,L,5,A,0,CODE$


BARCODE 250,80,"128",60,1,0,2,2,CODE$


PRINT 1


END

14. 生产线循环打印案例

START:


INPUT "SCAN:",CODE$


CLS


TEXT 50,50,"3",0,1,1,CODE$


PRINT 1


GOTO START

流程：

扫描枪输入

↓

打印

↓

等待下一次扫描

15. TSPL2 BASIC注意事项

不同型号差异

不是所有TSPL打印机都支持：

• BASIC
• 文件操作
• RTC
• INPUT

使用前需要确认固件。

推荐开发方式

复杂系统：

上位机生成TSPL

↓

打印机执行

简单独立设备：

TSPL2 BASIC

Part 10 完

下一部分：

Part 11 - 工业应用案例合集

包含：

• 仓库标签
• 快递面单
• 医疗标签
• 生产追溯标签
• RFID标签
• 自动贴标机
• PLC联动打印
• MES系统集成

Part 9 - TSPL2高级参考

目录

• 1. TSPL2高级功能介绍
• 2. DOWNLOAD程序
• 3. RUN执行程序
• 4. TSPL2 BASIC结构
• 5. 标签自动程序
• 6. GOTO跳转
• 7. IF条件判断
• 8. END结束程序
• 9. REM注释
• 10. 数据文件操作
• 11. RTC时间变量
• 12. 全局变量

1. TSPL2高级功能介绍

TSPL2除了普通标签打印命令外，还支持：

• 内置程序
• 变量
• 条件判断
• 循环
• 文件读写
• 时间读取
• 外部输入

结构类似：

打印指令

+

简单BASIC程序

适合：

• 独立打印工作站
• 无电脑打印
• 自动贴标设备
• 工业产线

2. DOWNLOAD程序

功能

将BASIC程序保存到打印机。

语法

DOWNLOAD "filename.BAS"

示例

DOWNLOAD "AUTO.BAS"

SIZE 100 mm,50 mm

CLS

TEXT 50,50,"3",0,1,1,"HELLO"

PRINT 1

EOP

说明：

DOWNLOAD

开始保存程序。

EOP

表示结束。

3. RUN执行程序

功能

执行打印机内部程序。

语法

RUN "filename.BAS"

示例

RUN "AUTO.BAS"

执行流程：

PC

↓

DOWNLOAD程序

↓

保存FLASH

↓

RUN

↓

打印机独立运行

4. TSPL2 BASIC结构

一个程序：

变量定义

↓

逻辑判断

↓

打印内容

↓

循环

示例：

A=100

TEXT 50,50,"3",0,1,1,STR$(A)

PRINT 1

5. 标签自动程序

典型AUTO.BAS：

DOWNLOAD "AUTO.BAS"


SIZE 100 mm,50 mm

GAP 3 mm,0


CLS


TEXT 50,50,"3",0,1,1,"AUTO PRINT"


PRINT 1


EOP

启动后：

打印机自动执行。

6. GOTO

功能

程序跳转。

语法

GOTO label

示例

START:


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

GOTO START

结果：

无限循环打印。

7. IF条件判断

功能

条件执行。

语法

IF condition THEN command

示例

A=10


IF A>5 THEN GOTO OK


OK:

TEXT 50,50,"3",0,1,1,"YES"

支持：

>

<

=

>=

<=

<>

8. END

功能

结束程序。

语法：

END

示例：

IF A=10 THEN END

9. REM

功能

注释。

语法：

REM comment

示例：

REM 打印产品标签

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

10. 数据文件操作

TSPL2支持：

• OPEN
• READ
• WRITE
• EOF
• LOF
• SEEK

用于：

• 本地数据
• 配置文件
• 编号保存

WRITE

写入文件。

语法：

WRITE handle,data

READ

读取文件。

语法：

READ handle,data

示例：

WRITE 0,A$

READ 0,B$

11. RTC时间变量

部分打印机支持RTC。

可读取：

TSPL2手册中将这些作为打印机内部变量使用。 oai_citation:1‡manualzz.com

示例

TEXT 50,50,"3",0,1,1,STR$(YEAR)

TEXT 50,100,"3",0,1,1,STR$(MONTH)

PRINT 1

输出：

2026
08

12. 全局变量

部分TSPL2支持：

@LABEL

用于统计打印数量。

示例：

A=@LABEL


TEXT 50,50,"3",0,1,1,STR$(A)


PRINT 1

13. 自动编号程序示例

DOWNLOAD "AUTO.BAS"


SIZE 100 mm,50 mm


SET COUNTER @1 1 1


CLS


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


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


PRINT 1


EOP

14. 独立打印系统结构

打印机FLASH

↓

AUTO.BAS

↓

读取输入

↓

生成标签

↓

打印

↓

等待下一次输入

15. 工业应用场景

生产线

PLC

↓

发送数据

↓

打印机变量

↓

打印标签

仓库

扫描枪

↓

INPUT

↓

打印SKU标签

追溯系统

数据库

↓

下载任务

↓

打印机执行

Part 9 完

下一部分：

Part 10 - TSPL2 BASIC完整语法参考

包含：

• 变量类型
• 字符串操作
• 数学函数
• 日期函数
• INPUT输入
• PRINT流程控制
• 文件读写完整示例

Part 8 - TSPL命令完整速查表

目录

• 1. TSPL命令分类
• 2. A-Z指令列表
• 3. 设置类命令
• 4. 绘图类命令
• 5. 条码类命令
• 6. 文件类命令
• 7. 查询类命令
• 8. 模式类命令
• 9. 常用组合模板

1. TSPL命令分类

TSPL命令主要分为：

2. TSPL A-Z指令列表

3. 设置类命令速查

SIZE

设置标签尺寸：

SIZE width,height

示例：

SIZE 100 mm,50 mm

GAP

设置间隙：

GAP gap,offset

示例：

GAP 3 mm,0

BLINE

黑标：

BLINE height,offset

SPEED

速度：

SPEED value

DENSITY

浓度：

DENSITY value

DIRECTION

方向：

DIRECTION 0

REFERENCE

坐标：

REFERENCE x,y

OFFSET

偏移：

OFFSET value

CODEPAGE

编码：

CODEPAGE 936

4. 文字命令速查

TEXT

单行文字：

TEXT x,y,font,rotation,x,y,"text"

示例：

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

BLOCK

多行文字：

BLOCK x,y,w,h,font,r,xm,ym,"text"

示例：

BLOCK 20,20,300,100,"3",0,1,1,"ADDRESS"

5. 图形命令速查

BAR

线：

BAR x,y,width,height

BOX

矩形：

BOX x1,y1,x2,y2,width

ELLIPSE

椭圆：

ELLIPSE x1,y1,x2,y2,width

REVERSE

反白：

REVERSE x,y,w,h

6. 条码命令速查

BARCODE

格式：

BARCODE x,y,type,height,human,rotation,narrow,wide,"data"

支持：

QRCODE

格式：

QRCODE x,y,ECC,size,mode,rotation,"data"

PDF417

格式：

PDF417 x,y,w,h,r,o,"data"

DMATRIX

格式：

DMATRIX x,y,"data"

7. 文件命令速查

DOWNLOAD

下载：

DOWNLOAD "file"

FILES

查看：

FILES

REMOVE

删除：

REMOVE "file"

MOVE

移动：

MOVE "old","new"

RUN

执行：

RUN "file"

8. 控制命令速查

CLS

清缓存：

CLS

PRINT

打印：

PRINT quantity

FEED

走纸：

FEED

FORMFEED

找标签：

FORMFEED

PAUSE

暂停：

PAUSE

RESET

重启：

RESET

9. 模式命令

撕纸

SET TEAR ON

剥离

SET PEEL ON

切刀

SET CUTTER ON

回卷

SET REWIND ON

10. 状态查询速查

查询状态：

~!T

查询配置：

~!U

查询信息：

~!A

状态：

~HS

11. 最常用标签模板

商品标签

SIZE 100 mm,50 mm

GAP 3 mm,0

CLS

TEXT 30,30,"3",0,2,2,"PRODUCT"

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

QRCODE 300,100,L,5,A,0,"123456"

PRINT 1

仓库标签

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",60,1,0,2,2,"A001"

PRINT 1

12. 开发检查清单

打印异常排查：

□ SIZE正确

□ GAP/BLINE正确

□ CODEPAGE正确

□ 字体支持中文

□ 坐标范围正确

□ SPEED合理

□ DENSITY合理

□ 状态正常

□ 标签方向正确

Part 8 完

下一部分：

Part 9 - TSPL2高级参考

包含：

• TSPL2扩展指令
• 内置脚本
• 自动执行
• 变量系统
• FORM命令
• 标签模板存储
• 工业生产线应用案例

Part 7 - 开发实例与工程实践

目录

• 1. TSPL开发流程
• 2. 标签坐标设计
• 3. DPI与坐标换算
• 4. C#打印示例
• 5. Java打印示例
• 6. Python TCP打印示例
• 7. USB打印示例
• 8. 标签模板设计
• 9. 常见问题排查

1. TSPL开发流程

一个完整打印系统通常流程：

业务系统

↓

生成TSPL字符串

↓

发送打印机

↓

打印机执行

↓

查询状态

↓

记录结果

2. 标签坐标设计

TSPL采用点坐标。

坐标原点：

(0,0)

位于：

标签左上角

示例：

+----------------------+
|                      |
| (50,50)              |
|    TEXT              |
|                      |
+----------------------+

3. DPI与坐标换算

打印机常见分辨率：

203 DPI换算

公式：

dots = mm × 8

示例：

10mm：

10 × 8 = 80 dots

300 DPI换算

公式：

dots = mm × 12

示例：

10mm：

10 × 12 = 120 dots

4. C#打印示例

TCP/IP发送TSPL

using System;
using System.Net.Sockets;
using System.Text;


public class TsplPrinter
{
    public static void Print(string ip,int port)
    {
        string tspl =
@"SIZE 100 mm,50 mm

GAP 3 mm,0

CLS

TEXT 50,50,""3"",0,2,2,""TEST LABEL""

BARCODE 50,120,""128"",60,1,0,2,2,""123456""

PRINT 1";


        using(TcpClient client = new TcpClient())
        {
            client.Connect(ip,port);

            NetworkStream stream = client.GetStream();

            byte[] data =
                Encoding.UTF8.GetBytes(tspl);

            stream.Write(data,0,data.Length);
        }
    }
}

调用：

TsplPrinter.Print(
    "192.168.1.100",
    9100
);

5. Java打印示例

import java.net.Socket;


public class TsplPrinter {

    public static void print()
        throws Exception {


        String tspl =
        "SIZE 100 mm,50 mm\n"+
        "CLS\n"+
        "TEXT 50,50,\"3\",0,2,2,\"JAVA TEST\"\n"+
        "PRINT 1";


        Socket socket =
            new Socket(
                "192.168.1.100",
                9100
            );


        socket.getOutputStream()
              .write(
                tspl.getBytes("UTF-8")
              );


        socket.close();
    }
}

6. Python TCP打印示例

import socket


printer_ip = "192.168.1.100"
printer_port = 9100


tspl = """
SIZE 100 mm,50 mm

CLS

TEXT 50,50,"3",0,2,2,"PYTHON TEST"

PRINT 1
"""


sock = socket.socket(
    socket.AF_INET,
    socket.SOCK_STREAM
)


sock.connect(
    (
        printer_ip,
        printer_port
    )
)


sock.send(
    tspl.encode("utf-8")
)


sock.close()

7. USB打印示例

Windows环境：

通常通过：

• Windows打印队列
• Raw打印

发送：

RAW TSPL DATA

示例：

SIZE 100 mm,50 mm
CLS
TEXT 50,50,"3",0,1,1,"USB PRINT"
PRINT 1

8. 标签模板设计

推荐模板结构：

固定区域

+

动态数据

+

条码

+

二维码

+

图片

例如：

商品标签：

+----------------------+

商品名称

型号

批次

条码

二维码

+----------------------+

9. 标准商品标签模板

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"


TEXT 30,120,"3",0,1,1,"BATCH:20260805"


BARCODE 30,170,"128",60,1,0,2,2,"123456789"


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


PRINT 1

10. 快递面单示例

SIZE 100 mm,150 mm

GAP 3 mm,0


CLS


TEXT 30,30,"3",0,2,2,"快递单"


BARCODE 50,100,"128",100,1,0,2,2,"SF123456789"


QRCODE 300,100,L,5,A,0,"SF123456789"


BLOCK 30,250,400,100,"3",0,1,1,"收件地址信息"


PRINT 1

11. 常见问题排查

问题1：中文乱码

原因：

• 编码错误
• 字体不支持

解决：

设置：

CODEPAGE 936

或者：

使用：

TSS24.BF2

问题2：打印位置偏移

检查：

REFERENCE

OFFSET

SHIFT

问题3：标签跑偏

检查：

GAP

BLINE

AUTODETECT

执行：

GAPDETECT

问题4：条码扫描失败

检查：

• 条码高度
• 密度
• 打印速度

建议：

SPEED 3

DENSITY 8

问题5：二维码太小

调整：

QRCODE

cell-size

例如：

QRCODE 50,50,L,8,A,0,"TEST"

12. 工业项目建议

生产环境建议：

打印前

查询：

~HS

确认：

READY

打印后

记录：

• 标签编号
• 时间
• 打印状态
• 操作员

13. 推荐架构

Web系统

↓

打印服务

↓

TSPL生成器

↓

打印队列

↓

打印机

↓

状态监控

Part 7 完

下一部分：

Part 8 - TSPL完整命令速查表

包含：

• A-Z全部命令列表
• 参数速查
• 支持机型说明
• 常用组合模板
• 实际生产调试清单

Part 6 - RFID 指令、高级模式、特殊控制命令

目录

• 1. RFID功能概述
• 2. RFID模块基础
• 3. RFID WRITE
• 4. RFID READ
• 5. RFID ERASE
• 6. RFID BLOCKWRITE
• 7. RFID LOCK
• 8. RFID打印流程
• 9. Peel剥离模式
• 10. Tear撕纸模式
• 11. Cutter切刀模式
• 12. Rewind回卷模式
• 13. 自动校准
• 14. 高级SET参数

1. RFID功能概述

TSPL2 支持部分 RFID 标签打印机。

例如：

• TSC TTP系列 RFID机型
• MH系列 RFID机型
• UHF RFID打印机

RFID标签打印流程：

定位标签

↓

写入RFID芯片

↓

打印表面内容

↓

输出标签

2. RFID模块基础

RFID标签通常包含：

3. RFID WRITE

功能

向RFID标签写入数据。

语法

RFID WRITE address,length,data

参数

示例

RFID WRITE 0,6,"123456"

4. RFID READ

功能

读取RFID标签数据。

语法

RFID READ address,length

示例

RFID READ 0,6

返回：

RFID DATA

5. RFID ERASE

功能

擦除RFID数据。

语法

RFID ERASE

应用

用于：

• 标签重新利用
• 测试标签

6. RFID BLOCKWRITE

功能

块写入。

适用于：

• UHF EPC标签
• 大数据区域

语法

RFID BLOCKWRITE block,data

示例

RFID BLOCKWRITE 1,"ABCDE"

7. RFID LOCK

功能

锁定RFID区域。

语法

RFID LOCK area,password

应用

防止：

• EPC修改
• 数据篡改

8. RFID完整打印流程

典型RFID标签：

创建标签

↓

定位RFID

↓

写入芯片

↓

打印文字

↓

打印条码

↓

输出

示例：

SIZE 100 mm,50 mm

GAP 3 mm,0


CLS


RFID WRITE 0,6,"ABC123"


TEXT 50,50,"3",0,1,1,"RFID TAG"


BARCODE 50,120,"128",60,1,0,2,2,"ABC123"


PRINT 1

9. SET PEEL

功能

开启剥离模式。

用于：

• 自动剥标
• 贴标机

开启

SET PEEL ON

关闭：

SET PEEL OFF

工作流程

打印

↓

标签分离

↓

等待取走

↓

继续打印

10. SET TEAR

功能

开启撕纸模式。

开启

SET TEAR ON

关闭：

SET TEAR OFF

11. SET CUTTER

功能

开启切刀模式。

开启

SET CUTTER ON

关闭：

SET CUTTER OFF

应用

适用于：

• 收据
• 票据
• 连续纸

12. SET REWIND

功能

开启回卷模式。

示例

SET REWIND ON

应用

用于：

• 大批量标签
• 后加工

13. 自动校准

GAPDETECT

功能：

自动检测标签间距。

语法：

GAPDETECT

BLINEDETECT

功能：

自动检测黑标。

语法：

BLINEDETECT

AUTODETECT

功能：

自动识别标签类型。

语法：

AUTODETECT

14. 高级SET参数

SET用于控制打印机特殊功能。

打印头温度

示例：

SET HEAT 10

撕纸位置

SET TEAR ON

剥离模式

SET PEEL ON

切刀模式

SET CUTTER ON

蜂鸣器

部分型号支持：

SET SOUND ON

15. PAUSE控制

暂停：

PAUSE

恢复：

按：

FEED

16. RESET高级使用

功能

恢复打印机状态。

指令

RESET

注意

RESET会：

• 清除缓存
• 停止当前任务
• 恢复默认状态

17. 工业应用示例

RFID仓储标签

SIZE 100 mm,80 mm

GAP 3 mm,0


CLS


RFID WRITE 0,12,"PRODUCT001"


TEXT 50,50,"3",0,2,2,"PRODUCT001"


QRCODE 50,150,L,5,A,0,"PRODUCT001"


BARCODE 250,150,"128",80,1,0,2,2,"PRODUCT001"


PRINT 1

18. 自动贴标机模式

SIZE 100 mm,50 mm


SET PEEL ON


CLS


TEXT 50,50,"3",0,1,1,"LABEL"


PRINT 1

19. 模式选择建议

Part 6 完

下一部分：

Part 7 - 完整开发实例

包含：

• TSPL模板设计方法
• C#打印类封装
• Java打印示例
• Python Socket打印
• USB发送
• TCP/IP发送
• 标签尺寸换算
• DPI计算
• 常见问题排查

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参数

Part 4 - 状态查询、通讯协议、打印机控制

目录

• 1. 状态查询概述
• 2. ~!T 打印机状态查询
• 3. ~!U 配置查询
• 4. ~!A 信息查询
• 5. ~HS 状态返回
• 6. 状态码解析
• 7. USB通讯
• 8. 串口通讯
• 9. TCP/IP网络通讯
• 10. 错误处理流程

1. 状态查询概述

TSPL 打印机支持通过发送查询指令获取设备状态。

常用于：

• 判断是否缺纸
• 判断是否开盖
• 获取打印机型号
• 获取剩余空间
• 自动化打印系统监控

通讯方式：

• USB
• RS232
• Ethernet
• Bluetooth

2. ~!T

功能

查询打印机基本状态。

指令

~!T

返回示例

PRINTER STATUS
READY

应用

发送：

~!T

读取：

READY

表示：

打印机正常，可以打印。

3. ~!U

功能

查询打印机配置。

指令

~!U

返回内容通常包括

MODEL
FIRMWARE
DPI
MEMORY
SPEED
DENSITY

例如：

MODEL:TTP-244 Pro
DPI:203
SPEED:4
DENSITY:8

4. ~!A

功能

查询打印机信息。

指令

~!A

返回信息

可能包含：

• 产品型号
• 固件版本
• 序列号
• 内存容量

5. ~HS

功能

获取实时打印状态。

这是开发中最常使用的状态指令之一。

指令

~HS

返回示例

00000000

不同型号返回格式略有区别。

6. 状态码解析

TSPL状态通常包含：

常见异常

缺纸

状态：

Paper Out

处理：

1. 放入标签纸
2. 执行：

FORMFEED

3. 继续打印

打印头打开

状态：

Head Open

处理：

关闭打印头。

暂停

状态：

Pause

恢复：

按打印机面板 FEED 键。

7. USB通讯

方式

USB通常作为虚拟打印设备。

系统：

Windows：

USB Printer

Linux：

/dev/usb/lp0

发送方式

直接发送 TSPL 字符串。

例如：

SIZE 100 mm,50 mm
CLS
TEXT 50,50,"3",0,1,1,"TEST"
PRINT 1

C# 示例

string tspl =
@"SIZE 100 mm,50 mm
CLS
TEXT 50,50,""3"",0,1,1,""TEST""
PRINT 1";


SendToPrinter(tspl);

8. RS232 串口通讯

常见参数

通常：

9600 8N1

示例发送

发送字符串：

CLS

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

PRINT 1

9. TCP/IP 网络通讯

默认端口

通常：

9100

通讯流程

连接：

Printer IP:9100

发送：

TSPL指令

关闭连接。

示例

连接：

192.168.1.100:9100

发送：

SIZE 100 mm,50 mm

CLS

TEXT 50,50,"3",0,1,1,"NETWORK PRINT"

PRINT 1

10. 错误处理流程

推荐开发流程：

发送打印任务

↓

查询状态

↓

判断结果

↓

继续/提示用户

示例逻辑

伪代码：

send PRINT

wait

send ~HS

if READY:

    continue

else:

    show error

11. 自动打印系统建议

工业环境：

推荐流程：

连接打印机

↓

查询状态

↓

发送标签

↓

等待完成

↓

再次查询状态

↓

记录日志

12. 打印队列管理

建议：

每张标签：

CLS

绘制内容

PRINT 1

查询状态

避免：

• 数据残留
• 标签错乱
• 缓存溢出

13. 常用调试指令合集

查看状态：

~!T

查看配置：

~!U

查看文件：

FILES

清缓存：

CLS

恢复：

RESET

14. 综合通讯测试标签

SIZE 100 mm,50 mm

GAP 3 mm,0

DIRECTION 0

SPEED 4

DENSITY 8

CLS


TEXT 50,50,"3",0,2,2,"TSPL TEST"


BARCODE 50,120,"128",80,1,0,2,2,"123456"


PRINT 1

Part 4 完

下一部分：

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

包含：

• COUNTER
• SET COUNTER
• SERIAL
• 日期时间打印
• 动态变量
• 键盘输入
• 自动编号标签
• 批量打印控制

Part 3 - 图片、字体、文件系统指令

目录

• 1. BITMAP
• 2. PUTBMP
• 3. PUTPCX
• 4. DOWNLOAD
• 5. EOP
• 6. FILES
• 7. REMOVE
• 8. MOVE
• 9. RUN
• 10. MEMORY
• 11. 字体下载流程
• 12. 图片下载流程

1. BITMAP

功能

打印位图数据。

主要用于：

• 程序生成图片
• 动态打印 Logo
• 打印自定义图形

语法

BITMAP x,y,width,height,mode,data

参数

示例

BITMAP 50,50,100,100,0,<bitmap data>

注意

BITMAP 通常用于：

• SDK直接生成数据
• 二进制发送

不适合人工编写。

2. PUTBMP

功能

打印已经存储在打印机中的 BMP 图片。

语法

PUTBMP x,y,"filename"

参数

示例

PUTBMP 50,50,"LOGO.BMP"

使用流程

步骤：

1. 下载图片

DOWNLOAD "LOGO.BMP"

2. 打印图片

PUTBMP 50,50,"LOGO.BMP"

3. PUTPCX

功能

打印 PCX 格式图片。

语法

PUTPCX x,y,"filename"

示例

PUTPCX 100,100,"IMAGE.PCX"

说明

PCX 是 TSPL 早期常用格式。

优点：

• 文件小
• 打印速度快

4. DOWNLOAD

功能

下载文件到打印机存储。

支持：

• 图片
• 字体
• 格式文件

语法

DOWNLOAD "filename"

示例

下载 Logo：

DOWNLOAD "LOGO.BMP"

下载流程

PC发送：

DOWNLOAD "LOGO.BMP"

然后：

二进制文件内容

最后：

EOP

5. EOP

功能

表示文件传输结束。

语法

EOP

示例流程

DOWNLOAD "LOGO.BMP"

<binary data>

EOP

6. FILES

功能

查看打印机存储文件。

语法

FILES

示例

发送：

FILES

返回：

LOGO.BMP
FONT.BF2
LABEL.BAS

用途

用于：

• 查看下载文件
• 调试存储空间

7. REMOVE

功能

删除打印机文件。

语法

REMOVE "filename"

示例

删除图片：

REMOVE "LOGO.BMP"

删除字体

REMOVE "FONT.BF2"

8. MOVE

功能

移动文件。

语法

MOVE "source","destination"

示例

MOVE "A.BMP","B.BMP"

9. RUN

功能

执行存储在打印机中的程序。

语法

RUN "filename"

示例

RUN "TEST.BAS"

应用

用于：

• 自动打印程序
• 内置脚本
• 快速调用模板

10. MEMORY

功能

查看存储空间。

查询：

~!T

或者：

FILES

常见存储区域

11. 字体下载

支持字体

TSPL 支持：

• TTF字体
• TSC字体
• BF字体

下载流程

第一步

发送：

DOWNLOAD "FONT.TTF"

第二步

发送字体二进制数据。

第三步

结束：

EOP

使用字体

示例：

TEXT 50,50,"FONT.TTF",0,1,1,"测试文字"

12. 图片下载流程

示例：下载Logo

发送：

DOWNLOAD "LOGO.BMP"

发送：

BMP二进制数据

结束：

EOP

打印：

PUTBMP 50,50,"LOGO.BMP"

13. 标签模板存储

部分TSPL2打印机支持保存标签模板。

流程：

保存

DOWNLOAD "LABEL.BAS"

执行

RUN "LABEL.BAS"

14. 实际应用示例

Logo + 文字 + 条码

SIZE 100 mm,50 mm

GAP 3 mm,0

CLS


PUTBMP 20,20,"LOGO.BMP"


TEXT 150,40,"3",0,2,2,"商品标签"


BARCODE 150,100,"128",60,1,0,2,2,"123456789"


PRINT 1

15. 文件管理完整流程

查看文件

FILES

删除文件

REMOVE "LOGO.BMP"

下载文件

DOWNLOAD "LOGO.BMP"

打印文件

PUTBMP 0,0,"LOGO.BMP"

Part 3 完

下一部分：

Part 4 - 状态查询、通讯协议、打印机控制

包含：

• ~!T
• ~!U
• ~!A
• ~HS
• 状态返回解析
• USB通讯
• 串口通讯
• TCP/IP通讯
• 打印错误处理