Star JavaPOS Driver for mCollection - Software Manual - Rev. 1.
Contents 1. Getting Started............................................................................................. 3 2. Operating Environment.............................................................................. 4 2.1 Operating System......................................................................................................... 4 2.2 Java Operation Environment..................................................................................... 4 2.3 Supported Models.............
Star JavaPOS Driver Software Manual 1. Getting Started Star JavaPOS driver offers full compliance with the JavaPOS Ver. 1.13. This manual supports the following Star JavaPOS driver packages. ▪ starjavapos_mCollection_1.13.x*_windows_32bit.zip ▪ starjavapos_mCollection_1.13.x*_windows_64bit.zip ▪ starjavapos_mCollection_1.13.x*_linux_32bit.zip ▪ starjavapos_mCollection_1.13.x*_linux_64bit.zip ▪ starjavapos_mCollection_1.13.x*_mac.zip * x : Version No.
Star JavaPOS Driver Software Manual 2. Operating Environment 2.1 Operating System This software supports the following operating systems. ▪ Windows 10* 32-bit and 64-bit (except Windows 10 Mobile and Windows 10 IoT Core) Windows 8.1* 32-bit and 64-bit (except Windows RT 8.1) Windows 8 * 32-bit and 64-bit (except Windows RT) Windows 7 32-bit and 64-bit * Limitation for Windows 8/8.1/10 - Windows UI (Modern UI) do not support.
Star JavaPOS Driver Software Manual 2.3 Supported Models The driver supports the operating systems and interfaces listed below.
Star JavaPOS Driver Software Manual 3. Installation Install the 32-bit or 64-bit driver, whichever is appropriate for your Java runtime environment. 1. Uncompress this package. 2. Files which are existed in unzipped package is able to put on a particular place. Files : “class libraries(jar file)” “file of JavaPOS driver settings (jpos.
Star JavaPOS Driver Software Manual 4. JavaPOS Driver Settings The Star JavaPOS Driver uses the JCL - Java Configuration Loader system for configuring the provided services. The file jpos.xml contained in this package has been prepared with device entries for Star's printer products. Refer to the followings and adjust jpos.xml to fit the environment of use. The following is a setting example of MCP31POSPrinter and CashDrawer.
Star JavaPOS Driver Software Manual 4.1 Common Settings Enter the following settings according to the connection method of your device. ■ Model Name Setting ... 1 ex. Please input the appropriate model name which you would like to use. Supported model names are as following. MCP31, MCP20, MCP21, POP10 Note: You do not have to enter this property on cash drawer devices. ■ Port Name / Port Settings ... 2 ex.
Star JavaPOS Driver Software Manual 2. Specifying USB serial number * Windows not supported. "usbprn:XXXXXXXX" "usbprn:" causes StarIO to open the printer with the serial number you've specified. This is useful in two scenarios: · To avoid new ports being created when the printer is connected to the computer's different USB ports. · When you have multiple printers connected simultaneously, your printer can be identified.
Star JavaPOS Driver Software Manual 【 Bluetooth 】 Pairing with the printer device in advance. Also after pairing, make sure that as following. Make sure that is showed the ”Standard Serial over Bluetooth link (COM X)”(X is number) at “Computer”(right click) > manage > Device Manager > “Ports (COM & LPT)”. At “Terminal”, perform the following command. hcitool scan (Search a Bluetooth Device, Check a MAC Adress of a Bluetooth Device) As administrator authority, run the following commands.
Star JavaPOS Driver Software Manual ■ Communications Timeout Setting ... 3 ex. The value set here establishes a timeout period used to affect communications within this software. If you do not specify this property, its default value (5000 ms) takes effect. Adjust Communications Timeout Setting depending on your environment and amount of printing data. 4.2 POS Printer Connection Settings ■ ETB Counter Setting ex.
Star JavaPOS Driver Software Manual 4.3 CashDrawer Connection Settings If you do not specify these items, the default value is valid. ■ Configuration - CashDrawer Circuit ex. You can set the Cash Draw Circuit you want to use. To use peripheral drive 1 for connecting the cash drawer, set this property to "True". To use peripheral device 2, set this property to "False". The default value is ”True”. ■ Configuration - On Pulse Width ex.
Star JavaPOS Driver Software Manual 5. Sample Program The sample program is available in "StarReceiptTest.java", "StarSlipTest.java", "StarCashDrawerTest.java" and "StarMICRTest.java". Use them as references for developing your applications. The following is the reference of “StarReceiptTest.java” for the print test. 1. Open the “StarReceiptTest.java”. Specify “location of jpos.xml” at “System.setProperty method". The “location of jpos.xml” is “Full(Relative) Path + jpos.xml” or ”jpos.xml” (if jpos.
Star JavaPOS Driver Software Manual 3. Save the StarReceiptTest.java. In Command Prompt(Terminal), run the following commands by administrator authority for checking a "sample receipt printing". *In this example, run the commands by administrator authority due to a place of directory. i) Change to the directory of running application. cd “Place of performing Java application” ii) The "javac" command compiles a “java file” and create a “class file”. javac –classpath .;jarFile1.jar;jarFile2.jar;...
Star JavaPOS Driver Software Manual i) ii) iii) i) ii) iii) * About a “-classpath” option of ”javac” or ”java” command. At "-classpath", specify the required "jar files" to compile and run applications. In addition to the above example, if there are in the same directory the "application executable file" (.class) and "jar files", can specify only "jar file name"(not need file path). ex. Particular place : jar file, xml, java, gif - “C:\Program Files\JavaPOS” jar fil
Star JavaPOS Driver Software Manual Commands for a java application : javac -classpath jpos113-controls.jar;jcl.jar StarReceiptTest.java java -classpath .;starjavapos.jar;stario.jar;jpos113-controls.jar; jcl.jar;xercesimpl.jar;xml-apis.jar StarReceiptTest javac -classpath jpos113-controls.jar:jcl.jar StarReceiptTest.java java -classpath .:starjavapos.jar:stario.jar:commandemulator.jar: jpos113-controls.jar:jcl.jar:xercesimpl.jar:xml-apis.
Star JavaPOS Driver Software Manual 6. Service Objects The following tables list this driver's supporting status of JavaPOS service objects. Please refer to the Java for Retail POS Programming Guide about the specifications of the Service Objects. 6.1 POS Printer The Service Objects of POSPrinter is supported in StarPRNT Mode.
Star JavaPOS Driver Software Manual Property Supporting status CapJrnUnderline ○ FALSE CapJrnCartridgeSensor ○ 0 CapJrnColor ○ 0 CapRecPresent ○ TRUE CapRec2Color ○ FALSE CapRecBarCode ○ CapRecBitmap ○ TRUE CapRecBold ○ TRUE CapRecDhigh ○ TRUE CapRecDwide ○ TRUE CapRecDwideDhigh ○ TRUE CapRecEmptySensor ○ TRUE CapRecItalic ○ FALSE CapRecLeft90 ○ FALSE CapRecNearEndSensor ○ CapRecPapercut ○ TRUE CapRecRight90 ○ FALSE CapRecRotate180 ○ TRUE CapRecStamp ○
Star JavaPOS Driver Software Manual Property Supporting status ErrorLevel ○ ○ ErrorStation ○ ○ ErrorString ○ ○ FontTypefaceList ○ "" FlagWhenIdle ○ ○ MapCharacterSet ○ FALSE MapMode ○ PageModeArea ○ "" PageModeDescriptor ○ 0 PageModeHorizontalPosition ○ 0 PageModePrintArea ○ "" PageModePrintDirection ○ 0 PageModeStation ○ 0 PageModeVerticalPosition ○ 0 RotateSpecial ○ JrnLineChars ○ 0 JrnLineCharsList ○ "" JrnLineHeight ○ 0 JrnLineSpacing ○ 0 JrnLineW
Star JavaPOS Driver Software Manual Property Supporting status SlpLinesNearEndToEnd ○ 0 SlpBarCodeRotationList ○ "" SlpBitmapRotationList ○ "" SlpPrintSide ○ PTR_PS_UNKNOWN SlpCartridgeState ○ PTR_CART_UNKNOWN SlpCurrentCartridge ○ 0 - 20 - Remarks
Star JavaPOS Driver Software Manual ■ Methods Method Supporting status Open ○ Close ○ Claim ○ Release ○ CheckHealth ○ ClearInput ClearInputProperties Remarks - Not applicable JavaPOS - Not applicable JavaPOS ClearOutput ○ CompareFirmwareVersion × DirectIO × ResetStatistics × RetrieveStatistics × UpdateFirmware × UpdateStatistics × PrintNormal ○ PrintTwoNormal × PrintImmediate ○ BeginInsertion ○ EndInsertion ○ BeginRemoval ○ EndRemoval ○ CutPaper ○ RotatePrint
Star JavaPOS Driver Software Manual 3) Parameter settings for 2D codes (QR code, PDF417). ex. printer.printBarCode(POSPrinterConst.PTR_S_RECEIPT, "http://StarMicronics.com", POSPrinterConst.PTR_BCS_QRCODE, 10 * 100, 60 * 100, POSPrinterConst.PTR_BC_CENTER, POSPrinterConst.PTR_BC_TEXT_BELOW);" Settable parameters ( Symbology ) QR code........ PTR_BCS_QRCODE PDF417......... PTR_BCS_PDF417 * When printing 2D codes, the Height , Width and TextPosition parameters are ignored.
Star JavaPOS Driver Software Manual ■ Events Event Supporting status Remarks - DataEvent DirectIOEvent × ErrorEvent ○ OutputCompleteEvent ○ StatusUpdateEvent ○ Not applicable JavaPOS ■ Escape Sequences Escape Sequence Supporting status Remarks ESC|[#]P Paper cut ○ ESC|[#]fP Feed and paper cut ○ ESC|sP Feed, Paper cut, and Stamp × ESC|sL Fire stamp × ESC|#B Print bitmap ○ ESC|tL Print top logo ○ ESC|bL Print bottom logo ○ ESC|[#]lF Feed lines ○ ESC|[#]uF Feed units ○
Star JavaPOS Driver Software Manual 6.2 Cash Drawer The Service Objects of Cash Drawer is supported in StarPRNT Mode.
Star JavaPOS Driver Software Manual ■ Events Event DataEvent DirectIOEvent ErrorEvent OutputCompleteEvent StatusUpdateEvent Supporting status - Remarks Not applicable JavaPOS × - Not applicable JavaPOS - Not applicable JavaPOS ○ - 25 -
Star JavaPOS Driver Software Manual 7. Version History Rev. No. Date of Revision Rev. 1.0 Jun. 2018 Changes First edition.
URL: http://www.starmicronics.
