TSPL 指令

TSPL (TSC Printer Language) 是 TSC 公司开发的标签打印机指令语言，广泛应用于标签条码打印机。

概述

TSPL 与 CPCL 类似，都是文本形式的指令语言。主要区别在于 TSPL 使用逗号分隔参数。

语法特点

特性	CPCL	TSPL
参数分隔	空格	逗号
字符串	双引号	双引号
单位	dot	mm 或 dot

编码说明

页面设置指令

标签尺寸 (SIZE)

设置标签纸的宽度和高度。

SIZE 宽度 mm,高度 mm
SIZE 宽度 mm,高度 mm,份数

参数	说明	单位
宽度	标签纸宽度	mm
高度	标签纸高度	mm
份数	打印份数（可选）	-

示例：

SIZE 60 mm,40 mm
SIZE 80 mm,50 mm,2

缝隙/间隙 (GAP)

设置两张标签纸之间的间隙。

GAP 间隙高度 mm,偏移量 mm

参数	说明	单位
间隙高度	标签间隙高度	mm
偏移量	垂直偏移量	mm

示例：

GAP 3 mm,0

黑标纸 (BLINE)

设置黑标纸模式。

BLINE 高度 mm,偏移量 mm

连续纸 (CONTINUOUS)

设置连续纸模式（无间隙）。

CONTINUOUS

标签纸模式 (LABEL)

设置标签纸打印模式。

LABEL

打印方向 (DIRECTION)

设置打印方向和镜像。

DIRECTION 方向,镜像

参数	值	说明
方向	0	正向出纸
方向	1	反向出纸
镜像	0	不镜像
镜像	1	镜像打印

示例：

DIRECTION 1,0

清除缓冲区 (CLS)

清除图像缓冲区。

CLS

打印浓度 (DENSITY)

设置打印浓度。

DENSITY 浓度值

参数	范围	说明
浓度值	0-15	0 最浅，15 最深

示例：

DENSITY 8

打印速度 (SPEED)

设置打印速度。

SPEED 速度值

参数	范围	说明
速度值	1-6	建议 3-4

示例：

SPEED 4

坐标偏移 (REFERENCE)

设置坐标原点偏移。

REFERENCE 水平偏移,垂直偏移

示例：

REFERENCE 10,10

进纸偏移 (OFFSET)

设置进纸偏移量。

OFFSET 偏移量 mm

垂直偏移 (SHIFT)

设置打印内容的垂直偏移。

SHIFT 偏移量

文本打印指令

文本 (TEXT)

打印文本内容。

TEXT X,Y,"字体",旋转,X放大,Y放大,"内容"
TEXT X,Y,"字体",旋转,X放大,Y放大,对齐,"内容"

参数	说明
X	文本起始 X 坐标（dot）
Y	文本起始 Y 坐标（dot）
字体	字体名称
旋转	旋转角度（0/90/180/270）
X放大	水平放大倍数（1-8）
Y放大	垂直放大倍数（1-8）
对齐	对齐方式（可选）
内容	要打印的文本

可用字体

字体名称	点阵大小	说明
TSS12.BF2	12	12点阵字体
TSS16.BF2	16	16点阵字体
TSS20.BF2	20	20点阵字体
TSS24.BF2	24	24点阵字体（推荐）
TSS28.BF2	28	28点阵字体
TSS32.BF2	32	32点阵字体
1	-	8x12 英文字体
2	-	12x20 英文字体
3	-	16x24 英文字体
4	-	24x32 英文字体
5	-	32x48 英文字体

旋转角度

值	角度
0	0°
90	90°
180	180°
270	270°

对齐方式

值	说明
0	默认（左对齐）
1	左对齐
2	居中
3	右对齐

示例：

TEXT 50,50,"TSS24.BF2",0,1,1,"产品名称"
TEXT 50,100,"TSS24.BF2",0,2,2,"放大两倍"
TEXT 50,200,"3",0,1,1,"English Text"
TEXT 50,250,"TSS24.BF2",0,1,1,2,"居中文本"

加粗文本

在字体参数后添加 B1 表示加粗。

TEXT X,Y,"字体",旋转,X放大,Y放大,B1,"内容"

文本框 (BLOCK)

打印文本段落，支持自动换行。

BLOCK X,Y,宽度,高度,"字体",旋转,X放大,Y放大,"内容"

参数	说明
宽度	文本框宽度
高度	文本框高度

示例：

BLOCK 50,50,400,200,"TSS24.BF2",0,1,1,"这是一段很长的文本，会自动换行显示在文本框内。"

条码打印指令

一维条码 (BARCODE)

打印一维条码。

BARCODE X,Y,"类型",高度,可读,旋转,窄条,宽条,"内容"

参数	说明
X	条码起始 X 坐标
Y	条码起始 Y 坐标
类型	条码类型
高度	条码高度（dot）
可读	是否显示可读文字（0=不显示，1=显示）
旋转	旋转角度（0/90/180/270）
窄条	窄条宽度（1-10）
宽条	宽条宽度（窄条×比率）
内容	条码数据

支持的条码类型

类型	说明
128	Code 128（推荐）
128M	Code 128 子集
39	Code 39
93	Code 93
ITF	Interleaved 2 of 5
UPCA	UPC-A
UPCE	UPC-E
EAN8	EAN-8
EAN13	EAN-13
CODABAR	Codabar
POST	Postnet
CPOST	China Post

示例：

BARCODE 50,200,"128",80,1,0,2,4,"ABC123456"
BARCODE 50,350,"EAN13",60,1,0,2,4,"6901234567890"

二维码打印指令

QR Code (QRCODE)

打印二维码。

QRCODE X,Y,纠错级别,单元宽度,模式,旋转,M2,S7,"内容"

参数	说明
X	二维码起始 X 坐标
Y	二维码起始 Y 坐标
纠错级别	L/M/Q/H
单元宽度	单元格宽度（1-10）
模式	A=自动
旋转	旋转角度（0/90/180/270）

纠错级别

级别	纠错能力
L	7%
M	15%
Q	25%
H	30%

示例：

QRCODE 300,50,H,4,A,0,M2,S7,"https://example.com"
QRCODE 50,50,M,6,A,0,"产品编号:12345"

DataMatrix (DMATRIX)

打印 DataMatrix 二维码。

DMATRIX X,Y,宽度,高度,模式,"内容"

示例：

DMATRIX 50,50,400,400,x8,"DataMatrix Content"

图形绘制指令

填充矩形 (BAR)

绘制填充的矩形（只能画横竖线条）。

BAR X,Y,宽度,高度

参数	说明
X	左上角 X 坐标
Y	左上角 Y 坐标
宽度	矩形宽度
高度	矩形高度

示例：

BAR 30,100,420,2
BAR 50,50,200,100

矩形边框 (BOX)

绘制空心矩形边框。

BOX X,Y,X_end,Y_end,线宽
BOX X,Y,X_end,Y_end,线宽,圆角

参数	说明
X	左上角 X 坐标
Y	左上角 Y 坐标
X_end	右下角 X 坐标
Y_end	右下角 Y 坐标
线宽	边框线宽
圆角	圆角半径（可选）

示例：

BOX 20,20,500,400,2
BOX 50,50,300,200,3,10

斜线 (DIAGONAL)

绘制斜线。

DIAGONAL X,Y,X_end,Y_end,线宽

画线 (LINE)

绘制直线（可画斜线）。

LINE X,Y,X_end,Y_end,线宽

示例：

LINE 50,50,300,200,2

画圆 (CIRCLE)

绘制圆形。

CIRCLE X,Y,直径,线宽

参数	说明
X	圆心 X 坐标
Y	圆心 Y 坐标
直径	圆的直径
线宽	边框线宽

示例：

CIRCLE 200,200,100,2

椭圆 (ELLIPSE)

绘制椭圆。

ELLIPSE X,Y,宽度,高度,线宽

示例：

ELLIPSE 200,200,150,80,2

反色 (REVERSE)

将指定区域反色显示。

REVERSE X,Y,宽度,高度

示例：

REVERSE 50,50,200,100

图片打印指令

位图图片 (BITMAP)

打印位图图片。

BITMAP X,Y,宽度,高度,模式,数据

下载位图到打印机

DOWNLOAD "文件名",数据大小,数据

打印已下载的位图 (PUTBMP)

PUTBMP X,Y,"文件名"

查询指令

查询打印机状态

<ESC>!?

查询 SN 号

~!T

查询电量

~!B

查询固件版本

~!F

查询打印机型号

~!I

获取关机时间

~!@

获取碳带状态

~!C

设置指令

设置关机时间

设置自动关机时间。

SET AUTOOFF 时间

参数	说明
时间	关机时间（分钟），0 表示不自动关机

碳带模式 (RIBBON)

设置热转印/热敏模式。

SET RIBBON ON
SET RIBBON OFF

设置	说明
ON	热转印模式（使用碳带）
OFF	热敏模式

撕纸模式 (TEAR)

设置撕纸模式。

SET TEAR ON
SET TEAR OFF

剥离模式 (PEEL)

设置剥离模式。

SET PEEL ON
SET PEEL OFF

切刀模式 (CUTTER)

设置切刀模式。

SET CUTTER ON
SET CUTTER OFF

编码设置

设置打印机编码。

CODEPAGE GBK
CODEPAGE UTF-8

学习纸张 (DETECT)

自动检测纸张类型和间隙。

DETECT

打印控制指令

打印 (PRINT)

执行打印任务。

PRINT 份数,每份张数
PRINT 份数

参数	说明
份数	打印份数
每份张数	每份打印的张数（可选，默认1）

示例：

PRINT 1
PRINT 3,2

打印自检页 (SELFTEST)

打印打印机自检页。

SELFTEST

完整示例

商品标签

SIZE 60 mm,40 mm
GAP 3 mm,0
DIRECTION 1,0
DENSITY 8
SPEED 4
CLS

TEXT 180,30,"TSS24.BF2",0,2,2,"商品标签"
BAR 30,80,420,2
TEXT 30,100,"TSS24.BF2",0,1,1,"品名: 有机苹果"
TEXT 30,140,"TSS24.BF2",0,1,1,"规格: 500g/袋"
TEXT 30,180,"TSS24.BF2",0,1,1,"产地: 山东烟台"
TEXT 30,220,"TSS24.BF2",0,1,1,B1,"价格: ￥25.90"
BARCODE 80,270,"128",60,1,0,2,4,"6901234567890"
QRCODE 380,100,M,4,A,0,"https://example.com/product"

PRINT 1

物流面单

SIZE 100 mm,150 mm
GAP 3 mm,0
DIRECTION 1,0
CLS

BOX 20,20,780,1180,3
TEXT 300,40,"TSS24.BF2",0,2,2,"快递单"
BAR 20,100,760,3

TEXT 40,130,"TSS24.BF2",0,1,1,"寄件人: 张三"
TEXT 40,170,"TSS24.BF2",0,1,1,"电话: 138****1234"
TEXT 40,210,"TSS24.BF2",0,1,1,"地址: 上海市浦东新区张江高科"
BAR 20,260,760,2

TEXT 40,290,"TSS24.BF2",0,1,1,"收件人: 李四"
TEXT 40,330,"TSS24.BF2",0,1,1,"电话: 139****5678"
BLOCK 40,370,700,120,"TSS24.BF2",0,1,1,"地址: 北京市朝阳区望京SOHO T3 25层"
BAR 20,500,760,3

BARCODE 150,550,"128",100,1,0,3,6,"SF1234567890123"
TEXT 280,680,"TSS24.BF2",0,1,1,"SF1234567890123"

QRCODE 300,750,H,8,A,0,"SF1234567890123"

TEXT 280,1000,"TSS24.BF2",0,1,1,"扫码查询物流"

PRINT 1

资产标签（带圆角边框）

SIZE 70 mm,30 mm
GAP 2 mm,0
DIRECTION 1,0
DENSITY 10
CLS

BOX 10,10,550,230,2,15
TEXT 30,30,"TSS24.BF2",0,1,1,"资产编号:"
TEXT 180,30,"TSS24.BF2",0,1,1,B1,"IT-2024-001234"
BAR 30,70,500,1
TEXT 30,90,"TSS24.BF2",0,1,1,"设备名称: MacBook Pro"
TEXT 30,130,"TSS24.BF2",0,1,1,"使用部门: 技术研发部"
QRCODE 420,80,M,3,A,0,"IT-2024-001234"

PRINT 1

SDK 集成

如需在应用中使用 TSPL 指令，请参考对应语言的 SDK 文档：

Dart SDK - Flutter 跨平台开发
Java SDK - Android 原生开发
JavaScript SDK - 小程序开发
OpenHarmony SDK - HarmonyOS / OpenHarmony 应用
Objective-C SDK - iOS 原生开发
Swift SDK - iOS/macOS 开发

参考文档

TSPL 完整指令文档 (PDF)