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
setPrinterSetting
Changes the set value of the printer setting.
The value acquired by this API is notified to the callback method specified in the delegate parameter.
Syntax
- (int) setPrinterSetting:(long)timeout
setttingList:(NSDictionary *)list
delegate:(id<Epos2PrinterSettingDelegate>)delegate; |
Parameter
timeout
Specifies the timeout period before completion of command transmission in milliseconds.
|
Value |
Description |
|---|---|
|
Integer from 5000 to 600000 |
Timeout period (in milliseconds) |
|
EPOS2_PARAM_DEFAULT |
Specifies the default value (10000). |
list
Specifies the list combining the changed printer setting item (type) and the set value (value).
type
Specifies the printer setting item to be changed.
|
Value |
Description |
|---|---|
|
EPOS2_PRINTER_SETTING_PAPERWIDTH |
Paper width |
|
EPOS2_PRINTER_SETTING_PRINTDENSITY |
Print density |
|
EPOS2_PRINTER_SETTING_PRINTSPEED |
Print speed |
value
Specifies the set value of the printer setting to be changed.
|
Value |
Description |
|---|---|
|
EPOS2_PRINTER_SETTING_PAPERWIDTH58_0 |
Paper width 58 mm |
|
EPOS2_PRINTER_SETTING_PAPERWIDTH60_0 |
Paper width 60 mm |
|
EPOS2_PRINTER_SETTING_PAPERWIDTH70_0 |
Paper width 70 mm |
|
EPOS2_PRINTER_SETTING_PAPERWIDTH76_0 |
Paper width 76 mm |
|
EPOS2_PRINTER_SETTING_PAPERWIDTH80_0 |
Paper width 80 mm |
|
EPOS2_PRINTER_SETTING_PRINTDENSITYDIP |
Print density DIP switch setting |
|
EPOS2_PRINTER_SETTING_PRINTDENSITY70 |
Print density 70% |
|
EPOS2_PRINTER_SETTING_PRINTDENSITY75 |
Print density 75% |
|
EPOS2_PRINTER_SETTING_PRINTDENSITY80 |
Print density 80% |
|
EPOS2_PRINTER_SETTING_PRINTDENSITY85 |
Print density 85% |
|
EPOS2_PRINTER_SETTING_PRINTDENSITY90 |
Print density 90% |
|
EPOS2_PRINTER_SETTING_PRINTDENSITY95 |
Print density 95% |
|
EPOS2_PRINTER_SETTING_PRINTDENSITY100 |
Print density 100% |
|
EPOS2_PRINTER_SETTING_PRINTDENSITY105 |
Print density 105% |
|
EPOS2_PRINTER_SETTING_PRINTDENSITY110 |
Print density 110% |
|
EPOS2_PRINTER_SETTING_PRINTDENSITY115 |
Print density 115% |
|
EPOS2_PRINTER_SETTING_PRINTDENSITY120 |
Print density 120% |
|
EPOS2_PRINTER_SETTING_PRINTDENSITY125 |
Print density 125% |
|
EPOS2_PRINTER_SETTING_PRINTDENSITY130 |
Print density 130% |
|
EPOS2_PRINTER_SETTING_PRINTSPEED1 |
Print speed level 1 |
|
EPOS2_PRINTER_SETTING_PRINTSPEED2 |
Print speed level 2 |
|
EPOS2_PRINTER_SETTING_PRINTSPEED3 |
Print speed level 3 |
|
EPOS2_PRINTER_SETTING_PRINTSPEED4 |
Print speed level 4 |
|
EPOS2_PRINTER_SETTING_PRINTSPEED5 |
Print speed level 5 |
|
EPOS2_PRINTER_SETTING_PRINTSPEED6 |
Print speed level 6 |
|
EPOS2_PRINTER_SETTING_PRINTSPEED7 |
Print speed level 7 |
|
EPOS2_PRINTER_SETTING_PRINTSPEED8 |
Print speed level 8 |
|
EPOS2_PRINTER_SETTING_PRINTSPEED9 |
Print speed level 9 |
|
EPOS2_PRINTER_SETTING_PRINTSPEED10 |
Print speed level 10 |
|
EPOS2_PRINTER_SETTING_PRINTSPEED11 |
Print speed level 11 |
|
EPOS2_PRINTER_SETTING_PRINTSPEED12 |
Print speed level 12 |
|
EPOS2_PRINTER_SETTING_PRINTSPEED13 |
Print speed level 13 |
|
EPOS2_PRINTER_SETTING_PRINTSPEED14 |
Print speed level 14 |
|
EPOS2_PRINTER_SETTING_PRINTSPEED15 |
Print speed level 15 |
|
EPOS2_PRINTER_SETTING_PRINTSPEED16 |
Print speed level 16 |
|
EPOS2_PRINTER_SETTING_PRINTSPEED17 |
Print speed level 17 |
delegate
Registers the callback method that returns the processing result of this API.
- (void) onSetPrinterSetting:(int)code;
|
- code
The processing result is stored. -
Error status
Description
EPOS2_CODE_SUCCESS
Processed successfully.
EPOS2_CODE_ERR_AUTORECOVER
Automatic recovery error occurred.
EPOS2_CODE_ERR_COVER_OPEN
Cover open error occurred.
EPOS2_CODE_ERR_CUTTER
Auto cutter error occurred.
EPOS2_CODE_ERR_MECHANICAL
Mechanical error occurred.
EPOS2_CODE_ERR_EMPTY
No paper is left in the roll paper end detector.
EPOS2_CODE_ERR_PARAM
An invalid parameter was passed.
EPOS2_CODE_ERR_MEMORY
Memory necessary for processing could not be allocated.
EPOS2_CODE_ERR_TIMEOUT
Failed to communicate with the devices within the specified time.
EPOS2_CODE_ERR_PROCESSING
Could not run the process.
EPOS2_CODE_ERR_ILLEGAL
This API was called while no communication had been started.
EPOS2_CODE_ERR_FAILURE
An unknown error occurred.
Return value
|
Error status |
Description |
|---|---|
|
EPOS2_SUCCESS |
The function was executed successfully. |
|
EPOS2_ERR_PARAM |
An invalid parameter was passed. |
|
EPOS2_ERR_FAILURE |
An unknown error occurred. |
Supplementary explanation
- This API cannot be used simultaneously with other APIs.
After executing this API, do not execute any other API until the callback is returned. - Use this API at the "beginning of a line." If this API is used elsewhere, it will be ignored.
- Do not turn off the power supply to the printer while executing this API.
- If communication with the printer is disconnected during execution of this API, the printer may become unable to operate. In such a case, turn the power supply to the printer off and then on again.
- Communication with the printer disconnects as the printer automatically restarts during
execution of this API. Reconnect as necessary.
In a network environment that uses DHCP, the IP address may change due to restart of the printer.
In such a case, search for the printer using Epos2Discovery class and reconnect. - This API can be used in the system configuration of the TM printer model and customer
display model.
With the system configuration of the TM Printer + DM-D + barcode scanner model, this API can be used when connecting via Bluetooth or USB. - This API cannot be used with SSL/TLS communication.
Quick Access
- Syntax
- Parameter
- Return value
- Supplementary explanation
- Introduction
- help
- Epos2Printer class
- initWithPrinterSeries
- connect
- disconnect
- startMonitor
- stopMonitor
- getStatus
- sendData
- beginTransaction
- endTransaction
- requestPrintJobStatus
- clearCommandBuffer
- addTextAlign
- addLineSpace
- addTextRotate
- addText
- addTextLang
- addTextFont
- addTextSmooth
- addTextSize
- addTextStyle
- addHPosition
- addFeedUnit
- addFeedLine
- addImage
- addLogo
- addBarcode
- addSymbol
- addHLine
- addVLineBegin
- addVLineEnd
- addPageBegin
- addPageEnd
- addPageArea
- addPageDirection
- addPagePosition
- addPageLine
- addPageRectangle
- addRotateBegin
- addRotateEnd
- addCut
- addPulse
- addSound
- addFeedPosition
- addLayout
- addCommand
- getMaintenanceCounter
- resetMaintenanceCounter
- getPrinterSetting
- setPrinterSetting
- getPrinterSettingEx
- setPrinterSettingEx
- setPrinterSettingEx[Obsolete]
- verifyPassword
- getPrinterInformation
- downloadFirmwareList
- getPrinterFirmwareInfo
- verifyUpdate
- updateFirmware
- forceRecover
- forcePulse
- forceStopSound
- forceCommand
- forceReset
- setStatusChangeEventDelegate
- setReceiveEventDelegate
- setGetPrinterSettingExDelegate
- setSetPrinterSettingExDelegate
- setVerifyPasswordDelegate
- interval
