Datamax 7A300007 Rev. 2 manual

APEX & ANDES Series Printer Command Language Developer’s Manual 7A300007 Rev. 2[...]

[...]

Copyrights Datamax-O’Neil is a registered trademark of Datamax-O’Neil Bluetooth is registered trademark of Bluetooth SIG, Inc. Wi-Fi is a registered trademark of the Wi-Fi Alliance Windows is a registered trademark of Microsoft Corporation Zebra and Comtec are registered trademarks of Zebra Technologies All other trademarks are the property of [...]

Document Revision History Document Title : APEX and ANDES Series Printer Com mand Language Developer’s Manual Revision Date Revision History Revisions Since Last Issue 7/25/2008 Revision 1 Original Release 01/08/2013 Revision 2 Added QR Code and GS1 DataBar Barcode S ymbologies[...]

i CONTENTS Introduction ..............................................................................................................................1 Datamax-O’Neil Printer Command Language (ExPCL) .....................................................1 Communications ..............................................................................[...]

ii Download – Logo................................................................................................................ ....43 Download – Fonts............................................................................................................... ....44 Important Font Downloading Notes: .......................................[...]

1 Intr oduction This manual is intended to be used by software developers and syste m integrators with the purpose of developing applications that can print output results using Datamax-O’Neil wide range of mobile thermal printers. This section of the manual describes the various printer models, their main technical specifications and the communi[...]

2 Parenthesis is not part of the command unless specified otherwise: For example Esc K n CR Escape Sequence: ESC K 1 CR Hexadecimal: 1B 4B 31 0D Decimal: 27 75 49 13 Note that CR means Carriage Return control character. The following pages describe Datamax-O’Neil Command Language (ExPCL) components in more details. The commands have been grouped [...]

3 Character Set s Select Character Set Esc F n This command will select the character set that will be used when printing extended characters (Hexadecimal: 80 to FF; Decimal: 128 to 255). n Character Set 1 International Character Set 2 PC Line Drawing Character Set A 16 bit font (Asian tables) Example1: The following escape sequence will select the[...]

4 This command (ESC K n CR) must be sent prior to any printable characters on the line in order to take effect. Example 1: The following escape sequence set the pitch to 12 CPI (Courier Font): Escape Sequence: ESC K 1 CR Hexadecimal: 1B 4B 31 0D Decimal: 27 75 49 13 Example 2: The following escape sequence set the pitch to 25 CPI Verin Font: Escape[...]

5 Character Size and Line Spacing – W id th and Height Double Wide ON SO This command sets any printed characters to double wide. Control Code: SO Hexadecimal: 0E Decimal: 14 Double Wide OFF SI This command disables the double wide feature. Control Code: SI Hexadecimal: 0F Decimal: 15 Double High ON FS This command enables double high printing. T[...]

6 Character Attributes Emphasized Printing Mode ESC U n The Emphasized printing mode command will cause the printer to print text with bold appearance. n Selection 0 Emphasized M ode Off 1 Emphasized Mode On Note that on power up the printer defaults to emphasized mode off. Example1: The following escape sequence will enable the Emphasized printing[...]

7 Reverse Print ESC U n The reverse print command enables the user to print white letters on a black background .Reverse printing begins with the characters following the command. n Selection R Reverse printing ON n Reverse printing OFF Note that on power up the printer defaults to reverse printing off. Example1: The following escape sequence will [...]

8 Horizont al Position Carriage Return CR This command prints the input buffer information and advances the paper to the next line. If the printer buffer is empty a line is advanced. Control Code: CR Hexadecimal: 0D Decimal 13 Backspace BS This command removes the previous character from the print buffer. Control Code: BS Hexadecimal: 08 Decimal: 8[...]

9 V ertical Position Line Feed LF This command prints the input buffer information and advances the paper to the next line. Total Feed Length = Vertical size of the current font + Text Line Spacin g A Carriage Return (CR) is also performed to place the current print position at the beginning of the next line. Control Code: LF Hexadecimal: 0A Decima[...]

10 Set Vertical Tab Height ESC T V n This command sets the vertical tab length in dot lines. 0 ≤ n ≤ 255. The default value of the vertical tab is 203 dot lines. Example: The following escape sequence sets the vertical tab to ten millimeters. Each dot is 0.125 mm so to fixed the vertical distance of 10mm, the n parameter is 80 (10 / 0.125). Esc[...]

11 z bar code is non-human readable t barcode type. n number of character bytes in data array. 1 ≤ n ≤ 255 h height of bar code printed in i ncrements of 0.125mm data n characters to be encoded in the barcode. *The parameters for the PDF417 barcode diff er from the Linear Barcodes. See PDF-417 specifications for more detail. Note that all barco[...]

12 Code 128 Specifications Description Each symbol starts with Leading Quiet Zone, followed with Start Symb ol, Data Symbols, ending with Stop Symbol and Trailing Quiet Zone Character set Support for full 256 ASCII set among three subsets Elements per symbol 6 (3 bars, 3 spaces) Character density 9.1 CPI Bar width 0.25mm Characters per line 2 Inch [...]

13 Example 1: The following escape sequence prints alphanumeric bar code "A2a", 12.5mm high, wit h human readable text: n = 3 printed characters + 1 start character = 4 L = 12.5mm / 0.125mm = #100 start character = START B (full ASCII alpha numeric) = #136 Escape Sequence: Esc Z 2 4 d 88 A 2 a CR LF Hexadecimal: 1B 5A 32 04 64 88 41 32 60[...]

14 Interleaved 2 of 5 Specifications Description Each symbol starts with Leading Quiet Zone, followed with Start Symb ol, Data Symbols, ending with Stop Symbol and Trailing Quiet Zone Character set numeric pairs Elements per symbol 10 (5 bars, 5 spaces) Character density 1.11 CPI Bar width 25mm Characters per line 2 inch printer : 16 numeric (maxim[...]

15 Example 2: The following escape sequence will print a UPC-E bar co de with the following: human readable, 30 mm high, containing “1234565” where 5 is the check digit. Escape Sequence: ESC Z 4 7 240 1 2 3 4 5 6 CR LF Hexadecimal: 1B 5A 34 07 F0 31 32 33 34 35 36 0D 0A Decimal: 27 90 52 7 240 49 50 51 52 53 54 13 10 Example 3: The following es[...]

16 GS1 DataBar Specifications Description GS1 DataBar symbols can carr y mo re inf o rmati o n and identify small items than the current EAN/UPC bar code. GS1 DataBar enables GTIN identification for hard-to-mark products like fresh foods, jewelry and do-it-yourself hardware products and can carry GS1 Application Identifiers such as serial numbers, [...]

17 6) 1(SOH)-12(FF) - pixels per X 7) 0(NULL)-3(ETX) - X pixels to undercut 8) 0(NULL)-3(ETX) - Y pixels to undercut 9) 1(SOH)-12(FF) * 2 - separator row height 10) 2(STX)-22(SYN) - maximum segments per row (22 default). Note this entry is only applicable for RSS Expanded symbolog y 11) Data string Example: The following escape commands encode the [...]

18 27 90 54 3 13 1 0 0 1 22 49 50 51 52 53 54 55 56 57 48 49 50 51 Expected Result (not to scale): Example: The following escape commands encode the data “1234567890123” in RSS14 Stacked Omnidirection al Linear type. Due to space limitation CR LF are not shown Escape Sequence: <ESC> ‘ z’ ‘ 6’ <EOT> <EOT> <SOH> &l[...]

19 Expected Result (not to scale): Example: The following escape commands encode the data “12345678901” in UPC-A type. Due to space limitation CR LF are not shown Escape Sequence: <ESC> ‘ z’ ‘ 6’ <BEL> <VT> <SOH> <NUL> <NUL> <SOH> <SYN > ‘1’ ‘2’ ‘3’ ‘4’ ‘5’ ‘6’ ‘7[...]

20 Decimal: 27 90 54 9 12 1 0 0 1 22 49 50 51 52 53 54 55 56 57 48 49 50 Expected Result (not to scale): Example: The following escape commands encode the data “1234567” in EAN-8 type. Due to space limitation CR LF are not shown Escape Sequence: <ESC> ‘ z’ ‘ 6’ <LF> <BEL> <SOH> <NUL> <NUL> <SOH>[...]

21 Decimal: 27 90 54 12 12 1 0 0 1 22 49 50 51 52 53 54 55 56 57 48 49 50 Expected Result (not to scale): QR CODE Specifications Description The code consists of black modules (square dots) arranged in a square pattern on a white background. The information encoded may be made up of four standardized types ("modes") of data (numeric, alph[...]

22 'M' --- MANUAL If you specify AUTO you do not need to specify the char acter mode. If you specify MANUAL you will need to specify the char acter mode. 7) 0x00(NULL)-0xFF - MSB for a message length parameter 8) 0x00(NULL)-0xFF - LSB for a message length parameter Total Message Length = (MSB * 256) + LSB 9) '0'(0x30) - '4&[...]

23 Compaction Mode Description Encoding Capability ‘0’ (Future Use) B yte Compaction Mode (BC) All characters, (0-255) ‘1’ (Recommended) T ext Compaction Mode (TC) ASCII only, (0-127) + Shift to BC Mode is im plemented. ‘2’ (Future Use) Numeric Compaction Mode (NC) Digits Only, (‘0’-‘9’) A’ (Future Use) AUTO (combinations of a[...]

24 Example: The following escape commands encode the data “12345678”. Due to space limitation CR LF are not shown Escape Sequence: ESC z 9 1 2 0 0 2 6 0 8 1 2 3 4 5 6 7 8 Hexadecimal : 1B 7A 39 31 32 30 30 32 06 00 08 31 32 33 34 35 36 37 38 Decimal: 27 122 57 49 50 48 48 50 6 0 8 49 50 51 52 53 54 55 56 Barcode Height Multiplier ESC z h n This[...]

25 The following 8-bit graphic command is used to print a single line of graphic Escape Sequence: ESC V SOH NUL 72 bytes of da ta Hexadecimal: 1B 56 01 00 72 bytes of data Decimal: 27 86 1 0 72 bytes of data 8 Bit Compressed Graphics ESC v height width counter dat a [c data] [c data] … This command differs from the 8 Bit Graphics command describe[...]

26 This data may be represented in hexadecimal: 0x55 0x55 0x00 0x00 0xA A 0x11 0x55 0x00 0x55 0x55 0x55 0x55 The RLE compressed graphics command: ESC ‘v’ height width counter data… DEC 27 118 2 6 255 85 255 0 3 170 17 85 0 253 85 HEX 0x1B 0x76 0x02 0x06 0xF F 0x55 0xFF 0x00 0x03 0xAA 0x11 0x55 0x00 0xFD 0x55 Printer Contr ols – Dat a Pr oce[...]

27 Print Buffer Contents (Buffer Mode) EOT This command allows the printer to process all of the commands stored in the printer buffer. This command is valid only when the printer is in the buffer mode. Control Code: EOT Hexadecimal: 04 Decimal 04 Enable EOT Control Character Transmissi on (Currently Not Available) ESC P + When enabled, the printer[...]

28 Printer Contr ols - Reset Cancel CAN This command deletes the entire printer buffer and resets the printer to the power-up default values. Control Code: CAN Hexadecimal: 18 Decimal: 24 Reset printer and load default setup ESC @ This command initializes all programmable attributes to factory default values. Custom programming, present in flash me[...]

29 Example 1: The command Esc M 0 0 0 CR Disables the power out timer Example 2: The command Esc M 9 9 0 CR Sets the timer to 99 seconds Note that spaces are not part of the command Extended Auto Power Down Command ESC M HH MM SS 0 CR The ‘Set Auto Power Down’ command allows the user to program the printer to automatically shut down after a cer[...]

30 Printer S tatus Commands Query Print Buffer & Timer-MCR Status STX This command will cause the printer to print the battery status Printer Response Print Buffer Status ESC B <4 ASCII digits> CR LF Timer-MCR Status ESC M <4 ASC II digits> CR LF Note that the first three digits of the Timer-MCR field correspond to the printer times[...]

31 Query Printer Model and Hardware Revision Level ESC P ) This command will cause the printer to send the hardware model to the host. Escape Sequence: ESC P ) Hexadecimal: 1B 50 29 Decimal: 27 80 41 After sending the previous command, the printer will respond with the ASCII sequence: ASCII Sequence:<string> CR LF The <string> field rep[...]

32 Example: The following escape sequence sets the timer to 99 seconds and activates the MRC to read the track #1. Escape Sequence: ESC M 9 9 1 CR Hexadecimal: 1B 4D 39 39 31 0C Decimal: 27 77 57 57 49 13 or Escape Sequence: ESC m 9 9 1 CR Hexadecimal: 1B 6D 39 39 31 0C Decimal: 27 109 57 57 49 13 Magnetic Card Data Output Format The track data ret[...]

33 Cancel Magnetic Card Data Read Command ESC C This command cancels the MCR read process. The printer returns to online operation mode. Escape Sequence: ESC C Hexadecimal: 1B 43 Decimal: 27 67 Note that after executing this command the printer will send the message “, 09, Cancel Request” to the host. Black Mark Sensing Contr ol Commands Set Pa[...]

34 Black Mark Sensing Command Mode Forward Seek Black Mark ESC Q F n CR This command sets the printer to black mark seek mode using a forward feed operation. The value of forward feed is determined by the user in dot lines (n) where 0 ≤ n ≤ 255 dots. Each dot line corresponds to 0.250mm. If the black mark is found, the printer responds with the[...]

35 Enable Back Black Mark Sensor ESC Q b e CR This command will cause the printer to enable the back black mark sensor and automatically disables the front side sensor. Escape Sequence: ESC Q b e CR Hexadecimal: 1B 51 62 65 0D Decimal: 27 81 98 101 13 Disable Back Black Mark Sensor ES C Q b d CR This command will disable the printer’s back black [...]

36 Printed Receipt/Label Presenter Negative Adjust (*) ESC Q D – n This command will cause the printer to move the paper backwards to a distance specified by n dots after a form or label has been printed. Example: The following escape sequence will move the paper backwards 112 dots Escape Sequence: ESC Q D - 112 Hexadecimal: 1B 51 44 2D 70 Decima[...]

37 Mark Beginning of a Page BeginPage(); This command follows Esc P P command and is used to indicate the beginning of a form in page printing mode. Define the Page Size SetPageSize ( width , height ); This command is used to define the valid drawing area for a label or form. Two parameters are required: width and height of the form, measured in do[...]

38 Command Name Description <b>, </b> Bold Text enclosed by <b> and </b> appear i n bold. <u>, </u> Underline Text enclosed by <u> and </u> are underlin ed. <h = value> Text Height Text height is magnified by the given numeri c value. Use <h = 1> to return to original siz e. <w = value&[...]

39 Type Value Barcode type 1 Code 39 2 Code 128 3 Code 2 of 5 4 UPC 5 Codabar height Sets the height of barcode in units of dots data Specifies the content of the barcode. It is the user’s responsibilit y to supply data that is appropriate for the chosen code. For example, Cod e 39 will not acce pt lower case letters. R efer to the Barcode Specif[...]

40 Form Fiest a TM Form Fiesta is a Form and Label Generating Software that can be used to automate the label design process. It is provided to Datamax-O’Neil partners and customers at no charge. All supported commands are implemented in Form Fiesta and are automatically generated when an element is drawn onto the canvas on the screen. Developers[...]

41 Download - Printer Default Setup Select Setup Download mode ESC D S This command puts the printer into the Download mode. The printer will response with a ’?’ character. Escape Sequence: ESC D S Hexadecimal: 1B 44 53 Decimal: 27 68 83 Start Default downl oad process ESC S L This command alerts the printer that a file will now be downloaded. [...]

42 Download – Self test Message Hardwar e Information Select Setup Download mode ESC D S This command puts the printer into the Download mode. The printer will response with a ’?’ character. Escape Sequence: ESC D S Hexadecimal: 1B 44 53 Decimal: 27 68 83 Start Hardware Information download process ESC S I This command alerts the printer that[...]

43 Download – Logo The Graphic Logo feature allows the storage of a formatted Bitmap file in nonvolatile memory. Up to eight memory sectors, of u p to 64,000 bytes each, are reserved to store a Graphic Logo in the printer. Upon receipt of a Graphic Logo print command, the Graphic Logo data is sent to the printer. This feature allows printing of a[...]

44 Escape Sequence: ESC L g 1 Hexadecimal: 1B 4C 67 31 Decimal: 27 76 103 49 Example 2: The following example replaces logo location 1 with the logo image contained in logo.pr n file. The following escape commands must be sent sequentially and are necessary to complete logo d ownload. Escape sequence 1: ESC D L CR LF Escape sequence 2: ESC L G 1 CR[...]

45 Display Tables Information ESC D I CR Same description as the command directly above. This command is for Legacy printer’s compatibility. Escape Sequence: ESC D I CR Hexadecimal: 1B 44 49 0D Decimal: 27 68 73 13 Disable Font Download Mode ESC F X This command will disable the font download mode and put the printer in ready print mode. Escape S[...]

46 Select Load Operating Mode ESC F M m CR This command selects the load operating mode. Possible values for parameter m are ‘0’: Standard response or ‘1’ : Response with diagnostics message (default). Command String Command Description Printer Response m =1 Printer Response m =0 LED Status Esc-‘D’-‘F’ Enable font downloading ? ? Co[...]

47 Select Font Row ESC F F f CR This command selects the row value for the font tables. The parameter f can be set in the range of ‘0’ to ‘9’ Select Font Column ESC F K k CR This command selects the column value for the font tables. The parameter k can be set in the range of ‘0’ to ‘9’ Select File Type ESC F L t CR This command sele[...]

48 Example 1: BBX 08 23 0 0 BITMAP 0008 000F INCORRECT 0002 0003 Example 2: BBX 08 23 0 0 BITMAP 08 0F CORRECT 02 03 The name of the font is indicated at the beginning of the .BDF file, therefore: FONT Font12C.BDF. If only the file is renamed, the firmware will not recognize it; in this case, the .BDF file must be opened and the file name must be c[...]

49 Bluetooth™ & W iFi Setup Command Datamax-O’Neil printers can be placed in pass-thru mode. In pass-thru mode, data communication will only o ccur between the two selected UARTS. This mode of operation is used to setup the Bluetooth ™ or 802.11b/g interface parameters. While in this mode, printing is disabled. Select Pass-Thru Command Mo[...]

50 Emulation The printer’s default mode of operation of Datamax-O’Neil Printers is the Datamax-O’Neil Printer Command Language (ExPCL). The emulations offered by Datamax-O’Neil Printers allow compatibility with printing systems and software created for printers offered by other mobile printer’s manufacturers. The Datamax-O’Neil printers[...]

51 Esc C n This command is ignor ed by the Datamax-O’Neil pr inter. It is recognized but no action is taken Esc A n This command sets the number of blank dot lines that are fed bet ween character lines. “n” is the number of interline spacing Originally n = (0x01..0x9B) in our versi on however n = (0x01..0x0A). CA N (^ X) Cancels the unprinted[...]

52 Communications Settings Dip Switch Settings The Datamax-O’Neil printers support Serial RS232, IrDA compatible infrared communication interfac es and USB* 1 .Bluetooth ™ and Wi-Fi communication are also available as an optional feature. Serial/USB IrDA, Wi-Fi and Bluetooth ™ communication settings can be changed via a DIP switch located on [...]

53 Serial Communication (RS232C) The RS232C Interface signals for the Datamax-O’Neil printers are terminated on a 6 PIN RJ type data connector located on the side of the printer. Six connections are provided from the Serial Interface to the host computer. A minimum of two connections are required for operation, RXD – pin 3 and Common – pin 1.[...]

54 RS232C Technical Specifications Name Value Data Transfer Rate 1200 – 115200 Baud Word Length 10 or 11 bits Start Bit 1 Data Bits 8 Parity Bit None, Odd or Even Stop Bits Auto Select 1 or 2 Signal Levels RS232C Mark or Logical 1 -3 to -15 VDC Space or Logical 0 + 3 to + 15 VDC Handshaking Two modes are supported (Soft ware and Hardware) Hardwar[...]

55 Software Driver Installation You must install the USB driver before you can use USB communication on the printer. Turn on the printer and connect it to the PC with a USB cable. If the driver has never been installed befor e, a dialog box will appear. Reply by selecting "I nstall from a list or specific location" and indicating the loca[...]

56 Settings Value Name APEX#, w here # matches the printer model Serial Settings 115200,8,n,2,n USB Settings 57600, 8, n, 2, n Discoverability mode Generally Discoverable Connectivity mode GAP Connectable Security mode Security Disabled Fixed PIN 0 (Zero) Set Master/Slave Policy Al ways let the connecting device select the master/slave role on inco[...]

57 W i-Fi Communication (Option) The printer control card communicates with the Wi-Fi interface at 115.2 K Baud/sec for serial interface printers and 57.6 K for USB interface printers. To select the WiFi interface, Dip Switch # 1 or Dip Switch # 2 (See Dip Switch Settings ta ble above) must be ON and all other Dip Switches must be OFF. Below are th[...]

58 Error/ Warning LED Panel LED # LED Color/ Status Description Action Required LED # 1 Communication RED/ Steady Low power indication: Charge battery (#1) GREEN/ Flashing (#3) RED/ Flashing Printer is in RS232 or USB mode and Printer Buffer is not empty. Press Feed to clear error. Cycling printer power will result in printer buffer data loss. LED [...]

59 Appendix A: Flash Font T ables The tables below show the Font Table organization in the Data max-O’Neil Printers. There are two classes of font tables: Replaceable and Factory Fonts. Please note each font table represents either the first or the second half of a font, not the complete 255 character set. Replaceable Fonts Tables The fonts in Re[...]

60 Courier International Font Table Courier PC Line Graphic Table[...]

61 Monospace Font Table Rotated Font Table[...]