Cognitive Programming Language (CPL) Programmer's Guide 105-008-04 Revision F – January 2012 *105-008-04*
Federal Communications Commission (FCC) Radio Frequency Interference Statement Warning Changes or modifications to this unit not expressly approved by the party responsible for compliance could void the user’s authority to operate the equipment. Note This equipment has been tested and found to comply with the limits for a Class A digital device, pursuant to Part 15 of the FCC Rules.
Table of Contents Introduction.............................................................................................. 2 Label Format Organization .................................................................. 3 Command Syntax................................................................................ 3 Important Programming Rules............................................................. 4 Related Publications............................................................................
DRAW_ELLIPSE ........................................................................ 58 DRAW_LINE ............................................................................... 59 END ............................................................................................ 60 FILL_BOX ................................................................................... 61 GRAPHIC ................................................................................... 63 Graphics mode..........................
Get Object Data ........................................................................ 122 Mark Object for Deletion ........................................................... 123 Mark Type of Objects for Deletion............................................. 124 Pack Objects............................................................................. 126 Delete Stored Object................................................................. 127 DELIMIT........................................................
VARIABLE AUDIO_FREQ ........................................................ 173 VARIABLE AUTOCUT .............................................................. 174 VARIABLE AUTO_TOF ............................................................ 175 VARIABLE AUX_POWER ........................................................ 176 VARIABLE BACKLIGHT ........................................................... 177 VARIABLE BEEPER.................................................................
VARIABLE MEASURE_LABEL................................................. 218 VARIABLE MEDIA_ADJUST .................................................... 219 VARIABLE MENU_LANGUAGE ............................................... 222 VARIABLE MIRROR_LABEL.................................................... 223 VARIABLE MODE..................................................................... 224 VARIABLE NO_MEDIA............................................................. 226 VARIABLE NORMAL ..................
Setting Bar or Gap Index Type ........................................................ 265 Optimizing Index Detection ............................................................. 265 Direct Thermal Printing ............................................................. 265 Thermal Transfer Printing with Standard Wax Ribbon .............. 266 Thermal Transfer Printing with Resin Ribbon ........................... 266 Automatic Detect.......................................................................
VARIABLE ETHERNET JOBSOKINERROR ............................ 282 VARIABLE ETHERNET LPD .................................................... 282 VARIABLE ETHERNET NETMASK.......................................... 283 VARIABLE ETHERNET RESET ............................................... 283 VARIABLE ETHERNET RESET COMMUNITY ........................ 284 VARIABLE ETHERNET RTEL .................................................. 284 VARIABLE ETHERNET RTEL PORT .......................................
Chapter 1 Introduction Bar code printers are programmable devices. Most CognitiveTPG printers use the same command language, which has become an industry standard. NOTE: EZ-LP and PCL printers are an exception. Standard CPL printer commands do not work on an EZ-LP or PCL printer. However, VARIABLE commands can be used to configure these printers. In typical label printing applications, you will use simple ASCII commands to control the printer. You will write these commands in files called label formats.
I N T R O D U C T I O N Label Format Organization With a few exceptions that are noted in the command descriptions, every label format contains: • A header line, which defines the overall label characteristics. • One or more printer commands. • An END statement, which tells the printer that it has received all required data. Here is a typical label format: ! 0 100 190 3 PITCH 100 BARCODE UPCA+ 20 75 70 19112610203 END This label format would print a UPCA bar code on a label.
I N T R O D U C T I O N Example Sample program code is included here showing proper use of the command. NOTE: The sample code shown does not always include all the lines in the label format that produced the sample label. Header lines, END statements and the like are often omitted to save space. Also, the label images shown only illustrate the features or command under discussion. They are not to scale.
I N T R O D U C T I O N Related Publications Every printer has a User's Guide, which covers hardware issues like installation, setup, and troubleshooting. We strongly recommend that you familiarize yourself with your User's Guide before attempting to program the printer. We also recommend the following books for readers desiring more information about bar code technology in general: • The Bar Code Book by Roger C. Palmer (Helmers Publishing, Inc.
Chapter 2 Printer Command Compatibility All commands, bar codes, and fonts do not work with all printers. Commands are added with the introduction of new printers and new firmware releases. Command usage can also vary, depending on the printer's firmware. The tables following provide some general command compatibility guidelines. Y indicates that the command is supported in the current firmware version for the listed printer.
P R I N T E R C O M M A N D C O M P A T I B I L I T Y SOLUS: Solus printer series, models SD4TI and ST4TI DEL SOL/LX: Del Sol models DT and DD, and Del Sol LX models LDT and LDD EZ-LP: EZ-LP models (printers recognize some CPL commands but do not support printing CPL formats; EcPL and ZcPL emulation printing only.) PCL: C Series, models with PCL, Cxxx-1330, Cxxx-1330-RX (printers recognize some CPL commands but do not support printing CPL formats; PCL printing only.
P R I N T E R C O M M A N D C O M P A T I B I L I T Y Table 1. Printer Command Compatibility (CPL only) The following table summarizes commands that are compatible with each printer model when operating with the most current version of firmware.
DLX/DLXi CXI CI CODE RANGER BL42 ADVANTAGE/LX Y BD/BT05 INDEX BD/BT02 PRINTER SUPPORT / NOTES CODE COURIER COMMAND NAME C O M P A T I B I L I T Y DEL SOL/LX C O M M A N D SOLUS P R I N T E R Y Y N Y Y Y Y Y Y Y JUSTIFY Y Y LOGO mode Y Y MULTIPLE Y Y NOINDEX Y Y PITCH Y Y QUANTITY R90, R180, R270 Y Y STRING Y Y TERMINAL TEXT Y TIME SET N N TIME ADD N N TIME GET N N TIME QUERY N N ULTRA_FONT Y Y Universal clear Y Y Wake-up string Y WIDTH Y Y Data storage commands: Prompts N N DataSk
P R I N T E R Background graphics Header line variable dot time !A automatic header line Standard Header Line Reuse Header Line Automatic Header Background Header Clear Background Header MENU commands: MENU START MENU END MENU EXIT MENU CONTROL MENU ACTION MENU ITEM MENU MESSAGE C O M P A T I B I L I T Y DLX/DLXi Y Y Y Y Y Y Y Y Y Y Y Y Y Y Y Y Y Y Y Y Y Y Y - Y Y Y Y Y Y Y Y Y - - - Y Y Y Y Y Y Y Y Y Y Y Y Y Y Y Y Y Y Y Y Y Y Y Y Y Y Y Y Y
P R I N T E R C O M M A N D C O M P A T I B I L I T Y Table 2. Printer Set-up and Diagnostic The following table summarizes set-up and diagnostic commands supported by each printer model.
P R I N T E R C O M P A T I B I L I T Y CXI DLX/DLXi EZ-LP PCL Trace Add String to Trace File Write Trace Data to File VARIABLE commands: CI CODE RANGER DEL SOL/LX SOLUS ADVANTAGE/LX BL42 BD/BT05 BD/BT02 PRINTER SUPPORT / NOTES CODE COURIER COMMAND NAME C O M M A N D Y Y Y Y Y Y Y Y Y Y VARIABLE ALLOCATE - - - Y Y Y Y Y - - - VARIABLE AUTOCUT - - - Y - Y - Y Y Y Y Y Y Y Y Y Y Y VARIABLE AUDIO_FREQ VARIABLE AUTO_TOF N N N N N N N N Y Y Y
COMMAND NAME PRINTER SUPPORT / NOTES BD/BT05 BL42 ADVANTAGE/LX SOLUS DEL SOL/LX CODE RANGER CI CXI DLX/DLXi EZ-LP PCL C O M P A T I B I L I T Y BD/BT02 C O M M A N D CODE COURIER P R I N T E R VARIABLE ETHERNET DHCP_CRIT N N N N N N N N Y Y Y Y Y VARIABLE ETHERNET DHCP_OFFERS N N N N N N N N Y Y Y Y Y VARIABLE ETHERNET FIRMWARE VARIABLE ETHERNET GARP VARIABLE ETHERNET GATEWAY VARIABLE ETHERNET IP ADDRESS N N N N Y Y Y N Y Y Y Y Y Y Y Y Y Y N
P R I N T E R C O M P A T I B I L I T Y CXI DLX/DLXi EZ-LP PCL Y Y Y Y Y Y Y Y Y Y Y Y Y Y Y Y Y VARIABLE FEED_BUTTON Y Y Y Y Y VARIABLE FEED_CONFIG Y Y Y Y Y Y Y Y Y Y Y Y Y Y Y SOLUS Y BL42 Y BD/BT05 Y BD/BT02 CI CODE RANGER DEL SOL/LX ADVANTAGE/LX PRINTER SUPPORT / NOTES CODE COURIER COMMAND NAME C O M M A N D VARIABLE ETHERNET TELNET TIMEOUT VARIABLE ETHERNET TEXT BUFFER N N N N Y N Y N VARIABLE ETHERNET SNMP VARIABLE FEED VARIABLE FEE
P R I N T E R BD/BT05 BL42 ADVANTAGE/LX SOLUS DEL SOL/LX CODE RANGER CI CXI DLX/DLXi EZ-LP PCL PRINTER SUPPORT / NOTES BD/BT02 VARIABLE LOW_BATTERY VARIABLE LOWSPEED VARIABLE MEASURE_LABEL VARIABLE MEDIA _ADJUST VARIABLE MENU_LANGUAGE VARIABLE MIRROR_LABEL C O M P A T I B I L I T Y CODE COURIER COMMAND NAME C O M M A N D Y - - - - - - - - - - - - Y Y Y Y Y Y Y Y Y Y Y Y Y Y Y Y Y Y - - - - - Y Y N N Y Y Y Y Y Y - - - Y Y Y Y Y VARIABLE
COMMAND NAME PRINTER SUPPORT / NOTES BD/BT05 BL42 ADVANTAGE/LX SOLUS DEL SOL/LX CODE RANGER CI CXI DLX/DLXi EZ-LP PCL C O M P A T I B I L I T Y BD/BT02 C O M M A N D CODE COURIER P R I N T E R VARIABLE REPORT_LEVEL - - - - Y Y Y Y Y Y Y Y Y VARIABLE RESET - Y Y Y Y Y Y Y Y Y Y Y Y Y Y Y Y Y Y Y Y Y Y VARIABLE ROTATE_LABEL VARIABLE SCRIPT_ INPUT_RESET VARIABLE SHIFT_LEFT VARIABLE SLEEP_AFTER - Y Y Y Y Y Y Y Y Y Y Y Y Y - - - - - - Y
P R I N T E R C O M M A N D C O M P A T I B I L I T Y Table 3.
P R I N T E R C O M M A N D C O M P A T I B I L I T Y Table 4.
Chapter 3 Standard Printer Commands This chapter describes standard printer commands. Standard Printer Command List The following is a list of standard printer commands.
S T A N D A R D P R I N T E R C O M M A N D S ADJUST Function Increments or decrements a variable value or numeric data on the preceding command line. Explicit Form ADJUST variable nnn Implicit Form A variable nnn Parameters Variable The name of the variable to be adjusted, as specified in its DEFINE_VAR command. The variable value is adjusted wherever it is called before the ADJUST command in the label format. This is an optional parameter, and is not supported in all printers.
S T A N D A R D P R I N T E R C O M M A N D S ADJUST -01 STRING 12X16 150 65 ADJUST20 ADJUST 01 END 22 Revision F, January 2012, CognitiveTPG
S T A N D A R D P R I N T E R C O M M A N D S ADJUST_DUP Function Used with the ADJUST command to print nonincremented duplicates of incremented labels. Explicit Form ADJUST_DUP nnn Implicit Form AP nnn Parameters n The number of duplicate labels printed for each increment specified with the ADJUST command. NOTE: Only one ADJUST_DUP command is allowed in each label format.
S T A N D A R D P R I N T E R C O M M A N D S AREA_CLEAR Function Clears an area of a label for replotting. AREA_CLEAR may be used in a normal label format, or with the !+ header mode to combine ASCII and graphics.
S T A N D A R D P R I N T E R C O M M A N D S BARCODE Function Prints a bar code, specifying type, position, height, and characters to be coded. Explicit Form BARCODE[Rnnn] type modifiers x y h characters Implicit Form B[Rnnn] type modifiers x y h characters Parameters [Rnnn] Prints bar codes that are rotated 0, 90, 180, or 270 degrees clockwise from horizontal. type Bar code type.
S T A N D A R D P R I N T E R C O M M A N D S (n:w) Specifications for the narrow (n) and wide (w) bars. Place these modifiers within parentheses. Allowable range is 1 to 9 for both n and w. For UPC, EAN, ADD2, ADD5, and CODE128 (A, B, and C), n specifies an integral multiplier for the bar code width. For all other codes, this option specifies the width in dots of the narrow and wide bars. The value of w must always be greater than n.
S T A N D A R D Comments P R I N T E R C O M M A N D S Unless modified by a BARCODE_FONT command, all codes except UPCA+, EAN8+, EAN13+, and UPCE use an 8x8 font for bar code subtext. The excepted codes use a 5x7 font, to allow space for extender bars. Bar code subtext begins two dots below the bar code block. All bar codes are positioned independently. This includes ADD2 and ADD5, which are normally used as add-ons for UPC and EAN codes.
S T A N D A R D P R I N T E R Example 2 BARCODE UPCA+ 20 75 70 19112610203 Example 3 BARCODE CODABAR(2:5) 10 30 20 A0123B Example 4 ! 0 100 120 1 PITCH 100 BARCODE UPCA+ 10 95 70 04644200395 BARCODE_FONT 8X8(00,-73,1,1,1,1) BARCODE ADD5 120 100 61 34028 STRING 8X8 10 5 ISBN 0-395-34028-4 END C O M M A N D S The following label formats print the same bar code using different dot times and bar width ratios. (Please note, though, that these formats use variable dot time.
S T A N D A R D P R I N T E R C O M M A N D S Example 5 Revision F, January 2012, CognitiveTPG 29
S T A N D A R D P R I N T E R C O M M A N D S BARCODE AZTEC Function Prints a two-dimensional matrix symbol consisting of square modules arranged around a bulls-eye pattern at the center, using the AZTEC symbology. Explicit Form BARCODE AZTEC (ECP, SqrSize, numSym, ID E M) x y size data ECP Error control and symbol size/type indicator. 0 = Default error correction level. (This is the default value) 1 to 99 = Error correction percentage (Fixed) 101 to 104 = 1 to 4 layer compact symbol.
S T A N D A R D P R I N T E R C O M M A N D S x y X and Y starting position for bar code block. size Number of encoded data bytes, including carriage returns and line feeds, or A[delim] where delim indicates a delimiter used to mark the data start and end (see Example). data Data to be encoded. Maximum data size for the AZTEC encoding is 1536 bytes. NOTE: The number of bytes specified must exactly equal the number of bytes in the data that follows.
S T A N D A R D P R I N T E R C O M M A N D S BARCODE DATAMATRIX Function Prints a two-dimensional barcode using the Datamatrix symbology. Explicit Form BARCODE DATAMATRIX (format, ecctype, rows, cols, cell size, bytes) x y data format Specifies the data format.
S T A N D A R D P R I N T E R C O M M A N D S cell size Sets size of module (square) in the barcode in 100ths of an inch. Value specified can be decimal (see first example below). Values are between 1.0 and 10.0, blank indicates a default of 2. bytes Number of encoded data bytes, including carriage returns and line feeds, or delim which indicates a delimiter used to mark the data start and end (see Example). Leave blank for the encoder to determine the byte count.
S T A N D A R D Examples P R I N T E R C O M M A N D S ! 0 100 500 1 DELIMIT ~ BARCODE DATAMATRIX (5,E,,,2.5,) 50 50 This has a ~0x0D~ Carriage Return. END ! 0 100 500 1 BARCODE DATAMATRIX (,F,,,3,~) 50 50 ~An Alternative Simple encoding.~ INDEX END ! 0 100 500 1 BARCODE DATAMATRIX (5,E,,,2.5,) 50 50 This is Data Matrix coding. CognitiveTPG.
S T A N D A R D P R I N T E R C O M M A N D S BARCODE_FONT Function Allows selection of the font type, size, and position of the human-readable characters printed below the bar-coded information. Explicit Form BARCODE_FONT type Implicit Form BT type Parameters type Font type. Most printers can use any resident font except Ultra Font C. STRING is the default font type and will work with any printer. If you use a STRING font you only need to specify the font size and modifiers.
S T A N D A R D vertadj P R I N T E R C O M M A N D S Offsets the printed text vertically. Must be two digits; add leading zeros as required. May be positive or negative. Positive values move the subtext down, negative values move it up. NOTE: If you use the horadj or vertadj modifiers, you must specify values for all modifiers as described for the STRING command. See the STRING, TEXT, and ULTRA_FONT commands for other parameter details.
S T A N D A R D P R I N T E R C O M M A N D S Example 2 BARCODE_FONT 9x12(00,05,1,1,1,2) BARCODE UPCAX+ 35 50 50 72773740001 Example 3 ! 0 100 120 1 PITCH 100 BARCODE UPCA+ 10 95 70 04644200395 BARCODE_FONT 8X8(00,-73,1,1,1,1) BARCODE ADD5 120 100 61 34028 STRING 8X8 10 5 ISBN 0-395-34028-4 END Revision F, January 2012, CognitiveTPG 37
S T A N D A R D P R I N T E R C O M M A N D S Barcode GS1 Databar Function Explicit Form Parameters Uses BARCODE RSS command to print a GS1 databar type barcode for space-constrained identification from EAN International and the Uniform Code Council, Inc.
S T A N D A R D height P R I N T E R C O M M A N D S For GS1 Databar Expanded type, this parameter is used to specify the segment width, in segments per line. Acceptable values are 2 to 22, default is 22. For UCC/EAN & CC-A/B/C types, this parameter specifies the height of the linear portion of the bar code. Acceptable values are 1 to 500, default is 25. For all other types, this parameter is ignored. Use 0 as a placeholder. Comments x y X and Y starting position for bar code block.
S T A N D A R D Examples P R I N T E R C O M M A N D S ! 0 100 250 1 C A linear barcode only BARCODE RSS 0 (1,1,22) 50 50 200 A~ ~123456765432~ INDEX END ! 0 100 250 1 C A stacked composite component BARCODE RSS 0 (1,1,22) 250 50 200 A~ ~123456765432|Composite Component~ INDEX END 40 Revision F, January 2012, CognitiveTPG
S T A N D A R D P R I N T E R C O M M A N D S BARCODE PDF417 Function Prints a two-dimensional bar code on a label, using the PDF417 symbology. Explicit Form BARCODE PDF417 x y w:h ec% rows:cols bytes T M data Implicit Form BARCODE 7 x y w:h ec% rows:cols bytes T M data Parameters R Optional. Indicates rotated code x y X and Y starting position for bar code block. w Width (x dimension) of the narrowest element (bar or space) in the bar code.
S T A N D A R D P R I N T E R C O M M A N D S bytes Number of encoded data bytes, including carriage returns and line feeds. Macro PDF functions are invoked if this value exceeds 3072 (see comments). T Optional; produces a truncated bar code (the right row indicator and stop bar are replaced by a single width bar). M Optional; enables Macro PDF functions (see comments). data Data to be encoded. NOTE: The number of bytes specified must exactly equal the number of bytes in the data that follows.
S T A N D A R D P R I N T E R C O M M A N D S I File ID. Enter the desired file identification as a string after the I character. If the I is not followed by a valid string, the printer will select a random file ID. N File name. Enter the desired file name as a string after the N character. B Block count. The B character tells the printer to count the number of PDF417 symbols spanned by the data, and attach this number to the code. P Time stamp.
S T A N D A R D Example 44 P R I N T E R C O M M A N D S PITCH 200 BARCODE PDF417 50 10 2 6 1 0 7 309 NAME:JOHN SMITH ADDRESS:116 WILBUR BOHEMIA, NY 11716 PHONE:516-555-4907 PHYSICIAN:DR.
S T A N D A R D P R I N T E R C O M M A N D S BARCODE QR Function Prints a 2-D matrix symbology consisting of an array of nominally square modules arranged in an overall square pattern using the QR symbology. A unique pattern at three of the symbol’s four corners assists in determining the bar code size, position, and rotation. Explicit Form BARCODE QR x y cellsize [m=model] size data x y X and Y starting position for bar code block.
S T A N D A R D P R I N T E R C O M M A N D S Comments When using the QR barcode the data must be formatted to ensure the proper barcode is created. The recommended format to encode DATA in the QR barcode is QA,DATA. The first character specifies the error correction level whose possible values are L, M, Q, or H for Low, Mid, Mid-high, and High level correction, respectively.
S T A N D A R D P R I N T E R C O M M A N D S BARCODE RSS RSS is legacy term. Current term is GSI Databar. See Barcode GS1 Databar. BARCODE UPS Function Prints a two-dimensional bar code on a label, using the MaxiCode symbology. CognitiveTPG printers may implement this bar code two ways, as described below.
S T A N D A R D data P R I N T E R C O M M A N D S Data to be encoded.
S T A N D A R D P R I N T E R C O M M A N D S bytes – Number of encoded data bytes in the Low Priority Message. The number of bytes includes all carriage returns and line feeds, and must equal 84. LMdata – Alphanumeric data to be encoded as the Low Priority Message. Uppercase alpha characters only. If the total number of bytes is less than 84, pad the data with the exclamation point character (!) until there are 84 bytes in the message.
S T A N D A R D P R I N T E R C O M M A N D S Comments MaxiCodes cannot be rotated, and can never have human-readable subtext. Example The following example uses the alternate form, with data coded following the ANSI MH10.8.3 standard. NOTE: This format will not print if copied directly to the printer. The BARCODE UPS command line is broken for Help window readability.
S T A N D A R D P R I N T E R C O M M A N D S 841706672Gs840 Postal Code, Country Code Gs001Gs1Z12345675 Class of Service, Tracking Number GsUPSNGs12345EGs089 SCAC, UPS Shipper Number, Julian Day of Pickup GsGs1/1 Place holder for Shipment ID Number, Package n/x Gs10.
S T A N D A R D P R I N T E R C O M M A N D S BEEP Function Causes the printer to beep for the specified duration when the command is received. The beeper volume has been previously set. Explicit Form BEEP seconds Parameters seconds Comments The beeper will sound when the command is processed in the label. If a beep is desired when the label has finished printing, the HALT command can be used.
S T A N D A R D P R I N T E R C O M M A N D S COMMENT Function This command is used for documenting label formats. Comment lines do not affect label printing. Explicit Form COMMENT characters Implicit Form C characters Parameters characters Comments This command is primarily for internal documentation of label formats, but you can also use it to temporarily disable commands within the label format. Placing a C or the word COMMENT before the command will disable it. The non-printing comment.
S T A N D A R D P R I N T E R C O M M A N D S DOUBLE Function Prints "double byte" text characters from a selected font set. Double byte fonts are used for characters that require greater resolution than can be provided in a single byte (specifically, Kanji characters). Explicit Form DOUBLE font ID (exspace,rotation,xmult,ymult) x y mtid characters Parameters font Specifies the text font.
S T A N D A R D P R I N T E R C O M M A N D S this into account when using the DOUBLE command. Example The following label format will print text using the double byte characters. The Kanji characters are mapped above ASCII 128, so may not display correctly on your terminal.
S T A N D A R D P R I N T E R C O M M A N D S DRAW_BOX Function Draws a hollow rectangle on the label. Explicit Form DRAW_BOX x y w h t Implicit Form D x y w h t Parameters x X coordinate of upper left corner of box y Y coordinate of upper left corner of box w Box width, measured in dot columns. Must be greater than zero. h Box height, measured in dot rows. Must be greater than zero. t Optional; specifies line thickness in dots. The default is 1.
S T A N D A R D P R I N T E R C O M M A N D S DRAW_CIRCLE Function Draws a circle located by the upper left corner of a square enclosing the circle. Explicit Form DRAW_CIRCLE x y d t c Parameters x X coordinate of upper left corner of enclosing square y Y coordinate of upper left corner of enclosing square d Circle diameter. Must be greater than zero. t Optional; specifies line thickness in dots. The default is 1.
S T A N D A R D P R I N T E R C O M M A N D S DRAW_ELLIPSE Function Draws an ellipse located by the upper left corner of a rectangle enclosing the ellipse on the label. Explicit Form DRAW_ELLIPSE x y w h t c Parameters x X coordinate of upper left corner of enclosing rectangle. y Y coordinate of upper left corner of enclosing rectangle. w Ellipse width, measured in dot columns. Must be greater than zero. h Ellipse height, measured in dot rows. Must be greater than zero.
S T A N D A R D P R I N T E R C O M M A N D S DRAW_LINE Function Draws a line from coordinate x1, y1 to x2,y2. Explicit Form DRAW_LINE x1 y1 x2 y2 t c Parameters x1 Starting X coordinate of line. x2 Starting Y coordinate of line. x2 Ending X coordinate of line. y2 Ending Y coordinate of line. t Optional; specifies line thickness in dots. The default is 1. c Optional; specifies plotting modes. B=plot black, W=plot white.
S T A N D A R D P R I N T E R C O M M A N D S END Function Signals the end of a label format Explicit Form END Implicit Form E Parameters None Comments The END command tells the printer that all data required for the current label format has been sent. When the END command reaches the printer, the label format is processed and printing begins.
S T A N D A R D P R I N T E R C O M M A N D S FILL_BOX Function This command inverts every dot in the specified rectangular area. Where the existing field is white, the FILL_BOX command fills it in black, while areas already black are flipped to white. Explicit Form FILL_BOX x y w h Implicit Form F x y w h Parameters x X coordinate of upper left corner of box y Y coordinate of upper left corner of box w Box width, measured in dot columns. Must be greater than zero.
S T A N D A R D Example 1 Example 2 62 ! 0 100 180 PITCH 200 FILL_BOX 50 FILL_BOX 50 FILL_BOX 25 FILL_BOX 27 END P R I N T E R C O M M A N D S 1 50 50 25 27 750 725 750 750 85 60 85 85 ! 0 100 90 1 PITCH 100 ULTRA_FONT B25 (6,0,0) FILL_BOX 65 1 130 20 ULTRA_FONT B25 (4,2,0) FILL_BOX 65 1 130 30 ULTRA_FONT B25 (6,0,0) FILL_BOX 65 36 130 20 ULTRA_FONT B25 (4,2,0) END 70 5 SHELL 1 71 6 SHELL 1 70 40 SHELL 2 71 40 SHELL 2 Revision F, January 2012, CognitiveTPG
S T A N D A R D P R I N T E R C O M M A N D S GRAPHIC Function Initializes the printer to receive graphics data, and positions the received graphic on a label. This ASCII command allows you to send standard PCX or BMP format graphics directly from a file. NOTE: GRAPHIC must be the last command in its label format. Do not follow it with an END command. The printer waits for graphics data and a following printable label file after receiving this command.
S T A N D A R D Example P R I N T E R C O M M A N D S The following two label formats will print a PCX graphic with its upper left corner at location 416, 14 if the appropriate PCX file is sent to the printer following the first label format. Format 1 ! 0 100 600 0 JUSTIFY RIGHT GRAPHIC PCX 416 14 - (Send the graphics file here. The printer will print after it receives the label format below.
S T A N D A R D P R I N T E R C O M M A N D S Graphics mode Function Initializes the printer to receive binary data for printing bitmapped graphics. Unlike most commands, this command is not sent as ASCII text. Send all graphics data, including the header line, to the printer in a continuous binary data stream. Explicit Form mode dottime dotrows numlbls data Parameters mode The graphics command. Use @ for foreground graphics printing, # for background graphics printing.
S T A N D A R D Comments P R I N T E R C O M M A N D S When programming in graphics mode, you control every dot on the print head separately. All the dots on the finished label can be either dark or light, depending on the setting for each bit in the graphics file. Send all data to the printer in a continuous binary stream. Enough data must reach the printer to control all the dots for the specified number of dot rows over the print width.
S T A N D A R D P R I N T E R C O M M A N D S ASCII commands cannot be mixed in the binary graphics file. If you want to print predefined objects (such as bar codes or text) on the same label with binary bitmapped graphics, you have four possible approaches: 1. Program either the graphics or the ASCII components in the background, and put the other components in the foreground. 2.
S T A N D A R D P R I N T E R C O M M A N D S HALT Function Pauses the printer after it prints one label. If there are more labels left to print in the current batch, pressing the printer's feed switch will signal the printer to print the next label. The HALT command also activates the label cutter in printers so equipped. Explicit Form HALT Implicit Form H Parameters None Comments This feature is intended for situations that require many similar labels, presented one at a time.
S T A N D A R D P R I N T E R C O M M A N D S Header line Function Initializes the printer to receive a label format. Explicit Form mode x dottime maxY numlbls Parameters mode Sets the encoding mode for the label format. Valid characters are: ! Standard header line. ASCII mode: The printer treats all incoming data as ASCII commands in this mode. @ Graphics mode: All incoming data is treated as binary graphics. (See Graphics mode for further details.) !# Background header line.
S T A N D A R D 70 P R I N T E R C O M M A N D S !* Clear background header line. (ASCII or GRAPHICS): Turns off background mode, recombining the foreground and background memory buffers. Does not clear memory. !+ Reuse header line. New start sequence - plots a label over an existing label without erasing the previous label. (See also AREA_CLEAR command.) !A Automatic header line. Same as !, except remaining header line parameters are not required.
S T A N D A R D P R I N T E R C O M M A N D S x X starting position for label. Older printers used this parameter to position labels horizontally so two labels could be printed side-by-side. Always set x equal to zero in any printers that support the MULTIPLE command. High speed Barcode Blaster printers automatically limit their print speed to 3 IPS when x is nonzero. dottime Determines how long the printhead dots stay hot, thereby changing the dot length.
S T A N D A R D Comments P R I N T E R C O M M A N D S The ASCII background and graphics background modes do not print labels immediately. Background mode splits the printer memory into two segments: the foreground and background memory buffers. Data sent via background mode resides in the background buffer and prints when the next label format containing foreground data reaches the printer. Background data stays in memory until intentionally cleared. All label formats require a header line.
S T A N D A R D Function P R I N T E R C O M M A N D S Enables automatic label indexing. When printing is finished the printer feeds the label stock until the next label's first dot row is positioned under the printhead burn line (based on the position of the label's indexing cue; i.e., the black bar or gap location). This is the default operating mode. Label indexing remains on unless disabled with a NOINDEX command. IMPORTANT! Do not use this command when using continuous-form media.
S T A N D A R D P R I N T E R C O M M A N D S JUSTIFY Function Positions Ultra Font and TEXT printing, PDF417 and MAXICODE bar codes, and GRAPHIC command images either left, right, or center of their horizontal coordinate (X coordinate for non-rotated text and bar codes, Y coordinate for rotated text and bar codes).
S T A N D A R D P R I N T E R C O M M A N D S Example 1 JUSTIFY LEFT ULTRA_FONT A40 (5,0,0) 400 10 LEFT JUSTIFY JUSTIFY RIGHT ULTRA_FONT A40 (5,0,0) 400 50 RIGHT JUSTIFY JUSTIFY CENTER ULTRA_FONT A40 (5,0,0) 400 90 CENTER JUSTIFY END Example 2 JUSTIFY LEFT ULTRA_FONT A40 (5,0,90) 150 120 LEFT JUSTIFY RIGHT ULTRA_FONT A40 (5,0,90) 100 120 RIGHT JUSTIFY CENTER ULTRA_FONT A40 (5,0,90) 50 120 CENTER END Revision F, January 2012, CognitiveTPG 75
S T A N D A R D P R I N T E R C O M M A N D S LOGO mode Function Allows placement of bitmapped graphics in specific label areas, or windows. You specify the window sizes and locations individually. Any number of graphics windows is allowed, providing they do not overlap. NOTE: Unlike most commands, you cannot enter the logo mode command in ASCII form. The printer will only accept it as pure binary data with no extraneous characters.
S T A N D A R D Comments P R I N T E R C O M M A N D S In background mode, the maximum programmable label size is cut in half. Consider using foreground LOGO mode with the !+ header line when printing combined ASCII and graphics. When sending the x, y, w, and h parameters, send the most significant byte first. Clear memory by sending a dummy label format to the printer before and after using LOGO mode. This keeps residual data from spoiling the finished label.
S T A N D A R D P R I N T E R C O M M A N D S MULTIPLE Function Causes the printer to print duplicate labels side-byside. Explicit Form MULTIPLE nnn Implicit Form M nnn Parameters n is the number of duplicate labels to print side-byside. The acceptable range is 2 to 9. The labels printed side-by-side must actually fit in the available space; otherwise they are truncated on the right side. NOTE: Avoid using this command with high speed Barcode Blaster printers.
S T A N D A R D Example P R I N T E R C O M M A N D S ! 0 130 70 2 PITCH 100 WIDTH 224 MULTIPLE 2 STRING 8X8 7 0 ADIDAS 4446 STRING 8X8 7 10 JOGGING STRING 8X8 7 20 SHORTS STRING 8X8 37 30 $14.
S T A N D A R D P R I N T E R C O M M A N D S NOINDEX Function Disables index detection. The printer will stop feeding the label after printing the last dot row. With most printers, this command remains in effect until you turn the printer off or issue an INDEX command. Portable printers are an exception: in these printers, NOINDEX shuts off when the printer goes to sleep.
S T A N D A R D P R I N T E R C O M M A N D S PITCH Function Sets the print density in dots per inch. Explicit Form PITCH nnn Implicit Form P nnn Parameters nnn is equal to print pitch in dots per inch (DPI). Allowable values depend on the printhead density: PH Density Default Pitch Alternate Pitch 300 300 150 203 200 100 150 150 75 NOTE: The default pitch changes to the lowest available print pitch if Blazer emulation is enabled. See the VARIABLE MODE command for more information.
S T A N D A R D Example 82 P R I N T E R C O M M A N D S ! 0 100 90 1 PITCH 200 JUSTIFY CENTER ULTRA_FONT B20 (5,0,0) 400 10 UFONT B20 AT 200 PITCH END ! 0 100 45 1 PITCH 100 JUSTIFY CENTER ULTRA_FONT B20 (5,0,0) 200 10 UFONT B20 AT 100 PITCH END Revision F, January 2012, CognitiveTPG
S T A N D A R D P R I N T E R C O M M A N D S PRINT TEST LABEL Function Causes the printer to print a test label that displays most of the current configuration settings. This is the same label that prints out when the feed button is pressed at power up. Explicit Form !PRINT TESTLABEL Parameters None Comments This command does not require a header line, but must be followed by a line feed (or carriage return and line feed). Do not use any other commands with PRINT TEST LABEL.
S T A N D A R D P R I N T E R C O M M A N D S QUANTITY Function Sets the quantity of labels to be printed by the label format. Explicit Form QUANTITY numlabels Implicit Form QY numlabels Parameters numlabels is equal to the number of labels printed by the label format. The allowable range is 0 to 65535. Comments Using this command is functionally identical to specifying the number of labels in the header line, but offers the programmer some added flexibility since numlabels can be a variable.
S T A N D A R D P R I N T E R C O M M A N D S Query Firmware Revision Function Causes the printer to send firmware revision information to the host computer. The printer sends its firmware part number, revision, revision time, and revision date in response to this command. Such information is useful when developing software that must control several different printers.
S T A N D A R D P R I N T E R C O M M A N D S Query Index Buffer Values Function This command is used to query the values in the index sensor buffer. Explicit Form !QIB Comments This command will return comma separated values that are the value from the index sensor and the index mark value. The index mark value will be 0 if this is the trailing edge of an index mark, 255 if it is the leading edge of an index mark or it will be current white level value.
S T A N D A R D P R I N T E R C O M M A N D S Query Index Settings Function This command is used to query the current index sensor settings. Explicit Form !QI Comments This command does not require a header line, but must be followed by a line feed (or carriage return and line feed). Do not use any other commands with !GET INDEX. Example The following will return the index settings to the current communication port.
S T A N D A R D P R I N T E R C O M M A N D S Query Printer Status Function Causes the printer to send a status message to the host computer. The status message indicates the current printer condition, such as ready, printing, low battery, out of paper, and so on. Such information is useful when controlling the printer from a remote site. However, the host computer must be programmed to properly interpret the incoming data.
S T A N D A R D Comments P R I N T E R C O M M A N D S This command replaces the normal header line. Follow the command with a line feed (or carriage return and line feed). Do not use any other commands with QUERY STATUS.
S T A N D A R D P R I N T E R C O M M A N D S B Background. This is the status if there is a valid image in the background memory buffer and no print tasks are pending. C Charging (applicable only to portable printers). The printer battery is charging and no print tasks are pending. The printer sends this message once per second if USER_FEEDBACK is ON. R Ready. The printer has no pending print tasks, is not charging, and the background buffer is empty.
S T A N D A R D P R I N T E R C O M M A N D S L Low battery. The printer sends this message eight times per second if it detects a low power condition and USER_FEEDBACK is ON. The printer will send this message once regardless of the USER_FEEDBACK state if the power drops below the normal operating voltage level (for example, when the power is switched off). O Out of paper. The printer sends this message eight times per second if it runs out of paper and USER_FEEDBACK is ON.
S T A N D A R D P R I N T E R C O M M A N D S The printer sends a five digit number after each letter. If the leading letter is a C (indicating the battery is charging), the number following the C is proportional to the battery charge state. If the leading letter is an E (indicating an EEPROM error), the number following the E is the EEPROM checksum. In all other cases, the five digit number shows the quantity of unprinted labels in the current batch. E messages have two parts.
S T A N D A R D P R I N T E R C O M M A N D S ROTATE R90, R180, R270 Function Prints STRING text on the label, rotated clockwise in three orientations: R90 – Prints text rotated 90 degrees clockwise from horizontal. R180 – Prints text rotated 180 degrees clockwise from horizontal (upside-down). R270 – Prints text rotated 270 degrees clockwise from horizontal.
S T A N D A R D P R I N T E R See also STRING, ULTRA_FONT, TEXT Example ! 0 100 100 1 STRING 9X12 32 10 NORMAL R90 9X12 97 16 RIGHT R180 9X12 77 50 FLIP R270 9X12 10 55 LEFT END 94 C O M M A N D S Revision F, January 2012, CognitiveTPG
S T A N D A R D P R I N T E R C O M M A N D S Show Inches Printed Function This command is used to query the printer’s inches printed count. Explicit Form !SHOW INCHCOUNT Comments This command does not require a header line, but must be followed by a line feed (or carriage return and line feed). Do not use any other commands with !SHOW INCHCOUNT. Example The following will return the inches printed count to the current communication port.
S T A N D A R D P R I N T E R C O M M A N D S Show Model Number Function This command is used to query the printer’s model number. Explicit Form !SHOW MODELNUMBER Comments This command does not require a header line, but must be followed by a line feed (or carriage return and line feed). Do not use any other commands with !SHOW MODELNUMBER. Example The following will return the printer’s model number to the current communication port.
S T A N D A R D P R I N T E R C O M M A N D S Show Serial Number Function This command is used to query the printer’s serial number. Explicit Form !SHOW SERIALNUMBER Comments This command does not require a header line, but must be followed by a line feed (or carriage return and line feed). Do not use any other commands with !SHOW SERIALNUMBER. Example The following will return the printer’s serial number to the current communication port.
S T A N D A R D P R I N T E R C O M M A N D S STRING Function Prints text (ASCII characters) on a label using CSI fonts. These are non-proportional, non-compressed bitmapped fonts. Explicit Form STRING type(eximage,exspace,xmult, ymult) x y characters Implicit Form S type(eximage,exspace,xmult,ymult) x y characters Parameters type Specifies the basic font size, in dots. There are seven font sizes: 3X5, 5X7, 8X8, 9X12, 12X16, 18X23, and 24X31.
S T A N D A R D P R I N T E R C O M M A N D S each time. When using this modifier you must specify values for exspace, xmult, and ymult. The allowable range is 1 to 9. For normal boldness, use a value of 1. Comments exspace Modifies the spacing between characters. Specify values for xmult and ymult when using exspace. The allowable range is 1 to 9. For normal spacing, use a value of 1. xmult Independently expands the width of any font.
S T A N D A R D Font Type 3X5 5X7 8X8 9X12 12X16 18X23 24X31 P R I N T E R C O M M A N D S Cell Size 4X5 6X7 8X8 9X12 13X16 19X23 25X31 When programming label formats, you can calculate the exact amount of space required by text blocks using the cell sizes shown. STRING fonts are stored in user-accessible memory in many printers, and are handled as stored objects. This means they may be deleted or replaced in the field, so the actual resident fonts may differ from those delivered in the printer.
S T A N D A R D Example 2 P R I N T E R C O M M A N D S ! 0 100 100 1 PITCH 100 STRING 5X7 10 0 LETTERS - 5X7 STRING 8X8 200 0 LETTERS - 8X8 STRING 9X12 10 10 LETTERS - 9X12 STRING 12X16 200 10 LETTERS - 12X16 STRING 18X23 10 28 LETTERS - 18X23 STRING 24X31 10 53 LETTERS - 24X31 END Revision F, January 2012, CognitiveTPG 101
S T A N D A R D P R I N T E R C O M M A N D S TERMINAL Function Configures port to be used to prompt for input when using stored formats, stored menus or stored variables. Explicit Form TERMINAL port Implicit Form TERMINAL port Parameters port Comments This command is meant to be used during script execution. When the DISCOVER parameter is used the printer assumes the display device is attached to the port that initiated the script.
S T A N D A R D P R I N T E R C O M M A N D S TEXT Function Prints text on a label using compressed bitmapped fonts. Explicit Form TEXT fontID(spacing,rotation,xmult,ymult) x y characters Implicit Form T fontID(spacing,rotation,xmult,ymult) x y characters Parameters fontID Specifies the font family and size.
S T A N D A R D P R I N T E R C O M M A N D S The following parameters are contained in parentheses and are optional: Comments spacing Sets the spacing between characters. Valid entries are 0 to 255, and set the number of dots between proportionally spaced characters. If a negative sign is placed before the spacing value, the type is spaced nonproportionally and the spacing value will set the character cell width. rotation Clockwise rotation of the printed character string.
S T A N D A R D Example P R I N T E R C O M M A N D S JUSTIFY CENTER TEXT 3 410 0 TEXT FONT TEXT 3(0,0,1,1) 410 40 TEXT FONT TEXT 3(10,0,1,1) 410 80 TEXT FONT TEXT 3(20,0,1,1) 410 120 TEXT FONT TEXT 3(0,0,2,1) 410 160 TEXT FONT TEXT 3(0,0,1,2) 410 200 TEXT FONT Revision F, January 2012, CognitiveTPG 105
S T A N D A R D P R I N T E R C O M M A N D S TIME Function Sets or gets data from the real-time clock in printers so equipped. Data derived from the clock resides in the system variable TIME. Explicit Form TIME action Implicit Form TE action Parameters action Clock operation. Allowable operations are SET, GET, and ADD, used as follows: TIME SET Sets the clock to the numeric time value following the command.
S T A N D A R D TIME ADD TE ADD TIME ? TE ? P R I N T E R C O M M A N D S Adds the specified interval to the last time read by TIME GET (that is, to the value currently stored in the variable TIME). The specified time interval must be in the form described under TIME SET, and you must specify all six parameters. Added intervals can be negative or positive. Addition starts at the seconds field, and added values arithmetically carry or borrow when a field over- or underflows.
S T A N D A R D P R I N T E R C O M M A N D S place after the TIME variable: 108 Parameter Returns %% % character %a Abbreviated weekday name (Sun, Mon, Tue) %A Full weekday name (Sunday, Monday, Tuesday) %b Month name (Jan, Feb, Mar) %B Full month name (January, February, March) %c Date and time using a two-digit year (mm/dd/yy hh:mm:ss; for example, 09/25/09 15:35:20) %C Date and time starting with a number to represent the day of the week, i.e.
S T A N D A R D P R I N T E R C O M M A N D S is the first day of the week (00 - 53) %w Weekday where 0 is Sunday (0 - 6) %W Digit week number, where Monday is the first day of the week (00 - 53) %x Date, with two-digit year (mm/dd/yy; for example, 05/21/98) %X Time (hh:mm:ss; for example, 21:45:30) %y Two-digit year without century (00 to 99) %Y Year with century You can use multiple formatting characters and mix printable characters with the formatting characters, to present the time or dat
S T A N D A R D Example 3 P R I N T E R C O M M A N D S The following command line will print the current date as stored in the TIME variable, in the form mm/dd/yy: TEXT 2 20 100 The date is: ~TIME %m/%d/%y~ 110 Revision F, January 2012, CognitiveTPG
S T A N D A R D P R I N T E R C O M M A N D S ULTRA_FONT Function Prints text on a label, using Ultra Fonts (stroke fonts). Unlike STRING fonts, Ultra Fonts maintain their shape in any size and boldness. Font modifiers can change character bolding, spacing, and rotation. Font type C may also be italicized and "grayed." Explicit Form ULTRA_FONT Tnnn IGz(bold,space,rot) x y char Implicit Form U Tnnn IGz(bold,space,rot) x y char Parameters T Font type, A, B, or C.
S T A N D A R D P R I N T E R C O M M A N D S x y Starting position of the printed character string. The reference point on the text block varies with character rotation. For 0 and 270 degree rotation, the X and Y starting position of the text block is in the upper left corner of the block. For 90 and 180 degree rotation, the X and Y starting position of the string is in the lower left corner of the text block. char ASCII characters to be printed.
S T A N D A R D Comments P R I N T E R C O M M A N D S space Number of dots between each printed character. Valid entries are 0 to 255 and N, with a default of 1. N sets nonproportional character spacing; that is, each character has the same width. Font type C does not support nonproportional spacing. rot Clockwise rotation of the printed characters. Valid entries are 0, 90, 180, and 270. The default is 0.
S T A N D A R D P R I N T E R C O M M A N D S U A30 (4,0,0) 220 360 Ultra fonts can be rotated, U A30 (4,0,0) 220 400 scaled, and bolded to U A30 (4,0,0) 220 440 produce a wide range of U A30 (4,0,0) 220 480 unique typefaces.
S T A N D A R D P R I N T E R C O M M A N D S Universal Clear Function Resets the printer to its initial power on state, effectively the same as cycling printer power. Explicit Form (ASCII) 23 23 23 23 23 67 76 69 65 82 23 23 23 23 23 Parameters None Comments Unlike other commands, you cannot send the Universal Clear command to the printer as a printable ASCII string of letters and/or numbers. Most computer keyboards do not have a character corresponding to ASCII 23.
S T A N D A R D P R I N T E R C O M M A N D S Wake-up string Function Switches the printer from idle to active mode in preparation for incoming data. Explicit Form CCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCC C Parameters None Comments The 4.25" portable printers use an energy-saving "sleep mode" to save battery power during periods of inactivity. These printers won't accept data when they are asleep. Code Courier printers go to sleep immediately after finishing the current task.
S T A N D A R D P R I N T E R C O M M A N D S does not adversely affect the behavior of printers that do not require one. You may want to send a wake-up string to every printer prior to sending your label formats, to help assure compatibility with all printers.
S T A N D A R D P R I N T E R C O M M A N D S WIDTH Function Sets the width of the printed label. Typically, this command is for printing on label stock that is narrower than the printhead. Explicit Form WIDTH nnn Parameters W nnn Comments Since data is handled in whole words, any value specified for the WIDTH results in an actual print width that can be expressed in 16 bits. The printer will round up any width value to the nearest whole word.
S T A N D A R D P R I N T E R C O M M A N D S NOTE: The WIDTH command is necessary with the Del Sol to correctly position the printing image. The WIDTH command line must precede any command that maps label components on the printer's memory grid, such as STRING or BARCODE. High speed Barcode Blasters automatically disable high speed printing when they encounter this command in a label format.
Chapter 4 Storing Data in the Printer Memory Commands discussed in this section allow you to store label formats and graphics in the printer's memory for later use. Internal data storage can help improve label throughput and may also simplify programming in some applications. NOTE: Internal data storage capability is an optional feature. Not all printers accept these commands, and due to hardware limitations, some printers that accept the commands may not successfully store data.
S T O R I N G D A T A I N T H E P R I N T E R M E M O R Y NOTE: CognitiveTPG does not recommend using volatile RAM for stored objects, since objects stored in volatile RAM is lost when the printer is turned off. However, you may want to use volatile RAM to store variables or objects that will change frequently. • When using volatile RAM for object storage, you must allocate space for that purpose. Refer to the VARIABLE ALLOCATE command for more information.
S T O R I N G D A T A I N T H E P R I N T E R M E M O R Y Get Object Data Function This command is used to get the binary data of an object. Explicit Form !OBJECT UPLOAD location id Parameters location Memory location to store the defined variable. The following memory areas are available: 0 – Volatile Ram 3 – Nonvolatile Ram (Flash) id Comments Stored object identifier assigned when the object was first stored.
S T O R I N G D A T A I N T H E P R I N T E R M E M O R Y Mark Object for Deletion Function Marks an object for deletion. The object will be deleted when the printer is power cycled or when the !OBJECT PACK command is issued. Explicit Form !OBJECT MARK id Parameters Comments Id String identifier for the object. Up to 8 characters long. The identifier is displayed when the object list is printed. Ultra font C (uffontc) is an internal font and cannot be deleted.
S T O R I N G D A T A I N T H E P R I N T E R M E M O R Y Mark Type of Objects for Deletion Function Marks all objects of a specific type for deletion. The objects will be deleted when the printer is power cycled or when the !OBJECT PACK command is issued. Explicit Form !OBJECT MARK_TYPE type Parameters type 124 19 Type of objects to be marked for deletion, listed below.
S T O R I N G D A T A I N T H E P R I N T E R M E M O R Y Comments This command can be used with the !OBJECT PACK command to speed up the deletion of multiple objects. See Also !OBJECT MARK, !OBJECT PACK Example The following command will mark all code page objects for deletion.
S T O R I N G D A T A I N T H E P R I N T E R M E M O R Y Pack Objects Function Deletes all objects that have been marked for deletion from the printer.
S T O R I N G D A T A I N T H E P R I N T E R M E M O R Y Delete Stored Object Function Deletes a stored object from memory. NOTE: This command replaces the normal header line. Do not use any other commands, including the END command, with this command. Explicit Form !D identifier Parameters identifier Stored object identifier assigned when the object was first stored.
S T O R I N G D A T A I N T H E P R I N T E R M E M O R Y DELIMIT Function Specifies the delimiter used to isolate variables within command lines. Explicit Form DELIMIT C Parameters C Comments Define the delimiter character before using any variables in a label format. The delimiter character must precede and follow every variable and its associated parameters. Delimiter character.
S T O R I N G D A T A I N T H E P R I N T E R M E M O R Y DEFINE VARIABLE Function Defines a variable for use within printer commands in a label format. When the printer encounters a variable in a command line, it replaces the variable name with entered or stored data. It can also (optionally) send a prompt for data to the user via the port selected with the VARIABLE TERMINAL command.
S T O R I N G 130 D A T A I N T H E P R I N T E R M E M O R Y length The maximum number of characters that are accepted as variable data. Allowable values are 1 to 32767, but available printer memory may impose a lower practical limit on this parameter. The DEFINE_VAR command also has a maximum line length of 254 characters, which will limit the variable length if it must be initialized. type Variable type. Available types are: P Protected.
S T O R I N G range D A T A I N T H E P R I N T E R M E M O R Y Input range specifier. Available specifiers are: A Only allows alphabetic characters N Only allows alphabetic and numeric characters (no punctuation) X Allows any character # Allows signed or unsigned whole numbers (no decimal point) You can specify a range for alphabetic or numeric variables by adding minimum and maximum values within double quotes. For example, # "100" "199" allows numeric values between 100 and 199 inclusive.
S T O R I N G pad 132 D A T A I N T H E P R I N T E R M E M O R Y R Places the data at the right end of the space specified by length parameter, filling the remaining space to the left with the character specified by pad. C Places the data in the center of the space specified by length parameter, filling the remaining space on both sides with the character specified by pad. N Tells the printer to ignore the length parameter so the variable data only occupies the space it actually needs.
S T O R I N G “prompt” D A T A I N T H E P R I N T E R M E M O R Y ASCII text that the printer sends to the port selected with the VARIABLE TERMINAL command when ready to receive data for the defined variable. Enclose the prompt text with quotation marks ("). If no prompt is desired, enter two quotation marks ("") with no characters between them. To include quotation marks within the prompt, precede the internal quotation mark with a backslash (\).
S T O R I N G D A T A I N T H E P R I N T E R M E M O R Y Format Recall Function Recalls a stored format from memory, merges any incoming variable data with the stored data, and prints labels as required. NOTE: This command replaces the normal header line. Do not use any other commands, including the END command, with this command. Explicit Form !R t identifier x 100 maxY numlabels Parameters t Data types. Use F for standard ASCII format files and E for enhanced format files.
S T O R I N G D A T A I N T H E P R I N T E R M E M O R Y Format Store Function Stores a label format in a specified memory area. The stored format can be recalled and printed with the Format Recall command. There are two general types of stored formats: standard and enhanced. The printer stores standard formats as ASCII data only. Enhanced stored formats are stored as fully mapped images in the image buffer, as well as ASCII data in the specified memory area.
S T O R I N G D A T A I N T H E P R I N T E R M E M O R Y Placing two variable field delimiters in a row creates a repeating field; i.e., will cause the printer to use the variable data from the previous variable field in the current field. This feature may be useful if you want to print the same data using two different fonts, or want to print the data as a rotated bar code and non-rotated text.
S T O R I N G D A T A I N T H E P R I N T E R M E M O R Y NOTE: Determine nnn using the number of dot rows actually occupied by the stored object, rather than from the number of dot rows available on the physical label. Memory space reserved by nnn is unavailable for other uses. Specifying too large a value wastes image buffer space. Storing multiple enhanced formats can quickly use up the image buffer.
S T O R I N G Example 1 D A T A I N T H E P R I N T E R M E M O R Y The following commands store the format that prints the label in the Format Recall example. Data is still needed for the description, price, and combined item/price. The printer will send prompts for this data to the serial port at print time. This is a standard stored format; notice that commands that define fixed data are freely mixed with commands that define variable data.
S T O R I N G D A T A I N T H E P R I N T E R M E M O R Y GRAPHIC RECALL Function Recalls a stored graphic from memory and prints labels as required. Explicit Form GRAPHIC RECALL Identifier x y Parameters identifier Stored object identifier assigned when the object was first stored. x y Starting position of the printed graphic; normally its upper-left corner. (The JUSTIFY command can position the graphic right, left, or center of the specified coordinates.
S T O R I N G D A T A I N T H E P R I N T E R M E M O R Y GRAPHIC STORE Function Stores the graphics file following the command in the specified memory area NOTE: Use this command with a dummy header line, and do not use an END command or any other commands with it. The graphics data to be stored must immediately follow the GRAPHIC STORE command. Explicit Form GRAPHIC STORE Type xx Identifier Parameters Type Graphic file type.
S T O R I N G D A T A I N T H E P R I N T E R M E M O R Y GRAPHIC STORE BMP 3 IMAGE_1 Revision F, January 2012, CognitiveTPG 141
S T O R I N G D A T A I N T H E P R I N T E R M E M O R Y Initialize Storage Function Clears all stored objects from the specified memory area in preparation for new data. NOTE: This command replaces the normal header line. Do not use any other commands, including the END command, with this command. Explicit Form !I xx Parameters xx Comments None Example The following command will clear nonvolatile RAM of all stored objects: Numeric identifier for the memory area to be cleared.
S T O R I N G D A T A I N T H E P R I N T E R M E M O R Y List Stored Objects Function Scans all memory areas for stored objects (label formats and graphics), then prints a list of all the objects, their size in bytes, their memory location, and the amount of available memory in each memory area. NOTE: This command replaces the normal header line. Do not use any other commands, including the END command, with this command.
S T O R I N G D A T A I N T H E P R I N T E R M E M O R Y Recall Menu Function Recalls a stored menu from memory and initiates its execution. NOTE: This command replaces the normal header line. Do not use any other commands, including the END command, with this command. Also, take care that no extraneous control characters follow the command; the printer may interpret them as menu control characters.
S T O R I N G D A T A I N T H E P R I N T E R M E M O R Y Recall Variable Function Recalls a stored variable for user input. The printer will send the associated prompt to the port selected with the VARIABLE TERMINAL command and await user input when it encounters this command. NOTE: This command replaces the normal header line. Do not use any other commands, including the END command, with this command.
Chapter 5 Menu Commands A menu lets the user control the printer at print time through a set of predefined choices. Menus are typically used when the printer is connected to a simple controlling device, such as a keyboard/display unit. IMPORTANT! Menu programming is inherently complex, and is only useful if the user must control the printer with a non-programmable device (such as a dumb terminal or keyboard).
M E N U C O M M A N D S They can even call printer commands without any user-selectable menu items, behaving much like stored label formats. Menus can call other menus, and can also recall and print stored objects or data.
M E N U C O M M A N D S Menus are stored objects. They must be stored in memory before they are called by the Recall Menu command. They follow all of the usual rules for stored objects. Menu Command List MENU ACTION MENU CONTROL MENU END MENU EXIT MENU ITEM MENU MESSAGE MENU START Recall Menu NOTE: There is no underscore between MENU and the sub-command name. For example, MENU ACTION is correct; MENU_ACTION is incorrect. Several other commands are especially useful when programming menus.
M E N U C O M M A N D S MENU ACTION Function Specifies one or more commands that the printer will execute when the user selects the associated MENU ITEM. Any legitimate printer commands are allowed (including the Recall Menu command). The printer commands and associated parameters embedded within the MENU ACTION command must be bounded by quotation marks.
M E N U C O M M A N D S If the printer finds a format header line within a MENU ACTION, it will expect all commands associated with that header line, up to and including the END command, to immediately follow within the same MENU ACTION command. You cannot split a label format over multiple MENU ACTION commands. Menus can contain MENU ACTION commands without any MENU ITEM commands. The printer will execute commands within such menus without operator intervention.
M E N U Example 3 C O M M A N D S The following label format will store a menu called MENU_ONE.
M E N U C O M M A N D S MENU CONTROL Function Specifies the characters used to exit, "scroll," or select an item from a menu. In most applications, these characters are chosen by pressing the four keys on the external keyboard that correspond to keyboard functions "cancel," next," "previous," and "select." Explicit Form MENU CONTROL cn nx pr se Implicit Form MU CONTROL cn nx pr se Parameters cn The decimal ASCII value of the character used to cancel the current action.
M E N U C O M M A N D S MENU END Function Signals the end of the menu definition. The printer will store the menu defined by the commands between MENU START and MENU END under the identifier specified in MENU START. NOTE: This command does not terminate menu execution. Use MENU EXIT for that. Explicit Form MENU END Implicit Form MU END Parameters None Comments The printer interprets all commands between MENU START and MENU END as part of the menu.
M E N U C O M M A N D S MENU EXIT Function Signals the printer to terminate menu processing. The printer then processes any remaining commands in the label format that called the menu. Explicit Form MENU EXIT Implicit Form MU EXIT Parameters None Comments The printer only interprets MENU EXIT if the command is placed between the MENU START and MENU END commands.
M E N U C O M M A N D S MENU ITEM Function Marks the beginning of a sequence of commands that will execute when the user selects the item from a programmed printer menu, and (optionally) defines text the printer will display when offering the menu to the user. The printer will send this text to the serial port when processing the stored menu, allowing the user to select the item either by item number or by menu scrolling.
M E N U Comments C O M M A N D S MENU ITEM commands are only allowed between MENU START and MENU END commands (that is, only within menus). Up to ten menu items are allowed in each menu. The printer assigns a number to every menu item, with item 1 being the first item in the menu, item 2 the second item, etc. The tenth item is item 0. One or more MENU ACTION commands must follow every MENU ITEM command.
M E N U C O M M A N D S MENU MESSAGE Function This causes text to be output to the serial port. It can be used to provide instructions to the user. Explicit Form MENU MESSAGE "...." Implicit Form MU MESSAGE "....
M E N U C O M M A N D S MENU START Function Signals the beginning of a menu definition and specifies the menu storage location and identifier. NOTE: This command does not execute the menu; the command only prepares the printer to receive the menu for storage. Use Recall Menu to execute stored menus. Explicit Form MENU START x menuname Implicit Form MU START x menuname Parameters x Storage location.
M E N U C O M M A N D S powered on or reset, provided that the printhead is closed. NOTE: To circumvent a programmed __BOOT__ menu, reset or apply power to the printer with the printhead open. The menu name _MENUC_ is reserved for storage of the MENU CONTROL characters. Do not use this name for your own menu. Comments The printer interprets all commands between MENU START and MENU END as part of the menu.
M E N U C O M M A N D S Recall Menu Function Recalls a stored menu from memory and initiates its execution Explicit Form !R M menuname NOTE: This command replaces the normal header line. Do not use any other commands, including the END command, with this command. Also, take care that no extraneous control characters follow the command. The printer may interpret them as menu control characters. Parameters menuname is the alphanumeric identifier under which the menu was originally stored.
Chapter 6 Capturing Data to USB Drive Commands Commands discussed in this section allow you to capture information from the printer, or to capture the input data the printer receives to a USB drive for viewing on a PC. This can be useful when troubleshooting issues. Only one file on the USB drive can be open at once. Files are placed in a TRACE subdirectory on the USB drive. A single file can be opened to capture both messages and data information. If both traces are opened, be sure to close both.
P R I N T E R S E T U P Open Output Message Trace Function This command is used to open a file and a USB stick for saving output messages. Explicit Form !SET MESSAGETRACEOPEN file Parameters file Comments This command does not require a header line, but must be followed by a line feed (or carriage return and line feed). Do not use any other commands with !SET MESSAGETRACEOPEN. Example The following will open the file msg1.txt on a USB stick to capture output messages.
P R I N T E R S E T U P Close Output Message Trace Function This command is used to stop capturing output messages to a file on a USB stick. Explicit Form !SET MESSAGETRACECLOSE Comments This command does not require a header line, but must be followed by a line feed (or carriage return and line feed). Do not use any other commands with !SET MESSAGETRACECLOSE. Example The following will stop capturing output messages to a file on a USB stick.
P R I N T E R S E T U P Open Input Capture Trace Function This command is used to open a file and a USB stick for saving the input stream. Explicit Form !SET DATATRACEOPEN file Parameters file Comments This command does not require a header line, but must be followed by a line feed (or carriage return and line feed). Do not use any other commands with !SET DATATRACEOPEN. Example The following will open the file msg1.txt on a USB stick to capture output messages.
P R I N T E R S E T U P Close Input Capture Trace Function This command is used to stop capturing the input stream to a file on a USB stick. Explicit Form !SET DATATRACECLOSE Comments This command does not require a header line, but must be followed by a line feed (or carriage return and line feed). Do not use any other commands with !SET MESSAGETRACECLOSE. Example The following will stop capturing the input stream to a file on a USB stick.
P R I N T E R S E T U P Add String to Trace File Function This command is used to add a string to an open trace file. Explicit Form !SET TRACEMARK mark Parameters mark Comments This command does not require a header line, but must be followed by a line feed (or carriage return and line feed). Do not use any other commands with !SET TRACEMARK. Example The following will add the line ‘Format_Sent’ to the trace file that is already open.
P R I N T E R S E T U P Write Trace Data to File Function This command is used to write all the data that has been captured to the USB stick. Explicit Form !SET TRACEFLUSH Comments This command does not require a header line, but must be followed by a line feed (or carriage return and line feed). Do not use any other commands with !SET TRACEFLUSH Example The following will write the trace data that has been captured to the USB stick.
Chapter 7 Printer Setup (VARIABLE) Commands VARIABLE commands let you change some of the printer's characteristics. These changes stay in effect until the printer is turned off or until they are changed by another VARIABLE command. NOTE: Do not confuse VARIABLE commands that control the printer with variable values which are used to represent data.
P R I N T E R S E T U P NOTE: All VARIABLE commands, and especially the VARIABLE WRITE command, should be used with care since they can change the data in the printer's nonvolatile RAM. You will probably need to use a few VARIABLE commands as a matter of routine, to set the printer up for various types of print media or print methods. We have prepared some sample label formats to cover these common requirements. Variable Command List The printer VARIABLE commands are listed below.
P R I N T E R S E T U P VARIABLE ALLOCATE Function Reserves space in the image buffer for stored objects. Explicit Form VARIABLE ALLOCATE nnn. Implicit Form V ALLOCATE nnn. Parameters nnn Comments This command is not supported in DLX or CSeries printers. Amount of memory reserved for stored objects, in whole kilobytes. The allowable range is 0 to 128. Flash RAM normally holds all stored objects (graphics and stored formats).
P R I N T E R S E T U P VARIABLE AUDIO_FREQ Function Sets the frequency of the beeper. Explicit Form VARIABLE AUDIO_FREQ hertz Implicit Form V AUDIO_FREQ hertz Parameters hertz Comments This command is not supported in DLX or CSeries printers. Valid values 0-20000. When using this command, send it to the printer with VARIABLE WRITE in a non-printing label format. Do not use this command in stored label formats.
P R I N T E R S E T U P VARIABLE AUTOCUT Function Enables or disables automatic label cutting in printers so equipped. With automatic label cutting enabled, the printer will cut the label after printing the last dot row. With automatic label cutting disabled, the printer will not cut the label unless there is a HALT command in the label format.
P R I N T E R S E T U P VARIABLE AUTO_TOF Function Enables or disables automatic registration of media TOF upon power-cycle or a head-up event. With automatic label TOF enabled, the printer will advance the media stock to the next label TOF upon power cycle and head-closing. With automatic label TOF disabled, the printer will not reposition the media during these events.
P R I N T E R S E T U P VARIABLE AUX_POWER Function Controls the 5 volt power applied to pin 9 of the serial port connector. This voltage can supply up to 400 milliamps at 5 volts to equipment attached to the serial port connector such as a scanner or keyboard. Explicit Form VARIABLE AUX_POWER status Implicit Form V AUX_POWER status Parameters status Comments When using this command, send it to the printer with VARIABLE WRITE in a non-printing label format.
P R I N T E R S E T U P VARIABLE BACKLIGHT Function Enables or disables the LCD backlight to come on when a button is pressed or the display text changes. If enabled, the backlight stays on for 3 seconds. Explicit Form VARIABLE BACKLIGHT on/off/? Implicit Form V BACKLIGHT on/off/? Parameters status Comments When using this command, send it to the printer with VARIABLE WRITE in a non-printing label format. Do not use this command in stored label formats.
P R I N T E R S E T U P VARIABLE BEEPER Function Sets the volume and duration of the beeper. Explicit Form VARIABLE BEEPER status [volume] [duration] Implicit Form V BEEPER status [volume] [duration] Parameters status ON enables the beeper; OFF disables the beeper; ? causes the printer to return the current setting status. volume Optional – valid values 0-4. Sets the volume of the beep. duration Optional – valid values 0-255.
P R I N T E R S E T U P VARIABLE BUFFER_TIMED_RESET Function Enables or disables the memory reset timer. Explicit Form VARIABLE BUFFER_TIMED_RESET duration Parameters duration Timer duration in 0.1 second intervals. The minimum value is 2 (0.2 seconds), maximum is 59990 (about 1 hour and 40 minutes). The default value varies by printer type: Code Courier – The default value is 5 (0.5 seconds). You can also specify the value as ON or OFF.
P R I N T E R S E T U P VARIABLE CODE_PAGE Function Selects the code page to be used when printing text that supports international languages. Explicit Form VARIABLE CODE_PAGE mode Parameters mode 0 – Code Page 858. 1 – Unicode UTF-8 encoding.
P R I N T E R S E T U P 31 – Code Page 1250 32 – Code Page 1251 33 – Code Page 1253 34 – Code Page 1254 35 – Not Available (Reserved for Code Page 1255) ? – Returns the current setting status. Comments CognitiveTPG reserves the use of the code page numbers 0 – 64 for code pages supplied by CognitiveTPG. Actual modes available are dependent on what objects are currently stored in the printer. The default mode is 0, which is always available.
P R I N T E R S E T U P VARIABLE COMM IMPORTANT! Do not experiment with this command! Improper use can cause a loss of serial communication with the printer. Function Sets new serial port parameters. Explicit Form VARIABLE COMM speed,parity,length,stop, R Implicit Form V COMM speed,parity,length,stop, R NOTE: Notice that commas are used as delimiters between parameters, and there are no spaces. If you are uncertain of the printer's current serial port parameters, try 9600,N,8,2.
P R I N T E R S E T U P NOTE: Not all personal computers support all baud rates. Make certain that your host system will support your VARIABLE COMM parameters. Setting the printer for a baud rate that your host will not support will cause a break in communication that may be difficult to remedy. CognitiveTPG printers will not support all possible parity, word length, and stop bit combinations. The acceptable combinations are: N,8,1 or N,8,2 or O,7,1or O,8,1 or E,7,1 or E,8,1.
P R I N T E R S E T U P Do not send any other data to the printer when changing serial port parameters. Do not use this command in stored label formats.
P R I N T E R S E T U P VARIABLE COMPATIBLE Function Enables Blazer compatibility mode supporting label width using single byte granularity. Normal mode is in 4 byte granularity, which is faster. Explicit Form VARIABLE COMPATIBLE status Implicit Form V COMPATIBLE status Parameters status Comments When using this command, send it to the printer with VARIABLE WRITE in a non-printing label format. Do not use this command in stored label formats.
P R I N T E R S E T U P VARIABLE COMPATIBLE LOCAL_PITCH Function This command changes the effect the PITCH command has on the printer.. Explicit Form VARIABLE COMPATIBLE LOCAL_PITCH status Implicit Form V COMPATIBLE LOCAL_PITCH status Parameters status ON causes the PITCH command to only affect the label it is in OFF causes the PITCH command to affect the label it is in, and subsequent labels.
P R I N T E R S E T U P VARIABLE COMPATIBLE LX_VAR_ERROR Function This command changes what the printer does when an error is found when processing a VARIABLE command. Explicit Form VARIABLE COMPATIBLE LX_VAR_ERROR status Implicit Form V COMPATIBLE LX_VAR_ERROR status Parameters status ON causes the printer to ignore the line if an error is found when processing a VARIABLE command. OFF causes the printer to stop printing the label if an error is found when processing a VARIABLE command.
P R I N T E R S E T U P VARIABLE COMPATIBLE DBF_ROT_LOC_ADJUST Function This command will enables an adjustment when printing double byte fonts rotated 90 or 180 degrees. Explicit Form VARIABLE COMPATIBLE DBF_ROT_LOC_ADJUST status Implicit Form V COMPATIBLE DBF_ROT_LOC_ADJUST status Parameters status ON causes an adjustment to be applied to when plotting double byte fonts rotated 90 or 180 degrees. OFF causes no adjustments to be made when plotting double byte fonts.
P R I N T E R S E T U P VARIABLE COMPATIBLE DISABLE_RG_JUSTIFY Function This function causes the current JUSTIFY setting to be applied to the position of recalled graphics Explicit Form VARIABLE COMPATIBLE DISABLE_RG_JUSTIFY status Implicit Form V COMPATIBLE DISABLE_RG_JUSTIFY status Parameters status ON causes recalled graphics position to be affected by the JUSTIFY setting. OFF causes recalled graphics position to ignore the JUSTIFY setting.
P R I N T E R S E T U P VARIABLE COMPATIBLE POWERUP_PITCH Function This command causes the VARIABLE PITCH command to only change the pitch that is set at power up.
P R I N T E R S E T U P VARIABLE COMPATIBLE USE_LX_PARSER Function This causes the printer to process all commands in the exact manner as AdvantageLX printers had.
P R I N T E R S E T U P VARIABLE COMPATIBLE LX_HEAD_DEFS Function This command allows for print head definitions to be used so print matches that of the AdvantageLX. Explicit Form VARIABLE COMPATIBLE LX_HEAD_DEFS status Implicit Form V COMPATIBLE LX_HEAD_DEFS status Parameters status ON causes the matching AdvantageLX print head definitions to be used. OFF uses C Series and DLX matching definitions.
P R I N T E R S E T U P VARIABLE COMPATIBLE LX_SINGLE_LABEL Function This command allows for printer to process and print a single label at a time. Explicit Form VARIABLE COMPATIBLE LX_SINGLE_LABEL status Implicit Form V COMPATIBLE LX_SINGLE_LABEL status Parameters status ON causes the printer to process and print one label at a time. OFF causes the printer to process and print multiple label simultaneously.
P R I N T E R S E T U P VARIABLE CONTRAST Function Sets the contrast level on the LCD display. Explicit Form VARIABLE CONTRAST level Implicit Form V CONTRAST level Parameters level Comments When using this command, send it to the printer with VARIABLE WRITE in a non-printing label format. Do not use this command in stored label formats. Example The format below will set the LCD display contrast to its highest setting. Value to set the LCD display contrast, valid values are 0 – 8.
P R I N T E R S E T U P VARIABLE CPL_COMMAND_MASK Function Locks out some CPL configurations commands. Explicit Form VARIABLE CPL_COMMAND_MASK mask Implicit Form V CPL_COMMAND_MASK mask Parameters mask mask is the sum or’ing the desired fields. Ignore VARIABLE DARKNESS 0x0001 Ignore VARIABLE SPEED - 0x0002 Ignore PITCH & VARIABLE PITCH - 0x0004 Ignore WIDTH & VARIABLE WIDTH - 0x0008 Ignore VARIABLE MEDIA_ADJUST - 0x0010 ? Comments – Returns current setting.
P R I N T E R S E T U P VARIABLE DARKNESS Function Changes the printhead heat, thereby adjusting the darkness at which labels are printed. Always use the lightest acceptable VARIABLE DARKNESS setting to extend the life of the printhead. Explicit Form VARIABLE DARKNESS n Implicit Form V D n Parameters n Darkness value.
P R I N T E R S E T U P too high. You may need to experiment with VARIABLE DARKNESS for optimum results with some thermal transfer media. Example The format below will adjust the darkness to -25 value. ! 0 0 0 0 VARIABLE DARKNESS -25 VARIABLE WRITE END NOTE: Always print labels at the lightest acceptable setting to extend the life of the printhead.
P R I N T E R S E T U P VARIABLE EPL_COMMAND_MASK Function Locks out some EPL configurations commands, allowing for equivalent CPL configurations to be used without the need to make application changes Explicit Form VARIABLE EPL_COMMAND_MASK mask Implicit Form V EPL_COMMAND_MASK mask Parameters mask mask is the sum or’ing the desired fields.
P R I N T E R S E T U P VARIABLE ERROR_LEVEL Function Selects the level of error messages returned. Explicit Form VARIABLE ERROR_LEVEL level Implicit Form V ERROR_LEVEL level Parameters level INFO - All diagnostic messages ERROR_LEVEL - Only errors preventing operation ? returns current setting. Comments When using this command, send it to the printer with VARIABLE WRITE in a non-printing label format. Do not use this command in stored label formats.
P R I N T E R S E T U P VARIABLE FEED Function Selects paper speed to use when feed switch is depressed. Explicit Form VARIABLE FEED speed Implicit Form V FEED speed Parameters speed Comments When using this command, send it to the printer with VARIABLE WRITE in a non-printing label format. Do not use this command in stored label formats.
P R I N T E R S E T U P VARIABLE FEED_BUTTON Function Selects the operation to be performed when the feed button is depressed. Explicit Form VARIABLE FEED_BUTTON operation Implicit Form V FEED_BUTTON operation Parameters operation Comments When using this command, send it to the printer with VARIABLE WRITE in a non-printing label format. Do not use this command in stored label formats.
P R I N T E R S E T U P VARIABLE FEED_CONFIG Function This command is used to determine what the printer should do when coming online both at power up and after the print head has been closed. The printer is able to feed to the next label, perform an index calibration, measure the label length or take no action. Explicit Form VARIABLE FEED_CONFIG P,D/? Parameters P D Action to be performed at power up ? Returns the current setting status. Action to be performed when the print head is closed.
P R I N T E R Example S E T U P The following command will cause the printer to perform a label measure at power up, and feed to the next label when he print head is closed.
P R I N T E R S E T U P VARIABLE FEED_TYPE Function Selects black bar or gap indexing. Explicit Form VARIABLE FEED_TYPE mode Implicit Form V F mode Parameters mode GAP selects gap indexing BAR selects black bar indexing NOTCH selects notch indexing ? returns the current setting. Comments The FEED_TYPE setting has no effect unless automatic label indexing is enabled.
P R I N T E R S E T U P VARIABLE GAP_SIZE Function Manually sets the length of the gap size for gap media. This command should also be used when there is unprintable area on the label. Explicit Form VARIABLE GAP_SIZE nnn Parameters nnn The length of the gap, in hundredths of an inch. ? – Returns the current setting status. Comments When using this command, the VARIABLE LABEL_LENGTH should be used to set the unprintable are of the label.
P R I N T E R S E T U P VARIABLE HIGHSPEED Function Changes the print speed to its highest available setting. The maximum print speed varies among printer models; consult your printer's User's Guide for more information. Explicit Form VARIABLE HIGHSPEED Implicit Form V HIGHSPEED Parameters None Comments Code Courier automatically adjusts its speed in response to ambient temperature and battery condition. Refer to the Code Courier User's Guide for details.
P R I N T E R VARIABLE INDEX Function Turns indexing on or off.
P R I N T E R S E T U P VARIABLE INDEX SETTING Function Adjusts the index detector for optimum gap detection through a wide range of ribbon and label densities. The command is primarily for use with thermal transfer printers in gap indexing mode. There is no need to use this command when using black bar indexing. The C Series printers use the CALIBRATE parameter, but not any of the other parameters.
P R I N T E R S E T U P The sensitivity of this mode is adjustable with the CALIBRATE mode. CALIBRATE Runs an index calibration, and then replaces the index data currently stored for mode 3 with the new data. The C Series printer uses only this parameter, not any of the other parameters. NOTE: Confirm that the correct print media is loaded before starting the calibration.
P R I N T E R Example 1 S E T U P The following label format will set the automatic indexing mode: ! 0 0 0 0 VARIABLE INDEX SETTING 0 VARIABLE WRITE END Example 2 The following label format will calibrate the index detector: ! 0 0 0 0 VARIABLE INDEX SETTING CALIBRATE END 210 Revision F, January 2012, CognitiveTPG
P R I N T E R S E T U P VARIABLE IRDA Function Turns the IrDa communications on or off. Explicit Form VARIABLE IRDA mode Implicit Form V IRDA mode Parameters mode Comments This command is not supported in DLX or CSeries printers. ON enables IrDa communications. OFF disables IrDa communcations. When using this command, send it to the printer with VARIABLE WRITE in a non-printing label format. Do not use this command in stored label formats.
P R I N T E R S E T U P VARIABLE IRDA COMM Function Selects the IrDa baud rate. Explicit Form VARIABLE IRDA COMM baud Implicit Form V IRDA COMM baud Parameters baud Comments This command is not supported in DLX or CSeries printers. Acceptable values are printer dependent, but are among the following: 600, 1200, 2400, 4800, 9600, 14400, 19200, 38400, 57600 and 115200. Consult your printer User's Guide for details.
P R I N T E R S E T U P VARIABLE IRDA PROTOCOL Function Selects one of the two available IrDa communications protocols: Lite or Denso. Explicit Form VARIABLE IRDA PROTOCOL protocol Implicit Form V IRDA PROTOCOL protocol Parameters protocol Comments This command is not supported in DLX or CSeries printers. Valid options: Lite or Denso. When using this command, send it to the printer with VARIABLE WRITE in a nonprinting label format. Do not use this command in stored label formats.
P R I N T E R S E T U P VARIABLE KBLAYOUT Function Select keyboard layout Explicit Form VARIABLE KBLAYOUT mode Parameters mode 0 – US English 1 – Canadian French 2 – Multilingual Canadian 3 – Legacy Canadian French 4 – German 5 – Italian 6 – Russian 7 – Latin American Spanish 8 – Portuguese 9 – Spanish ? – Returns current setting. Comments This command is used to set the keyboard layout. The default layout is 0. If an invalid layout is entered, 0 is used.
P R I N T E R S E T U P VARIABLE LABEL_LENGTH Function Manually sets the length of the label stock in use. This value is the length from the beginning of one label to the beginning of the next. Explicit Form VARIABLE LABEL_LENGTH nnn Parameters nnn The length of the label, in hundredths of an inch. ? – returns the current setting status. Comments When using this command the VARIABLE GAP_SIZE command should also be used to set the length unprintable part of the label.
P R I N T E R S E T U P VARIABLE LANGUAGE Function Enables the auxiliary language parsing type for the printer. When type is set for the desired language, the printer will recognize and process command data formatting in the specified printer language, in addition to CPL.
P R I N T E R S E T U P VARIABLE LOWSPEED Function Changes the printer speed to its lowest allowable value. Explicit Form VARIABLE LOWSPEED Implicit Form V LOWSPEED Parameters None Comments Code Courier automatically adjusts its speed in response to ambient temperature and battery condition. Refer to the printer's User's Guide for details.
P R I N T E R S E T U P VARIABLE MEASURE_LABEL Function Enables or disables automatic label length measurement when performing an index calibration. Explicit Form VARIABLE MEASURE_LABEL status Implicit Form V MEASURE LABEL status Parameters status ON – Labels will be measured during index calibration. OFF – Labels will not be measured during index calibration. ? – Returns the current setting status.
P R I N T E R S E T U P VARIABLE MEDIA_ADJUST Function Adjusts print contrast on object leading edges for optimum print quality. Adjustment of this parameter is not normally required, but may improve rotated bar code reliability in some circumstances. Printers that support this command employ an advanced "dot history" algorithm, which tracks the activity of each printhead dot from one dot row to the next.
P R I N T E R S E T U P Optimum MEDIA_ADJUST values depend on the currently loaded media (for TT printers, both paper and ribbon). CognitiveTPG suggests the following procedure for experimentally finding the optimum MEDIA_ADJUST value for your media. 1.
P R I N T E R S E T U P leading edge of the wide bars should also darken until they are solid all the way across. 7. Vary the MEDIA_ADJUST value in large increments (about 500) and print the test label until the printed bar code approaches the appearance described in step 6. Change MEDIA_ADJUST in smaller increments as you begin to see improvement in the print results. After achieving satisfactory visual results, you may want to scan the bar codes with a bar code verifier.
P R I N T E R S E T U P VARIABLE MENU_LANGUAGE Function This command sets the language that is used when displaying messages to the LCD on printer models that have an LCD display. Explicit Form VARIABLE MENU_LANGUAGE mode Parameters mode ENGLISH – Sets language to English. This is the default. FRENCH– Sets language to French. SPANISH – Sets language to Spanish. ITALIAN – Sets language to Italian. PORTUGUESE – Sets language to Portuguese. GERMAN – Sets language to German.
P R I N T E R S E T U P VARIABLE MIRROR_LABEL Function Allows for labels to be printed as mirror image, where all white areas are black and black areas are white. Explicit Form VARIABLE MIRROR_LABEL status Parameters status ON – Mirror the printed image. OFF – Normal printed image. ? – Returns the current setting status. Comments When using this command, send it to the printer with VARIABLE WRITE in a non-printing label format. Do not use this command in stored label formats.
P R I N T E R S E T U P VARIABLE MODE Function Selects Blazer Emulation Mode in printers that support variable dot time, or sets the default print pitch in all other printers except the Code Courier and the C Series printers which do not support the command. Explicit Form VARIABLE MODE n scale Implicit Form V MODE n scale Parameters n Mode type. Acceptable values are 0, 1, and 2. In printers that do not support variable dot time, VARIABLE MODE 0 sets the default print pitch to its highest value.
P R I N T E R Comments S E T U P This command is not supported in DLX or CSeries printers. When using this command, send it to the printer with VARIABLE WRITE in a non-printing label format. Do not use this command in stored label formats.
P R I N T E R S E T U P VARIABLE NO_MEDIA Function Specifies how long the printer will run without detecting a label before assuming that it is out of media. This only applies to gap indexing mode. Explicit Form VARIABLE NO_MEDIA nn Implicit Form V NO_MEDIA nn Parameters nn Number of label inches that the printer will try to feed before assuming it is out of media. Allowable values are 0 to 12, with a default of 1. A value of 0 disables this feature. A ? returns the current setting status.
P R I N T E R Example S E T U P The following label format will cause the printer to try and feed for three inches before reporting out of media.
P R I N T E R S E T U P VARIABLE NORMAL Function Changes the printer speed to a speed approximately halfway between the LOWSPEED and HIGHSPEED settings, or in printers with only two allowable speeds, sets the printer to the lowest speed. Your printer's User's Guide lists available print speeds. Explicit Form VARIABLE NORMAL Implicit Form V NORMAL Parameters None Comments Code Courier automatically adjusts its speed in response to ambient temperature and battery condition.
P R I N T E R VARIABLE OFF AFTER Function OBSOLETE PORTABLES ONLY Explicit Form VARIABLE OFF_AFTER time Implicit Form V OFF_AFTER time Revision F, January 2012, CognitiveTPG 229 S E T U P
P R I N T E R S E T U P VARIABLE ON/OFF Function Enables and disables access to certain protected VARIABLE values. Explicit Form VARIABLES status Parameters status Protection status. ON allows access to the protected VARIABLE settings. OFF prohibits access to the protected VARIABLE settings. The default is ON. Comments This command is not supported in DLX or CSeries printers. Do not use this command in stored label formats.
P R I N T E R S E T U P VARIABLE ON_TIME Function OBSOLETE Explicit Form VARIABLE ON_TIME time Implicit Form V ON_TIME time VARIABLE OVERRIDE Function Enables or disables printing at slower speeds when rotated barcodes are detected in the label format. Explicit Form VARIABLE OVERRIDE status Parameters status The speed at which to print labels containing rotated barcodes, in thousandths of an inch. Allowable values are 2000 to 5000, with a default of 2000. ON will enable this feature.
P R I N T E R Function Selects the default print pitch. Explicit Form VARIABLE PITCH n Implicit Form V PITCH n Parameters n S E T U P Default print pitch. Allowable values are as used in the PITCH command. A ? returns the current setting status. Comments When using this command, send it to the printer with VARIABLE WRITE in a non-printing label format. Do not use this command in stored label formats.
P R I N T E R S E T U P VARIABLE POSITION Function Moves the first printed dot row on the label up or down with respect to its last position. Explicit Form VARIABLE POSITION distance Implicit Form V POSITION distance Parameters distance Distance between the original starting location and the new location, in thousandths of an inch. Positive numbers move the first dot row down; negative numbers move the first dot row up. A ? returns the current setting status.
P R I N T E R S E T U P VARIABLE PRESENTLABEL Function Controls the dispensing of labels for application. VARIABLE PRESENTLABEL ensures a second set of labels is not printed before the operator is ready, and enables the user to change the distance fed forward and backward after printing. Explicit Form VARIABLE PRESENTLABEL Action Advance_Distance Retract_Distance Time_Delay VARIABLE PRESENTLABEL Action Implicit Form V PRESENTLABEL Action Parameters Active Valid values are ON and OFF.
P R I N T E R Comments S E T U P When printing, the printer will first retract the media as specified by Retract_Distance. When the label is printed, the printer advances the media as specified by Advance_Distance. When printing a batch of labels, only the first label is retracted and the last label advanced. When using the HALT command, each label is presented using the Advance and Retract values. Exceeding the recommended limitations may damage the printer.
P R I N T E R Example S E T U P The following example sets the Advance_Distance to 1.06 inches, the Retract_Distance to 1.00 inches and the Time_Delay to 10 seconds. All of the parameters must be present for the others to work. If only the Advance_Distance parameter is present, the Retract_Distance is set equal. Advance_Distance and Retract_Distance must be specified to enable the Time_Delay parameter.
P R I N T E R S E T U P VARIABLE PRINT_MODE Function Sets the printer up for direct thermal or thermal transfer printing. The command adjusts print darkness and gap indexing parameters and enables or disables the ribbon-out detector as needed for the selected print method.
P R I N T E R S E T U P VARIABLE PRINT_SPEED Function Sets or queries the current sprint speed. Explicit Form VARIABLE PRINT_SPEED speed Implicit Form V PRINT_SPEED speed Parameters ? LOWSPEED NORMAL HIGHSPEED speed Returns current setting. Use configured low speed Use configured normal speed Use configured high speed 0-65535 set specific speed in thousands of inches per second. Limit by top end of printer. . Comments Only use the specific speed version to set speed for hard to image media.
P R I N T E R S E T U P VARIABLE READ Function Reads the last saved variable values in permanent storage and uses them as the current values. The effect is the same as turning the printer off and then on again. Explicit Form VARIABLE READ Implicit Form V READ Parameters None Comments Do not use this command in stored label formats.
P R I N T E R S E T U P VARIABLE RECALIBRATE Function Turns automatic index calibration on or off. If enabled, automatic index calibration causes the printer to enter a recalibrate sequence when an indexing error is detected. Explicit Form VARIABLE RECALIBRATE mode Implicit Form V RECALIBRATE mode Parameters mode Comments When using this command, send it to the printer with VARIABLE WRITE in a non-printing label format. Do not use this command in stored label formats.
P R I N T E R S E T U P VARIABLE REPORT_LEVEL Function Sets the manner in which the printer reports recoverable errors. Explicit Form VARIABLE REPORT_LEVEL n Implicit Form V REPORT_LEVEL n Parameters n Comments 0 No error reporting. This is the default error level in most printers. 1 Error messages are sent to the serial port. 2 Error messages are sent to the serial port and printed on the label. ? Returns current setting.
P R I N T E R S E T U P VARIABLE REPORT_TYPE Function Configures where error messages are sent. Explicit Form VARIABLE REPORT_TYPE port Implicit Form V REPORT_TYPE port Parameters ? port Returns current setting. NONE – no reports SERIAL – reports to Serial port LABEL-Reports to label Comments When using this command, send it to the printer with VARIABLE WRITE in a non-printing label format. Do not use this command in stored label formats.
P R I N T E R S E T U P VARIABLE REPRINT Function Enables or disables automatic reprinting of partial or error-aborted labels. With reprint enabled, the printer will automatically reprint labels interrupted for paper out, head up, thermal overload, etc. With automatic reprint disabled, the printer will drop these interrupted labels and they will be lost.
P R I N T E R S E T U P VARIABLE RESET Function Returns user-accessible VARIABLE parameters to known values. Affected parameters and their default values vary among printer models. The command writes the known values to nonvolatile RAM. This command is used to restore the printer settings to their default factory values. Explicit Form VARIABLE RESET Implicit Form V RESET Parameters None Comments Do not use this command in stored label formats.
P R I N T E R S E T U P VARIABLE ROTATE_LABEL Function Configures rotation of label 180 degrees to be readable on exit. Explicit Form VARIABLE ROTATE_LABEL status Parameters status ON rotates the printed image 180 degrees. OFF normal printed image. ? returns current setting. Comments When using this command, send it to the printer with VARIABLE WRITE in a non-printing label format. Do not use this command in stored label formats.
P R I N T E R S E T U P VARIABLE SCRIPT_INPUT_RESET Function This command will cause the input source to be reset when the user enters the menu level specified. Explicit Form VARIABLE SCRIPT_INPUT_RESET n Implicit Form V SCRIPT_INPUT_RESET n Parameters n Comments When using this command, send it to the printer with VARIABLE WRITE in a non-printing label format.
P R I N T E R S E T U P VARIABLE SHIFT LEFT Function Shifts the printed image of all labels a specified distance to the left from the normal 0, 0 origin. Explicit Form VARIABLE SHIFT LEFT n Implicit Form V SHIFT LEFT n Parameters n The distance the image is shifted to the left, in hundredths of an inch. ? will return the current setting. Comments When using this command, send it to the printer with VARIABLE WRITE in a non-printing label format.
P R I N T E R S E T U P VARIABLE SLEEP_AFTER Function Sets the amount of time a portable printer will stay awake after completing a print job. Explicit Form VARIABLE SLEEP_AFTER duration Implicit Form V SLEEP_AFTER duration Parameters duration Length of time the printer will stay awake, in seconds. The allowable range is 0 to 255, with a default of one second. Setting duration to 0 will keep the printer awake continuously. ? returns the current setting.
P R I N T E R S E T U P VARIABLE TERMINAL Function Configures port to be used to prompt for input when using stored formats, stored menus or stored variables. Explicit Form VARIABLE TERMINAL port Implicit Form V TERMINAL port Parameters ? port Comments Returns the current setting. RS232, LCD_PANEL, USB, RTEL, DISCOVER. This is meant to be used as a setup command and not during script execution.
P R I N T E R S E T U P VARIABLE TIME Function Queries and sets real time clock module. Explicit Form VARIABLE TIME cmd Implicit Form V TIME cmd Parameters ? SET GET Add Comments 250 Returns current setting. Set clock to current value Gets current clock value Adds passed values to current time when printed. See Real Time clock section for additional information on using these commands.
P R I N T E R S E T U P VARIABLE TOF Function Moves the first printed dot row to the absolute offset specified with respect to the index position. This value replaces any previous TOF setting value for the current indexing mode. Explicit Form VARIABLE TOF offset Implicit Form V TOF offset Parameters offset Distance from the index position to the TOF position, in thousandths of an inch. ? returns the current setting.
P R I N T E R S E T U P VARIABLE TXTBFR Function Sets the size of the text buffer and the text overflow buffer. Explicit Form VARIABLE TXTBFR txt ovf Implicit Form V TXTBFR txt ovf Parameters txt Size of the text buffer, in bytes. The allowable range is 4096 to 65535, with a default of 4096. ? returns the current setting. ovf Optional; specifies the size of the overflow buffer, in bytes. The allowable range is 0 to (txt - 1024).
P R I N T E R S E T U P Solus will print an error label if the text buffer overflows. Increasing the text buffer size will decrease the size of the image buffer. Total memory size = text buffer + image buffer NOTE: Changing the text or overflow buffer sizes will delete any objects stored in the image buffer.
P R I N T E R S E T U P VARIABLE USER_FEEDBACK Function Enables or disables the transmission of certain status messages to the host computer. With this feature enabled, the printer regularly sends some status messages via the serial port. The printer will not send messages if the host computer is busy, (as indicated by the condition of its serial port CTS line.
P R I N T E R S E T U P VARIABLE USB_TXTBFR Function Sets the size of the USB Buffer Explicit Form VARIABLE USB_TXTBFR txt ovf Implicit Form V USB_TXTBFR txt ovf Parameters txt Size of the text buffer, in bytes. The allowable range is 4096 to 65535, with a default of 4096. ? returns the current setting. ovf Optional; specifies the size of the overflow buffer, in bytes. The allowable range is 0 to (txt - 1024).
P R I N T E R S E T U P Total memory size = text buffer + image buffer.
P R I N T E R S E T U P VARIABLE WIDTH Function Sets the default print width. Explicit Form VARIABLE WIDTH n Implicit Form V WIDTH n Parameters n Print width, in hundredths of an inch. ? returns the current setting. Comments Use this command with VARIABLE WRITE in a nonprinting label format. Do not use this command in stored label formats. This command is functionally identical to the WIDTH command, except that it can set the new print width in nonvolatile RAM.
P R I N T E R S E T U P VARIABLE WRITE Function Writes the current variable values to nonvolatile storage. Values in effect when VARIABLE WRITE is executed are retained in memory while the printer power is off. Explicit Form VARIABLE WRITE Implicit Form V WRITE Parameters None Comments You do not need to use this command every time you want to permanently change a VARIABLE value.
P R I N T E R Example S E T U P The example below shows how to set a VARIABLE value in one label format with VARIABLE WRITE. But you must remember that this label format is also writing all other current VARIABLE values to nonvolatile RAM at the same time.
P R I N T E R S E T U P VARIABLE ZPL_COMMAND_MASK Function Locks out some ZPL configuration commands, allowing for equivalent CPL configurations to be used without the need to make application changes. Explicit Form VARIABLE ZPL_COMMAND_MASK mask Implicit Form V ZPL_COMMAND_MASK mask Parameters mask mask is sum or’ing of desired fields.
Chapter 8 Using VARIABLE Commands Printer configuration must be handled through VARIABLE commands. The sample label formats in this section are provided for your convenience, to help you set the printer up for some common configurations. To use these label formats, copy the format to Windows Notepad or a similar ASCII text editor, edit the label format as required, and then print the label format.
U S I N G V A R I A B L E C O M M A N D S Blazer Compatibility As shipped, Barcode Blaster, Solus, Blaster Advantage, Advantage LX, Advantage DLX, and C-Series printers are not compatible with older Barcode Blazers, or with enhanced Blazers operating in nonlinear dot time mode. High speed Blasters can closely emulate Barcode Blazers. Solus, Advantage, and C-Series printers are more limited in their Blazer emulation.
U S I N G V A R I A B L E C O M M A N D S The following label format disables Blazer emulation mode and returns the printer to normal operation: ! 0 0 0 0 VARIABLE MODE 0 VARIABLE WRITE END There are many aspects to printer compatibility. You may want to request a copy of Technical Bulletin 10-00-0131, which covers Blazer/Blaster compatibility in detail. Contact our Technical Support Organization for more information.
U S I N G V A R I A B L E C O M M A N D S Setting Bar or Gap Index Type All currently manufactured CognitiveTPG printers support black bar and gap indexing, and are shipped from the factory set for gap indexing. The VARIABLE FEED_TYPE command controls the index method. Use one of the following label formats to change the index type.
U S I N G V A R I A B L E C O M M A N D S VARIABLE WRITE END Thermal Transfer Printing with Standard Wax Ribbon The following label format will set the index detector for thermal transfer printing using CognitiveTPG's standard wax ribbon: ! 0 0 0 0 VARIABLE INDEX SETTING 2 VARIABLE WRITE END Thermal Transfer Printing with Resin Ribbon The following label format will set the index detector for thermal transfer printing with typical resin-based ribbon installed: ! 0 0 0 0 VARIABLE INDEX SETTING 3 VARIABL
U S I N G V A R I A B L E C O M M A N D S Calibrate the Index The following label format runs an index detector calibration routine, and then stores the new index detector sensitivity setting in nonvolatile RAM under index sensitivity 3. After calibration, the routine will set the printer in index mode 3: ! 0 0 0 0 VARIABLE INDEX SETTING CALIBRATE END NOTE: You do not need to use VARIABLE WRITE when using the CALIBRATE mode. CALIBRATE automatically writes its data to nonvolatile RAM.
Chapter 9 Ethernet Printer Information Ethernet printers are full-featured bar code label and tag printers designed to interface directly with the Ethernet network. The printer works with any TCP/IP system. Additionally, it has a Centronics parallel interface for connection to a standalone computer or terminal. Many models also have a serial port or USB port. Note: A special cable is necessary for the C Series parallel and serial ports.
E T H E R N E T P R I N T E R I N F O R M A T I O N Network Protocols The printer will work with any system having TCP/IP support. It will not work with Netware IPX, Microsoft NetBEUI protocol, Appletalk, LAN Manager, or Microsoft Windows Network. Network Applications CognitiveTPG Ethernet equipped printers utilize TCP/IP for their communications protocol.
E T H E R N E T P R I N T E R I N F O R M A T I O N TELNET A Telnet daemon is implemented on top of TCP, and can be used to monitor the printer. The printer will not accept print jobs using the Telnet port. Note: This protocol is unavailable on the C-Series printers. Use TCP port 23 for Telnet connection to the printer. The port supports the following commands: BOOTP Bootp (Boot protocol) is provided to enable dynamic IP address assignment. Bootp requests are broadcast via UDP port 67.
E T H E R N E T P R I N T E R I N F O R M A T I O N DHCP Dynamic Host Configuration Protocol (DHCP) provides a more flexible dynamic IP address assignment than BOOTP. DHCP requests are broadcast via UDP port 67, and responses listened for on UDP port 68. When DHCP is enabled it will cause a slight delay at turn-on (configurable via the “VARIABLES ETHERNET DHCP_OFFERS” command) as the printer gets offers of IP addresses and decides which to use.
E T H E R N E T P R I N T E R I N F O R M A T I O N Manual Configuration To send configuration data to the printer manually: Connect the printer to a PC or terminal via a USB cable, or use the optional cables to connect to a RS-232 or Centronics parallel port. Send a configuration file containing the appropriate VARIABLE commands to the printer. You may disconnect the USB, serial, or parallel port and connect the printer to your network after sending the configuration data to the printer.
E T H E R N E T P R I N T E R I N F O R M A T I O N Set Host Name Function This command is used to set the printer’s host name string, which can be used to indentify the printer. Explicit Form !SET HOST_NAME name Parameters name Comments The name specified must conform to Ethernet host name specifications (see RFC952 assumptions section). Name host name to use to identify printer. This command does not require a header line, but must be followed by a line feed (or carriage return and line feed).
E T H E R N E T P R I N T E R I N F O R M A T I O N Show Host Name Function This command is used to query the printer’s host name. Explicit Form !SHOW HOST_NAME Comments This command does not require a header line, but must be followed by a line feed (or carriage return and line feed). Do not use any other commands with !SHOW HOST_NAME. Example The following will return the printer’s host name to the current communication port.
E T H E R N E T P R I N T E R I N F O R M A T I O N Operation Printer operation and use is as described in the user's guide, except for the Ethernet Link Indicator described on page 268 and the printer self test. Self Test To print a printer selftest label, press and hold in the FEED button while turning the printer on.
E T H E R N E T P R I N T E R I N F O R M A T I O N Variable Commands for Ethernet Several VARIABLE commands support configuration of the Ethernet printer. Most of these commands execute simple on-off functions, and accept ON or OFF as their associated parameters. Follow these rules when using the VARIABLE commands: Do not use these commands in label formats that print labels. Enter all commands as shown. You may abbreviate VARIABLE as V, but do not use any other abbreviations.
E T H E R N E T P R I N T E R I N F O R M A T I O N VARIABLE ETHERNET BOOTP Function Starts up the printer by reading configuration information from the server. Explicit Form VARIABLE ETHERNET BOOTP status Implicit Form V ETHERNET BOOTP status Parameters status = Bootp enabled or disabled; ON or OFF. The default is ON. Comments This command is not supported in DLX or CSeries printers.
E T H E R N E T P R I N T E R I N F O R M A T I O N VARIABLE ETHERNET DHCP_CRIT Function Specifies the criteria by which the printer chooses among multiple DHCP IP address assignment offers. Explicit Form VARIABLE ETHERNET DHCP_CRIT d Implicit Form V ETHERNET DHCP_CRIT d Parameters d The number indicating the criteria: 0=FIRST First DHCP offer received by the printer. 1=LONGEST Longest Lease Time DHCP offer received by the printer.
E T H E R N E T P R I N T E R I N F O R M A T I O N VARIABLE ETHERNET DHCP_OFFERS Function Specifies the number of seconds that the printer will wait for DHCP offers before failing the DHCP process if no acceptable offers were received or picking amongst the acceptable ones. Explicit Form VARIABLE ETHERNET DHCP_OFFERS seconds Implicit Form V ETHERNET DHCP_OFFERS seconds Parameters seconds= the number of seconds for the printer to wait before deciding which DHCP offer to accept. The default is 5.
E T H E R N E T P R I N T E R I N F O R M A T I O N VARIABLE ETHERNET FIRMWARE Function Compares the part number, firmware revision, and build with the currently loaded firmware and if the specified firmware is newer the printer contacts the indicated TFTP server (server) and requests the file (fname) be sent to the printer using the TFTP protocol.
E T H E R N E T P R I N T E R I N F O R M A T I O N VARIABLE ETHERNET GATEWAY Function Sets the gateway. Explicit Form VARIABLE ETHERNET GATEWAY ddd.ddd.ddd.ddd Implicit Form V ETHERNET GATEWAY ddd.ddd.ddd.ddd Parameters ddd.ddd.ddd.ddd is the IP address of the subnet’s router. Example VARIABLE ETHERNET GATEWAY 10.0.0.1 VARIABLE ETHERNET IP ADDRESS Function Sets the static Ethernet IP address. This is used if DHCP is not in use. Explicit Form VARIABLE ETHERNET IP ddd.ddd.ddd.
E T H E R N E T P R I N T E R I N F O R M A T I O N VARIABLE ETHERNET JOBSOKINERROR Function Determines whether the printer accepts LPD print jobs if the printer is in an error condition. Explicit Form VARIABLE ETHERNET JOBSOKINERROR On/Off Implicit Form V ETHERNET JOBSOKINERROR On/Off Parameters status= JOBSOKINERROR enabled or disabled; ON or OFF. The default is OFF. ? returns the current setting. Example VARIABLE ETHERNET JOBSOKINERROR OFF VARIABLE ETHERNET LPD Function Turns LPD on or off.
E T H E R N E T P R I N T E R I N F O R M A T I O N VARIABLE ETHERNET NETMASK Function Sets Ethernet Subnet Mask. Explicit Form VARIABLE ETHERNET NETMASK ddd.ddd.ddd.ddd Implicit Form V ETHERNET NETMASK ddd.ddd.ddd.ddd Parameters ddd.ddd.ddd.ddd is the Subnet Mask of the local network where the printer is connected. ? returns current setting. Example VARIABLE ETHERNET NETMASK 255.255.255.0 VARIABLE ETHERNET RESET Function Resets the printer.
E T H E R N E T P R I N T E R I N F O R M A T I O N VARIABLE ETHERNET RESET COMMUNITY Function Resets the SNMP COMMUNITY name. Explicit Form VARIABLE ETHERNET RESET COMMUNITY Implicit Form V ETHERNET RESET COMMUNITY Parameters None Example VARIABLE ETHERNET RESET COMMUNITY NOTE: The reset SNMP community name will be “public”. VARIABLE ETHERNET RTEL Function Enables or disables reverse telnet communication (RTEL) with the printer.
E T H E R N E T P R I N T E R I N F O R M A T I O N VARIABLE ETHERNET RTEL PORT Function Sets the reverse telnet (RTEL) port address. Explicit Form VARIABLE ETHERNET RTEL PORT ddddd Implicit Form V ETHERNET RTEL PORT ddddd Parameters ddddd = Reverse telnet port address. The default is 9100. ? returns current setting.
E T H E R N E T P R I N T E R I N F O R M A T I O N VARIABLE ETHERNET TELNET Function Enables or disables telnet communication with the printer. Explicit Form VARIABLE ETHERNET TELNET status Implicit Form V ETHERNET TELNET status Parameters status = TELNET enabled or disabled; ON or OFF. The default is OFF. ? returns current setting.
E T H E R N E T P R I N T E R I N F O R M A T I O N VARIABLE ETHERNET TEXT BUFFER Function Sets the size of the Ethernet buffer. Explicit Form VARIABLE ETHERNET TXTBFR bfr_size Implicit Form V ETHERNET TXTBFR bfr_size Parameters bfr size= Total size of the memory buffer used for Ethernet communications. ? returns the current setting.
Chapter 10 Bar Code Information All rules of bar code symbologies must be followed when creating bar code commands. Some of the rules for the most commonly used bar code symbologies are listed below. For more information on bar codes as supported in CognitiveTPG printers, refer to the BARCODE command description and Table 4, Printer bar code support.
B A R C O D E I N F O R M A T I O N I2OF5 AND D2OF5 I2OF5 (Interleaved 2 of 5) is an interleaved code, used mainly in the distribution industry. It supports numbers 0-9 only. It can use a checksum digit, but the user must calculate and enter the checksum manually as part of the code. I2OF5 uses start and stop characters, which the printer generates automatically. Because of the interleaved pattern, an even number of digits (including the checksum, if used) must be placed in the bar code string.
B A R C O D E I N F O R M A T I O N The characters represented by Code 39 are represented in Code 93 as single bar code characters, but all other Code 93 characters are represented by a control character plus another character. You must take this into account when estimating bar code length. EAN, EAN8, and EAN13 EAN (European Article Numbering) codes are an extension of the UPC system. A bar code scanner set to read EAN can read UPC; however, a scanner set for UPC may not read EAN.
B A R C O D E I N F O R M A T I O N Since you may use any of the four start/stop characters on either end of the symbol, there are 16 possible combinations. These combinations can identify the product type or other information. PLESSEY AND MSI1 PLESSEY code supports numerals 0-9, plus six additional characters (typically A-F). PLESSEY uses a check digit, but the check digit may be calculated several different ways.
B A R C O D E I N F O R M A T I O N by the allowable pattern of bars and spaces in each codeword. The printer converts the raw data to a series of numeric values following rules that provide optimum data compression. PDF417 provides several different rule sets, or modes, for optimum data compression. PDF417 provides error detection and correction within the bar code block. The thoroughness of the automatic error checking is called the security level of the code.
B A R C O D E I N F O R M A T I O N Postnet uses a start and stop bar and a modulo 10 check digit. CognitiveTPG printers automatically calculate and add this digit to the code. CODE128 A, B, C CODE128 uses 106 unique characters in three character sets to represent the numerals 0 through 9, the English alphabet in both upper and lowercase, some punctuation, and some special characters.
B A R C O D E I N F O R M A T I O N If you want a caret to actually appear on the label, place a caret before every caret you want printed. For example, ^^ prints one caret, and ^^^^ prints two carets. When the version of CODE128 is selected in the printer command file, the printer takes care of inserting the correct start character and stop character for the version of CODE128 selected. Only visible characters are centered and printed under the bar code.
B A R C O D E I N F O R M A T I O N CODE16K CODE16K is a multi-row symbology based on CODE128. It offers the features of CODE128 with the added density of a two-dimensional bar code. Each CODE16K symbol consists of from two to sixteen rows. Each row consists of a leading quiet zone, a start character, a guard bar, five symbol characters, a stop character, and a trailing quiet zone.
Chapter 11 Media Tips and Tricks Labels are available in a large variety of types and sizes. Some label characteristics must be taken into account when programming the printer. Media characteristics that can affect printer programming and printer performance are: Label/tag size and shape Relates to the WIDTH, VARIABLE WIDTH and VARIABLE SHIFT LEFT commands. Adhesive type Can affect printer peelback performance. Print method Relates to the VARIABLE PRINT_MODE command.
M E D I A T I P S A N D T R I C K S Adhesives Labels can come without adhesive (e.g.
M E D I A T I P S A N D T R I C K S Cut Type (Butt Cut, Gap Cut, or Continuous Form) Butt cut labels are separated from each other by a simple cut, leaving square edges. Gap cut labels are separated by a gap. Labels may be made in many shapes for special purposes such as the "butterfly" shape used for jewelry and eyeglass labels. Continuous form media has no perforation, gap, or bar and is typically used with cutter-equipped printers like the Blaster CL.
M E D I A T I P S A N D T R I C K S Media Sensitivity Different media types exhibit different heat sensitivity. The VARIABLE_DARKNESS command controls the amount of printhead heat. Different media types can also exhibit different response times. The media is in motion while the printhead dots are heating and cooling, so areas of the label that theoretically should stay white are subjected to temperatures close to their darkening temperature.
Chapter 12 Troubleshooting Most programming problems quickly resolve themselves with careful examination of the offending label format or program code. When you cannot solve a problem by simply reviewing your work, your best approach is to start troubleshooting using the information in your User’s Guide. NOTE: Some programming problems can masquerade as hardware problems.
T R O U B L E S H O O T I N G CCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCC ! 0 100 200 1 STRING 8X8 20 20 HELLO STRING 9X12 30 40 HELLO STRING 12X16 40 60 HELLO STRING 18X23 50 90 HELLO END • If the printer will not print this label but does print labels that were prepared on another system, your system may not be compatible with the printer. The most common cause of this is improper end-of-line termination. NOTE: Hex dump mode allows you to see every character that reaches the printer.
T R O U B L E S H O O T I N G Capture messages and data to USB storage device. • Only one file can be open at once. A single file can be opened for both messages and data. If open for both, be sure to close for both. Close files before removing USB storage device or data may be lost. Opening will erase any existing file with the same name. Files are placed in a TRACE subdirectory. The printer will beep on completion of close command to indicate it is safe to withdraw USB storage device. 1.
T R O U B L E S H O O T I N G Common Issues This section describes printing issues that you may encounter and suggestions for resolving them. Printer does not respond to incoming data. Cause: The label format does not terminate with a proper END command. • Cure: Terminate all label formats with an END command, unless specifically instructed otherwise by a particular command description. Terminate every format line with a carriage return and line feed. Cause: The host system is not sending pure ASCII data.
T R O U B L E S H O O T I N G Printer prints the label format text rather than the intended label. Cause: You are sending the label format to the printer from Microsoft Windows, and the current printer driver is converting the label format to ASCII commands. For example, you are using the CognitiveTPG Windows driver or a similar printer driver. • Cure: Use the "generic ASCII" driver when sending label formats to the printer from Windows.
T R O U B L E S H O O T I N G • Cure: Refer to the User’s Guide. Printer prints labels, but print quality is poor. Cause: Possible hardware problem. • Cure: Refer to the printer User’s Guide. Cause: Incorrect print media, for example, using direct thermal paper while printing in thermal transfer mode. • Cure: Load the correct print media for your printer and application. Confirm that the software is setting the printer for the correct print method.
T R O U B L E S H O O T I N G Print is stretched or shrunk vertically. Cause: Dot time in header line is incorrect. Cause: Label format was written for a different (typically, an earlier or later model) printer. • Cure: Try another value for dot time. If designing a turnkey software package, provide for user adjustment of dot time. Allow for printer limitations in this regard. For example, Barcode Blaster LS and Blaster Advantage printers only support dot time 100.
T R O U B L E S H O O T I N G • Cure: None. This is a normal condition. Use gap stock if this behavior is unacceptable. NOTE: The Del Sol’s lower index sensor must be in the center position for Gap indexing. Printer skips labels during printing. Cause: Max Y value in Header line is too large. • Cure: Recalculate Max Y value using formula (dot pitch) x (label height) + Max Y. If skipping still occurs, reduce Max Y. Cause: Dot time in header line is too large. • Cure: Reduce dot time.
T R O U B L E S H O O T I N G format, troubleshoot as usual. Reassemble the whole file and try it again after the bad format is working. Printer will not print at high speed. Cause: The printer has received a VARIABLE LOWSPEED or VARIABLE NORMAL command. • Cure: Send the printer a VARIABLE HIGHSPEED command.
T R O U B L E S H O O T I N G Numeric values do not increment properly in response to the ADJUST command. Cause: The numeric value you wish to adjust has more digits than the parameter specified in the ADJUST command. • Cure: Pad the ADJUST parameter with leading zeros as required. Cause: You are trying to adjust a numeric value to a number with more digits than the original value. • Cure: Pad the original value with leading zeros as required. Cause: You are using a MULTIPLE command with ADJUST.
T R O U B L E S H O O T I N G • Cure: Each JUSTIFY command in a format will remain in effect for the rest of the format or up to the next JUSTIFY. Insert new JUSTIFY commands where required. STRING or TEXT fonts do not work. Cause: The memory area containing the STRING or TEXT fonts has been unintentionally initialized, erasing the fonts. See the INITIALIZE STORAGE command for more information. • Cure: You will have to reload the fonts into nonvolatile RAM. Contact the factory for assistance.
T R O U B L E S H O O T I N G • Cure: Check the label format syntax, especially that of the first ignored command. Cause: The label format was written for a different printer model or firmware revision, and the ignored commands are not supported by your printer. • Cure: Rewrite the label format as required.
T R O U B L E S H O O T I N G Graphics Programming Issues Graphics programming is inherently more complex than ASCII programming, but is subject to the same problems. Resolve any ASCII programming problems before spending too much time troubleshooting graphics files. If you can successfully print ASCII format files, try printing a proven graphics label format file. If a proven graphics file will not print, suspect a printer/host communications problem.
T R O U B L E S H O O T I N G Printer prints a random pattern instead of the expected bitmap. Cause: The printer is set for a different pitch or width than the graphics file was designed for. • Cure: Before sending graphics to the printer, send a dummy label format consisting of a header line, WIDTH command, PITCH command, and END statement. This assures that the printer is set properly before sending the graphics data. Cause: The graphics file is too large for the available memory space.
T R O U B L E S H O O T I N G Graphics labels print, but are reversed. Cause: Bitmap was mapped backwards. Recently-manufactured printers map the printhead from right to left. Some older printers map the printhead from left to right. Graphics files designed for older printers may print backwards when sent to a newer printer. • Cure: When manually designing graphics files, calculate the data based on a mirror image of the original design.
T R O U B L E S H O O T I N G Index A ADJUST · 22 ADJUST_DUP · 24 AREA_CLEAR · 25 B BARCODE · 26 BARCODE PDF417 · 42 BARCODE AZTEC · 31 BARCODE DATAMATRIX · 33 Barcode GS1 Databar · 39 BARCODE QR · 47 BARCODE RSS · 49 BARCODE UPS · 49 BARCODE_FONT · 36 BEEP · 54 C Capture messages and data to USB storage device · 310 Capturing Data to USB Drive Commands · 166 Add String to Trace File · 171 Close Input Capture Trace · 170 Close Output Message Trace · 168 Open Input Capture Trace · 169 Open Output Message
T R O U B L E S H O O T I N G PITCH · 85 PRINT TEST LABEL · 87 G Get Object Data · 126 GRAPHIC · 67 GRAPHIC RECALL · 143 GRAPHIC STORE · 144 Graphics mode · 69 Q QUANTITY · 88 QUERY FIRMWARE REVISION · 89 Query Index Buffer Values · 90 Query Index Settings · 91 QUERY PRINTER STATUS · 92 H HALT · 72 Header line · 73 R Recall Menu · 148, 164 Recall Variable · 149 ROTATE R90, R180, R270 · 97 I INDEX · 77 Initialize Storage · 146 S J Set Host Name · 281 Show Host Name · 282 Show Inches Printed · 99 Show
T R O U B L E S H O O T I N G VARIABLE BUFFER_TIMED_RESET · 183 VARIABLE CODE_PAGE · 184 VARIABLE COMM · 186 VARIABLE COMPATIBLE · 189, 190, 191, 192, 193, 194, 195, 196, 197 VARIABLE CONTRAST · 198 VARIABLE DARKNESS · 200 VARIABLE EPL_COMMAND_MASK · 199, 202 VARIABLE ERROR_LEVEL · 204 VARIABLE FEED · 205 VARIABLE FEED_BUTTON · 206 VARIABLE FEED_CONFIG · 207 VARIABLE FEED_TYPE · 209 VARIABLE GAP_SIZE · 210 VARIABLE HIGHSPEED · 211 VARIABLE INDEX · 213 VARIABLE INDEX SETTING · 214 VARIABLE IRDA · 217 VARIAB