Datamax DGL Programmer'S Reference Manual Download Page 2

Summary of Contents for DGL

Page 1: ...Printer Protocol Interpreter PPI DGL Programmer s Reference Manual for DGL a Datamax DPL Printer Protocol Interpreter Thermal Series Printers ...

Page 2: ......

Page 3: ...Printer Protocol Interpreter PPI DGL Programmer s Reference Manual for DGL a Datamax DPL Printer Protocol Interpreter Thermal Series Printers ...

Page 4: ...a trademark and Datamax is a registered trademark of Datamax Technologies Corporation PPI is a trademark of Printronix Inc Printronix and PSA are registered trademarks of Printronix Inc COPYRIGHT 2006 PRINTRONIX INC All rights reserved ...

Page 5: ...ertical DPI Adjust 16 Command Ignore Menus 16 Length Cmd STXc 16 Heat Cmd H 16 Speed CMD P S 16 Cut Cmd o c 16 Soft Switch V 16 Sensor Cmd e r 16 Format Attr A 16 2 Fully Supported Commands 17 System Level Command Functions 17 STX A Set Time and Date 17 STX a Enable Feedback Characters 17 STX B Get Printer Time and Date Information 17 STX c Set Continuous Paper Length 17 STX E Set Quantity For Sto...

Page 6: ...Module Information 20 STX X Set Default Module 20 STX x Delete File from Module 20 STX y Select Font Symbol Set 20 Label Formatting Command Functions 20 Set Cut By Amount 20 Make Last Field Entered Increment Numeric Alphanumeric 21 Make Last Field Entered Decrement Numeric Alphanumeric 21 Set Count by Amount 21 A Set Format Attribute 21 B Barcode Magnification 21 C Set Column Offset Amount 21 c Se...

Page 7: ... Descriptor 25 ESC c E Character Code 25 ESC s W Character Download Data 25 Barcode Symbologies 25 3 Command Enhancements And Differences 27 SOH Reset 27 SOH Reset 27 SOH A Send ASCII Status String 27 SOH B Toggle Pause 27 SOH C Stop Cancel 27 SOH D SOH Shutdown 27 SOH E Send Batch Quantity 28 SOH F Send Status Byte 28 SOH U Update System Database with Current Database 28 STX J Set Pause for Each ...

Page 8: ...d Dot Pattern Test Label 31 STX t Test RAM Memory Module 31 STX w Test Flash Memory Module 31 STX Y Output Sensor Values 31 STX Z Print Internal Information 32 STX z Pack Module 32 STX b Set Cutter signal time 32 STX C Copy Module 32 STX D Memory Dump Test Mode Only 32 STX d Set Printer to double buffer mode 32 STX g Internal Batch Software Mode 32 STX N Enter Internal Batch 32 STX s Set Printer t...

Page 9: ...ions 41 Cutter Commands 41 Emulations 42 Printer Configuration 42 Command Reference 42 A Configuration Setting Compatibility 45 B Contact Information 53 Printronix Customer Support Center 53 Printronix Supplies Department 53 Corporate Offices 54 ...

Page 10: ...Table of Contents ...

Page 11: ...lete printer protocol operation NOTE When substituting a Datamax printer with an SL5000r T5000r printer refer to DGL Menu Conversions on page 45 Coax Twinax Interface Requirements If you are using a coax or twinax interface you must select the correct control code in the DGL configuration menu Refer to the Coax Twinax Programmer s Reference Manual and your printer User s Manual for instructions on...

Page 12: ...anish Swedish English Ascii Win3 0 Latin 1 Win3 1 Latin 1 Win3 1 Latin 2 Win3 1 Latin 5 Danish Norweg 8859 1 Latin 1 8859 2 Latin 2 8859 5 Latin 5 Euro Character 128 0 255 2 0 255 CC STX 1 CC ESC 1 27 0 255 CC CNT 1 94 0 255 CC CR 1 13 0 255 Legal Code Page 852 Code page 850 Alternate2 User Defined Notes Factory Default 1 These menus are only present when User Defined is selected in the Control Co...

Page 13: ... Con t Process Heat CMD H 2 Notes Factory Default 1 These menus are only present when User Defined is selected in the Control Codes menu 2 These menus are only present when Admin User is set to Enable in the PRINTER CONTROL menu Ignore 0 100 to 100 dots Row Offset 0 0 99 99 Inch Column Offset 0 0 99 99 inch Format Attrib XOR Transparent Error Handling Off Report Opaque Beep Process Speed CMD P S 2...

Page 14: ...or invalid characters the printer responds with Hex 07 BEL Enabled Feedback characters are sent to the host Disabled No feedback characters are sent The default is Disabled Default Module Sets the default module used to store files when no module or default module is specified in the command See Chapter 3 for further details RAM Flash The default is RAM Units of Measure Sets the printer to interpr...

Page 15: ...ping text and graphics are treated as the label is printed XOR Intersecting text strings images and barcodes print on top of one another Transparent Intersecting text strings images and bar codes will not be printed An odd number of overlapping objects will print Opaque Intersecting text strings images and barcodes are obliterated by those formatted last Each character cell is treated as opaque Th...

Page 16: ... several configuration commands in the host data This allows using their corresponding front panel settings without being overridden by host commands The default is to process all commands Length Cmd STXc Allows the user to disable the Length Command Heat Cmd H Allows the user to disable the Heat Command Speed CMD P S Allows the user to disable the speed commands Print Feed and Reverse Cut Cmd o c...

Page 17: ...ength This command is used to define the page label size when printing on continuous media It disables the media sensor top of form function but continues to monitor paper out conditions STX E Set Quantity For Stored Label This command sets the number of labels to print for the label format currently stored in the print buffer The printer automatically stores the most recent label format in the bu...

Page 18: ...ith 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 This command is used where control characters cannot be transmitted or where control chara...

Page 19: ...er to clear all of the Flash RAM and Internal Modules STX q Clear Module This command clears the selected memory module Flash or RAM STX r Select Reflective Sensor This command selects the reflective media sensor for top of form detection of reflective stock e g fan folded tags with carbon based black marks printed along the underside of the media The end of the black mark determines label TOF Lab...

Page 20: ...ation 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 STX X Set Default Module This command is used when downloading information to a module memory It is designed to allow the user to select between modules If C is entered to select a memory bank the data will g...

Page 21: ...rder to make the field decrement alphabetically rather than numerically This command has effect on only the label format record that it follows It is intended for use in conjunction with the label batch quantity Q or the System Level Commands for quantity and reprint STX E and STX G Set Count by Amount An application using incrementing or decrementing fields will occasionally require that more tha...

Page 22: ...ved the printer will generate and feed a label other termination commands are X and s Commands sent to the printer after a terminate label command must be Status and Control System Level or Font Download type F Advanced Font Attributes These commends extend the text presentation capabilities for Scalable Fonts The format attribute allows a set of label format records to select Bolding Italicizing ...

Page 23: ...de Menu selectable n Set Inch Mode Imperial This command sets the printer to measure in inches When this command is sent all measurements will change to inches All printers default to Imperial units Menu selectable P Set Print Speed This command sets a print speed for a label or batch of labels Q Set Quantity Of Labels To Print This command sets the number of the label copies to be printed All pri...

Page 24: ...egister loading the command only controls the way the bit mapped data is formatted The data used when it is created must be valid for the font type being used If the command is used only the changing data will be reformatted if this command is not used the entire label will be formatted The U command is used in conjunction with the STX U command to reformat only portions of a label resulting in fa...

Page 25: ...d encoded and or the string may now be terminated by a STX command followed by data terminated by a CR Font Loading Command Functions ESC c D Assign Font ID Number This command is the first command required for downloading a font to either RAM or Flash Memory modules ESC represents the ASCII control character 27 ESC s W Font Descriptor This command typically first data in a font file contains all ...

Page 26: ...upported Commands S 1 UCC EAN Code 128 Random Weight See Partially Supported Commands T 1 Telepen u UPS MaxiCode Modes 2 3 See Partially Supported Commands U UPS MaxiCode Modes 2 3 with Byte Count Specifier See Partially Supported Commands v FIM Z PDF 417 Z PDF 417 with Byte Count Specifier W1c DataMatrix W1C DataMatrix with Byte Count Specifier W1f Aztec W1f Aztec with Byte Count W1g and W1G USD ...

Page 27: ...ent printer status The printer returns a string of eight characters to the host followed by a carriage return Each character is either a Y or N indicating that the associated condition is true Y or false N Byte 1 is the first character transmitted by the printer See SOH F Not supported SOH B Toggle Pause This command toggles the printer s paused state on and off This is the same function achieved ...

Page 28: ... pause after printing each label and is intended for use with the optional Peel and Present Mechanism or with a Tear Bar when no Present Sensor is installed After removing the printed label the PAUSE button must be pushed in order to print the next label The printer must be reset to clear the STX J command Not supported STX KC Get Configuration This command returns the configuration of the printer...

Page 29: ...ory configuration to the host device The transmitted data provides information regarding the total amount of installed internal DRAM the amount available for configuration and the amount currently assigned to specific functions or entities Reported values are not all actual values STX Kq Query Memory Configuration new format This command causes the printer to transmit its internal DRAM memory conf...

Page 30: ... travel this distance in search of top of form label edge notch black mark etc before declaring a paper out fault The fault condition can occur if this value is set too close to the physical length of the label within 0 1inch 2 54mm Therefore it is good practice to set this value at 2 5 to 3 times the actual label length used The minimum value should be at least 5 127mm Not supported STX O Set Sta...

Page 31: ...he printer must be set to thermal transfer ribbon printing mode Not supported STX T Printhead Dot Pattern Test Label This command instructs the printer to print a dot pattern test label To view all dots the labels must be at least four inches 102mm long and as wide as the maximum print width Not supported STX t Test RAM Memory Module This command tests all RAM modules however the printer must be i...

Page 32: ...rted STX b Set Cutter signal time Obsolete System Command STX C Copy Module Obsolete System Command STX D Memory Dump Test Mode Only Obsolete System Command STX d Set Printer to double buffer mode Obsolete System Command STX g Internal Batch Software Mode Obsolete System Command STX N Enter Internal Batch Obsolete System Command STX s Set Printer to single buffer mode Obsolete System Command e Rec...

Page 33: ...t Not supported W Wait mode Prodigy only Obsolete System Command Z Zip Mode Prodigy only Obsolete System Command Print Area When looking at the front of the printer the origin of the label is positioned at the bottom left of the label and extends up and to the right The label length for continuous labels can be set in the Menu and through the STX cnnnn command On Datamax printers the print width i...

Page 34: ...ter 3 Fonts See the tables below for the different types of fonts that will be available All Single Byte fonts will be supported and will be available in DGL by default Double Byte support has not been planned ...

Page 35: ... 1 300 19 10 3 4 6 138 characteralphanumericupper andlowercase font 203 18 10 2 6 4 2 300 27 15 3 6 5 62 character alphanumeric uppercase font 203 27 14 2 9 6 3 300 40 21 3 9 6 62 character alphanumeric uppercase font 203 36 18 3 12 8 4 300 53 27 4 12 7 62 character alphanumeric uppercase font 203 52 18 3 18 4 5 300 77 27 4 18 5 62 character alphanumeric uppercase font 203 64 32 4 22 7 6 300 95 47...

Page 36: ... Fonts A04 A72 1 000 010 1 CG Triumvirate Bit Mapped Smooth Font Point sizes 4 5 6 8 10 12 14 18 24 30 36 48 and 72 Scalable Resident Fonts standard S00 CG Triumvirate Bold Condensed S01 CG Triumvirate Scalable Resident Fonts optional SA0 CG Times SA1 CG Times Italic SA2 CG Times Bold SA3 CG Times Bold Italic U40 Gothic B Kanji Double Byte Binary u40 Gothic B Kanji Double Byte Hex ASCII UC0 GB Sim...

Page 37: ...ble below for an overview of the available codepages Additional info and print samples can be found in the Class Series Programmers Manual Appendix E and I Codepages used by Scalable Fonts Font Valid ASCII Characters decimal Euro Char 0 32 127 255 1 2 32 168 171 172 225 255 3 4 5 6 32 35 38 40 58 65 90 128 142 144 146 153 154 156 157 165 168 225 255 7 32 126 N A 8 32 48 57 60 62 67 69 78 83 84 88 ...

Page 38: ...r as separate commands Dot Size Label formatting command Dwh can be used to change the size of a printed dot hence the print resolution dots per inch DPI NOTE The dot size does not affect all printed objects Barcodes are only affected in horizontal direction Barcode PDF affected in both directions Graphics are not affected at all Barcode Symbologies The sections below list the limitations for the ...

Page 39: ...h is 14 so problems are not expected PostNet Datamax has a slightly larger width for the first space in the start character all other sizes match exactly MaxiCode The postal code can have a length of up to 9 digits and up to 6 for alphanumeric on Datamax DGL however always encodes using exactly 6 or 9 When less than 6 alphanumeric bytes are provided trailing spaces will be added and trailing zeros...

Page 40: ...cles NOTE Only Lines and boxes will be supported by DGL Flash Ram Module compatibility DPL can store read several different types of objects to separate modules and perform operations on these modules Objects that can be stored to modules can be Labels Images Scalable or Bitmap fonts ID Format Comp F 7 bit Datamax image load file F B BMP 8 bit format image will be flipped black white F b BMP 8 bit...

Page 41: ...its current operation will be momentarily interrupted to respond to the command Status and Control Commands may be issued before or after System Level Commands however they cannot be issued among a Label Formatting Commands b during font downloading or c during image downloading Commands that require immediate action including commands that request immediate response will not be supported Non time...

Page 42: ...mands affecting the printer configuration will be ignored DGL has its own configuration management to save load configuration settings that can be used instead See table below for the affected commands all ignored Command Reference The following sections explain why certain commands are partially supported or ignored Ignored Commands STX Kb Backfeed Time Delay STX K Top of Form Offset Distance STX...

Page 43: ... still print the whole job by spanning it across multiple physical pages DGL will clip the job at the configured physical page length Workaround SOH U Update System Database with Current Database STX KC Get Configuration STX Kc Set Configuration STX Kd Set File as Factory Defaults STX KF Select Factory Defaults STX KQ Query Memory Configuration STX Kq Query Memory Configuration new format STX Kx D...

Page 44: ... Dot Pattern Labels DIAGNOSTICS Printer Tests STX J Set Pause for each label STX p Controlled Pause These commands can be supported by using PAA to filter out the commands and have GPIO put the printer in Single Label Mode A panel key can then be assigned by GPIO to either print the next label for STX J or disable pause mode again for STX p Partially Supported Commands STX t Test DRAM Memory Modul...

Page 45: ... Selects the top of form TOF sensingmethod for the media GAP CONTINUOUS REFLECTIVE CALIBRATE CTRL Gap Mark Sensor Disable Mark Gap Advanced Gap Advanced Notch LABEL LENGTH When the Sensor Type is set to Continuous this value is used to determine the TOF 04 00in 0 99 99 MEDIA CONTROL Label Length 04 0 or 06 0 00 1 to 99 0 inches MAXIMUM LABEL LENGTH Sets the maximum length between TOF marks gap or ...

Page 46: ... 3 15 to 15 PRINT SPEED Controls the rate of label movement during the printing process 6 2 12 ips Controls the rate of label movement during the printing process 6 2 12 ips FEED SPEED Controls the rate of label movement between printing areas 6 2 12 ips MEDIA CONTROL Slew Speed Automatic Manual 6 ips 1 10 ips REVERSE SPEED Controls the rate of label movement during backup positioning for start of...

Page 47: ... available modules PRINTER CONTROL Print File List PRINT FILE The user may select from a list of available files for sample printing N A FORMAT MODULE The user may select from a list of available modules for formatting all data will be erased N A DELETE FILE The user may select from a list of available files for deleting PRINTER CONTROL Delete Files PACK MODULE Packing the module removes files mar...

Page 48: ...rovides a list of available configuration files Selecting a file from the list causes a printer reset afterward the printer is configured according to the activated file CONFIG CONTROL Load Config SAVE SETTING AS Saves the entire effective configuration of the printer to a file CONFIG CONTROL Save Config DELETE FILE Provides a list of available configuration files to delete CONFIG CONTROL Delete C...

Page 49: ...er of inches printed since being set at the factory DIAGNOSTICS Ptr Media Dist RESETTABLE COUNTER The number of inches printed since the last reset DIAGNOSTICS Head Print Dist RESET COUNTER Resets the Resettable Counter to zero DIAGNOSTICS Reset Head Data PRINT CONFIGURATION Prints the effective configuration of the system CONFIG CONTROL Print Config Current CONFIGURATION LEVEL To upgrade the appl...

Page 50: ...ABLED MEDIA CONTROL Media Handling Tear off or Peel off SECURITY Provides the user with the ability to password protect all printer settings made through the front panel ENABLED DISABLED MODIFY PASSWORD PRINTER CONTROL Set Lock Key UNITS OF MEASURE Selects the measurement system in which the system s settings are represented in the menu system and on configuration labels METRIC IMPERIAL PPI DGL SE...

Page 51: ...operator and the printer N A Table 4 System Settings Menu Datamax Setting Description PTX Setting Table 5 Communications Menu Datamax Setting Description PTX Setting SERIAL PORT A SERIAL PORT B Controls the communications settings for the Serial Ports SERIAL PORT PARALLEL PORT A PARALLEL PORT B Controls the communications settings for the Parallel Ports PARALLEL PORT NIC ADAPTER Controls the commu...

Page 52: ...D N A HEAT COMMAND SPEED COMMANDS Allows the user to disable the DPL Heat and Speed Commands ENABLED DISABLED PPI DGL SETUP Heat Cmd Speed Cmd Process Ignore Table 5 Communications Menu Datamax Setting Description PTX Setting Table 6 Diagnostics Menu Datamax Setting Description PTX Setting HEX DUMP MODE Prints data and instructions received from the host rather than interpreting them as label form...

Page 53: ... the control panel then press Enter Is the problem with a new install or an existing printer Description of the problem be specific Good and bad samples that clearly show the problem faxing of these samples may be required Americas 714 368 2686 Europe Middle East and Africa 31 24 6489 410 Asia Pacific 65 6548 4114 http www printronix com public servicessupport default aspx Printronix Supplies Depa...

Page 54: ...2300 Fax 714 368 2600 Printronix Inc Nederland BV P O Box 163 Nieuweweg 283 NL 6600 Ad Wijchen The Netherlands Phone 31 24 6489489 Fax 31 24 6489499 Printronix Schweiz GmbH 42 Changi South Street 1 Changi South Industrial Estate Singapore 486763 Phone 65 6542 0110 Fax 65 6546 1588 Visit the Printronix web site at www printronix com ...

Page 55: ......

Page 56: ...250103 001B 250103 001 ...

Reviews: