device.sdk

Class MsrManager

java.lang.Object

device.sdk.MsrManager

public class MsrManager
extends java.lang.Object

MsrManager.java

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	MsrManager.AtrOnMode This enum present the Atr Mode
static class	MsrManager.CardInsertState This enum present the Card insertion state

Constructor Summary

Constructors

Constructor and Description
MsrManager()

Method Summary

Modifier and Type	Method and Description
boolean	AtrOn(MsrManager.AtrOnMode atrMode) This function power on & ATR on msr service.
MsrManager.CardInsertState	cardDetectPolling(int pollingTime) This function is polling fuction refer to card detection
boolean	checkSystemUid()
int	DeviceMsrClose() This function close msr service.
MsrResult	DeviceMsrGetData(int read_track) This function return msr result in msr service.
int	DeviceMsrOpen(MsrResultCallback callback) This function open msr service.
int	DeviceMsrStartRead() This function read start msr service.
int	DeviceMsrStartRead(int mode) This function read start msr service.
int	DeviceMsrStopRead() This function read stop msr service.
MsrManager.CardInsertState	GetCardInserted() This function get information that card detected
byte[]	getEncryptionData() This function get the encryption data, Use for MMD1000 Only.
java.lang.String	getFirmwareVersion() This function get the firmware version of the MSR.
static MsrManager	getInstance()
int	getTxMode() This function get read lowdata mode.
void	paymentTransactionStart(byte firstbyte, int pay, short year, short month, short dayOfWeek, short day, short hour, short minute, short second, short milliSeconds) This function Start payment Transaction
void	PowerDown() This function ATR down & power down msr service.
int	rdiClear() This function clear the RDI Ring buffer
int	rdiClose() This function turns off the msr for RDI.
int	rdiIsEnabled() This function get a status that RDi
int	rdiNelem() This function returns the number of data accumulated in the ring buffer.
int	rdiOpen()
int	rdiOpenK() This function powers the msr for RDI.
int	rdiRead(byte[] data, int length) This function read a command in Ring buffer
int	rdiSetEnable(int enable) This function set a status that Rdi
int	rdiWrite(byte[] byteArrays, int lenght) This function write a command in Ring buffer
byte[]	SendAPDU(byte[] Data) This function open msr service.
boolean	setPublicKey(java.io.File pemFile) This function set the public key in order to encrypt (RSA/ECB).
boolean	setPublicKey(java.lang.String pemKey) This function set the public key in order to encrypt (RSA/ECB).
boolean	setSystemTime(short year, short month, short dayOfWeek, short day, short hour, short minute, short second, short milliSeconds) This function set System Time current system time setting fuction,
int	setTxMode(int txmode, int allTerror, int ksnRes) This function set read lowdata mode.
boolean	setUsedEncryption(byte[] ksn, byte[] initKey) This function set to use encryption of this unit itself, Use for MMD1000 Only.
boolean	updateFirmware(java.io.File fwFile) This function update the firmware, Use for PM1100 Only.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

MsrManager

public MsrManager()

Method Detail

getInstance

public static MsrManager getInstance()

AtrOn

public boolean AtrOn(MsrManager.AtrOnMode atrMode)

This function power on & ATR on msr service.

Parameters:

byte - 0x00 is ISO and 0x01 is EMV Mode

Returns:

ATR status.

See Also:

MsrManager.AtrOn(device.sdk.MsrManager.AtrOnMode)

PowerDown

public void PowerDown()

This function ATR down & power down msr service.

See Also:

MsrManager.PowerDown()

GetCardInserted

public MsrManager.CardInsertState GetCardInserted()

This function get information that card detected

Returns:

whether to insert a card.

See Also:

MsrManager.GetCardInserted()

cardDetectPolling

public MsrManager.CardInsertState cardDetectPolling(int pollingTime)

This function is polling fuction refer to card detection

Returns:

CardInsertState.

See Also:

MsrManager.cardDetectPolling(int)

setSystemTime

public boolean setSystemTime(short year,
                             short month,
                             short dayOfWeek,
                             short day,
                             short hour,
                             short minute,
                             short second,
                             short milliSeconds)

This function set System Time current system time setting fuction,

Parameters:

time - informations

Returns:

sucess or fail.

See Also:

MsrManager.setSystemTime(short, short, short, short, short, short, short, short)

paymentTransactionStart

public void paymentTransactionStart(byte firstbyte,
                                    int pay,
                                    short year,
                                    short month,
                                    short dayOfWeek,
                                    short day,
                                    short hour,
                                    short minute,
                                    short second,
                                    short milliSeconds)

This function Start payment Transaction

Parameters:

payment - information and time information.

See Also:

MsrManager.paymentTransactionStart(byte, int, short, short, short, short, short, short, short, short)

SendAPDU

public byte[] SendAPDU(byte[] Data)

This function open msr service.

Parameters:

APDU - command byte array

Returns:

the APDU return value from the module.

See Also:

MsrManager.SendAPDU(byte[])

DeviceMsrOpen

public int DeviceMsrOpen(MsrResultCallback callback)

This function open msr service.

Parameters:

callback - Result return function.

Returns:

msr service open status.

See Also:

MsrManager.DeviceMsrClose()

DeviceMsrClose

public int DeviceMsrClose()

This function close msr service.

Returns:

msr service close status.

See Also:

MsrManager.DeviceMsrOpen(device.common.MsrResultCallback)

DeviceMsrStartRead

public int DeviceMsrStartRead()

This function read start msr service.

Returns:

msr service start status.

See Also:

MsrManager.DeviceMsrStopRead()

DeviceMsrStartRead

public int DeviceMsrStartRead(int mode)

This function read start msr service.

Parameters:

mode - Read data mode setting. Use for PM1100 only MMD1000 (NT) PM1100 mode 0 = default 11 = MsrReady 0x01 | MSRBinary 0x10 13 = MsrReady 0x01 | ICRReady 0x02 |MSRBinary 0x10

Returns:

msr service start status.

See Also:

MsrManager.DeviceMsrStopRead()

DeviceMsrStopRead

public int DeviceMsrStopRead()

This function read stop msr service.

Returns:

msr service stop status.

See Also:

MsrManager.DeviceMsrStartRead()

updateFirmware

public boolean updateFirmware(java.io.File fwFile)
                       throws java.io.IOException,
                              java.io.FileNotFoundException

This function update the firmware, Use for PM1100 Only.

Parameters:

fwFile - firmware file.

Returns:

true if success, false otherwise.

Throws:

java.io.IOException

java.io.FileNotFoundException

getFirmwareVersion

public java.lang.String getFirmwareVersion()

This function get the firmware version of the MSR.

Returns:

firmware version of the MSR.

DeviceMsrGetData

public MsrResult DeviceMsrGetData(int read_track)

This function return msr result in msr service.

Parameters:

read_track - select reading track data.

   track 1 (1 << 0).
   track 2 (1 << 1).
   track 3 (1 << 2).
 

Returns:

MsrResult class value.

setPublicKey

public boolean setPublicKey(java.lang.String pemKey)

This function set the public key in order to encrypt (RSA/ECB). The second track is encrypted, if you complete the setting.

Parameters:

pemKey - pem key with String.

Returns:

true if the value was set, false otherwise.

See Also:

MsrManager.setPublicKey(File)

setPublicKey

public boolean setPublicKey(java.io.File pemFile)
                     throws java.io.IOException

This function set the public key in order to encrypt (RSA/ECB). The second track is encrypted, if you complete the setting.

Parameters:

pemFile - File of pem key.

Returns:

true if the value was set, false otherwise.

Throws:

java.io.IOException

See Also:

MsrManager.setPublicKey(String)

setUsedEncryption

public boolean setUsedEncryption(byte[] ksn,
                                 byte[] initKey)

This function set to use encryption of this unit itself, Use for MMD1000 Only. Warning: This setting can only be used twice per unit.

Parameters:

ksn - key serial number to use encryption.

initKey - initial key to use encryption.

Returns:

true if setting to use encryption is success, false otherwise.

See Also:

MsrManager.getEncryptionData()

getEncryptionData

public byte[] getEncryptionData()

This function get the encryption data, Use for MMD1000 Only. You must first set MsrManager.setUsedEncryption(byte[], byte[])

Returns:

encryption data with byte array.

See Also:

MsrManager.setUsedEncryption(byte[], byte[])

rdiIsEnabled

public int rdiIsEnabled()

This function get a status that RDi

Returns:

Whether it operates in RDI mode.

See Also:

MsrManager.rdiIsEnabled()

rdiSetEnable

public int rdiSetEnable(int enable)

This function set a status that Rdi

Returns:

The success or failure of the function.

See Also:

MsrManager.rdiSetEnable(int)

rdiWrite

public int rdiWrite(byte[] byteArrays,
                    int lenght)

This function write a command in Ring buffer

Returns:

The success or failure of the function.

See Also:

MsrManager.rdiWrite(byte[], int)

rdiRead

public int rdiRead(byte[] data,
                   int length)

This function read a command in Ring buffer

Returns:

The length of the byte array read.

See Also:

MsrManager.rdiRead(byte[], int)

rdiNelem

public int rdiNelem()

This function returns the number of data accumulated in the ring buffer.

Returns:

Number of data.

See Also:

MsrManager.rdiNelem()

rdiClear

public int rdiClear()

This function clear the RDI Ring buffer

See Also:

MsrManager.rdiClear()

rdiOpenK

public int rdiOpenK()

This function powers the msr for RDI.

Returns:

The success or failure of the function.

See Also:

MsrManager.rdiOpen()

rdiOpen

public int rdiOpen()

rdiClose

public int rdiClose()

This function turns off the msr for RDI.

Returns:

The success or failure of the function.

See Also:

MsrManager.rdiClose()

checkSystemUid

public boolean checkSystemUid()

setTxMode

public int setTxMode(int txmode,
                     int allTerror,
                     int ksnRes)

This function set read lowdata mode. Use for MMD1000 only.

Parameters:

txmode, - allTerror, ksnRes TX Mode 2 = binary lowdata 4 = encrypted without initial vector use 6 = encrypted by using initial vector All Track Error 0 = all track error report : Enable - defualt 1 = all track error report : Disable KSN 0 = 10byte key sirial number - defualt 1 = 3 byte(21bit encryption count)

Returns:

The success or failure of the function.

See Also:

MsrManager.rdiClose()

getTxMode

public int getTxMode()

This function get read lowdata mode. Use for MMD1000 only.

Returns:

The success or failure of the function. TX Mode 2 = binary lowdata 4 = encrypted without initial vector use 6 = encrypted by using initial vector

See Also:

MsrManager.rdiClose()