EPSON ePOS SDK for Android

Specifications
- Product: Epson ePOS SDK for Android
- Version: Ver.2.31.0a
- Uploaded Date: 2025/4/1
- File Size: 88,438KB
Product Information
The Epson ePOS SDK for Android is a software development kit targeted at development engineers working on Android applications for printing on EPSON TM printers and EPSON TM Intelligent printers.
Environment Support
- Supported OS: Android Version 5.0 to 15.0
- Supported Interface:
- TM Printer: Wired LAN, Wireless LAN, Bluetooth, USB (TypeA/TypeB/TypeC)
- TM-Intelligent Printer: Wired LAN
- TM-T88VI-iHUB: Wired LAN, Wireless LAN, USB
- Development Environment: Android SDK r15 or later, Java Development Kit 7 or later
- Supported Android Devices: ARMv5TE, AArch64, x86-64, armeabi-v7a, x86
Supplied Files
- ePOS2.jar – Compiled Java class file for API usage
- ePOSEasySelect.jar – Java class file for easy printer selection
Supported Products
For detailed information, refer to the Epson ePOS SDK for Android User’s Manual.
Remarks
In the case of using a USB interface, it is recommended to obtain permission to access the USB device in the application in advance. Refer to the user manual for detailed instructions.
Obtaining USB Device Access Permission
- Add code to AndroidManifest.xml file.
- Add device_filter.xml in resource file with specific code.
- Select “OK” when permission dialog is displayed.
[Development environment] – Android SDK r15 or later – Java Development Kit 7 or later
[Android Device] – Devices that support ARMv5TE – Devices that support AArch64 – Devices that support x86-64 – Devices that support armeabi-v7a – Devices that support x86
3. Supported Products For detailed information, please see Epson ePOS SDK for Android User’s Manual.
4. Supplied Files – ePOS2.jar Compiled Java class file, archived into a jar format file to allow APIs to be used from Java programs.
– ePOSEasySelect.jar A Java class file for selecting a printer easily

– libepos2.so Library for function execution (ARMv5TE, AArch64 and x86-64 supported)
– libeposeasyselect.so Library for the ePOSEasySelect function execution (ARMv5TE, AArch64 and x86-64
supported)
– ePOS_SDK_Sample_Android.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_Android_um_en_revx.pdf A user’s manual
– ePOS_SDK_Android_um_ja_revx.pdf A user’s manual (The Japanese-language edition)
– ePOS_SDK_Android_Migration_Guide_en_revx.pdf A migration guide
– ePOS_SDK_Android_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 Android User’s Manual.
Internal
#
Internal
#
– In the case of USB interface, it is recommended that you obtain permission to access theUSB device in the application in advance. Noted below, how to get the permission. 1. Enter the following code into the AndroidManifest.xml file. <manifest …> <application> <activity …> <intent-filter> <action

android:name=”android.hardware.usb.action.USB_DEVICE_ATTACHED” /> </intent-filter> <meta-data
android:name=”android.hardware.usb.action.USB_DEVICE_ATTACHED” android:resource=”@xml/device_filter” />
</activity> </application> </manifest>
2. Add the res/xml/device_filter.xml in resource file, enter the following code into the device_filter.xml file. <?xml version=”1.0″ encoding=”utf-8″?> <resources> <usb-device vendor-id=”1208″ /> </resources>
Please select the OK button when you get the permission dialog is displayed.
If you don’t obtain permission to access the USB device in advance, there are the following notes when using the connect method.
– When you select the OK button in the Permissions dialog box, it takes a long time of about 10 seconds to open port.
– When you select the Cancel button in the Permissions dialog box, it wait for a timeout of 30 seconds.

– If you want to set the minifyEnabled to true in the Android Studio, please add the followings to the proguard file.
-keep class com.epson.** { *; } -dontwarn com.epson.**
Proguard file (proguard-rules.pro) is set as follows in build.gradle file. buildTypes { release { proguardFiles getDefaultProguardFile(‘proguard-android.txt’), ‘proguard-rules.pro’ } }
– 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. 7. Changes from the Current Version
[Updated supplied Files] – Added SB-H50 Peripheral Device Control Guide.
Internal
#
Documents / Resources
![]() | ePOS SDK for Android |
References
- EULA.jaeula.ja
- libepos2.solibepos2.so
- libeposeasyselect.solibeposeasyselect.so
- proguard-rules.proproguard-rules.pro
- README.jareadme.ja
- User Manualmanual.tools
