Epson ePOS SDK for iOS

1. Note

The Epson ePOS SDK for iOS is an SDK aimed at development engineers who are developing iOS applications for printing on an EPSON TM printer and an EPSON TM-Intelligent printer. Depending on the surrounding radio wave environment, radio waves may become saturated and communication may be disconnected. In that case please connect with the printer again. (For example, power cycle the printer or turn off / on the OS Bluetooth setting.) If it occurs frequently, please review the radio wave environment.

Please refer to the following URL for factors that block communication: https://support.apple.com/en-us/HT201542

2. Environment

[Support OS]

• iOS Ver.15 to 15.5
• iOS Ver.16 to 16.7.1
• iOS Ver.17 to 17.7.7
• iOS Ver.18 to 18.5
• iPadOS Ver.15 to 15.5
• iPadOS Ver.16.1 to 16.7.1
• iPadOS Ver.17 to 17.7.7
• iPadOS Ver.18 to 18.5

[Support interface]

[TM Printer]

• Wired LAN
• Wireless LAN
• Bluetooth
• Bluetooth Low Energy (hereinafter referred to as "BLE".)
• USB (TypeA)

[TM-Intelligent Printer]

• Wired LAN

[TM-T88VI-iHUB]

• Wired LAN
• Wireless LAN

[Development environment]

XCode16.4

3. Supported Products

For detailed information, please see Epson ePOS SDK for iOS User's Manual.

4. Supplied Files

• libepos2.xcframework
  Library for function execution
  (arm64, x86_64 supported)
• libeposeasyselect.xcframework
  Library for selecting a printer easily
  (armv7, armv7s, arm64, i386, x86_64 supported)
• ePOS_SDK_Sample_iOS.zip
  A sample program file
• DeviceControlProgram_Sample.zip
  This file contains sample device control programs
• EULA.en.txt
  Contains the SOFTWARE LICENSE AGREEMENT
• EULA.ja.txt
  Contains the SOFTWARE LICENSE AGREEMENT (The Japanese-language edition)
• ePOS_SDK_iOS_um_en_revx.pdf
  A user's manual
• ePOS_SDK_iOS_um_ja_revx.pdf
  A user's manual (The Japanese-language edition)
• ePOS_SDK_iOS_Migration_Guide_en_revx.pdf
  A migration guide
• ePOS_SDK_iOS_Migration_Guide_ja_revx.pdf
  A migration guide (The Japanese-language edition)
• TM-DT_Peripherals_en_revx.pdf
  This is the TM-DT Series Peripheral Device Control Guide
• TM-DT_Peripherals_ja_revx.pdf
  This is the TM-DT Series Peripheral Device Control Guide (The Japanese-language edition)
• JSON_Spec_sheet_revx.pdf
  JSON specification sheet
• README.en.txt
  This file
• README.ja.txt
  The Japanese-language edition of this file
• OPOS_CCOs_1.14.001.msi
  This is the OPOS CCO installer package

5. Remarks

• For detailed information, please see Epson ePOS SDK for iOS User's Manual.
• Under TCP/IP connection at iOS9.x, set the default gateway address to the network router.
• When printing process is repeated, create and destroy the instance of Printer class outside the iteration process and do not repeat it at short intervals.
• Call addTextLang API in first on each print data.

6. Restriction

• Discovery function of the following TM Intelligent printer doesn't support:
  TM-DT series (TM-DT software version 3.01 or earlier)
  TM-i series (TM-i firmware version 4.30 or earlier)
• If you turn on the TM Intelligent printer after starting the search, the TM Intelligent printer may not be detected. In that case, leave enough time for the TM Intelligent printer to become printable, then start the search again.
• BluetoothConnection function of the following iOS Version execute connectDevice API, the application may crash in a state in which to disable the Bluetooth settings.
  iOS 10.0.1
• In iOS 11, if the application fails to connect API via Bluetooth connection, please wait about 100 msec before executing connect API.

7. Changes from the Current Version

[New Function]

• Added the following API to specifies whether or not to send data which occurs while reconnection with the device is in progress after reconnection - setBufferingEnabled

[Bug fix]

• Fixed an issue where unsent responses from the device were deleted upon reconnection.