EPSON Epos SDK for iOS User Guide

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

Product Usage Instructions

Printing Process Tips

To ensure proper printing, create and destroy the instance of
Printer class outside the iteration process and avoid repeating it
at short intervals.
Call the addTextLang API first on each print data.

Restrictions and Troubleshooting

Avoid using the discovery function for certain TM Intelligent
printers as specified in the manual.
If using BluetoothConnection function on iOS Version 10.0.1, be
cautious about potential crashes when disabling Bluetooth
settings.

In iOS 11, if connection fails via Bluetooth, wait about 100
msec before executing the connect API.

Frequently Asked Questions (FAQ)

Q: Where can I find more detailed information about the
supported products?

A: Please refer to the Epson ePOS SDK for iOS User’s Manual for
comprehensive details on supported products.

Q: What should I do if the TM Intelligent printer is not
detected during search?

A: If the TM Intelligent printer is not detected, ensure to
leave enough time for the printer to become printable before
starting the search again.

Q: How do I handle repeated printing processes
effectively?

A: Create and destroy the instance of Printer class outside the
iteration process and refrain from repeating it at short intervals
for optimal results.

“`

View Fullscreen

Epson ePOS SDK for iOS

Version Uploaded date File size Explanation

Ver.2.33.0
2025/6/23
94,324KB
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 [Function change] – For Users in Europe, the Middle East and Africa European Radio Equipment Directive. [Updated support OS] – Added iOS/iPad versions support – iOS 17.7.1 to 17.7.7 – iOS 18.1 to 18.5 – iPadOS 17.7.1 to 17.7.7 – iPadOS 18.1 to 18.5 [Updated supplied Files] – The software license agreement has been updated.

Documents / Resources

EPSON Epos SDK for iOS [pdf] User Guide
Epos SDK for iOS, SDK for iOS, for iOS

References

User Manual

EPSON Epos SDK for iOS User Guide

Epos SDK for iOS

Product Information

Specifications

Supported Environment

Supplied Files