For printers and barcode scanners that we have not yet tested with Bluestore Live, we have created some general tips to help you get them working with the POS terminal.
We can't guarantee they will work, but if you have a particular hardware set up that you wish to test then the following information should help. If you have any questions, or feedback on your testing to help others, then please get in touch.
Basic knowledge of text file manipulation and the ability to interpret install instructions is required to follow the steps below.
A prerequisite for using printers and barcode scanners with Bluestore Live is a JavaPOS (JPOS) or UPOS driver from the manufacturer that supports the port type of the device (usb, serial, parallel) and the operating system on your computer (e.g. Windows 7 / Vista / XP, Apple OSX, Linux).
All manufacturers' installers are different, so we can't help with the install of the driver, but the basic steps that need to be completed are as follows. Ensure you shut down the Bluestore Live terminal before performing these steps.
1. In your Bluestore Live terminal installation directory, locate the file jpos.xml.
In a standard Windows install this will be at:
C:\Program Files\Bluestore Live POS\work\terminal\data\pos\jpos.xml
The file contains an entry for each device and you will need to add a section for your new hardware in step 3.
2. Follow the manufacturer's instructions to install the JPOS/UPOS driver.
You may need to know the location of java on your machine but often the installer will figure this out for itself.
If there is an installer then run through it to install the javaPOS driver.
It may prompt you for the location of your jpos.xml file, or this may be a separate configuration option, but you need to let your driver know to use the Bluestore Live jpos.xml file found in the location above.
Sometimes there is no installer and it will just be a case of copying some .jar files into your jre6/lib/ext/ folder and perhaps some files to other locations - follow the instructions given by the manufacturer. If you need advice then please get in touch and we might be able to help - some of the instructions can be quite cryptic!
Bluestore Live works with JavaPOS version 1.11. The manufacturer's files may include a javaPOS version that is older (the file is usually named jposXXX.jar or jposXXX-controls.jar where XXX is the version number). If this is the case then replace it with version 1.11 which is included in the JavaPOS pack in our downloads section (see below for link).
To summarise, after installing the manufacturer's driver you should end up with the following files in your jre/lib/ext folder:
1. The ones delivered when you installed java
2. The ones from the JavaPOS pack
3. The additional ones that were put there while installing the JavaPOS drivers from your device manufacturer.
Note that the manufacturer's files will probably include some files already in the JavaPOS pack. If in doubt use the ones from the JavaPOS pack not the device files.
3. Once the install is complete, we need to add the device entry to jpos.xml.
The manufacturer should provide the means to create a jpos.xml entry for your device - this may either be in a separate application or it may be an output from the installer. The entry will be different depending on the manufacturer, printer model, port type etc.
The entry will look something like this:
<JposEntry logicalName="StarMicronics SP216F">
<creation factoryClass="com.starmicronics.javapos.StarJposServiceInstanceFactory" serviceClass="com.starmicronics.javapos.StarJPOSPOSPrinter"/>
<vendor name="Star Micronics Co., Ltd." url=""/>
<jpos category="POSPrinter" version="1.4a"/>
<product description="Star Dot-matrix receipt printer" name="SP216F" url=""/>
<!--Other non JavaPOS required property (mostly vendor properties and bus specific properties i.e. RS232 )-->
<prop name="portName" type="String" value="LPT2"/>
<prop name="errorResponseTimeout" type="String" value="1000"/>
<prop name="capLogoStore" type="String" value="true"/>
<prop name="statusTimeout" type="String" value="500"/>
<prop name="timeout" type="String" value="1000"/>
<prop name="starModel" type="String" value="SP216F"/>
<prop name="capRecRaster" type="Boolean" value="true"/>
<prop name="deviceClassName" type="String" value="com.starmicronics.javapos.DeviceSP216F"/>
<prop name="portSettings" type="String" value="no settings required or accepted"/>
<prop name="statusTimeDelay" type="Long" value="500"/>
Copy the entry for your device and paste it into the Bluestore Live jpos.xml between the last </JposEntry> and </JposEntries> xml tags.
If necessary, change any properties that may be required e.g. for a serial printer, the portName will need to correspond to the COM port on which your device is communicating.
Save the jpos.xml file.
4. Create a Bluestore Live properties file for your device.
In the directory ..\work\terminal\data\pos\settings you will see a .properties file for each device contained in the jpos.xml file. These properties files contain the options from the jpos.xml entry that can be maintained directly in the hardware settings for the device on the terminal.
It may not be necessary to change any of these parameters if you have set them correctly already in the jpos.xml file, but an empty properties file is still required.
The file name must be the <logicalName> of the device (from the JposEntry) followed by .properties
5. Start the terminal and select the device
Your device should now be selectable in the hardware configuration (tools menu) under the device type. Highlight 'model' and press 'change option'. Select your new device and press ok.
Enable the device and save.