EM220II
OPOS Driver Application Develop Guide
P1007752-023
Rev. 1.00
EM220II
- 2 -
OPOS Driver
Application Develop Guide
Table of Contents
1. Manual Information ........................................................................................................ 6
2. Development environment ............................................................................................ 6
2-1 Communication Configuration .................................................................................... 6
3. Property / Method .......................................................................................................... 7
3-1 Printer Type ................................................................................................................ 7
3-2 Property Range / Default Value .................................................................................. 7
3-2-1 Capability property setting value ..................................................................... 7
3-2-2 Property default value / Range ....................................................................... 8
3-2-3 POSPrinter Method ........................................................................................ 8
3-2-4 POSPrinter Escape Sequences ...................................................................... 9
3-2-5 Color bitmap printing support .......................................................................... 9
4. Extended Functions ..................................................................................................... 10
4-1 DirectIO Method ........................................................................................................ 10
4-2 DirectIOEvent Event ................................................................................................. 12
5. Error Information ......................................................................................................... 13
5-1 ResultCode List ........................................................................................................ 13
Rev. 1.00
EM220II
- 3 -
OPOS Driver
Application Develop Guide
■ Proprietary Statements
This manual contains proprietary information of Zebra Technologies Corporation. It is
intended solely for the information and use of parties operating and maintaining the equipment described herein. Such proprietary information may not be used, reproduced, or disclosed to any other parties for any other purpose without the expressed written permission
of Zebra Technologies Corporation.
Product Improvements
Since continuous product improvement is a policy of Zebra Technologies Corporation, all
specifications and signs are subject to change without notice.
FCC Compliance Statement
NOTE: This equipment has been tested and found to comply with the limits or a Class B
digital device, pursuant to Part 15 of the FCC Rules. These limits are designed to provide
reasonable protection against harmful interference in a residential installation. This equipment generates, uses and can radiate radio frequency energy and, if not installed and
used in accordance with the instructions, may cause harmful interference to radio
communications. However, there is no guarantee that interference will not occur in a
particular installation. If this equipment does cause harmful interference to radio or
television reception, which can be determined by turning the equipment off and on, the
user is encouraged to try to correct the interference by one or more of the following
measures:
• Reorient or relocate the receiving antenna.
• Increase the separation between the equipment and receiver.
• Connect the equipment into an outlet or circuit different from that to which the receiver is
connected.
• Consult the dealer or an experienced radio/TV technician for help.
WARNING: Exposure to Radio Frequency radiation. To conform to FCC RF exposure requirements this device shall be used in accordance with the operating conditions and instructions listed in this manual.
NOTE: This unit was tested with shielded cables on the peripheral devices. Shielded
cables must be used with the unit to insure compliance.
Changes or modifications to this unit not expressly approved by Zebra Technologies Corporation could void the user’s authority to operate this equipment.
Rev. 1.00
EM220II
- 4 -
OPOS Driver
Application Develop Guide
Canadian Compliance Statement
This Class B digital apparatus complies with Canadian ICES-003.
Cet appareil numérique de la classe B est conforme á la norme NMB-003 du Canada.
“IC:” before the equipment certification number signifies that the Industry Canada technical
specifications were met. It does not guarantee that the certified product will operate to the
user’s satisfaction.
Liability Disclaimer
Inasmuch as every effort has been made to supply accurate information in this manual,
Zebra Technologies Corporation is not liable for any erroneous information or omissions.
Zebra Technologies Corporation reserves the right to correct any such errors and
disclaims liability resulting therefrom.
No Liability for Consequential Damage
In no event shall Zebra Technologies Corporation or anyone else involved in the creation,
production, or delivery of the accompanying product (including hardware and software) be
liable for any damages whatsoever (including, without limitation, damages for loss of
business profits, business interruption, loss of business information, or other pecuniary
loss) arising out of the use of or the results of use of or inability to use such product, even
if Zebra Technologies Corporation has been advised of the possibility of such damages.
Because some states do not allow the exclusion of liability for consequential or incidental
damages, the above limitation may not apply to you.
Rev. 1.00
EM220II
- 5 -
OPOS Driver
Application Develop Guide
Copyrights
The copyrights in this manual and the label print engine described therein are owned by
Zebra Technologies Corporation. Unauthorized reproduction of this manual or the software
in the label print engine may result in imprisonment of up to one year and fines of up to
$10,000 (17 U.S.C.506). Copyright violators may be subject to civil liability.
This product may contain ZPL® , ZPL II® , and ZebraLinktm programs; Element Energy
Equalizer® Circuit; E3® ; and AGFA fonts. Software © ZIH Corp. All rights reserved
worldwide.
ZebraLink and all product names and numbers are trademarks, and Zebra, the Zebra logo,
ZPL, ZPL II, Element Energy Equalizer Circuit, and E3 Circuit are registered trademarks of
ZIH Corp. All rights reserved worldwide.
Monotype® , Intellifont® and UFST® are trademarks of Monotype Imaging, Inc. registered
in the United States Patent and Trademark Office and may be registered in certain jurisdictions.
AndyTM , CG PalacioTM, CG Century SchoolbookTM, CG TriumvirateTM, CG TimesTM,
Monotype KaiTM, Monotype MinchoTM and Monotype SungTM are trademarks of
Monotype Imaging, Inc. and may be registered in some jurisdictions.
HY Gothic HangulTM is a trademark of Hanyang Systems, Inc.
AngsanaTM is a trademark of Unity Progress Company (UPC) Limited.
Andale® , Arial® , Book Antiqua® , Corsiva® , Gill Sans® , Sorts® and Times New Roman®
are trademarks of The Monotype Corporation registered in the United States Patent and
Trademark Office and may be registered in certain jurisdictions.
Century Gothic™, Bookman Old StyleTM and Century SchoolbookTM are trademarks of
The Monotype Corporation and may be registered in certain jurisdictions.
HGPGothicB is a trademark of the Ricoh company, Ltd. and may be registered in some jurisdictions.
UniversTM is a trademark of Heidelberger Druckmaschinen AG, which may be registered
in certain jurisdictions, exclusively licensed through Linotype Library GmbH, a wholly
owned subsidiary of Heidelberger Druckmaschinen AG.
Futura® is a trademark of Bauer Types SA registered in the United States Patent and
Trademark Office and may be registered in some jurisdictions.
TrueType® is a trademark of Apple Computer, Inc. registered in the United States Patent
and Trademark Office and may be registered in certain jurisdictions.
All other product names are the property of their respective owners.
All other brand names, product names, or trademarks belong to their respective holders.
© 2006 ZIH Corp.
Rev. 1.00
EM220II
- 6 -
OPOS Driver
Application Develop Guide
Printer Model
Baudrate
Printer Type
etc
EM220II
9600/19200/38400/57600/115200
Mono Thermal
203dpi
1. Manual Information
This is a manual about how to set and configure device and to develop applications to use
ZEBRA EM220II printer with OPOS driver.
Before use the printer, set and configure printer by using EM220II OPOS Setup Utility.
Throughout this manual, “OLE for Retail POS” is called “OPOS”.
Throughout this manual, “Unified for Retail POS” is called “UPOS”.
2. Development environment
2-1 Communication Configuration
1) Communication Configuration for serial interface.
You will set communication configuration in EM220II OPOS Setup Utility.
* Check the default communication setting. For more details refer to the user manual
included in the printer package.
Rev. 1.00
- 7 -
OPOS Driver
Application Develop Guide
3. Property / Method
Capability Name
1 Color Thermal : EM220II
CapCompareFirmwareVersion
FALSE
CapPowerReporting
TRUE
CapStatisticsReporting
FALSE
CapUpdateFirmware
FALSE
CapUpdateStatistics
FALSE
CapTransaction
TRUE
CapCoverSensor
TRUE
CapConcurrentRecSlp
FALSE
CapConcurrentJrnSlp
FALSE
CapConcurrentJrnRec
FALSE
CapCharacterSet
TRUE
CapRecUnderline
TRUE
CapRecPageMode
FALSE
CapCuncurrentPageMode
FALSE
CapRecStamp
FALSE
CapRecRotate180
TRUE
CapRecRight90
FALSE
CapRecPapercut
FALSE
CapRecNearEndSensor
FALSE
CapRecMarkFeed
FALSE
CapRecLeft90
FALSE
CapRecItalic
FALSE
CapRecEmptySensor
TRUE
CapRecDwideDhigh
TRUE
CapRecDwide
TRUE
CapRecDhigh
TRUE
CapRecColor
FALSE
CapRecCartridgeSensor
FALSE
CapRecBold
TRUE
CapRecBitmap
TRUE
CapRecBarCode
TRUE
CapRec2Color
FALSE
CapRecPresent
TRUE
3-1 Printer Type
Property value will be determined by the printer type, as shown in the below table.
3-2 Property Range / Default Value
3-2-1 Capability property setting value
EM220II
Rev. 1.00
- 8 -
OPOS Driver
Application Develop Guide
3-2-2 Property default value / Range
Property
Range or Value
RecLineCharsList
“32,42”
RecBitmapList
0,L90,R90,180
CharacterSetList
“437,1(Katakana),850,860,863,865,1252,866,852,858,862,
864,23(Thai42),1253,1254,1257,27(Farsi),1251,737,775,3
1(Thai14),32(Hebrew_old),1255,34(Thai11),35(Thai18),36(
Cyrillic),857,928,39(Thai16),1256”
RecLineHeight
24
RecLineWidth
384
RecLinePaperCut
5
RecLineSpacing
0~127(Default :16)
Method
Value
ChangePrintSide
X
MarkFeed
X
PrintNormal
O
PrintTwoNormal
X
PrintImmediate
O
PrintBarCode
O
PrintBitmap
O
CutPaper
O
ValidateData
O
TransactionPrint
O
SetLogo
O
SetBitmap
O
RotatePrint
O
EndRemoval
X
BeginRemoval
X
EndInsertion
X
BeginInsertion
X
clearPrintArea
O
pageModePrint
X
3-2-3 POSPrinter Method
EM220II
O: Supported X: Not supported
Rev. 1.00
- 9 -
OPOS Driver
Application Develop Guide
3-2-4 POSPrinter Escape Sequences
Escape Sequence
Value
#P
0~100
#fP
0~100
#sP
X
sL X #B O tL O bL O #lF
0~9999
#uF Base Pitch [inch]
O
#rF Maximum[inch]
X
#fT O bC
O
#uC O iC X #rC
X
RvC
O
#sC
X
#fC
X
TbC
X
TpC
X
1C O 2C O 3C O 4C
O
#hC
O
#vC
O
cA O rA O N
O
EM220II
O: Supported X: Not supported
3-2-5 Color bitmap printing support
EM220II OPOS Driver supports following image formats;
- GIF, JPG, BMP Image Format.
The image will be converted into monochrome.
Rev. 1.00
EM220II
- 10 -
OPOS Driver
Application Develop Guide
Parameter
Explanation
Type
Command
Output format
Long
PData
Number of output data / Value defined by command
Long
PString
Output Data
String
Command
Description
DISP_DI_OUTPUT
Output defined pString data
DISP_DI_INTERNATIONAL_CHAR
International characterset define
PTR_DI_EM220II_MSR_READ
Read the MSR data
PTR_DI_ EM220II _MSR_READ_TRACK1
Get the Track 1 information from MSR data
PTR_DI_ EM220II _MSR_READ_TRACK2
Get the Track 2 information from MSR data
PTR_DI_ EM220II _MSR_READ_TRACK3
Get the Track 3 information from MSR data
PTR_DI_ EM220II _MSR_READ_CLEAR
Clear the MSR data
PTR_DI_EM220II_MSR_READ_ENCRYPTION
Read the MSR encryption data
Argument
Command
PTR_DI_OUTPUT
PData
Null
PString
Output data
Description
Sends data without any process after checking printer status.
“PString” is not affected by “BinaryConversion”
Return
Result Code
ResultCodeExtended
OPOS_SUCCESS
0
OPOS_E_CLOSED
0
OPOS_E_CLAIMED
0
OPOS_E_NOTCLAIMED
0
OPOS_E_DISABLED
0
OPOS_E_BUSY
0
OPOS_E_ILLEGAL
0
OPOS_E_OFFLINE
0
OPOS_E_FAILURE
0
4. Extended Functions
This section is to explain DirectIO method. This method will operate properly only with
EM220II printer.
4-1 DirectIO Method
OPOS DirectIO Command
PTR _DI_OUTPUT
Rev. 1.00
- 11 -
OPOS Driver
Application Develop Guide
PTR_DI_INTERNATIONAL_CHAR
Argument
Command
PTR_DI_INTERNATIONAL_CHAR
PData
One of the commands:
PRN_DI_CHAR_USA
PRN_DI_CHAR_FRANCE
PRN_DI_CHAR_GERMANY
PRN_DI_CHAR_UK
PRN_DI_CHAR_DENMARK1
PRN_DI_CHAR_SWEDEN
PRN_DI_CHAR_ITALY
PRN_DI_CHAR_SPAIN1
PRN_DI_CHAR_NORWAY
PRN_DI_CHAR_DENMARK2
PString
Printing position
Description
Sets International character set. If CharacterSet property value is
changed, International character set will be reset.
Return
Result Code
ResultCodeExtended
OPOS_SUCCESS
0
OPOS_E_CLOSED
0
OPOS_E_CLAIMED
0
OPOS_E_NOTCLAIMED
0
OPOS_E_DISABLED
0
OPOS_E_BUSY
0
OPOS_E_ILLEGAL
0
OPOS_E_OFFLINE
0
OPOS_E_FAILURE
0
Argument
Command
PTR_DI_ EM220II _MSR_READ
PData
Null
PString
Null
Description
Read the MSR data.
Return
Result Code
ResultCodeExtended
OPOS_SUCCESS
0
OPOS_E_ILLEGAL
0
Argument
Command
PTR_DI_EM220II _MSR_READ_TRACK1
PTR_DI_ EM220II _MSR_READ_TRACK2
PTR_DI_ EM220II _MSR_READ_TRACK3
PData
Null
PString
Appropriate Track information
Description
Get the Track information from MSR data.
Return
Result Code
ResultCodeExtended
OPOS_SUCCESS
0
OPOS_E_ILLEGAL
0
EM220II
PTR_DI_ EM220II _MSR_READ
PTR_DI_ EM220II _MSR_READ_TRACK
Rev. 1.00
- 12 -
OPOS Driver
Application Develop Guide
PTR_DI_ EM220II _MSR_READ_CLEAR
Argument
Command
PTR_DI_ EM220II _MSR_READ_CLEAR
PData
Null
PString
Null
Description
Clear the MSR data.
Return
Result Code
ResultCodeExtended
OPOS_SUCCESS
0
OPOS_E_ILLEGAL
0
Argument
Command
PTR_DI_ EM220II _MSR_READ_ENCRYPTION
PData
Null
PString
Null
Description
Read the MSR encryption data.
Return
Result Code
ResultCodeExtended
OPOS_SUCCESS
0
OPOS_E_ILLEGAL
0
PTR_DI_ EM220II _MSR_READ_ENCRYPTION
4-2 DirectIOEvent Event
Not used.
EM220II
Rev. 1.00
EM220II
- 13 -
OPOS Driver
Application Develop Guide
Method
Result Code
ResultCodeExtended
ClaimDevice
OPOS_E_ILLEGAL
OPOS_EPTR_UNRECOVERABLE
OPOS_EPTR_MECHANICAL
OPOS_EPTR_CUTTER
OPOS_EPTR_OVERHEAT
OPOS_EPTR_REC_EMPTY
OPOS_EPTR_JRN_EMPTY
Method
Result Code
ResultCodeExtended
CheckHealth
OPOS_SUCCESS
0
OPOS_E_CLOSED
0
OPOS_E_CLAIMED
0
OPOS_E_DISABLED
0
OPOS_E_ILLEGAL
0
OPOS_E_OFFLINE
0
OPOS_E_OFFLINE
0
OPOS_E_FAILURE
OPOS_EPTR_UNRECOVERA BLE
OPOS_EPTR_CUTTER
OPOS_EPTR_MECHANICAL
OPOS_EPTR_OVERHEAT
Argument
Argument
Argument
ClearOutput
OPOS_SUCCESS
0
OPOS_E_CLOSED
0
OPOS_E_CLAIMED
0
OPOS_E_NOTCLAIMED
0
5. Error Information
This section is to explain returned error information when use POSPrinter methods. For
more details, please refer to the UPOS specifications.
5-1 ResultCode List
ClaimDevice
CheckHealth
ClearOutput
Rev. 1.00
- 14 -
OPOS Driver
Application Develop Guide
DirectIO
Method
Result Code
ResultCodeExtended
DirectIO
OPOS_SUCCESS
0
OPOS_E_CLOSED
0
OPOS_E_CLAIMED
0
OPOS_E_NOTCLAIMED
0
OPOS_E_DISABLED
0
OPOS_E_ILLEGAL
0
OPOS_E_OFFLINE
0
OPOS_EPTR_COVER_OPEN
OPOS_E_FAILURE
OPOS_EPTR_UNRECOVERA BLE
OPOS_EPTR_CUTTER
OPOS_EPTR_MECHANICAL
OPOS_EPTR_OVERHEAT
OPOS_E_EXTENDED
OPOS_EPTR_COVER_OPEN
OPOS_EPTR_JRN_EMPTY
OPOS_EPTR_REC_EMPTY
Method
Result Code
ResultCodeExtended
PrintNormal
OPOS_SUCCESS
0
OPOS_E_CLOSED
0
OPOS_E_CLAIMED
0
OPOS_E_NOTCLAIMED
0
OPOS_E_DISABLED
0
OPOS_E_ILLEGAL
0
OPOS_E_OFFLINE
0
OPOS_E_FAILURE
OPOS_EPTR_UNRECOVERA BLE
OPOS_EPTR_CUTTER
OPOS_EPTR_MECHANICAL
OPOS_EPTR_OVERHEAT
OPOS_E_EXTENDED
OPOS_EPTR_COVER_OPEN
OPOS_EPTR_JRN_EMPTY
OPOS_EPTR_REC_EMPTY
Method
Result Code
ResultCodeExtended
PrintImmediate
OPOS_SUCCESS
0
OPOS_E_CLOSED
0
OPOS_E_CLAIMED
0
OPOS_E_NOTCLAIMED
0
OPOS_E_DISABLED
0
OPOS_E_ILLEGAL
0
OPOS_E_OFFLINE
0
OPOS_E_FAILURE
OPOS_EPTR_UNRECOVERA BLE
OPOS_EPTR_CUTTER
OPOS_EPTR_MECHANICAL
OPOS_EPTR_OVERHEAT
OPOS_E_EXTENDED
OPOS_EPTR_COVER_OPEN
OPOS_EPTR_JRN_EMPTY
OPOS_EPTR_REC_EMPTY
PrintNormal
EM220II
PrintImmediate
Rev. 1.00
- 15 -
OPOS Driver
Application Develop Guide
CutPaper
Method
Result Code
ResultCodeExtended
CutPaper
OPOS_SUCCESS
0
OPOS_E_CLOSED
0
OPOS_E_CLAIMED
0
OPOS_E_NOTCLAIMED
0
OPOS_E_DISABLED
0
OPOS_E_ILLEGAL
0
OPOS_E_OFFLINE
0
OPOS_E_FAILURE
OPOS_EPTR_UNRECOVERA BLE
OPOS_EPTR_CUTTER
OPOS_EPTR_MECHANICAL
OPOS_EPTR_OVERHEAT
OPOS_E_EXTENDED
OPOS_EPTR_COVER_OPEN
OPOS_EPTR_JRN_EMPTY
OPOS_EPTR_REC_EMPTY
Method
Result Code
ResultCodeExtended
RotatePrint
OPOS_SUCCESS
0
OPOS_E_CLOSED
0
OPOS_E_CLAIMED
0
OPOS_E_NOTCLAIMED
0
OPOS_E_DISABLED
0
OPOS_E_ILLEGAL
0
OPOS_E_OFFLINE
0
OPOS_E_FAILURE
OPOS_EPTR_UNRECOVERA BLE
OPOS_EPTR_CUTTER
OPOS_EPTR_MECHANICAL
OPOS_EPTR_OVERHEAT
OPOS_E_EXTENDED
OPOS_EPTR_COVER_OPEN
OPOS_EPTR_JRN_EMPTY
OPOS_EPTR_REC_EMPTY
Method Name
Result Code
ResultCodeExtended
PrintBitmap
OPOS_SUCCESS
0
OPOS_E_CLOSED
0
OPOS_E_CLAIMED
0
OPOS_E_NOTCLAIMED
0
OPOS_E_DISABLED
0
OPOS_E_ILLEGAL
0
OPOS_E_OFFLINE
0
OPOS_E_FAILURE
OPOS_EPTR_UNRECOVERA BLE
OPOS_EPTR_CUTTER
OPOS_EPTR_MECHANICAL
OPOS_EPTR_OVERHEAT
OPOS_E_NOEXIST
0
OPOS_E_EXTENDED
OPOS_EPTR_COVER_OPEN
OPOS_EPTR_JRN_EMPTY
OPOS_EPTR_REC_EMPTY
OPOS_EPTR_SLP_EMPTY
OPOS_EPTR_TOOBIG
OPOS_EPTR_BADFORMAT
RotatePrint
EM220II
PrintBitmap
Rev. 1.00
- 16 -
OPOS Driver
Application Develop Guide
SetBitmap
Method
Result Code
ResultCodeExtended
SetBitmap
OPOS_SUCCESS
0
OPOS_E_CLOSED
0
OPOS_E_CLAIMED
0
OPOS_E_NOTCLAIMED
0
OPOS_E_DISABLED
0
OPOS_E_ILLEGAL
0
OPOS_E_OFFLINE
0
OPOS_E_FAILURE
OPOS_EPTR_UNRECOVERA BLE
OPOS_EPTR_CUTTER
OPOS_EPTR_MECHANICAL
OPOS_EPTR_OVERHEAT
OPOS_E_NOEXIST
0
OPOS_E_EXTENDED
OPOS_EPTR_COVER_OPEN
OPOS_EPTR_JRN_EMPTY
OPOS_EPTR_REC_EMPTY
OPOS_EPTR_SLP_EMPTY
OPOS_EPTR_TOOBIG
OPOS_EPTR_BADFORMAT
Method
Result Code
ResultCodeExtended
SetLogo
OPOS_SUCCESS
0
OPOS_E_CLOSED
0
OPOS_E_CLAIMED
0
OPOS_E_NOTCLAIMED
0
OPOS_E_DISABLED
0
OPOS_E_ILLEGAL
0
Method
Result Code
ResultCodeExtended
TransactionPrint
OPOS_SUCCESS
0
OPOS_E_CLOSED
0
OPOS_E_CLAIMED
0
OPOS_E_NOTCLAIMED
0
OPOS_E_DISABLED
0
OPOS_E_ILLEGAL
0
OPOS_E_OFFLINE
0
OPOS_E_FAILURE
OPOS_EPTR_UNRECOVERA BLE
OPOS_EPTR_CUTTER
OPOS_EPTR_MECHANICAL
OPOS_EPTR_OVERHEAT
OPOS_E_NOEXIST
0
OPOS_E_EXTENDED
OPOS_EPTR_COVER_OPEN
OPOS_EPTR_JRN_EMPTY
OPOS_EPTR_REC_EMPTY
OPOS_EPTR_SLP_EMPTY
EM220II
SetLogo
TransactionPrint
Rev. 1.00
www.zebra.com
Zebra Technologies International, LLC Zebra Technologies Europe Limited
333 Corporate Woods Parkway Dukes Meadow
Vernon Hills, Illinois 60061, 3109 USA Millboard Road
Phone: +1.847.634.6700
Toll-Free: +1.800.423.0422
Fax: +1.847.913.8766
Bourne End
Buckinghamshire, SL8 5XF, UK
Phone: +44 (0)1628 556000
Fax: +44 (0)1628 556001
Loading...