Apollo and A-Series Programming Guide August 2002 Copyright © Tharo Systems, Inc. Tharo Systems, Inc cab-Produkttechnik GmbH 2866 Nationwide Parkway Wilhelm-Schicklard-Str. 14 P.O. Box 798 76131 Karlsruhe Brunswick, Ohio 44212-0798 Deutschland Phone: (330)273-4408 Telefon: 721 / 66 26-0 Fax: (330)225-0099 Telefax: 721 / 66 26-259 Email: [email protected] Email: [email protected] http://www.tharo.com http://www.cabgmbh.com Copyright and Trademark Notices © 2002 by Tharo Systems, Inc. It is illegal to photocopy this manual or any portion of its content for any means or purpose without the publisher's permission. Fines of up to $10,000 may be imposed for violation. Speedo™ and Swiss™ are registered trademarks of Bitstream® Inc., U.S. Patent No. 5,099,435. All brand or product names are trademarks or registered trademarks of their respective companies. ===================================================================================== This page intentionally left blank ===================================================================================== Table of Contents _________________________________________________________________ Command Overview ................................................................................ 1 Command / Data Types...................................................................... 1 Command Syntax ............................................................................... 1 Command List..................................................................................... 2 Immediate Commands................................................................... 2 ESC Sequence Commands........................................................... 3 Label Format Commands............................................................... 4 Special Content Fields................................................................... 5 Print Orientation / Home Position for Commands............................... 8 __________________________________________________________________ Immediate Commands............................................................................. 9 Comment Line..................................................................................... 9 Start ASCII Dump............................................................................... 9 Direct Cut............................................................................................ 9 Download Data ...................................................................................10 Erase Data..........................................................................................12 Formfeed.............................................................................................12 Change Language/Country.................................................................13 Set Measuring Unit .............................................................................14 Pause Printer......................................................................................14 Query Printer.......................................................................................15 Reset Printer.......................................................................................16 Set Date/Time.....................................................................................16 Run Printer Self-Test ..........................................................................16 Firmware Version................................................................................17 Set Peripheral Signal Bits...................................................................17 Slashed Zero Selection.......................................................................18 __________________________________________________________________ ESC Sequence / Network Commands.....................................................19 __________________________________________________________________ Label Format Commands.........................................................................21 Amount of Labels................................................................................21 Bar Code Field Definition....................................................................23 Code 39.........................................................................................28 UPC-A............................................................................................29 UPC-E............................................................................................30 ===================================================================================== Table of Contents Bar Code Field Definition (cont.) 2 of 5 Interleaved........................................................................... 31 Code 128....................................................................................... 32 EAN-13/JAN-13............................................................................. 34 EAN-8/JAN-8................................................................................. 35 HIBC.............................................................................................. 36 Codabar ........................................................................................37 MSI Plessey.................................................................................. 38 Add-On 2....................................................................................... 39 Add-On 5....................................................................................... 40 Code 93......................................................................................... 41 Postnet.......................................................................................... 42 UCC128/EAN128.......................................................................... 43 FIM................................................................................................ 45 Maxicode....................................................................................... 46 DataMatrix..................................................................................... 48 Plessey.......................................................................................... 50 UPC-E0......................................................................................... 51 PDF417......................................................................................... 52 QR Code....................................................................................... 54 Cutter Parameters.............................................................................. 55 Global Object Offset........................................................................... 56 Define Files........................................................................................ 57 Font Number...................................................................................... 58 Graphic Field Definition...................................................................... 59 Circle............................................................................................. 60 Line ............................................................................................... 61 Rectangle...................................................................................... 63 Fill.................................................................................................. 64 Shade............................................................................................ 65 Outline........................................................................................... 66 Heat, Speed, Method of Printing........................................................ 67 Image Field Definition......................................................................... 68 Job Start............................................................................................. 69 Memory Card Access......................................................................... 70 Set Print Options................................................................................ 73 Set Peel-Off Mode.............................................................................. 74 Replace Field Contents...................................................................... 75 Set Label Size.................................................................................... 76 Text Field Definition............................................................................ 77 Internal Fonts................................................................................ 80 Examples....................................................................................... 83 Synchronous Peripheral Signal Settings............................................ 86 ===================================================================================== Table of Contents _________________________________________________________________ Special Content Fields ............................................................................87 Field Calculations and Comparisons...................................................94 __________________________________________________________________ Appendix A - Tables and Lists .................................................................96 UCC/EAN Application Identifiers.........................................................96 [U: ] Command - Common Control Codes..........................................98 __________________________________________________________________ Appendix B - Coding Examples ...............................................................99 Text File Label Coding Example.........................................................99 QBASIC Program Label Coding Example...........................................102 ESC Command Demonstration...........................................................104 Memory Card - QBASIC Programs and Text Files - Summary...........105 Memory Card - Front Panel Access....................................................107 Memory Card - Format, Display Info/Directory....................................108 Memory Card - Store Font..................................................................109 Memory Card - Store Image ...............................................................110 Memory Card - Database File.............................................................111 Memory Card - Serial File...................................................................112 Memory Card - Store Label.................................................................113 Memory Card - Store Label 2..............................................................114 Memory Card - Load Label Formats and Print....................................115 Memory Card - Print from Database...................................................116 Memory Card - Load Label Formats and Print....................................117 Memory Card - Operator Prompt........................................................118 Memory Card - Load Label Format and Print......................................120 Memory Card - Replace Existing Data................................................121 Memory Card - Incrementing Number from Operator Prompt.............122 Memory Card - Incrementing Serial Number from Serial File..............123 RS485 Network Card..........................................................................124 __________________________________________________________________ Index........................................................................................................126 ===================================================================================== This page intentionally left blank ===================================================================================== Command / Data Types There are three basic types of commands used on the Apollo printer, and one special type of data. Each of the following are described in separate sections of this manual: (cid:31) Immediate Commands are a single lower case letter. They perform a variety of printer functions. When the printer receives an Immediate command, it will immediately perform the command function, regardless of any other operation taking place. The effects of this command remain in place until the printer is reset. (cid:31) ESC Sequence Commands are a specialized group of commands frequently used for program control of network attached printers, when hands-on access to the control panel is not available. (cid:31) Label Format Commands are specified as a single upper case letter. They define the label and information to be printed on it, and are in effect for only one label job. (cid:31) Special Content Fields are used within Label Format commands. They consist of specific predefined words coded in brackets, [ ], that provide for various data insertion and data manipulation functions. Command Syntax (cid:32) No special characters are needed to create a label format. Any text editor may be used to enter commands. (cid:32) There is no strict format within a command. (cid:32) Where<CR> is shown, it may be a CR, a LF, or a CR/LF. (cid:32) For readability, parameters may be aligned with SPACES, TABS or additional ZEROES in numeric parameters. (cid:32) Parameters are separated with a comma or semicolon. (cid:32) Comment lines can be included by coding a semicolon (;) in the first position. (cid:32) Optional parameters are shown in command definitions within brackets [ ]. Special content fields are an exception - their optional fields are shown in { }. ===================================================================================== Command Overview 1 Command List Immediate Commands Description Page ; comment Comment line 9 a Start ASCII dump 9 c Direct cut 9 d type;name Downloads data 10 e type;name Erase data 12 f Formfeed 12 l name Change language/country 13 m unit Set measuring unit 14 p status Pause printer 14 q f Query free memory 15 q i;name Query image availability 15 q m Query memory type 15 q p Query peripheral types 15 q s;name Query scaleable font availability 15 r Reset printer 16 s datetime Set date/time 16 t Run printer self-test 16 v Request firmware version 17 x d;ao Set peripheral (x) bits directly 17 x e;ao Set peripheral (x) error value 18 x m;mask Set peripheral (x) mask bits 17 x s;ao Set peripheral (x) standby value 18 z option Slashed zero selection 18 ===================================================================================== 2 Command Overview