Datamax All In One Printer E4203 Users Manual 88 2265 01_D
E4203 to the manual 87ecfa84-d304-4fff-8b54-73b41a03428b
2015-02-02
: Datamax Datamax-All-In-One-Printer-E4203-Users-Manual-396417 datamax-all-in-one-printer-e4203-users-manual-396417 datamax pdf
Open the PDF directly: View PDF 
.
Page Count: 176
| Download | |
| Open PDF In Browser | View PDF |
Programmer’s Manual Corporate Headquarters 4501 Parkway Commerce Blvd. Orlando, Fl 32808 Phone: 407-578-8007 Fax: 407-578-8377 Asia-Pacific 19 Loyang Way #01-01 CILC Building Singapore 508724 Phone: +65 542-2611 Fax: +65 542-3611 Datamax International Herbert House 12 Elizabeth Way, Pinnacles Harlow, Essex CM19 5FE UK Phone: +44 1279 772200 Fax: +44 1279 424448 CG Times, based upon Times New Roman under license from the Monotype Corporation CG Triumvirate is a trademark of the AGFA Corporation Macintosh is a trademark of the Apple Corporation. PCL-4 and HP Laser JetII are trademarks of the Hewlett Packard Corporation Windows is a trademark of the Microsoft Corporation Information in this manual is subject to change without notice and does not represent a commitment on the part of Datamax Corporation. No part of this manual may be reproduced or transmitted in any form or by any means, for any purpose other than the purchaser’s personal use, without the expressed written permission of Datamax Corporation. © 2001 by Datamax Corporation Part Number: 88-2265-01 Revision: D Table of Contents Preface....................................................................................................... 1 Who Should Use This Manual .......................................................................................1 Scope of This Manual....................................................................................................1 General Conventions.....................................................................................................2 Computer Entry and Display Conventions.....................................................................2 Getting to Know the Printer............................................................................................3 Control Codes ........................................................................................... 5 Introduction....................................................................................................................5 Attention Getters............................................................................................................5 Immediate Commands.............................................................................. 7 Introduction....................................................................................................................7 SOH # Reset ..........................................................................................................7 SOH A Send ASCII Status String ...........................................................................7 SOH B Toggle Pause .............................................................................................8 SOH C Stop/Cancel................................................................................................8 SOH D SOH Shutdown...........................................................................................8 SOH E Send Batch Quantity ..................................................................................9 SOH F Send Status Byte........................................................................................9 SOH U Update System Database with Current Database......................................9 System-Level Commands ...................................................................... 11 Introduction..................................................................................................................11 STX A Set Time and Date ...................................................................................11 i STX a Enable Feedback Characters...................................................................12 STX B Get Printer Time and Date Information ....................................................12 STX c Set Continuous Paper Length ..................................................................13 STX d Set Double Buffer Mode ...........................................................................13 STX E Set Quantity For Stored Label..................................................................13 STX e Select Edge Sensor..................................................................................14 STX F Form Feed................................................................................................14 STX f Set Form Stop Position (Backfeed Command) ........................................14 STX G Print Last Label Format ............................................................................14 STX I Image Downloading..................................................................................15 STX i Scalable Font Downloading......................................................................16 STX J Set Pause for Each Label ........................................................................16 STX k Test RS-232 Port......................................................................................16 STX L Enter Label-Formatting Command Mode .................................................17 STX M Set Maximum Label Length ......................................................................17 STX m Set Metric Mode .......................................................................................17 STX n Set Imperial (Inches) Mode ......................................................................17 STX O Set Start of Print Position .........................................................................18 STX o Cycle Cutter..............................................................................................18 STX P Character (Hex) Dump Mode ...................................................................18 STX p Controlled Pause......................................................................................18 STX Q Clear All Modules .....................................................................................19 STX q Clear Module ............................................................................................19 ii STX r Select Reflective Sensor ..........................................................................19 STX S Set Feed Speed .......................................................................................19 STX s Set Single Buffer Mode ............................................................................20 STX T Print Dot Pattern Label .............................................................................20 STX t Test RAM Memory Module.......................................................................20 STX U Label Format String Replacement Field ...................................................21 STX V Software Switch Settings..........................................................................22 STX v Request Firmware Version .......................................................................22 STX W Request Memory Module Information ......................................................23 STX w Test Flash Memory Module......................................................................24 STX X Set Default Module...................................................................................24 STX x Delete File from Module ...........................................................................25 STX Y Output Sensor Values ..............................................................................25 STX y Select Font Symbol Set............................................................................26 STX Z Print Configuration and Dot Pattern Labels..............................................26 STX z Pack Module.............................................................................................26 Extended System Commands................................................................ 27 Introduction..................................................................................................................27 STX K Memory Configuration..............................................................................27 STX Kb Backfeed Time Delay ...............................................................................28 STX KC Get Configuration .....................................................................................29 STX Kc Set Configuration......................................................................................29 STX KD Database Configuration............................................................................33 iii STX KE Character Encoding..................................................................................34 STX Kf Set Present Distance................................................................................36 STX KQ Query Memory Configuration ...................................................................36 STX KR Reset Memory Configuration....................................................................37 STX Kr Reset Resettable Counter ........................................................................37 STX KS Memory Configuration, Scalable Font Cache...........................................37 STX KW Memory Configuration, Printable Label Width..........................................37 Label-Formatting Commands ................................................................ 39 Introduction .................................................................................................................39 : Set Cut By Amount...................................................................................39 A Set Format Attribute .................................................................................40 C Set Column Offset Amount ......................................................................41 c Set Cut By Amount...................................................................................41 D Set Dot Size Width and Height.................................................................42 E Terminate Label-Formatting Mode and Print............................................42 F Font Attributes ..........................................................................................43 f Set Present Speed ...................................................................................44 G Place Data in Global Register ..................................................................44 H Select Heat Setting...................................................................................45 M Select Mirror Mode ...................................................................................45 m Set Metric Mode .......................................................................................46 n Set Imperial (Inch) Mode ..........................................................................46 P Set Print Speed ........................................................................................46 iv p Set Backfeed Speed ................................................................................47 Q Set Print Quantity .....................................................................................47 R Set Row Offset Amount............................................................................48 r Recall Stored Label Format......................................................................48 S Set Slew Speed........................................................................................49 s Store Label Format In Module..................................................................49 T Set Field Data Line Terminator ................................................................50 U Mark Previous Field as a String Replacement Field.................................50 X Terminate Label-Formatting Mode without Printing..................................51 y Select Font Symbol Set............................................................................51 z Zero (Ø) Conversion to “0” .......................................................................52 + (>) Make Last Field Entered Increment Numeric (Alphanumeric)..................52 - (<) Make Last Field Entered Decrement Numeric (Alphanumeric) ................53 ^ Set Count by Amount ...............................................................................54 Special Label-Formatting Commands .........................................................................54 STX S Recall Global Data And Place In Field...................................................55 STX T Print Time and Date...............................................................................55 Font Loading Commands....................................................................... 57 Introduction..................................................................................................................57 *c###D Assign Font ID Number ............................................................................57 )s###W Font Descriptor.........................................................................................57 *c###E Character Code ........................................................................................58 (s#W Character Download Data ........................................................................58 v Generating Label Formats ..................................................................... 59 Introduction..................................................................................................................59 Format Record Commands .........................................................................................59 Generating Records ....................................................................................................60 The Structure of a Record ...........................................................................................60 Record Structure Types...............................................................................................63 Internal Bit-Mapped Fonts ...........................................................................................63 Smooth Font, and Downloaded Bit-Mapped Fonts......................................................64 Scalable Fonts.............................................................................................................64 Bar Codes....................................................................................................................65 Images.........................................................................................................................66 Graphics ......................................................................................................................66 Lines and Boxes .......................................................................................................66 Polygons ...................................................................................................................67 Circles.......................................................................................................................68 Available Fill Patterns for Polygons and Circles: ......................................................68 Examples..................................................................................................................69 Appendix A ASCII Control Chart .....................................................................................................71 Appendix B Sample Programs........................................................................................................73 Appendix C Available Font Sizes, Referencing and Samples.........................................................83 vi Appendix D Error Codes .................................................................................................................89 Appendix E Single-Byte Symbol Sets .............................................................................................91 Appendix F Bar Code Summary Data ..........................................................................................101 Bar Code Default Widths and Heights.......................................................................102 Appendix G Bar Code Details .......................................................................................................103 Appendix H Font Mapping: Single-Byte and Double-Byte Characters ..........................................131 Appendix I Symbol Sets and Character Maps .............................................................................133 Symbol Set Selection ................................................................................................133 Double-Byte Symbols, Chinese, Kanji and Korean ...................................................135 Appendix J Module Identifiers, Field Limits, Print Resolutions, & Column Values .......................137 Appendix K Speed Ranges and Defaults......................................................................................139 Appendix L Commands by Function.............................................................................................141 vii Appendix M Image Loading...........................................................................................................143 Appendix N UPC-A and EAN-13: Variable Price and Weight Bar Code .......................................145 Appendix O International Language Print Capability (ILPC) Programming Examples ..................147 Appendix P Downloading Firmware ..............................................................................................153 Appendix Q E-CLASS 4203 / 4304 Statement of Compatibility ....................................................155 Appendix R Bar Code Symbology Information Sources................................................................157 Glossary ................................................................................................ 159 Index ...................................................................................................... 163 viii Preface Who Should Use This Manual This manual is intended for programmers who wish to create their own label production software. Operators without programming experience may prefer to use a label-creation software package. For programming information on models not covered in this document, a copy may be downloaded from our web site at http://www.datamaxcorp.com. Scope of This Manual This manual explains the Datamax Programming Language (DPL) and its related uses in the writing, loading and storing of programs for the control and production of label formats using the Datamax E4203, E4204, and E4304 printers with Application (firmware) Versions 4.06 and above. This manual contains the following chapters and appendices. PREFACE on page 1 Contents, organization and conventions used in this manual CONTROL CODES on page 5 Description of the attention-getter characters necessary for the printer to receive a command sequence, and available alternate characters and line terminators. IMMEDIATE COMMANDS on page 7 Description of the commands, listed alphabetically, that perform status queries and printer control commands. SYSTEM-LEVEL COMMANDS on page 11 Description of the commands, listed alphabetically, that control the printer and allow scalable font and image downloads. EXTENDED SYSTEM COMMANDS on page 27 Description of the commands, listed alphabetically, that control the printer. LABEL-FORMATTING COMMANDS on page 39 Description of commands, listed alphabetically, that control the position of text and images on the media, print or store, and end the formatting process. FONT-LOADING COMMANDS on page 57 Description of commands, listed alphabetically, used when downloading font data in PCL-4 compatible bit-maps. E-Class DPL Programmer’s Manual 1 Preface GENERATING LABEL FORMATS on page 59 Description of the structure of records, the different types, and their use in generating label formats. APPENDICIES A THROUGH R on pages 71 through156 These contain details that cannot be ignored including various tables, programming examples, printer default values, and bar code symbology details. See the Table of Contents for specific content information. GLOSSARY on page 157 Definitions of words, abbreviations, and acronyms used in this manual. General Conventions These are some of the conventions followed in this manual: • On the header of each page, the name of the chapter. • On the footer of each page, the page number and the title of the manual. • Names of other manuals referenced are in Italics. • Notes are added to bring your attention to important considerations, tips or helpful suggestions. • Boldface is also used to bring your attention to important information. • This manual refers to IBM-PC based keyboard command characters for access to the ASCII character set. Systems based on different formats (e.g., Apple’s Macintosh) should use the appropriate keyboard command to access the desired ASCII character. See Appendix A for the ASCII character set. Computer Entry and Display Conventions Command syntax and samples are formatted as follows: • The Courier font in boldface indicates the DPL command syntax, and Italics are used to indicate the command syntax parameters. • Regular Courier font indicates sample commands, files and printer responses. • Square brackets [ ] around something indicates that it is optional. • • 2is used to identify the line termination character. Other strings placed between < > in this manual represent the character of the same ASCII name, and are single-byte hexadecimal values (e.g., , , and <0x0D> equal 02, 0D, and 0D, respectively). Hexidecimal values are often displayed in ‘C’ programming language conventions (e.g., 0x02 = 02 hex, 0x41 = 41 hex, etc.) E-Class DPL Programmer’s Manual Preface Getting to Know the Printer The following highlights basic printer setup and control. For detailed information, including connections, features, media loading, and operating instructions refer to the appropriate Operator’s Manual. • The Power Connection: Depending upon the model (see below), the printer can be connected via an external 110, 220, or auto-ranging AC power supply. Always ensure the power supply included with the printer is compatible with your electrical service. E4203, E4204 and E4304 • Interface Cable Requirements: The interface between the printer and host can be either a serial RS232C cable (as shown below) or a Centronics parallel cable. When the printer is connected with both a serial and parallel cable, it will automatically interface to the first connection that transmits valid data. After this connection has been made, the printer’s power must cycled to change the interface connection. Serial Interface Cable Requirements Part # 32-2300-01 E-Class DPL Programmer’s Manual Part # 32-2301-01 3 Preface • Interface Cable Connection: Connect the printer using the appropriate cable, as shown below. • Front Panel Operation: The Front Panel consists of three lights and three dual-function buttons. E4203, E4204 and E4304 • Normal Operating Mode: While in the normal operating mode, the printer’s buttons control operations such as pause, feed, and cancel. The FEED button is used to clear a fault after its cause has been removed. For testing and reset functions, combinations of the buttons must be simultaneously pressed, as follows: ‘F’ Buttons Function(s) + Prints the Internal Test Label (see the Operator’s Manual for an example). + Performs a warm reset, and then returns to the normal operating mode. + Prints the Database Configuration and Dot Pattern Labels. + + Resets the printer to factory defaults: Turn the printer ‘off’, then press and hold the buttons while turning the printer ‘on’. Continue to depress the buttons until the Paused Indicator turns ‘off’. For setup and calibration functions see the Operator’s Manual. 4 E-Class DPL Programmer’s Manual Control Codes Introduction The printer requires a special “attention getter” character in order to receive a command sequence, informing the printer that it is about to receive a command and the type of command it will be. Control Commands, System-Level Commands, and Font-Loading Commands have their own unique attention getter, followed by a command character that directs printer action. Attention Getters The attention getters (e.g., “SOH”) are standard ASCII control labels that represent a one character control code (i.e., ^A or Ctrl A). Appendix A contains the entire ASCII Control Code Chart. Attention Getter For: Immediate Commands System-Level Commands Font-Loading Commands ASCII Character Decimal Value SOH 1 STX 2 ESC 27 Table 2-1: Control Code Listings HEX Value 01 02 1B Alternate Control Code Modes For systems unable to transmit certain control codes, Alternate Control Code Modes are available. Configuring the printer to operate in an Alternate Control Code Mode (selected via the Setup Menu or the KD / Kc commands) requires the substitution of Standard Control Characters with Alternate Control Characters in what otherwise is a normal datastream. Control Character SOH STX CR ESC “Count By”[1] 1 Standard 0x01 0x02 0x0D 0x1B 0x5E Alternate 0x5E 0x7E 0x0D 0x1B 0x40 Alternate-2 0x5E 0x7E 0x7C 0x1B 0x40 See Label-Formatting Commands, ^, set count by amount. Table 2-2: Alternate Control Codes Note: Throughout this manual , , , , and ^ will be used to indicate the control codes. The actual values will depend on whether standard or alternate control codes are enabled for the particular application. Alternate Line Terminator Alternate-2 Control Codes provide for substitution of the line terminator as well as the control characters listed above. The line terminator (0x0D) is replaced by | (0x7C). The following is a sample label format datastream for a printer configured for Alternate-2 Control Codes: ~L|1911A10001000101234560|X|~UT01ABCDE|~G| E-Class DPL Programmer’s Manual 5 Control Codes 6 E-Class DPL Programmer’s Manual Immediate Commands Introduction When the printer receives an Immediate Command, its current operation will be momentarily interrupted to respond to the command. Immediate Commands may be issued before or after System-Level commands; however, they may not be issued among Label-Formatting Commands or during font or image downloading. Immediate Commands consist of: 1. Attention Getter, 0x01 or 0x5E, see Control Codes. 2. Command Character SOH # Reset This command resets the printer. Resetting the printer returns all settings to default and clears both the communications and printing buffers. The command also clears DRAM memory. Syntax: # Printer response: The printer will reset. T (The T may come after the ). SOH A Send ASCII Status String This command allows the host computer to check the current printer status. The printer returns a string of eight characters, followed by a carriage return. Each character (see below) indicates an associated condition, either true (Y) or false (N). Byte 1 is transmitted first. See F. Syntax: A Sample: A Printer response format: abcdefgh Where: Possible Values a Y/N b Y/N c Y/N d Y/N e Y/N f Y/N g Y/N h N Y Y Y Y Y Y Y Always No E-Class DPL Programmer’s Manual Interpretation = Interpreter busy (Imaging) = Paper out or fault = Ribbon out or fault = Printing batch = Busy printing = Printer paused = Label presented Byte Transmit Sequence 1 2 3 4 5 6 7 8 7 Immediate Commands SOH B Toggle Pause This command toggles the printer’s paused state between on and off. (This is the same function achieved by pressing the PAUSE Button on the front panel.) Syntax: B Sample: B Printer response format: This command will illuminate the Paused Indicator, suspend printing and wait until one of the following occurs: The B command is sent to the printer. The PAUSE Button is pressed. Upon which the printer will turn the Paused Indicator ‘off’ and resume operation from the point of interruption. (If the Receive Buffer is not full, an character will be transmitted from the printer.) SOH C Stop/Cancel This command performs the same function as pressing the CANCEL Button on the printer’s front panel. This function clears the current label format from the print buffer, pauses the printer and illuminates the Paused/Stop Indicator. (The pause condition is terminated as described under B.) Syntax: SOH D C SOH Shutdown This commands the printer to ignore Immediate Commands (^A). The SOH shutdown command is required before loading images or fonts because some may contain data sequences that could be interpreted as Immediate Commands. After the SOH shutdown command is sent, Immediate Commands can be turned back on by sending a valid SOH command three times, separated by a one second delay between each command, or by manually resetting the printer. It is good practice to check batch quantities ( E) to verify that the SOH commands are working. Syntax: 8 D E-Class DPL Programmer’s Manual Immediate Commands SOH E Send Batch Quantity This command causes the printer to send back a four-digit number indicating the quantity of labels that remain to be printed in the current batch, followed by a carriage return. Communications latency may cause this value to be higher than actual on some printers. Syntax: E Printer response: nnnn Where: nnnn SOH F - Is four decimal digits, 0-9999. Send Status Byte This command instructs the printer to send a single status byte where each bit (1 or 0) represents one of the printer’s status flags, followed by a carriage return (see below). If an option is unavailable for the printer, the single bit will always be 0. See A. F Syntax: Printer response format: X Where ‘X’ is 0 through 0xef with bits as indicated in the ‘Condition’ column below: Bit[1] 8 7 6 5 4 3 2 1 1 Bit one is the least significant bit. SOH U Value Condition 0 1 or 0 1 or 0 1 or 0 1 or 0 1 or 0 1 or 0 1 or 0 Always zero Label presented Printer paused Busy printing Printing batch Ribbon out or Fault Paper out or Fault Command interpreter busy (Imaging) Update System Database with Current Database This command saves the current printer configuration to Flash memory. Only those parameters stored in Flash memory are affected. These are all the parameters that can be modified via the Setup Menu. The values of any System Commands issued prior to U and affecting printer configuration items will also be saved. See the # command, above, for details on what events occur during a reset. Syntax: U Printer response: The printer will reset. T (The T may come before the ). E-Class DPL Programmer’s Manual 9 Immediate Commands 10 E-Class DPL Programmer’s Manual System-Level Commands Introduction The most commonly used commands are the System-Level Commands. These are used to load and store graphic information, in addition to printer control. System-Level Commands are used to override default parameter values (fixed and selectable) and may be used before or after Immediate Commands but cannot be issued among Label-Formatting Commands. System-Level Commands consist of: 1. Attention Getter, 0x02 or 0x7E, see Control Codes. 2. Command Character 3. Parameters (if any). STX A Set Time and Date This command sets the time and date. The initial setting of the date will be stored in the printer’s internal inch counter. This date can be verified by printing a Configuration Label. AwmmddyyyyhhMMjjj Syntax: Where: w mm dd yyyy hh MM jjj 1 digit for day of week; 1 = Monday; 7 = Sunday 2 digits for month 2 digits for day 4 digits for year 2 digits for hour in 24 hour format 2 digits for minutes 3 digits for Julian date (numerical day of the year) / constant; see notes below Sample: A1020319960855034 Printed response: Mon. Feb 3, 1996, 8:55AM, 034 Notes: (1) When set to 000, the Julian date is automatically calculated; otherwise, the Julian date will print as that entered number, without daily increments. If factory defaults are restored the actual Julian date will also be restored. (2) Printers without the Real Time Clock option lose the set time/date when power is removed. (3) Response format is variable; see the Special Label-Formatting Command T. E-Class DPL Programmer’s Manual 11 System-Level Commands STX a Enable Feedback Characters This command enables the feedback ASCII hex characters to be returned from the printer following specific events after each completed batch of labels when using serial communications. The default value is ‘Off’. Syntax: a Printer response: Event dependent. (Also, see Appendix D for error codes.) Where: Event Invalid character Label printed End of batch STX B Return Characters 0x07 ( BEL ) 0x1E ( RS ) 0x1F ( US ) Get Printer Time and Date Information This command instructs the printer to retrieve its internal time and date information. Syntax: B Sample: B Printer response format: wmmddyyyyhhMMjjj Where: w mm dd yyyy hh MM jjj 1 digit for day of week; 1 = Monday 2 digits for month 2 digits for day 4 digits for year 2 digits for hour in 24 hour format 2 digits for minutes 3 digits for Julian date / constant* * See A for details and restrictions. Printer response sample: 1020319960855034 12 E-Class DPL Programmer’s Manual System-Level Commands STX c Set Continuous Paper Length This command sets the label size for applications using continuous media. It disables the top-of-form function performed by the Media Sensor. The sensor, however, continues to monitor paper-out conditions. See M. Syntax: cnnnn Where: nnnn Sample: c0100 - Specifies the length of the media feed for each label format, in inches/100 or millimeters/10 (see m). This sample sets a label length of 100, which equals 1.00 inch (assuming Imperial Mode is selected). Note: This command must be reset to zero for edge or reflective sensing operation. Pre-printed media cannot be used with a continuous paper length because print registration will be lost. STX d Set Double Buffer Mode This command, available for backward compatiblity, enables double buffer mode. When printing labels with incrementing, decrementing and replacement fields (see note below) the printer will only erase and format those fields, leaving the rest of the label format untouched, and thus increasing throughput. This command is only active if the labels being printed are less than half the maximum size of the print buffer (see S). d Syntax: Note: This command is generally not used because fast formatting is the normal operating mode when the number of variable print fields (Label-Formatting commands +, -, <, >, u) is less than or equal to 1/3 of the total print field count. In this case the command will force fast formatting even when the proportion of variable print fields is greater than 1/3 the total. The maximum label size is unaffected by this command. The s command restores normal (fast) formatting. STX E Set Quantity For Stored Label This command sets a number of labels for printing using the format currently in the print buffer. (The printer automatically stores the most recent format received in the buffer until the printer is reset or power is removed.) When used in conjunction with the G command, this will print the labels. Syntax: Ennnn Where: nnnn Sample: E0025 G Printer response: 25 labels of the current format in memory will be printed. - A four-digit quantity, including leading zeros. Note: This command may be issued prior to a label format without a specified quantity, Qnnnnn. E-Class DPL Programmer’s Manual 13 System-Level Commands STX e Select Edge Sensor This command enables transmissive (see-through) sensing for top-of-form detection of die-cut, and holed or notched media. This Media Sensor will detect a minimum gap of 0.1 inches (2.54 mm) between labels (see the Operator’s Manual for media requirements). Use the O command to adjust the print position. This is the printer default setting at power-up or reset. e Syntax: Note: This command is ignored when cnnnn is issued with a non-zero value for nnnn. STX F Form Feed This commands the printer to form feed to the next start of print. Syntax: F Printer response: The printer will form feed. Note: Following a reset, if the length of the first label fed is less than the label offset value (defined by the O command) the printer will advance past that label until a top-ofform is detected, or until the offset is reached,skipping labels as necessary, unless Label Alignment is enabled. STX f Set Form Stop Position (Backfeed Command) This sets the stop position of the printed label, allowing the label to stop at a point past the start-ofprint position. When the next label format is sent, the printer motor reverses direction to retract the media to the start-of-print position. If quantities of more than one label are requested, the printer will operate without backfeeding. A backfeed will then only occur when printing has stopped for a few seconds. Syntax: fnnn Where: nnn Sample: f230 - Is a three-digit distance from the Media Sensor, in inches/100 or mm/10. This distance is independent of the start-of-print position ( O), yet it must be greater than the start-of-print position to take effect. The sample sets a stop position distance of 230 (2.3 inches from the Media Sensor’s eye). STX G Print Last Label Format This command prints a previously formatted label and restarts a canceled batch job following the last processed label. This is used when there is a label format in the buffer. The E command is used to enter the quantity. (If the E command is not used only one label will print.) Syntax: 14 G E-Class DPL Programmer’s Manual System-Level Commands STX I Image Downloading This command must precede image downloading from a host computer to the printer. The data that immediately follows the command string will be image data. If any of the 8-bit input formats are to be used, it is necessary to disable the Immediate Command interpreter by executing an D command before issuing the I command. See Appendix M for more information. To print an image, see Generating Label Formats. Note: The native format for storing downloaded PCX and BMP images is RLE-2. This results in a better compression ratio for gray-scale images and for images with very large areas with either black or white, effectively resulting in more module space for downloaded images. Syntax: Iabfnn…n data Where: a - Memory Module Bank Selection, A, B, or C; see Appendix J. b - Data Type (optional), A or omit. b Value: A omitted f - Format Designator f Designator: F B b I i P p R Sample: Image Data Value Range: ASCII Characters 0-9, A-F, (7 bit) 00-FF, (8 bit) Format Type: 7-bit Datamax image load file .BMP 8-bit format (image flipped), black and white (B&W) .BMP 8-bit format (image as received), B&W .IMG 8-bit format (image flipped), B&W .IMG 8-bit format (image as received), B&W .PCX 8-bit format (image flipped), B&W .PCX 8-bit format (image as received), B&W RLE-2 Native format nn…n - Up to 16 characters used as an image name. - data - Image data 0x0d terminates the name. D IApTest data...data The sample instructs the printer to (1) receive an 8-bit PCX image sent by the host in an 8-bit data format, (2) name the image ‘Test’, and (3) store it in memory module A. E-Class DPL Programmer’s Manual 15 System-Level Commands STX i Scalable Font Downloading The command structure for downloading both IntelliFont (.CDI) and TrueType (.TTF) scalable fonts (font files may be single-byte or double-byte character systems) is as follows: Syntax: imtnnName xx…xdata… Where: m - Memory Module Designator to save this font to; see Appendix J. t - Type of scalable font being downloaded: I = IntelliFont T = TrueType nn - Two-digit font reference ID. Valid range is 50-99, 9A-9Z, 9a-9z, (base 62 numbers). Name - The title, up to 16 characters, for this font. - 0x0d terminates the Name. xx…x - Eight-digit size of the font data, number of bytes, hexadecimal, padded with leading zeros. data - The scalable font data. iET52Tree Frog 000087C2data... Sample: This sample downloads a TrueType font to module ‘A’, assigns it the font ID of 52 and the name “Tree Frog”. The size of the font data is 0x87C2 bytes. STX J Set Pause for Each Label This command causes the printer to pause after printing each label and is intended for use with the peel mechanism or tear bar when the Present Sensor option is not installed. After removing the label, the PAUSE Button must be pushed in order to print the next label. (The printer must be reset to clear the J command.) J Syntax: STX k Test RS-232 Port This command instructs the printer to transmit the character Y from the printer’s RS-232 port. (Failure to receive a ‘Y’ could indicate an interfacing problem.) 16 Syntax: k Printer response: Y E-Class DPL Programmer’s Manual System-Level Commands STX L Enter Label-Formatting Command Mode This command switches the printer to the Label-Formatting Command mode. Once in this mode, the printer expects to receive Record Structures and Label-Formatting Commands. Immediate, SystemLevel, and Font-Loading commands will be ignored until the label-formatting mode is terminated with E, s, or X, (see Label-Formatting Commands for additional information). Syntax: STX M L Set Maximum Label Length This command instructs the printer move media this distance in search of the top-of-form (label edge, notch, black mark, etc.) before declaring a paper fault. A paper fault condition can occur if this setting is too close (within 0.1 inch [2.54 mm]) to the physical length of the label. Therefore, it is good practice to set this command to 2.5 to 3 times the actual label length used. The minimum value should be at least 5” (127 mm). Syntax: Mnnnn Where: nnnn Sample: M0500 - Is a four-digit length, 0000-9999, in/100 or mm/10. Maximum setting is 9999 (99.99 inches or 2540 mm). The default setting is 16 inches/ 406.4 mm The sample sets a maximum travel distance of 5 inches (unless printer is in metric mode, see m). STX m Set Metric Mode This command sets the printer to interpret measurements as metric values (e.g., c0100 will equal 10.0 mm). The default is Imperial (inches) Mode (see n). Syntax: STX n m Set Imperial (Inches) Mode This command sets the printer to interpret measurements as imperial values (e.g., c0100 will equal 1.00 inch). The printer defaults to this mode. Syntax: n E-Class DPL Programmer’s Manual 17 System-Level Commands STX O Set Start of Print Position This sets the point to begin printing relative to the top-of-form (the label’s edge as detected by the Media Sensor). The printer will feed from the top of form to the value specified in this command to begin printing. This value operates independently of the f command. Syntax: Onnnn Where: nnnn Sample: O0300 - Is a four-digit offset value. The “zero” setting is the default value, and settings below 50 are adjusted back to the default value. The default setting is 0220 in Imperial Mode (0559 in metric). The sample sets a start of print position of 3.0 inches (unless in Metric Mode, see m). STX o Cycle Cutter This command will cause the (optional) cutter mechanism to immediately perform a cut after all previously received commands are executed. The cutter must be installed, enabled and the interlock closed for operation. Syntax: STX P o Character (Hex) Dump Mode This command instructs the printer to enter the Character Hex Dump Mode (also known as ASCII dump or monitor mode). Data sent to the printer following this command will be printed in raw ASCII format. Labels must be at least four inches (102 mm) long and as wide as the maximum print width. This command has the same effect as turning the printer ‘On’ while pressing the FEED Button; however, no Configuration/Test Pattern label is printed. To return to normal operation the printer must be manually reset. Syntax: STX p P Controlled Pause This command will cause the printer to pause only after all previously received commands are executed. This controlled pause is often useful between batches of labels. (This command will not clear the pause condition, see B). Syntax: 18 p E-Class DPL Programmer’s Manual System-Level Commands STX Q Clear All Modules This command instructs the printer to clear all Flash and DRAM modules (see the Operator’s Manual of the corresponding printer for applicable memory options). All stored data will be destroyed. Syntax: STX q Q Clear Module This command clears the selected Flash or DRAM module. If a module is corrupted during normal operations (identifiable when the printer responds with a ‘No Modules Available’ message to a W command), it must be cleared. All stored data in the selected module will be destroyed. Syntax: qa Where: a Sample: qA - Memory module designator, A – C; see Appendix J. The above sample clears memory module A. Notes: (1) If a module directory intermittently returns the message ‘No Modules Available’ or if data continuously becomes corrupted, the module may be at the end of its service. However, before concluding that a module is defective cycle the printer’s power and test the module. (2) Some Flash Memory Expansion options must have jumpers installed to perform this command. STX r Select Reflective Sensor This command enables reflective (black mark) sensing for top-of-form detection of rolled butt-cut, and fan-fold or tag stocks with reflective marks on the underside. This Media Sensor will detect a minimum mark of 0.1 inches (2.54 mm) between labels (see the Operators Manual for media requirements). The end of the black mark determines the top of form. Use the O command to adjust the print position. Syntax: r Default: Edge sensing STX S Set Feed Speed This command controls the rate at which media is output when the FEED Button is pressed. Syntax: Sn Where: n E-Class DPL Programmer’s Manual - Is a letter value (see Appendix K). 19 System-Level Commands STX s Set Single Buffer Mode This command, available for backward compatiblity, instructs the printer to use single buffer operation. In single buffer mode, the printer will erase and format all fields. This, in turn, decreases printer throughput when incremental, decremental, or replacement fields are used (see LabelFormatting Commands). See d. s Syntax: STX T Print Dot Pattern Label This command instructs the printer to produce a Dot Pattern Label, a label comprised of differnet patterns that exercise the printhead. This is the same test label printed when powering on the printer while pressing the FEED Button, except that the printer will not produce a Configuration Label or enter the Hex Dump Mode. To view the full dot pattern use media at least 2 inches (51 mm) long and as wide as the maximum print width. T Syntax: Printer response: STX t Test DRAM Memory Module This command tests the DRAM module; however, the printer must be in Test Mode for the command to function. The printer returns a one-line message stating the module condition (no message is returned if a module is unavailable). To enable the Test Mode see the KD command. Syntax: t Printer response format: axxxK results Where: 20 a - 2 = Slot B xxx - Module size in Kbytes results - Test results given as ‘Good’ or ‘Bad’. E-Class DPL Programmer’s Manual System-Level Commands STX U Label Format String Replacement Field This command places new label data into format fields to build a label. The new data string must equal the original string length and contain valid data. To easily keep track of fields, place all of the fields to be updated with the command at the beginning of the label format. A maximum of 99 format fields can be updated. Fields are numbered consecutively 01 to 99 in the order received. A variant of the U command includes the truncate option ‘T’, where dynamic data that is shorter that the originally defined field length will not be padded, and the original maximum field length is maintained for subsequent replacements. If this option is not used when dynamic data is shorter than the length of the originally defined data field, the field will be padded with blanks (or zero when the Format Record header specifies a numeric barcode). Syntax: U[T]nnss…s Where: nn - Is the format field number, 2 digits. [T] - Truncate option ss…s - Is the new string data, followed by a Sample: L 161100001000100data field 1 161100001100110data field 2 161100001200120data field 3 Q0001 E U01New data F1 U02New data F2 E0002 G The sample produces three labels. The first is formatted with the commands between L and E. The next two labels print with the replacement data contained in the U commands (see E and G). E-Class DPL Programmer’s Manual 21 System-Level Commands STX V Software Switch Settings This command allows the control of printer options, where the appropriate value allows the option(s) to be turned ‘On’ or ‘Off’. Each option has a corresponding bit whose value is 1 when enabled. The tables below indicate the bit assignments and corresponding command value needed to enable the desired option(s). Syntax: Vn Where: n Sample: V5 - Is a single digit ASCII numeric value from 0-F. The value of n is used to override the power-up option settings. Reset or power-up returns the printer to the original settings. The sample corresponds to setting Bits 0 and 2, creating a command value of 5. When applied, this enables the Present Sensor and Cutter options. Bit Assignment 0 1 2 3 Printer Option Cutter N/A Present Sensor N/A Use the bit assignment table above to determine the command value n in the binary table below (e.g., the command value 5 sets the bits 0 and 2 to “1”). n Value 0 1 4 5 STX v Command Values for Bits Assigned Bit 3 2 0 0 0 0 0 1 0 1 1 0 0 0 0 0 0 1 0 1 Request Firmware Version This command causes the printer to send its version string (this data is the same as that printed on the Configuration Label). 22 Syntax: v Printer response: VER: E4304 – 04.06 09/01/2001 E-Class DPL Programmer’s Manual System-Level Commands STX W Request Memory Module Information This command requests a directory listing for memory module(s). Although a module can store font, image and format data together, it can display only one type of information at a time. If the module contains all three types of data, it will be necessary to check the directory three times, using each of the control parameters, F, G, and L to determine the contents. When no user accessible modules are present, there is no printer response to WF, WG or WL. Syntax: Wa Where: a - Data type: F G L f Sample: = = = = Downloaded Font Graphic (Image) Label All fonts (respective of the resident fonts available and any fonts that have been downloaded). Wf Printer response: Meaning: MODULE: A Module ID ‘A’, fonts following reside in this module 103 CG Triumv Downloaded font ID and name MODULE: F Module ID ‘F’ (no user access), fonts following reside in this module 000 Font internal ID 000, resident bitmapped font DPL ID 0 001 Font internal ID 001, resident bitmapped font DPL ID 1 002 Font internal ID 002, resident bitmapped font DPL ID 2 003 Font internal ID 003, resident bitmapped font DPL ID 3 004 Font internal ID 004, resident bitmapped font DPL ID 4 005 Font internal ID 005, resident bitmapped font DPL ID 5 006 Font internal ID 006, resident bitmapped font DPL ID 6 007 Font internal ID 007, resident bitmapped font DPL ID 7 008 Font internal ID 008, resident bitmapped font DPL ID 8 012 Font internal ID 012, resident bitmapped font DPL ID 9, A06 013 Font internal ID 013, resident bitmapped font DPL ID 9, A08 014 Font internal ID 014, resident bitmapped font DPL ID 9, A16 015 Font internal ID 015, resident bitmapped font DPL ID 9, A12 016 Font internal ID 016, resident bitmapped font DPL ID 9, A14 017 Font internal ID 017, resident bitmapped font DPL ID 9, A18 018 Font internal ID 018, resident bitmapped font DPL ID 9, A24 019 Font internal ID 019, resident bitmapped font DPL ID 9, A30 020 Font internal ID 020, resident bitmapped font DPL ID 9, A36 E-Class DPL Programmer’s Manual 23 System-Level Commands STX w Test Flash Memory Module This command tests the Flash memory module. The time for each test will vary from 20 to 120 seconds, depending upon the size of the module. (When testing the optional module, jumpers must be installed.) All stored data will be destroyed. If no module is present, there will be no printer response. Syntax: wa Where: a - Module designator; see Appendix J. Printer response format: Module A: xxxxK results Where: A - Module tested. xxxx - Module size in kilobytes. results - Test results given as ‘Good’ or ‘Bad’. STX X Set Default Module This command, typically used prior to the loading of PCL-4 bit-mapped fonts (see Font-Loading Commands), is designed to allow the user to select between modules when downloading information. The default module is one of the following: 1. The first alpha designator of the existing modules if item 2 has not occurred. 2. The module selected by this command. Syntax: Xa Where: a Sample: XB - Module designator, A or B; see Appendix J. The sample sets ‘B’ as the default module. 24 E-Class DPL Programmer’s Manual System-Level Commands STX x Delete File from Module This command removes a specific file from the specified module. The file name is removed from the module directory and thus the file cannot be accessed. The actual storage space occupied by the file is not released. (To reclaim deleted file storage space use z.) Syntax: xmtnn…n Where: m - Module designator; see Appendix J. t - The file type identification code: G L F S nn…n STX Y = = = = Image file Label format file Bit-Mapped font file Smooth scalable font file - The file name to delete, up to sixteen alphanumeric characters for graphic or label format files, 3 for bit-mapped font files, and 2 for smooth scalable font files. Output Sensor Values This command causes the printer to respond with its sensor value status. The printer must be in Test Mode (see the KD command). When Y is received, the printer will respond with A-D sensor values, see below. To repeat the display of values, send the printer a ‘space character’ (20 hexadecimal). Send to terminate the function. Syntax: Y Printer response: Thermistor ADC: 0048 Paperout ADC: 0000 TOF Adjust ADC: 0170 Where: Reflective ADC: 0000 Transmissive ADC: 0204 24 Volt ADC: 0217 Contrast ADC: 0093 Ribbon ADC: 0125 Battery level: Good Paperout ADC: 0225 indicates paper is present; 0000 indicates paper is not present. Battery level: ‘Good’ indicates the battery has sufficient charge; ‘Low’ indicates the battery is insufficiently charged Note: Some readings (e.g., the Media Sensor) require printer controlled paper movement to indicate a meaningful value. E-Class DPL Programmer’s Manual 25 System-Level Commands STX y Select Font Symbol Set This command selects the scalable font symbol set. The selected symbol set remains active until another symbol set is selected. See Appendices E, I, and the KS command for more information. Option dependant. Not all symbol sets can be used with all fonts. Syntax: ySxx Where: S - Byte size designation, see Appendix H. S = Single-byte symbol sets U = Double-byte symbol sets xx - Symbol set selection. Sample: ySPM The sample selects the PC-850 multilingual set. STX Z Print Configuration and Dot Pattern Labels This command prints Configuration and Dot Pattern Labels. The results are similar to performing the power-up self-test, but the printer does not enter Hex Dump Mode. To capture all printed information, use the labels as wide as the maximum print width and at least 4 inches (102mm) long. Z Syntax: Printer response: FRI SEPTEMBER 026, 1997 19:29 244 VER: E4304 - 04.06 08/24/01 BOOT 83-2329-04A CODE 83-2325-04F FONT 83-2337-01A CPLD 59-2157-01C SYSTEM RAM CHECKS____ GOOD SYSTEM RAM SIZE___ 2016 KBYTES SYSTEM RAM AVAIL__ 1264 KBYTES REG POWER SUPPLY__ NO DIRECT THERMAL COMMUNICATIONS NOT DETECTED 9600,8,N EDGE SOP ADJUST________ 128 PRESENT ADJUST____ 128 TOF LOW___________ 0 TOF DELTA_________ 10 TOF GAIN__________ 10 OOS MAXVOLT_______ 2 INPUT VALUES PAPER_____________ DARKNESS__________ TRAN______________ REFL______________ RIBM______________ THR_______________ 24V_______________ COUNTER INFORMATION ABSOLUTE VALUES 9-18-1999 LENGTH____ 773 INCHES TIME______ 20 HOURS RESETTABLE VALUES 9-22-1999 LENGTH____ 576 INCHES TIME______ 10 HOURS 255 131 255 149 87 48 223 MEMORY CONFIGURATION INTERNAL MODULE______ 128 SCALABLE FONTS_______ 64 LABEL SIZE 0410:02218 IN STX z Pack Module This command causes the printer to reclaim all storage space associated with all deleted files on the specified module (see X and x). 26 Syntax: zm Where: m - Module designator; see Appendix J. E-Class DPL Programmer’s Manual Extended System Commands Introduction Extended System Commands expand certain System-Level Commands, providing extra printer control. Extended System Commands are issued in the same context as System-Level Commands. The table below lists the commands. Command K Command Character b Backfeed Time Delay C Get Configuration c Set Configuration D Database Configuration E Character Encoding f Set Present Distance M Memory Configuration, Internal Module Q Query Memory Configuration R Reset Memory Configuration r Reset Resettable Counters S Memory Configuration, Scalable Font Cache W Memory Configuration, Printable Label Width Table 5-1: Extended System Command Characters STX K Memory Configuration This command configures the available DRAM as a method for managing printer memory. The DRAM memory includes standard DRAM. Memory can be assigned to specific entities or functions in units of 4KB blocks. The allocation(s) as set by this command, draw from the same memory pool, control the sizes of internal Module A, Scalable Cache, and label width. The command indirectly affects maximum print length and label throughput; see note below. The printer executes the memory configuration specified by the command during the next idle period following its receipt, and is stored in Flash memory then reinstated upon a power-up or reset. If the total requested memory allocation exceeds the configurable memory available, contains no fields, or for configurations not specified, the command will be rejected and the printer will assume its previous configuration. Any of the three fields are optional, and are separated by the colon. Brackets indicate optional fields. Syntax: Kix[:jy][:kz] Sample: KM0020:S0015 In the sample, memory is allocated 20*4*1024 bytes for Module A space and 15*4*1024 bytes for the scalable cache. E-Class DPL Programmer’s Manual 27 Extended System Commands Where: i, j, k are M, S, or W; x, y, z are four-digit maximum numbers of 4K byte blocks or inches/100 or (mm/10) as described below. M Represents the start of a sequence (up to five characters) that assigns memory to the Internal Module A. If this field does not appear, then the Internal Module is not affected. If no Internal Module exists, it will be created and formatted. Existing Internal Modules will be erased, re-sized and formatted. The number that follows the M is a decimal number (up to four digits) that specifies the size in 4KB blocks of memory to assign to the Internal Module. A value of “0000” will delete the Internal Module (see Appendix J for additional information). S Represents the start of a sequence (up to five characters) that assigns the amount of internal memory allocated to the smooth scalable font processor. This field is optional; if it does not appear, the current amount of memory assigned to the smooth scalable font processor will remain unchanged. The allocation must be at least 15 (60KB) to print scalable fonts, and at least 30 for double-byte fonts. The number that follows the S is a decimal number (up to four digits) that specifies the size in 4 KB blocks to assign to the smooth scalable font processor. Any value less than the minimum requirement results in the amount assigned to be zero (0), thereby disabling the printing of smooth scalable fonts. The recommended value is 0025 (100KB). W Represents the start of a sequence (up to five characters) that sets the printable label width. Setting a width smaller than the natural (maximum) width of the printer effectively extends printable label length. This field is optional; if it does not appear, the current printable label width is left unchanged. The number that follows the W is a decimal number (up to four digits) that specifies the printable label width in either 100ths of an inch or millimeters, depending on the current units setting of the printer (imperial or metric). If the value specified exceeds the printable width of the printer, the printable label width is set to the maximum. If the value specified is less than the minimum value allowed (200) then the printable label width is set to the minimum allowed value. Note: Label printing requirements may be computed as bytes (label print length * width allocation * printhead resolution / 8). For maximum throughput, the memory allocated should allow for a minimum of three times the computed requirement, or the available label length (as determined by KQ command) should be three times the label print length. STX Kb Backfeed Time Delay The backfeed time delay command controls the time a printed label is allowed to remain “presented” before being retracted to the start of print position. 28 Syntax: Kbnnn Where: nnn - Seconds/10 E-Class DPL Programmer’s Manual Extended System Commands STX KC Get Configuration This command returns the configuration of the printer. The form of the returned data is similar to that of a Configuration Label. This command should be parsed by KEYWORDS, not Character POSITIONS. Each line is terminated by a CR (0x0d) & LF (0x0a). Datamax will make every effort to keep Keyword consistent. KC Syntax: Printer response: XXX NOT SET 00, 0000 00:22 000 VER: E4304 - 04.06 08/24/01 BOOT 83-2329-04A CODE 83-2325-04F FONT 83-2337-01A CPLD 59-2157-01C INTERNAL FLASH MODULE PRESENT SYSTEM RAM CHECKS____ GOOD SYSTEM RAM SIZE___ 2015 KBYTES SYSTEM RAM AVAIL__ 1244 KBYTES REG POWER SUPPLY__ YES CONFIGURATION DIRECT THERMAL SERIAL PORT SELECTED 9600;8 BITS EDGE CONT FORM LENGTH__ 0 PRESENT ADJUST____ 127 SOP ADJUST________ 127 TOF LOW___________ 0 0 TOF DELTA_________ 10 10 TOF GAIN__________ 12 10 OOS MAXVOLT_______ 3 3 LABEL ALIGNMENT___ AUTO STX Kc ALIGN LENGTH______ 460 STOP LOCATION_____ PEEL INPUT VALUES PAPER_____________ 0 POT_______________ 255 TRAN______________ 250 REFL______________ 0 RIBN______________ 116 TEMP______________ 52 VOLT______________ 214 COUNTER INFORMATION ABSOLUTE VALUES 1- 1-1995 LENGTH____ 2065 INCHES TIME______ 62 HOURS RESETABLE VALUES 1- 1-1995 LENGTH____ 2065 INCHES TIME______ 62 HOURS MEMORY CONFIGURATION INTERNAL MODULE______ 15 SCALABLE FONTS_______ 32 LABEL SIZE 0416:02157 IN END OF LIST Set Configuration This command, equivalent to using other system commands followed by the U and intended for easily configuring a custom setup not dynamic configuration changes, specifies the Power-up Configuration parameter values for the printer. The printer will reset upon completion of a command stream containing parameter value (e.g., memory configuration, label width, etc.) changes; no commands should be sent until this reset is complete. The following are highlights of this command: • These parameter values do not affect the factory default settings of the printer. • When separated by a semi-colon (;), multiple parameter values included in a single command stream. • All values are stored in Flash memory and remain in effect until new values are received or until factory defaults are restored. • If system commands are sent that override the Power-up Configuration value(s), the Power-up Configuration value(s) will be restored the next time the printer is powered ‘on’ or reset. • The parameters are the same as those found in the Setup Menu. Note: Illegal or out of range parameter values may have unpredictable results. E-Class DPL Programmer’s Manual 29 Extended System Commands Syntax: Kcaa1val1[;aaIvalI][;aanvaln] Where: aa1, aaI, aan - Are two letter parameter names val1, valI, valn - Are parameter values, with ranges appropriate for the associated parameter Sample: KcPA120;CL600;STC The sample sets the Present Adjust to 120 dots, the Continuous Label Length to 6 inches, and the Media Sensor Type to Continuous. The following table summarizes the different Set Configuration Command parameters. Descriptions of these parameters can be found by referencing the Command Equivalent. Where no equivalent is given, Unique parameters descriptions are given below. Parameter Name Parameter Pneumonic Continuous Label Length Configuration Query Control Codes Cutter Equip CL QQQ CC CE Internal Module A Label Alignment Label Alignment Length Label Width No Paper Min (OOS) No Paper Min Reflective Print Method Present Adjust Present Sensor Enable IM LA AL LW TN RN MT PA PS Scalable Cache Sensor Type SC ST Serial Port Configuration SOP Adjust Stop Location TOF Bias TOF Bias Reflective TOF Delta TOF Delta Reflective TOF Gain TOF Gain Reflective SP SA SL TB RB TD RD TG RG Setup Command Menu Equivalent Item 0 – 9999 1/100 in. 10 c none none N/A N/A S, 1, 2 Standard, Alternate, Alternate-2 9 KD Y, N Enabled, Disabled 4 KD, V 0 – 128 4 KB 17 KM Y, N, A Enabled, Disabled, Automatic 18 N/A 000 – 999 1/100 inch 19 N/A 75 - head width 1/100 inch 15 KM 0 – 16 .1 Volt DC 11 N/A 0 – 16 .1 Volt DC 11 N/A D, T Direct, Thermal Transfer 1 KD 0 – 255 Dots 6 N/A Y, N Enabled, Disabled 3 KD, V 0 – 128 4 KB (0 = disabled) 16 KS G, C, R Gap (Edge), Continuous, 2 e, Reflective r, KD A See details below 7, 8 KD 0 – 255 Dots 5 N/A H, P, C, T, N Host, Peel, Cut, Cover, None 20 N/A 0 – 50 .1 Volt DC 14 N/A 0 – 50 .1 Volt DC 14 N/A 0 – 50 .1 Volt DC 13 N/A 0 – 50 .1 Volt DC 13 N/A 0 – 15 .1 Volt DC 12 N/A 0 – 15 .1 Volt DC 12 N/A Value Range Units / Interpretation Table 5-2: Set Configuration Commands Configuration Query – This command causes the printer to respond with the current configuration settings. The Kc response command stream format is sent to the host 30 E-Class DPL Programmer’s Manual Extended System Commands computer via the serial port, contains all parameters controlled by the Kc command, and may be used for restoring the printer’s configuration or for configuring other printers. Media sensing scaling values, TOF Bias, etc. may not be effective on other printers of the same type due to hardware tolerances. Label Alignment – This function prevents labels with lengths that are less than the distance between the printhead and the Media Sensor from being wasted at power-up. See the appropriate Operator’s Manual for detailed information. Note: The Real Time Clock (RTC) option allows the position-state of the label to be stored, thus eliminating the need for an alignment prior to the printing of the first label (assuming the label position has not moved while power was off). If the label stock has been changed then a Forced Alignment (the FEED Button is pressed and held for four seconds) is recommended. Media Type, Operation Mode Continuous stock; 6.5” or greater die-cut, notched and reflective stocks; multiple form lengths 6.5” or less die-cut, notched and reflective stocks Label Alignment Setting Disabled Automatic Enabled 6.5” or less die-cut, notched and reflective stocks with the Present Sensor enabled Automatic Description At power-up, printing will begin at the current label position without any alignment (unless the RTC option is installed). Use for easy label length changes, and to automatically set the maximum label length. Press and hold the FEED Button four seconds and the printer will automatically measure the label length. Once loaded and aligned subsequent power-ups will result in no wasted labels. Use for constant label lengths. Specify the Label Alignment Length using the KcAL command or the Setup Menu. Press and hold the FEED Button four seconds, or toggle printer power, then the printer will align with the specified length. This mode of operation requires a Label Alignment Length or that Label Alignment be set to AUTO. If either of these conditions is not met, the printer will not perform the alignment. Label Alignment Length – This length, measured from leading edge to leading edge of two successive labels, must be provided to the nearest hundredth of an inch. The number of labels that can be fit between the Media Sensor and the printhead will magnify any error in label alignment length. Errors are more favorable on the low side than on the high side. Media Type – Sets printing for either direct thermal media or thermal transfer media. No Paper Min / No Paper Min Reflective – Sets the Media Sensor reading for the Out Of Stock condition. E-Class DPL Programmer’s Manual 31 Extended System Commands Present Adjust – Fine-tunes the label stop position (see notes below). Serial Port Configuration – This command is followed by the port ID, always ‘A’ (i.e., SPA) then by the configuration parameter and value of Baud or Data Bits: Baud Rate – The SPABnn command sets the baud rate for the printer serial port, where nn may be any of the following: Bnn 12 24 48 96 19 38 Baud Rate (Bits Per Second) 1200 2400 4800 9600 19200 38400 Sample: KcSPAB38 The above sample sets the printer serial port baud rate to 38400 BPS (the host computer communications setup is expected to be the same) and has the same effect as using the Setup Menu. Data Bits – The KcSPADn command selects either 7 or 8 data bits, where n may be either of the following: Dn 7 8 Data bits (word length) 7 8 Sample: KcSPAD8 The above sample sets the printer serial port to receive eight-bit words (the host computer communications setup is expected to be the same) and has the same effect as using the Setup Menu. SOP Adjust – Fine-tunes the label Start Of Print position (see note below). Stop Location – Configures the printer for all standard label present positions, as follows: Setting Host Peel Cut Cover None Note: 32 Stop Location Provides backward compatibility for users engaging the cutter or Present Sensor to achieve present distances. The stop location (present distance) may be controlled dynamically by the host using the f or Kf commands. This selection has the same effect as KD Ignore Host Distance bit value 0. Sets the stop location to approximately 2 mm behind the peel bar edge, a nominal peel position. The Present Sensor status and this setting are independent. Sets the stop location to a nominal cut position. For die-cut media, the position is just following the end of the label. The cutter status and this setting are independent. Sets the stop location to that of the tear bar on the printer cover. Sets the stop location to the start of the next label, equivalent to setting the KD Ignore Host Distance bit value 1. The Peel, Cut, Cover, and None settings prevent host commands from affecting start of print ( O) and stop position ( f, Kf) commands from being honored. All stop locations can be adjusted with PRESENT ADJUST. E-Class DPL Programmer’s Manual Extended System Commands TOF Bias / TOF Bias Reflective – Manual entry for the control of the minimum voltage required to detect the label. TOF Delta / TOF Delta Reflective – Manual entry for the control of the low level voltage difference level to recognize a label “gap” or “mark.” TOF Gain / TOF Gain Reflective – Manual entry for the control of the voltage to the LED emitter of the Media Sensor. STX KD Database Configuration This command, stored in Flash memory and retained for future power-ups, controls the printer’s environment and operates as a pseudo DIP switch. Syntax: KDwxyz Where: w, x, y, and z are binary values with respective bit settings as defined in the following tables. (Bit 0 is least significant.) Sample: KD@H@@ The sample configures the printer as follows: @ H @ @ Sets the communications to 9600 baud with an 8-bit word and no parity; Selects direct thermal printing, standard control characters, and enables the media cutter; Selects gap sensing; Is the default setting (items saved for future expansion). Note: The Ignore Host Distance setting (see below) allows the printer to disregard O and f commands; a feature provided for host system software that sends these commands with values that may be inappropriate for the printer and result in incorrect start of print and present distances. Use the KD command or the Setup Menu to enable this feature. E-Class DPL Programmer’s Manual 33 Extended System Commands KD Parameter w x y z 1 Bit Number Parameter Function Parameter Value(s) 0–2 BAUD Rate / Set Test Mode 3 4&5 6 7 0 1 2 3 4 5 6 7 0&1 2 3–5 6 7 0&1 2 3–5 6 7 Word Length and Parity Unused Always 1 Always 0 Print Method Present Sensor Control Character[1] Cutter Ignore Host Distance Alt-2 Control Codes[1] Always 1 Always 0 Paper Type (Media Sensor) Linerless Unused Always 1 Always 0 Reserved Reserved Unused Always 1 Always 0 0 = 9600, 1 = 600, 2 = 2400, 3 = 19200, 4 = 4800, 5 = 38400, 6 = 1200, 7 = 9600 Test Mode 0 = 8 bits, no parity; 1 = 7 bits, even parity Set to 0 Set to 1 Set to 0 0 = direct thermal, 1 = thermal transfer 0 = not equipped, 1 = equipped 0 = standard, 1 = alternate characters 0 = disabled, 1 = enabled 0 = disabled, 1 = enabled (See note above) 0 = disabled, 1 = alternate-2 characters Set to 1 Set to 0 0 = gap (edge), 1 = reflective, 2 = continuous 0 = not equipped, 1 = equipped Set to 0 Set to 1 Set to 0 Set to 0 Set to 0 Set to 0 Set to 1 Set to 0 Selects the values of the control characters; see Control Codes. Table 5-3: KD Configuration Commands STX KE Character Encoding This command is provided primarily as a means for users of 7-bit communication and to embed control characters and extended ASCII characters in their datastreams. Any character in the DPL datastream may be substituted with a delimited two-character ASCII hexadecimal numeric equivalent. The command allows the delimiting character to be selected, and the encoding to be enabled or disabled. When character encoding is enabled, the printer will decode any ASCII hexadecimal numeric pairs following the delimiter as single-byte values. Character encoding is used where control characters cannot be transmitted or where control characters within data may prematurely terminate a label format record. Although the delimiter may be changed at any time (except within a label format definition), there cannot be more than one defined delimiter, and character encoding must be disabled with KEN prior to re-enabling, regardless of any change in the delimiter. 34 Syntax: KEex Where: e - Y – character encoding enabled N – character encoding disabled x - Delimiter: one ASCII character (Do not include when e = N) E-Class DPL Programmer’s Manual Extended System Commands KEN KEY\ L 1u0000001200120[)>\1E\01\1D\...\04\ E Sample: The sample disables, then enables character encoding with the backslash (\) as the delimiter. A UPS Maxicode will be formatted using a data string interpreted as: [)>RS01GS... EOT ; then formatting is terminated. Character Encoding Syntax: This syntax requires at least two hexadecimal ASCII digits (0-9, A-F) delimited by the character specified in the KE command. The number of hexadecimal digits between the delimiter pair must be even; see notes below. Syntax: xaa[bbcc…nn]x Where: x - One byte delimiter, 0 to ff16, leading and trailing. aa - 2 bytes, ASCII, hexadecimal encoded, range each character 0-9, A-F bb - 2 bytes, ASCII, hexadecimal encoded, range each character 0-9, A-F (optional) cc - 2 bytes, ASCII, hexadecimal encoded, range each character 0-9, A-F (optional) nn - 2 bytes, ASCII, hexadecimal encoded, range each byte - 0-9, A-F (optional) Notes: (1) A delimiter pair with no ASCII hexadecimal pairs between (e.g., \\) will be interpreted as one byte whose value is that of the delimiting character, allowing the assigned delimiter to be interpreted as itself rather than as the delimiter. (2) A delimited string that contains either a non-valid hexadecimal character (e.g., FX) or an odd number of bytes will be treated as an illegal string and, therefore, not correctly decoded. Character Encoding Examples: In the following partial datastreams it is assumed that character encoding is enabled and that the selected delimiter, a backslash (\), has been transmitted to the printer (i.e., KEY\). In each example, the printer has not received an unpaired delimiter prior the example. Partial DPL Sample Datastream AB\\CE \ABCDEF\ 1A\1A\1A Interpretation 5 bytes AB\CE with values 4116, 4216, 5C16, 4316, 4416 3 bytes with values AB16, CD16, and EF16 5 bytes 1A1A with values 3116, 4116, 1A16, 3116, 4116. represents a single-byte ASCII control character with value 1A16 Alternate Control Codes with Alternate Line Terminator: Character Encoding can also be used with the Alternate Control Character set. Alternate Control Characters are enabled via a Setup Menu or the KD / Kc commands. See Control Codes. E-Class DPL Programmer’s Manual 35 Extended System Commands STX Kf Set Present Distance This command specifies an additional amount to advance the label after printing. This command has the same effect as the f command, but specifies a distance to advance relative to the start of print ( O command) of the next label. Syntax: Kfnnnn Where: nnnn Sample: