Introduction - Epson ePOS SDK for Android - Tech.Reference - POS

Printer class

Controls printing by the printer.

API		Description
Initialization	Printer	Initializes the Printer class.
Communication path	connect	Connects to the printer.
Communication path	disconnect	Disconnects from the printer.
Status monitor	startMonitor	Enables status event notification.
Status monitor	stopMonitor	Disables status event notification.
Status acquisition	getStatus	Acquires status of the connected printer.
Transmission	sendData	Sends a command to the printer.
Transaction	beginTransaction	Starts a transaction.
Transaction	endTransaction	Ends a transaction.
Print job	requestPrintJobStatus	Acquires the print result.
Buffer clear	clearCommandBuffer	Clears the command buffer.
Text	addTextAlign	Adds text alignment setting to the command buffer.
	addLineSpace	Adds line spacing setting to the command buffer.
	addTextRotate	Adds text rotation setting to the command buffer.
	addText	Adds text to print to the command buffer.
	addTextLang	Adds language setting to the command buffer.
	addTextFont	Adds character font setting to the command buffer.
	addTextSmooth	Adds character smoothing setting to the command buffer.
	addTextSize	Adds character scaling factor setting to the command buffer.
	addTextStyle	Adds character style setting to the command buffer.
	addHPosition	Adds character print position setting to the command buffer.
Paper feed	addFeedUnit	Adds paper-feed setting in dots to the command buffer.
Paper feed	addFeedLine	Adds paper-feed setting in lines to the command buffer.
Graphics	addImage	Adds a raster image print command to the command buffer.
Graphics	addLogo	Adds a NV logo print command to the command buffer.
Barcode	addBarcode	Adds a barcode print command to the command buffer.
Barcode	addSymbol	Adds a 2D symbol print command to the command buffer.
Ruled line	addHLine	Adds a horizontal ruled line print command to the command buffer.
	addVLineBegin	Adds a vertical ruled line start command to the command buffer.
	addVLineEnd	Adds a vertical ruled line end command to the command buffer.
Page mode	addPageBegin	Adds a page mode start command to the command buffer.
	addPageEnd	Adds a page mode end command to the command buffer.
	addPageArea	Adds page mode print area setting to the command buffer.
	addPageDirection	Adds page mode print direction setting to the command buffer.
	addPagePosition	Adds page mode print position setting to the command buffer.
	addPageLine	Adds a page mode line draw command to the command buffer.
	addPageRectangle	Adds a page mode rectangle draw command to the command buffer.
Batch rotate print	addRotateBegin	Adds the start batch rotate print mode to the command buffer.
Batch rotate print	addRotateEnd	Adds the end batch rotate print mode to the command buffer.
Cut	addCut	Adds a sheet cut command to the command buffer.
Drawer	addPulse	Adds a drawer kick command to the command buffer.
Buzzer	addSound	Adds a buzzer sound command to the command buffer.
Label sheet/ black mark sheet	addFeedPosition	Adds a paper feed command to the command buffer.
Label sheet/ black mark sheet	addLayout	Adds sheet layout setting to the command buffer.
Command	addCommand	Adds a command to the command buffer.
Maintenance counter	getMaintenanceCounter	Acquires the counter value.
Maintenance counter	resetMaintenanceCounter	Resets the counter value.
Printer setting	getPrinterSetting	Acquires the set value of the printer setting.
	setPrinterSetting	Changes the printer setting.
	getPrinterSettingEx	Acquires the set value of the printer setting in JSON.
	setPrinterSettingEx	Specifies the printer setting in JSON.
	setPrinterSettingEx[Obsolete]	Specifies the printer setting in JSON.
	verifyPassword	Check the printer administrator password.
Information acquisition	getPrinterInformation	Acquires the printer information.
Firmware update	downloadFirmwareList	Acquires the list of the firmware.
	getPrinterFirmwareInfo	Acquires the information of the printer firmware.
	verifyUpdate	Acquires the result of the firmware update.
	updateFirmware	Instructs the printer to write the firmware image.
Forced transmission	forceRecover	Forced transmission function
	forcePulse
	forceStopSound
	forceCommand
	forceReset
Reception of result	setStatusChangeEventListener	Registers the event listener method.
	setReceiveEventListener
	setGetPrinterSettingExListener
	setSetPrinterSettingExListener
	setVerifyPasswordListener
Monitor interval	interval	<Obsolete> Status monitor interval

The print mode includes the standard mode, page mode, and the batch rotate print mode.

Standard mode
Prints line by line. Line spacing is automatically adjusted according to character size, image size, and barcode height. Suitable for printing receipts whose print length varies by print content.
Page mode
Prints page by page. Prints characters, images, and/or barcodes on a single page that is defined as a print area.
To print in the page mode, use addPageBegin and addPageEnd to start and end the page mode process, respectively.
Batch rotate print mode
This is a print mode in which the range of the print data (such as characters, images, barcodes, etc.) is set, the print data in the set range is compiled, inverted, and then printed.
When performing the processing in the batch rotate print mode, start the batch rotate print processing with addRotateBegin, and end the batch rotate print processing with addRotateEnd.

The APIs that can be used in each mode are described in the table below.

API	Standard mode	Page mode	Batch rotate print mode
Printer	-	-	-
connect	-	-	-
disconnect	-	-	-
startMonitor	✔	✔	✔
stopMonitor	✔	✔	✔
getStatus	✔	✔	✔
sendData	✔	✔	-
beginTransaction	✔	✔	✔
endTransaction	✔	✔	-
requestPrintJobStatus	✔	✔	✔
clearCommandBuffer	✔	✔	-
addTextAlign	✔	-	✔
addLineSpace	✔	✔	✔
addTextRotate	✔	-	✔
addText	✔	✔	✔
addTextLang	✔	✔	✔
addTextFont	✔	✔	✔
addTextSmooth	✔	✔	✔
addTextSize	✔	✔	✔
addTextStyle	✔	✔	✔
addHPosition	✔	✔	✔
addFeedUnit	✔	✔	✔
addFeedLine	✔	✔	✔
addImage	✔	✔	✔
addLogo	✔	✔	✔
addBarcode	✔	✔	✔
addSymbol	✔	✔	✔
addHLine	✔	-	✔
addVLineBegin	✔	-	✔
addVLineEnd	✔	-	✔
addPageBegin	✔	-	-
addPageEnd	-	✔	-
addPageArea	-	✔	-
addPageDirection	-	✔	-
addPagePosition	-	✔	-
addPageLine	-	✔	-
addPageRectangle	-	✔	-
addRotateBegin	✔	-	-
addRotateEnd	-	-	✔
addCut	✔	-	-
addPulse	✔	-	-
addSound	✔	-	-
addFeedPosition	✔	-	✔
addLayout	✔	-	✔
addCommand	✔	✔	✔

HybridPrinter class

Controls the hybrid model printers.

API		Description
Initialization	HybridPrinter	Initializes the HybridPrinter class.
Communication path	connect	Connects to the printer.
Communication path	disconnect	Disconnects from the printer.
Status monitor	startMonitor	Enables status event notification.
Status monitor	stopMonitor	Disables status event notification.
Status acquisition	getStatus	Acquires status of the connected printer.
Transmission	sendData	Transfers a print command.
Transaction	beginTransaction	Starts a transaction.
Transaction	endTransaction	Ends a transaction.
Buffer clear	clearCommandBuffer	Clears the command buffer.
Print method	selectPaperType	Specifies a print method.
Paper feed	waitInsertion	Waiting for paper insertion.
Paper feed	cancelInsertion	Cancels waiting for paper insertion.
Paper eject	ejectPaper	Ejects paper.
MICR	readMicrData	MICR reading
MICR	cleanMicrReader	Cleans the MICR mechanism.
Forced transmission	forceRecover	Forced transmission function
	forcePulse
	forceCommand
	forceReset
Print method acquisition	paperType	Acquires the print method setting information.
Monitor interval	interval	Printer status update interval
On standby	waitTime	Time from insertion of a paper to start of operation
40cpl mode	mode40Cpl	Sets the 40 cpl mode.
Reception of result	setStatusChangeEventListener	Registers the event listener method.
Reception of result	setReceiveEventListener	Registers the event listener method.

List of supported control operations for HybridPrinter class

APIs available for the HybridPrinter class depend on the type of control operation.

The following lists control operation types and available APIs.

API	Control operation
API	Receipt	Slip sheet	Endorsement	Validation	MICR
HybridPrinter	✔	✔	✔	✔	✔
connect	✔	✔	✔	✔	✔
disconnect	✔	✔	✔	✔	✔
startMonitor	✔	✔	✔	✔	✔
stopMonitor	✔	✔	✔	✔	✔
getStatus	✔	✔	✔	✔	✔
sendData	✔	✔	✔	✔	-
beginTransaction	✔	✔	✔	✔	✔
endTransaction	✔	✔	✔	✔	✔
clearCommandBuffer	✔	✔	✔	✔	-
selectPaperType	✔	✔	✔	✔	-
waitInsertion	-	✔	✔	✔	-
cancelInsertion	-	✔	✔	✔	✔
ejectPaper	-	✔	✔	✔	✔
readMicrData	-	-	-	-	✔
cleanMicrReader	-	-	-	-	✔
setStatusChangeEventListener	✔	✔	✔	✔	✔
setReceiveEventListener	✔	✔	✔	✔	✔

Creating print document by the HybridPrinter class

The HybridPrinter class creates a print document using the same API as the Printer class.

The APIs and corresponding print methods are listed below.

API		Print method
API		Receipt	Slip sheet	Endorsement	Endorsement (40cpl)	Validation
Text	addTextAlign	✔	✔	✔	-	✔
	addLineSpace	✔	✔	✔	-	✔
	addTextRotate	✔	✔	✔	✔	✔
	addText	✔	✔	✔	✔	✔
	addTextLang	✔	✔	-	-	✔
	addTextFont	✔	✔	✔	-	✔
	addTextSmooth	✔	-	-	-	-
	addTextSize	✔	✔	✔	-	✔
	addTextStyle	✔	✔^*	✔^*	-	✔^*
	addHPosition	✔	✔	✔	✔	✔
Paper feed	addFeedUnit	✔	✔	✔	✔	✔
Paper feed	addFeedLine	✔	✔	✔	✔	✔
Graphics	addImage	✔	-	-	-	-
Graphics	addLogo	✔	-	-	-	-
Barcode	addBarcode	✔	-	-	-	-
Barcode	addSymbol	✔	-	-	-	-
Page mode	addPageBegin	✔	✔	-	-	✔
	addPageEnd	✔	✔	-	-	✔
	addPageArea	✔	✔	-	-	✔
	addPageDirection	✔	✔	-	-	✔
	addPagePosition	✔	✔	-	-	✔
	addPageLine	✔	✔	-	-	-
	addPageRectangle	✔	✔	-	-	-
Cut	addCut	✔	-	-	-	-
Drawer	addPulse	✔	✔	✔	✔	✔
Command	addCommand	✔	✔	✔	✔	✔

^*The reverse parameter is not supported.

LineDisplay class

Controls character display on the customer display.

API		Description
Initialization	LineDisplay	Initializes the LineDisplay class.
Communication path	connect	Connects to the customer display.
Communication path	disconnect	Disconnects from the customer display.
Status acquisition	getStatus	Acquires status of the connected device.
Transmission	sendData	Sends a command to the customer display.
Buffer clear	clearCommandBuffer	Clears the command buffer.
Reset	addInitialize	Initializes the customer display.
Window	addCreateWindow	Defines the display area.
	addDestroyWindow	Deletes the display area setting.
	addSetCurrentWindow	Switches between display areas.
	addClearCurrentWindow	Deletes the current display area.
	addCreateScreen	Defines the base window.
	addCreateScreenCustom	Defines the base window.
	addCreateTextArea	Defines the display area.
	addDestroyTextArea	Deletes the display area setting.
	addSetCurrentTextArea	Switches between display areas.
	addClearCurrentTextArea	Deletes the current display area.
Cursor	addSetCursorPosition	Moves the cursor.
	addMoveCursorPosition	Moves the cursor within the display area.
	addSetCursorType	Changes the cursor display.
Text display	addText	Displays text.
	addReverseText	Displays inverted text.
	addMarqueeText	Displays a marquee.
Display setting	addSetBlink	Blinks display.
	addSetBrightness	Changes the display brightness.
	addBackgroundColor	Sets the background color.
Graphics	addStartSlideShow	Starts a slide show.
	addStopSlideShow	Ends a slide show.
	addDownloadImage	Displays an image.
	addRegisterDownloadImage	Registers an image.
Graphics	addNVImage	Displays an NV image.
Graphics	addClearImage	Deletes an image.
Barcode	addSymbol	Displays a two-dimensional symbol.
Barcode	addClearSymbol	Deletes a two-dimensional symbol.
Clock	addShowClock	Displays the clock.
Command transfer	addCommand	Runs an optional command.
Reception of result	setReceiveEventListener	Registers the event listener method.

The APIs and parameters that can be used vary depending on the customer display used and its display modes.

The table below shows the API that can be used in each customer display and display mode.

API	Parameter	DM-D30	DM-D70 (Standard mode)	DM-D70 (Column/row fixed mode)	DM-D110/ DM-D210
LineDisplay		✔	✔	✔	✔
connect		✔	✔	✔	✔
disconnect		✔	✔	✔	✔
getStatus		✔	✔	✔	✔
sendData		✔	✔	✔	✔
clearCommandBuffer		✔	✔	✔	✔
addInitialize		✔	✔	✔	✔
addCreateWindow		✔	-	✔	✔
addDestroyWindow		✔	-	✔	✔
addSetCurrentWindow		✔	-	✔	✔
addClearCurrentWindow		✔	-	✔	✔
addCreateScreen		-	✔	✔	-
addCreateScreenCustom		-	✔	✔	-
addCreateTextArea		-	✔	-	-
addDestroyTextArea		-	✔	-	-
addSetCurrentTextArea		-	✔	-	-
addClearCurrentTextArea		-	✔	-	-
addSetCursorPosition		✔	✔	✔	✔
addMoveCursorPosition		✔	✔	✔	✔
addSetCursorType		✔	-	-	✔
addText	data	✔	✔	✔	✔
	lang	✔*	✔	✔	✔*
	x	✔	✔	✔	✔
	y	✔	✔	✔	✔
	r	-	✔	-	-
	g	-	✔	-	-
	b	-	✔	-	-
addReverseText		✔	-	-	✔
addMarqueeText		✔	✔	✔	✔
addSetBlink		✔	-	-	✔
addSetBrightness		✔	✔	✔	✔
addBackgroundColor		-	✔	-	-
addStartSlideShow		-	✔	-	-
addStopSlideShow		-	✔	-	-
addDownloadImage		-	✔	-	-
addRegisterDownloadImage		-	✔	-	-
addNVImage		-	✔	-	-
addClearImage		-	✔	-	-
addSymbol		-	✔	-	-
addClearSymbol		-	✔	-	-
addShowClock		-	-	-	✔
addCommand		✔	✔	✔	✔
setReceiveEventListener		✔	✔	✔	✔

*: The setting value LineDisplay.LANG_MULTI cannot be used.

Keyboard class

Controls character entry from the keyboard.

API		Description
Initialization	Keyboard	Initializes the Keyboard class.
Communication path	connect	Connects to the keyboard.
Communication path	disconnect	Disconnects from the keyboard.
Status acquisition	getStatus	Acquires status of the connected device.
String setting	setPrefix	Sets the condition to handle as a continuous string.
String setting acquisition	getPrefix	Acquires the set prefix.
Key detection	setKeyPressEventListener	Registers the event listener method.
String detection	setReadStringEventListener	Registers the event listener method.

POSKeyboard class

Controls character entry from the POS keyboard.

API		Description
Initialization	PosKeyboard	Initializes the POSKeyboard class.
Communication path	connect	Connects to the keyboard.
Communication path	disconnect	Disconnects from the keyboard.
Status acquisition	getStatus	Acquires status of the connected device.
Key detection	setKeyPressEventListener	Registers the event listener method.

BarcodeScanner class

Controls barcode reading by the barcode scanner.

API		Description
Initialization	BarcodeScanner	Initializes the BarcodeScanner class.
Communication path	connect	Connects to the barcode scanner.
Communication path	disconnect	Disconnects from the barcode scanner.
Status acquisition	getStatus	Acquires status of the connected device.
Input data reception	setScanEventListener	Registers the event listener method.

MSR class

Controls card reading by the MSR.

API		Description
Initialization	Msr	Initializes the MSR class.
Communication path	connect	Connects to the MSR.
Communication path	disconnect	Disconnects from the MSR.
Status acquisition	getStatus	Acquires status of the connected device.
Data detection	setDataEventListener	Registers the event listener method.

SimpleSerial class

Controls serial communication between the printer and device.

API		Description
Initialization	SimpleSerial	Initializes the SimpleSerial class.
Communication path	connect	Connects to the serial.
Communication path	disconnect	Disconnects from the serial.
Status acquisition	getStatus	Acquires status of the connected device.
Command transfer	sendCommand	Transfers a command.
Input data reception	setReceiveEventListener	Registers the event listener method.

GermanyFiscalElement class

Connects to the German fiscal element (TSE), and controls data read/write operations.

API		Description
Initialization	GermanyFiscalElement	Initializes the GermanyFiscalElement class.
Communication path	connect	Connects to the German fiscal element (TSE).
Communication path	disconnect	Disconnects from the German fiscal element (TSE).
Status acquisition	getStatus	Acquires status of the German fiscal element (TSE).
Operation	operate	Send the JSONsring to the German fiscal element (TSE).
Reception of result	setReceiveEventListener	Registers the callback method for an event.

OtherPeripheral class

Controls peripheral devices via the developed device control programs.

API		Description
Initialization	OtherPeripheral	Initializes the OtherPeripheral class.
Communication path	connect	Connects to the device.
Communication path	disconnect	Disconnects from the device.
Status acquisition	getStatus	Acquires status of the connected device.
Transmission	sendData	Sends data to the peripheral device.
Reception of result	setReceiveEventListener	Registers the event listener method.

CommBox class

Controls data transmission and reception using the communication box.

API		Description
Initialization	CommBox	Initialize the CommBox class.
Communication path	connect	Connects to the communication box.
Communication path	disconnect	Disconnects from the communication box.
Status acquisition	getStatus	Acquires status of the connected device.
Transmission history	getCommHistory	Acquires the message transmission history.
Transmission	sendMessage	Sends a message to the communication box.
Reception	setReceiveEventListener	Registers the event listener method.

Common to all classes

These APIs can be used with all classes.

API		Description
Administration information	getAdmin	Acquires the administration information.
Administration information	getLocation	Acquires the installation location information.
Reconnection	setConnectionEventListener	Registers the event listener method.

Discovery class

Controls the device discovery function.

API		Description
Start	start	Starts device search.
Stop	stop	Stops device search.

Epos2Exception class

Acquires the error status when an exception occurs.

API		Description
Error status acquisition	getErrorStatus	Acquires the error status when an exception is thrown.

Log class

Controls the log output function.

API		Description
Log	setLogSettings	Sets the log output function.
Version acquisition	SdkVersion	Acquires the Epson ePOS SDK version.

EasySelect class

EasySelect class and EasySelectInfo class offer API commands and member variables for selecting printers by using NFC tags or QR codes.

EasySelect class is for analyzing NFC tags and QR codes.

API		Description
Analyzing of NFC tags	parseNFC	Analyzes NFC tags data.
Analyzing of QR codes	parseQR	Analyzes QR codes data.
Creation of QR codes	createQR	Creates QR code data that can be analyzed by parseQR.

EasySelectInfo class

This class is for storing data analyzed by parseNFC or parseQR. Specify the stored information in connect API to connect with the printer.

Member variables		Description
Printer type	deviceType	Stores printer type information.
Printer name	printerName	Stores a printer name.
MAC address/BD address	macAddress	Stores a MAC address or a BD address.

List of ePOS SDK API