Application Programming Guide
JavaPOS Driver
Rev. 1.04 SPP-R200
SPP-R200II
SPP-R200III
SPP-R210
SPP-R220
SPP-R300
SPP-R310
SPP-R400
http://www.bixolon.com
JavaPOS Driver
■ Table of Contents
1. Manual Information ................................................................................................ 3
2. Development environment ..................................................................................... 4
2-1 Communication Configuration ....................................................................................4
3. Property / Method.................................................................................................... 5
3-1 MSR Type ........................................................................................................................5
3-2 Property Range / Default Value ...................................................................................5
3-2-1 Capability property setting value ..........................................................................5
3-2-2 MSR Method ............................................................................................................5
4. Error Information ..................................................................................................... 6
4-1 ResultCode List ..............................................................................................................6
5. Precautions ............................................................................................................... 7
Rev. 1.04 - 2 -
JavaPOS Driver
1. Manual Information
This manual provides information on the BIXOLON JavaPOS driver as well as on the
usage MSR products offered by BIXOLON.
The following are terms contained in this manual.
- JDK : Java Development Kit
- JRE : Java Runtime Enviroment
- JavaPOS : Java Point of Sale
- JCL Utility: JavaPOS Configuration Loader Utility
[Reference Websites]
http://www.javapos.com : Java POS committee website
http://java.com : Official Java website
http://www.bixolon.com : BIXOLON printers website
We at BIXOLON maintain ongoing efforts to enhance and upgrade the functions and
quality of all our products. In following, product specifications and/or user manual
content may be changed without prior notice.
Rev. 1.04 - 3 -
JavaPOS Driver
2. Development environment
2-1 Communication Configuration
1) Communication Configuration for serial interface
You will set communication configuration in BIXOLON JavaPOS
Configuration Utility.
Printer Model Baud Rate Product Type
Optional built-in
SPP-R200 9600/19200/38400/57600/115200
Type
Optional built-in
SPP-R200II 9600/19200/38400/57600/115200
Type
Optional built-in
SPP-R200III 9600/19200/38400/57600/115200
Type
Optional built-in
SPP-R210 Not supported
Type
Optional built-in
SPP-R220 Not supported
Type
Optional built-in
SPP-R300 9600/19200/38400/57600/115200
Type
Optional built-in
SPP-R310 9600/19200/38400/57600/115200
Type
Optional built-in
SPP-R400 9600/19200/38400/57600/115200
Type
* Check the default communication setting. For more details refer to the user
manual included in the printer package.
Rev. 1.04 - 4 -
JavaPOS Driver
3. Property / Method
3-1 MSR Type
Property value will be determined by the MSR type, as shown in the below table.
3-2 Property Range / Default Value
3-2-1 Capability property setting value
SPP-R200_MSR / SPP-R200II_MSR
SPP-R200III_MSR / SPP-R210_MSR
Capability Property SPP-R220_MSR
SPP-R300_MSR / SPP-R310_MSR
SPP-R400_MSR
CapCompareFirmwareVersion FALSE
CapPowerReporting TRUE
CapStatisticsReporting FALSE
CapUpdateFirmware FALSE
CapUpdateStatistics FALSE
CapCardAuthentication FALSE
CapDataEncryption FALSE
CapDeviceAuthentication FALSE
CapISO TRUE
CapJISOne FALSE
CapJISTwo FALSE
CapTrackDataMasking FALSE
CapTransmitSentinels TRUE
CapWritableTracks FALSE
3-2-2 MSR Method
SPP-R200_MSR / SPP-R200II_MSR
SPP-R200III_MSR / SPP-R210_MSR
Method SPP-R220_MSR
SPP-R300_MSR / SPP-R310_MSR
SPP-R400_MSR
authenticateDevice X
deauthenticateDevice X
retrieveCardProperty X
retrieveDeviceAuthenticationData X
updateKey X
writeTracks X
O: Supported X: Not supported
Rev. 1.04 - 5 -
JavaPOS Driver
4. Error Information
This section is to explain returned error information when use MSR methods. For
more details, please refer to the UPOS specifications.
4-1 ResultCode List
ClaimDevice
Method Result Code ResultCodeExtended
ClaimDevice JPOS_E_ILLEGAL 0
CheckHealth
Method Result Code ResultCodeExtended
JPOS_SUCCESS 0
JPOS_E_CLOSED 0
JPOS_E_CLAIMED 0
CheckHealth JPOS_E_DISABLED 0
JPOS_E_ILLEGAL 0
JPOS_E_OFFLINE 0
JPOS_E_OFFLINE 0
ClearOutput
Method Result Code ResultCodeExtended
JPOS_SUCCESS 0
JPOS_E_CLOSED 0
ClearOutput
JPOS_E_CLAIMED 0
JPOS_E_NOTCLAIMED 0
Rev. 1.04 - 6 -
JavaPOS Driver
5. Precautions
1) Reproduction of any part of this documentation by any means is prohibited.
2) The contents of this documentation are subject to change without notice.
3) Comments and notification of any mistakes in this documentation are gratefully
accepted.
4) This software cannot be used with other equipment that the specified.
5) BIXOLON will not be responsible for any consequences resulting from the use of
any information in this documentation.
6) BIXOLON JavaPOS driver is designed to operate properly with the latest firmware
of each model. If the printer doesn’t operate properly, please check the firmware
version and contact the manufacturer.
Rev. 1.04 - 7 -
