Codesoft TP-290XIII Operating and maintenance manual

CODE SOFT
Programmer Manual
www.code-soft.com
TP-290XIII

Manual Description
Command Notation
[Name]Command inASCII format and generaldescription.
[Format] The code sequence, including ASCII, HEXand DECIMAL.
[Range]Givesthe allowablerangesforthe arguments.
[Description]Describesthe command sfunction.
[Details]Describesthe usage ofthe command indetail.
[Notes]Providesimportant information on setting and using the printercommand.
[Reference] Listsrelated commands.
[Example] Givesexamplesofhowtousethe command.
1HTHorizontal tab
[Format] ASCII HT
Hex09
Decimal9
[Description]Movesthe print position tothe next horizontaltabposition.
[Details] § Thiscommand isignored unless the next horizontaltabposition hasbeen set.
§ Ifthe next horizontaltabposition exceedsthe printingarea, the printersetsthe
printingposition to[Printingarea width+1].
§ Horizontaltabpositionsareset with ESCD.
§ Ifthiscommand isreceived when theprintingposition isat[printingarea
width+1], the printerexecutesprint buffer-full printingofthe current line and
horizontaltabprocessingfromthe beginningofthe next line.
§ The default settingofthe horizontaltabposition forthe paperroll isfont A(12
24)every8character(column9, 17, 25, ...).
§ When the bufferisfull on current line, the printerwill do the following:
InStandardMode, print the current line and set the print position tonext line.
InPageMode, printerentersnewline and set the print position tonext line.
[Reference]ESCD
2LF Printand linefeed
[Format] ASCII LF
Hex0A
Decimal10
[Description] Printsthedataintheprintbufferandfeedsonelinebasedonthecurrentlinespacing.
[Note]Thiscommand setsthe print position tothe beginningofthe line.
[Reference]ESC2, ESC3
THERMALRECEIPTPRINTER

THERMALRECEIPTPRINTER 2
3ESCSP n Setright-sidecharacterspacing
[Format] ASCII ESC SP n
Hex1B20 n
Decimal27 32 n
[Range] 0 n 255
[Description]Setsthe characterspacingforthe right side ofthe charactertoinches[ nx
horizontalmotion units].
[Details] § When charactersareenlarged ntimes, the right-side characterspacingisn
timesnormalvalue.
§ The maximumright-side spacingis255/203 inches. Anysettingexceedingthe
maximumisconverted tothe maximumautomatically.
[Default] n=0
[Reference]GSP
4ESC!nSetprintmode
[Format] ASCII ESC! n
Hex1B21 n
Decimal27 33 n
[Range]0 ≤n ≤255
[Description]Selectsprint mode(s)usingnasfollows:
Bit 1/0 HEX DECIMAL FUNCTION
0 00 0 Characterfont A(12 14)selected.
0 1 01 1 Characterfont B(12 12)selected.
1,2 --- --- Undefined.
0 00 0 Emphasized mode not selected.
3 1 08 8 Emphasized mode selected.
0 00 0 Double-height mode not selected.
4 1 10 16 Double-height mode selected.
0 00 0 Double-widthmode not selected.5 1 20 32 Double-widthmode selected.
6 --- --- Undefined.
0 00 0 Underline mode not selected.
7 1 80 128 Underline mode selected.
[Note]§ When bothdouble-height and double-widthmodesareselected, quadruple
sizecharactersareprinted.
§ Underliningisadded tothe entirewidthofeachcharacter, includingthe
spacetothe right ofacharacter, but isnot addedtoportionsoflinesthat
wereskipped bymeansofan HT.
[Default] n=0
[Reference]ESC- ESCE, GS!

THERMALRECEIPTPRINTER 3
5ESC$nL nHSetabsoluteprintposition
[Format] ASCII ESC$nL nH
Hex1B24 nL nH
Decimal 27 36 nL nH
[Range]0 n255
[Description]§ Setsthe distancefromthe beginningofthe line tothe position at which
subsequent charactersaretobeprinted.
§ The distancefromthe beginningofthe line tothe print position is[( nL +nH x
256) x (verticalorhorizontalmotion unit)] inches.
§ Settingsoutside the specified printablearea areignored.
6ESC%nSelect/cancel user-definedcharacterset
[Format] ASCII ESC%n
Hex1B25 n
Decimal27 37 n
[Range] 0 nL 255
[Description]Selectsorcancelsthe user-defined characterset.
§ When the LSB of nis0, the user-defined characterset iscanceled.
§ When the LSB of nis1, the user-defined characterset isselected.
[Details]§ When the user-defined characterset iscanceled, the internalcharacterset is
automaticallyselected.
§ nisavailableonlyforthe least significant bit.
[Default] n=0
[Reference]ESC&，ESC?
7ESC&yc1 c2 [x1 d1...d(y x1)]...[xk d1...d(y xk)] Defineuser-definedcharacters
[Format]ASCII ESC&yc1c2[x1d1...d(y ×x1)]...[xk d1...d(y ×xk)]
Hex1B26 yc1c2[x1d1...d(y ×x1)]...[xk d1...d(y ×xk)]
Decimal27 38 yc1c2[x1d1...d(y ×x1)]...[xk d1...d(y ×xk)]
[Range]y=3
32 ≤c1 ≤c2 ≤127
0 ≤x ≤12 Font A(12 ×24)
0 ≤x ≤9Font B(9 ×17)
0 ≤d1 ... d(y ×xk) ≤255
[Description]Definesuser-defined characters.
§ yspecifiesthe numberofbytesinthe verticaldirection.
§ c1specifiesthe beginningcharactercode forthe definition, and c2specifies

THERMALRECEIPTPRINTER 4
the finalcode.
§ xspecifiesthe numberofdotsinthe horizontaldirection.
[Note]§ The availablerangeofcharacterisfromASCII <20>H to<7F>H (96
characters).
§ Consecutivecharactercodesformultiplecharacterscan bedefined inone
definition. When specifyingonlyone character, specifyc1=c2。
§ disdefinition datathat indicatesthe patternfor"x"dotsinthe horizontal
direction startingfromthe left edge.
§ The datatodefine auser-defined characteris(y ×x)bytes.
§ Inthe definition data, a"1"representsadot that istobeprinted, and a"0"
representsadot that isnot tobeprinted.
§ The defined downloaded charactersarecleared inthe following
circumstances:
1)When "ESC@" isexecuted
2)When deleted by"ESC?"
3)When “FSq”isexecuted
4)When “GS*”isexecuted
5)When the printerisreset orturned off
[Default] The internalcharacterset
[Reference]ESC%, ESC?
[Example]§ When Font A(12 ×24)isselected
最高位
最低位
D1
d1d4 d7-----------------------d34
d2d5---------------------------- d35
d3d6---------------------------- d36
24点
12
点
§ When Font B(9 ×17)isselected

THERMALRECEIPTPRINTER 5
最高位
最低位
D1d1d4 d7-----------------------d25
d2d5----------------------------d26
d3d6---------------------------- d27
17点
9点
8ESC*mnL nHd1... dk Selectbit-imagemode
[Format] ASCII ESC*mnL nHd1...dk
Hex1B2AmnL nHd1...dk
Decimal27 42 mnL nHd1...dk
[Range]m=0, 1, 32, 33
0 ≤nL ≤255
0 ≤nH ≤3
0 ≤d ≤255
[Description]Selectsabit-imagemode usingmforthe numberofdotsspecified bynL and nH

THERMALRECEIPTPRINTER 6
Vertical Horizontalm Mode
Dot Density Density Data（k）
08dotsSingleDensity 867 DPI 100 DPI nL +nH ×256
1 8 dotsDoubleDensity 8 67 DPI 200 DPI nL +nH ×256
32 24 dotsSingleDensity 24 200 DPI 100 DPI (nL +nH ×256) ×3
33 24 dotsDoubleDensity 24 200 DPI 200 DPI (nL +nH ×256) ×3
[dpi: dot/25.4mm{1”}]
[Notes]§ Ifthe valuesofmand nHareout ofthe specified range, the followingdatais
processed asnormaldata.
§ The nL and nHindicatethe numberofdotsofthe bit imageinthe horizontal
direction. The numberofdotsiscalculated bynL +nH 256.
§ Ifthe bit-imagedatainputexceedsthenumberofdotstobeprinted on aline,
the excess dataisignored.
§ dindicatesthebit-imagedata.Setacorrespondingbitto1toprintadotorto
0tonot print adot.
§ Afterprintingabit image, the printerreturnstonormaldataprocessing
mode.
§ Exceptconvertmode,thiscommand doesn t affectotherprintmode,suchas
emphasized, doubleprint, underline, characterenlarged, contrary.
§ The relationshipbetween the imagedataand the dotstobeprinted isas
follows.
8-dot densityselected:
单密度
打印数据
1点
双密度
Dd1 d2 d3
位图数据
最高位
位图数据
最低位
打印数据
D d1d2d3
24-dot densityselected:

THERMALRECEIPTPRINTER 7
单密度
打印数据
1点
双密度
Dd1d2 d3 d4d5 d6
d7 d8
d9
位图数据
最高位
位图数据
最低位
打印数据
D d1d4 d7
d2d5d8
d3d6d9
9ESC –nTurnunderlinemodeon/off
[Format] ASCII ESC-n
Hex1B2Dn
Decimal27 45 n
[Range]0 ≤n ≤2, 48 ≤n ≤50
[Description]Turnsunderline mode on oroff,
n Function
0, 48 underline mode isturned off.
1, 49 underline mode isturned on. (1dots)
2, 50 underline mode isturned on. (2dots)
[Notes]§ Underlinescan beprinted forall characters, but not forthe spaceset byHT.
§ Underline isnot enabled when 90°rotation orcharactercontraryisset.
§ When underline mode isturned off, the followingcharactersarewithout
underline. The underline widthisnot changed. Default widthis1dot width.
§ Underline mode isstill enabled even charactersizeischanged.
§ Underline mode can alsobeturned on oroff byusingESC!.
§ Thiscommand doesnot affect the setting ofKanji characters.
[Default] n=0
[Reference]ESC!

THERMALRECEIPTPRINTER 8
10 ESC2Selectdefaultlinespacing
[Format] ASCII ESC2
Hex1B32
Decimal27 50
[Description]Selectsdefault (3.75mm, 1/6-inch)line spacing.
[Notes] § Default line spacingisabsoluteinstandardmode and pagemode.
[Reference]ESC3
11 ESC3nSetlinespacing
[Format] ASCII ESC3n
Hex1B33 n
Decimal27 51 n
[Range]0 ≤n ≤255
[Description]Setsthe line spacingto[ n(1/192)] inches.
[Notes] § Line spacingisabsoluteinstandardmode and pagemode.
[Default] n=3.75mm
[Reference]ESC2, GSP
12 ESC?nCancel user-definedcharacters
[Format] ASCII ESC?n
Hex1B3Fn
Decimal27 63 n
[Range]32 ≤n ≤127
[Description]Canceluser-defined characters
[Notes] § Thiscommand cancelsthe patterndefined forthe charactercode specified
byn. Afterthe user-defined charactersarecanceled, the corresponding
patternofthe internalcharacterisprinted.
§ Ifauser-defined characterhasnot been defined forthe specified character
code, the printerignoresthiscommand.
[Reference]ESC&, ESC%
13 ESC@Initializeprinter
[Format] ASCII ESC@
Hex1B40
Decimal27 64
[Description] Clearsthe datainthe print bufferand resetsthe printermode tothe mode that is
ineffect when the poweristurned on.

THERMALRECEIPTPRINTER 9
[Notes] § The DIPswitchsettingsarenot checked again.
§ The datainthe receivebufferisnot cleared.
§ Macrodefined isreserved.
§ NVbitmapdataisnot cleared.
14 ESCDn1...nkNULSethorizontal tabpositions
[Format] ASCII ESCDn1...nkNUL
Hex1B44 n1...nk00
Decimal27 68 n1...nk0
[Range]1 ≤n ≤255
0 ≤k ≤32
[Description]Set horizontaltabpositions
§ nspecifiesthe columnnumberforsettingahorizontaltabposition fromthe
beginningofthe line.
§ kindicatesthe totalnumberofhorizontaltabpositionstobeset.
[Notes]§ The horizontaltabposition isstored asavalue of[characterwidthxn]
measured fromthe beginningofthe line. The characterwidthincludesthe
right-side characterspacing, and double-widthcharactersareset withtwice
the widthofnormalcharacters.
§ Thiscommand cancelsthe previoushorizontaltabsettings.
§ When setting n=8, the print position ismoved tocolumn9bysending HT.
§ Upto32 tabpositions(k=32)can beset. Dataexceeding32 tabpositions
isprocessed asnormaldata.
§ Transmit [n] k inascendingorderand placeaNULcode 0at the end. When
[n]k isless than orequaltotheprecedingvalue [n]k-1,tabsettingisfinished
and the followingdataisprocessed asnormaldata.
§ ESCDNUL cancelsall horizontaltabpositions.
§ The previouslyspecified horizontaltabpositionsdo not change, even ifthe
characterwidthchanges.
§ Characterwidthisabsoluteinstandardmode and pagemode.
[Default] The default tabpositionsareat intervalsof8characters(columns9, 17, 25, ...)
forthe font B(12 14).
[Reference]HT
15 ESCEnTurnemphasizedmodeon/off
[Format] ASCII ESCEn
Hex1B45 n
Decimal27 69 n
[Range]0 ≤n ≤255
[Description]Turnemphasized mode on/off