1. TOP»
  2. Epson ePOS SDK for Android »
  3. CommBox class »
  4. connect

Select your printer model

Parameters are refined by the selected printer.

connect

Starts communication with the communication box.

Syntax

 
 
public void connect(String target, int timeout, String myId) throws Epos2Exception

Parameter

target

Specifies the method of connecting to the printer by a character string.

Specify the connection method using the following syntax.

<connection type>:<identifier>[<box ID>]

I/F

Connection type

Identifier

Example

Wi-Fi/Ethernet
  • "TCP"
  • "TCPS"
  • IP address in IPv4 format
  • MAC address
  • Host name
 
 
 
"TCP:192.168.192.168[Box1]"

To connect to the printer via SSL/TLS communication, specify TCPS in the connection type.

timeout

Specifies the maximum time (in milliseconds) to wait for communication with the printer to be established.

Value

Description

Integer from 1000 to 300000

Maximum wait time before an error is returned (in milliseconds).

CommBox.PARAM_DEFAULT

Specifies the default value (15000).

myId

Specifies a member ID to identify the application itself in the communication box.

Exception

When the process fails, Epos2Exception with one of the following error value occurs.

Error status

Description

ERR_PARAM

An invalid parameter was passed.

ERR_CONNECT

Could not open the device.

ERR_TIMEOUT

Failed to communicate with the devices within the specified time.

ERR_MEMORY

Memory necessary for processing could not be allocated.

ERR_FAILURE

An unknown error occurred.

ERR_PROCESSING

Could not run the process.

ERR_ALREADY_OPENED

Communication box is already open.

ERR_ALREADY_USED

Specified member ID is already in use.

ERR_BOX_COUNT_OVER

The number of created communication boxes has exceeded the upper limit.

ERR_BOX_CLIENT_OVER

The number of members belong to the communication box has exceeded the upper limit.

ERR_RECOVERY_FAILURE

Failed to recover the printer.

Supplementary explanation

  • This API will succeed regardless of the connection status of the TM printer (master) and peripheral devices.
  • Devices other than printers are exclusively locked.
  • If Epos2Exception including ERR_RECOVERY_FAILURE occurs, restart the printer.
 

Quick Access

  • [Name]
  • [Format]
  • [Range]
  • [Description]
  • [Notes]
Epson ePOS SDK includes patented or patent pending functions. The contents must not be disclosed to third parties.


Epson ePOS SDK for Android

  1. TOP»
  2. Epson ePOS SDK for Android »
  3. CommBox class »
  4. connect

Jump to the top