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 MSR.
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>[<device ID>]
I/F |
Connection type |
Identifier |
Description |
||
---|---|---|---|---|---|
Wi-Fi/Ethernet |
|
|
|
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). |
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_TIMEOUT |
Failed to communicate with the devices within the specified time. |
EPOS2_ERR_CONNECT |
Failed to open the device. |
EPOS2_ERR_ILLEGAL |
Tried to start communication with a printer with which communication had been already established. Tried to start communication with a printer during reconnection process. |
EPOS2_ERR_MEMORY |
Necessary memory could not be allocated. |
EPOS2_ERR_FAILURE |
An unknown error occurred. |
EPOS2_ERR_PROCESSING |
Could not run the process. |
EPOS2_ERR_NOT_FOUND |
The device could not be found. |
EPOS2_ERR_IN_USE |
The device was in use. |
EPOS2_ERR_TYPE_INVALID |
The device type is different. |
EPOS2_ERR_RECOVERY_FAILURE |
Failed to recover the printer. |
Supplementary explanation
- The device ID is set when the MSR is registered to the TM printer (master).
The value differs depending on the control method. -
Control method
Device ID
Reference
Device control program
Logical device name
TM-DT Series Peripheral Device Control Guide
Device control script
Arbitrary character string
Technical Reference Guide of the printer
- When using multi-threading to connect to multiple printers or peripheral devices, this API and disconnect cannot be started for other printers or peripheral devices until this API finishes processing. Start the next process after this API finishes processing.
- Devices other than printers are exclusively locked.
- When EPOS2_ERR_RECOVERY_FAILURE is returned in the return value, restart the printer.
Quick Access
- Syntax
- Parameter
- Return value
- Supplementary explanation
- Introduction
- help
- Epos2MSR class