downloadFirmwareList

Acquires the firmware list from the server.

The firmware list acquired by this API is notified to the callback method specified in the delegate parameter.

Syntax

<alternative>

	- (int) downloadFirmwareList: (NSString ) printerModel option:(NSString)option delegate:(id<Epos2FirmwareListDownloadDelegate>)delegate;

<obsolete>

	- (int) downloadFirmwareList: (NSString *) printerModel delegate: (id<Epos2FirmwareListDownloadDelegate>) delegate;

Parameter

printerModel

Specifies the model name of the target printer.

Value	Description
TM-m10	TM-m10
TM-m30	TM-m30
TM-m30II	TM-m30II
TM-m30II-H	TM-m30II-H
TM-m30II-NT	TM-m30II-NT
TM-m30II-S	TM-m30II-S
TM-m30III	TM-m30III
TM-m30III-H	TM-m30III-H
TM-T88VI	TM-T88VI
TM-T88VI-iHUB	TM-T88VI-iHUB
TM-P20II-WIFI	TM-P20II
TM-P80II-WIFI	TM-P80II

option

Specifies the version of the target firmware.

Value	Description
-A	Ver..A ESC/POS
-B	Ver..B ESC/POS

Ver.*.*A ESC/POS:For OT-WL02/WL06 users

Ver.*.*B ESC/POS:For OT-WL05/WL06 users

Check the firmware release information for the detailed functions of each firmware version.

If you don't use a wireless LAN unit, you can choose either A or B.

delegate

Registers the callback method that returns the processing result of this API.

	- (void) onFirmwareListDownload:(int)code firmwareList:(NSMutableArray<Epos2FirmwareInfo > )firmwareList

code
The processing result is stored.

Error status	Description
EPOS2_CODE_SUCCESS	Processed successfully.
EPOS2_CODE_ERR_CONNECT	Failed to communicate with the server.

firmwareList
The list of firmware that can be downloaded is stored in the Array format of Epos2FirmwareInfo.

Return value

Error status	Description
EPOS2_SUCCESS	The function was executed successfully.
EPOS2_ERR_PARAM	An invalid parameter was passed.
EPOS2_ERR_CONNECT	Failed to communicate with the server.
EPOS2_ERR_FAILURE	An unknown error occurred.

Supplementary explanation

This API can be used in an environment that can be connected to both the Internet and the printer.

This API cannot be used simultaneously with other APIs.
After executing this API, do not execute any other API until the callback is returned.

Do not turn off the power supply to the printer while executing this API.

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.
Since it takes time to send and receive large amounts of data over BLE connection, this API cannot be used with BLE connection.

If no firmware image exists on the server, the firmware list cannot be acquired.

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

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
Epos2LFCPrinter class
- initWithPrinterSeries
- connect
- disconnect
- startMonitor
- stopMonitor
- getStatus
- sendLFCData
- setLFCStatusChangeEventDelegate
- setSendCompleteEventDelegate
- setPrintCompleteEventDelegate
Epos2HybridPrinter class
- initWithLang
- connect
- disconnect
- startMonitor
- stopMonitor
- getStatus
- sendData
- beginTransaction
- endTransaction
- clearCommandBuffer
- selectPaperType
- waitInsertion
- cancelInsertion
- ejectPaper
- readMicrData
- cleanMicrReader
- forceRecover
- forcePulse
- forceCommand
- forceReset
- paperType
- interval
- waitTime
- mode40Cpl
- setStatusChangeEventDelegate
- setReceiveEventDelegate
Epos2LineDisplay class
- initWithDisplayModel
- connect
- disconnect
- getStatus
- sendData
- clearCommandBuffer
- addInitialize
- addCreateWindow
- addDestroyWindow
- addSetCurrentWindow
- addClearCurrentWindow
- addCreateScreen
- addCreateScreenCustom
- addCreateTextArea
- addDestroyTextArea
- addSetCurrentTextArea
- addClearCurrentTextArea
- addSetCursorPosition
- addMoveCursorPosition
- addSetCursorType
- addText
- addReverseText
- addMarqueeText
- addSetBlink
- addSetBrightness
- addBackgroundColor
- addStartSlideShow
- addStopSlideShow
- addDownloadImage
- addRegisterDownloadImage
- addNVImage
- addClearImage
- addSymbol
- addClearSymbol
- addShowClock
- addCommand
- setReceiveEventDelegate
Epos2Keyboard class
- init
- connect
- disconnect
- getStatus
- setPrefix
- getPrefix
- setKeyPressEventDelegate
- setReadStringEventDelegate
Epos2POSKeyboard class
- init
- connect
- disconnect
- getStatus
- setKeyPressEventDelegate
Epos2BarcodeScanner class
- init
- connect
- disconnect
- getStatus
- setScanEventDelegate
Epos2MSR class
- init
- connect
- disconnect
- getStatus
- setDataEventDelegate
Epos2SimpleSerial class
- init
- connect
- disconnect
- getStatus
- sendCommand
- setReceiveEventDelegate
Epos2GermanyFiscalElement class
- init
- connect
- disconnect
- getStatus
- operate
- setReceiveEventDelegate
Epos2OtherPeripheral class
- init
- connect
- disconnect
- getStatus
- sendData
- setReceiveEventDelegate
Epos2CommBox class
- init
- connect
- disconnect
- getStatus
- getCommHistory
- sendMessage
- setReceiveEventDelegate
Common to all classes
- getAdmin
- getLocation
- setConnectionEventDelegate
Epos2Discovery class
- start
- stop
Epos2Log class
- setLogSettings
- SdkVersion
Epos2BluetoothConnection class
- connectDevice
- disconnectDevice
EasySelect class
- parseNFC
- parseQR
- createQR
- parseBeacon
EasySelectInfo class
- deviceType
- printerName
- macAddress
- target
Appendix
- Status list
- Key code list
- List of Supported Classes
- List of Supported APIs
- Printer-specific Support Information
  - 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-T20X
  - TM-T60
  - TM-T70
  - TM-T70II
  - TM-T81II
  - TM-T81III
  - TM-T82
  - TM-T82II
  - TM-T82III
  - TM-T82IIIL
  - TM-T82X
  - TM-T83III
  - 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
- Usage restriction by firmware version