1. TOP»
  2. Epson ePOS SDK for iOS »
  3. Epos2LFCPrinter class »
  4. connect

Select your printer model

Parameters are refined by the selected printer.

connect

Starts communication with the printer.

Syntax

 
 
- (int) connect:(NSString *)target timeout:(long)timeout;

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>

I/F

Connection type

Identifier

Example

Wi-Fi/Ethernet

"TCP"
  • IP address in IPv4 format
  • MAC address
  • Printer host name
 
 
 
"TCP:192.168.192.168"

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).

EPOS2_PARAM_DEFAULT

Specifies the default value (15000).

Return value

The result of the API is returned.

Error status

Description

EPOS2_SUCCESS

The function was executed successfully.

EPOS2_ERR_PARAM

An invalid parameter was passed.

EPOS2_ERR_CONNECT

Failed to open the device.

EPOS2_ERR_TIMEOUT

Failed to communicate with the devices within the specified time.

The printer's buffer is full.

EPOS2_ERR_ILLEGAL

Tried to start communication with a printer with which communication had been already established.

EPOS2_ERR_MEMORY

Necessary memory could not be allocated.

EPOS2_ERR_FAILURE

An unknown error occurred.

EPOS2_ERR_TYPE_INVALID

The device type is different.

Supplementary explanation

  • This API is not executed on the main thread. Execute it on the sub-thread.
  • When communication with the printer is no longer necessary, be sure to call disconnect to terminate it.
  • When operating with multiple printers connected in a multi-threaded manner, this API and disconnect cannot be executed on other printers until this API has been processed. Please wait for this API to finish before executing it.
  • The printer status is returned to the event registered with the Epos2LFCPrinter class.
  • If you are using DHCP to assign the IP address of the printer, specify the MAC address of the printer as the identifier.
  • Devices other than printers are exclusively locked.
  • While connecting to a single printer using the Epos2LFCPrinter class, do not use classes other than Epos2Log class and Epos2Discovery class for the same printer. While connecting to a single printer using a class other than Epos2Log class and Epos2Discovery class, do not use Epos2LFCPrinter class for the same 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 iOS

  1. TOP»
  2. Epson ePOS SDK for iOS »
  3. Epos2LFCPrinter class »
  4. connect

Jump to the top