Uživatelská příručka EPSON Epos SDK pro iOS

Podporované prostředí
- OS podpory:
  - 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
- Rozhraní podpory:
  - Tiskárna TM: Wired LAN, Wireless LAN, Bluetooth, Bluetooth Low Energy (BLE), USB (TypeA)
  - Tiskárna TM-Intelligent: Kabelová LAN
  - TM-T88VI-iHUB: Wired LAN, Wireless LAN
  - Vývojové prostředí: XCode16.4
- Dodáno 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)
- 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.

Nejčastější dotazy

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

Opatření

 Unauthorized duplication, copying, reproduction, or modification of any part or all of this document is strictly
zakázáno.
 Contents of this manual are subject to change without prior notice. Contact us directly for the most recent
informace.
 Every effort is made to ensure that the contents of this manual are without error. Please contact us if any errors
or other issues are found.
 The previous statement notwithstanding, we will not be liable for any negative impact as a result of use.
 Epson shall not be liable for any damages caused as a result of using this product incorrectly, failing to comply
with the content of this document, or having repair or modifications performed by third parties other than
Epson or those specified by Epson.
 Epson shall not be liable for any issues as a result of installing optional parts or consumables that are not genuine Epson parts or parts certified by Epson.
ochranné známky
EPSON, EXCEED YOUR VISION, and ESC/POS are registered trademarks of Seiko Epson Corporation.
Android™ is a trademark or Google LLC.
Java™ are trademarks of Oracle Corporation, its subsidiaries, and related companies in the United States and
jiné země.
Wi-Fi® je registrovaná ochranná známka společnosti Wi-Fi Alliance®.
The Bluetooth® word mark and logo is a registered trademark of Bluetooth SIG, Inc. Seiko Epson uses these trademarks under the terms of license. Other trademarks and trade names are the property of their respective owners.
QR Code is a registered trademark of Denso Wave Incorporated.
Other company names or product names are trademarks or registered trademarks of their respective companies.
Systém příkazů ESC/POS®
Epson has embarked on a global initiative by developing ESC/POS, a unique POS printer command system. ESC/
POS contains a wealth of unique commands, many of which are patent-protected. Our system enables the configuration of versatile POS systems with a high level of scalability. In addition to being compatible with most
Epson POS printers and displays, the flexibility provided by this unique control system facilitates ease of future
upgrades. This functionality and convenience of use are appreciated around the world.
© Seiko Epson Corporation 2015-2020. All rights reserved

Bezpečnostní opatření

Význam symbolů
The following symbols are used in this manual. Make sure to understand the meaning of these symbols before
používání výrobku.
Omezení použití
Please use our products in environments and systems designed with consideration to safety and disaster
recovery such as fail-safe configurations and redundant designs, for example, if this product is used in
applications in which a high level of reliability and safety in functionality and precision is required such as in
aircraft, trains, ships, automobiles and other transportation-related applications or in crime prevention
equipment and safety equipment.
This product is not intended for use in applications that require extremely high levels of reliability and safety
such as in aerospace equipment, trunk-line communications equipment, nuclear power control equipment, and
medical equipment. Consider your usage environment and requirements carefully before using this product in
takové aplikace.
O této příručce
Účel této příručky
This manual provides the information necessary to develop applications using Epson ePOS SDK for Android.
Organizace této příručky
This manual is organized into the following chapters.
Describes usage precautions that must be observed. Incorrect handling due to the disregard of this information may result in product failure or incorrect operation.
Describes additional explanation or other useful information.
Chapter 1 Functionality
Kapitola 2 Jak používat
Chapter 3 API Reference
Chapter 4 Device Specifications
Kapitola 5 Sample Programy
Chapter 6 Application Guide
Appendix Open Source Software Licensing

Funkčnost

Epson ePOS SDK for Android is an SDK for developing Android applications. Using Epson ePOS SDK for Android
enables the use of simple code to control TM printers. Also, in some TM printers, peripheral devices such as the
customer display and barcode scanner that are connected to the printer, and slave printers that are connected
over a network can be controlled. In addition, application software using unique functions such as the spooler
function and Communication Box, etc. can also be developed.
In this manual, printers are classified as follows.

Typ Popis
TM Printers
Collective name for the following receipt printer models:
 Single-function models
 Mobile models
 Hybrid models
 TM-i Series
 TM-DT Series
Slave Printers A collective name for TM printers connected over a network that are
controlled from a smart device via the master TM printer.

Application Development in Epson ePOS SDK for Android
The following section describes the system configurations of applications developed in Epson ePOS SDK for Android.
Refer to the Technical Reference Guide of each printer for information on system configuration methods.

TM Printer Models

This is a system in which a smart device and TM printer are connected through communication.
A connection method (Bluetooth/Wi-Fi/Ethernet/USB) conforming to the specifications of your smart device and TM printer can be selected.
Multiple TM printers can be controlled via a Wi-Fi/Ethernet connection.

Customer Display Models
This is a system in which the TM printer and customer display are controlled from a smart device.
The customer display is connected to the TM printer, and the smart device and TM printer are connected through communication.
A connection method (Bluetooth/Wi-Fi/Ethernet/USB) conforming to the specifications of your smart device and TM printer can be selected.

TM Printer + DM-D30 + barcode scanner model

This is a system in which the TM Printer and DM-D30, as well as the barcode scanner are controlled from a smart device.
The DM-D30 and the barcode scanner are connected to the TM Printer, and the smart device and TM Printer are connected through communication.
A connection method (Bluetooth/Wi-Fi/Ethernet/USB) conforming to the specifications of your smart device and the TM Printer can be selected.
TM Printer + DM-D30 + barcode scanner model can be configured by the following TM printer.
❏ TM-m30
❏ TM-m30II
❏ TM-m30II-H
❏ TM-T88VI

 The ePOS-Device settings of the TM printer must be set to “Enable.”
 The ePOS-Device settings are made from EpsonNet Config (Web version) of the TM-m30.
 The default settings for the ePOS-Device settings of the TM-m30II/TM-m30II-H vary according to the destination.
Check the settings in EpsonNet Config (Web version) or TM-m30II Utility.
 The TM-T88VI ePOS-Device settings are carried out in TM-T88VI Utility.
 A combination of TM Printer + barcode scanner can also be used.

Model POS terminálu
This is a system in which a smart device and the TM printer (master) that acts as the POS terminal are connected through Wi-Fi/Ethernet network communication, and operation is performed by connecting multiple peripheral devices such as slave printers and customer display, etc. to the master printer.

In addition to Epson’s peripheral devices, the POS terminal model can control various peripheral devices from the device control program and device control script originally developed by Epson. Since the software to be loaded and the version of the software differ depending on the TM printer that acts as the POS terminal, the peripheral devices that can be controlled are also different. For details on controllable peripheral devices, refer to the Technical Reference Guide of the printer. The device control programs are implemented in TM-DT series (TM-DT software version 4.0 or later). Refer to TM-DT Series Peripheral Device Control Guide for information on the device control programs and device control scripts.

Epson ePOS SDK for Android Development Environment
The following development environment needs to be prepared to develop applications using the Epson ePOS
SDK for Android.
❏ Android SDK r15 or later
❏ Java Development Kit 7 or later
Application Operating Environment
This section describes the operating environment for applications developed using the Epson ePOS SDK for
Android.
For the most recent information on applicable smart devices, refer to the README.en.txt file obsažené v
“Epson ePOS SDK for Android” package.
Podporované tiskárny
The following list of printers can be controlled from the applications.
Single-function models
❏ TM-m10 ❏ TM-T60 ❏ TM-T82X
❏ TM-m30 ❏ TM-T70 ❏ TM-T83II
❏ TM-m30II ❏ TM-T70II ❏ TM-T83III
❏ TM-m30II-H ❏ TM-T81II ❏ TM-T88V
❏ TM-T20 ❏ TM-T81III ❏ TM-T88VI
❏ TM-T20II ❏ TM-T82 ❏ TM-T100
❏ TM-T20III ❏ TM-T82II ❏ TM-U220
❏ TM-T20IIIL ❏ TM-T82III ❏ TM-U330
❏ TM-T20X ❏ TM-T82IIIL
Mobile models
❏ TM-P20 ❏ TM-P60II
❏ TM-P60 ❏ TM-P80
Hybrid models
❏ TM-H6000V

TM-i Series
❏ TM-T20II-i ❏ TM-T88V-i (TM-i firmware Ver. 4.0 or later)
❏ TM-T70-i (TM-i firmware Ver. 4.0 or later) ❏ TM-T88VI-iHUB
❏ TM-T82II-i ❏ TM-U220-i
❏ TM-T83II-i
TM-DT Series
❏ TM-T70II-DT ❏ TM-T88VI-DT2
❏ TM-T70II-DT2 ❏ TM-H6000IV-DT
❏ TM-T88V-DT

Controllable Peripheral Devices

Control of the following peripheral devices is supported in Epson ePOS SDK for Android.
Slave printer
Wi-Fi enabled models of the following TM printers
❏ TM-P20
❏ TM-P60II (Peeler)
❏ TM-P80
The following TM printers that are equipped with a Wi-Fi/Ethernet interface
❏ TM-T20 ❏ TM-T88V
❏ TM-T20II ❏ TM-T88VI
❏ TM-T70 ❏ TM-T90
❏ TM-T70II ❏ TM-L90
❏ TM-T82II ❏ TM-U220
❏ TM-T83II ❏ TM-H6000IV
❏ TM-T88IV
The following TM-i Series/TM-DT Series
❏ TM-T20II-i ❏ TM-T88V-i (TM-i firmware Ver. 4.0 or later)
❏ TM-T70-i (TM-i firmware Ver. 4.0 or later) ❏ TM-T88V-DT (TM-DT software Ver.4.0 or later)
❏ TM-T70II-DT (TM-DT software Ver.4.0 or later) ❏ TM-U220-i
❏ TM-T82II-i ❏ TM-H6000IV-DT (TM-DT software Ver.4.0 or later)
❏ TM-T83II-i
Zákaznický displej
❏ DM-D30 ❏ DM-D110
❏ DM-D210

Peripheral Devices that can be Controlled by Device Control Programs
Peripheral devices conforming to the OPOS specifications can be controlled using the device control programs
that are supported by TM-DT series (TM-DT software version 4.0 or later).
In the categories described below, peripheral devices having a driver that runs in combination with OPOS
Common Control Object (OPOS CCO) 1.14.001 can be controlled.
❏ MSR
❏ POS keyboard
❏ Barcode scanner
Peripheral Devices that can be Controlled by Device Control Scripts
The peripheral devices listed below can be controlled from the device control scripts of the TM-i series/TM-DT
série.
❏ Key input device
 MSR (Hitachi-Omron Terminal Solutions, Corp.)
 Keyboard (Standard HID device)
 Barcode scanner (Standard HID device)
❏ Serial communication device

Web Obsah

Online reference is publicly available from the following webmísto. https://reference.epson-biz.com/pos/reference/

Omezení
❏ Set the barcode reader suffix (delimiter) to CR (carriage return code). Data cannot be obtained using any other settings.
❏ When using 2D barcode readers, Japanese and other multi-byte characters cannot be read correctly. However, when combining a TM-m30/TM-m30II/TM-m30II-H/TM-T88VI and 2D barcode reader to read a QR code, multibyte characters encoded with UTF-8 can be obtained correctly.
❏ Control codes cannot be read from 2D barcode data if it contains ASCII control codes (0x00 through 0x1F).
❏ The number of device ports that can be simultaneously opened in the same application is 16 ports.
❏ Activity may sometimes be destroyed when rotating the screen. When storing print instances as Activity, call closePrinter from the Print class before the Activity is destroyed.
❏ Communication will be disrupted if a terminal enters sleep mode while communicating with a printer via a Bluetooth connection.
❏ When using a virtual device, a MAC address cannot be used in the target parameter for the connect API.

Jak používat

This section describes how to create Epson ePOS SDK for Android projects and some basic programming methods used in the Epson ePOS SDK for Android.

Printer Connections
Connect smart devices and printers using a connection method that matches the system you want to create. Refer to the Technical Reference Guide of each printer for more information.

To connect via USB, refer to To connect via USB.

Creating an Epson ePOS SDK for Android Project

You can get the Android Studio from the following URL. http://developer.android.com/sdk/index.html

Start Android Studio and click on Start a new Android Studio project to create a new project.

Configure the project in accordance with the type of application you will create.
Configure the project in accordance with the instructions shown on the screen.
3 Store ePOS2.jar and ePOSEasySelect.jar in the following location.
C:\Users\[account name]\AndroidStudioProjects\[project name]\app\libs
4 Create the following folder structure.
C:\Users\[account name]\AndroidStudioProjects\[project name]\app\src\main\jniLibs
5 Depending on your CPU, store the following folders bundled with this package in the
jniLibs folder:
❏ armeabi
❏ arm64-v8a
❏ x86_64

Open the project that was created in Android Studio.
7 Run Clean Project from the Build menu.
8 Double-click on AndroidManifest.xml.

9 Under the element, declare the permission that specifies the method for connecting with devices.

Programovací příručka
This section describes some of the basic programming methods used in the Epson ePOS SDK for Android.
Programovací tok
This section describes a flow to create a program for controlling printers or peripheral devices respectively.
❏ Controlling Printers
❏ Controlling Customer Displays
❏ Controlling Keyboards and Barcode Scanners
Controlling Printers
The method of controlling the TM printer and slave printer, and programming receipt printing is described
níže.
Printer selection (class initialization)
Initialize the Printer class and select the printer to control.
Register the print complete event listener.
Do not add an API of Epson ePOS SDK in the callback.
1. Printer selection (class initialization)
2. Creating print data (data buffering)
3. Sending print data (connection with the devices/communication/printing/disconnection)
Printer printer = null;
zkuste {
printer = new Printer(Printer.TM_T88, Printer.MODEL_ANK, this);
}
catch (Epos2Exception e) {
//Displays error messages
}
printer.setReceiveEventListener(this);

Reference API

This chapter describes the APIs provided by Epson ePOS SDK for Android.
List of ePOS SDK API
Epson ePOS SDK for Android provides the following classes:
❏ Printer class
❏ HybridPrinter class
❏ LineDisplay class
❏ Keyboard class
❏ POSKeyboard class
❏ BarcodeScanner class
❏ MSR class
❏ SimpleSerial class
❏ GermanyFiscalElement class
❏ OtherPeripheral class
❏ CommBox class
❏ Common to all classes
❏ Discovery class
❏ Epos2Exception class
❏ Log class
❏ EasySelect class
❏ EasySelectInfo class
Printer class
Controls printing by the printer.
 Available APIs and parameters vary by printer model and peripheral device.
Refer to List of Supported Classes.
 For the list of APIs of each class, and the APIs supported by each printer, refer to List of Supported APIs.
Popis API
Initialization Printer Initializes the Printer class.
Komunikační cesta
connect Connects to the printer.
disconnect Disconnects from the printer.
Monitor stavu
startMonitor Enables status event notification.
stopMonitor Disables status event notification.

Dokumenty / zdroje

EPSON Epos SDK for iOS [pdfUživatelská příručka
Epos SDK for iOS, SDK for iOS, for iOS

Reference

Uživatelská příručka

EPSON Epos SDK for iOS

Specifikace

Návod k použití produktu