Select your printer model [−]
- TM-m10
- TM-m30
- TM-m30II
- TM-m30II-H
- TM-m30II-NT
- TM-m30II-S
- TM-m30II-SL
- TM-m30III
- TM-m30III-H
- TM-m50
- TM-m50II
- TM-m50II-H
- TM-T20
- TM-T20II
- TM-T20III
- TM-T20IIIL
- TM-T20IV
- TM-T20IV-L
- TM-T20IV-SP
- TM-T20X
- TM-T20X-II
- TM-T60
- TM-T70
- TM-T70II
- TM-T81II
- TM-T81III
- TM-T82
- TM-T82II
- TM-T82III
- TM-T82IIIL
- TM-T82IV
- TM-T82IV-L
- TM-T82X
- TM-T82X-II
- TM-T83III
- TM-T83IV
- TM-T88V
- TM-T88VI
- TM-T88VII
- TM-T100
- TM-L90 Liner-Free Label Printer Model
- TM-L100
- TM-U220
- TM-U220II
- TM-U330
- TM-P20
- TM-P20II
- TM-P60 (Receipt)
- TM-P60 (Peeler)
- TM-P60II (Receipt)
- TM-P60II (Peeler)
- TM-P80
- TM-P80II
- TM-H6000V
- TM-T20II-i
- TM-T70-i
- TM-T82II-i
- TM-T83II-i
- TM-T88V-i
- TM-T88VI-iHUB
- TM-U220-i
- TM-U220IIB-i
- TM-T70II-DT
- TM-T70II-DT2
- TM-T88V-DT
- TM-T88VI-DT2
- TM-H6000IV-DT
- TM-T88IV
- TM-T90
- TM-L90
- TM-H6000IV
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" |
|
|
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
- Syntax
- Parameter
- Return value
- Supplementary explanation