Wincor Nixdorf TH210 Programmer's Manual

Wincor Nixdorf TH210 Programmer's Manual

Hide thumbs Also See for TH210:
Table of Contents

Advertisement

TH210
Thermal Printer
Programmer's Guide (December 2015)

Advertisement

Table of Contents
loading
Need help?

Need help?

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

Questions and answers

Summary of Contents for Wincor Nixdorf TH210

  • Page 1 TH210 Thermal Printer Programmer’s Guide (December 2015)
  • Page 2: Table Of Contents

    Contents About this Guide ........................... 1 How to use this guide ........................1 Where to find the basics ........................ 1 Where to find advanced technical information ................1 Support ............................1 Diagnostics and Configuration ...................... 2 Start-up Diagnostics ........................2 Runtime Diagnostics ........................
  • Page 3 Bar codes 79 QR code Overview ........................79 Select printing position of HRI characters ................. 83 Select pitch of HRI characters ....................83 Select bar code height ......................83 Print multiple barcodes ......................85 Print GS1 DataBar, null terminated ..................86 Print GS1 DataBar, data length specified ..................
  • Page 4 Character code table Page 1 (PC850: Multilingual Latin I): ............119 Character code table Page 2 (PC852: Latin II): .................120 Character code table Page 3 (PC860: Portuguese): ..............121 Character code table Page 4 (PC863: Canadian French): ............122 Character code table Page 5 (PC865: Nordic): .................123 Character code table Page 6 (PC858: Multilingual I + Euro): ............124 Character code table Page 7 (PC866: Russian): ................125 Character code table Page 8 (WPC1252: Latin I): ..............126...
  • Page 5: About This Guide

    Support For more advanced procedures and troubleshooting, you may need to refer to the printer’s service manual or speak to a Wincor Nixdorf technical professional. Your representative is able to provide you with necessary information. For on-line service, refer to the Web site at www.wincor-nixdorf.com.
  • Page 6: Diagnostics And Configuration

    TH210 Programmer’s Guide Diagnostics and Configuration The 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 Perform during the printer’s start-up cycle.  Runtime diagnostics Perform during normal printer operation.
  • Page 7: Runtime Diagnostics

    TH210 Programmer’s Guide If the printer has not been turned on before, or a new EEPROM has been installed, the default values for the printer functions will be loaded into the EEPROM during start-up diagnostics, and the printer will make a quick four-tone beep (high then low frequency, twice).
  • Page 8: Accessing The Remote Diagnostic Tallies

    TH210 Programmer’s Guide TH210 Diagnostics Form Print test will vary per model or printer configuration. Accessing the remote diagnostic tallies Refer to “Command descriptions” in Chapter “Programming commands“ (Status commands: Transmit printer ID, remote diagnostics extension, Hexadecimal 1D 49 40 n)
  • Page 9: Indicators

    TH210 Programmer’s Guide Indicators The printer communicates various conditions both visually, with the green LED or audibly, with a series of tones or beeps. The following table lists these indicators. Indicator Sequence Condition Continuous, blinking on Paper out Cover open...
  • Page 10: Printer Configuration

    TH210 Programmer’s Guide Printer configuration Printers are shipped with all the functions and parameters preset at the factory. Settings for various printer parameters can be changed. This menu is printed on the receipt and scrolls through instructions for selecting and changing any of the functions or parameters.
  • Page 11: Configuring The Printer

    TH210 Programmer’s Guide Configuring the printer The configuration menu allows you to select functions or change various settings for the printer. Instructions printed on the receipt guide you through the processes. Caution: Be extremely careful changing any of the printer settings to avoid changing other settings that might affect the performance of the printer.
  • Page 12: Communication Interface Settings

    TH210 Programmer’s Guide Communication interface settings To change the communication interface settings, enter the configuration menu, select “Set Communication Interface” from the main menu. Caution: Be extremely careful changing any of the printer settings to avoid inadvertently changing other settings that might affect the performance of the printer.
  • Page 13: Enable Or Disable Data Scope Mode

    TH210 Programmer’s Guide Enable or disable data scope mode The data scope mode test prints a hexadecimal dump of all data sent to the printer: “1” prints as hexadecimal 31, “A” as hexadecimal 41 and so on. This helps troubleshoot communication problems and runs during a normal application (after being enabled through printer configuration).
  • Page 14: Electronic Journal Datascope Diagnostic

    TH210 Programmer’s Guide 3. Push the paper feed button. The receipt station prints all code pages and cuts the receipt. 4. To repeat this test, push the paper feed button again. To exit the receipt test mode: 1. Enter the configuration menu again.
  • Page 15 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 TH210, A794, A793 or Application Compatible Escape Command systems.
  • Page 16 TH210 Programmer’s Guide  Partial cut distance Allows the user to set the distance that the knife will cut across a receipt in 5 step increments between 110-160.  Fine partial cut steps Allows the user to set the amount of extra steps the knife will cut across a receipt, between 0 and ...
  • Page 17: Programming The Printer

    Comparison to A793 The following table details the list of commands whose behavior differs between the A793, A794, and TH210 because of the physical differences of a 6 dots/mm head (A793) versus an 8 dots/mm head (A794 and TH210). Command Description...
  • Page 18: Character Appearance

    Programmer’s Guide Command Description Difference between previous product and new product emulation mode inch and the TH210 has a fundamental step of 1/203 inch, the actual line spacing will not exactly match the requested spacing. 1B 4A n Print and feed paper This command uses n in terms of n/360 inches.
  • Page 19: Print Zones

    The TH210 Series adds a 27 dot high font, so standard print spacing is 30 dots. The TH210 Series paper-saving feature adds a 18 dot high font and reduces extra dot rows to 2, so standard print spacing is 20 dots.
  • Page 20: Emulation Modes

     Single-high (normal) and double-high Emulation modes The Wincor Nixdorf TH210 Series printer may be operated in a number of different emulation modes. However, printing characteristics and defaults may differ, depending on the desired mode. Print setup in emulation modes Refer to the chart below for defaults and allowed printing options in each emulation mode.
  • Page 21: Programming Commands

    TH210 Programmer’s Guide Programming Commands Commands listed by function Printer actions Code (hexadecimal) Command Clear printer Perform full knife cut (or code 1B 69) Perform partial knife cut (or code 1B 6D) 1B 07 Generate tone 1B 3D n Select peripheral device (for multi-drop)
  • Page 22 TH210 Programmer’s Guide Vertical and horizontal positioning Code (hexadecimal) Command Horizontal tab 1B 14 n Set column 1B 24 nL nH Set absolute starting position 1B 32 Set vertical line spacing to 1/6 inch 1B 33 n Set vertical line spacing 1B 44 n1...nk 00...
  • Page 23 TH210 Programmer’s Guide Text characteristics Code (hexadecimal) Command 1D F0 03 Save font ID number as default font at power up 1D F0 80 Download font 1D F0 C0 02 Download font list 1F 03 45 FSID Configure use of font set over power cycles...
  • Page 24 TH210 Programmer’s Guide Text characteristics Code (hexadecimal) Command 1F 03 45 FSID Configure use of font set over power cycles 1F 03 46 n Configure line spacing 1F 05 n Select superscript or subscript modes 1F 26 s c1 c2...
  • Page 25 TH210 Programmer’s Guide Real time Code (hexadecimal) Command 10 04 n Real time status transmission (DLE sequence) 10 05 n Real time request to printer (DLE sequence) 1D 03 n Real time request to printer (GS sequence) 1D 04 n...
  • Page 26 TH210 Programmer’s Guide Page mode Code (hexadecimal) Command Print and return to standard mode Cancel print data in page mode 1B 0C Print data in page mode 1B 4C Select page mode 1B 53 Select standard mode 1B 54 n...
  • Page 27 TH210 Programmer’s Guide Settings commands Code (hexadecimal) Command 1F 09 01 06 Save current settings as factory settings 1F 09 01 07 Clear active settings and restore factory settings 1F 09 01 08 Upload current settings 1F 09 01 09...
  • Page 28: Command Conventions

    TH210 Programmer’s Guide Command conventions The following information describes how each command is organized: Name: Name of command. ASCII: The ASCII control code. Hexadecimal: The hexadecimal control code. Decimal: The decimal control code. Value: A description of the command operands.
  • Page 29: Perform Full Knife Cut

    TH210 Programmer’s Guide Perform full knife cut ASCII ESC i Hexadecimal 19 1B 69 Decimal 27 105 Cuts the receipt. There are two codes (Hex 19 or 1B 69) for this command and both perform the same function. Exceptions The full cut is replaced by a partial cut in the A793 emulation. ASCII EM, (0x19) is ignored in LEGACY emulation.
  • Page 30: Initialize Printer

    TH210 Programmer’s Guide 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. Initialize printer ASCII ESC @...
  • Page 31: Enable Or Disable Panel Button

    TH210 Programmer’s Guide Enable or disable panel button ASCII ESC c 5 n Hexadecimal 1B 63 35 n Decimal 27 99 53 n Value of n: 0 = Enable 1 = Disable Default: 0 (Enable) Enables or disables the paper feed button. If the last bit is 0, the paper feed button is enabled. If the last bit is 1, the paper feed button is disabled.
  • Page 32 TH210 Programmer’s Guide Feed and cut mode 0, 48 Full cut (no extra feed) 1, 49 Partial cut (no extra feed) Feeds paper to cutting position + (n times vertical motion unit), and cuts the paper completely Feeds paper to cutting position + (n times vertical motion unit), and...
  • Page 33: Print And Paper Feed

    TH210 Programmer’s Guide Print test form ASCII US t Hexadecimal 1F 74 Decimal 31 116 Prints the current printer configuration settings on the receipt. Disabled in page mode. Port Idle Timeout ASCII US ETX 0x4E n1 n2 Hexadecimal 1F 03 4E n1 n2...
  • Page 34 TH210 Programmer’s Guide Feed n print lines ASCII DC4 n Hexadecimal 14 n Decimal 20 n Value of n: The number of lines to feed at current line height setting. Range of n: 0–255 in Native mode 0–127 in A793 emulation Feeds the paper n lines at the current line height without printing.
  • Page 35 TH210 Programmer’s Guide Extra Lines per Dot rows Extra Lines per Dot rows rows inch rows inch 6.77 Related information 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.
  • Page 36: Horizontal Tab

    TH210 Programmer’s Guide Print and feed n lines ASCII ESC d n Hexadecimal 1B 64 n Decimal 27 100n Range of n: 0–255 (0 is interpreted as 1) Prints one line from the buffer and feeds paper n lines at the current line height.
  • Page 37: Set Column

    TH210 Programmer’s Guide Mode Commands using x Commands using y Standard 1B 20, 1B 24, 1B 5C, 1D 4C, 1B 33, 1B 4A, 1B 4B, 1D 56 1D 57 Page (upper left or lower 1B 20, 1B 24, 1B 57, 1B 5C,...
  • Page 38: Set Vertical Line Spacing

    For more information, see the description of the command set horizontal and vertical minimum motion units command (1D 50) in this document. Compatibility information (TH210 receipt vs. A793 receipt) There is a difference in the normal behavior of this command in A793 emulation mode as compared to the original A793.
  • Page 39: Set Horizontal Tab Positions

    TH210 Programmer’s Guide Related information For more information, see the description of the set horizontal and vertical minimum motion units command in this document. In addition, see “Configure line spacing” (1F 03 46 n). Set horizontal tab positions ASCII ESC D n1…nk NUL Hexadecimal 1B 44 n1…nk 00...
  • Page 40 In order to improve the speed of printing, the TH210 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 41: Select Justification

    TH210 Programmer’s Guide Select justification ASCII ESC a n Hexadecimal 1B 61 n Decimal 27 97 n Value of n: 0, 48 = Left aligned 1, 49 = Center aligned 2, 50 = Right aligned Range of n: 0–2, 48–50...
  • Page 42: Set Printing Area Width

    TH210 Programmer’s Guide Or, to set the left margin to two inches at the default horizontal motion unit of 1/203 units per inch, send the four-byte string: GS L 150 1 Where 2 inches = 406/203, and 406 = (1 X 256) + 150.
  • Page 43: Text Characteristics Commands

    TH210 Programmer’s Guide Text characteristics commands These commands control what the printed information looks like, selection of character sets, definition of custom-defined characters, and setting of margins. The commands are described in order of their hexadecimal codes. The commands describe operation for 80mm paper.
  • Page 44 TH210 Programmer’s Guide 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 is ignored in LEGACY emulation. Set pitch (column width) ASCII ESC SYN n...
  • Page 45: Select Print Mode

    TH210 Programmer’s Guide used. When the starting printing position is the upper right or lower left of the printable area (set by select print direction in page mode, 1B 54 n) the vertical motion unit (y) is used. This command can be set independently in standard mode and in page mode.
  • Page 46 TH210 Programmer’s Guide Related information In standard mode, when double-height mode is selected, the character is enlarged in the paper feed direction, and when double-width mode is selected it is enlarged perpendicular to the paper feed direction. In 90° clockwise-rotated mode, the relationship between double-height and double-width is reversed.
  • Page 47 TH210 Programmer’s Guide c1 = Hex 20–FF (20 is always printed as a space) c2 = Hex 20–FF (20 is always printed as a space) To define only one character, use the same code for both c1 and c2 k = c2 – c1 + 1 = the number of characters to be defined in this command string [character i data] = [ni d1 ...
  • Page 48: Select Or Cancel Underline Mode

    TH210 Programmer’s Guide Defines and enters downloaded characters into RAM. The command may be used to overwrite single characters. User- defined characters are available until power is turned off or the Initialize Printer command (1B 40) is received. Any invalid byte (s, c1, c2, n1) aborts the command.
  • Page 49 TH210 Programmer’s Guide Cancel user-defined character ASCII ESC? n Hexadecimal 1B 3F n Decimal 27 63 n Value of n: Specified character code. Range of n: 32-255 Cancels the pattern defined for the character code specified by n. After the user-defined character is canceled, the corresponding pattern from current active ROM code page is printed.
  • Page 50: Select Or Cancel Italic Print

    TH210 Programmer’s Guide Select or cancel double-strike ASCII ESC G n Hexadecimal 1B 47 n Decimal 27 71 n Value of n: 0 = Off 1 = On (When 0 and 1 are the least significant bit, LSB) Default: 0 (off) Turns double-strike mode on or off until the printer is initialized, reset, or powered off.
  • Page 51: Select International Character Code

    TH210 Programmer’s Guide Select international character code ASCII ESC R n Hexadecimal 1B 52 n Decimal 27 82 n Value of n: Native mode A793 emulation Application Compatible Escape Command emulation (LEGACY) 0 = Code Page 437 0 = Code Page 437 0 = U.S.A.
  • Page 52: Select Or Cancel 90 Degree Clockwise Rotated Print

    TH210 Programmer’s Guide Selects the character set to be used until the printer is initialized, reset, or powered off. Look in “Appendix B: Resident Character Sets” in the User Manual for the character sets. The alphanumeric characters (0x20-0x7F) are the same for each set.
  • Page 53 TH210 Programmer’s Guide Native mode A793 emulation 0C = Code Page 857 0D = Code Page 1251 0E = Code Page 1255 0F = Code Page KZ_1048 10 = Code Page 1254 11 = Code Page 1250 12 = Code Page 28591...
  • Page 54 TH210 Programmer’s Guide Prints upside-down characters until the printer is initialized, reset, or powered off. The command may be combined with clockwise rotated print (1B 56) or counter-clockwise rotated print (1B 12). The character order is inverted in the buffer so text is readable. Only bit 0 is used. Bits 1-7 are not used.
  • Page 55 TH210 Programmer’s Guide This command is effective for all characters (except for HRI characters) and is effective until the printer is initialized, reset, or powered off. In standard mode, the vertical direction is the paper feed direction, and the horizontal direction is perpendicular to the paper feed direction.
  • Page 56 TH210 Programmer’s Guide In A793 emulation, the command is unrecognized and the parameter byte is put into the print buffer. Set smoothing ASCII GS b n Hexadecimal 1D 62 n Decimal 29 98 n Value of n: 0 = smoothing off...
  • Page 57: Double-Byte Fonts

    Double-byte fonts Five double-byte fonts are built-into the TH210-VI Series printer: Simplified Chinese, Traditional Chinese, Kanji, Korean and Thai. If the TH210-VI is set to Unicode, the GB18030 Chinese and Vietnamese character sets are available. Lock permanent font flash area...
  • Page 58: Select Font Id Number

    TH210 Programmer’s Guide This command allows or prevents the permanent font area to be erased. Note: This only affects the 1D 40 33 commands and downloading a font to permanent font area when a font already exists with the same ID.
  • Page 59: Select Font Style Number

    TH210 Programmer’s Guide Font ID Font C3 (hex) Traditional Chinese D3 (hex) Simplified Chinese CB (hex) Kanji CE (hex) Korean Select font style number ASCII GS 0xF0 0x02 n Hexadecimal 1D F0 02 n Decimal 29 240 2 n Value of n: 0-255 Select font style number for downloaded font.
  • Page 60: Graphics

    TH210 Programmer’s Guide Download font ASCII GS 0xF0 0x80 followed by file Hexadecimal 1D F0 80 Decimal 29 240 128 This command is the sequence introducer for downloading existing files. The downloaded font is always stored in the permanent font area of flash. If there is not enough memory in the permanent font area to store the file the printer returns NACK.
  • Page 61: Select Bit Image Mode

    TH210 Programmer’s Guide Warnings about the effect of running out of defined logo space during a download apply (i.e. the command is ignored). The application is required to manage user data space, downloaded font space, and logo space. After downloading a logo to the printer, wait 100ms to allow the printer time to write the logo to flash.
  • Page 62: Print Advanced Raster Graphics

    TH210 Programmer’s Guide Print advanced raster graphics ASCII ESC, m n rL rH d1 ... dn Hexadecimal 1B 2E m n rL rH d1 ... dn Decimal 27 46 m n rL rH d1 ... dn Value of m: horizontal offset from left margin = 8 x m dots...
  • Page 63 TH210 Programmer’s Guide density mode allows 0–288 dot columns. The number of bytes sent is represented by the formulas in the table. Each bit corresponds to two horizontal dots. Compare to set bit image mode (1B 2A, m = 0) earlier in this document.
  • Page 64 TH210 Programmer’s Guide In the case of a previously existing application that expects only one possible logo, the printer will not receive the select current logo (1D 23 n) command. In this case, the printer assigns 0 as the active logo identifier. It automatically stores any new logo definition in flash memory as logo 0, inactivating any previous logo 0 definition.
  • Page 65: Print Downloaded Bit Image

    TH210 Programmer’s Guide Print downloaded bit image ASCII GS / m Hexadecimal 1d 2F m Decimal 29 47 m Value and range of m: This command is used to print a previously stored monochrome (defined by 1D 2A) from printer memory on the receipt station.
  • Page 66: Print Raster Graphics

    TH210 Programmer’s Guide Print raster graphics ASCII DC1 n1 . . . n1 Hexadecimal 11 n1 . . . n72 Decimal 17 n1 . . . n1r Value and range of m: n1 to n72 corresponds to one dot row data for a thermal receipt printer.
  • Page 67 TH210 Programmer’s Guide Because the printhead and cutting knife are physically separated, it is necessary to advance the printed area of a receipt past the knife to avoid the last of the printing from being cut off. This advance of paper however, causes a blank space at the start of the next receipt that could be used.
  • Page 68 TH210 Programmer’s Guide Enable constant speed logos ASCII US { n Hexadecimal 1F 7B n Decimal 31 123 n Value of f: 0 = Off 1 = On Default: 0 (Off) This command allows the firmware to determine the optimal speed to print a logo. It is set prior to downloading the logo and reset after the logo has been downloaded.
  • Page 69: Status

    Status Status command introduction The TH210 has three methods of providing status to the application. These methods are through batch status commands, real time status commands and unsolicited status mode. An application may use one or more of these methods to understand the current status of the printer. A brief description of each of these methods follows.
  • Page 70: Transmit Paper Sensor Status

    Unlike the A793, that had a dedicated connector and resultant dedicated status reporting for each cash drawer, the TH210 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 71: Transmit Status

    Unlike the A793, that had a dedicated connector and resultant dedicated status reporting for each cash drawer, the TH210 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 72 TH210 Programmer’s Guide Cash drawer status (n = 2 or n = 50) Off/On Decimal Status for transmit status Not used. Fixed to off. Undefined. Undefined. Not used. Fixed to off. Flash memeory sector status (n = 4 or n = 52)
  • Page 73: Real Time Commands

    TH210 Programmer’s Guide Real time commands The real time commands provide an application interface to the printer even when the printer is not handling other commands (RS-232C communication interface only):  Real time status transmission: GS (Hex 1D) sequence and DLE (Hex 10) sequence ...
  • Page 74: Moving Data Through The Buffer

    TH210 Programmer’s Guide 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.
  • Page 75 Unlike the A793, that had a dedicated connector and resultant dedicated status reporting for each cash drawer, the TH210 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 76: Real Time Request To Printer

    TH210 Programmer’s Guide Off/On Decimal Function No unrecoverable error. Unrecoverable error occurred. Thermal printhead temp. and power supply voltage are in range. Thermal printhead temp. or power supply voltage are out of range. Fixed to off 4 = Transmit receipt paper status...
  • Page 77: Real Time Printer Status Transmission

    Unlike the A793, that had a dedicated connector and resultant dedicated status reporting for each cash drawer, the TH210 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 78: Automatic Status Back

    TH210 Programmer’s Guide Real time commands disabled ASCII US z n Hexadecimal 1F 7A n Decimal 31 122 n Value of n: 0 = enable 1 = disable This command is used to disable real time commands. They are disabled prior to sending graphic or other data to the printer that may contain embedded real time commands.
  • Page 79 TH210 Programmer’s Guide Off/On Decimal Status for ASB Undefined Undefined Undefined Undefined Exceptions If n = 0, ASB is disabled Related information When Automatic Status Back (ASB) is enabled using this command, the status transmitted by other commands and the ASB status are differentiated according to the information found in Recognizing Data from the printer, (in the Real Time Commands section in this chapter).
  • Page 80: Unsolicited Status Mode

    TH210 Programmer’s Guide Off/On Decimal Status for ASB Recoverable error: Cover open, paper out, temperature or voltage error is out of range. Not used. Fixed to off. Third (paper sensor Information) Off/On Decimal Status for ASB Receipt paper adequate Receipt paper low (if paper low sensor enabled)
  • Page 81 TH210 Programmer’s Guide If an immediate return of printer status is desired, then any of the other status commands should be issued following this command. Once this mode is activated, the printer automatically transmits 4 status bytes whenever any of the conditions change. If an RS-232C connection with hardware flow control is used, all four status bytes will be transmitted without checking DSR.
  • Page 82 TH210 Programmer’s Guide Second byte (error Information) Off/On Decimal Status for USM – – – Undefined – – – Undefined No mechanical error Mechanical error occurred No knife error. Knife error occurred. Not used. Fixed to off. No unrecoverable error.
  • Page 83: Bar Codes

    TH210 Programmer’s Guide Recognizing data from the printer An application sending various real time and non-real time commands to which the printer responds can determine which command a response belongs to by the table below. Responses to transmit peripheral device status (1B 75) and transmit paper sensor status (1B 76) are non-real time responses and will arrive in the order in which they were solicited.
  • Page 84 TH210 Programmer’s Guide The details of each command are described below. Note: The settings for model, size of module, and error correction level are effective until the printer is reset, or the power is turned off. Select model for QR code...
  • Page 85 TH210 Programmer’s Guide Select error correction level for QR Code ASCII GS ( k ETX NUL 1 E n Hexadecimal 1D 28 6B 03 00 31 45 n Decimal 29 40 107 3 49 69 n Value of n: Function...
  • Page 86 TH210 Programmer’s Guide Sample Manual Mode Data: 1D 28 6B 03 00 31 44 30 ‘ Set manual parsing 1D 28 6B 0D 00 31 50 30 ‘ Set data size ‘ Set alpha-numeric type 54 45 53 54 31 2D 2E 2F 3A ‘...
  • Page 87: Select Printing Position Of Hri Characters

    TH210 Programmer’s Guide A quiet zone of four times the size of one module is required on all sides of the QR code symbol, but it is not included in the printing data. Be sure to add a quiet zone when using this function.
  • Page 88 TH210 Programmer’s Guide There are two variations to this command. The first variation uses a NUL character to terminate the string; the second uses a length byte at the beginning of the string to compensate for the code 128 bar code, which can accept a NUL character as part of the data. With the second variation, the length of byte is specified at the beginning of the string.
  • Page 89: Print Multiple Barcodes

    TH210 Programmer’s Guide Bar code d1...dk length supplied by printer if necessary) Interleaved 2 of 5 48–57 Variable length (even number) (ITF) CODABAR (NW-7) 65–68, start code 48- 57, Variable length 36, 43, 45, 46, 47, 58 Code 93 00–127...
  • Page 90: Print Gs1 Databar, Null Terminated

    TH210 Programmer’s Guide No height restriction change from single line barcodes Quiet zone between barcodes = 10 * module width No text in between barcodes (results undefined) Upright, picket fence barcodes only, no upside down or ladder. Extended barcode printing for upside down and ladder barcodes can be done in page mode if required.
  • Page 91: Print Gs1 Databar, Data Length Specified

    TH210 Programmer’s Guide Print GS1 DataBar, data length specified ASCII GS k m nL nH d1... dn Hexadecimal 1D 6B m nL nH d1... dn Decimal 29 107 m nL nH d1... dn Type GS1 DataBar GS1 DataBar truncated GS1 DataBar stacked...
  • Page 92: Select Pdf 417 Parameters

    TH210 Programmer’s Guide Select PDF 417 parameters ASCII GS p a b c d e f Hexadecimal 1D 70 a b c d e Decimal 29 112 a b c d e f Values and Ranges: Ranges: Description: Value: The ratio of bar height to symbol length.
  • Page 93: Select Bar Code Width

    TH210 Programmer’s Guide The number of characters in a row and number of rows can be adjusted to vary the symbol’s overall aspect ratio to best fit an available space. Each row has a left and right row indicator with a data region between. The left-most character in the top row of the data region is the total number of characters in the data region, excluding error correction characters.
  • Page 94: Set Datamatrix Parameters

    TH210 Programmer’s Guide Set DataMatrix Parameters ASCII GS ( k pL pH cn fn m d1 d2 Hexadecimal 1D 28 6B 05 00 36 42 m d1 d2 Decimal 29 40 107 5 0 54 66 m d1 d2 Values and Ranges:...
  • Page 95: Set Datamatrix Module Size

    TH210 Programmer’s Guide Notes This command is ignored if any of m, d1, or d2 is outside its range. Settings of this command are in effect until 1b 40 is executed, the printer is reset, or the power is turned off.
  • Page 96: Print Datamatrix Symbol Data In The Symbol Storage Area

    TH210 Programmer’s Guide This command stores the DataMatrix symbol data (d1...dk) in the symbol storage area. k bytes of d1...dk are processed as the symbol data Notes The symbol data saved in the symbol storage area by this command is encoded by printing and transmission of this command.
  • Page 97: Page Mode

    The printer moves print position to the next dot of the last data of the symbol. Page mode Page mode is one of two modes that the TH210 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 98: Cancel Print Data In Page Mode

    TH210 Programmer’s Guide Cancel print data in page mode ASCII Hexadecimal Decimal Deletes all the data to be printed in the “page” area. Any data from the previously selected “page” area that is also part of the current data to be printed is deleted.
  • Page 99: Select Standard Mode

    TH210 Programmer’s Guide  Set counter-clockwise rotation (1B 12)  Select justification (1B 61)  Select or cancel upside-down printing (1B 7B)  Set left margin (1D 4C)  Set print area width (1D 57) The table below shows the difference in memory allocation in page mode when using monochrome and two-color paper.
  • Page 100: Select Print Direction In Page Mode

    TH210 Programmer’s Guide Select print direction in page mode ASCII EST T n Hexadecimal 1B 54 n Decimal 27 84 n Value of n: Start position 0 = Upper left corner proceeding across page to the right [A] 1 = Lower left corner proceeding up the page [B]...
  • Page 101: Set Absolute Vertical Print Position In Page Mode

    TH210 Programmer’s Guide Sets the position and size of the printing area in page mode until the printer is initialized, reset, or powered off, or a 0C command is sent. The command can be sent multiple times so that several different print areas, aligned in different print directions, can be developed in the printer’s page buffer before being printed using the print...
  • Page 102: Set Relative Vertical Print Position In Page Mode

    TH210 Programmer’s Guide lower right; and sets the absolute position in the horizontal when the starting position is set to the upper right or lower left. The horizontal and vertical motion unit are specified by the set horizontal and vertical minimum motion units (1D 50) command.
  • Page 103: Macros

    TH210 Programmer’s Guide Macros These commands are used to select and perform a user-defined sequence of printer operations. Select or cancel macro definition ASCII GS : Hexadecimal 1D 3A Decimal 29 58 Starts or ends macro definition. Macro definition begins when this command is received during normal operation and ends when this command is received during macro definition.
  • Page 104: User Data Storage

    TH210 Programmer’s Guide 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. User data storage...
  • Page 105: Flash Memory User Sectors Allocation

    TH210 Programmer’s Guide n = 49 (ASCII n = 1) HEX 31 Loads active logo to flash memory. This is the default condition for logo flash storage. A logo defined following this command is stored in flash memory. n = 50 (ASCII n = 2) HEX 32 Loads user-defined characters to RAM only.
  • Page 106: Flash Object Delete

    TH210 Programmer’s Guide n1 = 0 pack the permanent font area pack the logo and user-defined character area n1 = 1 Issuing this command will pack the objects currently stored in flash memory. Objects that are no longer valid will be removed. This will provide the user the maximum amount of storage in this area for new objects.
  • Page 107: Select Flash Area For Storing Logos And User-Defined Characters

    TH210 Programmer’s Guide If the sectors are available, and different from current parameters, all sectors are erased and the printer returns ACK. If the sectors specified are the same as current parameters, nothing is erased and the printer returns ACK.
  • Page 108: Lock Permanent Font Flash Area

    TH210 Programmer’s Guide n = 49 (ASCII n = 1) HEX 31 This command erases all 64K flash memory sectors allocated to user-defined character and logos storage. Those sectors should be erased in two situations: when the logo definition area is full and an application is attempting to define new logos, and when an application wants to replace one user-defined character set with another.
  • Page 109: Switch To Flash Download Mode

    TH210 Programmer’s Guide The printer never goes directly from the download mode to normal printer operation. To return to normal printer operation either the operator must turn the power off and then on to reboot or the application must send a command to cancel download mode and reboot.
  • Page 110: Settings Commands

    0–255 Sending this command followed by an application will download the application to the printer. This will reprogram the flash. Related information Available only in download mode of TH210-VI. For more information, contact your service representative. Reset firmware ASCII...
  • Page 111: Miscellaneous Configuration Commands

    TH210 Programmer’s Guide Upload factory settings ASCII US HT SOH TAB Hexadecimal 1F 09 01 09 Decimal 31 09 01 09 Uploads factory settings to the current communications port. Download settings ASCII US HT SOH LF Hexadecimal 1F 09 01 0A...
  • Page 112: Set Printer Emulation

    TH210 Programmer’s Guide Set max power ASCII US EXT EOT n Hexadecimal 1F 03 04 n Decimal 31 03 04 n Value of n: 0 = Auto 1 = 55W 2 = 75W 3 = 90W Default: 0 (Auto) Sets the max power to match the power supply of the printer. Auto is typically used for Wincor Nixdorf power supplies.
  • Page 113 TH210 Programmer’s Guide Value of n: 00h = 125 steps 05h = 110 steps 01h = 130 steps 06h = 115 steps 02h = 135 steps 07h = 120 steps 03h = 140 steps 08h = 150 steps 04h = 145 steps...
  • Page 114 TH210 Programmer’s Guide Enable or disable barcode string terminator ASCII US EXT RS n Hexadecimal 1F 03 1E n Decimal 31 03 30 n Value of n: 0 = Disable 1 = Enable Default: 0 (Disable) Enables or disables the barcode string terminator. If disabled, the string terminator will not be looked for when the length is specified.
  • Page 115 ID command (1D 49n). If n > 0, the printer ID will transmit whaver value of n is selected. If n = 0, the printer can be configured to send back the ID of the TH210, A794, A793 or Application Compatible Escape Command systems using the configuration menu.
  • Page 116 TH210 Programmer’s Guide Set vertical white space ASCII US EXT 0x47 n Hexadecimal 1F 03 47 n Decimal 31 03 71 n Value of n: number of dot rows 0 = Reduced white space on FF = Normal spacing When this command is sent, the amount of white space on the printed receipt is n dot rows.
  • Page 117: Commands Listed By Hexadecimal Code

    TH210 Programmer’s Guide Appendix A: Commands listed by hexadecimal code Code (hexadecimal) Command Horizontal tab Print and feed paper one line Print and return to standard mode Print and carriage return Clear printer 10 04 n Real time status transmission (DLE sequence)
  • Page 118 TH210 Programmer’s Guide Code (hexadecimal) Command 1B 3A 30 30 30 Copy character set from ROM to RAM 1B 3D n Select peripheral device (for multi-drop) 1B 3F n Cancel user-defined character 1B 40 Initialize printer 1B 44 n1...nk 00...
  • Page 119 TH210 Programmer’s Guide Code (hexadecimal) Command 1D 22 n 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 60 n1 Flash object area pack 1D 22 61 n1 n2 (n3)
  • Page 120 TH210 Programmer’s Guide Code (hexadecimal) Command 1D 66 n Select pitch of HRI characters 1D 68 n Select bar code height 1D 6B m d1...dk 00 Print bar code 1D 6B m n d1...dn 1D 6B n d1... 00 Print GS1 Databar (RSS barcode), null terminated 1D 6B m nL nH d1...
  • Page 121 TH210 Programmer’s Guide Code (hexadecimal) Command 1F 03 33 n Set default code page at power on 1F 03 3C nn Set timeout value for low-power idle state 1F 03 3D n Set Asian ASCII characters to narrow 1F 03 3F n1 n2...
  • Page 122: Resident Character Sets

    TH210 Programmer’s Guide Appendix B: Resident Character Sets Character sets Character code table Page 0 (PC437: USA, Standard Europe):...
  • Page 123: Character Code Table Page 1 (Pc850: Multilingual Latin I)

    TH210 Programmer’s Guide Character code table Page 1 (PC850: Multilingual Latin I):...
  • Page 124: Character Code Table Page 2 (Pc852: Latin Ii)

    TH210 Programmer’s Guide Character code table Page 2 (PC852: Latin II):...
  • Page 125: Character Code Table Page 3 (Pc860: Portuguese)

    TH210 Programmer’s Guide Character code table Page 3 (PC860: Portuguese):...
  • Page 126: Character Code Table Page 4 (Pc863: Canadian French)

    TH210 Programmer’s Guide Character code table Page 4 (PC863: Canadian French):...
  • Page 127: Character Code Table Page 5 (Pc865: Nordic)

    TH210 Programmer’s Guide Character code table Page 5 (PC865: Nordic):...
  • Page 128: Character Code Table Page 6 (Pc858: Multilingual I + Euro)

    TH210 Programmer’s Guide Character code table Page 6 (PC858: Multilingual I + Euro):...
  • Page 129: Character Code Table Page 7 (Pc866: Russian)

    TH210 Programmer’s Guide Character code table Page 7 (PC866: Russian):...
  • Page 130: Character Code Table Page 8 (Wpc1252: Latin I)

    TH210 Programmer’s Guide Character code table Page 8 (WPC1252: Latin I):...
  • Page 131: Character Code Table Page 9 (Pc862: Hebrew)

    TH210 Programmer’s Guide Character code table Page 9 (PC862: Hebrew):...
  • Page 132: Character Code Table Page 10 (Pc737: Greek)

    TH210 Programmer’s Guide Character code table Page 10 (PC737: Greek):...
  • Page 133: Character Code Table Page 11 (Pc874: Thai)

    TH210 Programmer’s Guide Character code table Page 11 (PC874: Thai):...
  • Page 134: Character Code Table Page 12 (Pc857: Turkish)

    TH210 Programmer’s Guide Character code table Page 12 (PC857: Turkish):...
  • Page 135: Character Code Table Page 13 (Wpc1251: Cyrillic)

    TH210 Programmer’s Guide Character code table Page 13 (WPC1251: Cyrillic):...
  • Page 136: Character Code Table Page 14 (Wpc1255: Hebrew)

    TH210 Programmer’s Guide Character code table Page 14 (WPC1255: Hebrew):...
  • Page 137: Character Code Table Page 15 (Kz_1048: Kazakh)

    TH210 Programmer’s Guide Character code table Page 15 (KZ_1048: Kazakh):...
  • Page 138: Character Code Table Page 16 (Wpc1254: Turkish)

    TH210 Programmer’s Guide Character code table Page 16 (WPC1254: Turkish):...
  • Page 139: Character Code Table Page 17 (Wpc1250: Central Europe)

    TH210 Programmer’s Guide Character code table Page 17 (WPC1250: Central Europe):...
  • Page 140: Character Code Table Page 18 (Wpc28591: Latin 1)

    TH210 Programmer’s Guide Character code table Page 18 (WPC28591: Latin 1):...
  • Page 141: Character Code Table Page 19 (Wpc28592: Latin 2)

    TH210 Programmer’s Guide Character code table Page 19 (WPC28592: Latin 2):...
  • Page 142: Character Code Table Page 20 (Wpc28599: Turkish)

    TH210 Programmer’s Guide Character code table Page 20 (WPC28599: Turkish):...
  • Page 143: Character Code Table Page 21 (Wpc28605: Latin 9)

    TH210 Programmer’s Guide Character code table Page 21 (WPC28605: Latin 9):...
  • Page 144: Character Code Table Page 22 (Pc864: Arabic)

    TH210 Programmer’s Guide Character code table Page 22 (PC864: Arabic):...
  • Page 145: Character Code Table Page 23 (Pc720: Arabic)

    TH210 Programmer’s Guide Character code table Page 23 (PC720: Arabic):...
  • Page 146: Character Code Table Page 24 (Wpc1256: Arabic)

    TH210 Programmer’s Guide Character code table Page 24 (WPC1256: Arabic):...
  • Page 147: Character Code Table Page 25 (Wpc28596: Arabic)

    TH210 Programmer’s Guide Character code table Page 25 (WPC28596: Arabic):...
  • Page 148: Character Code Table Page 26 (Katakana: Asia)

    TH210 Programmer’s Guide Character code table Page 26 (KATAKANA: Asia):...
  • Page 149: Character Code Table Page 27 (Pc775: Baltic)

    TH210 Programmer’s Guide Character code table Page 27 (PC775: Baltic):...
  • Page 150: Character Code Table Page 28 (Wpc1257: Baltic)

    TH210 Programmer’s Guide Character code table Page 28 (WPC1257: Baltic):...
  • Page 151: Character Code Table Page 29 (Wp28594: Baltic)

    TH210 Programmer’s Guide Character code table Page 29 (WP28594: Baltic):...
  • Page 152 Offenders will be liable for damages. All rights, including rights created by patent grant or registration of a utility model or design, are reserved. Delivery subject to availability; technical modifications possible. Copyright © Wincor Nixdorf International GmbH, 2015 Wincor Nixdorf International GmbH, 2015 Order No.: 01750275760 B...

Table of Contents