Epson C31CD38124 TM-T70II POS Receipt Printer User Manual

ePOS-Print XML

User’s Manual

Describes the features and development environment.

Describes how to use the sample program and how to build a system.

Describes how to write programs in Web application development.

Describes the ePOS-Print XML.

Describes specications of printers and other devices.

Describes the necessary information for controlling customer displays.

M00048218

Rev.S

Overview

Sample Program

Programming Guide

XML Reference

Device Specifications

Development Information for Customer Displays

Appendix

Cautions

 Unauthorized duplication, copying, reproduction, or modification of any part or all of this document is strictly

prohibited.

 Contents of this manual are subject to change without prior notice. Contact us directly for the most recent

information.

 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 gen-

uine Epson parts or parts certified by Epson.

Trademarks

EPSON, EXCEED YOUR VISION, and ESC/POS are registered trademarks of Seiko Epson Corporation.

Microsoft®, Windows®, Visual Studio®, Silverlight® and Internet Explorer® are either registered trademarks or

trademarks of Microsoft Corporation in the United States and other countries.

Android™ and Google Chrome™ are either registered trademarks or trademarks of Google Inc. in the United

States and other countries.

AirPlay, iPad, iPhone, iPod, iPod classic, iPod nano, iPod touch, and Retina are trademarks of Apple Inc., registered

in the U.S. and other countries. iPad Air, iPad mini, and Lightning are trademarks of Apple Inc. The trademark

“iPhone” is used with a license from Aiphone K.K.

Apple®, Mac OS®, iTunes® and Xcode® are trademarks of Apple Inc. registered in the US and other countries.

IOS® is registered trademarks or trademarks of Cisco in the United States and other countries.

Flash®, Flex™ are either registered trademarks or trademarks of Adobe Systems Incorporated in the United States

and other countries.

Java™ is a registered trademark of Oracle Corporation, its subsidiaries, and affiliates in the U.S. and other coun-

tries.

Eclipse® is a trademark or registered trademark of Eclipse Foundation, Inc.

FileMaker is a trademark of FileMaker, Inc., registered in the U.S.and other countries.

QR Code® is a registered trademark of DENSO Wave Incorporated.

All other trademarks are the property of their respective owners and used for identification purpose only.

ESC/POS® Command System

Epson has embarked on a global initiative to develop 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 configura-

tion 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.

For Safety

Key to Symbols

The symbols in this manual are identified by their level of importance, as defined below. Read the following

carefully before handling the product.

Restriction of Use

When this product is used for applications requiring high reliability/safety such as transportation devices related

to aviation, rail, marine, automotive etc.; disaster prevention devices; various safety devices etc; or functional/

precision devices etc, you should use this product only after giving consideration to including fail-safes and

redundancies into your design to maintain safety and total system reliability. Because this product was not

intended for use in applications requiring extremely high reliability/safety such as aerospace equipment, main

communication equipment, nuclear power control equipment, or medical equipment related to direct medical

care etc, please make your own judgment on this product’s suitability after a full evaluation.

Provides information that must be observed to avoid damage to your equipment or a malfunction.

Provides important information and useful tips.

About this Manual

Aim of the Manual

This manual is aimed to provide developers with information required for developing and designing applications

using ePOS-Print XML.

In this manual, "ePOS-Print supported printer" is a generic term for the TM-DT series/TM-i series and TM printers

that support the ePOS-Print XML.

The TM-DT series in this manual is a generic term for the following printers.

 TM-H6000IV-DT

 TM-T70II-DT

 TM-T88V-DT

The TM-i series in this manual is a generic term for the following printers.

 TM-L90-i

 TM-T20II-i

 TM-T70-i

 TM-T82II-i

 TM-T83II-i

 TM-T88V-i

 TM-T88VI-iHUB

 TM-U220-i

Manual Content

The manual is made up of the following sections:

Chapter 1 Overview

Chapter 2 Sample Program

Chapter 3 Programming Guide

Chapter 4 XML Reference

Chapter 5 Device Specifications

Chapter 6 Development Information for Customer Displays

Appendix ePOS-Print Editor

Contents

■ For Safety ............................................................................................................................. 3

Key to Symbols..........................................................................................................................................................................................3

■ Restriction of Use ................................................................................................................. 3

■ About this Manual................................................................................................................ 4

Aim of the Manual.................................................................................................................................................................................... 4

Manual Content ........................................................................................................................................................................................4

■ Contents ............................................................................................................................... 5

Overview ....................................................................................... 9

■ Overview .............................................................................................................................. 9

■ XML Print Service ...............................................................................................................10

Features......................................................................................................................................................................................................10

Interface Type ..........................................................................................................................................................................................10

WSDL(Web Services Description Language)................................................................................................................................12

Print Image................................................................................................................................................................................................12

Operating Environment .......................................................................................................................................................................12

ePOS-Print Service Versions................................................................................................................................................................16

Restrictions ...............................................................................................................................................................................................18

■ XML Reference ...................................................................................................................19

XML Schemas...........................................................................................................................................................................................19

Namespace ...............................................................................................................................................................................................19

Command Type.......................................................................................................................................................................................20

■ Provided Article ................................................................................................................. 21

Package......................................................................................................................................................................................................21

Manual........................................................................................................................................................................................................21

Sample Program .....................................................................................................................................................................................21

Download..................................................................................................................................................................................................21

Sample Program.......................................................................... 22

■ Overview ............................................................................................................................ 22

Sample Program Overview.................................................................................................................................................................22

■ Environment ...................................................................................................................... 23

■ Operating Environment ..................................................................................................... 24

■ Environment Settings ........................................................................................................ 25

ePOS-Print Settings................................................................................................................................................................................26

Editing the Sample Program ..............................................................................................................................................................28

Registering the Sample Program......................................................................................................................................................28

■ Environment Settings in Other Execution Environments .................................................. 29

HTML5 (To Build a Web Server on Windows/Linux)...................................................................................................................29

Java..............................................................................................................................................................................................................30

Windows (Visual Basic .NET)...............................................................................................................................................................31

Silverlight...................................................................................................................................................................................................32

Flash............................................................................................................................................................................................................ 33

Android ..................................................................................................................................................................................................... 34

Windows CE............................................................................................................................................................................................. 36

iOS............................................................................................................................................................................................................... 39

Windows Store Apps ............................................................................................................................................................................ 40

Programming Guide .....................................................................41

■ How to Use XML Schemas................................................................................................... 41

Visual Studio............................................................................................................................................................................................ 41

Eclipse........................................................................................................................................................................................................ 44

■ Executing Print Service ...................................................................................................... 45

Printing Mode of the TM Printer....................................................................................................................................................... 45

Programming Flow ............................................................................................................................................................................... 45

Print Document Creation.................................................................................................................................................................... 46

Transmission of Print Document...................................................................................................................................................... 50

Reception of Print Result..................................................................................................................................................................... 53

Checking the Printer Status ............................................................................................................................................................... 56

■ Specifying the Print Job ID from the Application............................................................... 57

■ Using the Spooler Function................................................................................................ 58

Programming Example........................................................................................................................................................................ 59

■ How to Use WSDL ............................................................................................................... 61

.NET Framework ..................................................................................................................................................................................... 61

Java ............................................................................................................................................................................................................. 63

XML Reference..............................................................................64

■ ePOS-Print XML..................................................................................................................64

XML for Controlling Printer ................................................................................................................................................................ 64

XML for Controlling Customer Display .......................................................................................................................................... 66

■ XML for Controlling Printer................................................................................................ 67

<epos-print> ........................................................................................................................................................................................... 67

<response>.............................................................................................................................................................................................. 68

<text> ........................................................................................................................................................................................................ 71

<feed> ....................................................................................................................................................................................................... 76

<image>.................................................................................................................................................................................................... 78

<logo>....................................................................................................................................................................................................... 80

<barcode>................................................................................................................................................................................................ 81

<symbol> ................................................................................................................................................................................................. 86

<hline> ...................................................................................................................................................................................................... 91

<vline-begin> ......................................................................................................................................................................................... 92

<vline-end>............................................................................................................................................................................................. 93

<page>...................................................................................................................................................................................................... 94

<area>........................................................................................................................................................................................................ 95

<direction>.............................................................................................................................................................................................. 97

<position>................................................................................................................................................................................................ 98

<line>.......................................................................................................................................................................................................100

<rectangle> ...........................................................................................................................................................................................102

<cut>........................................................................................................................................................................................................104

<pulse> ...................................................................................................................................................................................................105

<sound> .................................................................................................................................................................................................106

<command> .........................................................................................................................................................................................108

<layout> .................................................................................................................................................................................................109

<recovery>............................................................................................................................................................................................. 114

<reset> ....................................................................................................................................................................................................115

■ XML for Controlling Customer Display............................................................................. 116

<epos-display>.....................................................................................................................................................................................116

<window>.............................................................................................................................................................................................. 119

<cursor> .................................................................................................................................................................................................122

<blink>....................................................................................................................................................................................................123

<brightness>.........................................................................................................................................................................................124

<marquee>............................................................................................................................................................................................125

<clock>....................................................................................................................................................................................................127

<clear> ....................................................................................................................................................................................................128

<command> .........................................................................................................................................................................................130

Device Specifications................................................................. 131

■ XML Supported Printers................................................................................................... 131

■ Supported Elements List.................................................................................................. 132

XML for Controlling Printer ..............................................................................................................................................................132

■ Printer-specific Support Information .............................................................................. 135

TM-L90.....................................................................................................................................................................................................135

TM-L90 4xx.............................................................................................................................................................................................138

TM-m10................................................................................................................................................................................................... 140

TM-m30................................................................................................................................................................................................... 142

TM-P20 ....................................................................................................................................................................................................144

TM-P60II (Receipt) ............................................................................................................................................................................... 147

TM-P60II (Peeler).................................................................................................................................................................................. 149

TM-P80 ....................................................................................................................................................................................................151

TM-T20..................................................................................................................................................................................................... 154

TM-T20II...................................................................................................................................................................................................157

TM-T70..................................................................................................................................................................................................... 160

TM-T70II...................................................................................................................................................................................................162

TM-T82II...................................................................................................................................................................................................165

TM-T83II...................................................................................................................................................................................................168

TM-T88IV .................................................................................................................................................................................................171

TM-T88V .................................................................................................................................................................................................. 173

TM-T88VI .................................................................................................................................................................................................176

TM-T90..................................................................................................................................................................................................... 178

TM-U220 .................................................................................................................................................................................................180

TM-U330 .................................................................................................................................................................................................181

TM-H6000IV...........................................................................................................................................................................................182

TM-H6000V ............................................................................................................................................................................................184

TM-L90-i ..................................................................................................................................................................................................186

TM-T20II-i................................................................................................................................................................................................189

TM-T70-i ..................................................................................................................................................................................................192

TM-T82II-i................................................................................................................................................................................................194

TM-T83II-i................................................................................................................................................................................................197

TM-T88V-i................................................................................................................................................................................................200

TM-T88VI-iHUB......................................................................................................................................................................................203

TM-U220-i............................................................................................................................................................................................... 206

TM-T70II-DT............................................................................................................................................................................................ 207

TM-T88V-DT ...........................................................................................................................................................................................210

TM-H6000IV-DT .................................................................................................................................................................................... 213

■ Usage Restrictions by Firmware Version.......................................................................... 215

■ ePOS-Print Settings ......................................................................................................... 217

Development Information for Customer Displays..................... 218

■ Overview - Differential Information ................................................................................ 218

Interface..................................................................................................................................................................................................218

WSDL(Web Services Description Language).............................................................................................................................218

XML Schemas........................................................................................................................................................................................ 219

Command............................................................................................................................................................................................... 219

Provided Article....................................................................................................................................................................................219

■ Programming Guide (XML Print Service) ......................................................................... 220

How to Use XML Schemas................................................................................................................................................................ 220

Creating and Sending the Documents to be Displayed........................................................................................................220

■ Specifying the Print Job ID from the Application............................................................. 224

■ How to Use WSDL ............................................................................................................. 225

How to use WSDL ................................................................................................................................................................................225

Appendix ................................................................................... 228

■ ePOS-Print Editor ............................................................................................................. 228

ePOS-Print Editor Operating Environment................................................................................................................................. 228

Environment Setting Procedure..................................................................................................................................................... 228

Setting ..................................................................................................................................................................................................... 230

Creating a Sample Code....................................................................................................................................................................231

Encoding Graphic Data .....................................................................................................................................................................235

Chapter 1 Overview

Overview

This chapter describes the features of and the specifications for ePOS-Print.

Overview

ePOS-Print is an Epson's unique printing function that uses XML and Web Service.

This function creates request messages in XML format using the application on devices such as computers, smart

phones, and tablets, and performs printing to a TM printer on the network using Web Service.

It also allows you to control display of a customer display connected to the printer. The control is available with a

specific set of printer and customer display. For the information, refer to XML Supported Printers (p.131).

This document is made up of the following sections:

 XML Print Service (p.10)

 XML Reference (p.19)

For details about the provided articles, refer to Provided Article (p.21).

Print data can be created in ePOS-Print XML format also with Server Direct Print. For details, refer to XML

Reference (p.64).

Chapter 1 Overview

XML Print Service

ePOS-Print XML allows printing to ePOS-Print supported TM printer from applications in an environment or on

OS where HTTP communication is possible. ePOS-Print XML embedded into native applications on smart phones

and tablet terminals makes it possible to print from such devices.

When a print document is sent from a host to an ePOS-Print supported TM printer using SOAP/HTTP, the ePOS-

Print supported TM printer performs printing and returns a response document.

Features

❏ Allows printing from SOAP/HTTP-supported devices. Not OS-dependent.

❏ Installation of drivers and plug-ins is not required.

❏ No computers or servers are required for printing.

❏ In case of TM-DT series/TM-i series, it can print to other TM printer via printer.

❏ Automatically checks the status of the TM printer before printing. There is no need for checking the status of

the TM printer in advance.

❏ Does not respond to a printer's function to automatically send its status (Auto Status Back). Instead, capable of

sending an empty print command and checking the status of the TM printer based on the result of command

transmission.

❏ To change the printer settings, utility programs dedicated to each printer or other utility programs should be

used.

❏ Capable of obtaining the printer status even when the printer is offline.

Interface Type

❏ SOAP/HTTP Interface (p.11)

❏ SOAP/HTTP Interface (WSDL supported) (p.11)

❏ Interface for FileMaker® (p.11)

Application

(Response)

(Request)

ePOS-Print supported TM printer

ePOS-Print Service

Chapter 1 Overview

SOAP/HTTP Interface

When a print document is sent from an application to ePOS-Print Service using SOAP/HTTP, ePOS-Print Service

performs printing and returns a response document.

Specification

SOAP/HTTP Interface (WSDL supported)

When a print document is sent from an application to ePOS-Print Service using SOAP/HTTP, ePOS-Print performs

printing and returns a response document. Job ID can be specified.

(ePOS-Print Service Ver.4.1 or later versions supported.)

Specification

Interface for FileMaker

This interface uses the HTTP POST function of FileMaker for printing.

(ePOS-Print Service Ver.4.1 or later versions supported.)

Specification

Item Description

End point address http://[IP address of the ePOS-Print supported TM printer]/cgi-bin/epos/

service.cgi?devid=[device ID]&timeout=[timeout time]

Request message A SOAP message is sent against a HTTP POST method request.

One print document is specified in the SOAP body.

Response message A SOAP message is returned against a HTTP POST method response.

A response document is put in the SOAP body.

Item Description

End point address http://[IP address of the ePOS-Print supported TM printer]/cgi-bin/epos/service.cgi

Request message A SOAP message is sent against a HTTP POST method request.

In the SOAP header, the device ID, timeout time, and job ID can be specified.

One print document is specified in the SOAP body.

Response message A SOAP message is returned against a HTTP POST method response.

A device ID and a job ID are put in the SOAP header.

A response document is put in the SOAP body.

Item Description

End point address httppost://[IP address of the ePOS-Print supported TM printer]/cgi-bin/epos/

service.cgi?printdata=[SOAP message]

Request message A SOAP message is sent against a request in the HTTP POST function of FileMaker. In the

SOAP header, the device ID, timeout time, and job ID can be specified. One print document

is specified in the SOAP body.

Response message A SOAP message is returned against a response in the HTTP POST function of FileMaker. A

device ID and a job ID are put in the SOAP header.

A response document is put in the SOAP body.

Chapter 1 Overview

WSDL(Web Services Description Language)

WSDL defines the SOAP/HTTP interface in XML Print Service.

This allows you to generate client codes (proxy class) from WSDL by using the tool provided in the development

environment.

File name: epos-print-x.x.x.wsdl

epos-print-x.x.x.xsd

For details, refer to How to Use WSDL (p.61).

Print Image

Operating Environment

Application Environment

An environment in which HTTP communication is possible and XML documents can be handled

❏ OS (Example: iOS/ Android™/ Windows CE/ Windows/ Linux/ Mac OS, etc.)

❏ HTML5-supported browser, Flex, Silverlight

❏ Java, .NET Framework

Device

A device capable of HTTP communication by connecting to the network.

(Example: smart phones, tablet terminals, computers, etc.)

Development Environment

An editor program capable of editing XML documents.

(Example: Visual Studio/Eclipse, etc.)

Print text

Print raster image

Print barcode: EAN13

Paper feed: 24 dots

Chapter 1 Overview

ePOS-Print Supported Printer

For differences in functions according to printer type, refer to Printer-specific Support Information (p.135).

TM-DT Series

❏ TM-H6000IV-DT (Receipt printer only)

❏ TM-T70II-DT

❏ TM-T88V-DT

TM-i Series

❏ TM-L90-i ❏ TM-T83II-i

❏ TM-T20II-i ❏ TM-T88V-i

❏ TM-T70-i ❏ TM-T88VI-iHUB

❏ TM-T82II-i ❏ TM-U220-i

TM Printer

❏ Wi-Fi/Ethernet enabled models of the following TM printers

 TM-m10  TM-P60II (Peeler)

 TM-m30  TM-P80

 TM-P20  TM-T88VI

 TM-P60II (Receipt)  TM-H6000V (Receipt printer only)

❏ The following TM printers that are equipped with UB-E04 or UB-R04

 TM-L90  TM-T83II

 TM-L90 4xx  TM-T88IV

 TM-T20  TM-T88V

 TM-T20II  TM-T90

 TM-T70  TM-U220

 TM-T70II  TM-U330

 TM-T82II  TM-H6000IV (Receipt printer only)

You can check the interfaces equipped with the printer by printing a status sheet.

For more information, refer to the Technical Reference Guide of the printer.

Chapter 1 Overview

Printer Functions

Functionality available with ePOS-Print XML varies by printer.

Refer to the following for more information.

*1 Controllable TM printers vary by the version of software and firmware installed in printers.

For details, refer to the Technical

Reference Guide of the printer.

*2 TM-DT software Ver.3.0 or later.

*3 TM-i firmware Ver.4.1 or later.

*4 TM-DT software Ver.2.5 or later.

*5 TM-i firmware Ver.4.3 or later.

*6 TM printers equipped with UB-E04.

Printer Name Network printer control

Spooler/Print forwarding HTTPS Communication

TM-H6000IV-DT ✔✔

✔

TM-T70II-DT ✔ ✔

✔

TM-T88V-DT ✔✔

✔

TM-L90-i ✔ ✔

✔

TM-T20II-i ✔✔

✔

TM-T70-i ✔ ✔

✔

TM-T82II-i ✔✔

✔

TM-T83II-i ✔ ✔

✔

TM-T88V-i ✔✔

✔

TM-T88VI-iHUB ✔ ✔ ✔

TM-U220-i ✔✔

✔

TM-m10 - - ✔

TM-m30 - - ✔

TM-P20 - - -

TM-P60II (Receipt) - - -

TM-P60II (Peeler) - - -

TM-P80---

TM-T88VI ✔ ✔ ✔

TM-H6000V - - ✔

TM-L90 - - ✔

TM-T20 - - ✔

TM-T20II - - ✔

TM-T70 - - ✔

TM-T70II - - ✔

TM-T82II - - ✔

TM-T83II - - ✔

TM-T88IV - - ✔

TM-T88V - - ✔

TM-T90 - - ✔

TM-U220 - - ✔

TM-U330 - - ✔

TM-H6000IV - - ✔

Chapter 1 Overview

Check the followings for HTTPS communication.

• Prepare a certificate and secret key for the server, then register them to the printer.

• Self-signed certificates can be created by TM-DT series devices with version 4.0 or later of the TM-DT

software, TM-i series devices, and TM-T88VI devices. For instructions on how to create a self-signed

certificate, see Technical Reference Guide of the printer. Name and common name of the self-signed

certificate are the printer’s IP address.

• Common name of the server certificate and the host name of the printer must be the same. Otherwise,

HTTPS communication will fail with an error.

• Embed a CA (certificate authority) certificate, which is used to authenticate the CA signature on the server

certificate, in your program. Otherwise, HTTPS communication will fail with an error.

• When creating an iOS application, make sure to satisfy the requirements of ATS (App Transport Security).

• Comply with requirements for HTTPS communication of your application development environment.

• To send print data to the printer from an application on a HTTPS Web site, make sure to use HTTPS instead

of HTTP to communicate with the printer. Otherwise, the communication will fail with an error.

Chapter 1 Overview

ePOS-Print Service Versions

Depending on the version of ePOS-Print Service installed on the printer, some functions does not work with

ePOS-Print XML. (Usage Restrictions by Firmware Version (p.215))

How to check the version

TM Printers

You can check it using EPSON TMNet WebConfig. Refer to the Technical Reference Guide of each printer for more

information.

TM-DT Series/TM-i Series

The ePOS-Print Service of TM-DT Series and TM-i Series is installed in TM-DT software/TM-i firmware.

The table below shows which ePOS-Print Service version is included in which TM-DT software/TM-i firmware

version.

If XML element of newly added is used on unsupported models, schema error is returned and printing

cannot be done. The latest version of the XML Schema is recommended regardless of ePOS-Print Service

version installed on a printer. XML Schema is bundled with the sample program. For details, refer to Provided

Article (p.21).

ePOS-Print Service TM-DT Software TM-i Firmware

1.2 - 1.2x

2.0 - 2.0x

2.1 - 2.1x

2.2 2.0x -

3.0 2.2x, 2.5x 3.0x, 3.1x, 4.0x

3.2 - -

4.1 3.0x, 4.0x 4.1x, 4.3x, 4.4x

5.0 - -

6.0 - -

Chapter 1 Overview

TM-T88VI/TM-T88VI-iHUB/TM-H6000V

Print TM intelligent setting information to check the version.

Follow the procedure below.

Close the roll paper cover. Hold down the paper feed button and turn on the printer.

Hold the paper feed button down until printing of operating instruction starts.

Following the instructions, press the paper feed button six times to select the TM intelligent

setting information to be printed.

Press the paper feed button again and hold it down until the TM intelligent setting information

is printed.

The ePOS-Print Service version is indicated as shown below.

❏ TM-T88VI/TM-T88VI-iHUB

❏ TM-H6000V

When printing is finished, turn the printer off.

The operating instruction is printed after the printer status is printed.

Chapter 1 Overview

Restrictions

❏ The drawer and the buzzer cannot be used together.

❏ The buzzer function cannot be used if the printer is not provided with the buzzer.

❏ When multiple tones are set for raster images, intermitting printing may occur because the amount of data to

print increases and white stripes may appear in the print result.

❏ The scan quality of barcodes/2D-codes printed as multiple-tone raster images cannot be guaranteed. Print

them as two-tone images.

❏ If printing was cancelled, perform the following settings to clear the data left in the printer. 

(in ePOS-Print Service Ver.3.0 and later)

 In the printer DIP switches (memory switches), configure the Busy condition only for the receive buffer full.

 Disable the command execution (offline).

❏ Messages that contain BOM are not supported.

❏ Printing is not possible with a software application for iOS9 built on the Xcode development environment for

iOS, because HTTP communication is not allowed by APP Transport Security. We recommend to develop your

application on Epson ePOS SDK for iOS. 

https://reference.epson-biz.com/pos/reference/

❏ Only UTF-8 character encoding is supported.

Chapter 1 Overview

XML Reference

ePOS-Print XML is a POS printer command system that defines the major features of the ESC/POS command

system using XML.

XML Schemas

The ePOS-Print XML syntax is defined by W3C XML Schemas.

XML schemas help applications strictly validate XML documents using the XML API of the operating

environment. In addition, application developers can efficiently create XML documents using the XML document

editing support function of the integrated development environment.

File name : epos-print-x.x.x.xsd

Namespace

The ePOS-Print XML namespaces and namespace identifiers used in this document are shown as follows:

Identifier Namespace

(Default) http://www.epson-pos.com/schemas/2011/03/epos-print

tns http://www.epson-pos.com/schemas/2011/03/epos-print

xs http://www.w3.org/2001/XMLSchema

Chapter 1 Overview

Command Type

The installed functions vary depending on the model. For details, refer to Printer-specific Support Information

(p.135).

Item Description

Common Alignment, Rotation, Line Spacing, Page mode

Character ANK

Character style Font, Smoothing, Double-width, Double-height , Horizontal scale, Vertical scale,

White/Black Reverse, Underline, Emphasized Color, Print position

Paper feed By Unit, By Line

Raster image Mono, Multiple-tone

NV logo Mono, Multiple-tone

Barcode UPC-A, UPC-E, EAN13(JAN13), EAN8(JAN13), CODE39, ITF,CODABAR(NW-7), CODE93,

CODE128, GS1-128, GS1 DataBar

2D-Code PDF417, QR Code, MaxiCode, GS1 DataBar, Aztec Code, DataMatrix

Line 6 types

Paper cut No Feed, Feed Cut, Cut Reservation

Drawer Kick-out Connector, ON Time

Buzzer 7 or 10 Pattern, Repeat

Layout Paper layout setting

Command ESC/POS insertion

Response Print result, Error code, Status

Recovery from an error Recovery from errors that can be recovered from, Buffer clear

Reset Printer reset

Chapter 1 Overview

Provided Article

Package

Manual

❏ ePOS-Print XML User’s Manual (This Document)

❏ Each TM printer Technical Reference Guide

Sample Program

ePOS-Print_Sample_XML_Vx.x.xE.zip

Contains the following:

❏ epos-print-x.x.x.wsdl (ePOS-Print XML Print Service)

❏ epos-print-x.x.x.xsd (ePOS-Print XML schemas)

❏ Sample program (HTML5/ Java/ Windows/ Silverlight/ Flash/Android/ iOS/ Windows CE)

❏ editor/index.html (ePOS-Print Editor

Download

❏ For customers in North America, go to the following web site:

http://www.epson.com/support/

❏ For customers in other countries, go to the following web site:

https://download.epson-biz.com/?service=pos

File name Description

ePOS-Print_Sample_XML_Vx.x.xE.zip This is a sample program file.

ePOS-Print_XML_um_en_revx.pdf This Document.

Chapter 2 Sample Program

Sample Program

This chapter describes the environment settings for using ePOS-Print and how to use the sample program for

printing print data that is created with XML Reference from a printer by using XML Print Service.

Overview

Sample Program Overview

The following screen appears when the sample program starts. Click the [Print] button to execute.

Sample program execution result

A response message from ePOS-Print supported TM printer

In this chapter, descriptions are made mainly based on a HTML5 environment. For an environment other than

the above, read such descriptions in ways that suit the relevant environment.

Print text

Application Environment

Print barcode: EAN13

Paper feed: 24 dots

Paper cut

Chapter 2 Sample Program

Environment

This section describes the following system: the device's HTML 5-supported browser accesses the sample

program uploaded to Web server and then printing is performed. For use in other environments, see

"Environment Settings in Other Execution Environments" on page 29.

The following environments are provided for the sample program:

Environment File Name

HTML5-supported Web browser HtmlApplication1.zip

Java JavaProject1.zip

Windows (Visual Basic .NET) WindowsApplication1.zip

Silverlight SilverlightApplication1.zip, crossdomain.zip

Flash FlexProject1.zip, crossdomain.zip

Android AndroidProject1.zip

iOS iOSDeviceProject1.zip

Windows CE SmartDeviceProject1.zip

Windows Store Apps App1.zip

Chapter 2 Sample Program

Operating Environment

The system configuration diagram for the sample programs is as below.

❏ Web server

(Used for HTML5, Silverlight, and Flash sample programs.)

❏ Wireless LAN Router

❏ ePOS-Print supported TM printer (1 set)

❏ Terminal with an HTML5-supported Web browser

The figure below also describes an example of IP address settings as network settings.

Terminal

[192.168.192.XXX]

Wireless LAN Router

[192.168.192.1]

ePOS-Print supported TM printer

[192.168.192.20]

Wireless

Network

: When DHCP is used for the terminal

Web server

[192.168.192.10]

Chapter 2 Sample Program

Environment Settings

A flow for configuring the environment settings for the sample program is shown as follows:

1. Router Settings

Configure the settings such as SSID, IP address, DHCP, and allocated IP address. For details, refer to the

manual for the device you are using.

2. Network Setting of ePOS-Print Supported printer

Configure the network settings such as the IP address of the TM printer. Configuration is done from a

Web browser. For details, refer to the Technical Reference Guide for the printer.

3. Network settings for the printer to be controlled

Configure the network settings such as the IP address of the printer to be controlled if the network

printer is controlled from the ePOS-Print Supported Printer.

Configure these settings by using the network setting utility. For details, refer to the detailed instruction

manual for the printer (these settings are not required in this sample program).

4. Terminal settings

Configure the wireless LAN (Wi-Fi) settings of the terminal to match the router settings so as to enable

network connection. For details, refer to the manual for the device you are using.

5. ePOS-Print Settings (p.26)

Configure the ePOS-Print for the TM printer with the ePOS-Print available.

Configuration is done from a Web browser.

6. Editing the Sample Program (p.28)

Write the IP address of ePOS-Print supported TM printer in the source code of the sample program using

an editor program.

7. Registering the Sample Program (p.28)

Make registration using a Web browser.

(Required for HTML5, Silverlight, and Flash sample programs.)

Chapter 2 Sample Program

ePOS-Print Settings

ePOS-Print settings must be enabled to control printers via ePOS-Print XML.

The setting method varies depending on the printer model.

TM-T88VI

Make the settings using TM-T88VI Utility.

Refer to TM-T88VI Utility User’s Manual for more information.

TM-H6000V

Make the settings using TM-H6000V Utility.

Refer to TM-H6000V Utility User’s Manual for more information.

Other TM Printers

Follow the procedure below to make the settings.

Connect the TM printer to the network.

Start a Web browser and access the following URL.

http://[Printer IP address]/

Click ePOS-Print, then make the settings as described below.

❏ TM printer equipped with UB-E04 or UB-R04

ePOS-Print settings are unnecessary for TM-DT and TM-i series devices.

 Configure the settings via the network. USB connection cannot be used for setting.

 ePOS-Print settings are enabled by default for the following TM printers.

 TM-m10

 TM-m30

Item Setting

ePOS-Print Set to Enable. (Default: Disabled)

Device ID Align with the system settings. (Default: local_printer)

Printing Method

Set in line with the connected TM printer.

(For details, see "Printer-specific Support Information" (p.135)).

Character Code

Table

Align with the connected TM printer and set the TM printer's code page. (For details, see

"Printer-specific Support Information" (p.135) "ePOS-Print Settings").

Chapter 2 Sample Program

❏ For mobile printer (Wireless LAN Model)

Click [Send].

Turn the TM printer's power off and on again.

Item Setting

ePOS-Print Set to Enable. (Default: Disabled)

Device ID Align with the system settings. (Default: local_printer)

Chapter 2 Sample Program

Editing the Sample Program

Write the IP address of ePOS-Print supported TM printer in the sample program. Edit the program as follows:

Expand HtmlApplication1.zip.

Open index.html using an editor program.

Change the source code portion "// URL of ePOS-Print supported TM printer" in the source file to

the IP address of ePOS-Print supported TM printer and the save the source file.

Registering the Sample Program

Start the Web server.

Copy the sample program into the following folder:

Example: Web server configured by using IIS

System drive:\ Inetpub\wwwroot

// URL of ePOS-Print supported TM printer

var address = 'http://

192.168.192.168

/cgi-bin/epos/

service.cgi?devid=local_printer&timeout=10000

Printers equipped with Web server functionality can be used as Web servers. For details, refer to the Technical

Reference Guide of the printer.

Copy the sample program as a user with administrator authority.

Chapter 2 Sample Program

Environment Settings in Other Execution Environments

This section describes the setting operation in a development environment up to sample program execution.

❏ HTML5 (To Build a Web Server on Windows/Linux) (p. 29)

❏ Java (p. 30)

❏ Windows (Visual Basic .NET) (p. 31)

❏ Silverlight (p. 32)

❏ Flash (p. 33)

❏ Android (p. 34)

❏ Windows CE (p. 36)

❏ iOS (p. 39)

❏ Windows Store Apps (p. 40)

HTML5 (To Build a Web Server on Windows/Linux)

Environment Setting Procedure

Install IIS.

Configure your computer and ePOS-Print supported TM printer so that they can connect to the

network.

Extract the sample program and copy the extracted sample program files into the root folder of

IIS.

System drive : \Inetpub\wwwroot

Open the sample program html file using Visual Studio.

Item Description

Development environment (example) Microsoft Visual Studio 2010

Required item IIS (Internet Information Services) or Apache

Sample program file name HtmlApplication1.zip

Source editing

Edit the IP address of ePOS-Print supported TM printer to suit the network

environment.

Chapter 2 Sample Program

Java

Environment Setting Procedure

Obtain Java SE 6 and install that program.

Configure your computer and ePOS-Print supported TM printer so that they can connect to the

network.

Uncompress the sample program into any folder.

Import the sample program using Eclipse.

Item Description

Development environment (example) Eclipse

Required item Java SE Development Kit 6

Sample program file name JavaProject1.zip

Source editing

Edit the IP address of ePOS-Print supported TM printer to suit the network

environment.

Chapter 2 Sample Program

Windows (Visual Basic .NET)

Environment Setting Procedure

Configure your computer and ePOS-Print supported TM printer so that they can connect to the

network.

Uncompress the sample program into any folder.

Open the sample program solution file using Visual Studio.

Item Description

Development environment (example) Microsoft Visual Studio 2010

Required item -

Sample program file name WindowsApplication1.zip

Source editing

Edit the IP address of ePOS-Print supported TM printer to suit the network

environment.

Chapter 2 Sample Program

Silverlight

Environment Setting Procedure

Download Microsoft Silverlight 4 Tools for Visual Studio 2010(Silverlight4_Tools.exe) and install

that program.

Configure your computer and ePOS-Print supported TM printer so that they can connect to the

network.

Uncompress the sample program into any folder.

Open the sample program solution file using Visual Studio.

Item Description

Development environment (example) Microsoft Visual Studio 2010

Required item Microsoft Silverlight 4 Tools for Visual Studio 2010

Sample program file name SilverlightApplication1.zip, crossdomain.zip

Source editing

Edit the IP address of ePOS-Print supported TM printer to suit the network

environment.

When using by registering the Web server of TM intelligent printer, it is necessary to register cross domain

policy file (crossdomain.zip). For detail information on registration method, refer to Technical Reference

Guide for each printer.

Chapter 2 Sample Program

Flash

Environment Setting Procedure

Download Adobe Flash Builder from Flash Platform.

Configure your computer and ePOS-Print supported TM printer so that they can connect to the

network.

Uncompress the sample program into any folder.

Start Adobe Flash Builder and read the sample program project.

Item Description

Development environment Flash Builder 4.5 or later

Required item Flash Builder 4.5 or later

Sample program file name FlexProject1.zip, crossdomain.zip

Source editing

Edit the IP address of ePOS-Print supported TM printer to suit the network

environment.

When using by registering the Web server of TM intelligent printer, it is necessary to register cross domain

policy file (crossdomain.zip). For detail information on registration method, refer to Technical Reference

Guide for each printer.

Chapter 2 Sample Program

Android

Environment Setting Procedure

Obtain Android SDK and expand it into any folder.

Download Java SE Development Kit 6 and install that program.

Start Android SDK Manager and install the Android 1.5(API3) package.

Start Android AVD Manager and create [Android Virtual Device].

See "Creating Android Virtual Device" on page 34.

Install ADT Plug-in in Eclipse.

See "Installing ADT Plug-in" on page 35

Change the settings of Eclipse.

See "Changing the settings of Eclipse" on page 35

Configure your computer and ePOS-Print supported TM printer so that they can connect to the

network.

Uncompress the sample program into any folder.

Import the sample program using Eclipse.

Creating Android Virtual Device

Start Eclipse.

Select as [Windows]-[Android SDK and AVD Manager].

The "Android SDK and AVD Manager" screen appears. Select the [New] button.

On [Create new Android Virtual Device], type the name. Alternatively, select the device to use

and create a new entry.

Item Description

Development environment Eclipse

Required item  Android SDK 1.5

 Java SE Development Kit 6

 ADT (Android Development Tools) Plug-in for Eclipse

Sample program file name AndroidProject1.zip

Source editing

Edit the IP address of ePOS-Print supported TM printer to suit the network

environment.

Chapter 2 Sample Program

Installing ADT Plug-in

Start Eclipse.

From the menu items, select as [Help]-[Install New Software].

The "Install" screen appears. Click the [Add] button.

Enter values in the [Name] and [Location] fields and click the [OK] button.

Return to the "Install" screen. Tick [Developer Tools] and click the [Next] button.

When the installation process finishes, restart Eclipse.

Changing the settings of Eclipse

Start Eclipse.

Select as [Windows]-[Configuration].

The "Setting" screen appears. Select [Android].

Although a warning dialog box appears, telling you that a path to Android SDK has not been set, there is no problem.

Click the [Browse] button.

Select the [Android - Android SDK] directory and click the [OK] button.

Item Description

Name Enter any name.

Location Enter [https://dl-ssl.google.com/android/eclipse/].

Chapter 2 Sample Program

Windows CE

Environment Setting Procedure

Install Visual Studio 2008 SP1.

Download Windows Embedded Compact 7 and install that program.

Install Virtual PC 2007.

Configure your computer and ePOS-Print supported TM printer so that they can connect to the

network.

Uncompress the sample program into any folder.

Open the sample program solution file using Visual Studio.

Execute the sample program using Visual Studio.

The Device Emulator starts. In the Device Emulator, select as [File]-[Configure...]-[Network].

Item Description

Development environment Microsoft Visual Studio 2008 SP1

Required item  Windows Embedded Compact 7

 Virtual PC 2007

Sample program file name SmartDeviceProject1.zip

Source editing

Edit the IP address of ePOS-Print supported TM printer to suit the network

environment.

Chapter 2 Sample Program

The "Emulator Properties" dialog box appears. Select [Network].

Tick "Enable NE2000 PCMCIA network adapter and bind to:" and select the computer's network

card. Click the [OK] button.

In the Device Emulator, select as [Start]-[Settings].

In the Device Emulator, select as [Settings]-[Connections]-[Network Cards].

Chapter 2 Sample Program

In the Device Emulator, select [The Internet] and then select the same network card as that of

your computer.

Set the IP address and click [OK] at the top right of the screen.

A confirmation dialog box appears. Click [Yes].

Restart the Device Emulator.

Chapter 2 Sample Program

iOS

Environment Setting Procedure

Expand iOSDeviceProject1.zip.

Start XCode and open the [iOSDeviceProject1.xcodeproj] project file.

When the project is opened, the project settings and source files will be displayed.

From the options displayed when [Set Active Executable] is selected, select an iPhone or iPad

file.

Item Description

OS Mac OS X 10.6.8

Development environment Apple Xcode 3.2.6

SDK iOS SDK 4.3

Sample program file name iOSDeviceProject1.zip

Source editing

Edit the IP address of ePOS-Print supported TM printer to suit the network

environment.

Execution The sample program can be checked using iOS Simulator.

Chapter 2 Sample Program

Windows Store Apps

Environment Setting Procedure

Configure your computer and ePOS-Print supported TM printer so that they can connect to the

network.

Uncompress the sample program into any folder.

Open the sample program solution file using Visual Studio.

Item Description

OS Microsoft Visual Studio 2012

Required item Windows 8

Sample program file name App1.zip

Source editing

Edit the IP address of ePOS-Print supported TM printer to suit the network

environment.

Chapter 3 Programming Guide

Programming Guide

This chapter describes how to write programs in the application development using ePOS-Print.

How to Use XML Schemas

The XML document editing support function in the integrated development environment helps efficiently create

XML documents and validate XML documents.

Visual Studio

Setting Procedure

Create a new project.

[File ]-[New]-[Project...]

Add an XML file to the created project. 

[Project]-[Add New Item...]

This section describes specific procedures using Visual Studio (p. 41) and Eclipse (p. 44) as examples.

Chapter 3 Programming Guide

Set the XML schema "epos-print-x.x.x.xsd" to the XML file.

[XML]-[Schemas...]-[Add...]

Editing Example

Enter the character "<" in the XML file. Then, root element candidates appear.

Select "epos-print" from the candidates and enter the character ">". Then, the epos-print root

element is added.

Start a new line and enter the character "<". Then, element candidates appear.

For details on elements, refer to XML Reference (p.64).

Chapter 3 Programming Guide

Select "text" from the candidates and enter an empty space. Then, attribute candidates appear.

Select "lang" from the candidates. Then, attribute value candidates appear.

Select "en" from the candidates and enter the character ">". Then, the text element is added.

Enter a character string to print for the content of the text element.

Chapter 3 Programming Guide

Eclipse

Setting Procedure

Create an XML file and set the location of the schema using URL as follows:

<?xml version="1.0" encoding="UTF-8"?>

<epos-print xmlns:xsi=”http://www.w3.org/2001/XMLschema-instance”



xsi:schemaLocation="http://www.epson-pos.com/schemas/2011/03/epos-print epos-print-

x.x.x.xsd"



xmlns="http://www.epson-pos.com/schemas/2011/03/epos-print">

<text lang='en'>Hello
</text>

</epos-print>

For details on elements, refer to XML Reference (p.64).

Chapter 3 Programming Guide

Executing Print Service

Printing Mode of the TM Printer

The TM printer has two printing modes: standard mode and page mode.

Standard mode

In standard mode, characters are printed line by line. The line feed space is adjusted based on the font size and

the height of images, barcodes, etc. This mode is suitable for the type of printing such as printing receipts that

requires the paper length to change according to the print space.

Page mode

In page mode, you set a print area, lay out data in it, and print the data in a batch operation. Characters, images,

and barcodes are laid out in the print positions (coordinates).

Programming Flow

For the ePOS-Print XML, programming is performed based on the following work flow:

In this chapter, descriptions are made mainly based on a HTML5 environment. For an environment other than

the above, read such descriptions in ways that suit the relevant environment.

1. Print Document Creation (p 46)

❏ To create a text print document: (p 47)

❏ To create a graphic print document: (p 48)

❏ To create a page mode print document: (p 49)

2. Transmission of Print Document (p 50)

3. Reception of Print Result (p 53)

To ensure successful print operation, write a program in such a way that data is sent after checking the

printer status. For the above procedure, refer to Checking the Printer Status (p.56).

Chapter 3 Programming Guide

Print Document Creation

Create a print document using elements in the epos-print root element. For details on elements, refer to XML

Reference (p.64).

Refer to the following program for print document creation.

With the TM-i Series, the maximum size of printing data you can send at a time is indicated in the table below. If

you wish to send larger amounts of data, split it into smaller parts before sending.

These values may change depending on the TM-i firmware version and the printing speed of the printer.

For information about the printing speed, see the Technical Reference Guide for each TM printer.

<!DOCTYPE html>

<html>

<head>

<title>TITLE</title>

function createDocument() {

//Start print document creation.

var request = '<epos-print xmlns="http://www.epson-pos.com/schemas/2011/03/epos-

print">';

//Create a print document

request += '<text lang="en" smooth="true"/>';

request += '<text font="font_a"/>';

request += '<text width="3" height="3">Hello, World!
</text>';

request += '<cut type="feed"/>';

//End print document creation.

request += '</epos-print>';

}

</script>

</head>

<body>

</body>

</html>

TM-i Firmware Version

Print speed

300 mm/s 200 mm/s

Ver.4.0 or earlier 200 KB 133 KB

Ver.4.1 400 KB 267 KB

Ver.4.3 or later 4 MB 2.67 MB

Chapter 3 Programming Guide

To create a text print document:

Create a text print document using the text element in the epos-print root element. Configure the settings for

the text to print using the attributes of the text element.

Refer to the following program for print document creation.

For the string "Hello World!", to create a print document based on the following settings:

❏ Font: FontA

❏ Scale: x 4 (horizontal) and x 4 (vertical)

❏ Style: Bold

Print image

function createDocument() {

//Start print document creation.

var request = '<epos-print xmlns="http://www.epson-pos.com/schemas/2011/03/epos-

print">';

//Create a print document

//<Configure the print character settings>

request += '<text lang="en"/>';

request += '<text smooth="true"/>';

request += '<text font="font_a"/>';

request += '<text width="4" height="4"/>';

request += '<text em="true"/>';

//<Specify the character string to print>

request += '<text>Hello, World!
</text>';

//<Specify the feed cut>

request += '<cut type="feed"/>';

//End print document creation.

request += '</epos-print>';

}

</script>

Chapter 3 Programming Guide

To create a graphic print document:

Create a graphic print document using the image element in the epos-print root element. Set the image size

using an attribute of the image element. For graphics, specify raster graphic bit-image data using a base 64

encoded character string.

Refer to the following program for print document creation.

To create a print document with a checkered flag raster image:

Print image

function createDocument() {

//Start print document creation.

var request = '<epos-print xmlns="http://www.epson-pos.com/schemas/2011/03/epos-

print">';

//Create a print document

//<Specify the raster image>

request += '<image width="8" height="48">8PDw8A8PDw/w8PDwDw8PD/

Dw8PAPDw8P8PDw8A8PDw/w8PDwDw8PD/Dw8PAPDw8P</image>';

//<Specify the feed cut>

request += '<cut type="feed"/>';

//End print document creation.

request += '</epos-print>';

}

</script>

 This section describes how to print a raster image. In addition, there is also a method of printing graphics

registered in the NV memory of the printer. For details, refer to <logo> (p.80).

 For details on how to create raster images, refer to Encoding Graphic Data (p.235).

Chapter 3 Programming Guide

To create a page mode print document:

Create a graphic print document using the image element in the epos-print root element. Set the image size

using an attribute of the image element. For graphics, specify raster graphic bit-image data using a base 64

encoded character string.

Refer to the following program for print document creation.

For the string "Hello World!", to create a print document based on the following settings:

❏ Page mode print area (in dots) Origin of horizontal axis: 100, origin of vertical axis: 50, 

width: 200, height: 100

❏ Page mode print positions (in dots) Horizontal print position: 0, vertical print position: 42

❏ Font: FontA

❏ Scale: x 2 (horizontal) and x 2 (vertical)

❏ Style: Bold

Print image

function createDocument() {

//Start print document creation.

var request = '<epos-print xmlns="http://www.epson-pos.com/schemas/2011/03/epos-

print">';

//Create a print document

//<The page mode starts>

request += '<page>';

//<Specify the page mode print area>

request += '<area x="100" y="50" width="200" height="100"/>';

//<Specify the page mode print position>

request += '<position x="0" y="42"/>';

//<Set print text>

request += '<text lang="en"/>';

request += '<text smooth="true"/>';

request += '<text font="font_a"/>';

request += '<text width="2" height="2"/>';

request += '<text em="true"/>';

//<Specify the character string to print>

request += '<text>Hello,</text>';

request += '<position x="0" y="96"/>';

request += '<text>World!</text>';

//<The page mode ends>

request += '</page>';

//<Specify the feed cut>

request += '<cut type="feed"/>';

//End print document creation.

request += '</epos-print>';

}

</script>

Chapter 3 Programming Guide

Transmission of Print Document

A print document is sent using an ePOS-Print object.

Create an ePOS-Print object using the constructor and specify the end point address for the printer to be used for

printing as well as the print document into the send method to send the document.

For the details about the printer end point address, refer to Printer End Point Address (p.52).

Refer to the following program.

To Call SOAP/HTTP Interface

Refer to the following program.

ePOS-Print supported TM printer checks the status of the TM printer used for printing and then start printing

operation.

<!DOCTYPE html>

<html>

<head>

<title>TITLE</title>

function sendDocument() {

//Create a print document

var request = '<epos-print xmlns="http://www.epson-pos.com/schemas/2011/03/epos-

print">';

request += '<text lang="en" smooth="true"/>';

request += '<text font="font_a"/>';

request += '<text width="3" height="3">Hello, World!
</text>';

request += '<cut type="feed"/>';

request += '</epos-print>';

//Create a SOAP envelop

var soap = '<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">' +

'<s:Body>' + request + '</s:Body></s:Envelope>';

//Create an XMLHttpRequest object

var xhr = new XMLHttpRequest();

//Set the end point address

var url = 'http://192.168.192.168/cgi-bin/epos/

service.cgi?devid=local_printer&timeout=10000';

//Open an XMLHttpRequest object

xhr.open('POST', url, true);

//<Header settings>

xhr.setRequestHeader('Content-Type', 'text/xml; charset=utf-8');

xhr.setRequestHeader('If-Modified-Since', 'Thu, 01 Jan 1970 00:00:00 GMT');

xhr.setRequestHeader('SOAPAction', '""');

// Send print document

xhr.send(soap);

}

</script>

</head>

<body>

</body>

</html>

Chapter 3 Programming Guide

To Call SOAP/HTTP Interface (WSDL supported)

Refer to the following program.

<!DOCTYPE html>

<html>

<head>

<title>TITLE</title>

function sendDocument() {

//Create a print document

var request = '<epos-print xmlns="http://www.epson-pos.com/schemas/2011/03/epos-

print">';

request += '<text lang="en" smooth="true"/>';

request += '<text font="font_a"/>';

request += '<text width="3" height="3">Hello, World!
</text>';

request += '<cut type="feed"/>';

request += '</epos-print>';

//Create a print parameter

var param = '<parameter xmlns="http://www.epson-pos.com/schemas/2011/03/epos-

print">';

param += '<devid>local_printer</devid>';

param += '<timeout>10000</timeout>';

param += '<printjobid>ABC123</printjobid>';

param += '</parameter>';

//Create a SOAP envelop

var soap = '<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">' +

'<s:Header>' + param + '</s:Header><s:Body>' + request +



'</s:Body></s:Envelope>';

//Create an XMLHttpRequest object

var xhr = new XMLHttpRequest();

//Set the end point address

var url = 'http://192.168.192.168/cgi-bin/epos/service.cgi';

//Open an XMLHttpRequest object

xhr.open('POST', url, true);

//<Header settings>

xhr.setRequestHeader('Content-Type', 'text/xml; charset=utf-8');

xhr.setRequestHeader('If-Modified-Since', 'Thu, 01 Jan 1970 00:00:00 GMT');

xhr.setRequestHeader('SOAPAction', '""');

// Send print document

xhr.send(soap);

}

</script>

</head>

<body>

</body>

</html>

Chapter 3 Programming Guide

Printer End Point Address

Specify the printer end point address in the following format:

To Call SOAP/HTTP Interface (p.11)

http://[IP address]/cgi-bin/epos/service.cgi?devid=[device ID]&timeout=[timeout time]

To Call SOAP/HTTP Interface (WSDL supported) (p.11)

http://[IP address]/cgi-bin/epos/service.cgi

Items to specify Description

IP address Specify either the IP address or the domain name of ePOS-Print supported TM printer.

Device ID Specify the Device ID registered using the EPSON TMNet WebConfig(EpsonNet Config) of

ePOS-Print supported TM printer

Timeout period Specifies the time to abort the process in milliseconds. The maximum value is 300 seconds

(300000).

The timeout parameter is optional; when it is omitted, 60 seconds (60000) is set.

When the timeout period elapses, the print job is canceled; the data already interpreted by

the printer before the start of the print abort process is printed.

For SOAP/HTTP Interface (WSDL supported), the device ID and timeout time are specified in the SOAP

header.

Chapter 3 Programming Guide

Reception of Print Result

Set a callback function using the response root element (p. 68) to receive print results.

The following information is obtained:

❏ Print result

❏ Error code

❏ Printer status

❏ Printer's battery status

Refer to the following program. For the details about how to program a callback function in detail, refer to Error

handling (p.55).

The printer status can be obtained when communication with the printer is possible.

<!DOCTYPE html>

<html>

<head>

<title>TITLE</title>

function sendDocument() {

//Create a print document

var request = '<epos-print xmlns="http://www.epson-pos.com/schemas/2011/03/epos-

print">';

request += '<text lang="en" smooth="true"/>';

request += '<text font="font_a"/>';

request += '<text width="3" height="3">Hello, World!
</text>';

request += '<cut type="feed"/>';

request += '</epos-print>';

//Create a SOAP envelop

var soap = '<?xml version="1.0" encoding="utf-8"?>' +



'<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">



<s:Body>' + request + '</s:Body></s:Envelope>';

//Create an XMLHttpRequest object

var xhr = new XMLHttpRequest();

//Set the end point address

var url = 'http://192.168.192.168/cgi-bin/epos/service.cgi?devid



=local_printer&timeout=10000';

//Open an XMLHttpRequest object

xhr.open('POST', url, true);

//<Header settings>

xhr.setRequestHeader('Content-Type', 'text/xml; charset=utf-8');

xhr.setRequestHeader('If-Modified-Since', 'Thu, 01 Jan 1970 00:00:00 GMT');

xhr.setRequestHeader('SOAPAction', '""');

Chapter 3 Programming Guide

//Set a callback function

xhr.onreadystatechange = function () {

if (xhr.readyState == 4) {

if (xhr.status == 200) {

//Obtain the response root element

var res = xhr.responseXML;

var success = res.getElementsByTagName('response')[0].getAttribute('success');

//When the printing is not successful, display a message

if (!/^(1|true)$/.test(success)) {

alert('A print error occurred');

}

// Send print document

xhr.send(soap);

}

</script>

</head>

<body>

</body>

</html>

Chapter 3 Programming Guide

Error handling

Refer to the following program for the error handling method by a callback function.

// Set a response receipt callback function

xhr.onreadystatechange = function () {

// Obtain the print result and error code

var res = xhr.responseXML;

var msg = 'Print' + (res[0].getAttribute('success') ? 'Success' : 'Failure') + '\nCode:' +

res[0].getAttribute('code') + '\nStatus:\n';

// Obtain the printer status

var asb = res[0].getAttribute('status');

if (asb & 0x00000001) {

msg += ' No printer response\n';

}

if (asb & 0x00000002) {

msg += ' Print complete\n';

}

if (asb & 0x00000004) {

msg += ' Status of the drawer kick number 3 connector pin = "H"\n';

}

if (asb & 0x00000008) {

msg += ' Offline status\n';

}

if (asb & 0x00000020) {

msg += ' Cover is open\n';

}

if (asb & 0x00000040) {

msg += ' Paper feed switch is feeding paper\n';

}

if (asb & 0x00000100) {

msg += ' Waiting for online recovery\n';

}

if (asb & 0x00000200) {

msg += ' Panel switch is ON\n';

}

if (asb & 0x00000400) {

msg += ' Mechanical error generated\n';

}

if (asb & 0x00000800) {

msg += ' Auto cutter error generated\n';

}

if (asb & 0x00002000) {

msg += ' Unrecoverable error generated\n';

}

if (asb & 0x00004000) {

msg += ' Auto recovery error generated\n';

}

if (asb & 0x00020000) {

msg += ' No paper in the roll paper near end detector\n';

}

if (asb & 0x00080000) {

msg += ' No paper in the roll paper end detector\n';

}

if (asb & 0x80000000) {

msg += ' Stop the spooler\n';

}

//Display in the dialog box

alert(msg);

}

Chapter 3 Programming Guide

Checking the Printer Status

To check the printer status without printing, send empty print data.

Refer to the following program.

//Set the end point address

var url = 'http://192.168.192.168/cgi-bin/epos/

service.cgi?devid=local_printer&timeout=10000';

//Create an empty print document to check the printer status

var soap = '<?xml version="1.0" encoding="UTF-8"?>



<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/" ><s:Body>



<epos-print xmlns="http://www.epson-pos.com/schemas/2011/03/epos-print"/>



</s:Body></s:Envelope>';

//Create an XMLHttpRequest object

var xhr = new XMLHttpRequest();

//<Open an XMLHttpRequest object>

xhr.open('POST', url, true);

//<Header settings>

xhr.setRequestHeader('Content-Type', 'text/xml; charset=utf-8');

xhr.setRequestHeader('If-Modified-Since', 'Thu, 01 Jan 1970 00:00:00 GMT');

xhr.setRequestHeader('SOAPAction', '""');

//Set a response reception callback function for checking

xhr.onreadystatechange = function () {

if (xhr.readyState == 4){

if (xhr.status == 200){

var res = xhr.responseXML;

var success = res.getElementsByTagName('response')[0].getAttribute('success');

if (!/^(1|true)$/.test(success)) {

alert('Success');

}

};

//Send empty print data

xhr.send(soap);

Chapter 3 Programming Guide

Specifying the Print Job ID from the Application

A response containing the specified print job ID will be returned when sending a request from the application by

specifying the print job ID. (ePOS-Print Service Ver.4.1 or later versions)

Programming Example

Request

Response

<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">

<s:Header>

<devid>local_printer</devid>

</parameter>

</s:Header>

<s:Body>

<epos-print xmlns="http://www.epson-pos.com/schemas/2011/03/epos-print">

<text>Hello, World!
</text>

<cut />

</epos-print>

</s:Body>

</s:Envelope>

<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">

<s:Header>

<devid>local_printer</devid>

</parameter>

</s:Header>

<s:Body>

<response xmlns="http://www.epson-pos.com/schemas/2011/03/epos-print"

success="true" code="" status="252641302" battery="0" />

</s:Body>

</s:Envelope>

Job ID : ABC123

Print data

Job ID : ABC123

Response data

Chapter 3 Programming Guide

Using the Spooler Function

Refer to Printer Functions (p.14) for more information on printers equipped with spoolers.

A printing job will be executed immediately and a response will be returned to the application after printing is

complete when sending a printing request to ePOS-Print Service I/F from the application when the spooler

function is disabled.

The print data job will be added to the queue and a response will be returned to the application without waiting

for printing to complete when sending a printing request to ePOS-Print Service I/F from the application when

the spooler function is enabled.

Even if the output printer cannot complete the printing task, ePOS-Print Service I/F does not return an error to

the application. If print forwarding is enabled, printing from a substitute printer is available.

The application can obtain the print result later by requesting an empty print data with the print job ID specified.

Refer to the sequence diagram below.

ePOS-Print Service I/F Printer

Application

1.2 : Printing results

1.1 : Cmd()

1.3 : Response message()

1.1.1 : Print()

1 : Request message()

4.3 : Response message

(printjobid="ABC123",

Printing result)

ePOS-Print Service I/F Printer Forwarding printer

Application Spooler

1.2 : Execution result

1.1 : send()

2.1 : Print()

2 : Cmd()

Printing results (Failure)

3.1 : Print()

3 : Cmd()

Printing results (Success)

4.2 : Printing result

4.1 : send()

1 : Request message

(Print data,

printjobid="ABC123")

1.3 : Response message

(printjobid="ABC123",

Execution result)

4 : Request message

(Empty print data,

printjobid="ABC123")

Chapter 3 Programming Guide

Programming Example

Printing Process

Request

Response

<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">

<s:Header>

<devid>local_printer</devid>

</parameter>

</s:Header>

<s:Body>

<epos-print xmlns="http://www.epson-pos.com/schemas/2011/03/epos-print">

<text>Hello, World!
</text>

<cut />

</epos-print>

</s:Body>

</s:Envelope>

<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">

<s:Header>

<devid>local_printer</devid>

</parameter>

</s:Header>

<s:Body>

<response xmlns="http://www.epson-pos.com/schemas/2011/03/epos-print"

success="true" code="" status="2" battery="0" />

</s:Body>

</s:Envelope>

 When applications do not specify the print job IDs, the ePOS-Print Service I/F assigns print job IDs.

 As the printing process has not been performed at this time, success will be set to "true," code to "" (left

empty), status to 0x00000002 or 0x80000000 and battery to "0".

Chapter 3 Programming Guide

Acquiring the Print Job Status

Request

Response

<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">

<s:Header>

</parameter>

</s:Header>

<s:Body>

<epos-print xmlns="http://www.epson-pos.com/schemas/2011/03/epos-print" />

</s:Body>

</s:Envelope>

Empty print data is sent when requesting the acquisition of the print job status.

As such, child elements of the <epos-print> element are not specified.

<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">

<s:Header>

</parameter>

</s:Header>

<s:Body>

<response xmlns="http://www.epson-pos.com/schemas/2011/03/epos-print"

success="true" code="" status="252641302" battery="0" />

</s:Body>

</s:Envelope>

Chapter 3 Programming Guide

How to Use WSDL

This section describes how to generate client codes (proxy class) from WSDL by using the tool provided in the

development environment.

.NET Framework

Procedure

From the command prompt, execute Svcutil.exe and create the following files:

❏ ePOSPrint.cs (WCF contract)

❏ output.config (application configuration file)

Start Visual Studio and create a new project.

(Project example: console application)

Add a class file to the project.

(File to be added: ePOSPrint.cs)

Add a reference to the project.

(Assembly to be added: System.ServiceModel)

Edit the application configuration file.

(File to be edited: App.config)

❏ Open output.config and copy the <system.serviceModel> element.

❏ Change the end point address in accordance with the printer.

This section uses the following cases as examples:

 .NET Framework (p.61)

 Java (p.63)

Item Description

Tool ServiceModel Metadata Utility Tool (Svcutil.exe)

Command svcutil.exe epos-print-x.x.x.wsdl epos-print-x.x.x.xsd

For details about the Svcutil.exe tool, refer to the following Web site (as of September, 2015):

https://msdn.microsoft.com/en-us/library/aa347733.aspx

Chapter 3 Programming Guide

Create and execute a program to call XML Print Service.

Editing example (File to be edited: Program.cs)

namespace ConsoleApplication1

{

class Program

{

static void Main(string[] args)

{

ePOSPrintPortTypeClient client = new ePOSPrintPortTypeClient();

parameter param = new parameter();

param.printjobid = "ABC123";

param.devid = "local_printer";

param.timeout = "60000";

eposprint epos = new eposprint();

text t = new text();

t.align = align.center;

t.alignSpecified = true;

t.dh = true;

t.dhSpecified = true;

t.Value = "Hello, World!\n";

cut c = new cut();

c.type = cuttype.feed;

epos.Items = new object[] { t, c };

response res = client.send(ref param, epos);

Console.WriteLine(res.success);

Console.WriteLine(res.code);

Console.WriteLine(res.status);

Console.WriteLine(res.battery);

Console.ReadLine();

}

Chapter 3 Programming Guide

Java

Item Description

Tool JAX-WS wsimport tool

Command > wsimport epos-print-x.x.x.wsdl

For details about the JAX-WS wsimport tool, refer to following Web site (as of September, 2015):

http://docs.oracle.com/javase/8/docs/technotes/tools/windows/wsimport.html

Chapter 4 XML Reference

XML Reference

This chapter describes available commands of ePOS-Print XML.

ePOS-Print XML

ePOS-Print XML offers the following commands (elements).

Available elements and parameters vary by printer model. Refer to XML Supported Printers.

XML for Controlling Printer

Route element Element Function Standard mode Page mode

<epos-print>

<text> Prints a text ✔✔

<feed> Feeds paper ✔✔

<image> Prints a raster image ✔✔

<logo> Prints an NV logo ✔✔

<barcode> Prints a barcode ✔✔

<symbol> Prints a 2D symbol ✔✔

<hline> Prints a horizontal line ✔ -

<vline-begin> Starts to print a vertical line ✔ -

<vline-end> Finishes to print a vertical line ✔ -

<page> Page mode ✔ -

<area> Specifies a print area for the page mode - ✔

Specifies the printing direction for the page

mode

- ✔

Specifies a position to start printing for the

page mode

- ✔

<line> Prints a line in the page mode - ✔

<rectangle> Prints a rectangle in the page mode - ✔

<cut> Cuts paper ✔ -

<pulse> Drawer kick-out ✔ -

<sound> Sounds a buzzer ✔ -

<command> Inserts a command ✔✔

<layout> Paper settings ✔ -

<recovery> Recovers from an error ✔ -

<reset> Resets the printer ✔ -

<response> Acquires the execution result. ✔✔

Chapter 4 XML Reference

The table below shows the default for each of the elements.

The default is a factory default configured on the printer.

Element Attribute Default value

<text>

lang "en"

font "font_a"

smooth "false" / "0"

dw "false" / "0"

dh "false" / "0"

width "1"

height "1"

reverse "false" / "0"

ul "false" / "0"

em "false" / "0"

color "color_1"

x"0"

y "21"

align "left"

rotate "false" / "0"

linespc

The value differs by printer model.

For details, refer to Printer-specific Support Information.

<feed> linespc

<image>

color "color_1"

align "left"

mode "mono"

<logo> align "left"

hri "none"

font "font_a"

width "3"

height "162"

align "left"

rotate "false" / "0"

Chapter 4 XML Reference

XML for Controlling Customer Display

level

The value differs by type of 2D symbol.

For details, refer to <symbol>.

width

hight

size

align "left"

rotate "false" / "0"

<area>

x"0"

y"0"

width

The value differs by printer model.

For details, refer to Printer-specific Support Information..

height

<direction> dir "left_to_right"

x"0"

y "21"

Route element Element Function

<epos-display>

<window> Window settings

<text> Displays text

<cursor> Displays a cursor

<blink> Sets the display to blink

<brightness> Sets the brightness of the customer display

<marquee> Marquee display settings for text strings

<clock> Time display settings

<clear> Exits the display of the current window

<reset> Resets the display of the customer display

<command> Runs an ESC/POS command

<response> Acquires the execution result.

Element Attribute Default value

Chapter 4 XML Reference

XML for Controlling Printer

<epos-print>

This is an XML document that is sent from an application to a printer.

It requests the printer to execute the specified function. The <epos-print> provides all elements necessary to

control a printer.

Attribute

force

Enters in a forced transmission mode.

In the forced transmission mode, print commands are forcibly transmitted to the printer.

Sample program

❏ Blank print document

❏ Kicks the drawer out while the printer is in an offline status (paper end)

Supplementary explanation

❏ Use the forced transmission mode while the printer is offline. 

Sending it while the printer is online will result in an error.

❏ For TM-H6000V, you need to enable the Command execution during offline settings.

Refer to TM-H6000V Utility User's Manual for details.

❏ The following functions are available in the forced transmission mode:

Attribute value Description

"true" / "1" Enters in the forced transmission mode

"false" / "0" Enters in a normal transmission mode

<epos-print xmlns="http://www.epson-pos.com/schemas/2011/03/epos-print" />

<epos-print xmlns= "http://www.epson-pos.com/schemas/2011/03/epos-print"

force="true">

</epos-print>

Function Element

Opens a cash drawer <pulse>

Stops a buzzer <sound>

Recovers from a recoverable error <recovery>

Reset <reset>

Sends a real time command <command>

Chapter 4 XML Reference

This is an XML document that is sent back from a printer to an application.

Attribute

success

code

Attribute Description

success Print result

code Error code

status Status

battery Battery status

Attribute value Description

"true" / "1"

 Print succeeded

 Process succeeded (when the spooler function is enabled)

"false" / "0"

 Failed to print

 Process failed (when the spooler function is enabled)

Attribute value Description

"EPTR_AUTOMATICAL" Automatic recovery error occurred

"EPTR_BATTERY_LOW" Battery has run out

"EPTR_COVER_OPEN" Cover open error occurred

"EPTR_CUTTER" Auto cutter error occurred

"EPTR_MECHANICAL" Mechanical error occurred

"EPTR_REC_EMPTY" No paper is left in the roll paper end detector

"EPTR_UNRECOVERABLE" Unrecoverable error occurred

"SchemaError" Error exists in the requested document syntax

"DeviceNotFound" Printer specified by the device ID does not exist

"PrintSystemError" Error occurred with the printing system

"EX_BADPORT" An error occurred with the communication port

"EX_TIMEOUT" Print timeout occurred

"EX_SPOOLER" Print queue is full

"JobNotFound" Specified job ID does not exist

"Printing" Printing in progress

Chapter 4 XML Reference

status

One or more of the following values that represent the printer status are combined using bitwise OR opera-

tor, and expressed in decimal notation.

battery

One or more of the following values that represent the battery status are combined using bitwise OR oper-

ator, and expressed in decimal notation.

❏ AC adapter connection status

"JobSpooling" Job is spooling.

"TooManyRequests"

The number of print jobs sent to the printer has exceeded the allow-

able limit.

"RequestEntityTooLarge" The size of the print job data exceeds the capacity of the printer.

Attribute value Description

"0x00000001" No response from TM printer

"0x00000002" Printing completed

"0x00000004"

 Drawer kick connector pin No.3 status = "H"

 Offline status due to the battery level

"0x00000008" Offline status

"0x00000020" Cover is open

"0x00000040" Paper is being fed by the paper feed switch

"0x00000200" Paper feed switch is held depressed

"0x00000400" Mechanical error occurred

"0x00000800" Auto cutter error occurred

"0x00002000" Unrecoverable error occurred

"0x00004000" Automatic recovery error occurred

"0x00010000" Waiting for insertion of a slip sheet for slip printing

"0x00020000" Roll paper has almost run out

"0x00040000" Waiting for ejection of a slip sheet for slip printing

"0x00080000" Roll paper has run out

"0x01000000" Buzzer is sounding (supported model only)

"0x01000000" Waiting for labels to be removed (supported model only)

"0x04000000"

No paper is detected with the label peeler sensor (supported model

only)

"0x80000000" Spooler stopped

Attribute value Description

Chapter 4 XML Reference

❏ Remaining battery capacity

Sample program

❏ When the printer runs out of paper during printing and failed to print

❏ When the printer runs out of battery during printing and failed to print

Supplementary explanation

❏ Timing of the printer response differs by printer status.

❏ For a model without battery, 0xXX30 is set to the battery constant.

Attribute value Description

"0x30XX" AC adapter is connected

"0x31XX" AC adapter is not connected

Attribute value Description

"0xXX36" Remaining battery capacity 6

"0xXX35" Remaining battery capacity 5

"0xXX34" Remaining battery capacity 4

"0xXX33" Remaining battery capacity 3

"0xXX32" Remaining battery capacity 2

"0xXX31" Remaining battery capacity 1 (almost run out)

"0xXX30" Remaining battery capacity 0 (run out)

<response xmlns="http://www.epson-pos.com/schemas/2011/03/epos-print"

success="false" code="EPTR_REC_EMPTY" status="252641308" battery="0" />

<response xmlns="http://www.epson-pos.com/schemas/2011/03/epos-print"

success="false" code="EPTR_BATTERY_LOW" status="251658268" battery="12592" />

Printer status Description

The power is on The timing set on the printer

The power is off The timing when a client timeout occurs

Printing: an error occurs Before printing

Printing: print succeeded After printing completed

Chapter 4 XML Reference

<text>

This element allows you to specify text string to print and print settings such as character style, print position,

line spacing.

Attribute

lang

Depending on the specified language, some characters are printed as follows:

font

Attribute value Description

"en" English (ANK specification)

"de" German (ANK specification)

"fr" French (ANK specification)

"it" Italian (ANK specification)

"es" Spanish (ANK specification)

"ja"

Japanese (International character set is also changed to Japanese.)

"ja-jp"

"ko"

Korean (International character set is also changed to Korean.)

"ko-kr"

"zh-hans"

Simplified Chinese (International character set is also changed to Chi-

nese.)

"zh-cn"

"zh-hant"

Traditional Chinese

"zh-tw"

Language code other than above English (ANK specification)

Language Characters $(U+0024) Characters \(U+005C)

Japanese $ ¥

Korean $

￦

Simplified Chinese ¥ \

Traditional Chinese $ \

Attribute value Description

"font_a" Font A

"font_b" Font B

"font_c" Font C

Chapter 4 XML Reference

smooth

width

height

reverse

"font_d" Font D

"font_e" Font E

Attribute value Description

"true" / "1" Enables smoothing.

"false" / "0" Disables smoothing.

Attribute value Description

"true" / "1" Enables double width size.

"false" / "0" Disables double width size.

Attribute value Description

"true" / "1" Enables double height size.

"false" / "0" Disables double height size.

Attribute value Description

"1" to "8" Specifies the horizontal scaling factor rate.

Attribute value Description

"1" to "8" Specifies the vertical scaling factor rate.

Attribute value Description

"true" / "1" Inverts black and white

"false" / "0" Cancels the black and white inversion

Attribute value Description

"true" / "1" Enables the underscore style.

"false" / "0" Disables the underscore style.

Attribute value Description

Chapter 4 XML Reference

color

align

rotate

linespc

Attribute value Description

"true" / "1" Enables emphasized style.

"false" / "0" Disables emphasized style.

Attribute value Description

"none" No printing

"color_1" First color

"color_2" Second color

"color_3" Third color

"color_4" Fourth color

Attribute value Description

"0" to "65535" Specifies the horizontal print start position in units of dots.

Attribute value Description

"0" to "65535" Specify the vertical print start position in units of dots.

Attribute value Description

"left" Left alignment

"center" Center alignment

"right" Right alignment

Attribute value Description

"true" / "1" Enables text rotation.

"false" / "0" Disables text rotation.

Attribute value Description

"0" to "255" Specifies paper feed amount per line in units of dots.

Chapter 4 XML Reference

Sample program

When printing a text string with the following settings

Example of language setting

❏ Korean

❏ Simplified Chinese

❏ Traditional Chinese

Supplementary explanation

❏ To print data other than text after printing text, start a new line or feed paper.

❏ In the page mode, text is printed from the current print position with the base line dot of the characters

as the standard. For information on the base line dot, refer to Printer-specific Support Information.

❏ For the character codes available for printing, refer to the Technical Reference Guide of the printer.

❏ Shift JIS code characters can be printed when Japanese is specified as "font".

❏ If "dw" and "width" are set in a single element, the "width" setting is applied.

❏ If "dh" and "length" are set in a single element, the "height" setting is applied.

Item Value

Language Japanese

Smoothing Enabled

Alignment Center alignment

Font Font B

Double size

Double height and

width size

Underscore Enabled

<epos-print xmlns="http://www.epson-pos.com/schemas/2011/03/epos-print">

<text>Hello, World!
</text>

</epos-print>

<epos-print xmlns="http://www.epson-pos.com/schemas/2011/03/epos-print">

</epos-print>

<epos-print xmlns="http://www.epson-pos.com/schemas/2011/03/epos-print">

</epos-print>

<epos-print xmlns="http://www.epson-pos.com/schemas/2011/03/epos-print">

</epos-print>

Chapter 4 XML Reference

❏ Use "y" in the page mode.

❏ The "align" and "rotate" cannot be applied in the page mode.

❏ To rotate text string in the page mode, use <direction>.

❏ When setting "align" or "rotate", set it at the beginning of a line.

❏ When setting "color" for TM-U220 printer, set it at the beginning of a line.

❏ The "align" setting specified in this element is also applied to <image>, <logo>, <barcode>, and <sym-

bol>.

❏ The "rotate" setting specified in this element is also applied to <barcode> and <symbol>.

Chapter 4 XML Reference

<feed>

This element allows you to specify paper feed amount in dots or by the number of lines, line spacing, and paper

position after printing a line.

If you do not specify the paper feed amount, paper is advanced one line.

Attribute

unit

line

linespc

pos

Sample program

❏ Advances paper three lines

❏ Inserts a line break after printing text string

❏ Prints labels peeling them one by one from the sheet

Attribute value Description

"0" to "255" Specifies paper feed amount in units of dots

Attribute value Description

"0" to "255" Specifies paper feed amount in lines

Attribute value Description

"0" to "255" Specifies paper feed amount per line in units of dots

Attribute value Description

"peeling" Feed the sheet to the peeling position

"cutting" Feed the sheet to the cut position

"current_tof" Feed the sheet to the top of the current label

"next_tof" Feed the sheet to the top of the next label

<epos-print xmlns="http://www.epson-pos.com/schemas/2011/03/epos-print">

</epos-print>

<epos-print xmlns="http://www.epson-pos.com/schemas/2011/03/epos-print">

<text>Hello</text><feed />

<text>World</text><feed />

</epos-print>

Chapter 4 XML Reference

❏ Prints multiple labels continuously

❏ Prints a ticket on a black mark paper

Supplementary explanation

❏ When setting <feed> for label sheet or black mark sheet, set it in the standard mode.

❏ The "pos" setting is ignored in the page mode.

❏ When "30" dots is specified in "linespc", up to 240 lines can be specified in "line".

❏ The line spacing setting is stored for each of the standard mode and the page mode. The "linespc" set-

ting specified in this element affects the linespc setting of <text> and <feed>, which may follow.

❏ If the line spacing for a single line is set smaller than the print character size, paper may be fed for a larger

quantity than the set amount to ensure proper printing.

<epos-print xmlns="http://www.epson-pos.com/schemas/2011/03/epos-print">

</epos-print>

<epos-print xmlns="http://www.epson-pos.com/schemas/2011/03/epos-print">

</epos-print>

<epos-print xmlns="http://www.epson-pos.com/schemas/2011/03/epos-print">

</epos-print>

Chapter 4 XML Reference

<image>

This element allows you to specify a raster image. (data type xs: base64Binary)

Raster images are composed of pixels arranged in a grid formation. The top left corner is the origin.

Two colors (black and white) uses 1 bit per pixel, and 16 colors uses 4 bits per pixel. The bits are arranged from

the highest bit of each byte. Zero padding is needed so that each line of the image is expressed in byte units.

Attribute

width

height

color

align

mode

 "width" and "height" must be specified.

 If "color" and "mode" are not specified, the values shown below are set.

 color: color_1

 mode: mono

Attribute value Description

"0" to "655635" Specifies the image width in units of dots

Attribute value Description

"0" to "655635" Specifies the image height in units of dots

Attribute value Description

"none" No printing

"color_1" First color

"color_2" Second color

"color_3" Third color

"color_4" Fourth color

Attribute value Description

"left" Left alignment

"center" Center alignment

"right" Right alignment

Attribute value Description

"mono" Black and white (2 colors)

Chapter 4 XML Reference

Sample program

Prints a 8 dots width and 8dots height raster image that is filled with solid color.

Supplementary explanation

❏ Grayscale printing is allowed in the standard mode, not allowed in the page mode.

❏ We cannot guarantee the accuracy of reading a barcode or 2D symbol printed in grayscale. Print it in

black and white.

❏ In order to print a raster image at a high speed, set "align" to "left" and set "width" to a multiple of 8

which does not exceed the sheet width of the printer.

❏ In the page mode, set the print position of the image so that the image does not extend beyond the

print area.

❏ If you set to print a raster image in grayscale, the amount of data of the image increases and may be

printed intermittently, which causes white streaks on printout.

❏ In the page mode, the bottom left corner of the raster image is aligned with the start position for print-

ing the image. The print start position is not automatically moved.

❏ Create a raster image using the ePOS-Print XML generation tool or your application. When using your

application, follow the instruction below for 2 colors image or 16 colors image, whichever you want to

create.

❏ The "align" setting is ignored in the page mode.

❏ When setting "align" in the standard mode, set it at the beginning of a line.

❏ The "align" setting specified in this element is also applied to <text>, <logo>, <barcode>, and <symbol>.

"gray16" Grayscale (16-step)

<epos-print xmlns="http://www.epson-pos.com/schemas/2011/03/epos-print">

</epos-print>

Attribute value Description

Black and white

Set the image width to a multiple of 8, or pad the lacked bits with

zeros.

16-step grayscale

Set the image width to a multiple of 2, or pad the lacked bits with

zeros.

Attribute value Description

Chapter 4 XML Reference

<logo>

This element allows you to print an NV logo registered in the NV memory of the printer.

The NV logo needs to be registered to the printer in advance. For how to register the NV logo, refer to the

Technical Reference Guide of the printer.

Attribute

key1

key2

align

Sample program

Prints an NV logo whose key code 1 and 2 are stored in 48.

Supplementary explanation

❏ Grayscale printing is allowed in the standard mode, not allowed in the page mode.

❏ In the page mode, the bottom left corner of the logo is aligned with the start position for printing the

logo.

❏ The "align" setting is ignored in the page mode.

❏ When setting "align" in the standard mode, set it at the beginning of a line.

❏ The "align" setting specified in this element is also applied to <text>, <logo>, <barcode>, and <symbol>.

"key1" and "key2" must be specified.

Attribute value Description

"0" to "255" Specifies the key code 1 of the NV logo

Attribute value Description

"0" to "255" Specifies the key code 2 of the NV logo

Attribute value Description

"left" Left alignment

"center" Center alignment

"right" Right alignment

<epos-print xmlns="http://www.epson-pos.com/schemas/2011/03/epos-print">

</epos-print>

Chapter 4 XML Reference

Specifies barcode data as a text string.

Barcode type

Type Description

UPC-A

If an 11-digit figure is specified, the check digit is automatically appended.

If a 12-digit figure is specified, the 12th digit is used as the check digit but verification is

not performed.

UPC-E

Specify 0 in the first digit.

Specify the manufacturer code in the 2nd to 6th digits.

Specify the item code in right justification in the 7th to 11th digits. The number of digits

of the item code depends on the manufacturer code. Specify 0 in each unused data.

If an 11-digit figure is specified, the check digit is automatically appended.

If a 12-digit figure is specified, the 12th digit is used as the check digit but verification is

not performed.

EAN13 If an 12-digit figure is specified, the check digit is automatically appended.

If a 13-digit figure is specified, the 13th digit is used as the check digit but verification is

not performed.

JAN13

EAN8 If an 7-digit figure is specified, the check digit is automatically appended.

If an 8-digit figure is specified, the 8th digit is used as the check digit but verification is

not performed.

JAN8

CODE39

If the first character is * , this character is processed as the start character. Otherwise, the

start character is automatically added.

ITF

The start and stop codes are automatically added.

Addition and verification of the check digit are not performed.

CODABAR

Specify the start character ((A to D, a to d).

Specify the stop character ((A to D, a to d).

Addition and verification of the check digit are not performed.

CODE93

The start and stop characters are automatically added.

The check digit is automatically calculated and added.

Chapter 4 XML Reference

When specifying binary data which cannot be represented as a text string, use the following escape

sequences.

CODE128

Specify the start character (CODE A, CODE B, CODE C).

The stop character is automatically added.

The check digit is automatically calculated and added.

To encode the following characters, specify the corresponding 2-digit code starting with {

FNC1: {1

FNC2: {2

FNC3: {3

FNC4: {4

CODE A: {A

CODE B: {B

CODE C: {C

SHIFT: {S

{: {{

GS1-128

The start character, FNC1, check digit, and stop characters are automatically added.

To automatically calculate and add the application ID (AI) and the following check digit,

specify "*" at the check digit position.

The application ID (AI) can be put in parentheses. The parentheses are used as print char-

acters for HRI and not encoded as data.

A blank space can be inserted between the application ID (AI) and data. The blank space

is used as print characters for HRI and not encoded as data.

To encode the following characters, specify the corresponding 2-digit code starting with {

FNC1{1

FNC3{3

({(

){)

*{*

{{{

GS1 DataBar 

Omnidirectional,

Specify a 13-digit product ID (GTIN) excluding the application ID (AI) and check digit.

GS1 DataBar Truncated

GS1 DataBar Limited

GS1 DataBar Expanded

The application ID (AI) can be put in parentheses. The parentheses are used as print char-

acters for HRI and not encoded as data.

To encode the following characters, specify the corresponding 2-digit code starting with {

FNC1: {1

(: {(

): {)

Type Description

Chapter 4 XML Reference

Attribute

type

hri

Text string Description

\xnn Control code

\\ Back slash

"type" must be specified.

Attribute value Description

"upc_a" UPC-A

"upc_e" UPC-E

"ean13" EAN13

"jan13" JAN13

"ean8" EAN8

"jan8" JAN8

"code39" CODE39

"itf" ITF

"codabar" CODABAR

"code93" CODE93

"code128" CODE128

"gs1_128" GS1-128

"gs1_databar_omnidirectional" GS1 DataBar Omnidirectional

"gs1_databar_truncated" GS1 DataBar Truncated

"gs1_databar_limited" GS1 DataBar Limited

"gs1_databar_expanded" GS1 Databar Expanded

Attribute value Description

"none" No printing.

"above" Above the barcode

"below" Below the barcode

"both" Both above and below the barcode

Chapter 4 XML Reference

font

width

height

align

rotate

Sample program

Prints multiple types of barcode

Attribute value Description

"font_a" Font A

"font_b" Font B

"font_c" Font C

"font_d" Font D

"font_e" Font E

Attribute value Description

"2" to "6" Specifies the width of a single module in units of dots

Attribute value Description

"1" to "255" Specifies the height of a single module in units of dots

Attribute value Description

"left" Left alignment

"center" Center alignment

"right" Right alignment

Attribute value Description

"true" / "1" Enables text rotation

"false" / "0" Disables text rotation

Chapter 4 XML Reference

Supplementary explanation

❏ In the page mode, the bottom left corner of the barcode (except HRI) is aligned with the start position for

printing the barcode.

❏ If your barcode settings are not compliant with the barcode standards, or if the size is larger than the

print area, the barcode is not printed with no error returned.

❏ When setting "align" or "rotate" in the standard mode, set it at the beginning of a line.

❏ The "align" and "rotate" settings are ignored in the page mode.

❏ To rotate text string in the page mode, use <direction>.

❏ The "align" setting specified in this element is also applied to <text>, <image>, <logo>, and <symbol>.

❏ The "rotate" setting specified in this element is also applied to <text> and <symbol>.

epos-print xmlns="http://www.epson-pos.com/schemas/2011/03/epos-print">

<barcode type="code39">ABCDE</barcode>

<barcode type="code93">ABCDE</barcode>

<barcode type="code128">{Babcde</barcode>

</epos-print>

Chapter 4 XML Reference

This element allows you to specify a 2D symbol using a text string.

2D symbol type

Type Description

PDF417

Converts the string into UTF-8, processes the escape sequence(s), and encodes the data.

The maximum number of code words in the data area is 928, the maximum number of

code words in a single stage is 30, and the maximum number of stages is 90.

QR Code Converts the string into JIS, processes the escape sequence(s), and encodes the data by

choosing the data type from the following:

Numeric data: 0 to 9

Alphanumeric data: 0 to 9, A to Z, space, $, %, *, +, -, ., /, :

Kanji character: Shift JIS code

8-bit byte data: 0X00 to 0xff

Micro QR Code

MaxiCode

Converts the string into UTF-8, processes the escape sequence(s), and encodes the data.

In Mode 2 or 3, if the first data is [)>\x1e01\x1dyy ("yy" is a 2-digit figure), this is processed

as the message header and the second and succeeding data sequence is processed as

the primary message. Otherwise, the primary message starts with the first data.

Specify the primary message in the following format.

 For Mode 2

Postal code: (1- to 9-digit number)

GS: (\x1d)

ISO country code: (1- to 3-digit number)

GS: (\x1d)

Service class code (1- to 3-digit number)

 For Mode 3

Postal code: (data which can be converted with 1 to 6 code sets A)

GS: (\x1d)

ISO country code: (1- to 3-digit number)

GS: (\x1d)

Service class code (1- to 3-digit number)

GS1 DataBar Stacked

Converts the string into UTF-8, processes the escape sequence(s), and encodes the data.

Specify a 13-digit product ID (GTIN) excluding the application ID (AI) and check digit.

GS1 DataBar Stacked

Omnidirectional

GS1 DataBar Expanded

Stacked

Converts the string into UTF-8, processes the escape sequence(s), and encodes the data.

The application ID (AI) can be put in parentheses. The parentheses are used as print char-

acters for HRI and not encoded as data.

To encode the following characters, specify the corresponding 2-digit code starting with {

FNC1: {1

(: {(

): {)

Chapter 4 XML Reference

When specifying binary data which cannot be represented as a text string, use the following escape

sequences.

Attribute

type

Aztec Code Converts the string into UTF-8, processes the escape sequence(s), and encodes the data.

DataMatrix Converts the string into UTF-8, processes the escape sequence(s), and encodes the data.

Text string Description

\xnn Control code

\\ Back slash

"type" must be specified.

Attribute value Type

"pdf417_standard" Standard PDF417

"pdf417_truncated" Truncated PDF417

"qrcode_model_1" QR Code Model 1

"qrcode_model_2" QR Code Model 2

"qrcode_micro" Micro QR Code

"maxicode_mode_2" MaxiCode Mode 2

"maxicode_mode_3" MaxiCode Mode 3

"maxicode_mode_4" MaxiCode Mode 4

"maxicode_mode_5" MaxiCode Mode 5

"maxicode_mode_6" MaxiCode Mode 6

"gs1_databar_stacked" GS1 DataBar Stacked

"gs1_databar_stacked_omnidirectional" GS1 DataBar Stacked Omnidirectional

"gs1_databar_expanded_stacked" GS1 DataBar Expanded Stacked

"azteccode_fullrange" Aztec Code Full-Range mode

"azteccode_compact" Aztec Code Compact mode

"datamatrix_square" DataMatrix ECC200 Square

"datamatrix_rectangle_8" DataMatrix ECC200 Rectangle, 8 lines

"datamatrix_rectangle_12" DataMatrix ECC200 Rectangle, 12 lines

Type Description

Chapter 4 XML Reference

level

❏ PDF417

❏ QR Code

❏ Aztec Code

width

"datamatrix_rectangle_16" DataMatrix ECC200 Rectangle, 16 lines

Attribute value Description

"level_0" Error correction level 0

"level_1" (default value) Error correction level 1

"level_2" Error correction level 2

"level_3" Error correction level 3

"level_4" Error correction level 4

"level_5" Error correction level 5

"level_6" Error correction level 6

"level_7" Error correction level 7

"level_8" Error correction level 8

"default" Default value (error correction level 1)

Attribute value Description

"level_l" Error correction level L

"level_m" Error correction level M

"level_q" Error correction level Q

"level_h" Error correction level H

"default" Default value (error correction level M)

Attribute value Description

Integer (5 to 95) Error correction level

"default" Default value (error correction level 23)

2D symbol type Valid value Default value

PDF417 "2" to "8" "3"

QR Code "3" to "16" "3"

MaxiCode Ignored

Attribute value Type

Chapter 4 XML Reference

height

size

align

rotate

2D GS1 DataBar "2" to "8" "2"

Aztec Code "2" to "16" "3"

DataMatrix "2" to "16" "3"

2D symbol type Valid value Default value

PDF417

"2" to "8" (Scaling factor for

width)

"3"

QR Code

Ignored

MaxiCode

2D GS1 DataBar

Aztec Code

DataMatrix

2D symbol type

Default

value

Description

PDF417 "0" (auto) Specifies the number of code words per stage.

QR Code

Ignored

MaxiCode

2D GS1 DataBar

Expanded Stacked "0" (auto)

Specifies the maximum width of the 2D symbol (106

or more).

Other Ignored

Aztec Code Ignored

DataMatrix Ignored

Attribute value Description

"left" Left alignment

"center" Center alignment

"right" Right alignment

Attribute value Description

"true" / "1" Enables text rotation.

2D symbol type Valid value Default value

Chapter 4 XML Reference

Sample program

Prints multiple types of 2D symbols

Supplementary explanation

❏ If your 2D symbol settings are not compliant with the 2D symbol standards, or if the size is larger than

the print area, the symbol is not printed with no error returned.

❏ In the standard mode, a 2D symbol whose height exceeds 831 dots cannot be printed.

❏ In the page mode, the bottom left corner of the 2D symbol is aligned with the start position for printing

the symbol.

❏ Micro QR Code does not support "level_h".

❏ Specify the "level" that matches the type of the 2D symbol you specified.

❏ Set "default" to "level" if the 2D symbol type is MaxiCode or 2D GS1 DataBar.

❏ When setting "align" or "rotate" in the standard mode, set it at the beginning of a line.

❏ The "align" and "rotate" settings are ignored in the page mode.

❏ To rotate text string in the page mode, use <direction>.

❏ The "align" setting specified in this element is also applied to <text>, <image>, <logo>, and <barcode>.

❏ The "rotate" setting specified in this element is also applied to <text> and <barcode>.

"false" / "0" Disables text rotation.

<epos-print xmlns="http://www.epson-pos.com/schemas/2011/03/epos-print">

<symbol type="pdf417_standard">ABCDE</symbol>

<symbol type="qrcode_model_2" level="level_q">ABCDE</symbol>

<symbol type="azteccode_fullrange" level="23">ABCDE</symbol>

<symbol type="datamatrix_square">ABCDE</symbol>

</epos-print>

Attribute value Description

Chapter 4 XML Reference

<hline>

This element allows you to print a horizontal line.

Attribute

style

Sample program

Prints a double line from the 100th dot to the 200th dot, and prints another double line below from the

400th dot to the 500th dot.

Supplementary explanation

This does not work in the page mode.

 "x1" and "x2" must be specified.

 When "style" is not specified, "thin" is applied.

Attribute value Description

"0" to "65535"

Specifies the position to start drawing a horizontal ruled line in units

of dots.

Attribute value Description

"0" to "65535"

Specifies the position to finish drawing a horizontal ruled line in units

of dots.

Attribute value Description

"thin" Solid line: Fine

"medium" Solid line: Middle

"thick" Solid line: Thick

"thin_double" Double line: Fine

"medium_double" Double line: Middle

"thick_double" Double line: Thick

<epos-print xmlns="http://www.epson-pos.com/schemas/2011/03/epos-print">

</epos-print>

Chapter 4 XML Reference

<vline-begin>

Use this element to start printing a vertical line.

Attribute

style

Sample program

Prints a vertical thin line along each of the 100th dots and the 200th dots from the left edge.

Supplementary explanation

❏ This does not work in the page mode.

❏ Use <line> to draw a vertical line in the page mode.

❏ The vertical line continues until stopped by <vline-end>.

❏ Use this element together with <vline-end>.

 "x" must be specified.

 When "style" is not specified, "thin" is applied.

Attribute value Description

"0" to "65535"

Specifies the position to start drawing a vertical ruled line in units of

dots.

Attribute value Description

"thin" Solid line: Fine

"medium" Solid line: Middle

"thick" Solid line: Thick

"thin_double" Double line: Fine

"medium_double" Double line: Middle

"thick_double" Double line: Thick

<epos-print xmlns="http://www.epson-pos.com/schemas/2011/03/epos-print">

<vline-begin x="100" />

<vline-begin x="200" />

<vline-end x="100" />

<vline-end x="200" />

</epos-print>

Chapter 4 XML Reference

<vline-end>

Use this element to stop printing a vertical line.

Attribute

style

Sample program

Prints a vertical thin line along each of the 100th dots and the 200th dots from the left edge.

Supplementary explanation

❏ This API does not work in the page mode.

❏ Use <line> to draw a vertical line in the page mode.

❏ Use <vline-begin> to specify the start position of the vertical line.

❏ Use this method together with <vline-begin>.

 "x" must be specified.

 When "style" is not specified, "thin" is applied.

Attribute value Description

"0" to "65535"

Specifies the position to finish drawing a vertical ruled line in units of

dots.

Attribute value Description

"thin" Solid line: Fine

"medium" Solid line: Middle

"thick" Solid line: Thick

"thin_double" Double line: Fine

"medium_double" Double line: Middle

"thick_double" Double line: Thick

<epos-print xmlns="http://www.epson-pos.com/schemas/2011/03/epos-print">

<vline-begin x="100" />

<vline-begin x="200" />

<vline-end x="100" />

<vline-end x="200" />

</epos-print>

Chapter 4 XML Reference

<page>

This element allows you to change to the page mode from the standard mode.

Elements of <page>

Sample program

Prints a string "ABCDE" in the page mode

Element Description

<text> Prints a text

<feed> Paper feed

<image> Prints a raster image

<logo> Prints an NV logo

<barcode> Prints a barcode

<symbol> Prints a 2D symbol

<area> Specifies a print area

<direction> Specifies the printing direction

<position> Specifies a position to start printing

<line> Prints a line

<rectangle> Prints a rectangle

<command> Inserts a command

<epos-print xmlns="http://www.epson-pos.com/schemas/2011/03/epos-print">

<page>

<text>ABCDE</text>

</page>

</epos-print>

Chapter 4 XML Reference

<area>

This element allows you to set a print area by specifying an origin (starting position) relative to the absolute

origin, and specifying width and height.

The absolute origin is the top-left dot of the printable area.

Attribute

width

height

Sample program

Sets a 200-dots width and 30-dots height print area that starts from x:100 and y:50, and prints a text string

"ABCDE".

The "x", "y", "width" and "height" elements must be specified.

Attribute value Description

"0" to "65535" Specifies the horizontal origin in units of dots.

Attribute value Description

"0" to "65535" Specifies the vertical origin in units of dots.

Attribute value Description

"0" to "65535" Specifies the width in units of dots

Attribute value Description

"0" to "65535" Specifies the height in units of dots

Absolute origin point

Origin point(x, y)

Print area

Paper

Height

Width

Chapter 4 XML Reference

Supplementary explanation

❏ This does not work in the standard mode.

❏ Define the print area in accordance with the contents to print. Any portion of print data outside the print

area is not printed.

❏ Specify the width and height of the print area in accordance with the print direction setting. If the width

and height of the print area do not match the print direction setting, any portion of print data outside

the print area will not be printed. Use <direction> to specify the print direction.

<epos-print xmlns="http://www.epson-pos.com/schemas/2011/03/epos-print">

<page>

<text>ABCDE</text>

</page>

</epos-print>

Chapter 4 XML Reference

This element allows you to specify the print direction in the page mode.

Print direction and rotation of the print area can be specified. The starting position of the print area moves in

accordance with the rotation.

Attribute

dir

Sample program

Rotates the print area clockwise by 90 degrees and prints a text string "ABCDE".

Supplementary explanation

This does not work in the standard mode.

"dir" must be specified.

Attribute value Description

"left_to_right"

Prints from left to right (no rotation. The starting position is at the

upper left.)

"bottom_to_top"

Prints from bottom to top (Rotate the print area counterclockwise by

90 degrees. The starting position is at the lower left.)

"right_to_left"

Prints from right to left (Rotate the print area by 180 degrees. The

starting position is at the lower right.)

"top_to_bottom"

Prints from top to bottom (Rotate the print area clockwise by 90

degrees. The starting position is at the upper right.)

<epos-print xmlns="http://www.epson-pos.com/schemas/2011/03/epos-print">

<page>

<text>ABCDE</text>

</page>

</epos-print>

Chapter 4 XML Reference

This element allows you to specify the print start position (coordinates) within the print area specified by <area>

with reference to the starting position of the print area.

Attribute

Sample program

Specifies the print start position to 50,30 in the print area specified by <area>, and prints a text string

"ABCDE".

Supplementary explanation

❏ This does not work in the standard mode.

❏ Define the print start position (coordinates) in accordance with the contents to print.

"x" and "y" must be specified.

Attribute value Description

"0" to "65535" Specifies the horizontal print start position in units of dots.

Attribute value Description

"0" to "65535" Specify the vertical print start position in units of dots.

<epos-print xmlns="http://www.epson-pos.com/schemas/2011/03/epos-print">

<page>

<text>ABCDE</text>

</page>

</epos-print>

Print data Description

Text string

Specify the leftmost position of the baseline for the first character.

This can be omitted when printing data with the standard size in left

justification.

When printing a double-height character, set y to 42 or larger.

Barcode

Specify the lower-left position of the symbol.

Specify the height of the barcode in y.

Graphics/logo

Specify the lower-left position of the graphic data.

Specify the height of the graphic data in y.

Chapter 4 XML Reference

2D symbol

Specify the upper-left position of the symbol. This can be omitted

when printing from the upper-left position.

Print data Description

100

Chapter 4 XML Reference

<line>

This element allows you to draw a line in the page mode.

Attribute

style

Sample program

Prints a thin line starting from (100,0) and ending at (500,0).

 "x1", "y1", "x2", and "y2" must be specified.

 When "style" is not specified, "thin" is applied.

Attribute value Description

"0" to "65535" Specifies the horizontal draw start position in units of dots.

Attribute value Description

"0" to "65535" Specifies the vertical draw start position in units of dots.

Attribute value Description

"0" to "65535" Specifies the horizontal draw end position in units of dots.

Attribute value Description

"0" to "65535" Specifies the vertical draw end position in units of dots.

Attribute value Description

"thin" Solid line: Fine

"medium" Solid line: Middle

"thick" Solid line: Thick

"thin_double" Double line: Fine

"medium_double" Double line: Middle

"thick_double" Double line: Thick

101

Chapter 4 XML Reference

Supplementary explanation

❏ This does not work in the standard mode.

❏ A diagonal line cannot be drawn.

<epos-print xmlns="http://www.epson-pos.com/schemas/2011/03/epos-print">

<page>

</page>

</epos-print>

102

Chapter 4 XML Reference

This element allows you to draw a quadrangle in the page mode.

Attribute

style

Sample program

Prints a quadrangle that starts from (100,0) and ends at (500,200) using a thin double line.

 "x1", "y1", "x2", and "y2" must be specified.

 When "style" is not specified, "thin" is applied.

Attribute value Description

"0" to "65535" Specifies the horizontal draw start position in units of dots.

Attribute value Description

"0" to "65535" Specifies the vertical draw start position in units of dots.

Attribute value Description

"0" to "65535" Specifies the horizontal draw end position in units of dots.

Attribute value Description

"0" to "65535" Specifies the vertical draw end position in units of dots.

Attribute value Description

"thin" Solid line: Fine

"medium" Solid line: Middle

"thick" Solid line: Thick

"thin_double" Double line: Fine

"medium_double" Double line: Middle

"thick_double" Double line: Thick

103

Chapter 4 XML Reference

Supplementary explanation

❏ This does not work in the standard mode.

❏ Use <hline>, <vline-begin>, and <vline-end> to draw a quadrangle in the standard mode.

<epos-print xmlns="http://www.epson-pos.com/schemas/2011/03/epos-print">

<page>

</page>

</epos-print>

104

Chapter 4 XML Reference

<cut>

This element allows you to cut paper.

Attribute

type

Sample program

Feeds paper and then cuts it.

Supplementary explanation

❏ This does not work in the page mode.

❏ When setting this element, set it at the beginning of a line.

When "type" is not specified, "feed" is applied.

Attribute value Description

"no_feed" Cut without feed (cut the sheet without feeding paper)

"feed" Feed cut (cut the sheet after feeding paper)

"reserve"

Cut reservation (print the following texts and cut the sheet at the cut-

ting position).

<epos-print xmlns="http://www.epson-pos.com/schemas/2011/03/epos-print">

</epos-print>

105

Chapter 4 XML Reference

<pulse>

This element allows you to send a signal to the drawer kick connector.

Attribute

drawer

time

Sample program

Sends a 100 msec pulse signal to pin No.2 of the drawer kick connector.

Supplementary explanation

❏ This does not work in the page mode.

❏ The drawer function cannot be used with the buzzer function.

If "drawer" and "time" are not specified, the values shown below are set.

 drawer: drawer_1

 time: pulse_100

Attribute value Description

"drawer_1" Drawer kick connector pin No.2

"drawer_2" Drawer kick connector pin No.5

Attribute value Description

"pulse_100" 100-msec signal

"pulse_200" 200-msec signal

"pulse_300" 300-msec signal

"pulse_400" 400-msec signal

"pulse_500" 500-msec signal

<epos-print xmlns="http://www.epson-pos.com/schemas/2011/03/epos-print">

</epos-print>

106

Chapter 4 XML Reference

<sound>

This element allows you to sound buzzer.

Attribute

pattern

repeat

If "pattern", "repeat" and "cycle" are not specified, the values shown below are set.

 pattern: pattern_a

 repeat: 1

 cycle: 1000

Attribute value Description

"none" Stop

"pattern_a" Pattern A (optional external buzzer)

"pattern_b" Pattern B (optional external buzzer)

"pattern_c" Pattern C (optional external buzzer)

"pattern_d" Pattern D (optional external buzzer)

"pattern_e" Pattern E (optional external buzzer)

"error" Error sound pattern (optional external buzzer)

"paper_end" Paper empty sound pattern (optional external buzzer)

"pattern_0" Pattern 0 (built-in buzzer)

"pattern_1" Pattern 1 (built-in buzzer)

"pattern_2" Pattern 2 (built-in buzzer)

"pattern_3" Pattern 3 (built-in buzzer)

"pattern_4" Pattern 4 (built-in buzzer)

"pattern_5" Pattern 5 (built-in buzzer)

"pattern_6" Pattern 6 (built-in buzzer)

"pattern_7" Pattern 7 (built-in buzzer)

"pattern_8" Pattern 8 (built-in buzzer)

"pattern_9" Pattern 9 (built-in buzzer)

"pattern_10" Pattern 10 (built-in buzzer)

Attribute value Description

"0" Unlimited

"1" to "255" 1 to 255

107

Chapter 4 XML Reference

cycle

Sample program

Sounds the pattern A buzzer three times.

Supplementary explanation

❏ This does not work in the page mode.

❏ The buzzer function cannot be used with the drawer function.

❏ When "pattern_0" is specified in "pattern", a value that can be set in "repeat" is 1 to 2.

❏ When "pattern_0" is specified in "pattern", a value that can be set in "cycle" is 1000 to 6000.

❏ You can specify "cycle" only when specifying "pattern_0" to "pattern_10" in "pattern".

Attribute value Description

"1000" to "25500" Specifies the buzzer sound cycle in units of milliseconds

<epos-print xmlns="http://www.epson-pos.com/schemas/2011/03/epos-print">

</epos-print>

108

Chapter 4 XML Reference

This element allows you to specify ESC/POS commands encoding them in hexadecimal.

Sample program

Supplementary explanation

❏ Refer to the following URL for details of the ESC/POS command.

https://reference.epson-biz.com/modules/ref_escpos/

❏ ePOS-Print Service I/F does not check the commands sent by the <command> XML.

If the commands interfere with ePOS-Print Service I/F operations, other XML controls may work wrongly

or status values may become invalid.

This XML should be used with a full understanding of ESC/POS commands and the receipt printer speci-

fications.

<epos-print xmlns="http://www.epson-pos.com/schemas/2011/03/epos-print">

</epos-print>

109

Chapter 4 XML Reference

This element allows you to specify the paper settings.

These settings are required when using paper with black mark or die-cut labels.

Attribute

type

width

height

If none of the attributes are specified, the values shown below are set.

 type: receipt

 width: 580

 height: 0

 margin-top: 0

 margin-bottom: 0

 offset-cut: 0

 offset-label: 0

Attribute value Description

receipt Receipt (without black mark)

receipt_bm Receipt (with black mark)

label Label sheet (without black mark)

label_bm Label sheet (with black mark)

Attribute value Description

"290" to "600" Specifies the paper width in units of 0.1 mm

Paper type Valid value Description

Receipt (without black mark) "0" No need to specify

Receipt (with black mark)

 "0" (auto)

 "284" to "-1550" (manual)

Specifies the distance between the top

edges of two consecutive black marks

in units of 0.1 mm.

Label sheet (without black mark)

Specifies the distance between the top

edges of two consecutive labels in

units of 0.1 mm.

Label sheet (with black mark)

Specifies the distance between the

bottom edges of two consecutive black

marks in units of 0.1 mm.

110

Chapter 4 XML Reference

margin-top

margin-bottom

offset-cut

Paper type Valid value Description

Receipt (without black mark) "0" No need to specify

Receipt (with black mark) "-150" to "1500"

Specifies the distance from the top

edge of a black mark to the next print

start position in units of 0.1 mm.

Label sheet (without black mark) "0" to "1500"

Specifies the distance between the top

edge of a label to the next print start

position in units of 0.1 mm.

Label sheet (with black mark) "-15" to "1500"

Specifies the distance between the

bottom edge of a black mark to the

next print start position in units of 0.1

mm.

Paper type Valid value Description

Receipt (without black mark) "0" No need to specify

Receipt (with black mark) "0" No need to specify

Label sheet (without black mark) "-15" to "0"

Specifies the distance between the

bottom edge of a label to the bottom

of the print area in units of 0.1 mm.

(A positive value widens the margin

and a negative value narrows it.)

Label sheet (with black mark) "-15" to "15"

Specifies the distance between the

bottom edge of a black mark to the

bottom of the print area in units of 0.1

mm.

(A positive value widens the margin

and a negative value narrows it.)

Paper type Valid value Description

Receipt (without black mark) "0" No need to specify

Receipt (with black mark) "-290" to "50"

Distance from the top edge of the black

mark to the cut position

Label sheet (without black mark) "0" to "50"

Distance from the bottom edge of the

label to the cut position

Label sheet (with black mark) "0" to "50"

Distance from the top edge of the black

mark to the cut position

111

Chapter 4 XML Reference

offset-label

Sample program

Changing paper

When changing paper to another type, change the paper setting before starting to print.

❏ 58-mm receipt (without black mark)

❏ 58-mm receipt (with black mark)

❏ 58-mm label sheet (without black mark)

❏ 58-mm label sheet (with black mark)

Label paper settings for TM-P series

For TM-P series except TM-P60, first you need to specify the label size settings and paper feed setting for

feeding the sheet to the top of a label.

Paper type Valid value Description

Receipt (without black mark) "0" No need to specify

Receipt (with black mark) "0" No need to specify

Label sheet (without black mark) "0" No need to specify

Label sheet (with black mark) "0" to "15"

Distance from the top edge of the black

mark to the bottom edge of a label

<epos-print xmlns="http://www.epson-pos.com/schemas/2011/03/epos-print">

</epos-print>

<epos-print xmlns="http://www.epson-pos.com/schemas/2011/03/epos-print">

</epos-print>

<epos-print xmlns="http://www.epson-pos.com/schemas/2011/03/epos-print">

<layout type="label" width="580" height="0" margin-top="15" margin-bottom="-15"

offset-cut="25" />

</epos-print>

<epos-print xmlns="http://www.epson-pos.com/schemas/2011/03/epos-print">

<layout type="label_bm" width="580" height="0" margin-top="15" margin-bottom="-15"

offset-cut="25" offset-label = "15" />

</epos-print>

112

Chapter 4 XML Reference

Supplementary explanation

❏ This does not work in the page mode.

❏ Refer to the following for the parameter positions available for each type of paper.

<epos-print xmlns="http://www.epson-pos.com/schemas/2011/03/epos-print">

<!-- Top margin: 1.5 mm from the label top edge, Bottom margin: 1.5 mm from the label

bottom edge -->

<layout type="label" width="580" height="0" margin-top="15" margin-bottom="-15"

offset-cut="25" offset-label="0"/>

</epos-print>

Symbol Parameter

fwidth

113

Chapter 4 XML Reference

aheight

bmargin_top

e margin_bottom

coffset_cut

doffset_label

Symbol Parameter

114

Chapter 4 XML Reference

This element allows you to set the printer to recover from an error.

Sample program

Recovers from an recoverable error and clears the printer buffer.

Supplementary explanation

❏ This does not work in the page mode.

❏ Use this element with the forced transmission mode (force) enabled.

❏ After recovering from a recoverable error, the buffer of the printer is reset.

<epos-print xmlns= "http://www.epson-pos.com/schemas/2011/03/epos-print"

force="true">

</epos-print>

115

Chapter 4 XML Reference

<reset>

This element allows you to reset the printer.

Sample program

Resets the printer.

Supplementary explanation

❏ This does not work in the page mode.

❏ Any other print commands included in the document are ignored.

<epos-print xmlns= "http://www.epson-pos.com/schemas/2011/03/epos-print">

</epos-print>

116

Chapter 4 XML Reference

XML for Controlling Customer Display

<epos-display>

This is an XML document that is sent from an application to a customer display. It requests the customer display

to execute the specified function. The <epos-display> provides all elements necessary to control a customer

display.

Attribute

xmlns

Declares the namespace for epos-display. The namespace is as follows.

http://www.epson-pos.com/schemas/2012/09/epos-display

Sample program

Adds a text tag as a child element.

<epos-display xmlns="http://www.epson-pos.com/schemas/2012/09/epos-display">

<text>Hello world!!</text>

</epos-display>

117

Chapter 4 XML Reference

This is an XML document that is sent back from a customer display to an application.

Attribute

success

code

status

Sample program

❏ When succeeded

❏ When failed

Attribute value Description

"true" / "1" Display succeeded

"false" / "0" Display failed

Attribute value Description

"EDSP_NOT_FOUND" The device was not found.

"EDSP_NOT_OPEN" Failed to open the device.

"EDSP_INVALID_WINDOW" An unregistered window was specified.

"EDSP_SYSTEM_ERROR" An unexpected error occurred.

"EDSP_SCHEMA_ERROR" An XML structural error occurred.

"EX_BADPORT" An internal communication error with the device occurred.

"EX_TIMEOUT" A timeout error occurred during communication with the device.

"EX_INVALID_VALUE" Invalid parameter was detected.

"EDSP_UNRECOVERABLE" Unrecoverable error occurred.

"EDSP_CUTTER" Auto cutter error occurred.

"EDSP_MECHANICAL" Mechanical error occurred.

"EDSP_COVER_OPEN" Cover open error occurred.

"EDSP_REC_EMPTY" No paper is left in the roll paper end detector.

"EDSP_AUTOMATICAL" Automatic recovery error occurred.

Attribute value Description

"0" Always

118

Chapter 4 XML Reference

Supplementary explanation

When using TM-m30 printer and DM-D30 display, the following codes are not returned.

❏ "EDSP_UNRECOVERABLE"

❏ "EDSP_CUTTER"

❏ "EDSP_MECHANICAL"

❏ "EDSP_COVER_OPEN"

❏ "EDSP_REC_EMPTY"

❏ "EDSP_AUTOMATICAL"

119

Chapter 4 XML Reference

This element allows you to create or delete a window on the display, and change the current window.

❏ Specify "number", "x", "y", "width", and "height" to create a new window.

❏ Specify "true/1" for "destroy" to destroy the window specified by "number".

❏ To change the current window to another window, specify only "number".

Attribute

number

width

height

scrollmode

Attribute value Description

"1" to "4" Specifies the window number.

Attribute value Description

"1" to "20" Specifies the origin of the X coordinate.

Attribute value Description

"1" to "2" Specifies the origin of the Y coordinate.

Attribute value Description

"1" to "20" Specifies the window width.

Attribute value Description

"1" to "2" Specifies the window height.

Attribute value Description

"overwrite" (default)

When the cursor is at the rightmost position of the upper line, display-

ing a new character moves the cursor to the leftmost position of the

lower line. When the cursor is at the rightmost position of the lower

line, displaying a new character moves the cursor to the leftmost posi-

tion of the upper line.

"v_scroll"

When the cursor is at the rightmost position of the upper line, display-

ing a new character moves the cursor to the leftmost position of the

lower line. When the cursor is at the rightmost position of the lower

line, displaying a new character scrolls up the characters on the lower

line and clears the lower line.

120

Chapter 4 XML Reference

destroy

Error status

Sample program

❏ Defines "window 1" that has 10 width and 2 height starting from the upper left of the display, and scrolls

vertically.

❏ Defines "window 2" that has 10 width and 2 height starting from the center of the display, and scrolls

vertically.

❏ Changes the current window to "window 1"

❏ Destroys "window 2"

Supplementary explanation

❏ When adding a new window, make sure that the window area on the customer display does not overlap

with that of existing window(s)

❏ If you specify "number", "x", "y", "width", and "height", and specify "true/1" in "destroy", neither of the pro-

cesses (create and destroy window) is performed.

"h_scroll"

When the cursor is at the rightmost position, displaying a new charac-

ter scrolls all the characters already displayed on the cursor line to the

left by one character and the new character is displayed at the right-

most position.

Attribute value Description

"true" / "1" Destroys the window specified by "number"

"false" / "0" (default) Not destroy

Error Description

"EX_INVALID_VALUE"

The "x", "y", "width", and "height" specified for a new window overlap

with those of an existing window.

"EDSP_INVALID_WINDOW"

When changing the current window, the destination window does

not exist.

Attribute value Description

121

Chapter 4 XML Reference

<text>

This element allows you to specify text display settings to be displayed on a customer display.

Attribute

reverse

lang

Sample program

❏ Displays the text from the upper left.

❏ Displays inverted text (white text on black background) from the current cursor position.

❏ Changes the current window to "window 2" and displays window 2.

Supplementary explanation

If "x" and "y" are not specified, the text is displayed from the current cursor position.

Attribute value Description

"1" to "20" Specifies the X coordinate of the display position.

Attribute value Description

"1" to "2" Specifies the Y coordinate of the display position.

Attribute value Description

"true" / "1" Inverts black and white

"false" / "0" Cancels the black and white inversion

Attribute value Description

"en" (default) English

"ja" Japanese

<text x="1" y="1" lang="ja">Carrots \100</text>

<text reverse="true">Welcome!!</text>

<text x="1" y="1" lang="ja">Carrots \100</text>

122

Chapter 4 XML Reference

This element allows you to specify the cursor position and cursor display settings.

❏ Specify "x" and "y" to move the cursor to the specified coordinate on the customer display.

❏ Use "moveto" to move the cursor to a specified position in the current window.

Attribute

moveto

type

Sample program

❏ Move the cursor to the upper left of the customer display.

❏ Moves the cursor to the upper left of the current window.

Supplementary explanation

I f "x ", " y", a n d "m ove to " ar e sp ecif ied at a time, the cursor does not move.

Attribute value Description

"1" to "20" Specifies the X coordinate.

Attribute value Description

"1" to "2" Specifies the Y coordinate.

Attribute value Description

"top_left" Moves to the leftmost position on the top line.

"top_right" Moves to the rightmost position on the top line.

"bottom_left" Moves to the leftmost position on the bottom line.

"bottom_right" Moves to the rightmost position on the bottom line.

Attribute value Description

"none" No cursor display

"underline" Underscore

123

Chapter 4 XML Reference

<blink>

This element allows you to specify blink settings of the customer display.

Attribute

interval

Sample program

❏ Sets the time interval between display blinks to 500 ms.

❏ Sets the display to stop blinking.

❏ Sets the display to turn off. Maintains the display data.

Supplementary explanation

The setting value is rounded to a nearest value in units of 50 milliseconds.

Example: 1 => 50, 51 => 100, 101 => 150

Attribute value Description

"0" Normal display (light up)

"1" to "12700"

Specifies a time interval between display blinks in units of millisec-

onds.

"12701" to "12750" Display is turned off (display data is maintained)

124

Chapter 4 XML Reference

This element allows you to specify the brightness setting of the customer display.

Attribute

value

Sample program

❏ Specifies the brightness to 20%.

❏ Specifies the brightness to 40%.

Attribute value Description

"20" Brightness 20%

"40" Brightness 40%

"60" Brightness 60%

"100" Brightness 100%

125

Chapter 4 XML Reference

This element allows you to specify marquee display settings for text strings.

Characters in a text string is displayed one by one at a time interval specified in "uwait". When the last character

is displayed, the display of the text string restarts from the top character after the time specified in "rwait" has

elapsed.

Attribute

format

repeat

uwait

rwait

lang

Sample program

❏ Displays the characters one by one at 500-msec interval from the right of the display, and repeats the

marquee display at 1000-msec interval.

Attribute value Description

"walk" (default) Displays the text from the rightmost position of the window.

"place" Displays the text from the leftmost position of the window.

Attribute value Description

"0" Repeats unlimitedly

"1" to "127" Specifies the number of repeating times (an integer)

Attribute value Description

"0" to "2000"

Specifies a time interval (an integer) after displaying one character

and before displaying the next character in units of msec.

Attribute value Description

"100" to "2000"

Specifies a time period (an integer) to wait after displaying the last

character in units of msec.

Attribute value Description

"en" (default) English

"ja" Japanese

<marquee uwait="500" rwait="1000">Welcom!!</marquee>

126

Chapter 4 XML Reference

❏ Displays the characters one by one at 500-msec interval from the left of the display, and repeats the mar-

quee display at 1000-msec interval.

Supplementary explanation

❏ For TM-m30 and DM-D30, and TM-H6000V and DM-D110/DM-D210, "0" is only allowed in repeat.

❏ When controlling DM-D30, its marquee display may be distorted if the interval for displaying text is too

short due to the characteristics of the LCD. It is recommended to set uwait and rwait so that the interval

for displaying text is 600 msec or longer.

<marquee uwait="500" rwait="1000" format="place">Welcome!!</marquee>

127

Chapter 4 XML Reference

<clock>

This element allows you to display the time at the lower right of a customer display.

Attribute

hour

minute

Sample program

❏ Sets the clock time and displays the time.

❏ Displays the clock time.

Supplementary explanation

When using TM-m30 printer and DM-D30 display, use this element to set the correct time after turning on

and back on the printer, or after executing <reset>.

Attribute value Description

"0" to "233" Specifies "hour" using an integer.

Attribute value Description

"0" to "59" Specifies "minute" using an integer.

128

Chapter 4 XML Reference

<clear>

This element allows you to clear contents displayed on the current window.

If no current window exists, all the contents displayed on the customer display are cleared.

Sample program

129

Chapter 4 XML Reference

<reset>

This element allows you to reset the customer display. The reset brings the display to the following states.

❏ All displayed text and registered windows are discarded.

❏ The cursor setting is reset and the cursor is moved to the origin of the customer display.

❏ Display blinking and brightness settings are reset to their default.

Sample program

130

Chapter 4 XML Reference

This element allows you to execute specific ESC/POS commands.

Specify the command using hexadecimal string.

Sample program

Supplementary explanation

❏ Refer to the following URL for details of the ESC/POS command.

https://reference.epson-biz.com/modules/ref_escpos_dm_d_en/

❏ ePOS-Print Service I/F does not check the commands sent by the <command> XML.If the commands

interfere with ePOS-Print Service I/F operations, other XML controls may work wrongly or status values

may become invalid.This XML should be used with a full understanding of ESC/POS commands and the

customer display specifications.

Detailed information on ESC/POS commands are provided in the specification sheet of each customer display.

A separate contract is required to get the specification sheet. For more details, contact the store of your

purchase.

131

Chapter 5 Device Specifications

Device Specifications

This chapter describes the restriction on use of the elements, which depends on the printer model and customer

display model, and provides some values for attributes.

XML Supported Printers

The table below shows the printers that support the XML documents.

Refer to the Technical Reference Guide of each printer for more information on each printer.

XML Supported Printers

XML for Controlling Printer

All printers

Availability and restriction on use of the elements differ by printer. Refer to

Supported Elements List.

XML for Controlling Customer Display

Can be used for a set of the following printer and customer display.

 TM-m30 + DM-D30

 TM-T88VI/TM-T88VI-iHUB + DM-D30/DM-D110

 TM-H6000V+DM-D110/DM-D210

132

Chapter 5 Device Specifications

Supported Elements List

This section provides information on which element can be used for which printer.

The meaning of the symbols used in the list is as follows.

 ✔: Supported

 ✔*: Supported but has a restriction on attributes values

 -: Not supported

For information on the "✔*" restrictions, refer to Printer-specific Support Information.

XML for Controlling Printer

TM Printers

Element

TM-L90

TM-L90 4xx

TM-m10

TM-m30

TM-P20

TM-P60II (Receipt)

TM-P60II (Peeler)

TM-P80

TM-T20

TM-T20II

TM-T70

TM-T70II

TM-T82II

TM-T83II

TM-T88IV

TM-T88V

TM-T88VI

TM-T90

TM-U220

TM-U330

TM-H6000IV

TM-H6000V

<epos-print> ✔✔✔✔✔✔✔✔✔✔✔✔✔✔✔✔✔✔✔* ✔* ✔✔

<response> ✔✔✔✔✔✔✔✔✔✔✔✔✔✔✔✔✔✔✔✔✔✔

<text> ✔* ✔* ✔* ✔* ✔* ✔* ✔* ✔* ✔* ✔* ✔* ✔* ✔* ✔* ✔* ✔* ✔* ✔* ✔* ✔* ✔* ✔*

<feed> ✔✔✔* ✔ * ✔* ✔* ✔✔* ✔* ✔* ✔* ✔* ✔* ✔* ✔* ✔* ✔* ✔* ✔* ✔* ✔* ✔*

<image> ✔* ✔* ✔* ✔* ✔* ✔* ✔* ✔* ✔* ✔* ✔* ✔* ✔* ✔* ✔* ✔* ✔* ✔* ✔* ✔* ✔* ✔*

ogo> ✔✔✔✔✔✔✔✔✔✔✔✔✔✔✔✔✔✔ --✔✔

<barcode> ✔* ✔* ✔* ✔* ✔✔* ✔* ✔ * ✔* ✔* ✔* ✔* ✔* ✔* ✔* ✔* ✔* ✔*- -✔* ✔*

<symbol> ✔* ✔* ✔* ✔* ✔* ✔ * ✔* ✔* ✔* ✔* ✔* ✔* ✔* ✔* ✔* ✔* ✔* ✔*-

-✔* ✔*

<hline> ----------------------

<vline-begin> ----------------------

<vline-end> ----------------------

<page> ✔✔✔✔✔✔✔✔✔✔✔✔✔✔✔✔✔✔ --✔✔

<area> ✔✔✔✔✔✔✔✔✔✔✔✔✔✔✔✔✔✔ --✔✔

<direction> ✔✔✔✔✔✔✔✔✔✔✔✔✔✔✔✔✔✔ --✔✔

<position> ✔✔✔✔✔✔✔✔✔✔✔✔✔✔✔✔✔✔ --✔✔

<line> ----✔* ✔* ✔* ✔*--------✔*----✔*

<rectangle> ----✔* ✔* ✔* ✔*--------✔*----✔*

<cut> ✔* ✔* ✔* ✔* ✔* ✔* ✔* ✔* ✔* ✔* ✔* ✔* ✔* ✔* ✔* ✔* ✔* ✔* ✔* ✔* ✔* ✔*

<puls

e> ✔✔✔✔ ----✔✔✔✔✔✔✔✔✔✔✔✔✔✔

<sound> --✔* ✔* ✔* ✔* ✔* ✔* ✔* ✔*-✔* ✔* ✔*-✔* ✔*- -✔*- -

133

Chapter 5 Device Specifications

TM-DT Series/TM-i Series

<command> ✔✔✔✔✔✔✔✔✔✔✔✔✔✔✔✔✔✔✔✔✔✔

<layout> ----✔*- ✔✔*--------------

<recovery> ✔✔✔✔✔✔✔✔✔✔✔✔✔✔✔✔✔✔ --✔✔

<reset> ✔✔✔✔✔✔✔✔✔✔✔✔✔✔✔✔✔✔✔✔✔✔

Element

TM-L90-i

TM-T20II-i

TM-T70-i

TM-T82II-i

TM-T83II-i

TM-T88V-i

TM-T88VI-iHUB

TM-U220-i

TM-T70II-DT

TM-T88V-DT

TM-H6000IV-DT

<epos-print> ✔✔✔✔✔✔✔✔* ✔✔✔

<response> ✔✔✔✔✔✔✔✔✔✔✔

<text> ✔* ✔* ✔* ✔* ✔* ✔* ✔* ✔* ✔* ✔* ✔*

<feed> ✔✔* ✔* ✔* ✔* ✔* ✔* ✔* ✔* ✔* ✔*

<image> ✔* ✔* ✔* ✔* ✔* ✔* ✔* ✔* ✔* ✔* ✔*

<logo> ✔✔✔✔✔✔✔✔✔✔✔

<barcode> ✔* ✔* ✔* ✔* ✔* ✔* ✔*-✔* ✔* ✔*

<symbol> ✔* ✔* ✔* ✔* ✔* ✔ * ✔*-✔* ✔* ✔*

<hl

ine> -----------

<vline-begin> -----------

<vline-end> -----------

<page> ✔✔✔✔✔✔✔ - ✔✔✔

<area> ✔✔✔✔✔✔✔ - ✔✔✔

<direction> ✔✔✔✔✔✔✔ - ✔✔✔

<position> ✔✔✔✔✔✔✔ - ✔✔✔

<line> ------✔*----

<rectangle> ------✔*----

<cut> ✔* ✔* ✔* ✔* ✔* ✔* ✔* ✔* ✔* ✔* ✔*

<pulse> ✔✔✔✔✔✔✔✔✔✔✔

<sound> - ✔*-✔* ✔* ✔* ✔*-✔* ✔*-

<command> ✔✔✔✔✔✔✔✔✔✔✔

<layout> -----------

Element

TM-L90

TM-L90 4xx

TM-m10

TM-m30

TM-P20

TM-P60II (Receipt)

TM-P60II (Peeler)

TM-P80

TM-T20

TM-T20II

TM-T70

TM-T70II

TM-T82II

TM-T83II

TM-T88IV

TM-T88V

TM-T88VI

TM-T90

TM-U220

TM-U330

TM-H6000IV

TM-H6000V

134

Chapter 5 Device Specifications

<recovery> ✔✔✔✔✔✔✔ - ✔✔✔

<reset> ✔✔✔✔✔✔✔✔✔✔✔

Element

TM-L90-i

TM-T20II-i

TM-T70-i

TM-T82II-i

TM-T83II-i

TM-T88V-i

TM-T88VI-iHUB

TM-U220-i

TM-T70II-DT

TM-T88V-DT

TM-H6000IV-DT

135

Chapter 5 Device Specifications

Printer-specific Support Information

TM-L90

Printer Specifications

Parameter Restrictions

Item Receipt Specification

Die-cut Label Specifica-

tion

Amount of initial feed 30 dots

Initial page mode area

Monochrome print-

ing

576 x 738 dots 560 x 738 dots

Two-color printing 576 x 369 dots 560 x 369 dots

Maximum page mode area

Monochrome print-

ing

576 x 1476 dots 560 x 1476 dots

Two-color printing 576x 738 dots 560 x 738 dots

Baseline of Font A 21 dots from the top of the character

Baseline of Font B

ANK: 16

Chinese characters: 15 dots from the top of the character

Element Attribute Specificable Setting Value

<text>

lang

 "en"

 "de"

 "fr"

 "it"

 "es"

 "ko"

 "ko-kr"

 "zh-hans"

 "zh-cn"

 "zh-hant"

 "zh-tw"

 Language code other than above

font

 "font_a"

 "font_b"

 "font_c"

color

 "color_1"

 "color_2"

<image>

color

 "color_1"

 "color_2"

mode  "mono"

136

Chapter 5 Device Specifications

type

 "upc_a"

 "upc_e"

 "ean13"

 "jan13"

 "ean8"

 "jan8"

 "code39"

 "itf"

 "codabar"

 "code93"

 "code128"

font

 "font_a"

 "font_b"

 "font_c"

Element Attribute Specificable Setting Value

137

Chapter 5 Device Specifications

type

 "pdf417_standard"

 "pdf417_truncated"

 "qrcode_model_1"

 "qrcode_model_2"

 "maxicode_mode_2"

 "maxicode_mode_3"

 "maxicode_mode_4"

 "maxicode_mode_5"

 "maxicode_mode_6"

level

 "level_0"

 "level_1" (default value)

 "level_2"

 "level_3"

 "level_4"

 "level_5"

 "level_6"

 "level_7"

 "level_8"

 "level_l"

 "level_m"

 "level_q"

 "level_h"

 "default"

width

 PDF417

 QR Code

 MaxiCode

height

 PDF417

 QR Code

 MaxiCode

size

 PDF417

 QR Code

 MaxiCode

<cut> type

 "no_feed"

 "feed"

Element Attribute Specificable Setting Value

138

Chapter 5 Device Specifications

TM-L90 4xx

Printer Specifications

Parameter Restrictions

Item Receipt Specification

Die-cut Label Specifica-

tion

Amount of initial feed 30 dots

Initial page mode area

Monochrome print-

ing

576 x 738 dots 560 x 738 dots

Two-color printing 576 x 369 dots 560 x 369 dots

Maximum page mode area

Monochrome print-

ing

576 x 1476 dots 560 x 1476 dots

Two-color printing 576 x 369 dots 560 x 738 dots

Baseline of Font A 21 dots from the top of the character

Baseline of Font B

ANK: 16

Chinese characters: 15 dots from the top of the character

Element Attribute Specificable Setting Value

<text>

lang

 "en"

 "de"

 "fr"

 "it"

 "es"

 "ko"

 "ko-kr"

 "zh-hans"

 "zh-cn"

 "zh-hant"

 "zh-tw"

 Language code other than above

font

 "font_a"

 "font_b"

 "font_c"

color  "color_1"

<image> color  "color_1"

<barcode> font

 "font_a"

 "font_b"

 "font_c"

139

Chapter 5 Device Specifications

type

 "pdf417_standard"

 "pdf417_truncated"

 "qrcode_model_1"

 "qrcode_model_2"

 "qrcode_micro"

 "maxicode_mode_2"

 "maxicode_mode_3"

 "maxicode_mode_4"

 "maxicode_mode_5"

 "maxicode_mode_6"

 "gs1_databar_stacked"

 "gs1_databar_stacked_omnidirectional"

 "gs1_databar_expanded_stacked"

 "datamatrix_square"

 "datamatrix_rectangle_8"

 "datamatrix_rectangle_12"

 "datamatrix_rectangle_16"

level

 "level_0"

 "level_1" (default value)

 "level_2"

 "level_3"

 "level_4"

 "level_5"

 "level_6"

 "level_7"

 "level_8"

 "level_l"

 "level_m"

 "level_q"

 "level_h"

 "default"

<cut> type

 "no_feed"

 "feed"

Element Attribute Specificable Setting Value

140

Chapter 5 Device Specifications

TM-m10

Printer Specifications

Parameter Restrictions

Item Specification

Amount of initial feed 30 dots

Initial page mode area 420 x 2400 dots

Maximum page mode area 420 x 2400 dots

Baseline of Font A 21 dots from the top of the character

Baseline of Font B 21 dots from the top of the character

Baseline of Font C 16 dots from the top of the character

Element Attribute Specificable Setting Value

<text>

lang

 "en"

 "de"

 "fr"

 "it"

 "es"

 "zh-hant"

 "zh-tw"

 Language code other than above

font

 "font_a"

 "font_b"

 "font_c"

color  "color_1"

<image>

color  "color_1"

mode  "mono"

<barcode> font

 "font_a"

 "font_b"

 "font_c"

141

Chapter 5 Device Specifications

<symbol> type

 "pdf417_standard"

 "pdf417_truncated"

 "qrcode_model_1"

 "qrcode_model_2"

 "maxicode_mode_2"

 "maxicode_mode_3"

 "maxicode_mode_4"

 "maxicode_mode_5"

 "maxicode_mode_6"

 "gs1_databar_stacked"

 "gs1_databar_stacked_omnidirectional"

 "gs1_databar_expanded_stacked"

 "azteccode_fullrange"

 "azteccode_compact"

 "datamatrix_square"

 "datamatrix_rectangle_8"

 "datamatrix_rectangle_12"

 "datamatrix_rectangle_16"

<cut> type

 "no_feed"

 "feed"

<sound>

pattern

 "none"

 "pattern_a"

 "pattern_b"

 "pattern_c"

 "pattern_d"

 "pattern_e"

 "error"

 "paper_end"

repeat  "1" to "255"

Element Attribute Specificable Setting Value

142

Chapter 5 Device Specifications

TM-m30

Printer Specifications

Parameter Restrictions

Item 58mm Specification 80mm Specification

Amount of initial feed 30 dots

Initial page mode area 420 x 2400 dots 576 x 2400 dots

Maximum page mode area 420 x 2400 dots 576 x 2400 dots

Baseline of Font A 21 dots from the top of the character

Baseline of Font B 21 dots from the top of the character

Baseline of Font C 16 dots from the top of the character

Element Attribute Specificable Setting Value

<text>

lang

 "en"

 "de"

 "fr"

 "it"

 "es"

 "zh-hans"

 "zh-cn"

 "zh-hant"

 "zh-tw"

 Language code other than above

font

 "font_a"

 "font_b"

 "font_c"

color  "color_1"

<image>

color  "color_1"

mode  "mono"

<barcode> font

 "font_a"

 "font_b"

 "font_c"

143

Chapter 5 Device Specifications

<symbol> type

 "pdf417_standard"

 "pdf417_truncated"

 "qrcode_model_1"

 "qrcode_model_2"

 "maxicode_mode_2"

 "maxicode_mode_3"

 "maxicode_mode_4"

 "maxicode_mode_5"

 "maxicode_mode_6"

 "gs1_databar_stacked"

 "gs1_databar_stacked_omnidirectional"

 "gs1_databar_expanded_stacked"

 "azteccode_fullrange"

 "azteccode_compact"

 "datamatrix_square"

 "datamatrix_rectangle_8"

 "datamatrix_rectangle_12"

 "datamatrix_rectangle_16"

<cut> type

 "no_feed"

 "feed"

<sound>

pattern

 "none"

 "pattern_a"

 "pattern_b"

 "pattern_c"

 "pattern_d"

 "pattern_e"

 "error"

 "paper_end"

repeat  "1" to "255"

Element Attribute Specificable Setting Value

144

Chapter 5 Device Specifications

TM-P20

Printer Specifications

Parameter Restrictions

Item Specification

Amount of initial feed 30 dots

Initial page mode area 384 x 2400 dots

Maximum page mode area 384 x 2400 dots

Baseline of Font A 21 dots from the top of the character

Baseline of Font B 21 dots from the top of the character

Baseline of Font C 16 dots from the top of the character

Baseline of Font D 21 dots from the top of the character

Baseline of Font E 15 dots from the top of the character

Element Attribute Specificable Setting Value

<text>

lang

 "en"

 "de"

 "fr"

 "it"

 "es"

 "ko"

 "ko-kr"

 "zh-hans"

 "zh-cn"

 "zh-hant"

 "zh-tw"

 Language code other than above

color  "color_1"

<feed> pos

 "cutting"

 "current_tof"

 "next_tof"

<image>

color  "color_1"

mode  "mono"

145

Chapter 5 Device Specifications

<symbol> type

 "pdf417_standard"

 "pdf417_truncated"

 "qrcode_model_1"

 "qrcode_model_2"

 "maxicode_mode_2"

 "maxicode_mode_3"

 "maxicode_mode_4"

 "maxicode_mode_5"

 "maxicode_mode_6"

 "gs1_databar_stacked"

 "gs1_databar_stacked_omnidirectional"

 "gs1_databar_expanded_stacked"

 "azteccode_fullrange"

 "azteccode_compact"

 "datamatrix_square"

 "datamatrix_rectangle_8"

 "datamatrix_rectangle_12"

 "datamatrix_rectangle_16"

<line> style

 "thin"

 "medium"

 "thick"

<rectangle> style

 "thin"

 "medium"

 "thick"

<cut> type

 "no_feed"

 "feed"

<sound>

pattern

 "none"

 "pattern_1"

 "pattern_2"

 "pattern_3"

 "pattern_4"

 "pattern_5"

 "pattern_6"

 "pattern_7"

 "pattern_8"

 "pattern_9"

 "pattern_10"

repeat  "1" to "255"

Element Attribute Specificable Setting Value

146

Chapter 5 Device Specifications

type

 receipt

 receipt_bm

height

 Receipt (without black mark)

 Receipt (with black mark)

margin-top

 Receipt (without black mark)

 Receipt (with black mark)

margin-bottom

 Receipt (without black mark)

 Receipt (with black mark)

offset-cut

 Receipt (without black mark)

 Receipt (with black mark)

offset-label

 Receipt (without black mark)

 Receipt (with black mark)

Element Attribute Specificable Setting Value

147

Chapter 5 Device Specifications

TM-P60II (Receipt)

Printer Specifications

Parameter Restrictions

Item Receipt Specification

Die-cut Label Specifica-

tion

Amount of initial feed 30 dots

Initial page mode area 432 x 1624 dots 400 x 1624 dots

Maximum page mode area 432 x 1624 dots 400 x 1624 dots

Baseline of Font A 21 dots from the top of the character

Baseline of Font B 16 dots from the top of the character

Baseline of Font C 15 dots from the top of the character

Element Attribute Specificable Setting Value

<text>

lang

 "en"

 "de"

 "fr"

 "it"

 "es"

 "zh-hant"

 "zh-tw"

 Language code other than above

font

 "font_a"

 "font_b"

 "font_c"

color  "color_1"

<image>

color  "color_1"

mode  "mono"

<barcode> font

 "font_a"

 "font_b"

 "font_c"

148

Chapter 5 Device Specifications

<symbol> type

 "pdf417_standard"

 "pdf417_truncated"

 "qrcode_model_1"

 "qrcode_model_2"

 "maxicode_mode_2"

 "maxicode_mode_3"

 "maxicode_mode_4"

 "maxicode_mode_5"

 "maxicode_mode_6"

 "gs1_databar_stacked"

 "gs1_databar_stacked_omnidirectional"

 "gs1_databar_expanded_stacked"

 "azteccode_fullrange"

 "azteccode_compact"

 "datamatrix_square"

 "datamatrix_rectangle_8"

 "datamatrix_rectangle_12"

 "datamatrix_rectangle_16"

<line> style

 "thin"

 "medium"

 "thick"

<rectangle> style

 "thin"

 "medium"

 "thick"

<cut> type

 "no_feed"

 "feed"

<sound>

pattern

 "none"

 "pattern_1"

 "pattern_2"

 "pattern_3"

 "pattern_4"

 "pattern_5"

 "pattern_6"

 "pattern_7"

 "pattern_8"

 "pattern_9"

 "pattern_10"

repeat  "1" to "255"

Element Attribute Specificable Setting Value

149

Chapter 5 Device Specifications

TM-P60II (Peeler)

Printer Specifications

Parameter Restrictions

Item Receipt Specification

Die-cut Label Specifica-

tion

Amount of initial feed 30 dots

Initial page mode area 432 x 1624 dots 400 x 1624 dots

Maximum page mode area 432 x 1624 dots 400 x 1624 dots

Baseline of Font A 21 dots from the top of the character

Baseline of Font B 16 dots from the top of the character

Baseline of Font C 15 dots from the top of the character

Element Attribute Specificable Setting Value

<text>

lang

 "en"

 "de"

 "fr"

 "it"

 "es"

 "zh-hant"

 "zh-tw"

 Language code other than above

font

 "font_a"

 "font_b"

 "font_c"

color  "color_1"

<image>

color  "color_1"

mode  "mono"

<barcode> font

 "font_a"

 "font_b"

 "font_c"

150

Chapter 5 Device Specifications

<symbol> type

 "pdf417_standard"

 "pdf417_truncated"

 "qrcode_model_1"

 "qrcode_model_2"

 "maxicode_mode_2"

 "maxicode_mode_3"

 "maxicode_mode_4"

 "maxicode_mode_5"

 "maxicode_mode_6"

 "gs1_databar_stacked"

 "gs1_databar_stacked_omnidirectional"

 "gs1_databar_expanded_stacked"

 "azteccode_fullrange"

 "azteccode_compact"

 "datamatrix_square"

 "datamatrix_rectangle_8"

 "datamatrix_rectangle_12"

 "datamatrix_rectangle_16"

<line> style

 "thin"

 "medium"

 "thick"

<rectangle> style

 "thin"

 "medium"

 "thick"

<cut> type

 "no_feed"

 "feed"

<sound>

pattern

 "none"

 "pattern_1"

 "pattern_2"

 "pattern_3"

 "pattern_4"

 "pattern_5"

 "pattern_6"

 "pattern_7"

 "pattern_8"

 "pattern_9"

 "pattern_10"

repeat  "1" to "255"

Element Attribute Specificable Setting Value

151

Chapter 5 Device Specifications

TM-P80

Printer Specifications

Parameter Restrictions

Item Specification

Amount of initial feed 30 dots

Initial page mode area 576 x 1662 dots

Maximum page mode area 576 x 1662 dots

Baseline of Font A 21 dots from the top of the character

Baseline of Font B 16 dots from the top of the character

Element Attribute Specificable Setting Value

<text>

lang

 "en"

 "de"

 "fr"

 "it"

 "es"

 Language code other than above

font

 "font_a"

 "font_b"

color  "color_1"

<feed> pos

 "cutting"

 "current_tof"

 "next_tof"

<image>

color  "color_1"

mode  "mono"

<barcode> font

 "font_a"

 "font_b"

152

Chapter 5 Device Specifications

<symbol> type

 "pdf417_standard"

 "pdf417_truncated"

 "qrcode_model_1"

 "qrcode_model_2"

 "maxicode_mode_2"

 "maxicode_mode_3"

 "maxicode_mode_4"

 "maxicode_mode_5"

 "maxicode_mode_6"

 "gs1_databar_stacked"

 "gs1_databar_stacked_omnidirectional"

 "gs1_databar_expanded_stacked"

 "azteccode_fullrange"

 "azteccode_compact"

 "datamatrix_square"

 "datamatrix_rectangle_8"

 "datamatrix_rectangle_12"

 "datamatrix_rectangle_16"

<line> style

 "thin"

 "medium"

 "thick"

<rectangle> style

 "thin"

 "medium"

 "thick"

<cut> type

 "no_feed"

 "feed"

<sound>

pattern

 "none"

 "pattern_1"

 "pattern_2"

 "pattern_3"

 "pattern_4"

 "pattern_5"

 "pattern_6"

 "pattern_7"

 "pattern_8"

 "pattern_9"

 "pattern_10"

repeat  "1" to "255"

Element Attribute Specificable Setting Value

153

Chapter 5 Device Specifications

type

 receipt

 receipt_bm

height

 Receipt (without black mark)

 Receipt (with black mark)

margin-top

 Receipt (without black mark)

 Receipt (with black mark)

margin-bottom

 Receipt (without black mark)

 Receipt (with black mark)

offset-cut

 Receipt (without black mark)

 Receipt (with black mark)

offset-label

 Receipt (without black mark)

 Receipt (with black mark)

Element Attribute Specificable Setting Value

154

Chapter 5 Device Specifications

TM-T20

Printer Specifications

Parameter Restrictions

Item 58mm Specification 80mm Specification

Amount of initial feed 30 dots

Initial page mode area 420 x 831 dots 576 x 831 dots

Maximum page mode area 420 x 1662 dots 576 x 1662 dots

Baseline of Font A 21 dots from the top of the character

Baseline of Font B 16 dots from the top of the character

Element Attribute Specificable Setting Value

<text>

lang

 "en"

 "de"

 "fr"

 "it"

 "es"

 Language code other than above

font

 "font_a"

 "font_b"

color  "color_1"

<image>

color  "color_1"

mode  "mono"

<barcode> font

 "font_a"

 "font_b"

155

Chapter 5 Device Specifications

type

 "pdf417_standard"

 "pdf417_truncated"

 "qrcode_model_1"

 "qrcode_model_2"

 "maxicode_mode_2"

 "maxicode_mode_3"

 "maxicode_mode_4"

 "maxicode_mode_5"

 "maxicode_mode_6"

 "gs1_databar_stacked"

 "gs1_databar_stacked_omnidirectional"

 "gs1_databar_expanded_stacked"

level

 "level_0"

 "level_1" (default value)

 "level_2"

 "level_3"

 "level_4"

 "level_5"

 "level_6"

 "level_7"

 "level_8"

 "level_l"

 "level_m"

 "level_q"

 "level_h"

 "default"

width

 PDF417

 QR Code

 MaxiCode

 2D GS1 DataBar

height

 PDF417

 QR Code

 MaxiCode

 2D GS1 DataBar

size

 PDF417

 QR Code

 MaxiCode

 2D GS1 DataBar

<cut> type

 "no_feed"

 "feed"

Element Attribute Specificable Setting Value

156

Chapter 5 Device Specifications

<sound>

pattern

 "none"

 "pattern_a"

 "pattern_b"

 "pattern_c"

 "pattern_d"

 "pattern_e"

 "error"

 "paper_end"

repeat  "1" to "255"

Element Attribute Specificable Setting Value

157

Chapter 5 Device Specifications

TM-T20II

Printer Specifications

Parameter Restrictions

Item 58mm Specification 80mm Specification

Amount of initial feed 30 dots

Initial page mode area 420 x 831 dots 576 x 831 dots

Maximum page mode area 420 x 1662 dots 576 x 1662 dots

Baseline of Font A 21 dots from the top of the character

Baseline of Font B 16 dots from the top of the character

Element Attribute Specificable Setting Value

<text>

lang

 "en"

 "de"

 "fr"

 "it"

 "es"

 Language code other than above

font

 "font_a"

 "font_b"

color  "color_1"

<image>

color  "color_1"

mode  "mono"

<barcode> font

 "font_a"

 "font_b"

158

Chapter 5 Device Specifications

type

 "pdf417_standard"

 "pdf417_truncated"

 "qrcode_model_1"

 "qrcode_model_2"

 "maxicode_mode_2"

 "maxicode_mode_3"

 "maxicode_mode_4"

 "maxicode_mode_5"

 "maxicode_mode_6"

 "gs1_databar_stacked"

 "gs1_databar_stacked_omnidirectional"

 "gs1_databar_expanded_stacked"

level

 "level_0"

 "level_1" (default value)

 "level_2"

 "level_3"

 "level_4"

 "level_5"

 "level_6"

 "level_7"

 "level_8"

 "level_l"

 "level_m"

 "level_q"

 "level_h"

 "default"

width

 PDF417

 QR Code

 MaxiCode

 2D GS1 DataBar

height

 PDF417

 QR Code

 MaxiCode

 2D GS1 DataBar

size

 PDF417

 QR Code

 MaxiCode

 2D GS1 DataBar

<cut> type

 "no_feed"

 "feed"

Element Attribute Specificable Setting Value

159

Chapter 5 Device Specifications

<sound>

pattern

 "none"

 "pattern_a"

 "pattern_b"

 "pattern_c"

 "pattern_d"

 "pattern_e"

 "error"

 "paper_end"

repeat  "1" to "255"

Element Attribute Specificable Setting Value

160

Chapter 5 Device Specifications

TM-T70

Printer Specifications

Parameter Restrictions

Item 58mm Specification 80mm Specification

Amount of initial feed 30 dots

Initial page mode area

ANK model 416 x 1662 dots 512 x 831 dots

Multiple languages

model

416 x 1662 dots 576 x 1662 dots

Maximum page mode area

ANK model 416 x 1662 dots 512 x 1662 dots

Multiple languages

model

576 x 1662 dots

Baseline of Font A 21 dots from the top of the character

Baseline of Font B 16 dots from the top of the character

Element Attribute Specificable Setting Value

<text>

lang

 "en"

 "de"

 "fr"

 "it"

 "es"

 "ko"

 "ko-kr"

 "zh-hans"

 "zh-cn"

 "zh-hant"

 "zh-tw"

 Language code other than above

font

 "font_a"

 "font_b"

color  "color_1"

<image>

color  "color_1"

mode  "mono"

161

Chapter 5 Device Specifications

type

 "upc_a"

 "upc_e"

 "ean13"

 "jan13"

 "ean8"

 "jan8"

 "code39"

 "itf"

 "codabar"

 "code93"

 "code128"

font

 "font_a"

 "font_b"

type

 "pdf417_standard"

 "pdf417_truncated"

 "qrcode_model_1"

 "qrcode_model_2"

level

 "level_0"

 "level_1" (default value)

 "level_2"

 "level_3"

 "level_4"

 "level_5"

 "level_6"

 "level_7"

 "level_8"

 "level_l"

 "level_m"

 "level_q"

 "level_h"

 "default"

width

 PDF417

 QR Code

height

 PDF417

 QR Code

size

 PDF417

 QR Code

<cut> type

 "no_feed"

 "feed"

Element Attribute Specificable Setting Value

162

Chapter 5 Device Specifications

TM-T70II

Printer Specifications

Parameter Restrictions

Item 58mm Specification 80mm Specification

Amount of initial feed 30 dots

Initial page mode area

ANK model 416 x 1662 dots 512 x 1662 dots

Multiple languages

model

416 x 1662 dots 576 x 1662 dots

Maximum page mode area

ANK model 416 x 1662 dots 512 x 1662 dots

Multiple languages

model

576 x 1662 dots

Baseline of Font A 21 dots from the top of the character

Baseline of Font B 16 dots from the top of the character

Element Attribute Specificable Setting Value

<text>

lang

 "en"

 "de"

 "fr"

 "it"

 "es"

 "ko"

 "ko-kr"

 "zh-hans"

 "zh-cn"

 "zh-hant"

 "zh-tw"

 Language code other than above

font

 "font_a"

 "font_b"

color  "color_1"

<image> color  "color_1"

<barcode> font

 "font_a"

 "font_b"

163

Chapter 5 Device Specifications

type

 "pdf417_standard"

 "pdf417_truncated"

 "qrcode_model_1"

 "qrcode_model_2"

 "maxicode_mode_2"

 "maxicode_mode_3"

 "maxicode_mode_4"

 "maxicode_mode_5"

 "maxicode_mode_6"

 "gs1_databar_stacked"

 "gs1_databar_stacked_omnidirectional"

 "gs1_databar_expanded_stacked"

level

 "level_0"

 "level_1" (default value)

 "level_2"

 "level_3"

 "level_4"

 "level_5"

 "level_6"

 "level_7"

 "level_8"

 "level_l"

 "level_m"

 "level_q"

 "level_h"

 "default"

width

 PDF417

 QR Code

 MaxiCode

 2D GS1 DataBar

height

 PDF417

 QR Code

 MaxiCode

 2D GS1 DataBar

size

 PDF417

 QR Code

 MaxiCode

 2D GS1 DataBar

<cut> type

 "no_feed"

 "feed"

Element Attribute Specificable Setting Value

164

Chapter 5 Device Specifications

<sound>

pattern

 "none"

 "pattern_a"

 "pattern_b"

 "pattern_c"

 "pattern_d"

 "pattern_e"

 "error"

 "paper_end"

repeat  "1" to "255"

Element Attribute Specificable Setting Value

165

Chapter 5 Device Specifications

TM-T82II

Printer Specifications

Parameter Restrictions

Item Specification

Amount of initial feed 30 dots

Initial page mode area 576 x 831 dots

Maximum page mode area 576 x 1662 dots

Baseline of Font A 21 dots from the top of the character

Baseline of Font B 16 dots from the top of the character

Element Attribute Specificable Setting Value

<text>

lang

 "en"

 "de"

 "fr"

 "it"

 "es"

 "zh-hans"

 "zh-cn"

 "zh-hant"

 "zh-tw"

 Language code other than above

font

 "font_a"

 "font_b"

color  "color_1"

<image>

color  "color_1"

mode  "mono"

<barcode> font

 "font_a"

 "font_b"

166

Chapter 5 Device Specifications

type

 "pdf417_standard"

 "pdf417_truncated"

 "qrcode_model_1"

 "qrcode_model_2"

 "maxicode_mode_2"

 "maxicode_mode_3"

 "maxicode_mode_4"

 "maxicode_mode_5"

 "maxicode_mode_6"

 "gs1_databar_stacked"

 "gs1_databar_stacked_omnidirectional"

 "gs1_databar_expanded_stacked"

level

 "level_0"

 "level_1" (default value)

 "level_2"

 "level_3"

 "level_4"

 "level_5"

 "level_6"

 "level_7"

 "level_8"

 "level_l"

 "level_m"

 "level_q"

 "level_h"

 "default"

width

 PDF417

 QR Code

 MaxiCode

 2D GS1 DataBar

height

 PDF417

 QR Code

 MaxiCode

 2D GS1 DataBar

size

 PDF417

 QR Code

 MaxiCode

 2D GS1 DataBar

<cut> type

 "no_feed"

 "feed"

Element Attribute Specificable Setting Value

167

Chapter 5 Device Specifications

<sound>

pattern

 "none"

 "pattern_a"

 "pattern_b"

 "pattern_c"

 "pattern_d"

 "pattern_e"

 "error"

 "paper_end"

repeat  "1" to "255"

Element Attribute Specificable Setting Value

168

Chapter 5 Device Specifications

TM-T83II

Printer Specifications

Parameter Restrictions

Item Specification

Amount of initial feed 30 dots

Initial page mode area 512 x 1662 dots

Maximum page mode area 512 x 1662 dots

Baseline of Font A 21 dots from the top of the character

Baseline of Font B 16 dots from the top of the character

Element Attribute Specificable Setting Value

<text>

lang

 "en"

 "de"

 "fr"

 "it"

 "es"

 "ko"

 "ko-kr"

 Language code other than above

font

 "font_a"

 "font_b"

color  "color_1"

<image>

color  "color_1"

mode  "mono"

<barcode> font

 "font_a"

 "font_b"

169

Chapter 5 Device Specifications

type

 "pdf417_standard"

 "pdf417_truncated"

 "qrcode_model_1"

 "qrcode_model_2"

 "maxicode_mode_2"

 "maxicode_mode_3"

 "maxicode_mode_4"

 "maxicode_mode_5"

 "maxicode_mode_6"

 "gs1_databar_stacked"

 "gs1_databar_stacked_omnidirectional"

 "gs1_databar_expanded_stacked"

level

 "level_0"

 "level_1" (default value)

 "level_2"

 "level_3"

 "level_4"

 "level_5"

 "level_6"

 "level_7"

 "level_8"

 "level_l"

 "level_m"

 "level_q"

 "level_h"

 "default"

width

 PDF417

 QR Code

 MaxiCode

 2D GS1 DataBar

height

 PDF417

 QR Code

 MaxiCode

 2D GS1 DataBar

size

 PDF417

 QR Code

 MaxiCode

 2D GS1 DataBar

<cut> type

 "no_feed"

 "feed"

Element Attribute Specificable Setting Value

170

Chapter 5 Device Specifications

<sound>

pattern

 "none"

 "pattern_a"

 "pattern_b"

 "pattern_c"

 "pattern_d"

 "pattern_e"

 "error"

 "paper_end"

repeat  "1" to "255"

Element Attribute Specificable Setting Value

171

Chapter 5 Device Specifications

TM-T88IV

Printer Specifications

Parameter Restrictions

Item 58mm Specification 80mm Specification

Amount of initial feed 30 dots

Initial page mode area

Monochrome print-

ing

360 x 831 dots 512 x 831 dots

Two-color printing 360 x 415 dots 512 x 415 dots

Maximum page mode area

Monochrome print-

ing

360 x 1662 dots 512 x 1662 dots

Two-color printing 360 x 831 dots 512 x 831 dots

Baseline of Font A 21 dots from the top of the character

Baseline of Font B 16 dots from the top of the character

Element Attribute Specificable Setting Value

<text>

lang

 "en"

 "de"

 "fr"

 "it"

 "es"

 "ko"

 "ko-kr"

 "zh-hans"

 "zh-cn"

 "zh-hant"

 "zh-tw"

 Language code other than above

font

 "font_a"

 "font_b"

color

 "color_1"

 "color_2"

<image>

color

 "color_1"

 "color_2"

mode  "mono"

172

Chapter 5 Device Specifications

type

 "upc_a"

 "upc_e"

 "ean13"

 "jan13"

 "ean8"

 "jan8"

 "code39"

 "itf"

 "codabar"

 "code93"

 "code128"

font

 "font_a"

 "font_b"

type

 "pdf417_standard"

 "pdf417_truncated"

 "qrcode_model_1"

 "qrcode_model_2"

level

 "level_0"

 "level_1" (default value)

 "level_2"

 "level_3"

 "level_4"

 "level_5"

 "level_6"

 "level_7"

 "level_8"

 "level_l"

 "level_m"

 "level_q"

 "level_h"

 "default"

width

 PDF417

 QR Code

height

 PDF417

 QR Code

size

 PDF417

 QR Code

<cut> type

 "no_feed"

 "feed"

Element Attribute Specificable Setting Value

173

Chapter 5 Device Specifications

TM-T88V

Printer Specifications

Parameter Restrictions

Item 58mm Specification 80mm Specification

Amount of initial feed 30 dots

Initial page mode area 360 x 831 dots 512 x 831 dots

Maximum page mode area 360 x 1662 dots 512 x 1662 dots

Baseline of Font A 21 dots from the top of the character

Baseline of Font B

ANK 16 dots from the top of the character

Chinese characters 15 dots from the top of the character

Element Attribute Specificable Setting Value

<text>

lang

 "en"

 "de"

 "fr"

 "it"

 "es"

 "ko"

 "ko-kr"

 "zh-hans"

 "zh-cn"

 "zh-hant"

 "zh-tw"

 Language code other than above

font

 "font_a"

 "font_b"

color  "color_1"

<image> color  "color_1"

<barcode> font

 "font_a"

 "font_b"

174

Chapter 5 Device Specifications

type

 "pdf417_standard"

 "pdf417_truncated"

 "qrcode_model_1"

 "qrcode_model_2"

 "maxicode_mode_2"

 "maxicode_mode_3"

 "maxicode_mode_4"

 "maxicode_mode_5"

 "maxicode_mode_6"

 "gs1_databar_stacked"

 "gs1_databar_stacked_omnidirectional"

 "gs1_databar_expanded_stacked"

level

 "level_0"

 "level_1" (default value)

 "level_2"

 "level_3"

 "level_4"

 "level_5"

 "level_6"

 "level_7"

 "level_8"

 "level_l"

 "level_m"

 "level_q"

 "level_h"

 "default"

width

 PDF417

 QR Code

 MaxiCode

 2D GS1 DataBar

height

 PDF417

 QR Code

 MaxiCode

 2D GS1 DataBar

size

 PDF417

 QR Code

 MaxiCode

 2D GS1 DataBar

<cut> type

 "no_feed"

 "feed"

Element Attribute Specificable Setting Value

175

Chapter 5 Device Specifications

<sound>

pattern

 "none"

 "pattern_a"

 "pattern_b"

 "pattern_c"

 "pattern_d"

 "pattern_e"

 "error"

 "paper_end"

repeat  "1" to "255"

Element Attribute Specificable Setting Value

176

Chapter 5 Device Specifications

TM-T88VI

Printer Specifications

Parameter Restrictions

Item 58mm Specification 80mm Specification

Amount of initial feed 30 dots

Initial page mode area 360 x 831 dots 512 x 831 dots

Maximum page mode area 360 x 1662 dots 512 x 1662 dots

Baseline of Font A 21 dots from the top of the character

Baseline of Font B

ANK 16 dots from the top of the character

Chinese characters 15 dots from the top of the character

Element Attribute Specificable Setting Value

<text>

lang

 "en"

 "de"

 "fr"

 "it"

 "es"

 "ko"

 "ko-kr"

 "zh-hans"

 "zh-cn"

 "zh-hant"

 "zh-tw"

 Language code other than above

font

 "font_a"

 "font_b"

color  "color_1"

<image>

color  "color_1"

mode  "mono"

<barcode> font

 "font_a"

 "font_b"

177

Chapter 5 Device Specifications

<symbol> type

 "pdf417_standard"

 "pdf417_truncated"

 "qrcode_model_1"

 "qrcode_model_2"

 "maxicode_mode_2"

 "maxicode_mode_3"

 "maxicode_mode_4"

 "maxicode_mode_5"

 "maxicode_mode_6"

 "gs1_databar_stacked"

 "gs1_databar_stacked_omnidirectional"

 "gs1_databar_expanded_stacked"

 "azteccode_fullrange"

 "azteccode_compact"

 "datamatrix_square"

 "datamatrix_rectangle_8"

 "datamatrix_rectangle_12"

 "datamatrix_rectangle_16"

<line> style

 "thin"

 "medium"

 "thick"

<rectangle> style

 "thin"

 "medium"

 "thick"

<cut> type

 "no_feed"

 "feed"

<sound>

pattern

 "none"

 "pattern_a"

 "pattern_b"

 "pattern_c"

 "pattern_d"

 "pattern_e"

 "error"

 "paper_end"

repeat  "1" to "255"

Element Attribute Specificable Setting Value

178

Chapter 5 Device Specifications

TM-T90

Printer Specifications

Parameter Restrictions

Item

58mm Specifica-

tion

60mm Specifica-

tion

80mm Specifica-

tion

Amount of initial feed 30 dots

Initial page mode area

Monochrome print-

ing

420 x 738 dots 384 x 831 dots 576 x 738 dots

Two-color printing 420 x 369 dots 384 x 415 dots 576 x 369 dots

Maximum page mode area

Monochrome print-

ing

420 x 1476 dots 384 x 1662 dots 576 x 1476 dots

Two-color printing 420 x 738 dots 384 x 831 dots 576 x 738 dots

Baseline of Font A 21 dots from the top of the character

Baseline of Font B 16 dots from the top of the character

Element Attribute Specificable Setting Value

<text>

lang

 "en"

 "de"

 "fr"

 "it"

 "es"

 "ko"

 "ko-kr"

 "zh-hans"

 "zh-cn"

 "zh-hant"

 "zh-tw"

 Language code other than above

font

 "font_a"

 "font_b"

 "font_c"

color

 "color_1"

 "color_2"

<image>

color

 "color_1"

 "color_2"

mode  "mono"

179

Chapter 5 Device Specifications

type

 "upc_a"

 "upc_e"

 "ean13"

 "jan13"

 "ean8"

 "jan8"

 "code39"

 "itf"

 "codabar"

 "code93"

 "code128"

font

 "font_a"

 "font_b"

 "font_c"

type

 "pdf417_standard"

 "pdf417_truncated"

level

 "level_0"

 "level_1" (default value)

 "level_2"

 "level_3"

 "level_4"

 "level_5"

 "level_6"

 "level_7"

 "level_8"

 "default"

width  PDF417

height  PDF417

size  PDF417

<cut> type

 "no_feed"

 "feed"

Element Attribute Specificable Setting Value

180

Chapter 5 Device Specifications

TM-U220

Printer Specifications

Parameter Restrictions

Item

76mm Specifica-

tion

69.5mm Specifi-

cation

57.5mm Specifi-

cation

Amount of initial feed 12 dots

Element Attribute Specificable Setting Value

<epos-print> force  "false" / "0"

<text>

lang

 "en"

 "de"

 "fr"

 "it"

 "es"

 "ko"

 "ko-kr"

 "zh-hans"

 "zh-cn"

 "zh-hant"

 "zh-tw"

 Language code other than above

font

 "font_a"

 "font_b"

color

 "color_1"

 "color_2"

<image>

color

 "color_1"

 "color_2"

mode  "mono"

<cut> type

 "no_feed"

 "feed"

181

Chapter 5 Device Specifications

TM-U330

Printer Specifications

Parameter Restrictions

Item

76mm Specifica-

tion

69.5mm Specifi-

cation

57.5mm Specifi-

cation

Amount of initial feed 12 dots

Element Attribute Specificable Setting Value

<epos-print> force  "false" / "0"

<text>

lang

 "en"

 "de"

 "fr"

 "it"

 "es"

 "zh-hans"

 "zh-cn"

 Language code other than above

font

 "font_a"

 "font_b"

color

 "color_1"

 "color_2"

<feed> pos  "cutting"

<image>

color

 "color_1"

 "color_2"

mode  "mono"

<cut> type

 "no_feed"

 "feed"

<sound>

pattern

 "none"

 "pattern_a"

 "pattern_b"

 "pattern_c"

 "pattern_d"

 "pattern_e"

 "error"

 "paper_end"

 "pattern_0"

repeat  "1" to "255"

182

Chapter 5 Device Specifications

TM-H6000IV

Printer Specifications

Parameter Restrictions

Item 58mm Specification 80mm Specification

Amount of initial feed 30 dots

Initial page mode area 360 x 831 dots 512 x 831 dots

Maximum page mode area 360 x 1662 dots 512 x 1662 dots

Baseline of Font A 21 dots from the top of the character

Baseline of Font B 16 dots from the top of the character

Element Attribute Specificable Setting Value

<text>

lang

 "en"

 "de"

 "fr"

 "it"

 "es"

 "zh-hans"

 "zh-cn"

 "zh-hant"

 "zh-tw"

 Language code other than above

font

 "font_a"

 "font_b"

color  "color_1"

<image>

color  "color_1"

mode  "mono"

<barcode> font

 "font_a"

 "font_b"

183

Chapter 5 Device Specifications

type

 "pdf417_standard"

 "pdf417_truncated"

 "qrcode_model_1"

 "qrcode_model_2"

 "maxicode_mode_2"

 "maxicode_mode_3"

 "maxicode_mode_4"

 "maxicode_mode_5"

 "maxicode_mode_6"

 "gs1_databar_stacked"

 "gs1_databar_stacked_omnidirectional"

 "gs1_databar_expanded_stacked"

level

 "level_0"

 "level_1" (default value)

 "level_2"

 "level_3"

 "level_4"

 "level_5"

 "level_6"

 "level_7"

 "level_8"

 "level_l"

 "level_m"

 "level_q"

 "level_h"

 "default"

width

 PDF417

 QR Code

 MaxiCode

 2D GS1 DataBar

height

 PDF417

 QR Code

 MaxiCode

 2D GS1 DataBar

size

 PDF417

 QR Code

 MaxiCode

 2D GS1 DataBar

<cut> type

 "no_feed"

 "feed"

Element Attribute Specificable Setting Value

184

Chapter 5 Device Specifications

TM-H6000V

Printer Specifications

Parameter Restrictions

Item Receipt

Amount of initial feed 30 dots

Initial page mode area 512 x 1662 dots

Maximum page mode area 512 x 2400 dots

Baseline of Font A 21 dots from the top of the character

Baseline of Font B 21 dots from the top of the character

Baseline of Font C 18 dots from the top of the character

Element Attribute Specificable Setting Value

<text>

lang

 "en"

 "de"

 "fr"

 "it"

 "es"

 "zh-hant"

 "zh-tw"

 Language code other than above

font

 "font_a"

 "font_b"

 "font_c"

color  "color_1"

<image> color  "color_1"

<barcode> font

 "font_a"

 "font_b"

 "font_c"

185

Chapter 5 Device Specifications

<symbol> type

 "pdf417_standard"

 "pdf417_truncated"

 "qrcode_model_1"

 "qrcode_model_2"

 "maxicode_mode_2"

 "maxicode_mode_3"

 "maxicode_mode_4"

 "maxicode_mode_5"

 "maxicode_mode_6"

 "gs1_databar_stacked"

 "gs1_databar_stacked_omnidirectional"

 "gs1_databar_expanded_stacked"

 "azteccode_fullrange"

 "azteccode_compact"

 "datamatrix_square"

 "datamatrix_rectangle_8"

 "datamatrix_rectangle_12"

 "datamatrix_rectangle_16"

<line> style

 "thin"

 "medium"

 "thick"

<rectangle> style

 "thin"

 "medium"

 "thick"

<cut> type

 "no_feed"

 "feed"

Element Attribute Specificable Setting Value

186

Chapter 5 Device Specifications

TM-L90-i

Printer Specifications

Parameter Restrictions

Item Receipt Specification

Die-cut Label Specifica-

tion

Amount of initial feed 30 dots

Initial page mode area

Monochrome print-

ing

576 x 738 dots 560 x 738 dots

Two-color printing 576 x 369 dots 560 x 369 dots

Maximum page mode area

Monochrome print-

ing

576 x 1476 dots 560 x 1476 dots

Two-color printing 576x 738 dots 560 x 738 dots

Baseline of Font A 21 dots from the top of the character

Baseline of Font B

ANK: 16

Chinese characters: 15 dots from the top of the character

Element Attribute Specificable Setting Value

<text>

lang

 "en"

 "de"

 "fr"

 "it"

 "es"

 "ko"

 "ko-kr"

 "zh-hans"

 "zh-cn"

 "zh-hant"

 "zh-tw"

 Language code other than above

font

 "font_a"

 "font_b"

 "font_c"

color

 "color_1"

 "color_2"

<image>

color

 "color_1"

 "color_2"

mode  "mono"

187

Chapter 5 Device Specifications

type

 "upc_a"

 "upc_e"

 "ean13"

 "jan13"

 "ean8"

 "jan8"

 "code39"

 "itf"

 "codabar"

 "code93"

 "code128"

font

 "font_a"

 "font_b"

Element Attribute Specificable Setting Value

188

Chapter 5 Device Specifications

type

 "pdf417_standard"

 "pdf417_truncated"

 "qrcode_model_1"

 "qrcode_model_2"

 "maxicode_mode_2"

 "maxicode_mode_3"

 "maxicode_mode_4"

 "maxicode_mode_5"

 "maxicode_mode_6"

level

 "level_0"

 "level_1" (default value)

 "level_2"

 "level_3"

 "level_4"

 "level_5"

 "level_6"

 "level_7"

 "level_8"

 "level_l"

 "level_m"

 "level_q"

 "level_h"

 "default"

width

 PDF417

 QR Code

 MaxiCode

height

 PDF417

 QR Code

 MaxiCode

size

 PDF417

 QR Code

 MaxiCode

<cut> type

 "no_feed"

 "feed"

Element Attribute Specificable Setting Value

189

Chapter 5 Device Specifications

TM-T20II-i

Printer Specifications

Parameter Restrictions

Item 58mm Specification 80mm Specification

Amount of initial feed 30 dots

Initial page mode area 420 x 831 dots 576 x 831 dots

Maximum page mode area 420 x 1662 dots 576 x 1662 dots

Baseline of Font A 21 dots from the top of the character

Baseline of Font B 16 dots from the top of the character

Element Attribute Specificable Setting Value

<text>

lang

 "en"

 "de"

 "fr"

 "it"

 "es"

 Language code other than above

font

 "font_a"

 "font_b"

color  "color_1"

<image>

color  "color_1"

mode  "mono"

<barcode> font

 "font_a"

 "font_b"

190

Chapter 5 Device Specifications

type

 "pdf417_standard"

 "pdf417_truncated"

 "qrcode_model_1"

 "qrcode_model_2"

 "maxicode_mode_2"

 "maxicode_mode_3"

 "maxicode_mode_4"

 "maxicode_mode_5"

 "maxicode_mode_6"

 "gs1_databar_stacked"

 "gs1_databar_stacked_omnidirectional"

 "gs1_databar_expanded_stacked"

level

 "level_0"

 "level_1" (default value)

 "level_2"

 "level_3"

 "level_4"

 "level_5"

 "level_6"

 "level_7"

 "level_8"

 "level_l"

 "level_m"

 "level_q"

 "level_h"

 "default"

width

 PDF417

 QR Code

 MaxiCode

 2D GS1 DataBar

height

 PDF417

 QR Code

 MaxiCode

 2D GS1 DataBar

size

 PDF417

 QR Code

 MaxiCode

 2D GS1 DataBar

<cut> type

 "no_feed"

 "feed"

Element Attribute Specificable Setting Value

191

Chapter 5 Device Specifications

<sound> pattern

 "none"

 "pattern_a"

 "pattern_b"

 "pattern_c"

 "pattern_d"

 "pattern_e"

 "error"

 "paper_end"

Element Attribute Specificable Setting Value

192

Chapter 5 Device Specifications

TM-T70-i

Printer Specifications

Parameter Restrictions

Item 58mm Specification 80mm Specification

Amount of initial feed 30 dots

Initial page mode area

ANK model 416 x 1662 dots 512 x 831 dots

Multiple languages

model

416 x 1662 dots 576 x 1662 dots

Maximum page mode area

ANK model 416 x 1662 dots 512 x 1662 dots

Multiple languages

model

416 x 1662 dots 576 x 1662 dots

Baseline of Font A 21 dots from the top of the character

Baseline of Font B 16 dots from the top of the character

Element Attribute Specificable Setting Value

<text>

lang

 "en"

 "de"

 "fr"

 "it"

 "es"

 "ko"

 "ko-kr"

 "zh-hans"

 "zh-cn"

 "zh-hant"

 "zh-tw"

 Language code other than above

font

 "font_a"

 "font_b"

color  "color_1"

<image>

color  "color_1"

mode  "mono"

193

Chapter 5 Device Specifications

type

 "upc_a"

 "upc_e"

 "ean13"

 "jan13"

 "ean8"

 "jan8"

 "code39"

 "itf"

 "codabar"

 "code93"

 "code128"

font

 "font_a"

 "font_b"

type

 "pdf417_standard"

 "pdf417_truncated"

 "qrcode_model_1"

 "qrcode_model_2"

level

 "level_0"

 "level_1" (default value)

 "level_2"

 "level_3"

 "level_4"

 "level_5"

 "level_6"

 "level_7"

 "level_8"

 "level_l"

 "level_m"

 "level_q"

 "level_h"

 "default"

width

 PDF417

 QR Code

height

 PDF417

 QR Code

size

 PDF417

 QR Code

<cut> type

 "no_feed"

 "feed"

Element Attribute Specificable Setting Value

194

Chapter 5 Device Specifications

TM-T82II-i

Printer Specifications

Parameter Restrictions

Item Specification

Amount of initial feed 30 dots

Initial page mode area 576 x 831 dots

Maximum page mode area 576 x 1662 dots

Baseline of Font A 21 dots from the top of the character

Baseline of Font B 16 dots from the top of the character

Element Attribute Specificable Setting Value

<text>

lang

 "en"

 "de"

 "fr"

 "it"

 "es"

 "zh-hans"

 "zh-cn"

 "zh-hant"

 "zh-tw"

 Language code other than above

font

 "font_a"

 "font_b"

color  "color_1"

<image>

color  "color_1"

mode  "mono"

<barcode> font

 "font_a"

 "font_b"

195

Chapter 5 Device Specifications

type

 "pdf417_standard"

 "pdf417_truncated"

 "qrcode_model_1"

 "qrcode_model_2"

 "maxicode_mode_2"

 "maxicode_mode_3"

 "maxicode_mode_4"

 "maxicode_mode_5"

 "maxicode_mode_6"

 "gs1_databar_stacked"

 "gs1_databar_stacked_omnidirectional"

 "gs1_databar_expanded_stacked"

level

 "level_0"

 "level_1" (default value)

 "level_2"

 "level_3"

 "level_4"

 "level_5"

 "level_6"

 "level_7"

 "level_8"

 "level_l"

 "level_m"

 "level_q"

 "level_h"

 "default"

width

 PDF417

 QR Code

 MaxiCode

 2D GS1 DataBar

height

 PDF417

 QR Code

 MaxiCode

 2D GS1 DataBar

size

 PDF417

 QR Code

 MaxiCode

 2D GS1 DataBar

<cut> type

 "no_feed"

 "feed"

Element Attribute Specificable Setting Value

196

Chapter 5 Device Specifications

<sound> pattern

 "none"

 "pattern_a"

 "pattern_b"

 "pattern_c"

 "pattern_d"

 "pattern_e"

 "error"

 "paper_end"

Element Attribute Specificable Setting Value

197

Chapter 5 Device Specifications

TM-T83II-i

Printer Specifications

Parameter Restrictions

Item Specification

Amount of initial feed 30 dots

Initial page mode area 512 x 1662 dots

Maximum page mode area 512 x 1662 dots

Baseline of Font A 21 dots from the top of the character

Baseline of Font B

ANK 16 dots from the top of the character

Chinese characters 15 dots from the top of the character

Element Attribute Specificable Setting Value

<text>

lang

 "en"

 "de"

 "fr"

 "it"

 "es"

 "ko"

 "ko-kr"

 Language code other than above

font

 "font_a"

 "font_b"

color  "color_1"

<image>

color  "color_1"

mode  "mono"

<barcode> font

 "font_a"

 "font_b"

198

Chapter 5 Device Specifications

type

 "pdf417_standard"

 "pdf417_truncated"

 "qrcode_model_1"

 "qrcode_model_2"

 "maxicode_mode_2"

 "maxicode_mode_3"

 "maxicode_mode_4"

 "maxicode_mode_5"

 "maxicode_mode_6"

 "gs1_databar_stacked"

 "gs1_databar_stacked_omnidirectional"

 "gs1_databar_expanded_stacked"

level

 "level_0"

 "level_1" (default value)

 "level_2"

 "level_3"

 "level_4"

 "level_5"

 "level_6"

 "level_7"

 "level_8"

 "level_l"

 "level_m"

 "level_q"

 "level_h"

 "default"

width

 PDF417

 QR Code

 MaxiCode

 2D GS1 DataBar

height

 PDF417

 QR Code

 MaxiCode

 2D GS1 DataBar

size

 PDF417

 QR Code

 MaxiCode

 2D GS1 DataBar

<cut> type

 "no_feed"

 "feed"

Element Attribute Specificable Setting Value

199

Chapter 5 Device Specifications

<sound> pattern

 "none"

 "pattern_a"

 "pattern_b"

 "pattern_c"

 "pattern_d"

 "pattern_e"

 "error"

 "paper_end"

Element Attribute Specificable Setting Value

200

Chapter 5 Device Specifications

TM-T88V-i

Printer Specifications

Parameter Restrictions

Item 58mm Specification 80mm Specification

Amount of initial feed 30 dots

Initial page mode area 360 x 831 dots 512 x 831 dots

Maximum page mode area 360 x 1662 dots 512 x 1662 dots

Baseline of Font A 21 dots from the top of the character

Baseline of Font B

ANK 16 dots from the top of the character

Chinese characters 15 dots from the top of the character

Element Attribute Specificable Setting Value

<text>

lang

 "en"

 "de"

 "fr"

 "it"

 "es"

 "ko"

 "ko-kr"

 "zh-hans"

 "zh-cn"

 "zh-hant"

 "zh-tw"

 Language code other than above

font

 "font_a"

 "font_b"

color  "color_1"

<image> color  "color_1"

<barcode> font

 "font_a"

 "font_b"

201

Chapter 5 Device Specifications

type

 "pdf417_standard"

 "pdf417_truncated"

 "qrcode_model_1"

 "qrcode_model_2"

 "maxicode_mode_2"

 "maxicode_mode_3"

 "maxicode_mode_4"

 "maxicode_mode_5"

 "maxicode_mode_6"

 "gs1_databar_stacked"

 "gs1_databar_stacked_omnidirectional"

 "gs1_databar_expanded_stacked"

level

 "level_0"

 "level_1" (default value)

 "level_2"

 "level_3"

 "level_4"

 "level_5"

 "level_6"

 "level_7"

 "level_8"

 "level_l"

 "level_m"

 "level_q"

 "level_h"

 "default"

width

 PDF417

 QR Code

 MaxiCode

 2D GS1 DataBar

height

 PDF417

 QR Code

 MaxiCode

 2D GS1 DataBar

size

 PDF417

 QR Code

 MaxiCode

 2D GS1 DataBar

<cut> type

 "no_feed"

 "feed"

Element Attribute Specificable Setting Value

202

Chapter 5 Device Specifications

<sound> pattern

 "none"

 "pattern_a"

 "pattern_b"

 "pattern_c"

 "pattern_d"

 "pattern_e"

 "error"

 "paper_end"

Element Attribute Specificable Setting Value

203

Chapter 5 Device Specifications

TM-T88VI-iHUB

Printer Specifications

Parameter Restrictions

Item 58mm Specification 80mm Specification

Amount of initial feed 30 dots

Initial page mode area 360 x 831 dots 512 x 831 dots

Maximum page mode area 360 x 1662 dots 512 x 1662 dots

Baseline of Font A 21 dots from the top of the character

Baseline of Font B

ANK 16 dots from the top of the character

Chinese characters 15 dots from the top of the character

Element Attribute Specificable Setting Value

<text>

lang

 "en"

 "de"

 "fr"

 "it"

 "es"

 "ko"

 "ko-kr"

 "zh-hans"

 "zh-cn"

 "zh-hant"

 "zh-tw"

 Language code other than above

font

 "font_a"

 "font_b"

color  "color_1"

<image>

color  "color_1"

mode  "mono"

<barcode> font

 "font_a"

 "font_b"

204

Chapter 5 Device Specifications

type

 "pdf417_standard"

 "pdf417_truncated"

 "qrcode_model_1"

 "qrcode_model_2"

 "maxicode_mode_2"

 "maxicode_mode_3"

 "maxicode_mode_4"

 "maxicode_mode_5"

 "maxicode_mode_6"

 "gs1_databar_stacked"

 "gs1_databar_stacked_omnidirectional"

 "gs1_databar_expanded_stacked"

level

 "level_0"

 "level_1" (default value)

 "level_2"

 "level_3"

 "level_4"

 "level_5"

 "level_6"

 "level_7"

 "level_8"

 "level_l"

 "level_m"

 "level_q"

 "level_h"

 "default"

width

 PDF417

 QR Code

 MaxiCode

 2D GS1 DataBar

height

 PDF417

 QR Code

 MaxiCode

 2D GS1 DataBar

size

 PDF417

 QR Code

 MaxiCode

 2D GS1 DataBar

<line> style

 "thin"

 "medium"

 "thick"

Element Attribute Specificable Setting Value

205

Chapter 5 Device Specifications

<rectangle> style

 "thin"

 "medium"

 "thick"

<cut> type

 "no_feed"

 "feed"

<sound>

pattern

 "none"

 "pattern_a"

 "pattern_b"

 "pattern_c"

 "pattern_d"

 "pattern_e"

 "error"

 "paper_end"

repeat  "1" to "255"

Element Attribute Specificable Setting Value

206

Chapter 5 Device Specifications

TM-U220-i

Printer Specifications

Parameter Restrictions

Item

76mm Specifica-

tion

69.5mm Specifi-

cation

57.5mm Specifi-

cation

Amount of initial feed 12 dots

Element Attribute Specificable Setting Value

<epos-print> force  "false" / "0"

<text>

lang

 "en"

 "de"

 "fr"

 "it"

 "es"

 "ko"

 "ko-kr"

 "zh-hans"

 "zh-cn"

 "zh-hant"

 "zh-tw"

 Language code other than above

font

 "font_a"

 "font_b"

color

 "color_1"

 "color_2"

<image>

color

 "color_1"

 "color_2"

mode  "mono"

<cut> type

 "no_feed"

 "feed"

207

Chapter 5 Device Specifications

TM-T70II-DT

Printer Specifications

Parameter Restrictions

Item 58mm Specification 80mm Specification

Amount of initial feed 30 dots

Initial page mode area

ANK model 416 x 1662 dots 512 x 1662 dots

Multiple languages

model

416 x 1662 dots 576 x 1662 dots

Maximum page mode area

ANK model 416 x 1662 dots 512 x 1662 dots

Multiple languages

model

416 x 1662 dots 576 x 1662 dots

Baseline of Font A 21 dots from the top of the character

Baseline of Font B 16 dots from the top of the character

Element Attribute Specificable Setting Value

<text>

lang

 "en"

 "de"

 "fr"

 "it"

 "es"

 "ko"

 "ko-kr"

 "zh-hans"

 "zh-cn"

 "zh-hant"

 "zh-tw"

 Language code other than above

font

 "font_a"

 "font_b"

color  "color_1"

<image> color  "color_1"

<barcode> font

 "font_a"

 "font_b"

208

Chapter 5 Device Specifications

type

 "pdf417_standard"

 "pdf417_truncated"

 "qrcode_model_1"

 "qrcode_model_2"

 "maxicode_mode_2"

 "maxicode_mode_3"

 "maxicode_mode_4"

 "maxicode_mode_5"

 "maxicode_mode_6"

 "gs1_databar_stacked"

 "gs1_databar_stacked_omnidirectional"

 "gs1_databar_expanded_stacked"

level

 "level_0"

 "level_1" (default value)

 "level_2"

 "level_3"

 "level_4"

 "level_5"

 "level_6"

 "level_7"

 "level_8"

 "level_l"

 "level_m"

 "level_q"

 "level_h"

 "default"

width

 PDF417

 QR Code

 MaxiCode

 2D GS1 DataBar

height

 PDF417

 QR Code

 MaxiCode

 2D GS1 DataBar

size

 PDF417

 QR Code

 MaxiCode

 2D GS1 DataBar

<cut> type

 "no_feed"

 "feed"

Element Attribute Specificable Setting Value

209

Chapter 5 Device Specifications

<sound> pattern

 "none"

 "pattern_a"

 "pattern_b"

 "pattern_c"

 "pattern_d"

 "pattern_e"

 "error"

 "paper_end"

Element Attribute Specificable Setting Value

210

Chapter 5 Device Specifications

TM-T88V-DT

Printer Specifications

Parameter Restrictions

Item 58mm Specification 80mm Specification

Amount of initial feed 30 dots

Initial page mode area 360 x 831 dots 512 x 831 dots

Maximum page mode area 360 x 1662 dots 512 x 1662 dots

Baseline of Font A 21 dots from the top of the character

Baseline of Font B

ANK 16 dots from the top of the character

Chinese characters 15 dots from the top of the character

Element Attribute Specificable Setting Value

<text>

lang

 "en"

 "de"

 "fr"

 "it"

 "es"

 "ko"

 "ko-kr"

 "zh-hans"

 "zh-cn"

 "zh-hant"

 "zh-tw"

 Language code other than above

font

 "font_a"

 "font_b"

color  "color_1"

<image> color  "color_1"

<barcode> font

 "font_a"

 "font_b"

211

Chapter 5 Device Specifications

type

 "pdf417_standard"

 "pdf417_truncated"

 "qrcode_model_1"

 "qrcode_model_2"

 "maxicode_mode_2"

 "maxicode_mode_3"

 "maxicode_mode_4"

 "maxicode_mode_5"

 "maxicode_mode_6"

 "gs1_databar_stacked"

 "gs1_databar_stacked_omnidirectional"

 "gs1_databar_expanded_stacked"

level

 "level_0"

 "level_1" (default value)

 "level_2"

 "level_3"

 "level_4"

 "level_5"

 "level_6"

 "level_7"

 "level_8"

 "level_l"

 "level_m"

 "level_q"

 "level_h"

 "default"

width

 PDF417

 QR Code

 MaxiCode

 2D GS1 DataBar

height

 PDF417

 QR Code

 MaxiCode

 2D GS1 DataBar

size

 PDF417

 QR Code

 MaxiCode

 2D GS1 DataBar

<cut> type

 "no_feed"

 "feed"

Element Attribute Specificable Setting Value

212

Chapter 5 Device Specifications

<sound> pattern

 "none"

 "pattern_a"

 "pattern_b"

 "pattern_c"

 "pattern_d"

 "pattern_e"

 "error"

 "paper_end"

Element Attribute Specificable Setting Value

213

Chapter 5 Device Specifications

TM-H6000IV-DT

Printer Specifications

Parameter Restrictions

Item 58mm Specification 80mm Specification

Amount of initial feed 30 dots

Initial page mode area 360 x 831 dots 512 x 831 dots

Maximum page mode area 360 x 1662 dots 512 x 1662 dots

Baseline of Font A 21 dots from the top of the character

Baseline of Font B 16 dots from the top of the character

Element Attribute Specificable Setting Value

<text>

lang

 "en"

 "de"

 "fr"

 "it"

 "es"

 "zh-hans"

 "zh-cn"

 "zh-hant"

 "zh-tw"

 Language code other than above

font

 "font_a"

 "font_b"

color  "color_1"

<image>

color  "color_1"

mode  "mono"

<barcode> font

 "font_a"

 "font_b"

214

Chapter 5 Device Specifications

type

 "pdf417_standard"

 "pdf417_truncated"

 "qrcode_model_1"

 "qrcode_model_2"

 "maxicode_mode_2"

 "maxicode_mode_3"

 "maxicode_mode_4"

 "maxicode_mode_5"

 "maxicode_mode_6"

 "gs1_databar_stacked"

 "gs1_databar_stacked_omnidirectional"

 "gs1_databar_expanded_stacked"

level

 "level_0"

 "level_1" (default value)

 "level_2"

 "level_3"

 "level_4"

 "level_5"

 "level_6"

 "level_7"

 "level_8"

 "level_l"

 "level_m"

 "level_q"

 "level_h"

 "default"

width

 PDF417

 QR Code

 MaxiCode

 2D GS1 DataBar

height

 PDF417

 QR Code

 MaxiCode

 2D GS1 DataBar

size

 PDF417

 QR Code

 MaxiCode

 2D GS1 DataBar

<cut> type

 "no_feed"

 "feed"

Element Attribute Specificable Setting Value

215

Chapter 5 Device Specifications

Usage Restrictions by Firmware Version

The following shows the elements and their attributes that can be used only for the printers with the specific

firmware version.

For instructions on how to check or update the printer firmware version, refer to the Technical Reference Guide of

the printer.

❏ Can be used with ePOS-Print Service Ver.2.1 or later

❏ Can be used with ePOS-Print Service Ver.2.2 or later

❏ Can be used with ePOS-Print Service Ver.3.0 or later

Element Attribute Attribute value

<feed> pos -

Element Attribute Attribute value

<text> lang

zh-hans

zh-hant

<layout> --

type

azteccode_fullrange

azteccode_compact

datamatrix_square

datamatrix_rectangle_8

datamatrix_rectangle_12

datamatrix_rectangle_16

level Integer (5 to 95)

<sound>

pattern

pattern_1

pattern_2

pattern_3

pattern_4

pattern_5

pattern_6

pattern_7

pattern_8

pattern_9

pattern_10

cycle -

Element Attribute Attribute value

<epos-print> force -

216

Chapter 5 Device Specifications

❏ Can be used with ePOS-Print Service Ver.3.2 or later

❏ Can be used with ePOS-Print Service Ver.4.1 or later

❏ Can be used with ePOS-Print Service Ver.5.0 or later

<text> y -

<recovery> --

<reset> --

Element Attribute Attribute value

<text> font

font_d

font_e

<barcode> font

font_d

font_e

Element Attribute Attribute value

code

EX_SPOOLER

JobNotFound

Printing

status 0x80000000

<symbol> type qrcode_micro

Element Attribute Attribute value

<sound> pattern pattern_0

Element Attribute Attribute value

217

Chapter 5 Device Specifications

ePOS-Print Settings

Printer Model Printing Method Character Code Tables

TM-L90 Thermal (203 dpi) Page 0-5, 16-19

TM-L90 4xx Thermal (203 dpi) Page 0-5, 16-19, 20-21, 26, 30-31, 11-15, 32-53

TM-m10 Thermal (203 dpi) Page 0-5, 16-19, 20-21, 26,30-31, 11-15, 32-53

TM-m30 Thermal (203 dpi) Page 0-5, 16-19, 20-21, 26,30-31, 11-15, 32-53

TM-T20II Thermal (203 dpi) Page 0-5, 16-19, 20-21, 26,30-31, 11-15, 32-53

TM-T70 Thermal (180 dpi) Page 0-5, 16-19

TM-T70II Thermal (203 dpi) Page 0-5, 16-19, 20-21, 26,30-31, 11-15, 32-53

TM-T88IV Thermal (180 dpi) Page 0-5, 16-19

TM-T88V Thermal (180 dpi) Page 0-5, 16-19, 20-21, 26,30-31, 11-15, 32-53

TM-T90 Thermal (180 dpi) Page 0-5, 16-19

218

Chapter 6 Development Information for Customer Displays

Development Information for Customer Displays

This chapter describes the necessary information for controlling customer displays.

Overview - Differential Information

This section contains differential information about Chapter 1 "Overview" regarding the control of the customer

display. See Chapter 1 if necessary.

Interface

The end point addresses for customer display control on each interface are listed below.

❏ SOAP/HTTP Interface

http://[IP address of the Printer]/cgi-bin/eposDisp/service.cgi?devid=[device ID]&timeout=[timeout time]

❏ SOAP/HTTP Interface (WSDL supported)

http://[IP address of the Printer]/cgi-bin/eposDisp/service.cgi

❏ Interface for FileMaker

httppost://[IP address of the Printer]/cgi-bin/eposDisp/service.cgi?printdata=[SOAP message]

WSDL(Web Services Description Language)

The files for accessing the customer display are listed below.

File name: epos-display-x.x.x.wsdl

epos-display-x.x.x.xsd

Restrictions

❏ You cannot confirm if a customer display is connected or if it was displayed.

❏ When controlling customer displays using more than one terminals or applications, the last display data sent

from one of them is displayed overwriting previous ones.

219

Chapter 6 Development Information for Customer Displays

XML Schemas

The file name of the XML schema for customer display control is given below.

❏ epos-display-x.x.x.xsd

Namespace

The namespaces for customer display control are listed below.

Command

The command for customer display control are listed below.

Provided Article

The following files for customer display control are included in the sample program package.

❏ epos-display-x.x.x.wsdl (ePOS-Print XML Print Service)

❏ epos-display-x.x.x.xsd (ePOS-Print XML Schemas)

Identifier Namespace

(Default) http://www.epson-pos.com/schemas/2012/09/epos-display

tns http://www.epson-pos.com/schemas/2012/09/epos-display

xs http://www.w3.org/2001/XMLSchema

Item Description

Window Settings for creating and deleting windows and moving the current window

Character ANK

Character style Shading, display position

Cursor Settings for cursor location and display settings

Blink Settings for screen blinking

Brightness Settings for the customer display brightness

Marquee Settings for character string marquees

Clock Time display

Clear Clears the current window display

Reset Resets the customer display

Command Executes the ESC/POS command

220

Chapter 6 Development Information for Customer Displays

Programming Guide (XML Print Service)

This section explains the programing methods for application development with ePOS-Print XML.

How to Use XML Schemas

In XML schemas, the configuration method is the same; only the TM printer files and file names are different.

See the How to Use XML Schemas (p.41), change the file name and configure the settings.

❏ XML schema file for TM printer

epos-print-x.x.x.xsd

❏ XML Schema file for customer display

epos-display-x.x.x.xsd

Creating and Sending the Documents to be Displayed

Create a print document using elements in the epos-print root element. For details on elements, refer to XML for

Controlling Customer Display (p.116).

Send the document you created with the XMLHttpRequest object.

Use the constructor to create an XMLHttpRequest object, specify the end point address of the customer display

to be shown in the send method, specify the document to be displayed and send it.

For details on the end point address of the customer display, see Customer Display End Point Address (p.223).

Since the end point addresses of the TM printer and the customer display are different, printing with the TM

printer and accessing the customer display cannot be carried out for the same document.

221

Chapter 6 Development Information for Customer Displays

To Call SOAP/HTTP Interface

Refer to the following program.

<!DOCTYPE html>

<html>

<head>

<title>TITLE</title>

function sendDocument() {

// Create a display document

var request = '<epos-display xmlns="http://www.epson-pos.com/schemas/2012/09/

epos-display">';

request += '<reset/>';

request += '<cursor type="none"/>';

request += '<marquee format="place" repeat="0" uwait="500" rwait="2000">Thanks for

coming!</marquee>';

request += '</epos-display>';

// Create display parameters

var param = '<parameter xmlns="http://www.epson-pos.com/schemas/2012/09/epos-

display">';

param += '<devid>local_display</devid>';

param += '<timeout>10000</timeout>';

param += '<printjobid>ABC123</printjobid>';

param += '</parameter>';

// Create a SOAP envelop

var soap = '<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">' +

'<s:Header>' + param + '</s:Header> + '<s:Body>' + request +



'</s:Body></s:Envelope>';

// Create an XMLHttpRequest object

var xhr = new XMLHttpRequest();

// Set the end point address

var url = 'http://192.168.192.168/cgi-bin/eposDisp/

service.cgi?devid=local_display&timeout=10000';

// Open an XMLHttpRequest object

xhr.open('POST', url, true);

// <Header settings>

xhr.setRequestHeader('Content-Type', 'text/xml; charset=utf-8');

xhr.setRequestHeader('If-Modified-Since', 'Thu, 01 Jan 1970 00:00:00 GMT');

xhr.setRequestHeader('SOAPAction', '""');

//Set a callback function

xhr.onreadystatechange = function () {

if (xhr.readyState == 4) {

if (xhr.status == 200) {

//Obtain the response root element

var res = xhr.responseXML;

var success = res.getElementsByTagName('response')[0].getAttribute('success');

//When the displaying is not successful, display a message

if (!/^(1|true)$/.test(success)) {

alert('A display error occurred');

}

// Send display document

xhr.send(soap);

}

</script>

</head>

<body>

</body>

</html>

222

Chapter 6 Development Information for Customer Displays

To Call SOAP/HTTP Interface (WSDL supported)

Refer to the following program.

<!DOCTYPE html>

<html>

<head>

<title>TITLE</title>

function sendDocument() {

// Create a display document

var request = '<epos-display xmlns="http://www.epson-pos.com/schemas/2012/09/

epos-display">';

request += '<reset/>';

request += '<cursor type="none"/>';

request += '<marquee format="place" repeat="0" uwait="500" rwait="2000">Thanks for

coming!</marquee>';

request += '</epos-display>';

// Create a print parameter

var param = '<parameter xmlns="http://www.epson-pos.com/schemas/2012/09/epos-

display">';

param += '<devid>local_display</devid>';

param += '<timeout>10000</timeout>';

param += '<printjobid>ABC123</printjobid>';

param += '</parameter>';

// Create a SOAP envelop

var soap = '<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">' +

'<s:Header>' + param + '</s:Header> + '<s:Body>' + request +



'</s:Body></s:Envelope>';

// Create an XMLHttpRequest object

var xhr = new XMLHttpRequest();

// Set the end point address

var url = 'http://192.168.192.168/cgi-bin/eposDisp/service.cgi';

// Open an XMLHttpRequest object

xhr.open('POST', url, true);

// <Header settings>

xhr.setRequestHeader('Content-Type', 'text/xml; charset=utf-8');

xhr.setRequestHeader('If-Modified-Since', 'Thu, 01 Jan 1970 00:00:00 GMT');

xhr.setRequestHeader('SOAPAction', '""');

//Set a callback function

xhr.onreadystatechange = function () {

if (xhr.readyState == 4) {

if (xhr.status == 200) {

//Obtain the response root element

var res = xhr.responseXML;

var success = res.getElementsByTagName('response')[0].getAttribute('success');

//When the displaying is not successful, display a message

if (!/^(1|true)$/.test(success)) {

alert('A display error occurred');

}

// Send display document

xhr.send(soap);

}

</script>

</head>

<body>

</body>

</html>

223

Chapter 6 Development Information for Customer Displays

Customer Display End Point Address

Specify the customer display end point address in the following format:

To Call SOAP/HTTP Interface

http://[IP address]/cgi-bin/eposDisp/service.cgi?devid=[device ID]&timeout=[timeout time]

To Call SOAP/HTTP Interface (WSDL supported)

http://[IP address]/cgi-bin/eposDisp/service.cgi

Items to specify Description

IP address Specify the IP address or the domain name of the TM printer connected to the customer

display.

Device ID The device ID of the customer display is fixed to "local_display".

Timeout period Specifies the time to abort the process in milliseconds. The maximum value is 300

seconds (300000).

The timeout parameter is optional; when it is omitted, 60 seconds (60000) is set.

When the timeout period elapses, the print job is canceled; the data already interpreted

by the printer before the start of the print abort process is printed.

For SOAP/HTTP Interface (WSDL supported), the device ID and timeout time are specified in the SOAP

header.

224

Chapter 6 Development Information for Customer Displays

Specifying the Print Job ID from the Application

A response containing the specified print job ID will be returned when sending a request from the application by

specifying the print job ID.

Programming Example

Request

Response

<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">

<s:Header>

<devid>local_display</devid>

</parameter>

</s:Header>

<s:Body>

<epos-display xmlns="http://www.epson-pos.com/schemas/2012/09/epos-display">

<text>Hello, World!</text>

</epos-display>

</s:Body>

</s:Envelope>

<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">

<s:Header>

<devid>local_printer</devid>

</parameter>

</s:Header>

<s:Body>

<response xmlns="http://www.epson-pos.com/schemas/2012/09/epos-display"

success="true" code="" status="0" />

</s:Body>

</s:Envelope>

Job ID : ABC123

Response data

Job ID : ABC122

Response data

Job ID : ABC123

Display data

Job ID : ABC122

Print data

225

Chapter 6 Development Information for Customer Displays

How to Use WSDL

This section describes how to generate client codes (proxy class) from WSDL by using the tool provided in the

development environment.

How to use WSDL

Procedure

From the command prompt, execute Svcutil.exe and create the following files:

❏ ePOSDisplay.cs (WCF contract)

❏ output.config (application configuration file)

Start Visual Studio and create a new project.

(Project example: console application)

Add a class file to the project.

(File to be added: ePOSDisplay.cs)

Add a reference to the project.

(Assembly to be added: System.ServiceModel)

Edit the application configuration file.

(File to be edited: App.config)

❏ Open output.config and copy the <system.serviceModel> element.

❏ Change the end point address in accordance with the printer.

This section uses the following cases as examples:

• How to use WSDL (p.225)

• Java (p.227)

Item Description

Tool ServiceModel Metadata Utility Tool (Svcutil.exe)

Command > svcutil.exe epos-display-x.x.x.wsdl epos-display-x.x.x.xsd

For details about the Svcutil.exe tool, refer to the following Web site (as of September, 2015):

https://msdn.microsoft.com/en-us/library/aa347733.aspx

226

Chapter 6 Development Information for Customer Displays

Create and execute a program to call XML Print Service.

Editing example (File to be edited: Program.cs)

namespace ConsoleApplication1

{

class Program

{

static void Main(string[] args)

{

ePOSDisplayPortTypeClient client = new ePOSDisplayPortTypeClient();

parameter param = new parameter();

param.printjobid = "ABC123";

param.devid = "local_display";

param.timeout = "60000";

reset r = new reset();

cursor c = new cursor();

c.type = cursortypetype.none;

c.typeSpecified = true;

marquee m = new marquee();

m.format = marqueeformattype.place;

m.formatSpecified = true;

m.repeat = "0";

m.uwait = "500";

m.rwait = "2000";

m.Value = "Thanks for coming!";

object[] epos = new object[] { r, c, m };

response res = client.send(ref param, epos);

Console.WriteLine(res.success);

Console.WriteLine(res.code);

Console.ReadLine();

}

227

Chapter 6 Development Information for Customer Displays

Java

Item Description

Tool JAX-WS wsimport tool

Command wsimport epos-display-x.x.x.wsdlv

For details about the JAX-WS wsimport tool, refer to following Web site (as of September, 2015):

http://docs.oracle.com/javase/8/docs/technotes/tools/windows/wsimport.html

228

Appendix

ePOS-Print Editor

This section describes how to use ePOS-Print Editor included in the contents in the package.

This tool is a support tool for generating XML data. This tool allows you to create an ePOS-Print XML (p. 64) print

document as you like. In addition, the generated XML data can be printed for testing. Use this tool for your

application development.

ePOS-Print Editor Operating Environment

Web Browser

 Windows Internet Explorer 9 or later

 Mozilla Firefox 13 or later

 Google Chrome 19 or later

 Apple Safari 5.1.7 or later

 iPad Safari in iOS 5.1 or later

Environment Setting Procedure

Copy the editor folder contained in the sample program to the Web server.

Open the following URL page using the Web browser.

http://[Web server IP address]/editor/index.html

 In Google Chrome, when a preview image including pictures is displayed, a "SECURITY_ERR: DOM

Exception 18" error occurs.

 In Windows Internet Explorer 9, when printing is performed, a "SCRIPT5: Access is denied." error occurs.

If opening a page with ePOS-Print Editor's HTML file placed on the local disk, some functionality does not

operate due to your Web browser's security policy. Place the HTML file of ePOS Editor to a folder under Web

server.

229

Appendix

ePOS-Print Editor appears.

230

Appendix

Setting

Perform the print setting and the preview setting. Select the [Setting] tab to display the Setting screen.

*1 TM-DT Software Ver.3.0 or later/TM-i firmware Ver.4.1 or later/TM-T88VI

*2 Printers that support HTTPS (Printer Functions (p.14))

Item Description

Model

Specify the model of the printer to be used for printing.

The Preview screen resizes according to the paper width set to the

model.

IP address of ePOS-Print supported TM printer

Specify the IP address of the printer.

Be sure to specify this item.

Device ID of the target printer

Specify the device ID of the printer.

Be sure to specify this item.

Print timeout (milliseconds)

Specify the print timeout time in milliseconds.

The maximum value is 60000 (60 seconds).

Monitor the status When this checkbox is checked, the printer's status is monitored.

Drawer open status

Change this according to the specifications of the drawer that you

are using.

Use print job ID

Check this for a print job ID to be assigned when printing.

Use HTTPS

Check this to use HTTPS to communicate with the printer to print.

231

Appendix

Creating a Sample Code

Select the [Edit] tab to display the Edit screen. Create an ePOS-Print XML print document in the Edit screen.

Item Description

Menu area

Displays the available functions.

Click an icon to add it to the bottom of the edit area, and drag an icon to insert it anywhere

in the edit area.

Edit area

Displays the functions selected in the menu area.

Drag an element to change its position. An element can be deleted using the x button

located on its right side.

Import

ePOS-Print Editor can import an ePOS-Print XML print document.

For details, refer to Import (p.234).

Clear Deletes the edited details.

Forced Transmission Sets forced transmission mode.

Edit area

Menu area

232

Appendix

Create XML data as follows:

Click an icon in the menu area to add an element in the edit area.

The position of the added function can be changed by dragging.

Configure the added element.

Example: When the NV logo is added, set the key code.

Select the [Preview] tab to check the preview image.

When a printer is connected, you can also check the image by printing.

For details, refer to Print (p.233).

Select the [XML] tab. The ePOS-Print XML document is displayed. Use it by copying.

Save the ePOS-Print XML print document, and you can edit it by importing it again.

 Logo printing, barcode printing, 2D code printing, ESC command, buzzer sound, drawer kick, and

paper cut are displayed as icons.

 The layout may change depending on the preview settings. (For details, refer to Setting (p.230)).

233

Appendix

Using the printer, print the ePOS-Print XML print document according to the printer's settings to perform test

printing.

(For details on the printer settings, refer to Setting (p.230)).

Perform printing as follows:

Select the [Print] tab.

Check the content in the [Data to be sent (ePOS-Print XML)] box and press the [Send] button.

The ePOS-Print XML print document created using the Edit tab page is displayed in "Data to be sent (ePOS-Print XML)".

The print document is printed to ePOS-Print supported TM printer. 

The acquired status is displayed in the Information box.

Item Description

Data to be sent (ePOS-Print XML) The ePOS-Print XML document is displayed.

Send Sends data to the printer and performs printing.

Information Displays the print status.

Clear Deletes the content in the [Information] box.

234

Appendix

Import

ePOS-Print Editor can import an ePOS-Print XML print document.

This function is used to edit the already created ePOS-Print XML print document.

ePOS-Print Editor can import an ePOS-Print XML print document as follows:

Select the [Edit] tab and click the [Import] button.

The "Import" screen appears. Paste the ePOS-Print XML print document in the [Data to be import

(ePOS-Print XML)] box.

Click the [Apply] button.

The "Confirmation" screen appears. Click the [Yes] button.

Item Description

Data to be import

(ePOS-Print XML)

Pastes the ePOS-Print XML print document.

Apply Imports the ePOS-Print XML print document.

Information Displays the import information.

Close Closes the Import screen.

235

Appendix

Encoding Graphic Data

Use ePOS-Print Editor to convert raster graphic bit-image data into a base 64 encoded character string.

How to Use ePOS-Print Editor

Create data as follows:

Store the image file you want to print into the same level as the index of this tool.

Start ePOS-Print Editor.

Select the [Image] icon in the menu area and add it in the edit area.

Specify the name of the stored image file for "Image File (on the Server Side)" and click the

[Load] button.

Specify values as needed for "Scale to Fit Paper Width", "Mode", "Brightness", "Color", and

"Halftone".

236

Appendix

Select the [XML] tab.

Code converted into a base 64 encoded character string is displayed in [ePOS-Print XML Print

Document]. Copy the desired character string for use.

Epson C31CD38124 TM-T70II POS Receipt Printer

Product's Documents

ePOS-Print XML User's Manual

Specifications

Epson C31CD38124 Questions and Answers

Related Products

Epson C31CH61A9671 OmniLink TM-T70II-DT2 Thermal POS Printer with Integrated PC

Epson C31CH51A9972 TM-T20III Thermal Receipt Printer

Epson TM-T88VI C31ce94531 , , Thermal Receipt Printer, Black, Ethernet, Bluetooth Interfaces

Epson C31CJ27022 , Tm-m30ii, Thermal Receipt Printer, Autocutter, Usb, Ethernet, Black, Energy Star

Epson TM-T88V Direct Thermal Receipt Printer PAR Plus USB EDG PWR Energy Star, Monochrome, 5.8" Height x 5.7" Width x 7.7" DepthPARALLEL/USB MODEL

Epson C31CK01002 EU-m30 Kiosk Thermal Receipt Printer