Instruction/ maintenance manual of the product 1.8 Citizen Systems
Go to page of 61
CITIZEN OPOS DRIVER 1.8 Application Development Guide '07/07/26 Ver1.00.
CITIZEN OPOS DRIVER 1.8 Appl ication Development Guide 2 Revision Record Date Version Description 07/07/26 V1.00 New issue.
CITIZEN OPOS DRIVER 1.8 Appl ication Development Guide 3 Notes 1. Unauthorized use of all or any p a rt of this document is prohibited. 2. The information in this document is subject t o change without prior notice. 3. This document has been create d with full attention.
CITIZEN OPOS DRIVER 1.8 Appl ication Development Guide 4 1. INTRODUCTION ........................................................................................................................................... 6 1.2. CITIZEN OPOS D RIVER ..........
CITIZEN OPOS DRIVER 1.8 Appl ication Development Guide 5 3.3. C ASH D RAWER S ERVICE O BJECT AN D P ROPERTY R ELATIONS .................................................................... 53 CBM-1000TypeII .............................................
CITIZEN OPOS DRIVER 1.8 Appl ication Development Guide 6 1. Introduction The OPOS Driver complies with OPOS1.8. This docu ment provides the explanati on of device (POS printer)-dependent specifications and precautions.
CITIZEN OPOS DRIVER 1.8 Appl ication Development Guide 7 1.4. Application Developer Application developer who wants to use this driver must be familiar with the foll owing items.
CITIZEN OPOS DRIVER 1.8 Appl ication Development Guide 8 Service Object (SO) Service Object is called b y Control Object and executes the fu nction speci fied by OPOS for each device. It is implement ed as automation s erver and provi des the set of methods called b y CO.
CITIZEN OPOS DRIVER 1.8 Appl ication Development Guide 9 [HKEY_LOCAL_MACHINESOFTWAREOLEforRetailServiceOPOSPOSPrinter] @="" "PRN001"="CT-S2000_1" [HKEY_LOCAL_MACHINESOFTWAREOLEforRetailServiceOPOSPOSPrinterCT-S2000_1] @="CBM.
CITIZEN OPOS DRIVER 1.8 Appl ication Development Guide 10 1.7. CITIZEN OPOS Driver Precautions ・ If the printer power is turned off/on while co nnection to the printer is being est ablished, acquiring status of printer or cash drawer ma y become unsuccessful.
CITIZEN OPOS DRIVER 1.8 Appl ication Development Guide 11 2. CITIZEN OPOS Printer Service Object For the details, meth od of use, etc. of prop erty, method a nd event, re fer to “OpenP OS for OLE Application Programmer's Guide, Japanese Edition, Version 1.
CITIZEN OPOS DRIVER 1.8 Appl ication Development Guide 12 CT-S300/CT-S310 Method Notes Supporting status (CT-S300_*/CT-S310_*) Open { Close { ClaimDevice Notes on Serial I/F connection 7 (Refer to ClaimDevice in 2.6. POS Printer Service Object and Precautions.
CITIZEN OPOS DRIVER 1.8 Appl ication Development Guide 13 CT-S2000 Method Notes Supporting status (CT-S200_*) Open { Close { ClaimDevice Notes on Serial I/F connection 8 (Refer to ClaimDevice in 2.6. POS Printer Service Object and Precautions.) { ReleaseDevice { CheckHealth OPOS_CH_EXTERNAL Only (self diagnostic printing) is supported.
CITIZEN OPOS DRIVER 1.8 Appl ication Development Guide 14 CT-S4000 Method Notes Supporting status (CT-S4000_*) Open { Close { ClaimDevice Notes on Serial I/F connection 9 (Refer to ClaimDevice in 2.6. POS Printer Service Object and Precautions.) { ReleaseDevice { CheckHealth OPOS_CH_EXTERNAL Only (self diagnostic printing) is supported.
CITIZEN OPOS DRIVER 1.8 Appl ication Development Guide 15 CD-S500 Method Notes Supporting status (CD-S500_*) Open { Close { ClaimDevice Notes on Serial I/F connection 9 (Refer to ClaimDevice in 2.6. POS Printer Service Object and Precautions.) { ReleaseDevice { CheckHealth OPOS_CH_EXTERNAL Only (self diagnostic printing) is supported.
CITIZEN OPOS DRIVER 1.8 Appl ication Development Guide 16 2.3. POS Printer Service Object and Property Relations CBM-1000TypeII Property Notes Attribu te Supporting status (CBM1000TYPEII_*) AutoDisable Not applicable with OPOSPrinter R/W × Not supported BinaryConversion (Refer to BinaryConversion in 2.
CITIZEN OPOS DRIVER 1.8 Appl ication Development Guide 17 Property Notes Attribu te Supporting status (CBM1000TYPEII_*) CapConcurrentJrnRec R × Not supported CapConcurrentJrnSlp R × Not supported Ca.
CITIZEN OPOS DRIVER 1.8 Appl ication Development Guide 18 Property Notes Attribu te Supporting status (CBM1000TYPEII_*) CapSlpRight90 R × Not supported CapSlpRotate180 R × Not supported CapSlpUnderl.
CITIZEN OPOS DRIVER 1.8 Appl ication Development Guide 19 Property Notes Attribu te Supporting status (CBM1000TYPEII_*) RecLineChars The Font size is changed depending on the set value. Select the value from RecLineCharsList property. (Refer to RecLineChars/ RecLineCharsLis Property in 2.
CITIZEN OPOS DRIVER 1.8 Appl ication Development Guide 20 CT-S300/CT-S310 Property Notes Attribu te Supporting status (CT-S300_*/ CT-S 310_*) AutoDisable Not applicable with OPOSPrinter R/W × Not supported BinaryConversion 1 (Refer to BinaryConversion in 2.
CITIZEN OPOS DRIVER 1.8 Appl ication Development Guide 21 Property Notes Attribu te Supporting status (CT-S300_*/ CT-S 310_*) DeviceDescription R { CITIZEN Thermal POSPrinter DeviceName R { CT-S300: &.
CITIZEN OPOS DRIVER 1.8 Appl ication Development Guide 22 Property Notes Attribu te Supporting status (CT-S300_*/ CT-S 310_*) CapSlpDwideDhigh R × Not supported CapSlpEmptySensor R × Not supported C.
CITIZEN OPOS DRIVER 1.8 Appl ication Development Guide 23 Property Notes Attribu te Supporting status (CT-S300_*/ CT-S 310_*) JrnCurrentCartridge R/W × Not supported RecLineChars According to the value, the Font size is changed. Value should be chosen from RecLineCharsList property.
CITIZEN OPOS DRIVER 1.8 Appl ication Development Guide 24 CT-S2000 Property Notes Attribu te Supporting status (CT-S2000_*) AutoDisable Not applicable with OPOSPrinter R/W × Not supported BinaryConversion 1 (Refer to BinaryConversion in 2.6 POS Printer Service Object and Precautions.
CITIZEN OPOS DRIVER 1.8 Appl ication Development Guide 25 Property Notes Attribu te Supporting status (CT-S2000_*) CapTransaction R { TRUE: Batch processing of characters is possible.
CITIZEN OPOS DRIVER 1.8 Appl ication Development Guide 26 Property Notes Attribu te Supporting status (CT-S2000_*) CapSlpBothSidesPrint R × Not supported CapSlpCartridgeSensor R × Not supported CapSlpColor R × Not supported AsyncMode 1 (Refer to AsyncMode Property in 2.
CITIZEN OPOS DRIVER 1.8 Appl ication Development Guide 27 Property Notes Attribu te Supporting status (CT-S2000_*) RecLineChars According to the value, the Font size is changed. Value should be chosen from RecLineCharsList property. 1 (Refer to RecLineChars/ RecLineCharsLis Property in 2.
CITIZEN OPOS DRIVER 1.8 Appl ication Development Guide 28 CT-S4000 Property Notes Attribu te Supporting status (CT-S4000_*) AutoDisable Not applicable with OPOSPrinter R/W × Not supported BinaryConversion 1 (Refer to BinaryConversion in 2.6 POS Printer Service Object and Precautions.
CITIZEN OPOS DRIVER 1.8 Appl ication Development Guide 29 Property Notes Attribu te Supporting status (CT-S4000_*) CapTransaction R { TRUE: Batch processing of characters is possible.
CITIZEN OPOS DRIVER 1.8 Appl ication Development Guide 30 Property Notes Attribu te Supporting status (CT-S4000_*) CapSlpCartridgeSensor R × Not supported CapSlpColor R × Not supported AsyncMode 1 (Refer to AsyncMode Property in 2.6 POS Printer Service Object and Precautions.
CITIZEN OPOS DRIVER 1.8 Appl ication Development Guide 31 Property Notes Attribu te Supporting status (CT-S4000_*) RecLineCharsList 1 (Refer to RecLineChars/ RecLineCharsLis Property in 2.6 POS Printer Service Object and Precautions.) R { 80 mm paper "42, 56, 64 " "48, 64, 72" 82.
CITIZEN OPOS DRIVER 1.8 Appl ication Development Guide 32 CD-S500 Property Notes Attribu te Supporting status (CD-S500_*) AutoDisable Not applicable with OPOSPrinter R/W × Not supported BinaryConversion 1 (Refer to BinaryConversion in 2.6 POS Printer Service Object and Precautions.
CITIZEN OPOS DRIVER 1.8 Appl ication Development Guide 33 Property Notes Attribu te Supporting status (CD-S500_*) DeviceDescription R { CITIZEN Dot Matrix POSPrinter DeviceName R { "CD-S500".
CITIZEN OPOS DRIVER 1.8 Appl ication Development Guide 34 Property Notes Attribu te Supporting status (CD-S500_*) CapSlpEmptySensor R × Not supported CapSlpItalic R × Not supported CapSlpLeft90 R ×.
CITIZEN OPOS DRIVER 1.8 Appl ication Development Guide 35 Property Notes Attribu te Supporting status (CD-S500_*) RecLineChars According to the value, the Font size is changed. Value should be chosen from RecLineCharsList property. 2 (Refer to RecLineChars/ RecLineCharsLis Property in 2.
CITIZEN OPOS DRIVER 1.8 Appl ication Development Guide 36 2.4. POS Printer Service Object and OPOS Escape Se quence Relations CBM-1000TypeII Escape Sequence Notes Supporting status (CBM-1000TYPEII_*) Paper cut ESC|#P { 0-100 Full cut/Partial cut depends on the model.
CITIZEN OPOS DRIVER 1.8 Appl ication Development Guide 37 CT-S3000/CT-S310 Escape Sequence Notes Supporting status (CT-S300_*/CT-S310_*) Paper cut ESC|#P { 0-100 Feed and paper cut ESC|#fP { 0-100 Fee.
CITIZEN OPOS DRIVER 1.8 Appl ication Development Guide 38 CT-S2000 Escape Sequence Notes Supporting status (CT-S2000_*) Paper cut ESC|#P { 0-100 Feed and paper cut ESC|#fP { 0-100 Feed, cut, and stamp print ESC|#sP × Not supported Bitmap print ESC|#B After Bitmap printing, print position returns to the initial state (left- justified).
CITIZEN OPOS DRIVER 1.8 Appl ication Development Guide 39 CT-S4000 Escape Sequence Notes Supporting status (CT-S4000_*) Paper cut ESC|#P { 0-100 Feed and paper cut ESC|#fP { 0-100 Feed, cut, and stamp print ESC|#sP × Not supported Bitmap print ESC|#B After Bitmap printing, print position returns to the initial state (left- justified).
CITIZEN OPOS DRIVER 1.8 Appl ication Development Guide 40 CD-S500 Escape Sequence Notes Supporting status (CD-S500_*) Paper cut ESC|#P { 0-100 Feed and paper cut ESC|#fP { 0-100 Feed, cut, and stamp print ESC|#sP × Not supported Bitmap print ESC|#B After Bitmap printing, print position returns to the initial state (left- justified).
CITIZEN OPOS DRIVER 1.8 Appl ication Development Guide 41 2.5. POS Printer Service Obje ct and Event Relations CBM-1000TypeII Event Notes Supporting status (CBM1000TYPEII_*) DataEvent Not applicable with OPOSPrinter × DirectIOEvent × ErrorEvent { OutputCompleteEvent 222 (Refer to OutPutID property/ OutputCompleteEvent event in 2.
CITIZEN OPOS DRIVER 1.8 Appl ication Development Guide 42 CT-S4000 Event Notes Supporting status (CT-S4000_*) DataEvent Not applicable with OPOSPrinter × DirectIOEvent × ErrorEvent { OutputCompleteEvent 222 (Refer to OutPutID property/ OutputCompleteEvent event in 2.
CITIZEN OPOS DRIVER 1.8 Appl ication Development Guide 43 2.6. POS Printer Service Ob ject and Precautions ClaimDevice Method No identical serial port ( COM*) specified by the Wi ndows driver is not usable in the connection of serial interface. When t his method is exec uted in this connection, “OPOS_E_TIMEOUT” is returned.
CITIZEN OPOS DRIVER 1.8 Appl ication Development Guide 44 SetBitmap Method/ESC|#B Escape Sequence Bitmap is registered by specifying Bitmap n umber (1 - 20) us ing the SetBitmap method and bitmap printing is carried out b y specifying the register ed number in th e ESC|#B escape sequence.
CITIZEN OPOS DRIVER 1.8 Appl ication Development Guide 45 AsyncMode Property ・ TRUE Output metho d (PrintNormal, PrintTwoNormal , CutPaper, RotatePrint, PrintBarCode, and PrintBitmap) is exec uted asynchronously. ・ FALSE Output metho d is printed synchronously.
CITIZEN OPOS DRIVER 1.8 Appl ication Development Guide 46 + Chr$(&H33) + Chr$(&H33) _ + Chr$(&H30) + Chr$(&H3D) _ + Chr$(&H30) + Chr$(&H3A) _ + Chr$(&H34) + Chr$(&H31) .
CITIZEN OPOS DRIVER 1.8 Appl ication Development Guide 47 OutPutID Property/ OutputCompleteEvent Event Identifier of asynchr onous output st arted just before is r etained and incr emented by +1 with the following output.
CITIZEN OPOS DRIVER 1.8 Appl ication Development Guide 48 RecLineChars/ RecLineCharsLis t Property The number of on e-byte characters of the font printed in one line on th e paper is specified. ・ RecLineChars proper ty: Specifies the maximum number of digits of FontA corresponding to t he specified paper size.
CITIZEN OPOS DRIVER 1.8 Appl ication Development Guide 49 CT-S2000 Paper Size (mm) FontA(12*24dot ) FontB(9*24dot) FontC (8*16dot) RecLineChars RecLineCharsList 30 40 45 30 30, 4 0, 45 30 40 45 35 46 .
CITIZEN OPOS DRIVER 1.8 Appl ication Development Guide 50 RecSidewaysMaxChars Property Calculated based on one-byte character. Kanji font (KANJI) is basi cally treated as tw o characters but some font selected by the value of the RecLineChars property may not correspond t o two characters simply.
CITIZEN OPOS DRIVER 1.8 Appl ication Development Guide 51 3. Cash Drawer Service Object For the details, meth od of use, etc. of prop erty, method a nd event, re fer to “OpenP OS for OLE Application Programmer's Guide, Japanese Edition, Version 1.
CITIZEN OPOS DRIVER 1.8 Appl ication Development Guide 52 CT-S4000 Method Notes Supporting status (CT-S4000_*.CD*) Open { Close { ClaimDevice { ReleaseDevice { CheckHealth { OPOS_CH_EXTERNAL ClearInput Not applicable with OPOSDrawer. × ClearOutput Not applicable with OPOSDrawer.
CITIZEN OPOS DRIVER 1.8 Appl ication Development Guide 53 3.3. Cash Drawer Service Obje ct and Property Relations CBM-1000TypeII Property Notes Attri bute Supporting status (CBM1000TYPEII_*.CD*) AutoDisable Not applicable with OPOSDrawer. R/W × BinaryConversion Not applicable wi th OPOSDrawer.
CITIZEN OPOS DRIVER 1.8 Appl ication Development Guide 54 CT-S300/CT-S310 Property Notes Attri bute Supporting status (CT-S300_*.CD*/CT-S310_*.CD*) AutoDisable Not applicable with OPOSDrawer.
CITIZEN OPOS DRIVER 1.8 Appl ication Development Guide 55 CT-S2000 Property Notes Attri bute Supporting status (CT-S2000_*.CD*) AutoDisable Not applicable with OPOSDrawer.
CITIZEN OPOS DRIVER 1.8 Appl ication Development Guide 56 CT-S4000 Property Notes Attri bute Supporting status (CT-S4000_*.CD*) AutoDisable Not applicable with OPOSDrawer.
CITIZEN OPOS DRIVER 1.8 Appl ication Development Guide 57 CD-S500 Property Notes Attri bute Supporting status (CD-S500_*.CD*) AutoDisable Not applicable with OPOSDrawer.
CITIZEN OPOS DRIVER 1.8 Appl ication Development Guide 58 3.4. Cash Drawer Service Object and Event Relations CBM-1000TypeII Event Notes Supporting status (CBM1000TYPEII_*.CD*) DataEvent Not applicable with OPOSDrawer. × Not supported DirectIOEvent × Not supported ErrorEvent Not applicable with OPOSDrawer.
CITIZEN OPOS DRIVER 1.8 Appl ication Development Guide 59 CD-S500 Event Notes Supporting status (CD-S500_*.CD*) DataEvent Not applicable with OPOSDrawer. × Not supported DirectIOEvent × Not supported ErrorEvent Not applicable with OPOSDrawer. × Not supported OutputCompleteEvent Not applicable with OPOSDrawer.
CITIZEN OPOS DRIVER 1.8 Appl ication Development Guide 60 3.5. Cash Drawer Service Object and Precautions CapPowerReporting/ Powerm otify/ PowerState Property This service object supp orts only cash draw er connected t o the drawer ki ck connecto r at the back of the printer .
CITIZEN OPOS DRIVER 1.8 Appl ication Development Guide 61 CITIZEN OPOS DRIVER 1.8 Application Development Guide '07/07/26 Ver1.00 C I T I Z E N S Y S T E M S J A P A N C O .
An important point after buying a device Citizen Systems 1.8 (or even before the purchase) is to read its user manual. We should do this for several simple reasons:
If you have not bought Citizen Systems 1.8 yet, this is a good time to familiarize yourself with the basic data on the product. First of all view first pages of the manual, you can find above. You should find there the most important technical data Citizen Systems 1.8 - thus you can check whether the hardware meets your expectations. When delving into next pages of the user manual, Citizen Systems 1.8 you will learn all the available features of the product, as well as information on its operation. The information that you get Citizen Systems 1.8 will certainly help you make a decision on the purchase.
If you already are a holder of Citizen Systems 1.8, but have not read the manual yet, you should do it for the reasons described above. You will learn then if you properly used the available features, and whether you have not made any mistakes, which can shorten the lifetime Citizen Systems 1.8.
However, one of the most important roles played by the user manual is to help in solving problems with Citizen Systems 1.8. Almost always you will find there Troubleshooting, which are the most frequently occurring failures and malfunctions of the device Citizen Systems 1.8 along with tips on how to solve them. Even if you fail to solve the problem, the manual will show you a further procedure – contact to the customer service center or the nearest service center
