CognitiveTPG A799 Instruction Manual

Includes TPG LogoEZ® colorization informationProgramming GuideA799 Two-Color Thermal Receipt PrinterMade under one or more of the following U.S. paten

A799 Programming GuideChapter 1: About this Guide10 Revision D 12/09A799-PG00001D

Chapter 4: Programming Commands100Revision D 12/09A799-PG00001DValues:First variation: String terminated with NUL character. Length k is not specied

Chapter 4: Programming Commands 101Revision D 12/09A799-PG00001DPrint multiple barcodesASCII GS k Hexadecimal 1D 6B FF n Decimal 29 108 255All the

Chapter 4: Programming Commands102Revision D 12/09A799-PG00001DPrint GS1 DataBar (formerly RSS), null terminatedASCII GS k n d1... 00Hexadecimal 1

Chapter 4: Programming Commands 103Revision D 12/09A799-PG00001DSet GS1 DataBar (formerly RSS) parametersSetting of parameters for GS! DataBarASCII

Chapter 4: Programming Commands104Revision D 12/09A799-PG00001DSample symbol description:Each PDF 417 symbol consists of 3 to 90 stacked rows surround

Chapter 4: Programming Commands 105Revision D 12/09A799-PG00001DPage modePage mode is one of two modes that the A799 printer uses to operate. Standar

Chapter 4: Programming Commands106Revision D 12/09A799-PG00001DSelect page modeASCII ESC L Hexadecimal 1B 4C Decimal 27 76Switches from standard mo

Chapter 4: Programming Commands 107Revision D 12/09A799-PG00001DSelect standard modeASCII ESC S Hexadecimal 1B 53 Decimal 27 83Switches from page

Chapter 4: Programming Commands108Revision D 12/09A799-PG00001DSet print area in page modeASCII ESC W n1, n2 ...n8 Hexadecimal 1B 57 n1, n2 ...n8 De

Chapter 4: Programming Commands 109Revision D 12/09A799-PG00001DSet absolute vertical print position in page modeASCII GS $ nL nH Hexadecimal 1D 24

Chapter 2: Diagnostics and Conguration 11Revision D 12/09A799-PG00001DChapter 2: Diagnostics and CongurationThe A799 printer performs a number of d

Chapter 4: Programming Commands110Revision D 12/09A799-PG00001DMacrosThese commands are used to select and perform a user-dened sequence of printer o

Chapter 4: Programming Commands 111Revision D 12/09A799-PG00001DUser data storageWrite to user data storageASCII ESC ‘ m a0 a1 a2 d1 ... dm Hexadeci

Chapter 4: Programming Commands112 Revision D 12/09A799-PG00001DSelect memory type (SRAM/ash) where to save logos or user-dened fontsASCII GS “ n H

Chapter 4: Programming Commands 113Revision D 12/09A799-PG00001DExpanded ash memory allocationASCII GS “ 0x80 Hexadecimal 1D 22 80 Decimal 29 34

Chapter 4: Programming Commands114Revision D 12/09A799-PG00001DSelect ash area for storing logos and user-dened charactersASCII GS” 0x81 Hexadecima

Chapter 4: Programming Commands 115Revision D 12/09A799-PG00001DUser storage status (ColorPOS®)ASCII GS 0x97 m n Hexadecimal 1D 97 m n Decimal 29

Chapter 4: Programming Commands116Revision D 12/09A799-PG00001DFlash downloadThese commands are used to load rmware into the printer.The commands are

Chapter 4: Programming Commands 117Revision D 12/09A799-PG00001DReturn segment number status of ash memoryASCII GS SOH Hexadecimal 1D 01 Decimal

Chapter 4: Programming Commands118Revision D 12/09A799-PG00001DErase all ash contents except boot sectorASCII GS SO Hexadecimal 1D 0E Decimal 29 1

Chapter 4: Programming Commands 119Revision D 12/09A799-PG00001Dcommunications failed or that the write to ash failed. The alternatives seem to be t

Chapter 2: Diagnostics and Conguration12 Revision D 12/09A799-PG00001DRuntime diagnosticsRuntime diagnostics (sometimes called level 2 diagnostics) r

Chapter 4: Programming Commands120Revision D 12/09A799-PG00001DSetting the GatewayASCII US BS ETX n1 n2 n3 n4 Hexadecimal 1F 08 03 n1 n2 n3

Chapter 4: Programming Commands 121Revision D 12/09A799-PG00001DDHCP (auto-conguration)ASCII US BS BS n1 Hexadecimal 1F 08 08 n1

Chapter 4: Programming Commands122Revision D 12/09A799-PG00001D

Appendix A: Commands by Hexadecimal Code 123Revision D 12/09A799-PG00001DAppendix A: Commands listed by hexadecimal codeBy command codeCode (hexadec

Appendix A: Commands by Hexadecimal Code124Revision D 12/09A799-PG00001DCode (hexadecimal) Command Page1B 33 n Set vertical line spacing 471B 34

Appendix A: Commands by Hexadecimal Code 125Revision D 12/09A799-PG00001DCode (hexadecimal) Command Page1C 70 m n Print ash logo 711C 71 n ...

Appendix A: Commands by Hexadecimal Code126Revision D 12/09A799-PG00001DCode (hexadecimal) Command Page 1D 68 n Select bar code height 991D 6B m d

Appendix A: Commands by Hexadecimal Code 127Revision D 12/09A799-PG00001DCode (hexadecimal) Command Page 1F 03 17

Appendix B: Resident Character Sets128 Revision D 12/09A799-PG00001D

Appendix B: Resident Character Sets 129Revision D 12/09A799-PG00001DAppendix B: Resident Character SetsCharacter setsCode page 437 (US)

Chapter 2: Diagnostics and Conguration 13Revision D 12/09A799-PG00001DFor more information about See this section Accessing the remote diagnostic t

Appendix B: Resident Character Sets130 Revision D 12/09A799-PG00001DCode page 737 (Greek)

Appendix B: Resident Character Sets 131Revision D 12/09A799-PG00001DCode page 850 (Multilingual)

Appendix B: Resident Character Sets132 Revision D 12/09A799-PG00001DCode page 852 (Slavic)

Appendix B: Resident Character Sets 133Revision D 12/09A799-PG00001DCode page 857 (Turkish)

Appendix B: Resident Character Sets134 Revision D 12/09A799-PG00001DCode page 858 (with Eurosymbol)

Appendix B: Resident Character Sets 135Revision D 12/09A799-PG00001DCode page 860 (Portuguese)

Appendix B: Resident Character Sets136 Revision D 12/09A799-PG00001DCode page 862 (Hebrew)

Appendix B: Resident Character Sets 137Revision D 12/09A799-PG00001DCode page 863 (French Canadian)

Appendix B: Resident Character Sets138 Revision D 12/09A799-PG00001DCode page 865 (Nordic)

Appendix B: Resident Character Sets 139Revision D 12/09A799-PG00001DCode page 866 (Cyrillic)

Chapter 2: Diagnostics and Conguration14 Revision D 12/09A799-PG00001DIndicatorsThe printer communicates various conditions both visually, with the g

Appendix B: Resident Character Sets140 Revision D 12/09A799-PG00001DCode page 1252 (Windows Latin 1)

A799 Two-Color Thermal Receipt Printer: Programmer Guide A799-PG00001 Rev. D 12/09

Chapter 2: Diagnostics and Conguration 15Revision D 12/09A799-PG00001DPrinter congurationPrinters are shipped with all the functions and parameters

Chapter 2: Diagnostics and Conguration16 Revision D 12/09A799-PG00001DConguring the printerThe conguration menu allows you to select functions or c

Chapter 2: Diagnostics and Conguration 17Revision D 12/09A799-PG00001DCommunication interfaceTo change the communication interface settings, enter t

Chapter 2: Diagnostics and Conguration18 Revision D 12/09A799-PG00001DDiagnostic modesTo change the diagnostic modes enter the conguration menu, sel

Chapter 2: Diagnostics and Conguration 19Revision D 12/09A799-PG00001DEnable or disable receipt test modeThe receipt test mode veries proper receip

Changes or modications to this unit not expressly approved by the party responsible for compliance could void the user’s authority to operate the equ

Chapter 2: Diagnostics and Conguration20 Revision D 12/09A799-PG00001DPrinter settings and functionsTo change the printer settings and functions, ent

Chapter 2: Diagnostics and Conguration 21Revision D 12/09A799-PG00001DSelect the hardware options sub-menu to set: • Printhead setting This settin

Chapter 2: Diagnostics and Conguration22 Revision D 12/09A799-PG00001D

Chapter 3: Programming the Printer 23Revision D 12/09A799-PG00001DChapter 3: Programming the PrinterOverview of commandsCommands control all operatio

Chapter 3: Programming the Printer24Revision D 12/09A799-PG00001DCommand Description Dierence between previous product and new product emulati

Chapter 3: Programming the Printer 25Revision D 12/09A799-PG00001DTPG ColorPOS® two-color and color interpreted commands (continued)Hexadecimal ASCI

Chapter 3: Programming the Printer26Revision D 12/09A799-PG00001DCharacter appearanceThe appearance of text can be changed using the following print m

Chapter 3: Programming the Printer 27Revision D 12/09A799-PG00001DPrint zones for 82.5mm paperSpecications of print zone for 82.5 mm paper:• 640 do

Chapter 3: Programming the Printer28Revision D 12/09A799-PG00001DEmulation modesThe CognitiveTPG A799 printer may be operated in a number of different

Chapter 4: Programming Commands 29Revision D 12/09A799-PG00001DChapter 4: Programming CommandsCommands listed by functionPrinter actionsCode (hexadec

A799 Programming GuideContents 3Revision D 12/09A799-PG00001DContentsChapter 1: About this Guide ...

Chapter 4: Programming Commands30Revision D 12/09A799-PG00001DVertical and horizontal positioning Code (hexadecimal) Command Page09 Horizontal tab

Chapter 4: Programming Commands 31Revision D 12/09A799-PG00001D1D 8D n m Text strike-through mode 621D F0 01 n Select font ID number 621D F0 02 n

Chapter 4: Programming Commands32Revision D 12/09A799-PG00001D1F 03 16 f s p/r t LogoEZ® colorization 771F 03 17 a m s LogoEZ® attribute mapping

Chapter 4: Programming Commands 33Revision D 12/09A799-PG00001D1D 71 a b c d e f L f H Set GSI Databar (formerly RSS) parameters 1031D 77 n Select

Chapter 4: Programming Commands34Revision D 12/09A799-PG00001DFlash downloadCode (hexadecimal) Command Page1B 5B 7D Switch to ash download mode 1

Chapter 4: Programming Commands 35Revision D 12/09A799-PG00001DCommand conventionsThe following information describes how each command is organized:N

Chapter 4: Programming Commands36Revision D 12/09A799-PG00001DPerform full knife cutASCII EM ESC i Hexadecimal 19 1B 69 Decimal 25 27 105Cuts th

Chapter 4: Programming Commands 37Revision D 12/09A799-PG00001DInitialize printerASCII ESC @ Hexadecimal 1B 40 Decimal 27 64Default: Character pi

Chapter 4: Programming Commands38Revision D 12/09A799-PG00001DSelect sensors to stop printingASCII ESC c 4 n Hexadecimal 1B 63 34 n Decimal 27 99 5

Chapter 4: Programming Commands 39Revision D 12/09A799-PG00001DSet current colorASCII ESC r m Hexadecimal 1B 72 m Decimal 27 114 mDefault of m: 0

A799 Programming GuideContents4 Revision D 12/09A799-PG00001DChapter 4: Programming Commands ...29Command

Chapter 4: Programming Commands40Revision D 12/09A799-PG00001DSet paper type (ColorPOS®)ASCII GS 0x81 m n Hexadecimal 1D 81 m n Decimal 29 129 m nV

Chapter 4: Programming Commands 41Revision D 12/09A799-PG00001DFont and lines per inch (LPI) setup for dierent emulationsEmulation LPI Font(s) Fo

Chapter 4: Programming Commands42Revision D 12/09A799-PG00001DPrint and paper feedThe print and feed commands control printing on the receipt and pape

Chapter 4: Programming Commands 43Revision D 12/09A799-PG00001DAdd n extra dot rowsASCII SYN n Hexadecimal 16 n Decimal 22 nValue of n: Number of

Chapter 4: Programming Commands44Revision D 12/09A799-PG00001DPrint and feed paperASCII ESC J n Hexadecimal 1B 4A n Decimal 27 74 nValue of n: n/2

Chapter 4: Programming Commands 45Revision D 12/09A799-PG00001DVertical and horizontal positioningThe horizontal positioning commands control the hor

Chapter 4: Programming Commands46Revision D 12/09A799-PG00001DSet absolute starting positionASCII ESC $ nL nH Hexadecimal 1B 24 nL nH Decimal 27 36

Chapter 4: Programming Commands 47Revision D 12/09A799-PG00001DSet vertical line spacingASCII ESC 3 n Hexadecimal 1B 33 n Decimal 27 51 nValue of

Chapter 4: Programming Commands48Revision D 12/09A799-PG00001DSet relative print positionASCII ESC \ n1 n2 Hexadecimal 1B 5C n1 n2 Decimal 27 92 n1

Chapter 4: Programming Commands 49Revision D 12/09A799-PG00001Dprevious data. This behavior can be used to an application’s advantage to provide the

A799 Programming GuideContents 5Revision D 12/09A799-PG00001DVertical and horizontal positioning ...45Ho

Chapter 4: Programming Commands50Revision D 12/09A799-PG00001DSet printing area widthASCII GS W nL nH Hexadecimal 1D 57 nL nH Decimal 29 87 nL nHRa

Chapter 4: Programming Commands 51Revision D 12/09A799-PG00001DText characteristics commandsThese commands control what the printed information looks

Chapter 4: Programming Commands52Revision D 12/09A799-PG00001DSelect pitch (column width)ASCII ESC SYN n Hexadecimal 1B 16 n Decimal 27 22 nValue o

Chapter 4: Programming Commands 53Revision D 12/09A799-PG00001DSelect print modeASCII ESC ! n Hexadecimal 1B 21 n Decimal 27 33 n Value of n: Pit

Chapter 4: Programming Commands54Revision D 12/09A799-PG00001DSelect or cancel user-dened character setASCII ESC % n Hexadecimal 1B 25 n Decimal 2

Chapter 4: Programming Commands 55Revision D 12/09A799-PG00001DDene extended user-dened character setASCII US & s c1 c2 [character 1 data] .

Chapter 4: Programming Commands56Revision D 12/09A799-PG00001DCopy character set from ROM to RAMASCII ESC : 0 0 0 Hexadecimal 1B 3A 30 30 30 Decimal

Chapter 4: Programming Commands 57Revision D 12/09A799-PG00001DSelect or cancel double-strikeASCII ESC G n Hexadecimal 1B 47 n Decimal 27 71 nValu

Chapter 4: Programming Commands58Revision D 12/09A799-PG00001DSelect international character code ASCII ESC R n Hexadecimal 1B 52 n Decimal 27 82 n

Chapter 4: Programming Commands 59Revision D 12/09A799-PG00001DSelect international character set ASCII: ESC t n Hexadecimal: 1B 74 n Decimal: 27

A799 Programming GuideContents6 Revision D 12/09A799-PG00001DGraphics ...

Chapter 4: Programming Commands60Revision D 12/09A799-PG00001DSelect character sizeASCII GS ! n Hexadecimal 1D 21 n Decimal 29 33 nValue of n: 1–8

Chapter 4: Programming Commands 61Revision D 12/09A799-PG00001DTurns on white/black reverse print mode. In white/black reverse print mode, print dots

Chapter 4: Programming Commands62Revision D 12/09A799-PG00001DText strike-through mode (ColorPOS®)ASCII GS 0x85 m n Hexadecimal 1D 8D n m Decimal 2

Chapter 4: Programming Commands 63Revision D 12/09A799-PG00001DSave font ID number as default font at power upASCII GS 0xF0 0x03 Hexadecimal 1D F0

Chapter 4: Programming Commands64Revision D 12/09A799-PG00001DSelect active user-dened character setSelects user-dened character set number for down

Chapter 4: Programming Commands 65Revision D 12/09A799-PG00001DSelect bit image modeASCII ESC * m n1 n2 d1 ... dn Hexadecimal 1B 2A m n1 n2 d1 ...

Chapter 4: Programming Commands66Revision D 12/09A799-PG00001DPrint advanced raster graphicsASCII ESC . m n rL rH d1 … dn Hexadecimal 1B 2E m n rL r

Chapter 4: Programming Commands 67Revision D 12/09A799-PG00001DSelect the current logoASCII GS # n Hexadecimal 1D 23 n Decimal 29 35 nRange of n:

Chapter 4: Programming Commands68Revision D 12/09A799-PG00001DDene downloaded bit imageASCII GS * n1 n2 d1 ... dn] Hexadecimal 1D 2A n1 n2 d1 ... d

Chapter 4: Programming Commands 69Revision D 12/09A799-PG00001DPrint downloaded bit imageASCII GS / m Hexadecimal 1D 2F m Decimal 29 47 mValue and

A799 Programming GuideContents 7Revision D 12/09A799-PG00001DReal time request to printer ...

Chapter 4: Programming Commands70Revision D 12/09A799-PG00001DPrint raster monochrome graphics (ColorPOS®)ASCII GS 0x82 n1…..n72 (576 dots) for 80 mm

Chapter 4: Programming Commands 71Revision D 12/09A799-PG00001DDownload logo image (ColorPOS®)ASCII GS 0x84 m n1 n2 d1…..dx , x = (n1 * n2*8 ) * m

Chapter 4: Programming Commands72Revision D 12/09A799-PG00001DApply shading to logo (ColorPOS®)ASCII GS Ox8B n m o Hexadecimal 1D 8B n m o Decimal

Chapter 4: Programming Commands 73Revision D 12/09A799-PG00001DColor shade mode (ColorPOS®)ASCII GS 0x87 m Hexadecimal 1D 87 m Decimal 29 135 mThi

Chapter 4: Programming Commands74Revision D 12/09A799-PG00001DThe geometric location points for this graphic are dened by a rectangular area start po

Chapter 4: Programming Commands 75Revision D 12/09A799-PG00001DApply margin message mode (ColorPOS®)ASCII GS 0x99 l m n o Hexadecimal: 1D 99 l m n

Chapter 4: Programming Commands76Revision D 12/09A799-PG00001DLogo print with knife cutASCII GS 0x9B m n Hexadecimal 1D 9B m n Decimal 29 155 m

Chapter 4: Programming Commands 77Revision D 12/09A799-PG00001DSet LogoEZ® colorizationASCII US ETX SYN f s p/t t Hexadecimal 1F 03 16 f s p/t t De

Chapter 4: Programming Commands78Revision D 12/09A799-PG00001Df = 2 link watermark printing Example: Activate watermark printing using logo #F1

Chapter 4: Programming Commands 79Revision D 12/09A799-PG00001Df = 4 link logo print before cut Prints a logo after the skip distance of “s” befor

A799 Programming GuideContents8 Revision D 12/09A799-PG00001DReturn microprocessor CRC ...

Chapter 4: Programming Commands80Revision D 12/09A799-PG00001DA word (2 bytes) is used to identify the attribute mapping, with “m” bits 0 – 6 identify

Chapter 4: Programming Commands 81Revision D 12/09A799-PG00001DRelated informationThis command is utilized in the TPG LogoEZ® utility. The utility ca

Chapter 4: Programming Commands82Revision D 12/09A799-PG00001DStatusStatus command introductionThe A799 has three methods of providing status to the a

Chapter 4: Programming Commands 83Revision D 12/09A799-PG00001DRequest alternate status (A793 emulation only)ASCII ESC u n Hexadecimal 1B 75 n Deci

Chapter 4: Programming Commands84Revision D 12/09A799-PG00001DTransmit printer IDASCII GS I n Hexadecimal 1D 49 n Decimal 29 73 nValue of n: 1, 49

Chapter 4: Programming Commands 85Revision D 12/09A799-PG00001DTransmit printer ID, remote diagnostics extensionASCII GS I @ n Hexadecimal 1D 49 40

Chapter 4: Programming Commands86Revision D 12/09A799-PG00001DValue of n (continued)ASCII Hex Dec Remote diagnostic item Function å 86 134 Kni

Chapter 4: Programming Commands 87Revision D 12/09A799-PG00001DThe status bytes to be transmitted are described in the three tables on the next page

Chapter 4: Programming Commands88Revision D 12/09A799-PG00001DCash drawer status (n = 2 or n = 50)Bit O/On Hex Decimal Status for transmit status

Chapter 4: Programming Commands 89Revision D 12/09A799-PG00001DReal time commandsThe real time commands provide an application interface to the print

Chapter 1: About this Guide 9Revision D 12/09A799-PG00001DChapter 1: About this GuideHow to use this guideThis is a supplemental guide providing prog

Chapter 4: Programming Commands90Revision D 12/09A799-PG00001DMoving data through the buerApplications should not let the buffer ll up with real tim

Chapter 4: Programming Commands 91Revision D 12/09A799-PG00001DExceptionsThe command is ignored if n is out of range.An application using DLE (0x10)

Chapter 4: Programming Commands92Revision D 12/09A799-PG00001D3 = Transmit error statusBit Status Hex Decimal Function0 O 00 0 Fixed to o.1

Chapter 4: Programming Commands 93Revision D 12/09A799-PG00001DReal time request to printer GS sequence DLE sequenceASCII GS ETX n DLE ENQ n He

Chapter 4: Programming Commands94Revision D 12/09A799-PG00001DReal time printer status transmissionASCII GS ENQ Hexadecimal 1D 05 Decimal 29 5Trans

Chapter 4: Programming Commands 95Revision D 12/09A799-PG00001DUnsolicited status modeSelect or cancel unsolicited status mode (USM)ASCII: GS a n He

Chapter 4: Programming Commands96Revision D 12/09A799-PG00001DFirst Byte (Printer Information)Bit O/On Hex Decimal Status for USM0 O 00 0 No

Chapter 4: Programming Commands 97Revision D 12/09A799-PG00001DThird byte (paper sensor information)Bit O/On Hex Decimal Status for USM0 O 00

Chapter 4: Programming Commands98Revision D 12/09A799-PG00001DRecognizing data from the printerAn application sending various real time and non-real t

Chapter 4: Programming Commands 99Revision D 12/09A799-PG00001DSelect pitch of HRI charactersASCII GS f n Hexadecimal 1D 66 n Decimal 29 102 nValu