1. TOP»
  2. Epson ePOS SDK for iOS »
  3. Epos2BluetoothConnection class »
  4. connectDevice

Select your printer model

Parameters are refined by the selected printer.

connectDevice

Shows a list of Bluetooth devices available for pairing and pairs a selected device with the terminal.

Acquires the Bluetooth address of the printer newly paired with the terminal.

Syntax

 
 
- (int) connectDevice:(NSMutableString *) macAddress;

Parameter

macAddress

The BD address of the printer newly paired is returned.

Format

Description

BT:00:11:22:33:44:55

Separated by ":" (colon).

Return value

The result of the API is returned.

Error status

Description

EPOS2_BT_SUCCESS

The function was executed successfully.

EPOS2_BT_ERR_PARAM

An invalid parameter was passed.

EPOS2_BT_ERR_UNSUPPORTED

The function was executed on an unsupported OS.

EPOS2_BT_ERR_CANCEL

Pairing connection was canceled.

EPOS2_BT_ERR_ALREADY_CONNECT

A printer already paired was selected.

EPOS2_BT_ERR_ILLEGAL_DEVICE

An invalid device was selected.

EPOS2_ERR_FAILURE

An unknown error occurred.

Supplementary explanation

  • Use this API before calling connect API.
  • This API is supported by iOS7.0 or later only.
  • When using on an iOS terminal with the arm64 architecture, add "arm64" to the architectures used to build the application.
  • Complete pairing and connecting with the Bluetooth device, and then start the application, or use connectDevice API to establish pairing and connection with the device.
 

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. Epos2BluetoothConnection class »
  4. connectDevice

Jump to the top