Programmers Guide 980415-001 Rev B
Programmers Guide 980415-001 Rev B
Programmers Guide 980415-001 Rev B
This manual contains Programming information for Zebra Series Card Printers manufactured by Zebra Technologies Corporation, Camarillo, California.
COPYRIGHT NOTICE
This document contains information proprietary to Zebra Technologies Corporation. This document and the information contained within is copyrighted by Zebra Technologies Corporation and may not be duplicated in full or in part by any person without written approval from Zebra. While every effort has been made to keep the information contained within current and accurate as of the date of publication, no guarantee is given or implied that the document is error-free or that it is accurate with regard to any specification. Zebra reserves the right to make changes, for the purpose of product improvement, at any time.
TRADEMARKS
Zebra is a trademark of Zebra Technologies. Windows and MS-DOS are registered trademarks of Microsoft Corp. All other marks are trademarks or registered trademarks of their respective holders.
980415-001 Rev.B
iii
Table of Contents
INTRODUCTION . . . . . . . . . . . . . . . . . . . . . . . . . 1-1 Common Features . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-2 Programming Objectives . . . . . . . . . . . . . . . . . . . . . . . . . 1-2 Basic Command Syntax . . . . . . . . . . . . . . . . . . . . . . . . . 1-7 Command Editor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-8 Image Memory Arrangements . . . . . . . . . . . . . . . . . . . . . . 1-8 Bit-Map Compression Algorithm . . . . . . . . . . . . . . . . . . . . 1-10 Data-to-Card Mapping . . . . . . . . . . . . . . . . . . . . . . . . . 1-13 Control Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-18 Card Handling Process . . . . . . . . . . . . . . . . . . . . . . . . . 1-19 Command Linking . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-20 Sample Card . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-20 Parallel Port Signals . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-21 Error Line Coding . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-21 COMMAND REFERENCE . . . . . . . . . . . . . . . . . . . . . 2-1 . Command - Clear Error Status Lines . . . . . . . . . . . . . . . . . 2-7 &B Command - Write Buffer Single Track . . . . . . . . . . . . . . . 2-8 &C Command - Set Coercivity . . . . . . . . . . . . . . . . . . . . . 2-9 &CDER Command - Read Custom Track Data . . . . . . . . . . . . 2-10 &CDEW Command - Write Custom Track Data . . . . . . . . . . . 2-12 &D Command - Change Track Density . . . . . . . . . . . . . . . . 2-14 &E Command - Write Single Track . . . . . . . . . . . . . . . . . . 2-15 &E* Command - Write Track Buffers . . . . . . . . . . . . . . . . . 2-16 &L Command - Read Single Track . . . . . . . . . . . . . . . . . . 2-17 &P Command - Check Card Present - Encoder . . . . . . . . . . . . 2-18 &R Command - Reset Magnetic Encoder . . . . . . . . . . . . . . . 2-19 &SVM Command - Disable/Enable Magnetic Encoding Verifications . 2-20 &T Command - Mag. Encoder Card Eject . . . . . . . . . . . . . . 2-21 &W Command - Change Encoding Direction . . . . . . . . . . . . . 2-22 $F Command - Clear Color Image Buffers . . . . . . . . . . . . . . 2-23 $FP Command - Clear Specified Bit-Maps . . . . . . . . . . . . . . 2-24 !AO Command- Check Patch Sensors. . . . . . . . . . . . . . . . . 2-25 Command !AT - Check Heat Offset . . . . . . . . . . . . . . . . . . 2-26 !CCLN Command - Check Cleaning Parameters . . . . . . . . . . . 2-27 !CT Command - Check Cooling Time . . . . . . . . . . . . . . . . . 2-28 !D Command - Move Print Head Down . . . . . . . . . . . . . . . . 2-29 !FF Command - Set Ribbon Color Sequence . . . . . . . . . . . . . 2-30 !L Command - Check Sensor Levels . . . . . . . . . . . . . . . . . 2-31 !LC Command - Check Lamination Counter . . . . . . . . . . . . . 2-32 !LT Command - Check Lamination Temperature . . . . . . . . . . . 2-33 !LTI Command - Check Lamination Time. . . . . . . . . . . . . . . 2-34 !M Command - Move Print Head Up . . . . . . . . . . . . . . . . . 2-35 !O Command - Check Card Offset . . . . . . . . . . . . . . . . . . 2-36 !OFP Command - Check X-Axis Patch Offset . . . . . . . . . . . . . 2-37
iv
980415-001 Rev.B
!OP Command - Check Patch Offsets. . . . . . . . . . . . . . . !R Command - Print Head Resistance . . . . . . . . . . . . . . !RIBBON Command - Check Ribbon Type . . . . . . . . . . . . !RLEVEL Command - Check Patches Remaining. . . . . . . . . !SA Command - Self Adjust. . . . . . . . . . . . . . . . . . . . !SERIE Command - Get Serial Number. . . . . . . . . . . . . . !SIDE Command - Check Lamination Mode . . . . . . . . . . . !SB Command - Check Stand-By Mode Settings . . . . . . . . . !V Command - Return Operational Parameter . . . . . . . . . . !X Command - Check Command Initiator . . . . . . . . . . . . %CLN Command - Check Due-for-Cleaning Parameters . . . . . %F Command - Return Font Names . . . . . . . . . . . . . . . %N Command - Return Number of Loaded Fonts . . . . . . . . %NLOGO Command - Return Name of Logo . . . . . . . . . . +$C Command - Adjust Color Contrast . . . . . . . . . . . . . +$L Command - Adjust Specified Color Intensity . . . . . . . . +B Command - Serial Interface Rate . . . . . . . . . . . . . . . +BS Command - Set Black Speed . . . . . . . . . . . . . . . . +C Command - Adjusts Monochrome Intensity . . . . . . . . . +CCLN Command - Set Cleaning Parameters . . . . . . . . . . +CDOTS Command - Image Print Quality Compensation Factor +CH Command - Adjust Hologram Intensity . . . . . . . . . . . +CT Command - Set Cooling Time . . . . . . . . . . . . . . . +CV Command - Adjust Clear Varnish Intensity . . . . . . . . . +DLAMI Command - Set Lamination Configuration . . . . . . . +EC Command - End of Print . . . . . . . . . . . . . . . . . . +LC Command - Set Lamination Counter . . . . . . . . . . . . +LT Command - Set Lamination Temperature. . . . . . . . . . +LTI Command - Set Lamination Time . . . . . . . . . . . . . +O Command - Print Offset X-Axis. . . . . . . . . . . . . . . . +OCL Command - Offset Contactless . . . . . . . . . . . . . . +OFP Command - Adjust X-Axis Patch Offset . . . . . . . . . . +OLP Command - Offset Overlaminate Patch . . . . . . . . . . +OP Command - Adjust Patch X and Y Offset . . . . . . . . . . +OS Command - Smart Card Y-axis Offset . . . . . . . . . . . +OY Command - Print Offset Y-axis . . . . . . . . . . . . . . . +RB Command - Set Rejected Box. . . . . . . . . . . . . . . . +RIB Command - Set Ribbon Type . . . . . . . . . . . . . . . +RIBBON Command - Set Ribbon Type . . . . . . . . . . . . . +RO Command - X-Axis Offset, Relative . . . . . . . . . . . . . +ROY Command - Y-Axis Offet, Relative . . . . . . . . . . . . +SB Command - Set Stand-By Mode . . . . . . . . . . . . . . +SIDE Command - Set Lamination Mode . . . . . . . . . . . . +TC Command - Set Temperature . . . . . . . . . . . . . . . . +V Command - Black Print Speed . . . . . . . . . . . . . . . . +VL Command - Set Lamination Speed . . . . . . . . . . . . . +X Command - Change Command Initiator . . . . . . . . . . . A Command - Print Test Card . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
2-38 2-39 2-40 2-41 2-42 2-43 2-44 2-45 2-46 2-47 2-48 2-49 2-50 2-51 2-52 2-53 2-54 2-55 2-56 2-57 2-58 2-59 2-60 2-61 2-62 2-67 2-68 2-69 2-70 2-71 2-72 2-73 2-74 2-75 2-76 2-77 2-78 2-79 2-81 2-82 2-83 2-84 2-85 2-86 2-87 2-88 2-89 2-90
980415-001 Rev.B
B/vB Command - Write Bar Code. . . . . . . . . . . . . . . . . . . 2-91 C/vC Command - Write Box (Monochrome) . . . . . . . . . . . . . 2-93 CHECK Command - Return Checksum . . . . . . . . . . . . . . . . 2-94 CLEAN Command - Start Cleaning Card Sequence. . . . . . . . . . 2-95 CLNCARD Command - Establish Cleaning Card Sequence . . . . . . 2-96 CRB Command - Set Counter for Rejected Box. . . . . . . . . . . . 2-97 D/vD Commands - Write Diagonal (Monochrome) . . . . . . . . . . 2-98 DFONT Command - Download Font . . . . . . . . . . . . . . . . . 2-99 DLOGO Command - Download Logo . . . . . . . . . . . . . . . . 2-100 E Command - Retransmit Last Response. . . . . . . . . . . . . . . 2-101 F/vF Command - Clear Monochrome Image Buffers . . . . . . . . . 2-102 G/vG Command - Initialize Monochrome Graphic (B/W) . . . . . . 2-103 GS Command - Download Color Graphic . . . . . . . . . . . . . . 2-104 I Command - Print Monochrome Panel . . . . . . . . . . . . . . . 2-105 IH Command - Print Hologram Overlay . . . . . . . . . . . . . . . 2-106 IM Command - Print Color Test Card . . . . . . . . . . . . . . . . 2-107 IMB Command - Print Gray Test Card . . . . . . . . . . . . . . . . 2-108 IS Command - Print Card Panel . . . . . . . . . . . . . . . . . . . 2-109 IV Command - Print Clear Varnish. . . . . . . . . . . . . . . . . . 2-110 J Command - Print Multiple Monochrome Cards . . . . . . . . . . 2-111 L/vL Command - Write Line (Monochrome) . . . . . . . . . . . . . 2-112 M/m Commands - Multiple Command . . . . . . . . . . . . . . . . 2-113 MB Command - Return Card To Card Feeder . . . . . . . . . . . . 2-114 MC Command - Clear Media Path . . . . . . . . . . . . . . . . . 2-115 MCL Command - Move Contactless . . . . . . . . . . . . . . . . . 2-116 ME Command - Exit Card To Output Hopper . . . . . . . . . . . . 2-117 MF Command - Flip Card . . . . . . . . . . . . . . . . . . . . . . 2-118 MI Command - Input Card To Print Ready Position . . . . . . . . . 2-119 MIB Command - Reverse Card To Print Ready . . . . . . . . . . . 2-120 MO Command - Exit Card To Output Hopper . . . . . . . . . . . . 2-121 MRB Command - Move Card to Rejected Box. . . . . . . . . . . . 2-122 MS Command - Move To Smart Card Programmer . . . . . . . . . 2-123 O/vO Commands - Load Single Line Bit-map (Mono.) . . . . . . . 2-124 P/vP Commands - Write Dot (Monochrome). . . . . . . . . . . . . 2-126 PS Command - Download Color Image Buffer. . . . . . . . . . . . 2-127 R Command - Reset . . . . . . . . . . . . . . . . . . . . . . . . . 2-128 RCBC Command - Reset Rejected Card Box Counter . . . . . . . . 2-129 RLOGO Command - Retrieve Logo . . . . . . . . . . . . . . . . . 2-130 SF Command - Synchronize Film (Overlaminate) . . . . . . . . . . 2-131 SXY Command - Center Image Maps . . . . . . . . . . . . . . . . 2-132 T/vT Commands - ASCII Text (Monochrome) . . . . . . . . . . . . 2-133 TF Command - Film Type . . . . . . . . . . . . . . . . . . . . . . 2-135 V Command - Check Printer Type/Version . . . . . . . . . . . . . 2-136 Z/vZ Commands - Load Bit-map (Monochrome) . . . . . . . . . . 2-137
vi
980415-001 Rev.B
Appendix A . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-1 Resident Fonts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-2 Code 39(Code 3 of 9). . . . . . . . . . . . . . . . . . . . . . . . . . . A-3 Standard 2 of 5(Code 2/5) . . . . . . . . . . . . . . . . . . . . . . . . A-5 Interleaved 2 of 5 (Code I 2/5). . . . . . . . . . . . . . . . . . . . . . . A-6 UPC-A . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-7 EAN-8 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-8 EAN-13 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-9 Code 128Subsets B & C. . . . . . . . . . . . . . . . . . . . . . . . . A-10 EAN International Regulation Agencies . . . . . . . . . . . . . . . . . A-12 Appendix B . . . . . . . . . . . . . . . . . . . . Parallel Port Printer Data Handshake Signal Lines. . . . Parallel Port Printer Error Response. . . . . . . . . . . Serial Port Printer Data Handshake . . . . . . . . . . . Serial Port PrinterError Response . . . . . . . . . . . . Appendix C . . . . . . . . . . . . . . . . . . . . Magnetic Encoders . . . . . . . . . . . . . . . . . . . Encoder Operation. . . . . . . . . . . . . . . . . . . Data Errors. . . . . . . . . . . . . . . . . . . . . . . Encoder Default Configuration . . . . . . . . . . . . . Basic Commands . . . . . . . . . . . . . . . . . . . Advanced Encoder Commands . . . . . . . . . . . . Resetting The Encoder To ANSI/ISO Track Defaults. . . Change Track Density . . . . . . . . . . . . . . . . . Changing Read Configuration . . . . . . . . . . . . . Changing Write Configurations. . . . . . . . . . . . . Custom ISO Data . . . . . . . . . . . . . . . . . . . Unique Custom Data Formats . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . B-1 B-1 B-1 B-2 B-2 C-1 C-1 C-2 C-2 C-3 C-4 C-4 C-5 C-5 C-5 C-6 C-6 C-6
. . . .
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
980415-001 Rev.B
vii
viii
980415-001 Rev.B
INTRODUCTION
This manual describes programming commands that control operations and deliver data for the following card printer models:
Models
RFID
Color Printing
Duplex Lamination
Log-On Security
P205 P210 P310F P310C P310i P320i P420 P420i P520 * P520i * P720i * Model that laminates duplex using same lamination patch type for both card sides Model capable of applying different upper and lower lamination patch types onto cards
All models employ a Common Command Set plus additional Command Sets for any model-specific features. All models ship with Windows drivers. Associated programming for use in the Windows environment is not necessary.
980415-001 Rev.B
1-1
Common Features All covered models can print bar-codes in several formats
and have resident scalable font descriptions. Also, all models can include a Smart-Card Docking Station. P310 and P420 variants can have a Proximity Card docking Station. All models are offered with or without a Magnetic Stripe Encoder. A Serial Host Interface is optional on the P205, P210, P310, and P420 variants, where an associated RS-232C Setup Command exists. All models can have USB Ports, either standard or as an option. The programming commands control the printing process by color and by ribbon material, allowing overprinting and separate control of various protective coverings.
Programming The Escape Commands allow printer setups, many of Objectives which determine how a Printer Module Element reacts
upon receiving an incoming card. For example, a data download must occur before the Printer Module can print a card or encode a magnetic stripe. Except for the Card Feeder, each module has an Input Sensor that triggers the responses determined previously by setup commands. Card Sensors also allow the Firmware to keep track of the position of the card in the Card Path. Therefore, the need for card positioning occurs as an automatic response to related commands. For example, with no card in the Card Path, a Print Command produces a Card Feed. Similarly, if a Print Command occurs after a card has passed beyond the Print Head, the card first returns to the Print Head. Ribbons come in different panel configurations, and how the printer responds to a Print Command varies according to the Ribbon Type Command Parameters specified. For each ribbon type, a related print sequence exists. However, all models equipped with the RFID feature sense the ribbon type, and firmware takes care of this parameter. While some commands affect just one printer module, others can produce responses from more than one. Also, some commands serve as setups for a particular printer and, therefore, need not be reestablished for each print job. Notably, all command parameters end up in Flash memory.
1-2
980415-001 Rev.B
980415-001 Rev.B
1-3
Models *Panel P205 P310 P420 P520 P720 Count P210 P320 1 Kresin (all monochrome colors) Scratch-off Gray 1 KresinO 2 KdyeO 2 YMC 3 YMCK 4 YMCKresinO 5 YMCKresinKresin 5 YMCKresinOKresin 6 * P310 monochrome and P205 printers only use 1-panel ribbons. Printer Ribbons
1-4
980415-001 Rev.B
Duplex LaminatorPrinters with this element laminate both card surfaces in a single lamination pass. This element also has its own CPU that carries out the details of instructions received. Operator LCD Control PanelPrinters with this element convey messages to operators via a 2-line by 16character LCD screen and allow operator responses and Printer Control. Power and Alert LEDs also appear. This element also has its own CPU that carries out the details of instructions received. Significant model/configuration differences related to programming include the following: P310 Monochrome card printers have a smaller command set along with an image buffer sufficient for a one-bit image mapping depth. Imaging using Thermal Transfer Methodology occurs, supported by Thermal Transfer Printer Ribbons. (Only fully-saturated dots image in a single print pass.) Any gray-scale imaging requires host data mapped into multiple-dot matrixes, sized for the desired gray-scale range (e.g., a four-by-four dot pixel matrix can produce 16 levels of gray plus white, [(4 x 4)2/16 + white]). Gray Levels derive from the number of dots imaged inside the matrix. P310 Color card printers employ dye sublimation methodology for color imaging and thermal transfer methodology for imaging from Resin Monochrome Ribbons or Ribbon Panels. A yellow, magenta, and cyan imaging sequence occurs. Each ribbon panel produces images from five-bit-per-dot data. The black panels on Zebra-supplied ribbons with color panels have a resin coating that particularly suits bar-code and other solid image printing (i.e., no gray scale). However, resin responds poorly as a dye sublimation print medium. Therefore, the black used for gray-scale imaging comes from formulations of yellow, magenta, and cyan (YMC), which means dye-sublimation black also has a five-bit-per-dot range (32 levels of gray). If the need for a resin-panel-generated gray scale should ever become necessary, associated host data must be mapped into multiple-dot pixel matrixes as noted in the P310 Monochrome description.
980415-001 Rev.B
1-5
P310 Color Card Printers have five image buffersthree for color and another for two for monochrome. The color buffer receives downloads of Cyan, Magenta, and Yellow image data, each five bits deep. The Monochrome Buffer receives black and/or varnish data one bit deep. Separate data for Resin Black and Overlay Varnish can often be avoided. Because of its durability, card areas with resin images may not require varnish for the associated ultraviolet protection. Therefore, by using a reverse imaging for varnish, the same bit-map used for resin produces a varnish overlay that omits the areas with resin. Also, through reverse imaging, a Clear Command can prepare Monochrome Memory for a full-coverage varnish. P420s employ the same Print Engines as the P310 Color described above. Because P420s also have a Card-Flip assembly and a Rejected Card Box, these models have some additional related commands. P420s also have an interface that supports the programming of Proximity Cards (also called Contactless Cards). Memory size is doubled to support two-sided printing. P520s have all the same implementations as a P420, including Smart Card stations, and Magnetic Encoders as options. However, P520s also have a Card Laminator Station. Laminators serve as heat-transfer devices for material or panels contained on Lamination Ribbons. A variety of these kinds of ribbons exist, as follows: Ribbons with transparent die-cut patches that offer near edge-to-edge card coverage Die cuts with cutouts for Smart Card Contacts, and smaller die cuts that serve to avoid Magnetic Stripes Preprinted Patches that contain security devices such as graphics, holograms, or other optically-encoded safeguards P520 Laminators can also serve a heat-transfer function for ribbons containing a coating instead of die-cut panels. However, only a total card application can occur. Because the Print Station can have a Dye Sublimation Ribbon with Varnish Panels, many choices exist for selection of protective coatings. Additional commands exist to implement Laminator use.
1-6
980415-001 Rev.B
Instead of just an <Esc>, a P520 Command meant for the Laminator needs a preceeding: <Esc>#<Space>1<Space> P720s have P420 elements plus a Laminator module that fully implements simultaneous near edge-to-edge patch applications from above and below the Card Path. Integral sensors assure accurate patch placements and signal the Ribbon Types in use and the amount remaining on their cores.
Basic Command Each command begins with a Command Initiator (the EsSyntax cape Character). For P520s, directing characters can follow the Escape Character. The Command Initiator serves to mark the character(s) immediately following as command characters. Command characters vary between one and seven characters (or up to seven bytes of hexadecimal data). Some Commands then have one or more Parameters to supply the printer with information necessary to complete the command. A Space Character delineates individual Command Control Parameters. The following Text Command shows a typical example. Each Command Line requires a Carriage Return Character (13 dec. or 0D hex.). The Printer ignores a single Line Feed (LF) character (Dec. 10 or 0A Hex.) when it immediately follows the command terminating Carriage Return. Most PC Based Systems send a CR/LF when the Enter Key is pressed.
Command Name
<Esc>T
100
100
20
30
Text
Text<Rtn>
Hexadecimal Programming Code Space (Delimiters) Escape (Command Initiator) Carriage Return (Command Terminator)
980415-001 Rev.B
1-7
Command Editor Any ASCII based Text Editor can serve to create simple
command files. In the DOS environment, MS-DOS EDIT offers a good choice. To execute the file, use the Print Command from the editor, or from DOS, the COPY Command, to send the file to the printer. Examples using the COPY Command are:
Image Memory Figure 1-1 shows elements involved in image data flow. Arrangements Note that two Image Memory Configurations exist and
that Image Memory always contains compressed data. Ideally, hosts should send compressed data, which requires a compatible compression algorithm. This can substantially reduce the data transfer times of most image files.
1-8
980415-001 Rev.B
Host Computer
Mono. Buffer
Image Buffers
Black Buffer Varnish Buffer Doubled for Printers With Card Flip Stations
Monochrome Printers need no Color Buffers and offer less memory capacity. Color Printers may need as many as five buffers and, therefore, have a greater memory capacity. In most cases, compressed data for an entire card image fits into available memory in a single download sequence. Color-separated data enters related buffers due to a buffer-specifying parameter in the Color Data Command.
980415-001 Rev.B
1-9
Characteristically, a Bit-Map Compression Algorithm flags data segments as either repeating or non-repeating, specifies the bytes repeated, and the number of repeats. For these card printers, compression applies to byte-wide bit-map segments, which the host sends with the PS, GS, Z, and vZ commands. The PS and GS commands include parameters specifying a buffer (YMCK). Monochrome commands Z and vZ send associated bit-map data to the Black (K) and Varnish Buffers, respectively. All of these commands include parameters that specify whether or not the command applies to compressed data. For recognition by the card printer, compressed data must conform to the following rules: Rule 1. When high, the most significant bit (the Flag Bit) of a two-byte sequence indicates that the second byte repeats. The remaining seven bits of the first byte specify the number of repeats, allowing a field-specification range of from zero to 127 repeats. Rule 2. When low, the Flag Bit of a data sequence indicates that the remaining seven bits of the byte specify the number of following bytes that represent non-repeating image data. Here, however, the range allows a specification of from zero to 31 bytes of data. Rule 3. The first byte in the Data Field of any command specifying a Compressed Bit-Map must have the Compression Flag high, even if a one must be entered as the number of bytes repeated. Rule 4. No other algorithm can be used to compress image data for this card printer. Figure 1-2 includes examples of data strings employing compression.
1-10
980415-001 Rev.B
Mono. Panel 8-Dot Data Field 1XXX XXXX XXXX XXXX Data Compression Flag Set No. of Repeats (1~127) Data Byte Repeated
Dye Sub. Panel 1-Dot Data Field 1XXX XXXX XXXX XXXX Data Compression Flag Set No. of Repeats (1~127) Data Byte Repeated Compression Example 1
0001 1111 0001 1111 0001 1111 0001 1111 0001 1111 0000 0011 0000 0011 0000 0011
1F Hex (5 repeats) 85 1F
03 Hex (3 repeats) 83 03
Compressed Data 1000 0101 0001 1111 1000 0011 0000 0011
Compression Example 2
0001 1111 0001 1111 0001 1111 0001 1111 0001 1111 0000 0100 0000 1011 0000 0011
1F Hex (5 repeats) 85 1F
04 0B 03 Hex (0 repeats) 03 04 0B 03
Compressed Data 1000 0101 0001 1111 0000 0011 0000 0100 0000 1011 0000 0011
980415-001 Rev.B
1-11
Figure 1-3 shows how a bit-map relates to associated non-compressed data. Figure 1-4 shows the same bit-map in association with compressed data.
x axis
1B 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 0D
5A 00 00 00 00 03 0F 1F 3F 3F 7F 7F 7F FC F0 E0 C0 C0 C0 C0 FF FF FF FF FF FF FF FF C0 80 80 80 00
00 00 00 00 F0 FC FE FF FF FF FF FF 0F 03 01 00 00 00 00 FF FF FF FF FF FF FF FF 00 00 00 00 00
00 00 00 00 00 00 00 00 00 80 80 80 C0 C0 C0 C0 C0 C0 C0 FF FF FF FF FF FF FF FF 00 00 00 00 00
00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 01 01 01 03 FF FF FF FF FF FF FF FF 03 01 01 01 00
00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00
980415-001 Rev.B
00 00 00 00 00 00 00 00 00
Data-to-Card Figure 1-5 shows a card consistent with the orientation of Mapping a card traveling right to left in the Card Path of a printer.
From this perspective, the data field of the PS, GS, Z, and vZ commands first becomes a memory-resident image in a designated image buffer. The Image Buffer, as shown, fills from top to bottom and from right to left. Because the Image Buffer has a last-in-first-out (LIFO) arrangement, card images build from bottom to top and from left to right.This suits the front-to-back loading of Print Head Registers and the right-to-left card movement during print cycles. As noted in the figure, an object mirrored in both axis in the data sent to the buffer would print normally on the card.
980415-001 Rev.B
1 Byte
03 0F 1F 3F 3F 7F 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 0D
F0 FC FE FF FF FF 7F 7F FC F0 E0 C0 C0 C0 C0 84 84 84 84 84 84 84 84 C0 80 80 80
84 84 84 84 84 80 FF FF 0F 03 01 00 00 00 00 FF FF FF FF FF FF FF FF 00 00 00 00
00 00 00 00 00 00 80 80 C0 C0 C0 C0 C0 C0 C0 02 02 02 02 02 02 02 18 00 00 00 00
02 02 02 02 3C 00 00 00 00 00 00 01 01 01 03 00 00 00 00 00 00 00 00 03 01 01 01
00 00 00 87
1-13
Download Buffer Data Command Buffer Select (YMCK) Parameter Compressed vs. Uncompressed Parameter Data Downloaded (300dpi/11,8dpmm)
PS p1 p2 data.............................data
Image Buffer
IS p1
Print Direction
Card Size 3.375 x 2.125 in 85,7 x 53,9 mm
PartialImage Origin
MAXIMUM CARD IMAGING 646 Line Bytes by 1030 Lines ASSOCIATED COMMANDS Monochrome Overlay G IH O IV Z vZ P vP L* vL* C* vC* D* vD* T vT B vB I Color PS GS IS
1-14
980415-001 Rev.B
When converting from another color system to CMY, the best possible results occur when a table maps each source color to a visually equivalent CMY printer color. Such a table must convert all possible printer colors. Also, the conversions must be fine-tuned to produce optimum results. However, for RGB data, a simple conversion can occur via the following: Y = 255 - B M = 255 - G C = 255 - R. Color data always enters a color image buffer, either as Yellow, Magenta, or Cyan. This is also true for KdyeO ribbon, which images with black dye. The command designates the buffer differently according to the Buffer Specification Parameter in the command. Note that the specification for Dye Sublimation only applies to images produced using a Dye Sublimation Black Ribbon. All data associated with these commands represent imaging consisting of five-bits-per-dot. Whether downloading data for a partial image (GS command) or for a complete card image (PS command) the data must match the associated card area. For partial images (sometimes called logos because of a typical application) the GS Command Parameters specify the area imaged. This assures proper line breaks. Any either overor under-flow produces an error. For proper appearance, color images should not overprint other card printing.
Associated printers have no need to print varnish. However, the Varnish Buffer stores monochrome data. Therefore, all data commands for monochrome data require the v preface. A subsequent I command prints data stored in the Varnish Buffer. Note that the IV Command serves to indicate the presence of a ribbon with varnish panels that then get bypassed. P-Series Printers always download monochrome data into a Monochrome Image Buffer. In printers without Laminators, monochrome data commands prefaced with a v designate the Varnish Buffer. Commands without the v preface designate the buffer used for resin printing. If only one Monochrome Image Buffer exists, the command designates the buffer differently depending on the associated data. However, most color imaging does not need a pre-established Varnish Buffer to apply the varnish coat-
980415-001 Rev.B
1-15
ing. If no Varnish Buffer is downloaded, the printer defaults to the Resin Buffer for the application of varnish. This works for three reasons. First, color ribbons have resin black followed by varnish panels, both limited to monochrome data. Second, the primary use of varnish is to protect the dye sublimation imaging from ultraviolet radiation. Third, because resin may need no varnish protection, an inverted-resin bit-map can apply varnish. The IV command has a parameter setting to produce an inverted data print. Therefore, when suitable, leave the Resin Buffer unchanged after printing resin. Then, issue an IV command to print the varnish. Note that full-coverage varnish, as required for ultraviolet protection using dye-sublimation black ribbons, requires only a buffer clear command (F) followed by the inverted print command (IV). A watermark simulation can result by, in effect, punching holes in the varnish image. Similarly, suitable holes in the varnish application are necessary to prevent coverage over Magnetic Stripes or Smart Card Contacts. However, this concern can be avoided by limiting images requiring varnish to the card sides without contacts or stripes. A hologram transfer from an associated ribbon occurs by printing a Varnish Buffer that images the area of the ribbon containing the hologram. Both of these images require data previously downloaded into the Varnish Buffer. Monochrome graphic objects can download into either a Resin or Varnish Buffer. As with the preceding, a v preface designates a buffer that prints with the IV Command, and commands without the v preface designate a buffer that prints with the I Command. Commands exist for downloads of the following graphic objects: P/vP L/vL C/vC D/vD T/vT B/vB Write Dot Write Line Write Box Write Diagonal Line Write Text Write Bar-Code
1-16
980415-001 Rev.B
The following Gaphic Commands have Rotational Parameters (clockwise): D/vD (Diagonal Line) Center of Rotation T/vT (Text) Center of Rotation B/vB (Bar Code) Center of Rotation 0, 90, or 180 lower-left 90 Increments (0~270) lower-left or object center 90 Increments (0~270) lower-left or object center
Monochrome bit-maps require entry of two commandsfirst an initializing command (G) and then an associated data command. The G Command specifies image placements associated with the following commands: O/vO Z/vZ Download Single Line Download Multiple Lines
Figure 1-5 shows the relationship between data sent by O or Z commands and an area previously established by a G command. The G command can also define data as single bits (i.e., image dots). With dots selected as the Data Mode in the G Command, data sent to the printer must, nevertheless, finish on an even byte boundary. When necessary, fill in zero bits to bytes that do not reach the boundary specified in the G Command. Data is handled in bytes decimal (0~255) or hexadecimal (00~FF) by the printer.
980415-001 Rev.B
1-17
Bar Codes
Bar Codes vary in capacity, size, character sets, and density. Several industries have adopted specific coding and bar code formats. A selected Bar Code must match a code supported by the scanning equipment. All the Bar Codes offered by the card printers have the data characters, 2 quiet zones, and Start and Stop Characters. The Bar Codes can include Text as part of the Printed Bar Code. Some of the Bar Codes include a printer-generated Check Digit (or Data Check Sum) Character automatically or as an option. A command error condition occurs when Image Data extends beyond the addressable range of the Image Buffer. The Bar Code and Text Fields must remain within the addressable area of the Image Buffer. Each of the Bar Codes, in the Command B and Appendix-A Descriptions have a formula to determine a Bar Code Length. Selecting a larger Bar Code Width Multiplier and a higher ratio of the narrow to wide bars (and spaces, where applicable) improves the general readability of a Bar Code. Also, wider bars and spaces increase the depth of field for improved performance with Moving-Beam Lasers and other non-contact scanning devices.
Control Commands The card printers can perform a variety of print, card, ribbon, head movement, and other control command operations.
1-18
980415-001 Rev.B
Card Handling The following outlines a recommended card handling seProcess quence:
1. Smart Card Programming - Option 2. Magnetically Encode Card - Option 3. Print Card For color, print: Yellow Magenta Cyan Black Clear Varnish or Hologram Transfer 4. Duplex - Flip Card - Option 5. Print Card Backside - Option For color, print: Yellow Magenta Cyan Black Clear Varnish Hologram Lamination 6. Eject Card
980415-001 Rev.B
1-19
Never image or laminate over magnetic stripes or Smart Card Contacts. Encoding and/or Smart Card Programming Errors can result. Those with lamination capabilities can order patches that leave these areas uncovered.
Sample Card Figure 5-6 shows a printed card along with the commands
used.
Commands
+RIB +C 3 F B 512 600 4 0 2 4 100 1 TEST T 512 75 4 0 0 35 1 Company Name, Incorporated T 200 200 0 1 0 50 1 FIRST NAME T 200 300 0 1 0 50 1 LAST NAME T 200 400 0 1 0 50 1 ACCOUNT NUMBER T 65 320 7 1 0 50 0 Reverse text L 15 80 970 4 1 M1I
Descriptions
Ribbon Type Thermal Intensity Clear Mono. Buffer Write Bar Code Write Text Write Text Write Text Write Text Write Text Write Line Print Monochrome
1-20
980415-001 Rev.B
Parallel Port Signals P205, P210, P310 and P420 Printers have a Serial Port
Option. Serial equipped printers communicate with the host over an RS-232C interface using ACK/NAK flow control. Parallel Ports are standard. The other card printer models have no Serial Port Option. Card printers with Parallel Ports communicate with the host using the following signal lines:
Eight bits of parallel data. A host signal that indicates stable data. A printer signal that indicates data received. The host drops the STROBE signal in response. BUSY (Pin 11) A printer signal that indicates an inability to accept commands due to ongoing processing. In printers with more than one processor, a BUSY response from one processor does not imply a BUSY at the another processor. READY (Pin 13) A printer signal that indicates its availability to receive Host Commands. PAPER ERROR (Pin 12) Card printers report errors to the host by encoding the PAPER ERROR and ERROR lines (see Error Line Coding below). ERROR/ (Pin 15) Card printers report errors to the host by encoding the PAPER ERROR and ERROR lines (see Error Line Coding below). INIT (Pin 14) Not used.
980415-001 Rev.B
1-21
1-22
980415-001 Rev.B
COMMAND REFERENCE
This section contains individual command descriptions for data downloads, printing, lamination, magnetic encodes, and card movement control. An included Command List groups commands by function and shows the associated applicable Printer Models.
Esc Space
Enter
980415-001 Rev.B
2-1
Command List
P310(i)/P320i Color
P/S520(i)
P/S720(i)
DESCRIPTION
P205 P210
P310 Mono.
COMMAND
P420(i)
Setup Commands
!FF !R +$C +$L +BS +C
+CDOTS
Set Ribbon Color Sequence Print Head Resistance Adjust Independent Color Contrast Level Adjust Specified Color Intensity Level Set Black Speed Adjust Thermal Transfer Intensity Level Set Image Quality Compensation Factor Adjust Hologram Intensity Set Cooling Time Adjust Clear Varnish Intensity Print Length (X-axis) Set Lamination Counter Set Lamination Roller Temperatures Set Lamination Time Offset Start Print Position (X-axis)
2-30 2-39 2-52 2-53 2-55 2-56 2-57 2-58 2-59 2-60 2-61 2-67 2-68 2-69 2-70 2-71 2-72 2-37 2-74 2-75 2-76 2-77 2-78 2-79 2-81 2-82 2-83 2-84 2-85
+CCLN Set Cleaning Parameters +CH +CT +CV +EC +LC +LT +LTI +O
+OCL Offset Contactless (Proximity) Card +OFP Adjust X-Axis Patch Offset +OLP Offset Overlaminate Patch +OP +OS +OY +RB +RIB +RO +SB Offset Patch X and Y Offset (P720) Offset (X-axis) Smart Card Offset Start Print Position (Y-axis) Hopper Selection for Rejected Cards Ribbon Type (Non RFID only) Set X-Axis Offset, Relative Set Stand-By Mode
+RIBBON Set Lamination Ribbon Type +ROY Set Y-Axis Offset, Relative +SIDE Set Lamination Mode
2-2
980415-001 Rev.B
PAGE
P/S520(i)
P/S720(i)
DESCRIPTION
P205 P210
P310(i)/P320i Color
P310 Mono.
COMMAND
P420(i)
2-132
Tests
A IM IMB Print Test Card Print Color Test Card Print Test Card 2-90
2-107 2-108
Initialize Commands
. &C
&CDER &CDEW
Clears Error Status Lines Set Encoder Coercivity Custom Encoder Read Density Custom Encoder Write Density Change Encoder Track Write Density Reset Encoder Change Encoding Direction Clear Color Bit-maps Clear Specified Bit Map Serial Interface Rate (Serial I/O) Set Temperature (Laminator) Reduce Color Print Speed Set Lamination Speed Change Control Character (Serial I/O) Clear Monochrome Image Buffers Reset Printer Synchronize Film (P520 use) Film Type (Laminator)
2-7 2-9 2-10 2-12 2-14 2-19 2-20 2-22 2-23 2-24 2-54 2-62 2-86 2-84 2-88 2-89
980415-001 Rev.B
PAGE
2-3
P/S520(i)
P/S720(i)
DESCRIPTION
P205 P210
P310(i)/P320i Color
P310 Mono.
COMMAND
P420(i)
Check Card Presence - Encoder (Serial I/O) Check P720 Patch Sensors Check P720 Laminator Heat Offset Check P720 Cooling Time Check P720 Laminator Sensor Levels Check P720 Lamination Counter Check P720 Lamination Temperatures Check P720 Lamination Time Check P720 Laminator Card Offset Check P720 X-Axis Patch Offset Check P720 Patch Offsets Check Ribbon Type Check Patches Remaining Check P720 Lamination Mode Check Stand-By Mode Settings Return Operational Parameter Check Command Initiator (Serial I/O) Return Installed Fonts Return Number of Fonts Saved Return Name of Saved Logo Retransmit Last Response (Serial I/O) Check Printer Type/Version
2-18 2-25 2-26 2-27 2-28 2-31 2-32 2-33 2-34 2-36 2-37 2-38 2-40 2-41 2-43 2-44 2-45 2-46 2-47 2-48 2-49 2-50 2-51 2-94 2-101 2-136
2-4
980415-001 Rev.B
PAGE
P/S520(i)
P/S720(i)
DESCRIPTION
P205 P210
P310(i)/P320i Color
P310 Mono.
COMMAND
P420(i)
2-99 2-100 2-103 2-104 2-112 2-124 2-126 2-127 2-130 2-133 2-137
Initialize Monochrome Graphic Download Color Graphic Write Line Load Single Line Graphic Dots Download Write Dot Download Color Image Data Write Text Multiple Line of Graphic Dots Download
2-114 2-115 2-116 2-117 2-118 2-119 2-120 2-121 2-122 2-123 2-131
Print Commands
I IH IS IV J Print Card Monochrome Panel Print Hologram Overlay Print Card Panel (YMC) Print Varnish Overlay Print Multiple Cards N Times 2-105 2-106 2-109 2-110 2-111
980415-001 Rev.B
PAGE
2-5
P/S520(i)
P/S720(i)
DESCRIPTION
P205 P210
P310(i)/P320i Color
P310 Mono.
COMMAND
P420(i)
Miscellaneous Commands
!D !M !SA
CLNCAR D
CLEAN Start Cleaning Card Sequence Set Cleaning Card Sequence Multiple Command Strings
M/m
2-113
2-6
980415-001 Rev.B
PAGE
980415-001 Rev.B
2-7
The actual data encoded onto the card is converted from ASCII to an ISO track-specified encoding format. See Appendix C for default ANSI/ISO data formats and custom data encoding commands.
2-8
980415-001 Rev.B
980415-001 Rev.B
2-9
Syntax <Esc>&CDER p1 p2 ISO Data <Esc>&CDER p1 p2 p3 Raw Data Parameters p1 = Track Select: (values 1, 2, 3, or 0 (zero)
Where: 0 = Reset of ALL tracks to ISO default configuration parameters p2 = Custom Data Select, as follows:
Description - ISO Format Data Resets ALL tracks to ISO default configuration 0 parameters. Default Format Select Q ISO Track 1 Data Format to Track 1 R ISO Track 2 Data Format to Track 2 S ISO Track 3 Data Format to Track 3 Custom ISO Track Format Location qX Track 1 with ISO Track X Format rX Track 2 with ISO Track X Format sX Track 3 with ISO Track X Format X = 1, 2, or 3 as the ISO default track format applied to the selected track (e.g., Q=q1, R=r2, and S=s3. Value
2-10
980415-001 Rev.B
Read Forward - Raw Data U U_ V V_ W W_ Track 1 Track 1 read data with NULs in data string Track 2 Track 2 read data with NULs in data string Track 3 Track 3 read data with NULs in data string
Read Reverse - Raw Data u u_ v v_ w w_ Track 1 Track 1 read data with NULs in data string Track 2 Track 2 read data with NULs in data string Track 3 Track 3 read data with NULs in data string
p3 = Data Block Size Select in Bits Where: Acceptable values = 3, 4, 5, 6, and 7 The Encoder cannot decode and convert Raw Data into ASCII data. The Encoder only reports data read after the process has completed.
980415-001 Rev.B
2-11
Syntax <Esc>&CDEW p1 p2 ISO Data <Esc>&CDEW p1 p2 p3 Raw Data Parameters p1 = Track Select: (values 1, 2, 3 or 0 (zero)
Where: 0 = Reset of ALL tracks to ISO default configuration parameters p2 = Data Format Select, as follows:
Description - ISO Format Data Reset ALL tracks to ISO default configuration 0 parameters. Default Format Select A ISO Track 1 Data Format to Track 1 B ISO Track 2 Data Format to Track 2 C ISO Track 3 Data Format to Track 3 Custom ISO Track Format Select aX Track 1 with ISO Track X Format bX Track 2 with ISO Track X Format cX Track 3 with ISO Track X Format X = ISO default track format applied to the selected track (e.g., A=a1, B=b2, and C=c3. Value
2-12
980415-001 Rev.B
Read Forward - Raw Data E E_ F F_ G G_ Track 1 Track 1 read data with NULs in data string Track 2 Track 2 read data with NULs in data string Track 3 Track 3 read data with NULs in data string
p3 = Data Block Size Select in Bits Where: Acceptable values = 3, 4, 5, 6, and 7 The encoder cannot encode and convert ASCII data into Raw Data. The Encoder only reports that a data write process has completed.
980415-001 Rev.B
2-13
2-14
980415-001 Rev.B
980415-001 Rev.B
2-15
2-16
980415-001 Rev.B
The actual data encoded onto the card is converted automatically from an ISO-track-specified encoding format to ASCII. See Appendix C for default ANSI/ISO data formats and custom data encoding commands.
980415-001 Rev.B
2-17
The card printer responds to commands (with data or error codes) via the Bi-directional Serial Interface only. Printers with parallel interfaces cannot respond to this command, (other than flagging an error). In a Test Environment, card printers can operate with both interfaces attached and communicating with the printer. The Printer CPU Board has associated connectors.
2-18
980415-001 Rev.B
980415-001 Rev.B
2-19
2-20
980415-001 Rev.B
980415-001 Rev.B
2-21
2-22
980415-001 Rev.B
980415-001 Rev.B
2-23
2-24
980415-001 Rev.B
980415-001 Rev.B
2-25
2-26
980415-001 Rev.B
980415-001 Rev.B
2-27
2-28
980415-001 Rev.B
980415-001 Rev.B
2-29
p1 = 1 Moves ribbon to next Transparent Panel, unless already there. For P210, moves ribbon to next panel. p1 = 2 Moves ribbon to next Non-transparent Panel, unless already there. For P210, moves ribbon to next panel. p1 = 3 Moves ribbon to beginning of Black (for YMCKresinO ribbons only)
2-30
980415-001 Rev.B
980415-001 Rev.B
2-31
2-32
980415-001 Rev.B
980415-001 Rev.B
2-33
2-34
980415-001 Rev.B
980415-001 Rev.B
2-35
2-36
980415-001 Rev.B
980415-001 Rev.B
2-37
2-38
980415-001 Rev.B
<Esc>!R 1567
980415-001 Rev.B
2-39
2-40
980415-001 Rev.B
980415-001 Rev.B
2-41
2-42
980415-001 Rev.B
980415-001 Rev.B
2-43
2-44
980415-001 Rev.B
980415-001 Rev.B
2-45
2-46
980415-001 Rev.B
The card printer responds to commands (with Data or Error Codes) via the Bi-directional Serial Interface only. Printers with parallel interfaces cannot respond to this command, (other than flagging an error). In a Test Environment, card printers can operate with both interfaces attached and communicating with the printer. The Printer CPU Board has associated connectors.
Description This command checks for an Alternate Command Initiator. The printer either reports the Alternate Command Initiation Character or nothing.
980415-001 Rev.B
2-47
Where: p1 = Total number of Head-down Image Passes made by printer since new (note that each ribbon panel used counts as a pass) p2 = Current setting for image passes that trigger a cleaning alert (default = 00005000see CLNCARD Command) p3 = Current setting for passes performed using Cleaning Card (default = 5see CLNCARD Command)
Example
2-48
980415-001 Rev.B
Syntax <Esc>%F Parameters None Example (Resident) 0 :aria100 1 :aria100b >ACK Example 0 :aria100 1 :aria100b 2 :aria 100b (w/Download) >ACK
980415-001 Rev.B
2-49
2-50
980415-001 Rev.B
980415-001 Rev.B
2-51
2-52
980415-001 Rev.B
980415-001 Rev.B
2-53
The card printer responds to commands (with data or error codes) via the Bi-directional Serial Interface only. Printers with parallel interfaces cannot respond to this command, (other than flagging an error). In a Test Environment, card printers can operate with both interfaces attached and communicating with the printer. The Printer CPU Board has associated connectors.
Syntax <Esc>+B p1{ p2} Parameters p1 = Serial Interface Baud Rate Options
Where: 0 = 9600 (Default) 1 = 19200 2 = 38400 3 = 57600 p2 = Command reply time Where: None = ACK after Baud switch 1 = ACK before Baud switch
2-54
980415-001 Rev.B
980415-001 Rev.B
2-55
2-56
980415-001 Rev.B
980415-001 Rev.B
2-57
2-58
980415-001 Rev.B
980415-001 Rev.B
2-59
2-60
980415-001 Rev.B
980415-001 Rev.B
2-61
2-62
980415-001 Rev.B
On first side, print YMCK then laminate. On second side, print YMCKO panels (no laminate): +DLAMI 0 1 IS 0 IS 1 IS 2 I IV 10 MF +DLAMI 1 0 IS 0 IS 1 IS 2 I IV Laminate enabled (side-1 default) Print Y (side 1) Print M (side 1) Print C (side 1) Print K (side 1) No varnish, just a return Flip Card & return Varnish enabled Print Y (side 2) Print M (side 2) Print C (side 2) Print K (side 2) Print O (side 2), flip, laminate, & eject
980415-001 Rev.B
2-63
Examples Using On first side, print YMCK panels then laminate. On secYMCKOK Ribbon ond side, print last K panel then laminate:
+RIB 10 +DLAMI 0 1 IS 0 IS 1 IS 2 I IV 10 MF +DLAMI 0 0 I 20 MO YMCKOK ribbon in use Laminate enabled (side-1 default) Print Y (side 1) Print M (side 1) Print C (side 1) Print K (side 1) No varnish, just a return Flip Card Laminate enabled Print K (side 2) Flip Card, Laminate, & Eject
On first side, print YMCK panels then laminate. On second side, print just last K panel: +RIB 10 +DLAMI 1 0 IS 0 IS 1 IS 2 I IV 10 MF +DLAMI 0 0 I 20 MO YMCKOK ribbon in use Laminate enabled (side-1 default) Print Y (side 1) Print M (side 1) Print C (side 1) Print K (side 1) No varnish, just a return Flip Card & return Varnish enabled Print K (side 2) & return Flip card, laminate, & eject
2-64
980415-001 Rev.B
Examples Using Print Kdye and laminate Kdye on side two: KdyeO Ribbon
+DLAMI 0 1 IS 3 IV 10 MF +DLAMI 0 0 IS 3 IV Laminate enabled (side-1 default) Print K (side 1) No varnish, just a return Flip Card & return Disable both varnish & laminate Print K (side 2) Flip card, laminate, & eject
On first side, print K and laminate. On second side, print K and varnish: +DLAMI 0 1 IS 3 IV 10 MF +DLAMI 1 0 IS 3 IV Laminate enabled (side-1 default) Print K (side 1) No varnish, just a return Flip Card & return Varnish enabled Print K (side 2) Print O, flip card, & laminate
980415-001 Rev.B
2-65
On first side, print K and laminate. On second side just print K: +DLAMI 0 1 I 10 MF +DLAMI 0 1 I Laminate enabled (side-1default) Print K (side 1), & return Flip Card & return Varnish enabled Print K, flip card, & eject
Print K on both sides without lamination: +DLAMI 1 0 I 10 MF +DLAMI 0 0 I Varnish enabled Print K & return Flip Card & return Disable both varnish & laminate Print K & eject card
2-66
980415-001 Rev.B
P210
Start of Printing
Start of Printing
X and EC Origin
Syntax <Esc>+EC p1 Parameters p1 = line count for end-of-print
Where: 10 = default (standard) 0~48 = range
Example The following example sets the End of Print to 10 (the default value).
<Esc>+EC 10
980415-001 Rev.B
P310
X and EC Origin
2-67
2-68
980415-001 Rev.B
980415-001 Rev.B
2-69
Syntax <Esc># 1 +LTI p1 Paramterers p1 = Time in tenths of seconds (Default of 100 specifies
10 seconds)
2-70
980415-001 Rev.B
980415-001 Rev.B
2-71
2-72
980415-001 Rev.B
980415-001 Rev.B
2-73
P205 P205 P210 P210 P310Mono P310 P310Color P310 P320 P320 P420 P420 P520 P720 P720 RFID
Syntax <Esc># 1 +OLP p1 p2 p3 Parameters p1 = Card Offset Count from Ribbon Sync. Marker
sense to the point p2 takes effect. Only used to synchronize lamination patches that follow Initializations p2 = Offset between where patch applications start p3 = Count where patch applications end
2-74
980415-001 Rev.B
980415-001 Rev.B
2-75
2-76
980415-001 Rev.B
980415-001 Rev.B
2-77
2-78
980415-001 Rev.B
980415-001 Rev.B
2-79
2-80
980415-001 Rev.B
980415-001 Rev.B
2-81
2-82
980415-001 Rev.B
980415-001 Rev.B
2-83
Syntax <Esc># 1 +SB p1 p2 Parameters p1 = Idle Period (seconds) before Laminator enters
Stand-By Mode. Where: p1 = 0 disables Stand By Mode p2 = Laminator Roller Temperatures (C) during Stand-By Mode
2-84
980415-001 Rev.B
980415-001 Rev.B
2-85
2-86
980415-001 Rev.B
980415-001 Rev.B
2-87
2-88
980415-001 Rev.B
The card printer responds to commands (with data or error codes) via the Bi-directional Serial Interface only. Printers with parallel interfaces cannot respond to this command, (other than flagging an error). In a Test Environment, card printers can operate with both interfaces attached and communicating with the printer. The Printer CPU Board has associated connectors.
980415-001 Rev.B
2-89
2-90
980415-001 Rev.B
p4 = Bar Code selection - See Appendix A Where: 0 = Code 39 (3 of 9Alphanumeric) 1 = 2/5 Interleaved (Numeric, Even No Count 2 = 2/5 Industrial (Numeric) no Check Digit 3 = EAN8 (Numeric, 12 digits encoded) 4 = EAN13 (Numeric, 12 digits encoded) 5 = UPC - A (Numeric, 12 digits encoded) 6 = Reserved for MONARCH 7 = Code 128 C w/o Check Digits* (Numeric only, Even Number Printed) 8 = Code 128 B w/o Check Digits* (Alphanumeric) 107 = Code 128 C w/Check Digits* (Numeric only, Even Number printed) 108 = Code 128 B w/Check Digits* (Alphanumeric) * Not supported in some Monochrome Printers
980415-001 Rev.B
2-91
NOTE: Some bar code types have a selectable bar code width ratio. See Appendix A for supported ratio and settings. p6 = Bar Code Bar Width Multiplier. Range 3~9 for all Zebra card bar codes except UPC-A, EAN-8 and EAN-13 which have a range of 4~7. For a selected bar width ratio of 2:5, the range is 2~4. Note: Each bar code type has a specified standard for the width range of a narrow bar width. See Appendix A for optimal values. p7 = Bar Code Height in dots Note: Each Bar Code Type has an industry specified minimum height standard. See Appendix A for optimal values. p8 = Print Text version of Bar Code under Bar Code Where: 1 = yes 0 = no. data = Represents a fixed data field. Each bar code type has a differing data field length and allowable character requirements. See Appendix A. A printer error occurs when a Bar Code extends beyond the addressable area of the Image Buffer. See Appendix A for field size calculations for total bar code length and height.
2-92
980415-001 Rev.B
0 D o t s
Lines
980415-001 Rev.B
p5
2-93
2-94
980415-001 Rev.B
Non P720 Syntax <Esc>CLEAN Non P720 Parameters None P720 Syntax <Esc>CLEAN p1 P720 Parameters p1 = Station Cleaned
Where: 1 = Printer 2 = Magnetic Encoder Head 3 = Printer and Laminator 4 = Laminator
980415-001 Rev.B
2-95
Syntax <Esc>CLNCARD p1 p2 Parameters p1 = Ribbon Panel Count to Cleaning Notification (Default = 5000) p2 = Number of Cleaning Card Passes Through Printer (Default = 5)
2-96
980415-001 Rev.B
980415-001 Rev.B
2-97
p7 = Graphic Mode: Where: 0 = Reverse Bit MapClear Print Area and load Reverse Bit Map Image 1 = Standard Bit MapClear Print Area and load Bit Map Image 2 = Merge Bit MapOverwrite Background Bit Map Image with Printable Dot Locations, leaving Non-printing Dot Locations alone
0 D o t s
Lines
p4 p3
Diagonal Line Image Origin
2-98
980415-001 Rev.B
980415-001 Rev.B
2-99
2-100
980415-001 Rev.B
The card printer responds to commands (with data or error codes) via the bi-directional serial interface only. Printers with parallel interfaces cannot respond to this command, (other than flagging an error). In a Test Environment, card printers can operate with both interfaces attached and communicating with the printer. The Printer CPU Board has associated connectors.
Description This command directs the printer to repeat the last Status
Message.
980415-001 Rev.B
P205 P205 P210 P310Mono P310 P310Color P320 P420 P520 P720 RFID
2-101
2-102
980415-001 Rev.B
p4 = Vertical (Y-axis) Height of graphic in bytes. Round up the number of bytes loading in multiples of 8 bits (i.e. Monochrome Dots) p5 = Horizontal (X-axis) Width of graphic in dots (i.e. horizontal lines) p6 = Graphic Mode: Where: 0 = Reverse Bit MapClear Print Area and load Reverse Bit Map Image 1 = Standard Bit MapClear Print Area and load Bit Map Image 2 = Merge Bit MapOverwrite Background Bit Map Image with Printable Dot Locations, leaving Non-printing Dot Locations alone
980415-001 Rev.B
2-103
2-104
980415-001 Rev.B
980415-001 Rev.B
2-105
2-106
980415-001 Rev.B
980415-001 Rev.B
2-107
2-108
980415-001 Rev.B
980415-001 Rev.B
2-109
2-110
980415-001 Rev.B
980415-001 Rev.B
2-111
0 D o t s
Lines
2-112
980415-001 Rev.B
<Esc>M 3 MI[!D[!M[MO
The M Command groups a Command String. A card loads to the Print-Ready Position with the MI Command. !D lowers the Print Head; !M raises the Print Head, and MO sends the card to the Output Hopper. The M Command specifies three repeats of this sequence. If an error occurs (e.g., the Input Hopper runs out of cards) a command sequence linked by the M Command terminates. In contrast, after error correction and an associated pressing of the Panel Button, a command sequence linked by the m Command resumes.
980415-001 Rev.B
2-113
2-114
980415-001 Rev.B
980415-001 Rev.B
2-115
2-116
980415-001 Rev.B
Syntax <Esc>ME{ p1} Parameters p1 = Number of cards to pass through printer (p1 omitted specifies a single card)
980415-001 Rev.B
2-117
2-118
980415-001 Rev.B
980415-001 Rev.B
2-119
2-120
980415-001 Rev.B
980415-001 Rev.B
2-121
2-122
980415-001 Rev.B
980415-001 Rev.B
2-123
Parameters data =
Uncompressed or compressed monochrome bit-map data. Data length must match the line length specified in the proceeding G command.
See Chapter 1 for the relationship of Monochrome Bit-maps to data. CHECKSUM = Single byte of XOR data generated from image data. If CHECKSUM is specified by the related G/vG Command, a Checksum must be included here.
Remember, any chance Control Characters that appear among the data require a preceding open bracket ([) character. Control Characters include Escape (1B hex), Enter (OD hex), and the Open Bracket (5B hex).
2-124
980415-001 Rev.B
EscO
1B 1B 1B 1B 1B 1B 1B 1B 1B 1B 1B 1B 1B 1B 1B
4F 4F 4F 4F 4F 4F 4F 4F 4F 4F 4F 4F 4F 4F 4F
00 00 00 00 03 0F 1F 3F 3F 7F 7F 7F FC F0 E0
00 00 00 00 F0 FC FE FF FF FF FF FF 0F O3 01
980415-001 Rev.B
2-125
CR
0D 0D 0D 0D 0D 0D 0D OD OD OD OD OD OD OD OD
1 Byte
Data
2-126
980415-001 Rev.B
980415-001 Rev.B
2-127
R Command - Reset
Description Reinitializes printer
NOTE: P520 Laminators can be reset by using the <Esc#<Sp>1<sp> Command Direction Sequence.
2-128
980415-001 Rev.B
980415-001 Rev.B
2-129
Syntax <Esc>RLOGO {p1} Parameters p1 = Optional Logo Name. However, a space <Sp>
must follow the command.
2-130
980415-001 Rev.B
980415-001 Rev.B
2-131
2-132
980415-001 Rev.B
Syntax <Esc>T p1 p2 p3 p4 p5 p6 p7 data vT p1 p2 p3 p4 p5 p6 p7 data Parameters p1 = Horizontal (X) Start Position in dots
p2 = Vertical (Y) Start Position in dots (position of lower case descender, if used) p3 = Rotation & Origin Where:
Value 0 1 2 3 4 5 6 7 Description No rotation 90 degrees 180 degrees 270 degrees No rotation 90 degrees 180 degrees 270 degrees Origin Lower Left Lower Left Lower Left Lower Left Centered Centered Centered Centered
p4 = Font selection Where: 0 = 100 points Normal 1 = 100 points Bold p5 = Horizontal (X-axis) Width (before rotation) of Text (data string) Graphic in dots. If the value is zero the text maintains normal font proportions and scales according to the value of the Y-axis (p6) value.
980415-001 Rev.B
2-133
2-134
980415-001 Rev.B
980415-001 Rev.B
2-135
Syntax <Esc>V{ p1} Parameters p1 = Optional Configuration Parameter (for Parallel I/O)
P310/P320, P420, P520, and P720 Printers) Where: None = Returns Printer Type and Firmware Version. 10 = No error if P310/P320 12 = No error if Magnetic Encoder 13 = No error if Smart Card Docking 14 = No error if Card Flip 20 = No error if Edge-to-Edge Printing 50 = No error if Monochrome Printert 70 = No error if P520 80 = No error if P600 81 = No error if P720 90 = No error if printer also has USB Interface
2-136
980415-001 Rev.B
Parameters data =
Uncompressed or Compressed Monochrome Bit-Map data. The Bit-Map data must match the size and dimensions specified in the proceeding G command.
See Section 1 for the relationship on how Monochrome Bit-Maps relate to data. CHECKSUM = Single byte of XOR data generated from the Image Data. If CHECKSUM is specified by the related G/vG Command, a Checksum must be included here. Remember, any chance Control Characters that appear among the data require a preceding Open Bracket ([) Character. Control characters include Escape (1B hex), Return (OD hex), and the Open Bracket (5B hex).
980415-001 Rev.B
2-137
1 Byte
1B 00 00 00 00 03 0F 1F 3F 3F 7F 7F 7F FC F0 E0 OD 5A 00 00 00 00 F0 FC FE FF FF FF FF FF 0F 03 01
EscZ
Data
CR
2-138
980415-001 Rev.B
Appendix A
This section contains a listing of all fonts, bar codes, and their respective character sets supported by the EPCL Card Printer Programming Language.
980415-001 Rev.B
A-1
based on Normal and Bold. The Fonts are proportionally generated by the printer from 100 Point Normal and 100 Point Bold font descriptions.
Hexadecimal - Most Significant Digit 0 0 1 2 Hexadecimal - Least Significant Digit 3 4 5 6 7 8 9 A B C D E F 0 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 1 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 2 32 ! 33 " 34 # 35 $ 36 % 37 & 38 ' 39 ( 40 ) 41 * 42 + 43 , 44 45 . 46 / 47 3 0 48 1 49 2 50 3 51 4 52 5 53 6 54 7 55 8 56 9 57 : 58 ; 59 < 60 = 61 > 62 ? 63 4 @ 64 A 65 B 62 C 63 D 64 E 69 F 70 G 71 H 72 I 73 J 74 K 75 L 76 M 77 N 78 O 79 5 P 80 Q 81 R 82 S 83 6 7 8 9 A B C D E F ` p 96 112 128 144 160 176 192 208 224 240 a q 97 113 129 145 161 177 193 209 225 241 b r 98 114 130 146 162 178 194 210 226 242 c s 99 115 131 147 163 179 195 211 227 243
T d t 84 100 116 132 148 164 180 196 212 228 244 U e u 85 101 117 133 149 165 181 197 213 229 245 V f v 86 102 118 134 150 166 182 198 214 230 246 W g w 87 103 119 135 151 167 183 199 215 231 247 X h x 88 104 120 136 152 168 184 200 216 232 248 Y i y 89 106 121 137 153 169 185 201 217 233 349 Z j z 90 107 122 138 154 170 186 202 218 234 250 [ k 91 108 123 139 155 171 187 203 219 235 251 \ l 92 109 124 140 156 172 188 204 220 236 252 ] m 93 110 125 141 157 173 189 205 221 237 253 ^ n 94 111 126 142 158 174 190 206 222 238 254 _ o 95 112 127 143 159 175 191 207 223 239 255
A-2
980415-001 Rev.B
Code 39 Code 39 encodes Alphanumeric Characters using five (Code 3 of 9) bars and four spaces. Of the nine, three are wide. The Ra-
tio (R) determines wide-to-narrow bar and space widths. The minimum for a Narrow Bar or Space is three dots or 0.010 inch (0.254 mm). Supported Ratios of narrow bar to wide bar widths are: 2:1, 5:2 (2.5:1), and 3:1. To calculate the full length of a Code 39 Bar Code: L = [ (C+2) (3R + 7) - 1] X
Where: L = Length of Bar Code C = Number of Characters R = Ratio of wide to narrow bars X = Number of Dots times 0.0033 inches per dot (0.0847 mm per dot) For the 5:2 ratio, the X = Dots times 2 The specified minimum recommended height is 0.25 inches (6.35 mm) or 75 dots. The recommend Quiet Zone is 0.25 inches (6.35mm or 75 dots) or, when larger, 10 times X. The set of Characters (49) for Code 39 are as follows:
980415-001 Rev.B
A-3
T 84 100 116 U 85 101 117 V 86 102 118 W 87 103 119 X 88 104 120 Y 89 106 121 Z 90 107 122 91 108 123 92 109 124 93 110 125 94 111 126 95 112 127
A-4
980415-001 Rev.B
Standard 2 of 5 The 2 of 5 Code Symbology encodes all information in (Code 2/5) the width of the bars. Spaces carry no information . Bars
2 of 5 Code supports the numeric characters: 0 through 9 The supported ratio of narrow bar to wide bar widths are: 2:1, 5:2 (2.5:1), and 3:1. To calculate the full length of a 2 of 5 Bar Code: L = [ C (2R + 8) + 14] X Where: L = Length of bar code C = Number of characters R = Ratio of wide to narrow bars (For 5:2, R = 2.5) X = Number of Dots times 0.0033 inches per dot (0.08847 mm per dot) For 5:2 ratio, the X = Dots times 2
are wide or narrow and the Wide Bars are set by the Ratio (R). Spaces are the same width as the narrow bars.
The specified minimum recommended height of a Code 2/5 Bar Code is 0.25 inches (6.35 mm) or 75 dots. The recommend Quiet Zone is 0.25" (6.35mm or 75 dots) or, when larger, 10 times X.
980415-001 Rev.B
A-5
Interleaved 2 of 5 The name Interleaved 2 of 5 derives from the method (Code I 2/5) used to encode two characters. The Bar Code Symbol
pairs two characters, using bars to represent the first character and the interleaved spaces to represent the second character. Therefore, each character has two definitions, one for bars and the other for spaces. Each consists of two wide elements and three narrow elements. Bars and spaces are wide or narrow and the wide bars are set by the Ratio (R). Interleaved Two of Five Code supports the numeric characters: 0 through 9 The printer automatically adds a leading Zero (0) Character) to Code I 2/5 Bar Codes with an odd number of Bar Code Data Characters. The supported ratio of narrow bar to wide bar widths are: 2:1, 2:5 (2.5:1), and 3:1. To calculate the full length of an I 2/5 Bar Code:
L = [ C (2R + 3) + 6 + R ] X Where: L = Length of bar code C = Number of characters R = Ratio of wide to narrow bars (5:2=2.5) X = Number of Dots times 0.0033 inches per dot (0.08847 mm per dot) Where: The minimum recommended height of a Code I 2/5 Bar Code is 0.25 inches (6.35 mm) or 75 dots. Ideally the Bar Code Height should be 15% of the Bar Code Length. The recommend Quiet Zone is 0.25" (6.35mm or 75 dots) or, when larger, 10 times X.
A-6
980415-001 Rev.B
sion of UPC and is usually the version seen on grocery store items in the United States. The symbology encodes 10-digit Universal Product Code numbers. An eleventh digit, at the beginning, indicates the Type of Product, and a twelfth digit is a Module Check Digit. The UPC Code Number and check digit are assigned by: Uniform Code Council (UCC) 8163 Old Yankee Rd., Ste. J, Dayton, OH 45458 Phone (513) 435-3870; Fax: (513) 435-4749 UPC-A code supports the numeric characters: 0 through 9 The printer ignores the Ratio Command Parameter (narrow bar to wide bar width). The equation to calculate the UPC-A Bar Code length is:
L = (91) X Where: L = Length of bar code X = Number of Dots times 0.0033 inches per dot (0.08847 mm per dot) UPC-A Bar Code Height, by specification, is six individual UPC-A bar code characters high. The following equation can be used to calculate the Industry Specified Height in dots. H = (42) X Where: H = Height of Bar Code in dots X = Bar Code Multiplier Multiply the height of the bar code in dots by 0.0033 inches per dot (0.08847 mm per dot) to get the actual height of the Bar Code .
980415-001 Rev.B
A-7
national Article Numbering), is the International Standard Bar Code for retail food packages, corresponding to the Universal Product Code (UPC) in the United States. The symbology encodes a seven-digit EAN-8 number. The printer automatically generates an eighth Check Digit. Numerous international agencies assign EAN Code Numbers and Check Digits. See the list at the end of this appendix. EAN-8 Code supports the numeric characters: 0 through 9 The printer ignores the Ratio Command Parameter (narrow bar to wide bar width). The equation to calculate the EAN-8 Bar Code Length is:
L = (67) X Where: L = Length of bar code X = Number of Dots times 0.0033 inches per dot (0.08847 mm per dot) EAN-8 Bar Code Height, by specification, is six (6) individual EAN-8 bar code characters high. The following equation can be used to calculate the Industry Specified Height in dots. H = (42) X Where: H = Height of Bar Code in Dots X = Bar Code Multiplier Multiply the height of the Bar Code in dots by 0.0033 inches per dot (0.08847 mm per dot) to get the actual Bar Code Height.
A-8
980415-001 Rev.B
Numbering system (EAN) and is a super set of UPC. EAN-13 has the same number of bars as UPC Version A, but encodes a 13th digit. The 12th and 13th digits define the Country Code. The codes 00-04 and 06-09 are assigned to the United States. Numerous international agencies assign the EAN-13 Code Numbers. See the list at the end of this appendix. EAN-13 Code supports the numeric characters: 0 through 9 The printer ignores the Ratio Command Parameter (narrow bar to wide bar width). The equation to calculate the EAN-13 bar code length is:
L = (98) X Where: L = Length of Bar Code X = Number of dots times 0.0033 inches per dot (0.08847 mm per dot) EAN-13 Bar Code Height, by specification, equals six individual EAN-13 Bar Code Characters. The following equation can be used to calculate the Industry Specified Height in dots. H = (42) X Where: H = Height of Bar Code in dots X = Bar Code Multiplier Multiply the height of the Bar Code in dots by 0.0033 inches per dot (0.08847 mm per dot) to get the actual Bar Code Height.
980415-001 Rev.B
A-9
Code 128 Code 128 is a high density Alphanumeric Bar Code. ZeSubsets B & C bra printers in Code 128 B Mode encode single digit alphanumerics as single Bar Code Characters. The printer in Code 128 C Mode encodes two numeric digits as a Single Bar Code Character.
The printer accepts ASCII input data and encodes with a Code 128 Bar Code Value (or digit). The following table shows the Code 128 B Encoded Value and corresponding ASCII Characters supported by the printers. Code 128 C encodes numeric ASCII pairs (i.e., 0 & 5 would encode to the single Code 128 C digit 05. The printers automatically add a leading zero character to data specifying an odd number of Code 128 C Bar Code Characters. The percentile (%) character must preceed another percentile character to encode. Example: %% = %
Encoded Code Value A
0 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 SP ! " # $ % & ' ( ) * + , . / 0 1 2 3 4 5 6 7 8 9 : ; < = > ? @ A B C D
Code B
SP ! " # $ % & ' ( ) * + , . / 0 1 2 3 4 5 6 7 8 9 : ; < = > ? @ A B C D
Code C
00 01 02 03 04 05 06 07 08 09 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36
Code B
E F G H I J K L M N O P Q R S T U V W X Y Z [ \ ] ^ _ . a b c d e f g h i
Code C
37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73
Code B
j k l m n o p q r s t u v w x y z { | } ~ DEL FNC3 FNC2 SHIFT CodeC FNC4 CodeA FNC1 Start A Start B Start C
Code C
74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 CodeB CodeA FNC1 Start A Start B Start C
A-10
980415-001 Rev.B
The printer ignors the Ratio Command Parameter (narrow bar to wide bar width). The equation to calculate the Code 128 B Bar Code length is: L = [ C (11) + 24] X Where: L = Length of bar code C = Number of characters & checksum character X = Number of Dots times 0.0033 inches per dot (0.08847 mm per dot) The equation to calculate the Code 128 C Bar Code Length is: L = [ (11 C) / 2) + 24 ] X Where: L = Length of Bar Code C = Number of characters (rounded up to the next even digit) & checksum character X = Number of dots times 0.0033 inches per dot (0.08847 mm per dot) The minimum recommended height of a Code 128 bar code is 0.25 inches (6.35 mm) or 75 dots. Ideally the Bar Code Height should be 15% of the Bar Code Length. The recommend Quiet Zone is 0.25 inches (6.35mm or 75 dots) or, when larger, 10 times X.
980415-001 Rev.B
A-11
EAN International General Specifications for the Article Symbol Marking Regulation Agencies (1987), EAN Prefix List
EAN International (EAN) Rue Royale 29, B-1000 Bruxelles (Belgium) Reinhold Van Lennep, Secretary General prEN 797 Bar coding - Symbology specifications EAN/UPC NNI P.O. Box 5059, NL-2600 GB DELFT THE NETHERLANDS ANSI 11 West 42nd Street, 13th floor New York, N.Y. 10036, USA Australian EAN Coding Authority Australian Product Numbering Association, Ltd. (APNA), Unit 8, 417 Femtree Gully Rd. Mount Waverlet, Vidoria 3149, Australia England EAN Coding Authority Article Numbering Assoc. (UK) Ltd. (ANA) 11 Kingsway London WC2B 6AR, England Japan EAN Coding Authority Distribution Code Center (DCC) No. 3 TOC-Bldg.7-23-1 Nishigotanda, Shinagawaku, Tokyo 141, Japan Mexico EAN Coding Authority Asociacion Mexicana del Codigo de Producto (AMECOP) Horatio,1855-6O, Col. Polanco, DFCP 11570, Mexico New Zealand EAN Coding Authority New Zealand Product Number Association, Ltd. PO Box 11-110, Wellington, New Zealand South Africa EAN Coding Authority South Africa Numbering Association PO Box 41417, Craighall, 2024, Johannesburg, South Africa
A-12
980415-001 Rev.B
Appendix B
This section contains Status and Error Reporting information for Color and Monochrome Card Printers.
Parallel Port Printer The Busy and Acknowledge signal lines transfer data to Data Handshake the printer only. Signal Lines
Parallel Port Printer The Color Card Printers respond to Error Conditions with Error Response combinations of the Error and Paper Error signals at the
Parallel Interface. Detailed Error Responses are sent via the Serial Port only.
Paper Error 0 0 1 Error 1 0 1 Description No Error Syntax Error Ribbon End or Empty Feeder Mechanical Error
980415-001 Rev.B
B-1
Serial Port Printer Some programs use Acknowledge (ACK) and Not AcData Handshake knowledge (NACK) to display these communication pro-
tocol responses. The ACK response signals Command Accepted, Waiting for Command. The NACK response signals an Error or Check Status condition exists and typically includes a corresponding error or status code. The NACK can also signify an Input Buffer Full condition.
Serial Port Printer The printers respond, via the Serial Port, to various condiError Response tions with Status and Error Codes.
Status and Error Responses have the following format: (NACK)05(EOT) - Card in Magnetic Encoder.
B-2
980415-001 Rev.B
Code -1 01 02 03 04 05 06 10 11 12 13 14 20 21 22 30 31 32 33 34 40 41 42 43 44 45
Error
Status
Condition Mechanical Error - Printer Ribbon Broken/Missing Temperature Mechanical Feeder Empty Card In Encoder Card Not In Encoder Invalid Command or Parameter Invalid Coordinates (Image placement) Unknown Bar Code Reference Unknown Text/Font Reference Unknown Command Bar Code Data Syntax Text Data Syntax Graphic Data Syntax Graphic Image Initialization - Failed Graphic Image Maximum Width Exceeded Graphic Image Maximum Height Exceeded Graphic Image Data Checksum Error Data Transfer Time-out Parameter/Syntax Mag. Encoder Write Mag. Encoder Read/Verify Mag. Encoder Mechanical Mag. Encoder Not Responding 1) Magnetic Stripe Missing 2) Card Jam
980415-001 Rev.B
B-3
B-4
980415-001 Rev.B
Appendix C
This section contains information for operation and formatting for the Magnetic Stripe Encoder.
Magnetic Encoders All printers with Encoders write and read ANSI 4.16 and
ISO 7811/2/3. Encoder Track Positions are fixed and cannot be modified. Two Encoder Read Write Head Mounting Options exist: Below the Card PathThe Standard Mounting that supports down-facing Magnetic Stripes when loading cards Above the Card PathAn Optional Mounting that supports up-facing Magnetic Stripes when loading cards. The Read Write Heads are positioned just beyond the Print Head for both options
Recording Area
980415-001 Rev.B
C-1
When the encoder receives a command, it performs the requested action and reports the result. The printer cannot execute a new Encoder Command prior to completion of the previous Encoder Command. Detailed Encoder (and general printer) Status Information is reported to the host via an Optional Serial Interface Port only. See Appendix B for a detailed listing of printer and encoder responses.
Read The encoder can only read (back to the host) a single track
of data at a time. The &L Command performs read-only operations, see Command Reference, page 2-17. However, the M or m Commands can serve as linking operators for several Read Commands. The Encoder performs each command in the string until completion of the Command String. An Error terminates an M Command String, while command execution resumes with Error Correction for an m Command String. The M command concatenates the read data into a single response to the host. Example of Multiple Read Command String
(Escape and Carriage Returns not shown)
Track 1 data = 1111 Track 2 data = 2222 Track 3 data = 3333 Multiple read command string is:
<Esc>M 1 &L1[&L2[&L3
Data sent to the host, in a single response: 111122223333
Data Errors The Encoder retries, up to six times, any Read or Write
(Write-Verify Read) Operation, before reporting an error.
C-2
980415-001 Rev.B
Encoder Default The Encoder reads and writes standard ANSI/ISO Track Configuration Data formats in the standard ANSI/ISO Track Locations.
The following shows the three standard ANSI/ISO tracks.
Each track can be encoded and decoded with ASCII characters in the standard default ANSI/ISO data formats.
Encoder ANSI/ISO (Default) Track Data Formats Track 1 2 3 Density 210 BPI 75 BPI 210 BPI Data Format 7 Bit (6 data, 1 parity) 5 Bit (4 data, 1 parity) 5 Bit (4 data, 1 parity) Data Characters Space $ ( ) - / Enter 0 through 9 A through Z (All Caps) 0 through 9 0 through 9 Data Separator ^ = =
The ANSI/ISO Data Formats include a Preamble (all zeros), a Start Character, Data (7-bit or 5-bit as specified by ANSI/ISO), a Stop character, and a Longitudinal Redundancy Check Character. The 7-bit Data Format has 6 bits of encoded data and a Parity Bit. The 5-bit Data Format has 4 bits of encoded data and a Parity Bit. The ANSI/ISO Data Formats include a Data Field Separator (or delimiter) that allows parcing of the encoded track data. An example of separate data fields would be the American Bankers Association (ABA) Data Format (normally located on track 2) that includes a Primary Account Number (PAN) Field and an Account Information Field (for Expiration Date, Country Code, etc.). The Encoder reports a Data Error when the total number of Data Characters exceeds the maximum allowed by physical encoding (bit density) and the data format in any read or write data function.
980415-001 Rev.B
C-3
Basic Commands All card printers with Encoders, perform the basic func-
tions of reading and writing to ANSI/ISO Track and Data Formats. The commands for these Basic Encoder Functions are as follows:
Basic Encoder Commands Encode Single Data Track Buffer Single Track Data Encode All Data Tracks Read Single Track Data Page 2-15 2-8 2-16 2-17
Advanced Encoder Printers with Magnetic Stripe Encoders have an ExCommands panded Encoder Command Set. These commands allow
programmers to create Custom Data and Track Formats. The Encoder can be programmed to read and write Custom Data and Formats. The Encoder can be programmed to use Standard ANSI/ISO Data Formats on one or other ANSI/ISO Track Locations. For example, the Encoder can be programmed to read and write ANSI/ISO Track 3 Data Format on Track 1. When in this mode, the Advanced Encoder Commands support encoding of and decoding to host with ASCII Character Data. The Encode automatically adds the selected ANSI/ISO Data Formating. The Encoder reports errors when reading and writing in this mode. The Encoder does not accept ASCII characters that are not part of the selected ANSI/ISO Data Character Set. See Page C-3 for a table containing the character sets. The following lists the Advanced Encoder Commands:
Advanced Encoder Commands Reset Encoder Buffer Track Data Read Single Track Data Change Encoding Direction Change Track Density Custom Write Format Custom Read Format
C-4
980415-001 Rev.B
The encoder does not write data unless the Read Buffer is programmed to read Identical Data Parameters. Otherwise, an error occurs.
Resetting The To ensure a proper Encoder Configuration, the programEncoder To ANSI/ISO mer should reset the Encoder to ANSI/ISO Track Data, Format, Density and Location. Track Defaults
Reset the Encoder to ANSI/ISO defaults with the following command sequence.
Example: (Escape and Carriage Returns not shown) <Esc>&R &CDEW 0 0 &CDER 0 0
The encoder stores the Track Settings in Flash Memory. If the Encoder is powered down, the printer retains the last Encoder Read, Write, and Track Density settings.
Change Track Density The &D Command allows changes in the density of a
track. &D Command changes occur to a given track density without changing the related data format or character set. See Command Reference &D, page 2-14, for command details.
Changing Read The &CDER command serves to change the Read Data Configuration Format Configuration. This command can configure a
given track to: Its ANSI/ISO Data Format. Change it to another ANSI/ISO Track Format. Allow Forward or Reverse Data Reads. Change to Raw Data format, which has Custom Track Data Formating and Data Block Encoding.
980415-001 Rev.B
C-5
The &L Read Command needs to be configured to read Raw (or hexadecimal) Custom Data.
Changing Write The &CDEW Command allows changes to the Read Configurations Data Format Configuration. This command can configure a given track to: Its ANSI/ISO Data Format. Change to another ANSI/ISO track format. Change to Raw Data Format having Custom Track Data Format and Data Block Encoding. The &B Read Command needs to be configured to store to Write Raw (or hexadecimal) Custom Data.
Custom ISO Data The Encoder can be configured to process ISO Track
Data in non-ISO track locations. The printer interprets and processes the ASCII data normally. The Custom Data Control Commands are &D (track density), &CDER (Read Data Format) and the &CDEW (Write Data Format).
The printer automatically read-verifies after a write, so all three commands (&D, &CDER, and &CDEW) must be properly configured to function without reporting a Data Error.
C-6
980415-001 Rev.B
Unique Custom Data The Encoder is capable of reading and writing Formats non-ANSI/ISO Data. The Data Block and the Track Data
String Formatting is stripped away and passed through the Encoder (and printer) without Error Checking, Encoding, or Decoding. The Host sends and receives Raw Hexadecimal Data Strings. Each hexadecimal block sent to the Encoder represents a block of Magnetic Card Encoded Data. The Encoder stripes the Most Significant Bits of the Data Blocks off of each Hexadecimal Block.
Raw Hexadecimal FF AA (1111 1111) (1010 1010) Encode Encoded as 6 bit on Card 111111101010
Decode
Raw Hexadecimal Data, when encoded, requires the following elements in the Final Binary Data String: Preamble dataThe minimum number of leading binary 0 bits (i.e., NUL characters). Note: the NUL (00 hexadecimal) is normally sent to the printer with a character like the @ symbol (40 hexadecimal) and is encoded as all zero bits in 6 (or lower) Bit Data Mode. 75bpi - 20 min., 24 nominal, 1024 max. 210bpi - 40 min., 68 nominal, 1024 max. Start BitThe first binary 1 bit detected starts Data Block Grouping. The LSB (least significant bit) of the first character sited in a data block is the Start Bit. NUL Data BlockWithout NULs enabled, the Encoder terminates the Data String or causes the Data String to restart with a new Start Bit, a Data Block with a 1s bit. NUL Data Block with NULs enabledAllows the inclusion of NUL Data Character Blocks within the data string. Postamblebinary 0 bits, (i.e., NUL characters) fill remainder of track.
980415-001 Rev.B
C-7