SPRT TL24 Installation instructions

SPRT®TL24/25 Technical Command Manual
TL24/25 Technical
Command Manual
（VER 0.01）
Beijing Spirit Technology Development Co., Ltd.
Version Description
Date
Version
Revise Contents
Aug. 2018
V0.01
First Draft

SPRT®TL24/25 Technical Command Manual
CONTENT
1. ESC/POS Commands ..............................................................................................................................1
2. CPCL Commands ..................................................................................................................................... 1
3. TSPL Commands ......................................................................................................................................2
ESC/POS command ......................................................................................................................................... 3
HT .............................................................................................................................................................3
LF ............................................................................................................................................................. 3
FF ..............................................................................................................................................................3
CR .............................................................................................................................................................4
DLE EOT n .............................................................................................................................................. 4
ESC SP n .................................................................................................................................................. 6
ESC ! n ..................................................................................................................................................... 6
ESC $ nL nH............................................................................................................................................ 7
ESC % n ................................................................................................................................................... 8
ESC & y c1 c2 [x1 d1...d(y × x1)]...[xk d1...d(y × xk)]..........................................................................8
ESC * m nL nH d1... dk ...................................................................................................................... 10
ESC – n ...................................................................................................................................................12
ESC 2 ......................................................................................................................................................13
ESC 3 n ...................................................................................................................................................13
ESC = n .................................................................................................................................................. 13
ESC ? n ...................................................................................................................................................14
ESC @ ....................................................................................................................................................14
ESC D n1...nk NUL ............................................................................................................................... 14
ESC E n .................................................................................................................................................. 15
ESC G n ..................................................................................................................................................15
ESC J n ................................................................................................................................................... 16
ESC M n .................................................................................................................................................16
ESC R n ..................................................................................................................................................16
ESC V n ..................................................................................................................................................17
ESC \ nL nH ........................................................................................................................................... 18
ESC a n ...................................................................................................................................................18
ESC c 5 n ................................................................................................................................................19
ESC d n ...................................................................................................................................................19
ESC t n ................................................................................................................................................... 19
ESC { n ...................................................................................................................................................21
FS P n ..................................................................................................................................................... 21
GS ! n ..................................................................................................................................................... 22
GS * x y d1...d(x × y × 8)...................................................................................................................... 23
GS / m .....................................................................................................................................................24
GS B n .................................................................................................................................................... 24
GS H n ....................................................................................................................................................25
GS L nL nH ............................................................................................................................................ 25
GS P x y ..................................................................................................................................................26

SPRT®TL24/25 Technical Command Manual
GS W nL nH...........................................................................................................................................26
GS f n ..................................................................................................................................................... 27
GS h n ................................................................................................................................................... 27
①GS k m d1...dk NUL②GS k m n d1...dn ......................................................................................28
GS w n ...................................................................................................................................................30
FS ! n..................................................................................................................................................... 31
FS & ....................................................................................................................................................... 31
FS - n .....................................................................................................................................................32
FS . .........................................................................................................................................................32
FS 2 c1 c2 d1...dk ............................................................................................................................... 32
FS C n ................................................................................................................................................... 33
FS S n1 n2 ............................................................................................................................................34
FS W n...................................................................................................................................................34
GS Z n ................................................................................................................................................... 35
ESC Z m n k dL dH d1 …dn ..............................................................................................................35
①GS k m v r d1...dn NUL ②GS k m v r nL nH d1...dn .................................................................36
CPCL Commands ........................................................................................................................................37
！{offset} 200 200 {height} {qty} ..........................................................................................37
PRINT Commands .............................................................................................................................. 37
FORM Commands .............................................................................................................................. 38
TEXT Commands ................................................................................................................................38
LINE Commands ................................................................................................................................. 39
BOX Commands ..................................................................................................................................40
INVERSE-LINE Commands .............................................................................................................. 40
GRAPHICS Commands ..................................................................................................................... 40
BARCODE Commands ...................................................................................................................... 41
BARCOD-TEXT Commands ............................................................................................................. 44
SETBOLD Commands ....................................................................................................................... 44
SETSP Commands............................................................................................................................. 45
INVERSE-TEXT Commands.............................................................................................................45
UNDERLINE-TEXT Commands ....................................................................................................... 45
PAGE-ROTATE Commands .............................................................................................................. 46
CENTER Commands ..........................................................................................................................46
LEFT Commands ................................................................................................................................ 46
RIGHT Commands ..............................................................................................................................46
TSPL Commands ........................................................................................................................................ 47
System setting commands .................................................................................................................47
SIZE Commands ................................................................................................................................. 47
CASHDRAWER Commands ............................................................................................................. 47
GAP Commands ..................................................................................................................................47
DIRECTION Commands ....................................................................................................................48
REFERENCE Commands ................................................................................................................. 48
COUNTRY Commands ...................................................................................................................... 48
CODEPAGE Commands ....................................................................................................................49

SPRT®TL24/25 Technical Command Manual
CLS Commands .................................................................................................................................. 49
FEED Commands ............................................................................................................................... 49
BACKFEED&BACKUP Commands ................................................................................................. 50
FORMFEED Commands ....................................................................................................................50
HOME Commands .............................................................................................................................. 50
PRINT Commands .............................................................................................................................. 50
SOUND Commands ............................................................................................................................50
LIMITFEED Commands ..................................................................................................................... 51
Label Formatting Commands ............................................................................................................51
BAR Commands ..................................................................................................................................51
BARCODE Commands ...................................................................................................................... 52
BOX Commands ..................................................................................................................................52
BITMAP Commands ........................................................................................................................... 53
ERASE Commands .............................................................................................................................55
REVERSE Commands .......................................................................................................................55
TEXT Commands ................................................................................................................................55
QRCODE Commands ........................................................................................................................ 56
Inquire printer status command ........................................................................................................ 56
<ESC>!? Commands ..........................................................................................................................56
<ESC>! R Commands ........................................................................................................................ 57
~!@ Commands ...................................................................................................................................57
~!A Commands .................................................................................................................................... 57
~!D Commands ....................................................................................................................................57
~!F Commands .................................................................................................................................... 58
~!I Commands ......................................................................................................................................58
~!T Commands .................................................................................................................................... 58
File Management Commands ........................................................................................................... 58
BEEP Commands ................................................................................................................................58
SET KEY1, SET KEY2 Commands ..................................................................................................58
SET PRINTKEY Commands ............................................................................................................. 59
SET REPRINT Commands ................................................................................................................59
Appendix A: 128 code .................................................................................................................................60
A.1 128 code summary ...................................................................................................................... 60
A.2 Character sets ...............................................................................................................................61
Appendix B: Print mode and its conversion ............................................................................................65
Appendix C: Pre-print black mark description ........................................................................................ 68

SPRT®TL24/25 Technical Command Manual
1
Format Specification
This section shows how to read and use the instructions of the manual. Please read it before
programming.
The command instructions of the manual include:
1. ESC/POS Commands
1) Description of Name and function of the command. This is the first part of the command
instruction, which provide the command of ASCII form and the function description.
2) Format. In this part, using three kinds of form: the ASCII,HEX and Decimal, to describe the
Command. The default is Decimal if have no especial description, For example: 1 ≤n≤
4,1 is Decimal 1, not the ASCII code 1.
3) Scope. Provide the scope of the Variable.
4) Description. Provide the detailed explanation of the command.
5) Annotation. Provide some notes of the command. Commands under different mode, or
coordinating with different commands may cause interaction, so we provide some details
here.
6) Reference. Provide some other commands which are interrelated or similar.
---> DLE EOT n Real time transmission status
---> [Format] ASCII DLE EOT n
Hex 10 04 n
Decimal 16 4 n
---> [Range] 1 ≤n≤4
---> [Description] Sending the printer state that designated by parameter n just in time
---> [Notes] When printer receives the command, returns to the interrelated status
immediately
---> [Reference]
2. CPCL Commands
1) Description of Name and function of the command. This is the first part of the command
instruction, which provide the command of character form and the function description.
2) Format. This part uses the character encoding form to describe the instructions.
3) Instructions. Provide the scope of the instruct and range of variate.
4) Reference. Provide some other commands which are interrelated or similar.
---> PRINT
---> [Name] Print Order
---> [Format] PRINT

SPRT®TL24/25 Technical Command Manual
2
---> [Instruction] CPCL command, the last print command execution, receipt PRINT and
ENTER, indicated a document is completed.
---> [Reference]
Note: CPCL instruct rules state:
1. Instructions are forms of characters, and all are capitalized, both ends with the
ENTER, line feeds.
2. Zebra instruct is judged by the followed conditions: starting with !, followed by a space,
and then five figures.
3. Each parameter ended with Spaces or ENTER.(Several ended with ;)
Except first instruct (For Example:”! 0 200 200 210 1’’) “!” must be followed by a space,
other parameters can follow with any space(For Example:! 0 200 200 210 1).
4. Every number parameters for maximum of 65536.
5. If the parameter is the fixed length, content behind the last parameter will be ignored.
For Example:! 0 200 200 210 1 sdhsiadhsiahdsaudgu
6. The maximum of vertical coordinate: 520dots
7. For SP-TL24U5 and SP-TL24UBTDM5 models, the maximum of horizontal coordinates:
448dots, if >448,will be 0)
8. For SP-TL24and SP-TL24UBTDM models, the maximum of horizontal coordinates:
348dots, if >348,will be 0)
9. For the position of overlapping print content.
10. Only after received the PRINT instruction, the machine will print, otherwise it will not
print at all.
11. There can be spaces in front of the instructions, but can not have other content.
3. TSPL Commands
1) Description of Name and function of the command. This is the first part of the command
instruction, which provide the command of character form and the function description.
2) Format. This part uses the character encoding form to describe the instructions.
3) Instructions. Provide the scope of the instruct and range of variate.
4) Reference. Provide some other commands which are interrelated or similar.
Notes:TSPL instruct rules state:
1. In addition to the eight instructions to ask the printer status, the other instructions are
in the form of characters, and are uppercase, are the carriage return, line as the end.
2. Each parameter to a space, comma, double quotation marks or carriage return end.
3. Every number parameters for maximum of 65536.
4. The maximum of vertical coordinate: 520 dots
5. For SP-TL24U5 and SP-TL24UBTDM5 models, the maximum of horizontal
coordinates: 448dots, if >448,will be 0)
6. For SP-TL24and SP-TL24UBTDM models, the maximum of horizontal coordinates:
348dots, if >348,will be 0)
7. For the position of overlapping print content,

SPRT®TL24/25 Technical Command Manual
3
8. Only after received the PRINT instruction, the machine will print, otherwise it will not
print at all.
9.There can be spaces in front of the instructions, but can not have other content.
ESC/POS command
HT
[Name] Horizontal tab
[Format] ASCII HT
Hex 09
Decimal 9
[Description] Moves the print position to the next horizontal tab position.
[Notice] .This command is ignored unless the next horizontal tab position has been set.
.If the next position of horizontal tab exceeds the printing area, the current
position will be set as [printing width+1].
.Horizontal tab positions are set with ESCD.
.If the current position is at [ printing width+1] when receives the command,the
printer will carry out the action in row buffer and move the printing position to the
Zero position of next line.
.The default value of tab position is every 8 standard ASCII characters (12*24) a
tab.
.When the current row buffer is full,the printer will carry out the action below:
Under standard mode,printer prints the content of current row and sets the
Printing position at the zero position of next line
Under page mode,the printer begins a new line and set the printing position at the
zero position of next line.
[Reference] ESC D
LF
[Name] Printing and feeding line
[Format] ASCII LF
Hex 0A
Decimal 10
[Description] Printing the data in the print buffer and feeds one line
[Notice] This command sets the print position to the beginning of the line.
[Reference] ESC 2, ESC 3
FF
[Name] Printing and feeding paper
[Format] ASCII FF
Hex 0C
Decimal 12
[Description] Printing all of the content in print buffer and returning to the standard mode,
under the standard mode, if the printer establishes in the black mark paper
mode, then printing the data in the buffer to feed paper to the black mark

SPRT®TL24/25 Technical Command Manual
4
section, if haven’t black mark, then feed the paper 30cm behind stop,the
pre-print black mark specification is showed in the appendix C. the pre-print
black mark instruction.If not at the black mark examining status and then only
print the contents of buffer,don’t feed paper.
[Notice] .Clearing the content in print buffer after printing.
.The printing area setup by ESC W returns to the default.
.The printer don’t cut paper.
.This command sets the current position at the beginning of the line
[Reference] ESC FF, ESC L, ESC S
CR
[Name] Printing and entering
[Format] ASCII CR
Hex 0D
Decimal 13
[Description] The same as LF when the command is permitted,if forbidden, it will be ignored.
[Notice] Setting the printing position at the beginning of the line.
[Reference] LF
DLE EOT n
[Name] Real time status transmission
[Format] ASCII DLE EOT n
Hex 10 04 n
Decimal 16 4 n
[Range] 1 ≤n≤4
[Description] Sending the printer state that designated by parameter n just in time:
n=1:Sending state of the printer
n=2:Sending off line state
n=3:Sending error state
n=4:Sending state of paper sensor
[Notice] -When printer receives the command,returns to the interrelated status
immediately
.Avoiding to put this command in the command sequence of more than2
characters.
.This command will still valid even though the printer is set to forbid by the
Command of ESC=(selecting peripheral).
.When sending printer current state,each state is indicated by 1byte
.Transmission state value of the printer can not confirm whether the master
computer received
.Printer will carry out the command immediately once received
n = 1: Printer state
bit
0/1
HEX
Decimal
Function

SPRT®TL24/25 Technical Command Manual
5
0
0
00
0
Fix as 0
1
1
02
2
Fix as 1
2
0
00
0
The cash box open/close signal is low(the third of cash box
plug leads foot)
1
04
4
The cash box open/close signal is high(the third of
cash box plug leads foot)
3
0
00
0
online
1
08
8
offline
4
1
10
16
Fix as 1
5,6
undefined
7
0
00
00
Fix as 0
n = 2: off line state
bit
0/1
HEX
Decimal
Function
0
0
00
0
Fix as 0
1
1
02
2
Fix as 1
2
0
00
0
The top cover closed
1
04
4
The top cover opened
3
0
00
0
Not holding down the feed button
1
08
8
holding down the feed button
4
1
10
16
fix as 1
5
0
00
0
Printer is not out of paper
1
20
32
Printer is out of paper
6
0
00
0
No error state
1
40
64
error state
7
0
00
0
fix as 0
n = 3: error state
bit
0/1
HEX
Decimal
Function
0
0
00
0
fix as 0
1
1
02
2
fix as 1
2
-
-
-
undefined
3
0
00
0
noun cutter error
1
08
8
cutter error
4
1
10
16
fix as 1
5
0
00
0
noun unrecoverable error
1
20
32
Have unrecoverable error
6
0
00
0
noun auto recoverable error
1
40
64
have auto recoverable error
7
0
00
0
fix as 0
n = 4: paper sensor state
bit
1/0
HEX
Decimal
Function

SPRT®TL24/25 Technical Command Manual
6
0
0
00
0
fix as 0
1
1
02
2
fix as 1
2,3
0
00
0
the sensor of paper is going out: have enough paper.
1
0C
12
the sensor of paper is going out:the paper is going out
4
1
10
16
fix as 1
5,6
0
00
0
lack of paper sensor: have paper
1
60
96
lack of paper sensor: noun paper
7
0
00
0
fix as 0
[Reference] DLE ENQ,GS a,GS r
ESC SP n
[Name] Setting the right space of characters
[Format] ASCII ESC SP n
Hex 1B 20 n
Decimal 27 32 n
[Range] 0 ≤n≤255
[Description] Setting the right space of character for[n× units of vertical or lateral shifting.
[Notice] -When the character enlarges,the space enlarges the same times.
-The command does not effect the setup of Chinese characters.
-The value which is set by the command under page and standard mode is mutual
independence.
-Units of vertical or lateral shifting area pointed by GS P.Changing units of vertical
or lateral shifting does not change the current right space.
-Using lateral shifting units under standard mode.
-According to the direction of printing area and the beginning position to select
vertical or lateral shifting units under page mode.
The selection modes areas below:
①Using lateral shifting when the beginning position is the top left or lower right
corner of the printing area which is set by ESC T;
②Using vertical shifting when the beginning position is the lower left or top right
corner of the printing area which is set by ESC T;
The maximum right space is 255/203 inches.If setting beyond this value,it will
change into the maximum distance automatically.
[Default] n= 0
[Reference] GS P
ESC ! n
[Name] selecting print mode
[Format] ASCII ESC ! n
Hex 1B 21 n
Decimal 27 33 n
[Range] 0 ≤n≤255
[Description] Setting character print mode according to value of n
bit
1/0
HEX
Decimal
Function