com.cloudpos

Class POSTerminal

java.lang.Object

com.cloudpos.POSTerminal

public abstract class POSTerminal
extends java.lang.Object

The POSTerminal class acts as a central manager for accessing various device components in Smart POS systems. It extends the java.lang.Object class.

This class provides methods to retrieve device instances, check for device existence, and obtain device specifications. It supports a range of devices such as magnetic stripe readers, PIN pads, printers, card readers, fingerprint scanners, and LED indicators.

Usage involves instantiating the class with a relevant Android context and using its methods to interact with the different peripherals of the Smart POS system.

Field Summary

Fields

Modifier and Type	Field and Description
protected static android.content.Context	androidContext
static java.lang.String	DEVICE_NAME_ADVANCE_PINPAD
static java.lang.String	DEVICE_NAME_CASH_DRAWER
static java.lang.String	DEVICE_NAME_EMV
static java.lang.String	DEVICE_NAME_FINGERPRINT
static java.lang.String	DEVICE_NAME_HSM
static java.lang.String	DEVICE_NAME_IDCARD_READER
static java.lang.String	DEVICE_NAME_LED
static java.lang.String	DEVICE_NAME_MSR
static java.lang.String	DEVICE_NAME_PINPAD
static java.lang.String	DEVICE_NAME_PRINTER
static java.lang.String	DEVICE_NAME_RF_CARD_READER
static java.lang.String	DEVICE_NAME_SECONDARY_DISPLAY
static java.lang.String	DEVICE_NAME_SERIALPORT
static java.lang.String	DEVICE_NAME_SIGNATURE
static java.lang.String	DEVICE_NAME_SMARTCARD_READER
static java.lang.String	DEVICE_NAME_USBEXTSWITCHDEVICE
static java.lang.String	POS_TERMINAL_CLASS system property
static java.lang.String	POS_TERMINAL_INTERNAL_CLASS

Constructor Summary

Constructors

Constructor and Description
POSTerminal()

Method Summary

Modifier and Type	Method and Description
abstract Device	getDevice(java.lang.String deviceName) Fetches a device object based on its name.
abstract Device	getDevice(java.lang.String deviceName, int logicalID) Retrieves a device object based on its name and a logical ID.
abstract DeviceSpec	getDeviceSpec(java.lang.String deviceName) Provides the specifications for a specified device.
static POSTerminal	getInstance(android.content.Context context) Retrieves an instance of the device manager.
abstract TerminalSpec	getTerminalSpec() Returns the specifications of the terminal.
abstract boolean	isDeviceExist(java.lang.String deviceName) Checks if a specified device is present.
abstract java.lang.String[]	listDevices() Lists all available device names.

Methods inherited from class java.lang.Object

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

Field Detail

DEVICE_NAME_MSR

public static final java.lang.String DEVICE_NAME_MSR

See Also:

Constant Field Values

DEVICE_NAME_HSM

public static final java.lang.String DEVICE_NAME_HSM

See Also:

Constant Field Values

DEVICE_NAME_RF_CARD_READER

public static final java.lang.String DEVICE_NAME_RF_CARD_READER

See Also:

Constant Field Values

DEVICE_NAME_IDCARD_READER

public static final java.lang.String DEVICE_NAME_IDCARD_READER

See Also:

Constant Field Values

DEVICE_NAME_PRINTER

public static final java.lang.String DEVICE_NAME_PRINTER

See Also:

Constant Field Values

DEVICE_NAME_PINPAD

public static final java.lang.String DEVICE_NAME_PINPAD

See Also:

Constant Field Values

DEVICE_NAME_SMARTCARD_READER

public static final java.lang.String DEVICE_NAME_SMARTCARD_READER

See Also:

Constant Field Values

DEVICE_NAME_SERIALPORT

public static final java.lang.String DEVICE_NAME_SERIALPORT

See Also:

Constant Field Values

DEVICE_NAME_LED

public static final java.lang.String DEVICE_NAME_LED

See Also:

Constant Field Values

DEVICE_NAME_CASH_DRAWER

public static final java.lang.String DEVICE_NAME_CASH_DRAWER

See Also:

Constant Field Values

DEVICE_NAME_SECONDARY_DISPLAY

public static final java.lang.String DEVICE_NAME_SECONDARY_DISPLAY

See Also:

Constant Field Values

DEVICE_NAME_EMV

public static final java.lang.String DEVICE_NAME_EMV

See Also:

Constant Field Values

DEVICE_NAME_SIGNATURE

public static final java.lang.String DEVICE_NAME_SIGNATURE

See Also:

Constant Field Values

DEVICE_NAME_FINGERPRINT

public static final java.lang.String DEVICE_NAME_FINGERPRINT

See Also:

Constant Field Values

DEVICE_NAME_ADVANCE_PINPAD

public static final java.lang.String DEVICE_NAME_ADVANCE_PINPAD

See Also:

Constant Field Values

DEVICE_NAME_USBEXTSWITCHDEVICE

public static final java.lang.String DEVICE_NAME_USBEXTSWITCHDEVICE

See Also:

Constant Field Values

POS_TERMINAL_CLASS

public static final java.lang.String POS_TERMINAL_CLASS

system property

See Also:

Constant Field Values

POS_TERMINAL_INTERNAL_CLASS

public static final java.lang.String POS_TERMINAL_INTERNAL_CLASS

See Also:

Constant Field Values

androidContext

protected static android.content.Context androidContext

Constructor Detail

POSTerminal

public POSTerminal()

Method Detail

getInstance

public static POSTerminal getInstance(android.content.Context context)

Retrieves an instance of the device manager.

Parameters:

context - the Android context

Returns:

an instance of POSTerminal

getTerminalSpec

public abstract TerminalSpec getTerminalSpec()

Returns the specifications of the terminal.

Returns:

TerminalSpec object with terminal specifications

listDevices

public abstract java.lang.String[] listDevices()

Lists all available device names.

Returns:

array of device names

isDeviceExist

public abstract boolean isDeviceExist(java.lang.String deviceName)

Checks if a specified device is present.

Parameters:

deviceName - the name of the device

Returns:

true if the device exists, false otherwise

getDevice

public abstract Device getDevice(java.lang.String deviceName)

Fetches a device object based on its name.

Parameters:

deviceName - the name of the device

Returns:

Device object for the specified device

getDevice

public abstract Device getDevice(java.lang.String deviceName,
                                 int logicalID)

Retrieves a device object based on its name and a logical ID. The logical ID is used to specify a particular device when multiple devices of the same type are present.

For example, when using a SAM (Secure Access Module) card device, the logicalID should be one of the following: 0, 1, 2, or 3, depending on the device type. Similarly, for an LED device, the logicalID corresponds to different colors of the LED, with values 0, 1, 2, or 3.

Parameters:

deviceName - the name of the device to be retrieved

logicalID - the logical ID of the device, used to distinguish between multiple devices of the same type

Returns:

a Device object representing the specified device

getDeviceSpec

public abstract DeviceSpec getDeviceSpec(java.lang.String deviceName)

Provides the specifications for a specified device.

Parameters:

deviceName - the name of the device

Returns:

DeviceSpec object with device specifications