HPRT TP809 Owner's manual

TP809
Programming Manual
Rev.1.2

REVISION RECORDS
REV
DATE
DESCRIPTION
Drawn
Checked
Approved
1.0
2017/11/14
PUBLICATION
Yan Xiaomei
Lin Yang
Lin Yang
1.1
2018/11/28
Modify Function
065/066/067/068/069/080/081/
082/167/169/180/182
Baochun Lin
Lin Yang
Lin Yang
1.2
2018.12.03
Add function:
ESC &, ESC 3, ESC S, FS !, FS &,
FS –, FS ., FS 2, FS S , FS W, ESC i
ESC m, ESC u
Baochun Lin
Lin Yang
Lin Yang

About This Manual
Please read this technical manual before programming.
Main description for command as below:
1）Function
This is the first part of command description. Here we propose the command of ASCII code and its function.
2）Format
This part describes the command with ASCII code format, HEX., format, and Decimal format.
3）Range
The range of the variable
The range value is default as decimal digit. For example, 1 ≤ n ≤ 4, “1” and “4” are decimal digits.
4）Description
Detailed illustration for the command
5）Note
Different mode must be with different command. This part explains the interaction details in different mode.
6）Reference
Other commands which are interrelated or similar with this.

TABLE OF CONTENTS
About This Manual .......................................................................................................................... 1
1 Bit Image Commands .................................................................................................................... 1
Select bit-image mode.............................................................................................................................................. 1
Define downloaded bit image .................................................................................................................................. 1
Print downloaded bit image ..................................................................................................................................... 2
Set graphics data ...................................................................................................................................................... 2
GS ( L pL pH m fn [parameters]................................................................................................................................. 3
Transmit the NV graphics memory capacity ............................................................................................................. 4
<Function 50> GS ( L pL pH m fn (fn = 2, 50) ......................................................................................................... 4
<Function 51> GS ( L pL pH m fn (fn = 3, 51) ......................................................................................................... 4
<Function 64> GS ( L pL pH m fn d1 d2 (fn = 64) ................................................................................................... 5
<Function 65> GS ( L pL pH m fn d1 d2 d3 (fn = 65) .............................................................................................. 5
<Function 66> GS ( L pL pH m fn kc1 kc2 (fn = 66) ................................................................................................ 5
<Function 67> GS ( L pL pH m fn a kc1 kc2 b xL xH yL yH [c d1…dk]1…[c d1....dk]b (fn = 67).................................. 6
<Function 69> GS ( L pL pH m fn kc1 kc2 x y (fn = 69) ........................................................................................... 7
<Function 112> GS ( L pL pH m fn a bx by c xL xH yL yH d1...dk (fn = 112) ........................................................... 8
2 Print Position Commands .............................................................................................................. 9
HT ............................................................................................................................................................................. 9
ESC $ nL nH............................................................................................................................................................... 9
ESC T n ...................................................................................................................................................................... 9
GS $ nL nH .............................................................................................................................................................. 10
ESC \ nL nH ............................................................................................................................................................. 10
ESC W xL xH yL yH dxL dxH dyL dyH .................................................................................................................... 11
ESC a n .................................................................................................................................................................... 12
ESC D n1...nk NUL ................................................................................................................................................... 12
GS L nL nH............................................................................................................................................................... 12
GS W nL nH............................................................................................................................................................. 13
GS \ nL nH............................................................................................................................................................... 13
3 Print Commands ......................................................................................................................... 14
LF ............................................................................................................................................................................ 14
FF (In page mode)................................................................................................................................................ 14
ESC FF ..................................................................................................................................................................... 14
ESC J n..................................................................................................................................................................... 15
ESC d n.................................................................................................................................................................... 15
GS ( A pL pH n m ..................................................................................................................................................... 16
4 Miscellaneous Function Commands............................................................................................. 17
ESC @ ..................................................................................................................................................................... 17
ESC L ....................................................................................................................................................................... 17
ESC p m t1 t2 .......................................................................................................................................................... 17
5 Character Control Commands...................................................................................................... 18
ESC ! n..................................................................................................................................................................... 18

ESC % n ................................................................................................................................................................... 18
ESC ? n .................................................................................................................................................................... 19
ESC SP n .................................................................................................................................................................. 19
CAN......................................................................................................................................................................... 19
ESC – n .................................................................................................................................................................... 19
ESC E n .................................................................................................................................................................... 20
ESC R n.................................................................................................................................................................... 20
ESC M n................................................................................................................................................................... 21
ESC V n.................................................................................................................................................................... 21
ESC { n..................................................................................................................................................................... 21
ESC G n ................................................................................................................................................................... 22
GS B n ..................................................................................................................................................................... 22
GS ! n ...................................................................................................................................................................... 23
ESC t n..................................................................................................................................................................... 24
ESC & ...................................................................................................................................................................... 25
6 Status Commands ....................................................................................................................... 27
GS r n ...................................................................................................................................................................... 27
ESC v ....................................................................................................................................................................... 29
DLE EOT n ............................................................................................................................................................... 30
7 Barcode Commands .................................................................................................................... 33
GS h n ..................................................................................................................................................................... 33
GS f n ...................................................................................................................................................................... 33
GS H n ..................................................................................................................................................................... 33
GS k......................................................................................................................................................................... 34
GS w n..................................................................................................................................................................... 35
GS ( k pL pH cn fn [parameters].............................................................................................................................. 36
<Function 065> GS ( k pL pH cn fn n (cn = 48, fn = 65)........................................................................................ 37
<Function 066> GS ( k pL pH cn fn n (cn = 48, fn = 66)........................................................................................ 37
<Function 067> GS ( k pL pH cn fn n (cn = 48, fn = 67)........................................................................................ 37
<Function 068> GS ( k pL pH cn fn n (cn = 48, fn = 68)........................................................................................ 38
<Function 069> GS ( k pL pH cn fn n (cn = 48, fn = 69)........................................................................................ 38
<Function 080> GS ( k pL pH cn fn m d1…dk (cn = 48, fn = 80)........................................................................... 39
<Function 081> GS ( k pL pH cn fn m (cn = 48, fn = 81)....................................................................................... 40
<Function 082> GS ( k pL pH cn fn m (cn = 48, fn = 82)....................................................................................... 40
<Function 167> GS ( k pL pH cn fn n (cn = 49, fn = 67)........................................................................................ 41
<Function 169> GS ( k pL pH cn fn n (cn = 49, fn = 69)........................................................................................ 41
<Function 180> GS ( k pL pH cn fn m d1…dk (cn = 49, fn = 80)........................................................................... 42
<Function 181> GS ( k pL pH cn fn m (cn = 49, fn = 81)....................................................................................... 42
<Function 182> GS ( k pL pH cn fn m (cn = 49, fn = 82)....................................................................................... 43
8 Mechanical Control Commands ................................................................................................... 44
GS V ........................................................................................................................................................................ 44
ESC i ........................................................................................................................................................................ 44
ESC m...................................................................................................................................................................... 45
ESC u....................................................................................................................................................................... 46
9 Line Spacing Commands.............................................................................................................. 47

ESC 3....................................................................................................................................................................... 47
10. Miscellaneous Commands ........................................................................................................ 48
ESC S ....................................................................................................................................................................... 48
11.KANJI Commands...................................................................................................................... 49
FS !.......................................................................................................................................................................... 49
FS & ........................................................................................................................................................................ 50
FS - .......................................................................................................................................................................... 51
FS . .......................................................................................................................................................................... 52
FS 2 ......................................................................................................................................................................... 53
FS W........................................................................................................................................................................ 54
12. Other Commands..................................................................................................................... 55
FS q n [xL xH yL yH d1...dk]1...[xL xH yL yH d1...dk]n & FS p n m [obsolete command]............................. 55
GS v 0 m xL xH yL yH d1...dk [obsolete command]................................................................................................. 55
ESC 2....................................................................................................................................................................... 56

TP809 Programming Manual
1
1 Bit Image Commands
Select bit-image mode
[Format]
ASCII
ESC * m nL nH d1...dk
Hex
1B 2A m nL nH d1...dk
Decimal
27 42 m nL nH d1...dk
[Range]
m = 0, 1, 32, 33
1 ≤ (nL + nH × 256) ≤ 2047
(0 ≤ nL ≤ 255, 0 ≤ nH ≤ 7)
0 ≤ d ≤ 255
k = nL + nH × 256 [when m = 0, 1]
k = (nL + nH × 256) × 3 [when m = 32, 33]
[Description]
• Stores the bit image data in the print buffer using the bit image mode specified by m.
• nL, nH specifies the number of dots of the image data in the horizontal direction as (nL
+ nH × 256).
• d specifies the bit image data (column format).
m
Bit image mode
Vertical direction
Horizontal direction
0
8 dots single-density
68 dpi
101 dpi
1
8 dots dual-density
68 dpi
203 dpi
32
24-dot single-density
203 dpi
101 dpi
33
24-dot double-density
203 dpi
203 dpi
Define downloaded bit image
[Format]
ASCII
GS * x y d1...dk
Hex
1D 2A x y d1...dk
Decimal
29 42 x y d1...dk
[Range]
1 ≤ x ≤ 255
1 ≤ y ≤ 48 [where 1 ≤ x × y ≤ 1536]
0 ≤ d ≤ 255
k = x × y × 8
[Description]
• Defines the downloaded bit image in the downloaded graphic area.
• x specifies the number of bytes in the horizontal direction as x bytes.
• y specifies the number of bytes in the vertical direction as y bytes.
• d specifies the defined data (column format).
[Note]
•A downloaded bit image and user-defined characters(ESC &) cannot be defined
simultaneously.When this command is executed,all user-defined characters are deleted.

TP809 Programming Manual
2
Print downloaded bit image
[Format]
ASCII
GS / m
Hex
1D 2F m
Decimal
29 47 m
[Range]
0 ≤ m ≤ 3, 48 ≤ m ≤ 51
[Description]
Prints downloaded bit image defined by GS ∗ and using the mode specified by m.
m
Mode
Vertical direction
Horizontal direction
0, 48
Normal
203dpi
203dpi
1, 49
Double-width
203dpi
101dpi
2, 50
Double-height
101dpi
203dpi
3, 51i
Quadruple
101dpi
101dpi
Set graphics data
[Format]
ASCII
GS 8 L p1 p2 p3 p4 m fn [parameters]
Hex
1D 38 4C p1 p2 p3 p4 m fn [parameters]
Decimal
29 56 76 p1 p2 p3 p4 m fn [parameters]
• In the description below, only GS (L is used for explanation).
• Note that GS (L and GS 8 L have the same function).
• If the [parameters] in the Format column in the table below exceed 65533 bytes, use GS
8 L.
• The only differences between GS (L and GS 8 L are as listed below. The format for GS 8 L
is not provided in the following descriptions; however, [Range], [Default], [Description],
and [Notes] for parameters other than those listed in the table below are the same as for
GS ( L. <Parameters specifying the number of parameters after pH or p4>
Command
Parameters
Structure
Maximum value
GS ( L
pL, pH
2 bytes
65,535
GS 8 L
p1, p2, p3, p4
4 bytes
4,294,967,295
• Processes graphics data.
• pL, pH specify (pL + pH × 256) as the number of bytes after pH (m, fn, and
[parameters]).
• fn specifies the function.
• [parameters] specify the process of each function.

TP809 Programming Manual
3
GS ( L pL pH m fn [parameters]
[Format]
ASCII
GS ( L pL pH m fn [parameters]
Hex
1D 28 4C pL pH m fn [parameters]
Decimal
29 40 76 pL pH m fn [parameters]
[Note]
• Frequent write command executions by an NV memory write command may damage
the NV memory.
Therefore, it is recommended to limit writing the commands into the NV memory to less
than 10 times a day.
• If the power is turned off or the printer is reset via an interface while this command is
being executed, the printer may go into an abnormal condition. Be careful not to turn
the power off or let the printer be reset via an interface while this command is being
executed.
• While processing this command, the printer is BUSY while writing the data to the NV
memory and stops receiving data. Therefore, be sure not to transmit data, including the
real-time commands, while the printer is BUSY.
• When <Function 48, 51, or 64> is transmitted, do not transmit the subsequent data
until the status is received. ESC/POS Handshaking Protocol procedures are required
when using <Function 64>.
fn
Format
Function No.
Function name
0，48
GS ( L pL pH m fn
48
Transmit the NV graphics memory capacity
2，50
GS ( L pL pH m fn
50
Print the graphics data in the print buffer
3，51
GS ( L pL pH m fn
51
Transmit the remaining capacity of the
NV graphics memory
64
GS ( L pL pH m fn d1 d2
64
Transmit the key code list for defined
NV graphics
65
GS ( L pL pH m fn d1 d2 d3
65
Delete all NV graphics data
66
GS ( L pL pH m fn kc1 kc2
66
Delete the specified NV graphics data
67
GS ( L pL pH m fn a kc1 kc2 b xL
xH yL yH [c d1...dk]1... [c
d1...dk]b
67
Define the NV graphics data (raster
format)
69
GS ( L pL pH m fn kc1 kc2 x y
69
Print the specified NV graphics data
112
GS ( L pL pH m fn a bx by c xL
xH yL yH d1…dk
112
Store the graphics data in the print
buffer (raster format)

TP809 Programming Manual
4
Transmit the NV graphics memory capacity
[Format]
ASCII
GS ( L pL pH m fn
Hex
1D 28 4C pL pH m fn
Decimal
29 40 76 pL pH m fn
[Range]
(pL + pH × 256) = 2 (pL = 2, pH = 0)
m = 48
fn = 0, 48
[Description]
Transmit the entire capacity of the NV graphics area (number of bytes in the NV graphics
area).
<Function 50> GS ( L pL pH m fn (fn = 2, 50)
[Function]
Print the graphics data in the print buffer
[Format]
ASCII
GS ( L pL pH m fn
Hex
1D 28 4C pL pH m fn
Decimal
29 40 76 pL pH m fn
[Range]
(pL + pH × 256) = 2 (pL = 2, pH = 0)
m = 48
fn = 2, 50
[Description]
Prints the buffered graphics data stored by processing of GS ( L <Function 112>.
<Function 51> GS ( L pL pH m fn (fn = 3, 51)
[Function]
Transmit the remaining capacity of the NV graphics memory
[Format]
ASCII
GS ( L pL pH m fn
Hex
1D 28 4C pL pH m fn
Decimal
29 40 76 pL pH m fn
[Range]
(pL + pH × 256) = 2 (pL = 2, pH = 0)
m = 48
fn = 3, 51
[Description]
Transmit the number of bytes of remaining memory (unused area) in the NV graphics
area.