CognitiveTPG A799 Programming Manual

CognitiveTPG A799 Programming Manual

A799 two-color thermal receipt printer
Hide thumbs Also See for A799:
Table of Contents

Advertisement

A799 Two-Color Thermal Receipt Printer
Programming Guide
Includes TPG LogoEZ
colorization information
®
Made under one or more of the following U.S. patents:
4886381, 5579043, 5613787, 5651624, 5713678, 5752779, 5789916,
5800080, 5879090, 5887999, 5975776, 6027266, 6085973, 6089450,
6129465, 6155483, 6404452, 6486902, 6504331, 5749277, 6722754,
6739773, 6784909.

Advertisement

Table of Contents
loading
Need help?

Need help?

Do you have a question about the A799 and is the answer not in the manual?

Questions and answers

Subscribe to Our Youtube Channel

Summary of Contents for CognitiveTPG A799

  • Page 1 A799 Two-Color Thermal Receipt Printer Programming Guide Includes TPG LogoEZ colorization information ® Made under one or more of the following U.S. patents: 4886381, 5579043, 5613787, 5651624, 5713678, 5752779, 5789916, 5800080, 5879090, 5887999, 5975776, 6027266, 6085973, 6089450, 6129465, 6155483, 6404452, 6486902, 6504331, 5749277, 6722754,...
  • Page 2 No part of this document may be reproduced, transmitted, or translated in any form or by any means, electronic or mechanical, for any purpose without the express written permission of CognitiveTPG. Copyright Copyright © 2009 by TPG IPB, Inc., 950 Danby Road, Ithaca, New York 14850, USA. All rights reserved. Printed in USA. Confidential, Unpublished. Property of TPG IPB, Inc. Trademarks CogntiveTPG™...
  • Page 3: Table Of Contents

    Select the hardware options sub-menu to set: ........21 Chapter 3: Programming the Printer ..........23 Overview of commands ..............23 Comparison to A793 .................23 Two-color commands (comparison A794 to A799) ......24 Character appearance...............26 Width specifications ................26 Standard ....................... 26 Compressed ......................26 Print zones ..................26...
  • Page 4 A799 Programming Guide Revision D 12/09 Contents Chapter 4: Programming Commands ..........29 Commands listed by function ............29 Printer actions ...................29 Print and paper feed ................29 Vertical and horizontal positioning ..........30 Text characteristics ................30 Graphics ....................31 Status ....................32 Batch mode ......................32 Real time .......................
  • Page 5 A799 Programming Guide Revision D 12/09 Contents Vertical and horizontal positioning ..........45 Horizontal tab ..................... 45 Set horizontal and vertical minimum motion units ......45 Set column ......................45 Set absolute starting position ............... 46 Set vertical line spacing to 1/6 inch ............46 Set vertical line spacing ..................
  • Page 6 A799 Programming Guide Revision D 12/09 Contents Graphics .....................64 Download BMP logo ..................64 Select bit image mode ..................65 Print advanced raster graphics ..............66 Select single-density graphics ..............66 Select double-density graphics ..............66 Select the current logo ..................67 Define downloaded bit image ..............
  • Page 7 A799 Programming Guide Revision D 12/09 Contents Real time request to printer ................93 Real time printer status transmission ............94 Real time commands disabled ..............94 Unsolicited status mode ..............95 Select or cancel unsolicited status mode (USM) ........95 Recognizing data from the printer ..............
  • Page 8 A799 Programming Guide Revision D 12/09 Contents Return microprocessor CRC .................117 Erase all flash contents except boot sector ..........118 Return main program flash CRC ..............118 Erase selected flash sector ................118 Download to active flash sector ..............118 Reset firmware ....................119 Ethernet setup commands .............119 Restore default settings ................119...
  • Page 9: Chapter 1: About This Guide

    Where to find the basics If you are looking for information on setup or basic operation, refer to the A799 User Guide. The programming guide assumes that you have the A799 User Guide handy for reference or are already familiar with the printer.
  • Page 10 A799 Programming Guide Revision D 12/09 Chapter 1: About this Guide A799-PG00001D...
  • Page 11: Chapter 2: Diagnostics And Configuration

    Revision D 12/09 Chapter 2: Diagnostics and Configuration Chapter 2: Diagnostics and Configuration The A799 printer performs a number of diagnostics that provide useful information about the operating status of the printer. The following diagnostic tests are available. • Start-up diagnostics Performed during the printer’s start-up cycle.
  • Page 12: Runtime Diagnostics

    • Number of flash cycles • CRC number • Number of cutter jams • Number of lines printed • Number of times the cover is opened • Number of knife cuts • Maximum temperature reached (See tallies note on the following page.) A799-PG00001D...
  • Page 13 Print test and configuration menu samples will vary per model or printer configuration. (Shown approximately 60% of size.) For more information about See this section Accessing the remote diagnostic tallies “Command descriptions” in Chapter 4: Programming commands (Status commands: Transmit printer ID, remote diagnostics extension, Hexadecimal 1D 49 40 n) A799-PG00001D...
  • Page 14: Indicators

    See this section Error conditions and correcting them “ Troubleshooting the printer” on page 30, Chapter 4: Using the Printer, in the A799 User Guide Communication of printer status to the host application “Command descriptions” in Chapter 4: Programming commands, Status sections.
  • Page 15: Printer Configuration

    Paper width Normal Printhead setting Datascope Receipt test For more information about See this section • Printer Emulations Using the configuration menu “Configuring the printer” to configure the printer on page 16. Native mode A794 emulation A793 emulation LEGACY emulation A799-PG00001D...
  • Page 16: Configuring The Printer

    4 Make sure receipt paper is loaded in the printer before �������� � � b. Open the receipt cover. ������ � ���� proceeding. (For loading instructions, see the A799 ������������ � ������� Press and hold the paper feed button while closing ���������������� � ������...
  • Page 17: Communication Interface

    • Alternate DTR/DSR Enabled Disabled Note: Press the paper feed button for at least one second to validate the selection. For more information about See this section Setting the RS-232C Serial “Configuring the printer” interface settings on page 16 A799-PG00001D...
  • Page 18: Diagnostic Modes

    2 Disable the data scope mode. 3 Exit the configuration menu. The printer is on-line and can communicate normally with the host computer. For more information about See this section Enabling the data scope mode “Configuring the printer” on page 16 A799-PG00001D...
  • Page 19: Enable Or Disable Receipt Test Mode

    The A793, A794 and Legacy Command emulations do not recognize the ColorPOS commands. ® Note: Press the paper feed button for at least one second to validate the selection. For more information about See this section Setting the printer emulation “Configuring the Printer”, page 16 A799-PG00001D...
  • Page 20: Printer Settings And Functions

    This function is used to determine what printer ID value is returned in response to a Transmit printer ID command (1D 49 n) when the printer is in A794 emulation mode. The printer can be configured to send back the ID of the A799, A794, A793 or Application Compatible Escape Command systems.
  • Page 21: Select The Hardware Options Sub-Menu To Set

    This setting is the printhead energy rating and must match the rating marked on the front right of the thermal mechanism in the printer. Whenever a new thermal mechanism is installed, this setting must match the indicated energy rating on the mechanism. (See A799 Service manual for replacing the thermal mechanism.) • Paper Type Name Sets the printer to optimum performance for paper being used.
  • Page 22 Revision D 12/09 Chapter 2: Diagnostics and Configuration A799-PG00001D...
  • Page 23: Chapter 3: Programming The Printer

    Any nonlegal commands have their parameter sent to the print buffer as data. Comparison to A793 The following table details the list of commands whose behavior differs between the A793, A794, and A799 because of the physical differences of a 6 dots/mm head (A793) versus an 8 dots/mm head (A794 and A799).
  • Page 24: Two-Color Commands (Comparison A794 To A799)

    Print and feed paper This command uses n in terms of n/360 inches. Since the A793 had a fundamental step of 1/152 inch and the A799 has a fundamental step of 1/203 inch, the actual line spacing will not exactly match the requested spacing.
  • Page 25 1F 03 17 a m s US ETX ETB a m s Set attribute mapping Note: The new TPG LogoEZ colorization utility provides you a fast and easy way to get basic two-color and logos onto ® your receipt without having to enter commands. Check out the CognitiveTPG Website at: www.CognitiveTPG.com.
  • Page 26: Character Appearance

    576 addressable bits of graphics across an 80mm wide receipt. Minimum print line height is 24 dots for text or graphics. Standard print line spacing is 27 dots (i.e., 3 extra row dots). The A799 adds a 27 dot high font, so standard print spacing is 30 dots. A799-PG00001D...
  • Page 27: Print Zones For 82.5Mm Paper

    Resulting output (1B 7B n) (1B 56 n) (1B 12) Canceled Canceled Cleared A B C Canceled Canceled Note: The following print modes cannot be mixed on the same line: • Right-side up and upside-down • Single-high (normal) and double-high A799-PG00001D...
  • Page 28: Emulation Modes

    LPI will be changed as in the table above. • If emulation is switched from any emulation to A799 native, the font and LPI will remain unchanged because the A799 native mode supports all font and LPI options offered in the emulation modes.
  • Page 29: Chapter 4: Programming Commands

    Print and feed paper one line Print and carriage return Feed n print lines 15 n Feed n dot rows 16 n Add n extra dot rows Print 1B 4A n Print and feed paper 1B 64 n Print and feed n lines A799-PG00001D...
  • Page 30: Vertical And Horizontal Positioning

    1B 7B n Select or cancel upside-down print mode 1D 21 n Select character size 1D 42 n Select or cancel white/black reverse print mode 1D 62 n Set smoothing 1D 85 m n Reverse color text mode (two-color) A799-PG00001D...
  • Page 31: Graphics

    Background logo print mode 1D 99 l m n o Apply margin message mode 1D 9A n m o Shade and store logo 1D 9B m n Logo print with knife cut 1D A0 nl nh Set temporary max target speed A799-PG00001D...
  • Page 32: Status

    1D 6B n d1... 00 Print GSI Databar (formerly RSS), null terminated 1D 6B m n L n H d1... dn Print GSI Databar (formerly RSS), data length specified 1D 70 a b c d e f Select PDF 417 parameters A799-PG00001D...
  • Page 33: Page Mode

    Select memory type (SRAM/flash) where to save logos or user-defined fonts 1D 22 55 n1 n2 Flash memory user sectors allocation 1D 22 80 Expanded flash memory allocation 1D 22 81 n Select flash area 1D 40 n Erase user flash sector 1D 97 m n User storage status A799-PG00001D...
  • Page 34: Flash Download

    Set raw TCPIP port 1F 08 05 n1 LP Daemon 1F 08 06 n1 Telnet Daemon 1F 08 07 n1 BootP 1F 08 08 n1 DHCP (auto-configuration) 1F 08 09 n1 Inactivity timeout 1F 08 0A n1 Keep-alive pings (arps) A799-PG00001D...
  • Page 35: Command Conventions

    • Line spacing, pitch, and user-defined character sets are maintained at current selections (RAM is not affected) • Single-wide, single-high, non-rotated, and left-aligned characters are set • Printing position is set to column one Related Information This command is recognized in A793 emulation and A799 native mode, ignored in LEGACY emulation. A799-PG00001D...
  • Page 36: Perform Full Knife Cut

    Selects the device to which the host computer sends data. Related information Other bits of n (1–7) are undefined and ignored. When the printer is disabled by this command, it ignores transmitted data until the printer is re-enabled by the same command. A799-PG00001D...
  • Page 37: Initialize Printer

    When multiple sensors have been selected, anytime one of the sensors detects a paper-end, the paper end signal is output. When this command is executed a sensor is switched. The paper-end signal switching is delayed depending on the receive buffer state. Exceptions The command is ignored, except in parallel communications. A799-PG00001D...
  • Page 38: Select Sensors To Stop Printing

    • On-time = p1 (Hex) x 2 msec • Off-time = p2 (Hex) x 2 msec Related information Off-time is the delay before the printer performs the next operation. Refer to cash drawer specifications for required on and off-time. A799-PG00001D...
  • Page 39: Set Current Color

    Selects a mode for cutting paper and cuts the paper. There are two formats for this command, one requiring one parameter m, the other requiring two parameters m and n. The format is indicated by the parameter m. Formulas n times the vertical motion unit is used to determine the cutting position to which the paper is fed. A799-PG00001D...
  • Page 40: Set Paper Type (Colorpos ® )

    LPI will be changed as in the table on next page. • If emulation is switched from any emulation to A799 native, the font and LPI will remain unchanged because the A799 native mode supports all font and LPI options offered in the emulation modes.
  • Page 41: Set Interpretation Of "Set Current Color" Command

    = 00 will cause 1B 72 00 to print red and all other values to print black. This command defines how to interpret the 1B 72 command for legacy environments. It provides a method to resolve any differences in the definition of command 1B72 between the A799 native mode and earlier implementations in other printers.
  • Page 42: Print And Paper Feed

    The number of lines to feed at current line height setting. Range of n: 0–255 in A799 native mode 0–127 in A793 emulation Feeds the paper n lines at the current line height without printing. Ignored on receipt if current line is not empty.
  • Page 43: Add N Extra Dot Rows

    This is ignored in LEGACY emulation and the parameter byte goes into the print buffer. Print ASCII Hexadecimal Decimal Prints one line from the buffer and feeds paper one line. Executes LF on receipt. Related information This command is ignored in LEGACY emulation. A799-PG00001D...
  • Page 44: Print And Feed Paper

    1B 4A n Decimal 27 74 n Value of n: n/203 inch in A799 native mode, A794 emulation and Application Compatible Escape Commands emulation mode; n/360 inch in A793 emulation mode Range of n: 0–255 Prints one line from the buffer and feeds the paper n/8 mm (n/203 inch). The line height equals the character height when n is too small.
  • Page 45: Vertical And Horizontal Positioning

    Prints the first character of the next print line in column n. It must be sent for each line not printed at column one. The value of n is set to one after each line. Exceptions This command cannot be used with single- or double-density graphics. Related information This is ignored in LEGACY emulation and the parameter byte goes into the print buffer. A799-PG00001D...
  • Page 46: Set Absolute Starting Position

    In order to improve the speed of printing, the A799 moves the data into a buffer for the printhead when it receives it. When the “Set relative print position” command contains a move to the left, this causes the new data to overstrike the previous data.
  • Page 47: Set Vertical Line Spacing

    ESC 3 n Hexadecimal 1B 33 n Decimal 27 51 n Value of n: n/406 inch in A799 native mode, A794 emulation n/360 inch in A793 emulation mode n/203 inch in Application Compatible Escape Commands emulation mode Range of n: 0-255 Default: 3.37 mm (0.13 inch)
  • Page 48: Set Relative Print Position

    In order to improve the speed of printing, the A799 moves the data into a buffer for the printhead when it receives it. When the “Set relative print position” command contains a move to the left, this causes the new data to overstrike the Continued...
  • Page 49: Select Justification

    GS L 150 1 Where 2 inches = 406/203, and 406 = (1 X 256) + 150. Exceptions: The command is effective only at the beginning of a line. This command is ignored if the line buffer is not empty. A799-PG00001D...
  • Page 50: Set Printing Area Width

    Where 2 inches = 406/203, and 406 = (1 X 256) + 150. Exceptions This command is effective only at the beginning of a line. If the setting exceeds the printable area, the maximum value of the printable area is used. The maximum printable area is 576 dots. See the illustration. A799-PG00001D...
  • Page 51: Text Characteristics Commands

    This command is valid only at the beginning of a line. Rotated print and non-rotated print characters cannot be used together in the same line. Related information See “Summary of rotated printing” in this document. This command is ignored in LEGACY emulation. A799-PG00001D...
  • Page 52: Select Pitch (Column Width)

    (set by select print direction in page mode, 1B 54 n) the vertical motion unit (y) is used. Related information This is ignored in LEGACY emulation and the parameter byte goes into the print buffer. In the A793 emulation, the command and parameter byte are ignored. A799-PG00001D...
  • Page 53: Select Print Mode

    Look in Chapter 3: Programming the Printer, “Character appearance” for a description of standard and compressed character pitches. The bits in this command perform the same function as the stand-alone functions: 1B 16 n Select pitch 1B 45 n Emphasized 1B 47 n Double-strike Double-wide Single-wide 1B 2D n Underline A799-PG00001D...
  • Page 54: Select Or Cancel User-Defined Character Set

    (1B 40) is received. Any invalid byte (s, c1, c2, n1) aborts the command. Related information See 1D 22 n (select memory type) to save user-defined characters. A799-PG00001D...
  • Page 55: Define Extended User-Defined Character Set

    This command and the Select Print Mode(s) command (1B 21) turn underline on and off in the same way. Exceptions This command is ignored if n is out of the specified range. Related information In A793 emulation, this command is unrecognized and the parameter n is put into the print buffer. A799-PG00001D...
  • Page 56: Copy Character Set From Rom To Ram

    Related information This command and the select print mode(s) command (1B 21) function identically. They should have the same setting when used together. In A793 emulation, this command is unrecognized and the parameter byte is put into the print buffer. A799-PG00001D...
  • Page 57: Select Or Cancel Double-Strike

    Turns italic print mode on or off. The printer is reset to the standard print mode after a clear printer (0x10) command is received. Exceptions Only the lowest bit of n is valid. Related information This command is recognized in A799 native mode and A794 emulation. In A793 and LEGACY emulations, the parameter byte is put into the buffer. A799-PG00001D...
  • Page 58: Select International Character Code

    Default: 0 (Code Page 437) Selects the character set to be used. Look in “Appendix B: Resident Character Sets” in the A799 User Guide for the character sets. There are two codes for this command (see select international character set, 1B 74 n). Both codes perform the same function.
  • Page 59: Select International Character Set

    Default: 0 (Code Page 437) Selects the character set to be used. Look in “Appendix B: Resident Character Sets” in the A799 User Guide Programming Supplement for the character sets. There are two codes for this command (See “Select international character code, 1B 52 n.) Both codes perform the same function.
  • Page 60: Select Character Size

    ASCII GS B n Hexadecimal 1D 42 n Decimal 29 66 n Value of n: 0 = Off 1 = On (When 0 and 1 are the least significant bit, LSB) Range of n: 0–255 Default: 0 (Off ) A799-PG00001D...
  • Page 61: Reverse Color Text Mode (Colorpos ® )

    If m = n but not zero, the printer produces solid printing in the given color. This tactic can be used to minimize the firmware busy work. The value of current color and white/black reserve print mode is superceded by the value of n whenever this mode is on (m>0). Bar codes, logos, and bit images are not affected by this command. A799-PG00001D...
  • Page 62: Text Strike-Through Mode (Colorpos ® )

    This command is also sent to select a downloaded font at run time. Three Asian Fonts are available for use on the A799 printer: Traditional Chinese, Kanji, and Korean. Only one of these character sets can be downloaded to the printer at one time.
  • Page 63: Save Font Id Number As Default Font At Power Up

    (12, 13, 1B 21 n, 1D 21 n,…) Exceptions This command is ignored if n is out of the specified range. Related information In A793 emulation, this command is unrecognized and the parameter byte is put into the print buffer. A799-PG00001D...
  • Page 64: Select Active User-Defined Character Set

    BMP file images that are not monochrome are put into the print buffer. Related information Microsoft BMP bitmap file format. This command is recognized in A799 native mode and in A794 emulation. In A793 and LEGACY emulations, the BMP file bytes are put into the print buffer. A799-PG00001D...
  • Page 65: Select Bit Image Mode

    Sets the print resolution and enters one line of graphics data into the print buffer. Excess data is accepted but ignored. Any print command is required to print the data, after which the printer returns to normal processing mode. See the illustration for graphic representations of the bit image below. A799-PG00001D...
  • Page 66: Print Advanced Raster Graphics

    Each bit corresponds to one horizontal dot. Compare to set bit image mode (1B 2A, m=1) earlier in this document. Related information In LEGACY emulation, this command is unrecognized and the parameters are put into the print buffer. A799-PG00001D...
  • Page 67: Select The Current Logo

    Related information This command is recognized in A799 native mode and A794 emulation. In A793 and LEGACY emulations, the parameters are put into the print buffer. A799-PG00001D...
  • Page 68: Define Downloaded Bit Image

    40) command is received. This bit image will be saved as a monochrome logo indexed by current value that was last set by the select current logo command or 0 is a select current logo command had not yet been given. See the illustration below for a graphic representation of the downloaded bit image. A799-PG00001D...
  • Page 69: Print Downloaded Bit Image

    A complete rendering of the intended final image should have been done by the application before sending the dot rows. If two-color paper is indicated by the set paper type command, then the raster will be printed in the color that is defined by the set current color command. A799-PG00001D...
  • Page 70: Print Raster Monochrome Graphics (Colorpos ® )

    This command is used for printing a single raster of color graphics in real-time. Offsets, page and any other modes or overlays, including watermark, and current color do not apply to this command. A complete rendering of the intended final image has to be done by the application before sending the dot rows. A799-PG00001D...
  • Page 71: Download Logo Image (Colorpos ® )

    1D 2A x y … for description of data definition bytes arrangement. During execution of this command printer turns off USM and Real Time status processing. The printer goes busy when writing to flash. At the end of this command the printer resets. A799-PG00001D...
  • Page 72: Apply Shading To Logo (Colorpos ® )

    Analogously, when the paper-color is the current color, m defines the relative amount of color dots being “erased” by white originals of the paper. Both text and monochrome graphics are affected by this command. Turning monochrome shade mode on, turns color shade mode off. A799-PG00001D...
  • Page 73: Color Shade Mode (Colorpos ® )

    The form and merge real time surround graphics command can be given multiple consecutive times, allowing the application to set up a multi-polygon background before starting its printout with placed text or logo. Continued... A799-PG00001D...
  • Page 74: Save Graphics Buffer As Logo (Colorpos ® )

    (such as text output) the graphics buffer will be merged (logical OR process) with print output. This command sets the graphics buffer state to “merge pending”, functioning and performing the save as in the form and merge real time surround graphics command. Related information This command is ignored in page mode. A799-PG00001D...
  • Page 75: Apply Margin Message Mode (Colorpos ® )

    This command applies shading to an existing logo of any size, storing the result in a new logo at index o. The new logo is thus better suited for use in a merging mode. The % of shading will have only a few perceptible gradations, so large increments (20 is suggested) should be used to achieve visibly distinct effects. A799-PG00001D...
  • Page 76: Logo Print With Knife Cut

    In order for this command to function properly, all commands used by legacy applications to move the end of the current receipt past the knife should be removed. The command is available only in A799 native mode. Related information See “Print downloaded bit image” command.
  • Page 77: Set Logoez Colorization

    Since the normal space on the receipt paper after a knife cut is 18 mm (144 rows), no extra space is usually needed above the logo. The default value is s = 0 and turns off the f = 1 logo after knife-cut link. A799-PG00001D...
  • Page 78 If the f = 4 logo link is undefined, you should set a null trailer logo with s = 1 and p = 144 (1F 03 16 04 1 90, no logo at index F3). This will turn off margin message at the position of a knife cut and leave a clear space at the top of the next receipt. A799-PG00001D...
  • Page 79: Set Logoez Attribute Mapping

    • restore background merge suspension (1D 9B [previous value]) Related information This command is utilized in the TPG LogoEZ utility. The utility can be used to pre-configure new printers with a default ® colorization setup without requiring any application changes. The default setup was designed to provide a general level of colorization features that would not affect the printer operation.
  • Page 80 Any mappings utilizing compressed and/or double-wide attributes will effect the length of a line and could cause unintended line wraps. Mappings containing double-high attributes could cause unintended receipt lengths. When both attribute mappings are set, processing is perform in order sequence. When two text attribute substitutions contain conflicting dependent remappings, the result is undefined. A799-PG00001D...
  • Page 81: Convert 6-Dots/Mm Bitmap To 8-Dots/Mm Bitmap

    Revision D 12/09 Chapter 4: Programming Commands Related information This command is utilized in the TPG LogoEZ utility. The utility can be used to pre-configure new printers with a default ® colorization setup without requiring any application changes. The default setup was designed to provide a general level of colorization features that would not affect the printer operation.
  • Page 82: Status

    Exceptions Unlike the A793, that had a dedicated connector and resultant dedicated status reporting for each cash drawer, the A799 has a single connector that shares data reporting from either cash drawer. When either cash drawer is open, an open status is reported by the printer.
  • Page 83: Request Alternate Status (A793 Emulation Only)

    In DTS/DSR protocol, the printer waits for DSR = SPACE. Related information See busy line and fault conditions in the real time commands section of this document for details about fault condition reporting. In LEGACY emulation, this command is ignored. A799-PG00001D...
  • Page 84: Transmit Printer Id

    4, 52 = Logo Definition Transmits the printer ID specified by n as follows: Printer ID Specification ID (Hexadecimal) 1, 49 Printer model ID A799 0x24 2, 50 Type ID Installed options Refer to below 3, 51 ROM version ID...
  • Page 85: Transmit Printer Id, Remote Diagnostics Extension

    Return receipt lines tally, preceded by n to identify Printer returns 10 bytes in above example: â00010000<CR> ä Knife cut tally, 8 digit ASCII numeric, Write to NVRAM max 99,999,999 à Knife cut tally Write to NVRAM, and print on receipt to verify A799-PG00001D...
  • Page 86 Clear cover openings tally to 0 » Cover openings tally Return cover openings tally, returns 10 bytes Max temperature tally Reset max temperature reached value Max temperature tally Return max temperature reached since it was reset, returns 10 bytes A799-PG00001D...
  • Page 87: Transmit Status

    Exceptions Unlike the A793, that had a dedicated connector and resultant dedicated status reporting for each cash drawer, the A799 has a single connector that shares data reporting from either cash drawer. When either cash drawer is open, an open status is reported by the printer.
  • Page 88: Send Printer Software Version

    The printer returns 8 bytes containing the boot and flash software version. The first 4 bytes returned are an ASCII string for the boot version. The second 4 bytes are an ASCII string for the flash version. Example: For 1.234.56 (8 bytes), the boot version is 1.23 and the flash version is 4.56. A799-PG00001D...
  • Page 89: Real Time Commands

    In this case the printer will use the real time command sequence bytes instead of the other command’s parameter bytes when finally executing that other command from the buffer; the other command will NOT be executed correctly. These three situations generally preclude use of standard DOS drivers for the serial communication ports when using real time commands. A799-PG00001D...
  • Page 90: Moving Data Through The Buffer

    3 = Transmit error status 4 = Transmit receipt paper status Transmits the selected one byte printer status specified by n in real time according to the following parameters. This command includes two sequences: GS (1D) and DLE (0x10). A799-PG00001D...
  • Page 91 10 04 n. Unlike the A793, that had a dedicated connector and resultant dedicated status reporting for each cash drawer, the A799 has a single connector that shares data reporting from either cash drawer. When either cash drawer is open, an open status is reported by the printer.
  • Page 92 Bit Status Hex Decimal Function Fixed to off Fixed to on Paper adequate Paper low (if paper low sensor enabled) Paper adequate Paper low (if paper low sensor enabled) Fixed to on Paper present Paper exhausted Paper present Paper exhausted Fixed to off A799-PG00001D...
  • Page 93: Real Time Request To Printer

    An application using DLE (0x10) sequence must send ENQ within 100 milliseconds of DLE or the printer will misinterpret the DLE and execute a clear printer command. Avoid this possibility by using the ID 03 n sequence, that is handled exactly the same as 10 05 n. A799-PG00001D...
  • Page 94: Real Time Printer Status Transmission

    Exceptions Unlike the A793, that had a dedicated connector and resultant dedicated status reporting for each cash drawer, the A799 has a single connector that shares data reporting from either cash drawer. When either cash drawer is open, an open status is reported by the printer.
  • Page 95: Unsolicited Status Mode

    Recognizing Data from the printer, which follows the USM return description. The status bytes to be transmitted are described in the following four tables. Byte 1 = printer information Byte 2 = error information Byte 3 = paper sensor information Byte 4 = paper sensor information A799-PG00001D...
  • Page 96 No knife error. Knife error occurred. Not used. Fixed to off. No unrecoverable error. Unrecoverable error occurred. No recoverable error. Recoverable error: Cover open, paper out, temperature or voltage error is out of range. Not used. Fixed to off. Continued... A799-PG00001D...
  • Page 97 Bit Off/On Hex Decimal Status for USM – – – Undefined – – – Undefined – – – Undefined – – – Undefined Not used. Fixed to off. – – – Undefined – – – Undefined Not used. Fixed to off. A799-PG00001D...
  • Page 98: Recognizing Data From The Printer

    0 = Not printed 1 = Above the bar code 2 = Below the bar code 3 = Both above and below the bar code Default: 0 (Not printed) Prints HRI (human readable interface) characters above or below the bar code. A799-PG00001D...
  • Page 99: Select Pitch Of Hri Characters

    Rotated barcodes set with small modules (select bar code width command 1D 77 n , with n=1 or 2) and PDF 417 barcodes in any orientation are printed at low speed, for better readability. Exceptions The command is only valid at the beginning of a line. Illegal data cancels the command. A799-PG00001D...
  • Page 100 The variable d indicates the character code to be encoded into the specified bar code system. If character code d cannot be encoded, the printer prints the bar code data processed so far, and the following data is treated as normal data. Exceptions Code 93 and PDF 417 are only available in A799 native mode. A799-PG00001D...
  • Page 101: Print Multiple Barcodes

    Barcode 1, code 128 1d 6b 49 07 67 04 05 06 07 08 09 Barcode 2, code 128 1d 6b 49 04 67 01 02 03 Barcode 3, code 128 1d 6b ff 00 End multiple barcodes, print A799-PG00001D...
  • Page 102: Print Gs1 Databar (Formerly Rss), Null Terminated

    GS1 DataBar stacked GS1 DataBar stacked omni-directional GS1 DataBar limited GS1 DataBar expanded and expanded stacked UPC-A UPC-E EAN-13 EAN-8 UCC/EAN-128 with CC-A or CC-B UCC/EAN-128 with CC-C Note: Data length specified 1 to 2436 via integer nH : nL. A799-PG00001D...
  • Page 103: Set Gs1 Databar (Formerly Rss) Parameters

    There are three mutually exclusive sets of symbol patterns, or clusters, each having 929 distinct patterns. Because different clusters are used for adjacent rows, it is possible for the decoder to tell if the scanning path is crossing row boundaries without the use of separator bars. A799-PG00001D...
  • Page 104: Select Bar Code Width

    Select bar code width ASCII GS w n Hexadecimal 1D 77 n Decimal 29 119 n Value of n: 2, 3, 4, 5, 6 Default: Sets the bar code width to n dots. Formulas n/8mm (n/203 inch) A799-PG00001D...
  • Page 105: Page Mode

    Page mode Page mode is one of two modes that the A799 printer uses to operate. Standard mode is typical of how most printers operate by printing data as it is received and feeding paper as the various paper feed commands are received. Page mode is different in that it processes or prepares the data as a “page”...
  • Page 106: Select Page Mode

    Two-color (dots) paper 81.0 72 wide x 72 high 72 wide x 72 high (energy) Exceptions The command is enabled only when input at the beginning of a line. The command has no effect if page mode has previously been selected. A799-PG00001D...
  • Page 107: Select Standard Mode

    (0C or 1B 0C). Exceptions The command is valid only in page mode. The command is ignored if the value of n is out of the specified range. A799-PG00001D...
  • Page 108: Set Print Area In Page Mode

    Maximizing the possible area in page mode consumes almost all of the free RAM. Without any free RAM, bitmap rotations and enlargements cannot be performed. Use the User Storage Status command (1D 97 m n) to determine the amount of free memory. Exceptions The command is effective only in page mode. A799-PG00001D...
  • Page 109: Set Absolute Vertical Print Position In Page Mode

    When pitch n is specified to the movement upward: nL + nH x 256 – 65536 – N Exceptions This command is used only in page mode, otherwise it is ignored. Any setting that exceeds the specified printing area is ignored. A799-PG00001D...
  • Page 110: Macros

    The macro executes r times continuously at the interval specified by t when the LSB (least significant bit) of m = 1. Exceptions If this command is received while a macro is being defined, the macro definition is aborted and the definition is cleared. If the macro is not defined or if r is 0, nothing is executed. A799-PG00001D...
  • Page 111: User Data Storage

    Value of n2: Byte Range of k: 20 – 63 (decimal locations) Writes the two-byte word, n1 n2, to location k in history EEROM. Related information: This is ignored in LEGACY emulation and the parameter bytes go into the print buffer. A799-PG00001D...
  • Page 112: Select Memory Type (Sram/Flash) Where To Save Logos Or User-Defined Fonts

    The selection remains in effect until it is changed via this command or until the power cycles. To specify permanent font flash, also send 1D 22 81 01. Related information This command is recognized in A799 native mode. In A793 and LEGACY emulations, parameter bytes go into the print buffer. Flash memory user sectors allocation ASCII GS “...
  • Page 113: Expanded Flash Memory Allocation

    1D 22 80 34 nL nH n sectors to electronic journal area 1D 22 80 40 end expanded flash memory allocation sequence n = 0xFFFF means allocate all remaining sectors to this area; only one area can specify this parameter value. A799-PG00001D...
  • Page 114: Select Flash Area For Storing Logos And User-Defined Characters

    (1D 40 n) command, an application should wait for the response from the printer before sending data. Otherwise, data will be lost. If an application is unable to receive data, it should wait a minimum of ten seconds after sending the erase user flash sector (1D 40 n) command before sending data. A799-PG00001D...
  • Page 115: User Storage Status (Colorpos ® )

    Change of the divisions is possible via flash erasure and flash allocation commands. If the communication protocol is RS-232C – Xon/Xoff, then “X symbol substitution response” should be configured with the setting communications parameters command (US STX , 1F 02). A799-PG00001D...
  • Page 116: Flash Download

    Return boot sector firmware part number ASCII GS NULL Hexadecimal 1D 00 Decimal 29 0 Returns ACK (Hex 06) + 12 bytes ASCII string describing the flash memory boot sector firmware part number. Ex : 189-1234567A Exceptions Available only in download mode. A799-PG00001D...
  • Page 117: Return Segment Number Status Of Flash Memory

    The printer transmits ACK if the calculated CRC is correct for the selected sector; NAK if the CRC is incorrect or if no sector is selected. Return microprocessor CRC ASCII GS BEL Hexadecimal 1D 07 Decimal 29 7 Returns the CRC calculated over the boot sector code space. Formulas ACK <low byte> <high byte> A799-PG00001D...
  • Page 118: Erase All Flash Contents Except Boot Sector

    The printer may return one of several responses. ACK means that the data was written correctly and the host should transmit the next block. NAK means that, for some reason, the data was not written correctly. This could mean that A799-PG00001D...
  • Page 119: Reset Firmware

    Setting Net Mask ASCII US BS STX n1 n2 n3 n4 Hexadecimal 1F 08 02 n1 n2 n3 n4 Decimal 31 8 n1 n2 n3 n4 Default: 0.0.0.0 Sets the Net Mask value specified by the values n1 to n4. A799-PG00001D...
  • Page 120: Setting The Gateway

    US BS BELL n1 Hexadecimal 1F 08 07 Decimal 31 8 n1 = 0: disabled n1 = 1: enabled Default: disabled Enables or disables the use of BootP at power-up to obtain an IP address. BootP is a subset of DHCP. A799-PG00001D...
  • Page 121: Dhcp (Auto-Configuration)

    Enables or disables resetting of open TCP ports after five (5) minutes inactivity. Keep-alive pings ASCII US BS LF n1 Hexadecimal 1F 08 0A n1 Decimal 31 8 10 n1 n1 = 0: disabled n1= 1: enabled Default: enabled A799-PG00001D...
  • Page 122 Chapter 4: Programming Commands Revision D 12/09 A799-PG00001D...
  • Page 123: Appendix A: Commands Listed By Hexadecimal Code

    1B 2A m n1 n2 d1...dn Select bit image mode 1B 2D n Select or cancel underline mode 1B 2E m n rL rH d1 … dn Print advanced raster graphics 1B 32 Set vertical line spacing to 1/6 inch A799-PG00001D...
  • Page 124 1B 74 n Select international character set 1B 75 0 Transmit peripheral device status (RS-232C printers only) 1B 75 n Request alternate status (A793 emulation only) 1B 76 Transmit paper sensor status 1B 7B n Select or cancel upside-down print mode A799-PG00001D...
  • Page 125 1D 5C nL nH Set relative vertical print position in page mode 1D 5E r t m Execute macro 1D 61 n Select or cancel unsolicited status mode 1D 62 n Set smoothing 1D 66 n Select pitch of HRI characters A799-PG00001D...
  • Page 126 Save font ID number as default font at power up 1D F0 80 Download font 1D F0 C0 02 Download font list 1D FF Reset firmware 1F 03 16 f s p/t t LogoEZ colorization ® 1F 03 16 05 n Set interpretation of “Set current color” command A799-PG00001D...
  • Page 127 1F 26 s c1 c2 Define extended user-defined character set 1F 56 Send printer software version 1F 69 n Select active user-defined character set 1F 74 Print test form 1F 7A Real time commands disable 1F 7B n Enable constant speed logos A799-PG00001D...
  • Page 128 Appendix B: Resident Character Sets Revision D 12/09 A799-PG00001D...
  • Page 129: Appendix B: Resident Character Sets

    Revision D 12/09 Appendix B: Resident Character Sets Appendix B: Resident Character Sets Character sets Code page 437 (US) A799-PG00001D...
  • Page 130: Code Page 737 (Greek)

    Appendix B: Resident Character Sets Revision D 12/09 Code page 737 (Greek) A799-PG00001D...
  • Page 131: Code Page 850 (Multilingual)

    Revision D 12/09 Appendix B: Resident Character Sets Code page 850 (Multilingual) A799-PG00001D...
  • Page 132: Code Page 852 (Slavic)

    Appendix B: Resident Character Sets Revision D 12/09 Code page 852 (Slavic) A799-PG00001D...
  • Page 133: Code Page 857 (Turkish)

    Revision D 12/09 Appendix B: Resident Character Sets Code page 857 (Turkish) A799-PG00001D...
  • Page 134: Code Page 858 (With Eurosymbol)

    Appendix B: Resident Character Sets Revision D 12/09 Code page 858 (with Eurosymbol) A799-PG00001D...
  • Page 135: Code Page 860 (Portuguese)

    Revision D 12/09 Appendix B: Resident Character Sets Code page 860 (Portuguese) A799-PG00001D...
  • Page 136: Code Page 862 (Hebrew)

    Appendix B: Resident Character Sets Revision D 12/09 Code page 862 (Hebrew) A799-PG00001D...
  • Page 137: Code Page 863 (French Canadian)

    Revision D 12/09 Appendix B: Resident Character Sets Code page 863 (French Canadian) A799-PG00001D...
  • Page 138: Code Page 865 (Nordic)

    Appendix B: Resident Character Sets Revision D 12/09 Code page 865 (Nordic) A799-PG00001D...
  • Page 139: Code Page 866 (Cyrillic)

    Revision D 12/09 Appendix B: Resident Character Sets Code page 866 (Cyrillic) A799-PG00001D...
  • Page 140: Code Page 1252 (Windows Latin 1)

    Appendix B: Resident Character Sets Revision D 12/09 Code page 1252 (Windows Latin 1) A799-PG00001D...
  • Page 142 A799 Two-Color Thermal Receipt Printer: Programmer Guide A799-PG00001 Rev. D 12/09...

This manual is also suitable for:

Colorpos a799

Table of Contents