TSC TTP-245, TTP-243 Plus, TTP-244, TTP-244CE, TTP-245C Programming Manual

TSPL/TSPL2 Programming Language

PROGRAMMING

MANUAL

TSC BAR CODE PRINTER SERIES

Update History

Date

Content

Editor

2007/7/13

Revise some typos

Phil

2007/12/25

Revise FREAD$() example

Camille

2008/4/10

Add update history list

Camille

2009/1/17

Add GAPDETECT command.

Ken

2009/5/18

Add CIRCLE command

Phil

2009/6/24

Add RSS command

Phil

2010/7/6

Revise bar command section

Camille

2010/10/25

Revise some sections

Camille

2011/01/06

Add CODE 11 barcode

Ernest

2011/01/06

Add AZTEC barcode

Ernest

2011/01/06

Revise sensor intension table in SET GAP

Ernest

2011/01/10

Add BLINEDETECT command

Ernest

2011/01/10

Add AUTODETECT command

Ernest

2011/01/10

Add BASIC function FORMAT$()

Ernest

2011/01/10

Add BASIC function NOW$()

Ernest

2011/01/10

Add BASIC function TRIM$()

Ernest

2011/01/10

Add BASIC function LTRIM$()

Ernest

2011/01/10

Add BASIC function RTRIM$()

Ernest

2010/01/10

Add BASIC function STRCOMP()

Ernest

2010/01/10

Add BASIC function INSTR()

Ernest

2011/01/25

Modify TSC address

Camille

2011/03/04

Revise, TTP-248M doesn't support mirror function

Ernest

2011/03/04

Add sensor range of TTP-225/ TDP-225 in command SET GAP

Ernest

2011/12/09

Add some command spec in RSS.

Ernest

TABLE OF CONTENTS

Document Conventions ................................................................................................... IV

Object Position Calculation ............................................................................................... V

Printer Models List ......................................................................................................... VII

Setup and System Commands ........................................................................................... 1

SIZE ........................................................................................................................................................... 1

GAP ........................................................................................................................................................... 3

GAPDETECT ............................................................................................................................................... 5

BLINEDETECT ............................................................................................................................................ 6

AUTODETECT ............................................................................................................................................ 7

BLINE ........................................................................................................................................................ 8

OFFSET .................................................................................................................................................... 10

SPEED ..................................................................................................................................................... 11

DENSITY .................................................................................................................................................. 13

DIRECTION AND MIRROR IMAGE ................................................................................................................. 14

REFERENCE ............................................................................................................................................. 16

SHIFT ....................................................................................................................................................... 17

COUNTRY ................................................................................................................................................ 19

CODEPAGE .............................................................................................................................................. 20

CLS .......................................................................................................................................................... 22

FEED........................................................................................................................................................ 23

BACKFEED & BACKUP .............................................................................................................................. 24

FORMFEED .............................................................................................................................................. 26

HOME ..................................................................................................................................................... 27

PRINT ...................................................................................................................................................... 29

SOUND .................................................................................................................................................... 30

CUT ......................................................................................................................................................... 31

LIMITFEED............................................................................................................................................... 32

SELFTEST ................................................................................................................................................. 33

Label Formatting Commands .......................................................................................... 34

BAR ......................................................................................................................................................... 34

BARCODE ................................................................................................................................................ 35

BITMAP ................................................................................................................................................... 40

BOX ......................................................................................................................................................... 42

CIRCLE ..................................................................................................................................................... 43

DMATRIX ................................................................................................................................................. 44

ERASE ...................................................................................................................................................... 45

MAXICODE .............................................................................................................................................. 46

PDF417 ................................................................................................................................................... 48

AZTEC ...................................................................................................................................................... 53

PUTBMP ................................................................................................................................................. 55

PUTPCX ................................................................................................................................................... 57

QRCODE .................................................................................................................................................. 59

RSS .......................................................................................................................................................... 64

REVERSE.................................................................................................................................................. 68

TEXT ........................................................................................................................................................ 69

Status Polling Commands (RS-232) .................................................................................. 71

<ESC>!? ................................................................................................................................................... 71

<ESC>!R .................................................................................................................................................. 72

~!@ ......................................................................................................................................................... 73

~!A .......................................................................................................................................................... 74

~!C .......................................................................................................................................................... 75

~!D .......................................................................................................................................................... 76

~!F ........................................................................................................................................................... 77

~!I ........................................................................................................................................................... 78

~!T .......................................................................................................................................................... 79

Message Translation Protocols ........................................................................................ 81

~# ............................................................................................................................................................ 81

Commands for Windows Driver ...................................................................................... 82

!B ............................................................................................................................................................ 82

!J ............................................................................................................................................................. 83

!N ............................................................................................................................................................ 84

File Management Commands ......................................................................................... 85

DOWNLOAD ............................................................................................................................................ 85

EOP ......................................................................................................................................................... 90

FILES ....................................................................................................................................................... 91

KILL ......................................................................................................................................................... 92

MOVE...................................................................................................................................................... 94

RUN ........................................................................................................................................................ 95

BASIC Commands and Functions ..................................................................................... 97

ABS( ) ...................................................................................................................................................... 97

ASC( ) ...................................................................................................................................................... 98

CHR$( ) .................................................................................................................................................... 99

END ....................................................................................................................................................... 100

EOF( ) .................................................................................................................................................... 101

OPEN .................................................................................................................................................... 103

WRITE ................................................................................................................................................... 106

READ ..................................................................................................................................................... 107

SEEK ...................................................................................................................................................... 109

LOF( )..................................................................................................................................................... 110

FREAD$( ) .............................................................................................................................................. 111

FOR…NEXT LOOP .................................................................................................................................. 112

IF…THEN…ELSE…ENDIF LOOP ............................................................................................................. 114

GOSUB…RETURN .................................................................................................................................. 118

GOTO .................................................................................................................................................... 119

INP$( ) ................................................................................................................................................... 121

INPUT ................................................................................................................................................... 122

REM ...................................................................................................................................................... 123

OUT ...................................................................................................................................................... 124

GETKEY( ) .............................................................................................................................................. 125

INT( ) ..................................................................................................................................................... 127

LEFT$( ) ................................................................................................................................................. 128

LEN( ) .................................................................................................................................................... 129

MID$( ) .................................................................................................................................................. 130

RIGHT$( ) .............................................................................................................................................. 131

STR$( ) ................................................................................................................................................... 132

STRCOMP ( ) .......................................................................................................................................... 133

INSTR ( ) ................................................................................................................................................ 134

TRIM$( ) ................................................................................................................................................ 135

LTRIM$( ) ............................................................................................................................................... 136

RTRIM$( ) .............................................................................................................................................. 137

VAL( )..................................................................................................................................................... 138

BEEP ...................................................................................................................................................... 139

NOW$( ) ................................................................................................................................................ 140

FORMAT$( ) ........................................................................................................................................... 141

Device Reconfiguration Commands ............................................................................... 144

SET COUNTER ....................................................................................................................................... 144

SET CUTTER .......................................................................................................................................... 145

SET PARTIAL_CUTTER ........................................................................................................................... 147

SET BACK ............................................................................................................................................... 149

SET KEY1, SET KEY2, SET KEY3 ............................................................................................................... 151

SET LED1, SET LED2, SET LED3 ............................................................................................................... 153

SET PEEL ................................................................................................................................................ 155

SET TEAR & SET STRIPER ....................................................................................................................... 156

SET GAP ................................................................................................................................................ 158

SET HEAD .............................................................................................................................................. 161

SET RIBBON ........................................................................................................................................... 162

SET COM1 ............................................................................................................................................. 163

SET PRINTKEY ........................................................................................................................................ 164

SET REPRINT ......................................................................................................................................... 166

PEEL ...................................................................................................................................................... 167

LED1, LED2, LED3 .................................................................................................................................. 169

KEY1, KEY2, KEY3 .................................................................................................................................. 171

Printer Global Variables ................................................................................................ 173

@LABEL ................................................................................................................................................ 173

YEAR ..................................................................................................................................................... 175

MONTH ................................................................................................................................................. 176

DATE ..................................................................................................................................................... 177

WEEK .................................................................................................................................................... 178

HOUR .................................................................................................................................................... 179

MINUTE ................................................................................................................................................ 180

SECOND ................................................................................................................................................ 181

@YEAR .................................................................................................................................................. 182

@MONTH ............................................................................................................................................. 184

@DATE .................................................................................................................................................. 186

@DAY .................................................................................................................................................... 188

@HOUR ................................................................................................................................................ 190

@MINUTE ............................................................................................................................................. 192

@SECOND ............................................................................................................................................. 194

Document Conventions

This manual uses the following typographic conventions.

Convention Description

[expression list] Items inside square brackets are optional, expression

maximum length 2*1024 bytes;

<ESC> ESCAPE (ASCII 27), control code of status

polling command returns the printer status immediately.

~ (ASCII 126), control code of status polling

command, returns the printer status only when the printer is ready.

Space (ASCII 32) characters will be ignored in the

command line.

“ (ASCII 34), beginning and ending of expression

CR,LF (ASCII 13),(ASCII 10) denotes end of command line.

NULL (ASCII 0) supported in the expression, except the

2D bar code commands.

Note: 203 DPI: 1 mm = 8 dots Arial font in bold and italic type is used for note.

Paper feed direction

DIRECTION 0

Label origin (0,0) X

Y

X=7mm

Y=3mm

Object Position Calculation

203 DPI, 1mm=8 dots 300 DPI, 1mm=12 dots

DIRECTION 0 TEXT 56,24,”3”,0,1,1,”ABC”

DIRECTION 1 TEXT 56,24,”3”,0,1,1,”ABC”

Paper feed direction

DIRECTION 1

Label origin (0,0) X

Y

X=7mm

Y=3mm

Printer Models List

Series

Models

TTP-243 series

1. TTP-243

2. TTP-243E

TTP-243 Plus series

3. TTP-243 Plus

4. TTP-243E Plus

TTP-244ME series

5. TTP-243M

6. TTP-244ME

7. TTP-244ME Plus

TTP-244 series

8. TTP-244

9. TTP-244 Plus

TTP-244CE series

10. TTP-244CE

TTP-245 series

11. TTP-245

12. TTP-245G

13. TTP-245 Plus

TTP-247

14. TTP-247

TTP-225

15. TTP-225

TTP-245C series

16. TTP-245C

TDP-245 series

17. TDP-245

10. TDP-245G

11. TDP-245 Plus

TDP-225

18. TDP-225

TTP-246M series

19. TTP-246M

20. TTP-246G

21. TTP-246M Plus

TTP-248M series

22. TTP-248M

TTP-2410M series

23. TTP-2410M

TDP-643 Plus

24. TDP-643 Plus

TDP-643R Plus

25. TDP-643R Plus

TTP-342 series

26. TTP-342

27. TTP-342 Plus

TTP-342M series

28. TTP-342M

29. TTP-342M Plus

TTP-343 series

30. TTP-343

31. TTP-343 Plus

TTP-345

32. TTP-345

TTP-343C series

33. TTP-343C

TTP-344M series

34. TTP-344M

35. TTP-344M Plus

TTP-346M series

36. TTP-346M

TTP-384M series

37. TTP-384M

TTP-644M series

38. TTP-644M

M23 series

39. M23

Setup and System Commands

 SIZE

Description

This command defines the label width and length.

Syntax

English system (inch) SIZE m,n Metric system (mm) SIZE m mm,n mm Dot measurement SIZE m dot,n dot This command is only supported in v6.27 and later firmware.

Parameter Description m Label width (inch or mm) n Label length (inch or mm)

Note :

200 DPI : 1 mm = 8 dots 300 DPI : 1mm = 12 dots For metric and dot systems, there must be a space between parameter and “mm” or “dot”.

Max. width

72mm

104mm

106mm

108mm

219.5mm

TTP-243 series

X

TTP-243 Plus series

X

TTP-244ME series

X

TTP-244ME Plus series

X

TTP-244 series

X

TTP-244CE series

X

TTP-245 series

X

TTP-245C series

X

TDP-245 series

X

TTP-246M series

X

TTP-248M series

X

TTP-2410M series

X

TDP-643 Plus series

X

TDP-643R Plus series

X

TTP-342 series

X

TTP-342 Plus series

X

TTP-342M series

X

TTP-342M Plus series

X

TTP-343 series

X

TTP-343C series

X

TTP-344M series

X

TTP-346M series

X

TTP-384M series

X

TTP-644M series

X

TTP-247 X

TTP-345 X

M23 series

X

Example

(1) English system (inch) SIZE 3.5, 3.00

(2) Metric system (mm) SIZE 100 mm, 100 mm

See Also

SIZE, BLINE

 GAPDETECT

Description

This command feeds the paper through the gap sensor in an effort to determine the paper

and gap sizes, respectively. This command references the user’s approximate measurements.

If the measurements conflict with the actual size, the GAPDETECT command will not work properly. This calibration method can be applied to the labels with pre-printed logos or texts.

Syntax

GAPDETECT [x, y]

Parameter Description x Paper length (in dots) y Gap length (in dots)

Note: If the x, y parameters are ignored then the printer will calibrate and determine the paper length and gap size automatically.

See Also

GAP, SIZE, BLINEDETECT, AUTODETECT

 BLINEDETECT

Description

This command feeds the paper through the black mark sensor in an effort to determine the paper and black mark sizes, respectively. This command references the user’s approximate measurements. If the measurements conflict with the actual size, the BLINEDETECT command will not work properly. This calibration method can be applied to the labels with pre-printed logos or texts.

Syntax

BLINEDETECT [x, y]

Parameter Description x Paper length (in dots) y Gap length (in dots)

Note: If the x, y parameters are ignored then the printer will calibrate and determine the paper length and gap size automatically.

See Also

GAP, SIZE, GAPDETECT, AUTODETECT

 AUTODETECT

Description

This command feeds the paper through the gap/black mark sensor in an effort to determine the paper and gap/black mark sizes, respectively. This command references the user’s approximate measurements. If the measurements conflict with the actual size, the AUTODETECT command will not work properly. This calibration method can be applied to the labels with pre-printed logos or texts.

Syntax

AUTODETECT [x, y]

Parameter Description x Paper length (in dots) y Gap length (in dots)

Note: (1). If the x, y parameters are ignored then the printer will calibrate and determine the paper length and gap/black mark size automatically. (2). When using this command, the printer will detect the label by the proper sensor type so please don’t set the command GAP or BLINE in your program. (3). It is supported in firmware V6.86EZ or later.

See Also

GAP, SIZE, GAPDETECT, BLINEDETECT

 BLINE

Description

This command sets the height of the black line and the user-defined extra label feeding length each form feed takes.

Syntax

English system (inch) BLINE m,n Metric system (mm) BLINE m mm,n mm

Parameter Description m The height of black line either in inch or mm. 0 ≤ m ≤ 1 (inch), 0 ≤ m ≤ 25.4 (mm) n The extra label feeding length. 0 ≤ n ≤ label length 0,0 Continuous label.

Note: For metric system, there must be a space between parameter and “mm”. When the sensor type is changed from “GAP” to “Black Mark”, please send the “BLINE” command to the printer first. Ex : In DOS mode, C :\>copy con lpt1 <Enter> BLINE 2 mm,0 <Enter> <Ctrl>+<Z> <Enter>

Example

English system (inch) BLINE 0.20,0.50 Metric system (mm) BLINE 5.08 mm,12.7 mm

See Also

SIZE, GAP

 OFFSET

Description

This command defines the selective, extra label feeding length each form feed takes, which, especially in peel-off mode and cutter mode, is used to adjust label stop position, so as for label to register at proper places for the intended purposes. The printer back tracks the extra feeding length before the next run of printing.

Syntax

English system (inch) OFFSET m Metric system (mm) OFFSET m mm

Parameter Description m The offset distance (inch or mm). -1 ≤ m ≤ 1(inch)

CAUTION: Impropriety offset value may cause paper jam.

Example

English system (inch) OFFSET 0.5 Metric system (mm) OFFSET 12.7 mm

See Also

SIZE, GAP, SET PEEL, SET CUTTER

 SPEED

Description

This command defines the print speed.

Syntax

SPEED n

Parameter Description n printing speed in inch per second

Model / IPS

1

1.5 2 2.5 3 3.5 4 5 6 8

10

12

TTP-243 series

x x x

TTP-243 Plus series

x x x

TTP-244ME series

x x x x TTP-244ME Plus series

x x x x TTP-244 series

x x x TTP-244CE series

x x x TTP-245 series

x x x x TTP-245C series

x x x x x TDP-245 series

x x x x TTP-246M series

x x x x x TTP-246M Plus series

x x x x x x TTP-248M series

x x x x

TTP-2410M series

x x x x

x

TDP-643 Plus series

x x x TDP-643R Plus series

x x x TTP-342 series

x x x TTP-342 Plus series

x x x TTP-342M series

x x x TTP-342M Plus series

x x x TTP-343 series

x x TTP-343C series

x x x TTP-344M series

x x x TTP-344M Plus series

x x x x TTP-346M series

x x x x TTP-384M series

x x x TTP-644M series

x x x M23 series

x x x x x

Example

SPEED 10

See Also

DENSITY

 DENSITY

Description

This command sets the printing darkness.

Syntax

DENSITY n

Parameter Description n 0~15 0: specifies the lightest level 15: specifies the darkest level

Note: Default DENSITY setting is 8

Example

DENSITY 7

See Also

DENSITY

 DIRECTION and Mirror Image

Description

This command defines the printout direction and mirror image. This will be stored in the printer memory.

Syntax

DIRECTION n[,m]

Parameter Description n 0 or 1. Please refer to the illustrations below: m 0: Print normal image. 1: Print mirror image.

Model

Support

DIRECTION

MIRROR

TTP-243 series X

TTP-243 Plus series

X

TTP-244ME series

X

TTP-244ME Plus series

X

TTP-244 series X X

TTP-244CE series

X

TTP-245 series X X

TTP-245C series X X

TDP-245 series X X

TTP-246M series

X

TTP-248M series X

TTP-2410M series

X

TDP-643 Plus series

X

TDP-643R Plus series

X

TTP-342 series X

TTP-342 Plus series

X

TTP-342M series X

TTP-342M Plus series

X

TTP-343 series X X

TTP-343C series X X

TTP-344M series

X

TTP-346M series

X

TTP-384M series

X

TTP-644M series

X

M23 series X X

Example

DIRECTION 0 DIRECTION 0,1

See Also

REFERENCE

 REFERENCE

Description

This command defines the reference point of the label. The reference (origin) point varies with the print direction, as shown:

Syntax

REFERENCE x, y

Parameter Description x Horizontal coordinate (in dots) y Vertical coordinate (in dots)

Note: 200 DPI: 1 mm = 8 dots 300 DPI: 1 mm = 12 dots

Example

REFERENCE 10,10

See Also

DIRECTION

 SHIFT

Description

This command moves the label’s vertical position. A positive value moves the label further from the printing direction; a negative value moves the label towards the printing direction. For a visual representation, see next page.

Syntax SHIFT n

Parameter Description n The maximum value is 1 inch. For 200 dpi printers, the range

is –203 to 203; for 300 dpi printers, the range is –300 to 300. The unit is dot.

Model

Support

TTP-243 series

TTP-243 Plus series

X

TTP-244ME series

TTP-244ME Plus series

X

TTP-244 series

X

TTP-244CE series

X

TTP-245 series

X

TTP-245C series

X

TDP-245 series

X

TTP-246M series

X

TTP-248M series

TTP-2410M series

X

TDP-643 Plus series

TDP-643R Plus series

X

TTP-342 series

TTP-342 Plus series

X

TTP-342M series

TTP-342M Plus series

X

TTP-343 series

X

TTP-343C series

X

TTP-344M series

X

TTP-346M series

X

TTP-384M series

X

TTP-644M series

X

M23 series

Example

SIZE 4,2.5 GAP 2 mm,0 DIRECTION 0 SHIFT 30 OFFSET 0 CLS TEXT 400,200,"3",0,1,1,"DIRECTION 0" TEXT 400,250,"3",0,1,1,"SHIFT 30" BOX 10,0,780,490,8 PRINT 3,1

See Also

CODEPAGE, ~!I

 CODEPAGE

Description

This command defines the code page of international character set.

Syntax

CODEPAGE n

Parameter Description n Name or number of code page, which can be divided into 7-bit code page and 8-bit code page. 7-bit code page name USA: USA BRI: British GER: German FRE: French DAN: Danish ITA: Italian SPA: Spanish SWE: Swedish SWI: Swiss

8-bit code page number 437: United States 850: Multilingual 852: Slavic 860: Portuguese 863: Canadian/French 865: Nordic 857: Turkish (TSPL2 printers only)

Windows code page 1250: Central Europe (TSPL2 printers only) 1252: Latin I (TSPL2 printers only) 1253: Greek (TSPL2 printers only) 1254: Turkish (TSPL2 printers only)

Note: DATA LENGTH determines 7-bit or 8-bit communications parameter.

TSC TTP-245, TTP-243 Plus, TTP-244, TTP-244CE, TTP-245C Programming Manual

Specifications and Main Features

Frequently Asked Questions

User Manual