Zebra Technologies P1061668-001 manual

P1061668-001 Rev . A Zebra ® Kiosk OPOS Driver User Guide[...]

© 2013 ZIH Corp. The copyrights in this manual and the software and/or firmware in the printer described therein are owned by ZIH Corp. and Zebra’ s licensors. Unauthorized reproduction of this manual or the software and/or firmware in the printer may result in imprisonment of up to one year and fines of up to $10,000 (17 U.S.C.506). Copyright v[...]

11/25/2013 OPOS Driver User Guide P1061668-001 Rev . A Contents Who Should Use This Document ............................................ 3 Core Companies ..................................................... 4 Document Conv entions ................................................... 5 Kiosk OPOS Driver Installation ................................[...]

Contents 2 P1061668-001 Rev . A OPOS Driver User Guide 11/25/2013 Proper ties ............................................................ 3 3 CapCharacterSet Proper ty ............................................ 3 3 CapRecMarkFeed Proper ty ............................................ 3 3 CapRecNearEndSensor Proper ty ............................[...]

11/25/2013 OPOS Driver User Guide P1061668-001 Rev . A About This Document This section provides you with contact information, additional references, and document conventions. Who Should Use This Document The Kiosk OPOS Driver User Guide is targeted to an application developer who requires access to POS-specific peripheral devices. OPOS Inf ormatio[...]

About This Document Who Should Use This Document 4 P1061668-001 Rev . A OPOS Driver User Guide 11/25/2013 OLE f or Retail POS Committee Core Companies • Epson • Fujitsu-ICL • Microsoft • NCR — plus — • OPOS-Japan • OPOS-Europe[...]

5 Document Con ventions 11/25/2013 OPOS Driver User Guide P1061668-001 Rev . A Document Con ventions The following conventions are used throughout this document to convey certain information. Alternate Color (online only) Cross-references contain hot links to other sections in this guide. If you are viewing this guide online in .pdf format, you can[...]

Document Conv entions 6 P1061668-001 Rev . A OPOS Driver User Guide 11/25/2013[...]

11/25/2013 OPOS Driver User Guide P1061668-001 Rev . A Kiosk OPOS Driver Installation Kiosk OPOS Driver Installation The following sections describe: • Har dwar e Requir ements on page 7 • Compatible Operating Systems on page 7 • Befor e Installing the OPOS Driver on page 8 • Installing the OPOS Driver on page 8 • T esting the Installatio[...]

Kiosk OPOS Driver Installation Kiosk OPOS Driver Installation 8 P1061668-001 Rev . A OPOS Driver User Guide 11/25/2013 Bef ore Installing the OPOS Driver Before you start installing the OPOS Driver , install the appropriate Kiosk Printer Driver and power on your printer . Installing the OPOS Driver After you install the appropriate Kiosk Printer Dr[...]

9 Kiosk OPOS Driver Installation Kiosk OPOS Driver Installation 11/25/2013 OPOS Driver User Guide P1061668-001 Rev . A The list of available drivers appear . 4. In the Kiosk OPOS Driver row , click Download . The End User License Agreement appears. 5. Click Accept and Begin Download Now , and save the zebra-kiosk-opos-driver- installer 1-1 1-1-2.ex[...]

Kiosk OPOS Driver Installation Kiosk OPOS Driver Installation 10 P1061668-001 Rev . A OPOS Driver User Guide 11/25/2013 The W elcome screen appears. 8. Click Next. The License Agreement appears. 9. Click the I Agree check box, and then click Next . 10. Read the Important Information , and then click Next .[...]

11 Kiosk OPOS Driver Installation Kiosk OPOS Driver Installation 11/25/2013 OPOS Driver User Guide P1061668-001 Rev . A A message appears indicating that the setup is completing. 11. Click Next to begin the installation. The Updating Y our System dialog appears. Note • A command prompt appears briefly as the files are being copied.[...]

Kiosk OPOS Driver Installation Kiosk OPOS Driver Installation 12 P1061668-001 Rev . A OPOS Driver User Guide 11/25/2013 When the update is complete, the following dialog appears. 12. In the Select Printer area, select the Kiosk printer that you want to use with the OPOS driver , click Install OPOS driver , and then click OK . The following dialog a[...]

13 Kiosk OPOS Driver Installation Kiosk OPOS Driver Installation 11/25/2013 OPOS Driver User Guide P1061668-001 Rev . A T esting the Installation When the driver is installed a link to the test application can be found in the Start menu OPOS_T est folder or All ProgramsKiosk OPOS Driver Installer folder . 1. Click Start > All Programs > Kios[...]

Kiosk OPOS Driver Installation Kiosk OPOS Driver Installation 14 P1061668-001 Rev . A OPOS Driver User Guide 11/25/2013 2. In the Open Name box, type the full name of the Kiosk printer (e.g., Zebra TTP 2030, Zebra KR203). 3. Click Open , Claim, then Enable to connect the OPOS Printer Service Object T est T ool with the printer . • When connected,[...]

11/25/2013 OPOS Driver User Guide P1061668-001 Rev . A Kiosk Modifications of the OLE for Retail POS OLE f or Retail POS Controls The goal of this document is to provide an overview and programming guide for the Zebra Kiosk OPOS driver implementation. For full reference of OLE for Retail POS please download the full manual at http://www .nrf-arts.o[...]

Kiosk Modifications of the OLE for Retail POS How an Application Uses an OPOS Control 16 P1061668-001 Rev . A OPOS Driver User Guide 11/25/2013 Ho w an Application Uses an OPOS Contr ol The first action the application must take on the Control is to call its Open method. The parameter of this method selects a device name to associate with the Contr[...]

17 Kiosk Modifications of the OLE for Retail POS Summary of Common Properties, Methods, and Events 11/25/2013 OPOS Driver User Guide P1061668-001 Rev . A Summary of Common Properties, Methods, and Events T able 1 • Common Pr operties Name V er T ype Access Zebra Kiosk Printer Supported Properties AutoDisable 1.2 Boolean R/W NO CapCompareFirmwareV[...]

Kiosk Modifications of the OLE for Retail POS Summar y of Common Proper ties , Methods, and Ev ents 18 P1061668-001 Rev . A OPOS Driver User Guide 11/25/2013 T able 2 • Common Methods Name V er Zebra Kiosk Printer Supported Methods Open 1.0 YES Close 1.0 YES ClaimDevice 1.0 YES Claim — Special addition ReleaseDevice 1.0 YES CheckHealth 1.0 NO C[...]

19 Kiosk Modifications of the OLE for Retail POS DirectIO Method 11/25/2013 OPOS Driver User Guide P1061668-001 Rev . A DirectIO Method Syntax LONG DirectIO (LONG Command , LONG* pData , BSTR* pString ); P arameters This table identifies the parameters for this format: Remarks Call to communicate directly with the Service Object. This method provid[...]

Kiosk Modifications of the OLE for Retail POS DirectIO Method 20 P1061668-001 Rev . A OPOS Driver User Guide 11/25/2013 The calling application has to prepare the DirectIO function with the following data: {STX} and the printout with the following data: {ETX}. After sending of {STX} you can send all valid KPL commands to the printer but they have t[...]

21 Kiosk Modifications of the OLE for Retail POS Events 11/25/2013 OPOS Driver User Guide P1061668-001 Rev . A Events ErrorEvent Event Remarks Fired when an error is detected and the Control’ s State transitions into the error state. Input error events are not delivered until the DataEventEnabled property is TRUE, so that proper application seque[...]

Kiosk Modifications of the OLE for Retail POS POS Printer Summar y 22 P1061668-001 Rev . A OPOS Driver User Guide 11/25/2013 ControlObjectDescription 1.0 String R — YES ControlObjectV ersion 1.0 Long R — YES ServiceObjectDescription 1.0 String R Open YES ServiceObjectV ersion 1.0 Long R Open YES DeviceDescription 1.0 String R Open YES DeviceNam[...]

23 Kiosk Modifications of the OLE for Retail POS POS Printer Summary 11/25/2013 OPOS Driver User Guide P1061668-001 Rev . A CapRecBitmap 1.0 Boolean R Open YES CapRecBold 1.0 Boolean R Open YES CapRecCartridgeSensor 1.5 Long R Open NO CapRecColor 1.5 Long R Open NO CapRecDhigh 1.0 Boolean R Open YES CapRecDwide 1.0 Boolean R Open YES CapRecDwideDhi[...]

Kiosk Modifications of the OLE for Retail POS POS Printer Summar y 24 P1061668-001 Rev . A OPOS Driver User Guide 11/25/2013 CapSlpNearEndSensor 1.0 Boolean R Open NO CapSlpRight90 1.0 Boolean R Open NO CapSlpRotate180 1.0 Boolean R Open NO CapSlpUnderline 1.0 Boolean R Open NO AsyncMode 1.0 Boolean R/W Open YES CartridgeNotify 1.5 Long R/W Open NO[...]

25 Kiosk Modifications of the OLE for Retail POS POS Printer Summary 11/25/2013 OPOS Driver User Guide P1061668-001 Rev . A JrnLetterQuality 1.0 Boolean R/W Open, Claim, & Enable NO JrnEmpty 1.0 Boolean R Open, Claim, & Enable NO JrnNearEnd 1.0 Boolean R Open, Claim, & Enable NO JrnCartridgeState 1.5 Long R Open, Claim, & Enable NO [...]

Kiosk Modifications of the OLE for Retail POS POS Printer Summar y 26 P1061668-001 Rev . A OPOS Driver User Guide 11/25/2013 SlpLineCharsList 1.0 String R Open NO SlpLineHeight 1.0 Long R/W Open, Claim, & Enable NO SlpLineSpacing 1.0 Long R/W Open, Claim, & Enable NO SlpLineW idth 1.0 Long R Open, Claim, & Enable NO SlpLetterQuality 1.0[...]

27 Kiosk Modifications of the OLE for Retail POS POS Printer Summary 11/25/2013 OPOS Driver User Guide P1061668-001 Rev . A CheckHealth 1.0 Open, Claim, & Enable YES ClearInput 1.0 Not Supported NO ClearOutput 1.0 Open & Claim YES DirectIO 1.0 Open YES compareFirmwareV ersion 1.9 — NO resetStatistics 1.8 — NO retrieveStatistics 1.8 — [...]

Kiosk Modifications of the OLE for Retail POS General Inf or mation 28 P1061668-001 Rev . A OPOS Driver User Guide 11/25/2013 General Inf ormation The POS Printer follows the general output model, with some enhancements: Printer out-of-paper and cover open conditions are reported by setting the ResultCode to OPOS_E_EXTENDED and then setting ResultC[...]

29 Kiosk Modifications of the OLE for Retail POS General Information 11/25/2013 OPOS Driver User Guide P1061668-001 Rev . A Data Characters and Escape Sequences The following escape sequences are recognized. If an escape sequence specifies an operation that is not supported by the printer station, then it is ignored. One Shots Perform indicated act[...]

Kiosk Modifications of the OLE for Retail POS General Inf or mation 30 P1061668-001 Rev . A OPOS Driver User Guide 11/25/2013 Print Mode Characteristics that are remembered until explicitly changed. Feed units ESC |#uF Feed the paper forward by mapping mode units. The character ‘#’ is replaced by an ASCII decimal string telling the number of un[...]

31 Kiosk Modifications of the OLE for Retail POS General Information 11/25/2013 OPOS Driver User Guide P1061668-001 Rev . A Print Line Characteristics that are reset at the end of each print method or by a “Normal” sequence. T able 11 • Print Line Data Characters and Escape Sequences Name Data Remarks Zebra Kiosk Printer Supported Bold ESC |([...]

Kiosk Modifications of the OLE for Retail POS General Inf or mation 32 P1061668-001 Rev . A OPOS Driver User Guide 11/25/2013 Scale horizontally ESC |#hC Prints with the width scaled ‘#’ times the normal size, where ‘#’ is replaced by an ASCII decimal string. YES, max value 7 Scale vertically ESC |#vC Prints with the height scaled ‘#’ t[...]

33 Kiosk Modifications of the OLE for Retail POS Properties 11/25/2013 OPOS Driver User Guide P1061668-001 Rev . A Pr oper ties CapCharacterSet Pr oper ty Added in Release 1.1, Updated in Release 1.5 Syntax LONG CapCharacterSet Remarks Holds the default character set capability . It is PTR_CCS_WINDOWS for Kiosk printer . This property is initialize[...]

Kiosk Modifications of the OLE for Retail POS Proper ties 34 P1061668-001 Rev . A OPOS Driver User Guide 11/25/2013 CharacterSetList Pr oper ty “999” for Kiosk printer . FontT ypefaceList Pr oper ty Added in Release 1.1 There are two fonts supported in the Kiosk printer; a small Monospac821 BT and a larger Lucida Console. MapMode Pr oper ty The[...]

35 Kiosk Modifications of the OLE for Retail POS Properties 11/25/2013 OPOS Driver User Guide P1061668-001 Rev . A RecLineSpacing Pr oper ty The value of RecLineSpacing is initialized to the printer ’ s default line spacing when the device is first enabled following the Open method. The value is approximately 7/10 of the RecLineHeight. RecLinesT [...]

Kiosk Modifications of the OLE for Retail POS Methods 36 P1061668-001 Rev . A OPOS Driver User Guide 11/25/2013 Methods CutP aper Method The Percentage parameter indicates the percentage of paper to cut. The constant identifier PTR_CP_FULLCUT or the value 100 causes a full paper cut. A full cut and 50% cut are the only valid values for the Kiosk pr[...]

37 Kiosk Modifications of the OLE for Retail POS Methods 11/25/2013 OPOS Driver User Guide P1061668-001 Rev . A The Symbology parameter values for this release are: T able 12 • One Dimensional Symbologies V alue Meaning PTR_BCS_UPCA UPC-A — PTR_BCS_UPCA_S UPC-A with supplemental barcode (Not valid) PTR_BCS_UPCE UPC-E (Not valid) PTR_BCS_UPCE_S [...]

Kiosk Modifications of the OLE for Retail POS Methods 38 P1061668-001 Rev . A OPOS Driver User Guide 11/25/2013 Remarks Call to print a barcode on the specified printer station. If the property RotateSpecial indicates that the barcode is to be rotated, then perform the rotation. The Height, W idth, and T extPosition parameters are applied to the ba[...]

39 Kiosk Modifications of the OLE for Retail POS Methods 11/25/2013 OPOS Driver User Guide P1061668-001 Rev . A SetBitmap Method Remarks Call to save information about a bitmap for later printing. The bitmaps may be no bigger then approximately 5000 bytes all together otherwise the printer cannot load it. Only 2 bitmaps may be set, and each bitmap [...]

Kiosk Modifications of the OLE for Retail POS Methods 40 P1061668-001 Rev . A OPOS Driver User Guide 11/25/2013[...]

[...]

Zebra T echnologies Corporation Zebra Technologies Corporation 475 Half Day Road, Suite 500 Lincolnshire, IL 60069 USA T: +1 847 634 6700 Toll-free +1 866 230 9494 F: +1 847 913 8766 Zebra T echnologies Eur ope Limited Dukes Meadow Millboard Road Bourne End Buckinghamshire, SL8 5XF , UK T : +44 (0)1628 556000 F: +44 (0)1628 556001 Zebra T echnologi[...]