Epson TM-T20II-i Technical Reference Guide

Download

Describes how to control the printer and necessary information when you develop applications.

Describes setup and installation of the product and peripherals.

Describes how to handle the product.

Describes general specifications and character code tables.

Describes features for the product.

Technical Reference Guide

Product Overview

Setup

Application Development Information

Handling

Appendix

M00075604

Rev. E

Cautions

• No part of this document may be reproduced, stored in a retrieval system, or transmitted in any form or by any means, electronic, mechanical, photocopying, recording, or otherwise, without the prior written permission of Seiko Epson Corporation.

• The contents of this document are subject to change without notice. Please contact us for the latest information.

• While every precaution has been taken in the preparation of this document, Seiko Epson Corporation assumes no responsibility for errors or omissions.

• Neither is any liability assumed for damages resulting from the use of the information contained herein.

• Neither Seiko Epson Corporation nor its affiliates shall be liable to the purchaser of this product or third parties for damages, losses, costs, or expenses incurred by the purchaser or third parties as a result of: accident, misuse, or abuse of this product or unauthorized modifications, repairs, or alterations to this product, or (excluding the U.S.) failure to strictly comply with Seiko Epson Corporation’s operating and maintenance instructions.

• Seiko Epson Corporation shall not be liable against any damages or problems arising from the use of any options or any consumable products other than those designated as Original Epson Products or Epson Approved Products by Seiko Epson Corporation.

Trademarks

EPSON is a registered trademark of Seiko Epson Corporation.

Exceed Your Vision and ESC/POS are registered trademarks or trademarks of Seiko Epson Corporation.

Windows countries.

microSD is registered trademarks of SD Card Association.

Wi-Fi

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

AndroidTM is a trademark of Google Inc.

IOS license.

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

is registered trademarks or trademarks of Microsoft Corporation in the United States and other

, WPATM, and WPA2TM are either registered trademarks or trademarks of Wi-Fi Alliance®.

is a trademark or registered trademark of Cisco in the U.S. and other countries and is used under

ESC/POS® Command System

Epson ESC/POS is a proprietary POS printer command system that includes patented or patent-pending commands.

ESC/POS is compatible with most Epson POS printers and displays.

ESC/POS is designed to reduce the processing load on the host computer in POS environments. It comprises a set of highly functional and efficient commands and also offers the flexibility to easily make future upgrades.

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.

You must follow warnings carefully to avoid serious bodily injury.

WARNING

Provides information that must be observed to prevent damage to the equipment or loss of data.

CAUTION

 Possibility of sustaining physical injuries.  Possibility of causing physical damage.  Possibility of causing information loss.

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

Provides important information and useful tips.

Warnings

WARNING

 To avoid risk of electric shock, do not set up this product or handle cables during a

thunderstorm

 Never insert or disconnect the power plug with wet hands.

Doing so may result in electric shock.

 Handle the power cable with care.

Improper handling may lead to fire or electric shock.

 Do not modify or attempt to repair the cable.  Do not place any heavy object on top of the cable.  Avoid excessive bending, twisting, and pulling.  Do not place the cable near heating equipment.  Check that the plug is clean before plugging it in.  Be sure to push the plug all the way in.

 Be sure to use the specified power source.

Connection to an improper power source may cause fire or electric shock.

 Do not place multiple loads on the power outlet.

Overloading the outlet may lead to fire.

 Shut down your equipment immediately if it produces smoke, a strange odor, or

unusual noise.

Continued use may lead to fire. Immediately unplug the equipment and contact your dealer or a Seiko Epson service center for advice.

 Never attempt to repair this product yourself.

Improper repair work can be dangerous.

 Never disassemble or modify this product.

Tampering with this product may result in injury or fire.

 Do not allow foreign matter to fall into the equipment.

Penetration by foreign objects may lead to fire.

 If water or other liquid spills into this equipment, do not continue to use it.

Continued use may lead to fire. Unplug the power cord immediately and contact your dealer or a Seiko Epson service center for advice.

 Do not use aerosol sprayers containing flammable gas inside or around this product.

Doing so may cause fire.

Cautions

 Do not connect cables in ways other than those mentioned in this manual.

Different connections may cause equipment damage or fire.

CAUTION

 Be sure to set this equipment on a firm, stable, horizontal surface.

The product may break or cause injury if it falls.

 Do not use this product in locations subject to high humidity or dust levels.

Excessive humidity and dust may cause equipment damage or fire.

 Do not place heavy objects on top of this product. Never stand or lean on this product.

Equipment may fall or collapse, causing breakage and possible injury.

 Take care not to injure your fingers on the manual cutter

 When you remove printed paper  When you perform other operations such as loading/replacing roll paper

 Do not open the roll paper cover without taking the necessary precautions, as this can

result in injury from the autocutter fixed blade.

 To ensure safety, unplug this product before leaving it unused for an extended period.  Do not knock or strike the printer. This may cause defective print.  Do not catch cables or place foreign matter under the printer.  Use the UL-approved peripherals (only for North American users).

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/precisio

n 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. B ec ause this product was not inten

ded for use in applications requiring extremely

high reliability/safety, s uch 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 aft

er a full evaluation.

About this Manual

Aim of the Manual

This manual aims to provide all the information necessary for the development, design, and

installment of POS systems, order entry systems, and other receipt issuing systems that use TM-

T20II-i.

Manual Content

The manual is made up of the following sections:

Chapter 1

Chapter 2

Chapter 3

Chapter 4

Appendix

Product Overview

Setup

Application Development Information

Handling

Product Specifications

Option Specifications

Setting Items for Software Setting Mode

Character Code Tables

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

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

Warnings ................................................................................................................................................. 4

Cautions.................................................................................................................................................. 5

■ Restriction of Use.................................................................................................................. 5

■ About this Manual................................................................................................................ 6

Aim of the Manual ................................................................................................................................. 6

Manual Content .................................................................................................................................... 6

■ Contents................................................................................................................................ 7

Product Overview ........................................................................11

■ Features............................................................................................................................... 11

■ Product Configurations...................................................................................................... 13

Bundled items....................................................................................................................................... 13

Options.................................................................................................................................................. 13

■ Part Names and Functions ................................................................................................ 14

Power Switch ........................................................................................................................................ 14

Power Switch Cover............................................................................................................................. 14

Roll paper cover / Cover open lever................................................................................................. 15

Cutter cover ......................................................................................................................................... 15

Control Panel........................................................................................................................................ 15

Interfaces.............................................................................................................................................. 16

Status LED.............................................................................................................................................. 17

Push Button ........................................................................................................................................... 17

Wired LAN Status LED........................................................................................................................... 18

Wireless LAN cable set (optional) LED ............................................................................................... 18

■ Online and Offline..............................................................................................................19

Online .................................................................................................................................................... 19

Offline .................................................................................................................................................... 19

■ Error Status........................................................................................................................... 20

Automatically Recoverable Errors...................................................................................................... 20

Recoverable Errors............................................................................................................................... 20

Unrecoverable Errors ........................................................................................................................... 21

■ NV Memory ........................................................................................................................ 22

NV Graphics Memory .......................................................................................................................... 22

Memory Switches (Customized Value)..............................................................................................22

R/E (Receipt Enhancement) .............................................................................................................. 22

Maintenance Counter ........................................................................................................................ 22

Setup .............................................................................................23

■ Flow of Setup ...................................................................................................................... 23

■ Installing the Product ......................................................................................................... 28

Installing the product Vertically .......................................................................................................... 29

Hanging the product on a Wall..........................................................................................................30

■ Changing the Paper Width................................................................................................ 32

■ Installing the microSD Card............................................................................................... 33

■ Connecting the Product to the Network .......................................................................... 34

For Wired LAN connection ..................................................................................................................34

For Wireless LAN Interface ................................................................................................................... 34

■ Connecting the Peripherals .............................................................................................. 37

Connecting the Customer Display.....................................................................................................37

Connecting the Optional External Buzzer .........................................................................................38

Connecting the Serial Communication Device ...............................................................................41

Key Input Device via a USB Interface.................................................................................................41

Connecting the Cash Drawer.............................................................................................................42

■ Connecting the AC Adapter............................................................................................. 43

■ Attaching the Power Switch Cover................................................................................... 44

■ Setting the Memory Switches/Receipt Enhancement.................................................... 45

Functions ...............................................................................................................................................46

■ Network Setting .................................................................................................................. 54

Confirming Network Setting ................................................................................................................56

Initializing the Network Setting ............................................................................................................57

■ Enabling PHP....................................................................................................................... 59

■ Enabling HTTPS Communication....................................................................................... 60

■ Settings for Server Direct Print ........................................................................................... 61

■ Setting for Connected Devices......................................................................................... 62

■ Registering Web Contents................................................................................................. 64

Creating Web Contents ......................................................................................................................64

Specifications for when PHP is enabled.............................................................................................65

Verifying the integrity of Web contents with md5 files .....................................................................66

Certificate files ...................................................................................................................................... 66

Registering Web Contents...................................................................................................................67

■ Settings for Spooler............................................................................................................. 69

■ Settings for Print Forwarding .............................................................................................. 70

■ Settings for Device Data Notification ............................................................................... 71

Application Development Information...................................... 73

■ Controlling the Printer ........................................................................................................ 73

Epson ePOS SDK ...................................................................................................................................74

ePOS-Device XML.................................................................................................................................75

ePOS-Print XML......................................................................................................................................77

Server Direct Print .................................................................................................................................78

Device Data Notification.....................................................................................................................79

Web Server............................................................................................................................................80

Spooler and Print Forwarding..............................................................................................................81

■ Software and Manuals....................................................................................................... 84

How to Get Manuals and the Utility ...................................................................................................85

■ EPSON TMNet WebConfig .................................................................................................. 86

Starting EPSON TMNet WebConfig..................................................................................................... 86

Help Screen Display ............................................................................................................................. 86

Version Screen Display ........................................................................................................................ 86

General Information ............................................................................................................................ 87

Information - Wired - TCP/IP................................................................................................................ 88

Information - Wireless - TCP/IP ............................................................................................................ 88

Information - Web Contents ............................................................................................................... 89

Information - Time ................................................................................................................................ 89

Web Service Settings - Device Admin - Printer ................................................................................. 90

Web Service Settings - Device Admin - Customer Display.............................................................. 91

Web Service Settings - Device Admin - Key Input Device .............................................................. 92

Web Service Settings - Device Admin - Serial Communication Device........................................ 92

Web Service Settings - Device Admin - Search Printer.................................................................... 93

Web Service Settings - Spooler - Settings .......................................................................................... 93

Web Service Settings - Spooler - Print forwarding ............................................................................ 94

Web Service Settings - Web Contents - Update Settings ................................................................ 95

Web Service Settings - Server Access - Direct Print.......................................................................... 96

Web Service Settings - Server Access - Status Notification ............................................................. 97

Web Service Settings - Server Access - Device Data Notification ................................................. 98

System Settings - Network - Wired ...................................................................................................... 99

System Settings - Network - Wired - TCP/IP........................................................................................ 99

System Settings - Network - Wireless................................................................................................. 100

System Settings - Network - Wireless - TCP/IP .................................................................................. 101

System Settings - Security - Authenticate Server ............................................................................ 101

System Settings - Security - SSL.......................................................................................................... 102

System Settings - Proxy - Proxy .......................................................................................................... 103

System Settings - Time - Time ............................................................................................................ 103

Admin Settings - Maintenance - Reset............................................................................................ 104

Admin Settings - Administrator Information - Administrator .......................................................... 104

Admin Settings - Administrator Information - Password ................................................................. 104

PHP settings......................................................................................................................................... 105

■ Status sheet....................................................................................................................... 106

■ Setting/Checking Modes ................................................................................................ 112

Self-test Mode .................................................................................................................................... 112

NV Graphics Print Mode ................................................................................................................... 113

Receipt Enhancement Information Print Mode ............................................................................. 114

Software Setting Mode...................................................................................................................... 115

Hexadecimal Dumping Mode ......................................................................................................... 118

■ Easy Setup......................................................................................................................... 119

■ Checking/Updating TM-i Firmware ................................................................................ 120

Checking the TM-i Firmware Version................................................................................................ 120

Updating TM-i Firmware .................................................................................................................... 120

Handling .....................................................................................121

■ Installing and Replacing Roll Paper ............................................................................... 121

■ Removing Jammed Paper .............................................................................................. 123

■ Cleaning the Printer ......................................................................................................... 125

Cleaning the Printer Case................................................................................................................. 125

Cleaning the Thermal Head/Platen Roller ...................................................................................... 125

■ Preparing for Transport..................................................................................................... 126

Appendix.................................................................................... 127

■ Product Specifications..................................................................................................... 127

Software Specifications .....................................................................................................................128

Controllable Peripherals ....................................................................................................................129

Printing Specifications ........................................................................................................................130

Character Specifications...................................................................................................................131

Printable Area .....................................................................................................................................132

Printing and Cutting Positions............................................................................................................133

Paper Specifications ..........................................................................................................................133

Electrical Characteristics ...................................................................................................................134

Environmental Conditions..................................................................................................................135

External Dimensions and Mass ..........................................................................................................136

AC Adapter.........................................................................................................................................137

■ Option Specifications ...................................................................................................... 137

Wireless LAN Cable Set (OT-WL01)....................................................................................................137

Customer Display (DM-D110 ) ...........................................................................................................137

■ Setting Items for Software Setting Mode ........................................................................ 138

■ Character Code Tables ................................................................................................... 140

Chapter 1 Product Overview

Product Overview

This chapter describes features of the product.

Features

TM-T20II-i is a receipt printer which can print directly from a smart device application or Web

application.

This product supports ePOS-Device

peripherals or network compatible TM printers.

*1: ePOS-Device: Epson original technology to control TM printers or POS peripherals via a smart

device application or Web application. This technology is realized by ePOS-Device Service

running on the products.

and ePOS-Print *2 and are capable of controlling POS

*2: ePOS-Print: Epson original printing function t

systems supported by XML and Web services. This technology is realized by the ePOS-Print

Service running on the products.

hat has a high compatibility with a variety of

Functions

•Enables connection to peripherals (customer displays, barcode scanners, etc) via a USB or serial

interface.

•The Epson ePOS SDK is provided for iOS, Android and Windows application, and Web

application development.

The Epson ePOS SDK is a software development kit that integrates the ePOS-Print SDK and the

ePOS-Device SDK. It is recommended

SDK is migrated to the Epson ePOS SDK. For detail, refer to the Migration Guide included with

the Epson ePOS SDK.

• Uses the communication box

function allows for communications, etc. between tablet terminals. (ePOS-Device SDK,

ePOS-Device XML)

•Supports Server Direct Print that sends a request for print data from the product to the Web server

at regular

intervals.

•Since print data can be saved in the spooler, applications can be released from processing print

jobs regardless of the printer status.

•When a network printer is registered, print forwarding process can be realized. Also, if the printer

is not ready to print, you can print from another printer.

that application software developed with the ePOS-Device

function to enable communications between applications. This

•Device data notification function is realized, allowing for notifications to be sent from devices

such as barcode scanners to Web servers to trigger applications.

•Equipped with Web server that supports the scripting language "PHP" and database "SQLite3".

•Enables HTTPS *2 communication.

•Supports TLS1.2. SSL3.0 is not supported.

*1: For more information on the communication box, see the User's Manuals for the Epson ePOS

SDK, or the ePOS-Device XML User's Manual.

*2: TM-i firmware Ver. 4.3 or later.

*3: TM-i firmware Ver. 4.4 or later.

For information on how to use these functions, see "Controlling the Printer" on page 73.

Product Configurations

Bundled items

•AC adapter

•AC cable *

• Roll paper (for operation check)

•58 mm width roll paper guide

•Power switch cover

•Waterproof power switch cover

•Start Here

•Manual CD

• Wall-hanging bracket

•Screws for installing the wall-hanging bracket

Chapter 1 Product Overview

•Rubber feet for vertical installation

•Switch panel for vertical installation

* May not be included depending on the areas and models.

Options

•Affixing tape for fixing the printer (Model: DF-10)

•Buzzer unit (Model: OT-BZ20)

•Wireless LAN cable set (Model: OT-WL01)

•Customer display (Model: DM-D110)

Part Names and Functions

Roll paper cover

Control panel

Cover open lever

Power switch

Cutter cover

Power switch cover

Manual cutter

Power Switch

Turns the printer on or off. The marks on the switch: ( : OFF/ : ON)

A waterproof cover for the power switch is also included.

Before turning on the product, be sure to check that the AC adapter is connected to the power supply.

CAUTION

After the product is turned on, it requires about 30 seconds until it is ready to print.

Power Switch Cover

Install the power switch cover that comes with the TM-T20II-i onto the printer to prevent

inadvertent changing of the power switch, to prevent tampering, and to improve the appearance of

the printer.

To op erate the power switch, insert an object with a pointed tip such as a ballpoint pen into the hole

on the power switch cover.

If an accident occurs with the power switch cover attached, unplug the power cord immediately.

WARNING

Continued use of the printer may cause fire or electric shock.

Use the waterproof power switch cover if the printer is installed in a humid location or exposed to water. If current leakage occurs, it could result in electric shock.

Chapter 1 Product Overview

(Power) LED

Error LED

Paper LED

Feed button

Roll paper cover / Cover open lever

When setting or replacing the roll paper, use the cover open lever to open the roll paper cover.

Do not open the roll paper cover during printing or while the autocutter is operating.

Cutter cover

The autocutter is inside the cutter cover. Open the cover when roll paper is jammed in the printer or

to return the cutter blade manually.

Control Panel

Name Status Description

(Power) LED On Power is being supplied.

Off Power is not being supplied.

Error LED Off Normal operation (online)

On  Immediately after the power is turned on or immediately after a reset

(offline). Automatically goes off after a while to indicate that the printer is ready.

 The end of the roll paper is detected, and when printing has stopped

(offline). If this happens, replace the roll paper.

Flashing An error has occurred

(For details about the flash codes, see

Paper LED Off There is a sufficient amount of roll paper remaining.

On There is little or no roll paper remaining.

Flashing A self-test printing standby state and macro execution standby state

Feed button Pressing this button once feeds the roll paper by one line. Holding this button down

feeds the roll paper continuously.

"Error Status" on page 20.)

Interfaces

Drawer kick

connector

DC-in connector

Ethernet port

USB host ports

Serial port

Protective cover

micro SD card slot

USB device port

Name Description

Drawer kick connector Connects a cash drawer or the optional buzzer unit.

Ethernet port Connect the LAN cable here to connect to the network.

USB host port (Type A) Connects peripherals via a USB interface.

USB device port (Type B) Connects a computer when setting the product with TM-T20II Utility.

DC-In connector Connects a AC adapter.

microSD card slot Used when using the PHP function.

Serial port Connects a serial communication device.

 When connecting USB interface devices, make sure to check the devices or manuals,

etc. for current consumption. The total value should be 800 mA or less. Never use

CAUTION

devices that provide no information on current consumption.

 Make sure that the protective cover is securely fit into place while the product is oper-

ating.

 For Ethernet ports, make sure that the outdoor aerial LAN cables are connected

through a surge protector. Failure to do so may lead to device error resulting from indirect lightning.

For the Micro-USB port, use a Micro-USB (Type Micro-B) cable.

Chapter 1 Product Overview

Status LED

Push button

Status LED

With the status LED on the rear of the product, you can check the interface board status.

LED Description

On (Green) Operating normally.

On (Orange) Starting up.

If the status LED is on in orange even after 30 seconds have passed since the printer is turned on, repair is required.

Off Power is not turned on.

If the status LED is off even if the printer is turned on, repair is required.

Push Button

Press the push button with a thin object such as a tweezers.

The push button has the following functions:

•Status sheet printing:

Make sure the product is turned on, press the push button for approximately 3 seconds. When you

release the button, a status sheet on which net

"Confirming with a status sheet" on page 56.)

work parameters are printed will be ejected. (See

•Initialization:

Make sure the product is turned on, press the push button for approximately 10 seconds. When

you release the button, network setting (Wired LAN/ Wireless LAN) will be initialized. (See

"Initializing the Network Setting" on page 57.)

To print a status sheet, release the push button within 10 seconds. If the button is kept down for 10 seconds or more, the network setting will be initialized.

 Press the push button after the status LED color has changed from orange to green. After

the printer is turned on, it takes about 20 to 30 seconds until the status LED color changes to green.

 Even if the button is pressed while the status LED is on in orange, the button will not operate.

Wired LAN Status LED

LED (Green)

LED (Yellow)

LED (Green)

With the Wired LAN Status LED on the rear of the product, you can check the communication status

of the product.

LED Status Description

Green On Link established

Flashing Transmitting/receiving data

Off Link not established

Yellow On 100BASE-TX

Off 10BASE-T

Wireless LAN cable set (optional) LED

With the LED on the wireless LAN unit, you can check the communication status of the product.

LED Description

Off The wireless LAN unit is not connected to the product. Or the product power is OFF.

Flashing This wireless LAN unit is connected to the product and is in operation.

Flashing rapidly

This wireless LAN unit is connected to the product and is in operation. This unit is communicating on a network.

Chapter 1 Product Overview

Online and Offline

Online

When no events to go offline have occurred, the printer is online and ready for normal printing.

Offline

The printer automatically goes offline under the following conditions:

•During power on (including resetting with the interface) until the printer is ready

•During the self-test

•When the roll paper cover is open.

•While roll paper is fed using the Feed button.

•When printing stops due to end of paper. (When

paper)

• Macro execution standby state

•When an error has occurred

the roll paper end sensor detects the end of

Error Status

LED ON

LED OFF

Approx. 160 ms

Approx. 2560 ms

There are three possible error types: automatically recoverable errors, recoverable errors, and

unrecoverable errors. Check the error LED flash code.

When connection to peripherals fails, check the status LEDs at the lower rear of the product.

Automatically Recoverable Errors

Printing is no longer possible when automatically recoverable errors occur. They ca n be recovered

easily, as described below.

Error Error description Error LED flash code Recovery measure

Roll paper cover open error

Print head temperature error

The roll paper cover was opened during printing.

A high temperature outside the head drive operating range was

LED ON

LED OFF

LED ON

LED OFF

Approx. 160 ms

Recovers automatically when the roll paper cover is closed.

Recovers automatically when the print head cools.

detected.

Recoverable Errors

Printing is no longer possible when recoverable errors occur. They can be recovered easily by turning

the power on again after eliminating the cause of the error.

Error Error description Error LED flash code Recovery measure

Autocutter error Autocutter does not

work correctly.

Remove the jammed paper or foreign matter in the printer, close the roll paper cover, and then turn the power on to recover.

Chapter 1 Product Overview

LED ON

LED OFF

Approx. 160 ms

LED ON

LED OFF

Approx. 160 ms

LED ON

LED OFF

Approx. 160 ms

LED ON

LED OFF

Approx. 160 ms

LED ON

LED OFF

Approx. 160 ms

Approx. 2560 ms

Unrecoverable Errors

If the same error occurs again even after turning the power back on, contact your dealer or a Epson

service center.

Turn off the power immediately when unrecoverable errors occur.

CAUTION

Error Error description Error LED flash code

Memory R/W error After R/W checking, the printer does not

work correctly.

High voltage error The power supply voltage is extremely high.

Low voltage error The power supply voltage is extremely low.

CPU execution error The CPU is executing an incorrect address.

Internal circuit

Internal circuits are not connected correctly.

connection error

NV Memory

The product's NV memory (Non-Volatile Memory) stores data even after the product power is

turned off. NV memory contains the following memory areas for the user:

•NV graphics memory

•Memory switches (customized value)

•R/E (Receipt Enhancement)

•Maintenance counter

As a guide, NV memory rewriting should be 10 times or less a day when you program applications.

CAUTION

NV Graphics Memory

Graphics, such as shop logos to be printed on receipts, can be stored.

Use the TM-T20II Utility to register graphics.

To ch eck the registered graphics, select [Operation Check] - [Print Logo] in TM-T20II Utility.

 For detailed information about the TM-T20II Utility, see the TM-T20II Utility User’s Manual.  For information about how to use the NV graphics memory print mode, see

Print Mode" on page 113

"NV Graphics

Memory Switches (Customized Value)

With the memory switches (customized value), which are software switches for the product, you can

set paper width, print density, f ont, power supply unit capacity, automatic paper cut, and paper

reduction. See

"Setting the Memory Switches/Receipt Enhancement" on page 45.

R/E (Receipt Enhancement)

Graphics, such as shop logos can be printed on top or bottom of receipts by setting R/E (Receipt

Enhancement). For information about R/E, see

Enhancement" on page 45

"Setting the Memory Switches/Receipt

Maintenance Counter

With this function, printer information, such as the number of line feeds, the number of autocuts and

product operation time after the printer starts working, is automatically stored in NV memory. You

can read the information with the TM-T20II Utility or in a self-test to

part replacement.

use it for periodical checks or

Chapter 2 Setup

Setup

This chapter describes the installation and setup procedure of the product and peripherals required

to use the product.

Yo u can utilize "Easy Setup", which enables settings to the TM-i to be made in a simple manner using

a USB memory that contains a file of EPSON TMNet WebC on fig setting values.

For detail, refer the “TM-i series Easy Setup Guide”.

Flow of Setup

The setting items are different depending on the system to be used. Check the items by referring to

"Controlling the Printer" on page 73.

•Epson ePOS SDK, ePOS-Device XML, ePOS-Print XML (

•Server Direct Print (page 25)

•Device Data Notification (page 26)

•Using This Product as a Web Server (

This chapter consists of the following sections along with the setup flow of the product and

peripherals.

In this setup flow, necessary items are in a frame with a solid line. Optional items are explained in an frame with a dotted line.

page 27)

page 24)

Epson ePOS SDK, ePOS-Device XML, ePOS-Print XML

7. Setting the Memory Switches/Receipt Enhancement (page 45)

Settings for EPSON TMNet WebConfig

1. Installing the Product (page 28)

Settings for Printer

2. Changing the Paper Width (page 32)

3. Connecting the Peripherals (page 37)

4. Connecting the Product to the Network (page 34)

5. Connecting the AC Adapter (page 43)

6. Attaching the Power Switch Cover (page 44)

8. Network Setting (page 54)

9. Enabling HTTPS Communication (page 60)

10. Setting for Connected Devices (page 62)

11. Settings for Spooler (page 69)

12. Settings for Print Forwarding (page 70)

Server Direct Print

7. Setting the Memory Switches/Receipt Enhancement (page 45)

Settings for EPSON TMNet WebConfig

1. Installing the Product (page 28)

Settings for Printer

2. Changing the Paper Width (page 32)

3. Connecting the Peripherals (page 37)

4. Connecting the Product to the Network (page 34)

5. Connecting the AC Adapter (page 43)

6. Attaching the Power Switch Cover (page 44)

8. Network Setting (page 54)

10. Setting for Connected Devices (page 62)

11. Settings for Spooler (page 69)

12. Settings for Print Forwarding (page 70)

9. Settings for Server Direct Print (page 61)

Chapter 2 Setup

Device Data Notification

7. Setting the Memory Switches/Receipt Enhancement (page 45)

Settings for EPSON TMNet WebConfig

1. Installing the Product (page 28)

Settings for Printer

2. Changing the Paper Width (page 32)

3. Connecting the Peripherals (page 37)

4. Connecting the Product to the Network (page 34)

5. Connecting the AC Adapter (page 43)

6. Attaching the Power Switch Cover (page 44)

8. Network Setting (page 54)

9. Setting for Connected Devices (page 62)

10. Settings for Device Data Notification (page 71)

Using This Product as a Web Server

Settings for Printer

Settings for EPSON TMNet WebConfig

1. Installing the Product (page 28)

2. Changing the Paper Width (page 32)

3. Connecting the Peripherals (page 37)

5. Connecting the Product to the Network (page 34)

6. Connecting the AC Adapter (page 43)

7. Attaching the Power Switch Cover (page 44)

8. Setting the Memory Switches/Receipt Enhancement (page 45)

9. Network Setting (page 54)

12. Registering Web Contents (page 64)

11. Enabling PHP (page 59)

4. Installing the microSD Card (page 33)

Ava ilable when PHP is enabled.

10. Enabling HTTPS Communication (page 60)

Chapter 2 Setup

Installing the Product

Horizontal Installation Vertical Installation Hanging Installation

You can install the product horizontally on a flat surface (with the paper exit on top) or vertically

(with the paper exit at the front). Also, you can hang it on a wall using the included accessories.

 Take measures to prevent the product from moving by vibration during paper cutting and

when using a drawer. Affixing tape (Model: DF-10) is provided as an option.

 Do not place the product in dusty locations.  Do not knock or strike the product. This may cause defective print.  Do not catch cables or foreign matter under the product.

Chapter 2 Setup

Control panel label for vertical installation

Rubber feet

Installing the product Vertically

When installing the product vertically, be sure to attach the included control panel label for vertical

installation on the roll paper cover, and attach 4 rubber feet in the rectangular indents in the product

case, as shown in the illustration below.

Vertical installation

Yo u can install the product so that the roll paper cover is upright to the mounting surface using the

included wall hanging bracket.

Attach the control panel label for vertical installation on the roll paper

cover.

Install the wall hanging bracket on the product, and fix it using 2 included

screws.

Attach 2 rubber feet in the rectangular indents in the product case, and

attach 2 rubber feet within the scribed line on the hanging bracket.

Place the product with the wall-hanging-bracket-side down.

Control panel label for vertical installation

Rubber feet

207 mm {8.15"}

Wall hanging bracket

Hanging the product on a Wall

Control panel label for vertical installation

To ha ng the product on the wall, follow the steps below.

 To fix the product securely, hang the product on a wall made of wood, concrete, or metal.  The thickness of the wall should be 10 mm or more.  Be sure to use metallic screws.  The screws on the wall side must have a pull-out strength of 150 N (15.3 kgf) or more.

Attach the included control panel label for vertical installation on the roll

paper cover.

Install 2 screws (screw diameter: 4 mm, head diameter: 7 to 9 mm) in the

wall at an interval of 80 mm.

Make sure the length of the screw's body in the wall is 10 mm or more, and the length outside the wall is 3 to 4 mm.

Remove the screws retaining the printer case, install the wall hanging

bracket on the product, and fix it using the screws.

Chapter 2 Setup

Screws

Align the holes in the wall hanging bracket with the screws on the wall, and

hook it securely.

Wall hanging bracket

Changing the Paper Width

You can change the paper width from 80 to 58 mm by installing the included 58-mm width paper

guide plate. Follow the steps below to change the paper width.

Because some parts of the print head and the autocutter contact the platen and they may become worn out, once you change the paper width from 80 to 58 mm and use the product, you cannot change it back to 80 mm.

Open the roll paper cover.

Align 3 projections on the 58-mm width paper guide plate with the

rectangular holes in the product, and push it downwards.

Roll paper guide

Rectangular holes

Make the setting for the paper width with the memory switch.

For information about the memory switch, see "Setting the Memory Switches/Receipt

Enhancement" on page 45

Installing the microSD Card

Install the microSD card into the microSD card slot on the rear of the product.

Use a microSD card that has wear leveling functions

 The microSD card can only be used if the PHP function is enabled.  The spooler cannot be used if PHP is enabled.

Installing the microSD Card

Open the protective cover on this product. Check the insertion direction of

the microSD card and insert it into the microSD card slot.

 Insert the microSD card with its metal side facing down.  Push the microSD card to the bottom until it clicks.

Chapter 2 Setup

Close the protective cover.

Removing the microSD Card

Open the protective cover on this product and gently push the microSD

card into the slot.

Push the microSD card to the bottom until it clicks.

When the microSD card is slightly ejected, pull it out carefully.

Close the protective cover.

Connecting the Product to the Network

For Wired LAN connection

Connect the product to a network by a LAN cable via a hub.

Insert a 10BASE-T/100BASE-TX LAN cable into the LAN connector until it clicks.

 When LAN cables are installed outdoors, make sure devices without proper surge

protection are cushioned by being connected through devices that do have surge

CAUTION

For Wireless LAN Interface

The optional wireless LAN cable set (OT-W01) enables you to use the product with a wireless LAN

connection.

Be sure not to connect a LAN cable when you use the wireless LAN cable set.

protection. Otherwise, the devices can be damaged by lightning.

 Never attempt to connect the customer display cable, drawer kick cable, or a standard

telephone line cable to the LAN connector.

This product cannot be used with the wired LAN connection and wireless LAN connection at the same time. When the product is set and installed for both of them, only the LAN connection works.

Check whether the following items are included.

•Wireless LAN unit

•USB extension cable

•Affixing tape (1 pair, 2 pieces)

•Rubber cover

•Cauti

• User’s manual

To co nnect the wireless LAN unit to the product, you can connect directly or use the USB extension

cable.

If connecting the wireless LAN unit directly causes interference with other cables or bad

communication, use the included USB extension cable.

on label

Connecting the unit directly with the product

USB port

Install the wireless LAN unit to a USB port of the product.

Using the USB extension cable

Attach the included rubber cover to the connector of the USB extension

cable into which the wireless LAN unit will be inserted, to prevent the unit from coming off.

Chapter 2 Setup

Insert the wireless LAN unit into the connector of the cable.

Adjust the position of the rubber cover so that the description on the label on the back side of the wireless LAN unit is not covered.

Connect the USB extension cable to the USB port of the product.

If you want to fix the wireless LAN unit, cut the included affixing tape to fit and put on the unit, and fix the unit in a place with good communication.

Chapter 2 Setup

Connecting the Peripherals

Connect each cable of a peripheral to a port or connector at the rear of the product.

 When connecting USB interface devices, make sure to check the devices or manuals,

etc. for current consumption. The total value should be 800 mA or less. Never use

CAUTION

Connecting the Customer Display

For details on connecting the customer display, refer to the "DM-D110/DM-D210 Technical

Reference Guide".

Use EPSON TMNet WebC onfig to configure customer display settings and perform display tests.

devices that provide no information on current consumption.

 Make sure that the protective cover is securely fit into place while the product is oper-

ating.

For detail, refer to

"Setting for Connected Devices" on page 62.

Connecting the Optional External Buzzer

Optional external buzzer

Affixing tape (1 pair, 2 pieces)

User’s Manual

You can use the optional external buzzer (OT-BZ20) by connecting it to the drawer kick connector.

 The optional external buzzer and the drawer cannot be used together at the same time.  If you configure the memory switch (customized value) setting to enable the optional external

buzzer, the drawer cannot be opened because the pulse is not sent to the drawer kick connector pin.

 Make sure to use the accessory affixing tape (hook and loop fastener) to attach the optional

external buzzer to the product.

 Be careful not to spill water, oil, solvent, or any other liquid over the product. Doing so may

result in malfunction of the product.

Check whether the following items are included.

Installation Position

This product is recommended to be installed on either side of the product.

 Do not install the optional external buzzer at the roll paper exit.  To prevent liquid from entering inside, it is recommended to install the optional external

buzzer so that the volume adjustment knob is positioned sideways or downward. (For details of the volume adjustment knob, see

"Adjusting the Buzzer Volume" on page 40.)

Chapter 2 Setup

Affixing tape

Drawer kick connector

Installation Procedures

Turn off the product.

Connect and disconnect the optional external buzzer while the product is turned off. If you connect it while the product is turned on, the buzzer does not function correctly.

Clean and dry the printer case where the optional external buzzer will be

installed.

With 2 pieces of the affixing tape combined, peel off the sticker on one

side, and paste it around the center of the attaching surface of the optional external buzzer.

Connect the cable of the optional external buzzer to the drawer kick

connector on the product.

Do not connect both the optional external buzzer and the drawer by using a splitter or similar device.

Peel off the sticker on the other side of the affixing tape, and attach and fix

Printer case

Volume adjustment knob

High

Low

the optional external buzzer to the printer case.

Turn on the product.

When and how to beep can be set by TM-T20II Utility or the product's

customized value. (See "Setting the Memory Switches/Receipt

Enhancement" on page 45)

 To use this product, be sure to enable the optional external buzzer with the product

setting. For the details on the setting, see "Setting the Memory Switches/Receipt

Enhancement" on page 45

 When the optional external buzzer is enabled with the product setting, the drawer

cannot be driven.

Adjusting the Buzzer Volume

Turn the volume adjustment knob to adjust the buzzer volume.

Chapter 2 Setup

Connecting the Serial Communication Device

Use a serial cable to connect a device to the serial port of this product.

To co mmunicate with a serial communication device, communication conditions of the device

should match those of this product.

Refer to the manual for the serial communication device to check the following con

•Communication Speed

•Data bit

•Parity

•Stop bit

•Flow control

The communication conditions of this product are configured using EPSON TMNet WebC onfig.

For detail, refer to

"Setting for Connected Devices" on page 62.

ditions.

Key Input Device via a USB Interface

For key input devices such as barcode scanners and keyboards, connect a USB cable of a device to

the USB port at the rear of this product.

Use EPSON TMNet WebC onfig to select a device control script and perform communication tests.

For detail, refer to

"Setting for Connected Devices" on page 62.

Connecting the Cash Drawer

Drawer kick connector

With shielded

Drawer kick connector

Printer side

User side [Drawer kick side]

Drawer open/close switch

Drawer kick solenoid

Control device

Using the optional product for TM printer is recommended.

If the optional external buzzer is used, you cannot use a cash drawer.

 Specifications of drawers differ depending on makers or models. When you use a

drawer other than specified, make sure its specification meets the following

WARNING

conditions.

Otherwise, devices may be damaged.  The load, such as a drawer kick solenoid, must be connected between pins 4 and 2 or pins

4 and 5 of the drawer kick connector.

 When the drawer open/close signal is used, a switch must be provided between drawer

kick connector pins 3 and 6.

 The resistance of the load, such as a drawer kick solenoid, must be 24

input current must be 1A or less.

 Be sure to use the 24V power output on drawer kick connector pin 4 for driving the equip-

ment.

 Use a shielded cable for the drawer connector cable.  Two driver transistors cannot be energized simultaneously.  Leave intervals longer than 4 times the drawer driving pulse when sending it

continuously.

 Be sure to use the product power supply (connector pin 4) for the drawer power

source.

 Do not insert a telephone line into the drawer kick connector.

Doing so may damage the telephone line or product.

 or more or the

Connect the connector of the drawer kick cable to the product.

Drawer Connection Circuitry

F. G

+24V

Connecting the AC Adapter

DC-in connector

 Be sure to use the included AC adapter as the power supply unit.

Using a nonstandard power supply can result in electric shock and fire.

WARNING

Make sure that the power is turned off, and connect the AC adapter in the following steps.

 Should a fault ever occur in the included AC adapter, immediately turn off the power

to the product and unplug the power supply cable from the wall socket.

 Be sure to unplug the power supply unit’s cable from the wall socket whenever

connecting or disconnecting the power supply unit to the product.

Failure to do so may result in damage to the power supply unit or the product.

 Make sure the wall socket power supply satisfies the rated voltage requirements of

the power supply unit. Never insert the power supply cable plug into a socket that does not meet the rated voltage requirements of the power supply unit.

Doing so may result in damage to both the power supply and the product.

Chapter 2 Setup

Push the DC connectors of the AC adapter all the way into the DC-In

connectors of the product.

Push the connector of the power code all the way into the AC inlet of the

AC adapter.

Push the power plug all the way into the grounded outlet.

Place the AC adapter with the label facing down.

Attaching the Power Switch Cover

Power switch cover

Power switch cover (Waterproof)

Install the power switch cover that comes with the TM-T20II-i onto the product to prevent

inadvertent changing of the power switch, to prevent tampering, and to improve the appearance of

the product.

To op erate the power switch, insert an object with a pointed tip such as a ballpoint pen into the hole

the power switch cover.

To de tach the cover, also use a sharp-pointed object.

WARNING

If an accident occurs with the power switch cover attached, unplug the power cord immediately.

Continued use of the product may cause fire or electric shock.

Chapter 2 Setup

Setting the Memory Switches/Receipt Enhancement

With the memory switch and R/E (receipt enhancement) function, which are software settings for

this printer, you can set the various functions.

For an outline of the functions, see the following section. Use the methods shown in the table below;

TM-T20II Utility or Software Setting Mode to se

t the memory switches and R/E functions.

Function TM-T20II Utility

Receive buffer capacity

Processing when data receive error

BUSY condition

Auto line feed

USB power-saving function

Release condition of receive buffer BUSY

Memory Switches

Error signal output

Paper width

Print density

Print speed

Character code table default

International character default

Interface selection

Software Setting

Mode

- ✔

✔✔

Power supply unit capacity

Number of columns

Autocutting after closing cover

Customized Values

Paper reduction

Font A auto replacement

Font B auto replacement

Optional buzzer

Logo 180 dpi emulation mode

USB Interface Settings

Interface Settings

✔✔

- ✔

✔✔

Auto top logo

Function TM-T20II Utility

Software Setting

Mode

✔ -

Auto bottom logo

Auto top/bottom logo extended functions

Receipt Enhancement

dpi: dots per inch

*1: No settings are required.

*2: Do not change the settings.

*3: Excluding some function.

 For information about the TM-T20II Utility, see the TM-T20II Utility User’s Manual.  To directly configure the product in the software setting mode, see

on page 115.

Functions

Receive buffer capacity

✔ -

"Software Setting Mode"

•4 KB (initial setting)

•45 bytes

Processing when data receive error

•Prints “?” (initial setting)

•Ignored

No settings are required.

BUSY condition

•Receive buffer full/Offline

•Receive buffer full (initial setting)

Do not change the settings.

Chapter 2 Setup

Auto line feed

•Always enabled (initial setting)

•Always disabled

No settings are required.

USB power-saving function

•Disabled

•Enabled (initial setting)

Release condition of receive buffer BUSY

• Releases when the remaining receive buffer capacity becomes 256 bytes (initial setting)

• Releases when the remaining receive buffer capacity becomes 138 bytes

This function is enabled only when Receive buffer capacity is set to 4 KB.

Error signal output

•Enabled (initial setting)

•Disabled

No settings are required.

Paper width

•80 mm (initial setting)

•58 mm

To change the paper width, you need to install the 58-mm width paper guide plate. For information about how to change the paper width, see

"Changing the Paper Width" on page 32.

Print density

Selectable from levels 1 to 7 (85% ~ 115%).

Initial setting: level 4 (100%)

Depending on the paper type, it is recommended to set the print density as shown in the table

below for the best print quality.

Original Paper type Density Level

P350, AF50KS-E, KT55F20, KT48F20 4 (100%)

F5041 5 (105%)

When the print density level is increased, printing speed may be reduced.

Print speed

Selectable from levels 1 to 13 (Slow ~ Fast)

Initial setting: level 13

Depending on print conditions, such as print duty, print head temperature, and data transmission speed, print speed is automatically adjusted, which may cause white lines due to intermittent print (the motor sometimes stops). To avoid this, keep the print speed constant by setting it lower, or set the transmission speed higher for the serial interface.

Character code table default

Selectable from 43 pages

Initial setting: Page 0 (PC437: USA, Standard Europe)

No settings are required.

International character default

Selectable from 18 sets

Initial setting: USA

No settings are required.

Interface selection

Interface is fixed.

Do not change the settings.

Power supply unit capacity

Selectable from levels 1 to 3 (Low ~ High)

Initial setting: level 3

Number of columns

•Standard mode (initial setting)

•42 column mode

Autocutting after closing cover

•Cuts (initial setting)

•Does not cut

Chapter 2 Setup

Paper reduction

Extra upper space reduction

•Disabled (initial setting)

•Enabled

Extra lower space reduction

•Disabled (initial setting)

•Enabled

Line space reduction rate

•Not reduced (initial setting)

•25%

•50%

•75%

Line feed reduction rate

•Not reduced (initial setting)

•25%

•50%

•75%

Barcode height reduction rate

•Not reduced (initial setting)

•25%

•50%

•75%

Font A auto replacement

•Does not replace (initial setting)

•Font B

This function is enabled only when Number of columns is set to Standard mode.

Font B auto replacement

•Does not replace (initial setting)

•Font A

This function is enabled only when Number of columns is set to Standard mode.

Optional buzzer

 For information about how to connect the optional external buzzer, see "Connecting the

Optional External Buzzer" on page 38

 When the optional external buzzer is enabled, a cash drawer cannot be used. Be sure to

disable it when you use a cash drawer.

Enables/disables

•Disabled (initial setting)

•Enabled

Buzzer frequency (Error)

•Does not sound

•Sounds 1 time

•Sounds continuously (initial setting)

Sound pattern (Autocut)

Selectable from Patterns A to E

Initial setting: Pattern A

Buzzer frequency (Autocut)

•Does not sound

•Sounds 1 time (initial setting)

Sound pattern (Pulse 1)

Selectable from Patterns A to E

Initial setting: Pattern A

Buzzer frequency (Pulse 1)

•Does not sound

•Sounds 1 time (initial setting)

Sound pattern (Pulse 2)

Selectable from Patterns A to E

Initial setting: Pattern B

Buzzer frequency (Pulse 2)

•Does not sound

Chapter 2 Setup

•Sounds 1 time (initial setting)

Logo 180 dpi emulation mode

•Standard logo mode (initial setting)

•180 dpi logo mode

Set to 180 dpi logo mode when you register graphics for 180 dpi so that the print result (203 dpi) is the same as one printed with a 180 dpi printer.

Communication condition of serial interface

No settings are required.

Transmission speed

• 2400 bps

• 4800 bps

• 9600 bps

• 19200 bps

• 38400 bps (initial setting)

• 57600 bps

• 115200 bps

[bps: bits per second]

Parity

•None (initial setting)

•Even

•Odd

Data bit

•7 bits

•8 bits (initial setting)

Flow control

•DTR/DSR (initial setting)

•XON/XOFF

Communication condition of USB interface

•USB printer class

•USB vendor-defined class (initial setting)

Do not change the settings.

Auto top logo

TM-T20II Utility does not support the function for Number of lines to be deleted below top logo.

Key-code

Selectable from key-codes of registered logos

Alignment

•Left

•Center

•Right

Number of lines to be deleted below top logo

Auto bottom logo

Key-code

Selectable from key-codes of registered logos

Alignment

•Left

•Center

•Right

Auto top/bottom logo extended functions

TM-T20II Utility does not support the following functions.

 Top logo print while paper feeding to the cutting position  Top logo print while clearing the buffer to recover from a recoverable error  Top logo print after paper feeding with the Feed button has finished

Chapter 2 Setup

Top logo print while paper feeding to the cutting position

•Disabled (initial setting)

•Enabled

Top logo print when printer is powered on

•Disabled (initial setting)

•Enabled

Top logo print when roll paper cover is closed

•Disabled

•Enabled (initial setting)

Top logo print while clearing the buffer to recover from a recoverable error

•Disabled

•Enabled (initial setting)

Top logo print after paper feeding with the Feed button has finished

•Disabled (initial setting)

•Enabled

Network Setting

There are following methods for network settings.

•EPSON TMNet WebC o nfig: Set from the computer's web browser

•Easy Setup: Set from the USB memory where the configuration file is stored.

This section briefly explains how to set from EPSON TMNet WebCo nfig.

Though Easy Setup requires no network connection during setup, you must specify values for all the setting items available for EPSON TMNet WebConfig.

For about Easy Setup, refer to “TM-i Series Easy Setup Guide”.

1. Connect via a wired LAN

Connect this product and a PC for setting via a wired LAN.

To use a wireless LAN, connect the wireless LAN unit to the USB port on this product.

2. Check the IP address of this product

When this product is turned on and becomes ready for printing, it prints out the automatically

acquired IP address.

If no IP address is printed, print a status sheet and check the IP address.

3. Start EPSON TMNet WebConfig

Access the address bar of the Web browser on the PC for setting to start EPSON TMNet WebC onfig.

When SSL is disabled: http://[This product's IP address]/webconfig

When SSL is enabled: https://[This product's IP address]/webconfig

For detail, see "Starting EPSON TMNet WebC on fig" on page 86

4. Set up TCP/IP

Select the [System Settings] menu and then [Wired] - [TCP/IP] or [Wireless] - [TCP/IP], and set

TCP/IP.

After setting, click [Apply] at the bottom of the screen. Then the settings are written to the product. If

[Apply] is not clicked, the settings are not applied.

For detail, see

Network - Wireless - TCP/IP" on page 101

"System Settings - Network - Wired - TCP/IP" on page 99 or "System Settings -

Chapter 2 Setup

5. Set up a wireless LAN

For a wireless LAN, select the [System Settings] menu and [Wireless], and set the items such as SSID

and Security Mode.

After setting, click [Apply] at the bottom of the screen. Then the settings are written to the product. If

[Apply] is not clicked, the settings are not applied.

For detail, see

"System Settings - Network - Wireless" on page 100.

 Be sure to change the SSID from the default value.  For security protection, encryption setting is strongly recommended.

6. Connect via a wireless LAN

To use a wireless LAN, disconnect the LAN cable from this product after setting is finished.

This product cannot be used with the wired LAN connection and wireless LAN connection at the same time. The wired LAN connection has a priority.

Confirming Network Setting

You can confirm the network setting with a status sheet or EPSON TMNet WebC onfig.

Confirming with a status sheet

Print a status sheet and check the following items.

•Wired TCP/IP

 Get IP Address

 Set using Automatic Private IP Addressing (APIPA)

 IP Address

 Subnet Mask

 Default Gateway

•Wireless

 Communication Standard

 Network Mode

 SSID

 Wireless LAN Frequency Region

 Ad-Hoc Channel

 Authenti

 Security Mode

•Wireless TCP/IP

 Get IP Address

 Set using Automatic Private IP Addressing (APIPA)

 IP Address

 Subnet Mask

 Default Gateway

About how to print the status sheet, see

cation Method

"Status sheet" on page 106.

Confirming with EPSON TMNet WebConfig

Refer to the followings.

• "General Information" on page 87

• "Information - Wired - TCP/IP" on page 88

•

"Information - Wireless - TCP/IP" on page 88

Chapter 2 Setup

Initializing the Network Setting

When network connection fails, follow the steps below to initialize the network setting to the

default.

Details of initialization

When initialization is performed, the following EPSON TMNet WebCo nfig setting items are

initialized. For details on EPSON TMNet WebC o nfig, refer to "EPSON TMNet WebCo nfig" on page

•System Settings - Network - Wired - TCP/IP

The IP address is set to DHCP.

•System Settings - Network - Wireless

The wireless LAN connection mode is set to Infrastructure mode, and the SSID is initialized to the

default value.

•System Settings - Network - Wireless - TCP/IP

The IP address for the wireless LAN is set to "192.168.192.168".

•System Settings - Time - Time

me server is disabled and the time difference is initialized to the default value.

The ti

•Admin Settings - Administrator Information - Password

The password required when starting up EPSON TMNet We b Config is initialized to the default

value.

 EPSON TMNet WebConfig settings other than those listed above are not initialized.  Files registered to EPSON TMNet WebConfig are saved.

(Certificate files, Web contents, PHP, etc.)

Initialization procedure

Push button

Load the paper on the product and turn on the product.

Push and hold the push button for 10 seconds or longer.

The following initialization start message is printed.

Press the push button with a thin object such as a tweezers.

Do not turn off the power until the initialization is completed.

20 to 25 seconds later, the following message is printed, and a status sheet is

printed out.

Chapter 2 Setup

Enabling PHP

To use PHP on this product, enable PHP using EPSON TMNet WebC o nfig.

The spooler cannot be used if PHP is enabled.

This section briefly explains the setup procedure.

1. Check the microSD card

Make sure that the microSD card is installed in the microSD card slot on this product.

2. Start EPSON TMNet WebConfig

Access the address bar of the Web browser on the PC for setting to start EPSON TMNet WebC o nfig.

When SSL is disabled: http://[This product's IP address]/webconfig/PHPSetting

When SSL is enabled: https://[This product's IP address]/webconfig/PHPSetting

3. Enable PHP

Select [Enable] from “PHP”.

After setting, click [Apply] at the bottom of the screen. Then the settings are written to the product. If

[Apply] is not clicked, the settings are not applied.

Enabling HTTPS Communication

To use HTTPS communication on this product, enable the SSL setting using EPSON TMNet

Web Co nfig and register a certificate.

• To access the Web server (HTTPS server):

SSL certificate) to th

• To access the Web server (HTTPS server) or to use this product as a Web server (including PHP):

Make sure that the certificate issued by the certification authority (signature source for the SSL cer-

tificate to be imported to this product) has been imported to the devi

This section briefly explains the setup procedure.

1. Connect this product to a network

Connect this product to a network and turn on the product.

2. Start EPSON TMNet WebConfig

is product.

ce.

You can use with TM-i firmware Ver.4.3 or later for this product.

Access the address bar of the Web browser on the PC for setting to start EPSON TMNet WebC onfig.

When SSL is disabled: http://[This product's IP address]/webconfig

When SSL is enabled: https://[This product's IP address]/webconfig

For detail, see "Starting EPSON TMNet WebC on fig" on page 86

3. Set up SSL

Select the [System Settings] menu and then [Security] - [SSL], and set SSL settings.

After setting, click [Apply] at the bottom of the screen. Then the settings are written to the product. If

[Apply] is not clicked, the settings are not applied.

For detail, see

"System Settings - Security - SSL" on page 102.

Chapter 2 Setup

Settings for Server Direct Print

Set up Server Direct Print using EPSON TMNet Web Config.

You can use with TM-i firmware Ver.4.3 or later for this product.

This section briefly explains the setup procedure.

1. Connect this product to a network

Connect this product to a network and turn on the product.

2. Start EPSON TMNet WebConfig

Access the address bar of the Web browser on the PC for setting to start EPSON TMNet WebC o nfig.

When SSL is disabled: http://[This product's IP address]/webconfig

When SSL is enabled: https://[This product's IP address]/webconfig

For detail, see

"EPSON TMNet Web Co nfig" on page 86.

3. Set up Server Direct Print

Select the [Web Service Settings] menu and then [Direct Print], and set Server Direct Print settings.

After setting, click [Apply] at the bottom of the screen. Then the settings are written to the product. If

[Apply] is not clicked, the settings are not applied.

For detail, see

"Web Service Settings - Server Access - Direct Print" on page 96.

Setting for Connected Devices

The Epson ePOS SDK, ePOS-Device XML, ePOS-Print XML, Server Direct Print, and Device Data

Notification systems identify controlled devices by the device ID. The device ID is registered in this

product. Set the device ID using EPSON TMNet Web Config.

This section briefly explains the setup procedure.

1. Connect the controlled devices

Physically connect (or connect via network) this product to all devices to be controlled by the

product, and turn the power on.

For devices that can be controlled, see "Software Specifications" on page 128

2. Check the information of the controlled devices

Check the type and IP address of devices to be controlled via this product.

In addition, check the device ID to be set for the controlled devices with the system administrator.

3. Start EPSON TMNet WebConfig

Access the address bar of the Web browser on the PC for setting to start EPSON TMNet WebC onfig.

When SSL is disabled: http://[This product's IP address]/webconfig

When SSL is enabled: https://[This product's IP address]/webconfig

For detail, see

"Starting EPSON TMNet WebC onfig" on page 86.

4. Register the controlled devices

From [Printer], [Customer Display], [Key Input Device], or [Serial Communication Device] in the

[Configuration] menu, register and set up the controlled devices.

After setting, click [Apply] or [Add] at the bottom of the screen. Then the settings are written to the

product. If [Apply] or [Add] is not clicked, t

For detail, see the following information.

he settings are not applied.

•Printer: For setting this product and TM printer on the network device ID

and performing test prints. (

•Customer Display: For setting whether to use the Customer Display and performing

test display. The communication settings of this product must be

made to match the Customer Display's communication settings.

The device ID is set to fixed, "local_display". (

•Key Input Device: For setting device IDs for barcode scanners and key input

devices, selecting control scripts, and performing operational

page 92)

tests. (

•Serial Communication Device: For setting whether to use the Serial Communication Device, con-

figuring communication settings, and performing communica-

tion tests. Communication settings of this product should match

those of a serial communication device. The device ID is set to

fixed, "local_serial".(page 92)

page 90)

page 91)

Chapter 2 Setup

5. Check the controlled devices

Update the browser and confirm that the devices registered in the Device List are displayed.

Check if the registered devices operate properly.

Changing Device ID of This Product

To ch ange the device ID of this product, select "local_printer" from "Model", and enter the device ID

to be applied in "Device ID".

This section briefly explains the setup procedure.

1. Start EPSON TMNet WebConfig

Access the address bar of the Web browser on the PC for setting to start EPSON TMNet WebC o nfig.

When SSL is disabled: http://[This product's IP address]/webconfig

When SSL is enabled: https://[This product's IP address]/webconfig

For detail, see

"Starting EPSON TMNet WebC onfig" on page 86.

2. Change the device ID

From [Printer] in the [Web Service Settings] menu, change the device ID of this product.

Select [local_printer] from "Model" and enter the device ID to be applied in [Device ID].

After setting, click [Add] at the bottom of the screen. Then the settings are written to the product. If

[Add] is not clicked, the settings are not appli

For detail, see

"Web Service Settings - Device Admin - Printer" on page 90.

ed.

3. Check the device ID

Update the browser and confirm that the device ID has been changed.

Registering Web Contents

ePOS-Device_UM_E_Sample.zip .................: Zip file

index.html css *.css img *.bmp *.jpg *.png js *.js sample *.html

ssltrustedcerts ............................................ : Server authentication certificate

example.pem

sslservercerts.............................................. : SSL authentication certificate

ServerCrt.crt ServerKey.key ChainCrt.crt

Registering Web c ontents to this product allows the use of a Web server that is accessed from an

input terminal for content distribution.

You can periodically update Web contents on this product by using a Web server for distributing

Web c o ntents tha

Creating Web Contents

This section explains the types of Web contents, and the folder configuration used.

Types of contents

•Web contents: HTML files, CSS files, JavaScript files, and Image data

•Certificate files: Server authentication certificate, SSL authentication certificate

File capacity

Zip the files to be registered all together. the zip file name is arbitrary.

t is separate from this product. You can update certificate files used by this product.

 Use one-byte alphanumeric characters (ASCII characters) for a zip file name and sub-folder

name.

 The maximum size of the files before being zipped is 30 MB. Otherwise, registering fails.  Save crossdomain.xml and clientaccesspolicy.xml to the root folder if the user web

application path is “/”.

Folder configuration

Configure folders in the following manner.

Chapter 2 Setup

epsonsample.zip

webpage ............................ : A folder added

index.php

css *.css img *.bmp *.jpg *.png js *.js sample *.html

epsonsample.zip

index.html

css *.css img *.bmp *.jpg *.png ssltrustedcerts certificate001.pem js *.js sample *.html

➀

➁

• To access the Web contents registered in this product from an input terminal or other device, the

reference URL is different depending on the folder configuration of the zip file as shown below.

When SSL is disabled:

➀ http://[This product’s IP address]/index.html ➁ http://[This product’s IP address]/webpage/index.php

When SSL is enabled:

➀ https://[This product’s IP address]/index.html ➁ https://[This product’s IP address]/webpage/index.php

Specifications for when PHP is enabled

The specifications for saving Web c o ntents using PHP settings for this product are as follows.

Specification

Item

When enabling PHP: When disabling PHP:

Content save location microSD card Inside this product

Registering Web contents Overwrite

Automatic updating of Web contents

The maximum amount of Web content

The maximum amount of Web content that can be registered at once

Overwrite

Depends on the capacity of the microSD card

30 MB 30 MB

Replacement with existing file

30 MB

*1: Overwrites the file with the same file name. Files are not deleted if file names differ.

*2: Saves a new file after deleting all existing files.

Verifying the integrity of Web contents with md5 files

You can verify the integrity of auto updating Web c ontents with md5 files. When this product

acquires a Web content file, an md5 file is downloaded to the Web server, if available. The md5 value

of the md5 file is compared to the md5 value calculated from the Web content file and, if the values

ch, the Web content file is unpacked and extracted. If these values are inconsistent, the file is not

mat

unpacked and extracted.

Preparation

•Create an md5 file with the same file name as the Web content file. Only write the md5 value of the

Web c ontent file (zip) in the fi le.

•Save the md5 file to the same folder as the Web content file.

Check Verification

You can check the results of running an automatic update from [Information] - [Web Contents] -

[Status of Last Automatic Update] in the EPSON TMNet WebC onfig.

For detail, refer to

"Information - Web Contents" on page 89.

Certificate files

You can automatically update Server authentication certificates and SSL authentication certificates

using the Web contents automatic update function.

You can download and use Server authentication certificates for this product. For det

"System Settings - Security - SSL" on page 102.

Make sure to update certificate files, including certificates in use.

Make sure to replace certificate files by deleting existing certificate files and saving new certificate files. You will be unable to connect if certificate files currently in use are not included. Make sure to include certificates currently in use in the Web content file each time.

ail, refer to

File Specifications

Save certificate files to the following folders.

•Server authentication certificate: ssltrustedcerts

• SSL authentication certificate: sslsevercerts

Use the following file names for SSL authentication certificate files.

Type File name

Certificate file ServerCrt.crt

Private key file ServerKey.key

Certificate chain file ChainCrt.crt

Chapter 2 Setup

Registering Web Contents

To re gister a web content in this product, the following methods are available:

•Manual Update: Web contents are registered manually by using EPSON TMNet WebC onfig.

•Automatic Update: Web contents are saved in the Web server and automatically updated by

the product referring to the files periodically.

You can access the web application even when a web content update is in progress. If you wish to ensure compatibility between programs when linking and running multiple PHP files, be sure to send a maintenance notification in advance or to choose a design that does not require you to stop the PHP application.

Manual Update

1. Connect this product to a network

Connect this product to a network and turn on the product.

2. Start EPSON TMNet WebConfig

Access the address bar of the Web browser on the PC for setting to start EPSON TMNet WebC o nfig.

When SSL is disabled: http://[This product's IP address]/webconfig

When SSL is enabled: https://[This product's IP address]/webconfig

For detail, see

"Starting EPSON TMNet WebC onfig" on page 86.

3. Register the Web contents

From [Update Settings] in the [Web Service Settings] menu, register the Web contents to this product.

Click [Browse...], specify the zip file to be registered, and then click [Upload].

For detail, see

"Web Service Settings - Web Contents - Update Settings" on page 95.

Automatic Update

1. Connect this product to a network

Connect this product to a network and turn on the product.

2. Start EPSON TMNet WebConfig

Access the address bar of the Web browser on the PC for setting to start EPSON TMNet WebC onfig.

When SSL is disabled: http://[This product's IP address]/webconfig

When SSL is enabled: https://[This product's IP address]/webconfig

For detail, see "Starting EPSON TMNet WebC on fig" on page 86

3. Set automatic update of Web contents

From [Update Settings] in the [Web Service Settings] menu, set automatic update of Web contents.

Select [Enable] from “Automatic Update“.

Configure the settings such as the update frequency and timing of Web contents and the URL of the

server where the file to be obtained is stored.

After setting, click [Apply] at

[Apply] is not clicked, the settings are not applied.

For detail, see

"Web Service Settings - Web Contents - Update Settings" on page 95.

the bottom of the screen. Then the settings are written to the product. If

Chapter 2 Setup

Settings for Spooler

To use the spooler with this product, you need to enable the spooler using EPSON TMNet

Web Co nfig.

 PHP cannot be used if the spooler is enabled.  You can use with TM-i firmware Ver.4.3 or later for this product.

This section gives an overview of the setup procedure.

1. Connect this product to the network

Connect this product to the network and turn on the power.

2. Start EPSON TMNet WebConfig

On the setup computer, enter the following into the address bar of your Web browser to start EPSON

TMNet WebC onfig.

When SSL is disabled: http://[This product's IP address]/webconfig

When SSL is enabled: https://[This product's IP address]/webconfig

For details, see

"Starting EPSON TMNet WebC onfig" on page 86.

3. Set the Spooler

Make spooler operation settings from [Settings] on the [Web Service Settings] menu.

Select [Enable] from [Spooler].

Set the number of retry times and the retry interval when the printer is not ready to print in [Retry

Settings].

After making settings, click [Apply] at the bottom of the screen. The settings are saved to this

product. Settings are n

For details, see

"Web Service Settings - Spooler - Settings" on page 93.

ot enabled unless you click [Apply].

Settings for Print Forwarding

To use print forwarding on this product, you need to register the print forwarding route using

EPSON TMNet WebC on fig.

 You can use with TM-i firmware Ver.4.3 or later for this product.  When using print forwarding, make sure you enable the spooler.

This section gives an overview of the setup procedure.

1. Connect this product to the network

Connect this product to the network and turn on the power.

2. Start EPSON TMNet WebConfig

On the setup computer, enter the following into the address bar of your Web browser to start EPSON

TMNet WebC onfig.

When SSL is disabled: http://[This product's IP address]/webconfig

When SSL is enabled: https://[This product's IP address]/webconfig

For details, see "Starting EPSON TMNet WebC onfig" on page 86

3. Set the Spooler

Enable the spooler settings, and then set the number of retry times and the retry interval. For details,

see "Settings for Spooler" on page 69.

4. Set the Print Forwarding Route

Set the print forwarding route from [Print forwarding] on the [Web Service Settings] menu.

In [Message Text], set the notification message printed when print forwarding occurs, and then click

[Apply]. The settings for the forwarding message are saved to this product.

From [Print forwarding route to be registered], set t

forwarding route, and then click [Register]. The settings for the print forwarding route are saved to

this product.

After making each setting, click [Apply] or [Register]. Settings are not enabled unless you click

[Apply] or [Register].

For details, see

"Web Service Settings - Spooler - Print forwarding" on page 94.

he printer and location used for the print

Settings for Device Data Notification

To use the device data notification function with this product, you need to make the following

settings using EPSON TMNet WebC onfig.

•Set the ID for the input device

•Set the target server

•Set the print message output when an error occurs

You can use with TM-i firmware Ver.4.3 or later for this product.

This section gives an overview of the setup procedure.

1. Connect this product to the network

Connect this product to the network and turn on the power.

Chapter 2 Setup

2. Start EPSON TMNet WebConfig

On the setup computer, enter the following into the address bar of your Web browser to start EPSON

TMNet WebC onfig.

When SSL is disabled: http://[This product's IP address]/webconfig

When SSL is enabled: https://[This product's IP address]/webconfig

For details, see

"Starting EPSON TMNet WebC onfig" on page 86.

3. Set the Device Data Notification

Make the necessary settings from [Device Data Notification] on the [Web Service Settings] menu.

After making settings, click [Apply] at the bottom of the screen. The settings are saved to this

product. Settings are not enabled unless you click [Apply].

For details, see

"Web Service Settings - Server Access - Device Data Notification" on page 98.

Chapter 3 Application Development Information

Application Development Information

This chapter describes how to control the product and gives information useful for product

application development.

Controlling the Printer

The method for controlling the printer with your print application will depend on the system

structure.

Controlling method System Page

Epson ePOS SDK

Controlling printing and peripherals from iOS, Android and Windows applications, and Web applications.

The Epson ePOS SDK is a software development kit that integrates the ePOS-Print SDK and the ePOS-Device SDK.

page 74

Controlling printing and peripheral operations from computer, smartphone, tablet terminals, and other devices

Print from devices such as computers, smartphones, or tablets using a Web service

Notification for data from the device is sent to the Web server which triggers the application (TM-i firmware Ver. 4.3 or later)

Web server application prints by including print data in its responses to requests from the product (TM-i firmware Ver. 4.3 or later)

Web system using this product as a Web server Web Server page 80

Spooler and Print Forwarding (Supported by TM-i firmware Ver. 4.3 or later)

ePOS-Device XML page 75

ePOS-Print XML page 77

Device Data Notification page 79

Server Direct Print

This function is available in combination with the following systems.

 Epson ePOS SDK

 ePOS-Device XML

 ePOS-Print XML

 Device Data Notification

 Server Direct Print

page 78

page 81

Epson ePOS SDK

The Epson ePOS SDK is an SDK for developing iOS, Android, Windows applications, and Web

applications. You can use the Epson ePOS SDK to control the printer with simple code.

Additionally, you can control customer displays, bar code scanners and other POS peripherals

connected to this product, and TM printers connect

application software using proprietary TM-Intelligent printer functions, such as the spooler

function and the communication box.

*: Supported by TM-i firmware Ver. 4.3 or later.

ed to the network. Further, you can also develop

Operation environment

For more information on the recommended operation environment for application software, refer to

the Epson ePOS SDK User's Manuals.

Package

The following packages are provided.

•Epson ePOS SDK for iOS

•Epson ePOS SDK for Android

•Epson ePOS SDK for Universal Windows apps

•Epson ePOS SDK for JavaScript

Web Contents

A Web reference is provided on the following web site.

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

How to obtain

Download from our web site.

Chapter 3 Application Development Information

ePOS-Device XML

ePOS-Device XML is a command system that uses XML to define functions to control various POS

peripherals (including this product printer unit) connected to this product. An application creates a

request message in XML format and sends it to this prod

This product executes control on peripherals and returns a response.

This command system has the following features:

•It enables use of the following devices via this product:

•Printing to TM printers on the network *

uct using socket communications.

•Displaying to the cus

•Barcode scanner of USB interface, input via keyboard, etc.

•Transmission/reception to/from serial communication device

•Since print data can be saved in the spooler, the application can be released from print processing

regardless of the printer status. *

•When a network printer is registered, forwarding process can be realized. Also whe

unavailable, you can print from another printer. *

*: Supported by TM-i firmware Ver. 4.3 or later.

tomer display

n the printer is

Operation environment

Application

Environment capable of performing socket communications and handling XML documents

Example: iOS, Android, Windows, Linux, MacOS, etc.

Terminal

Environment connected to the network and capable of performing socket communications

Example: Smartphone, tablet devices, computer, etc.

The package includes:

•ePOS-Device XML User’s Manual

•Sample program

How to obtain

Download from our web site.

Chapter 3 Application Development Information

ePOS-Print XML

ePOS-Print XML is a POS printer command system that uses XML to define the main functions for

the ESC/POS command system. The application creates a request message in XML format and sends

it to this product using HTTP.

Yo u can print using this product as well as TM printers on a net

This command system has the following features:

•Print in environments that allow HTTP/HTTPS communication.

•Print using this product as well as TM printers on a network.

work.

Operation environment

Application

Environment that allows HTTP/HTTPS communication and that can handle XML documents

Example: iOS, Android, Windows, Linux, MacOS, and so on

Devices

Environment connected to a network and that allows HTTP/HTTPS communication

Examples: Smartphones, tablets, computers, and so on

The package includes:

The following is provided with the ePOS-Print XML User's Manual package.

•ePOS-Print XML User's Manual

•XML schema files

•Sample programs

•ePOS-Print Editor

How to obtain

Download from our web site.

Server Direct Print

You can use with TM-i firmware Ver.4.3 or later for this product.

The Server Direct Print function is used to print the print data acquired by this product from the Web

server.

Enables a web server application to print to this product or a TM printer on the network by

including print data in its responses to requests from the product.

This function has the following features:

•Can acquire print data from three different URLs. Print data can be used in ePOS-Print XML

format.

•Printable to TM printers on the network via TM-T20II-i.

The package includes:

•Server Direct Print User’s Manual

•Sample programs in ePOS-Print XML format

How to obtain

Download from our web site.

Chapter 3 Application Development Information

Device Data Notification

You can use with TM-i firmware Ver.4.3 or later for this product.

Data from the device can be requested to the Web server to trigger the application.

The response generated by the request of this product can include print data in ePOS-Device XML

format, device control, and communication box control.

This comes with the following features.

•Input dev

communication boxes

•Devices that can be controlled by responses from a Web server: Printers, customer displays, serial

communication devices, and communication boxes

ices: Key input devices such as barcode scanners, serial communication devices,

The package includes:

The following is provided with the Device Data Notification User's Manual package.

•Device Data Notification User's Manual

•Sample programs

How to obtain

Download from our web site.

Web Server

TM-T20II-iDevice

microSD

Http Server

(Apache)

ePOS-Device

Service

1. Request

http://-----/index.php

3. Response

(HTML/JavaScript etc)

2. Data processing

Database

PHP module

(SQLite3)

Web Browser

Web page

(HTML, CSS, JavaScript)

ePOS-Device SDK

for JavaScript

4. Print Data

5. Print

Equipped with Web server that supports the scripting language "PHP" and database "SQLite3".

Using contents created with PHP, you can:

•Create dynamic Web pages.

•Manage user data by saving files and operating database.

The Web contents registered on this product can be automatically obtained or

specified URL.

updated from a

The package includes:

•PHP Setup Manual

•Sample program

How to obtain

Download from our web site.

Chapter 3 Application Development Information

Print data

Spooler

operation setting

Print processing

Secondary Printer

print processing

Spooler disabled

Spooler enabled

Print forwarding enabled

processing

Printing

complete

TM-i firmware

Ver.4.1 or earlier

Disabled

Spooling

unavailable

Enabled

Print forwarding

location settings available

Printing failed

Printing failed exceeding

the number of reprint times

Printing failed exceeding

the number of reprint times

TM-i firmware

Ver.4.3 or later

Printing

succeeded (1)

Printing

succeeded

Tertiary Printer

print processing

No print forwarding

location settings

Remaining spooler

capacity (3)

Printing failed (2)

Clear

print data (4)

Reprint (6)

Printing failed

Reprint (6)

Spooling

available (5)

Printing

succeeded (7)

Clear

print data (9)

Print forwarding

message (10)

Print forwarding

message (10)

Clear

print data (9)

Printing

succeeded

Printing failed

Reprint (6)

Print forwarding

location settings (8)

Spooler and Print Forwarding

This section explains the print flow determined by whether or not the spooler or print forwarding is

set for this product.

 When this product is turned off, data in the spooler and the log storage area is cleared.  When printing cannot be performed with this products spooler or print forwarding, the print

data is cleared. If printing has not been completed when checking in the application, we recommend reprinting.

 Print data that is too large for the remaining free space in the spooler is cleared. For the

spooler capacity, see

 If the number of job IDs exceeds the maximum storage number, the IDs are overwritten start-

ing with the oldest first. For the maximum storage number, see

page 128

 You cannot check the print results such as the spooler print data or job IDs from EPSON

TMNet WebConfig.

"Software Specifications" on page 128 .

"Software Specifications" on

•(1): TM-i firmware Ver.4.1 or earlier: [Print result = true] is returned to the application.

TM-i firmware Ver.4.3 or later: [JobID, Print result = true] is returned to the application.

•(2): TM-i firmware Ver.4.1 or earlier: [Print result = false, Error code = Printer status] is

returned to the application

TM-i firmware Ver.4.3 or later: [JobID, Print result = false, Error code = Printer status] is

returned to the application.

•(3): The remaining free space in the spooler and the size of the print data is checked, and the

product determines whether or not the print data can be spooled.

•(4): If the print data cannot be spooled, the print dat

a is cleared. [JobID, Print result = false, Error

code = EX_SPOOLER (spooler stopped)] is returned to the application.

This data is not stored in the product's spooler or the log storage area.

• (5): When print data can be spooled, [JobID, Print result = true] is stored in the spooler. [JobID,

Print result = true] is also returned

to the application.

•(6): Make the reprint settings (number of times and interval) in EPSON TMNet WebC o nfig. For

details, see "Web Service Settings - Spooler - Settings" on page 93.

• (7): When printing is successful, the spooler's print data and [JobID, Print result = true] are

deleted. [JobID, Print result = true] are stored in the log storage area of this product.

•(8): Make the print forwarding location settings in EPSON TMNet WebCo nfig. For details, see

"Web Service Settings - Spooler - Print forwarding" on page 94.

• (9): When printing fails, the spooler's print data and [JobID, Print result = true] are deleted. [JobID,

Print result = false, Error code = Printer status] are stored in the log storage area of this

product.

•(10): Make the forwarding message settings in EPSON TMNet WebC onfig. For details, see "Web

Service Settings - Spooler - Print forwarding" on page 94

Chapter 3 Application Development Information

Checking the print results

When the spooler is disabled

After printing, the job ID and print results are returned to the application. Also, when printing

cannot be performed, the job ID, print results, and error code are returned.

When the spooler is enabled

•When print data cannot be spooled:

[JobID, Print result = false, Error code = EX_SPOOLER (spooler stopped)] is returned to the

application.

•When print data can be spooled:

After spooling the print data, [JobID, Print result = true] is returned to the application. Printing is

not performed at this point. Make an

printing was performed.

Checking the print results from the application

inquiry from the application to this product to confirm if

The method for checking the print results differs for each system.

•ePOS-Device XML and ePOS-Print XML:

Request the empty print data specified for the job ID from the application.

For details, see the ePOS-Device XML User's Manual or the ePOS-Print XML User's Manual.

•Epson ePOS SDK:

Use an API that acquires job IDs to acquire the print results from the application.

For more

to the Epson ePOS SDK User's Manuals.

•Server direct print:

Return the empty print data specified for the job ID as the response to the print request from this

product.

For details, see the Server Direct Print

•Device data notification:

Request the empty print data specified for the job ID in ePOS-Device XML format.

For details, see the Device Data Notification User's Manual.

When an inquiry is made from the application for the print results, this product retur

following information.

•Printing succeeded: [JobID, Print results = true]

information on the recommended operation environment for application software, refer

User's Manual.

ns the

•Printing failed: [JobID, Print result = false, Error code = Printer status]

•Printing or print forwarding: [JobID, Print result = false, Error code = Printing]

Software and Manuals

The following software and manuals are provided for application development.

 To use the TM-T20II Utility, connect the product with a PC for setting via the USB cable or

LAN cable. Connecting the product with a PC via an wireless LAN is not possible.

 After using the TM-T20II Utility, be sure to turn off the product, and then turn it on.

Software

Software Description Manual

TM-T20II Utility Windows-based software.

Use this utility for the following functions:

 Storing logos

 Font settings

 Printing control settings

 Paper reduction settings

 Automatic paper cut settings

 Operation check

 Setting backup/restore

Coupon and Electronic Journal are unavailable.

Epson Monitoring Tool

Epson ePOS SDK The Epson ePOS SDK is a software development

Use to check a list of status for the Epson printers connected to the network.

You can also update certificates for multiple printers used for WPA-Enterprise in a batch.

kit that integrates the ePOS-Print SDK and the ePOS-Device SDK. The ePOS-Device SDK does not support new products and functions released following the release of the Epson ePOS SDK.

It is recommended that application software developed with the ePOS-Device SDK is migrated to the Epson ePOS SDK.

For detail, refer to the Migration Guide included with the Epson ePOS SDK.

TM-T20II Utility User’s Manual

(Installed along with TM-T20II Utility.)

Epson Monitoring Tool User’s Manual

 Epson ePOS SDK for iOS

User’s Manual

 Epson ePOS SDK for iOS

Migration Guide

 Epson ePOS SDK for

Android User’s Manual

 Epson ePOS SDK for

Android Migration Guide

 Epson ePOS SDK for

Universal Windows apps User’s Manual

 Epson ePOS SDK for

JavaScript User’s Manual

 Epson ePOS SDK for

JavaScript Migration Guide

ePOS-Device XML Sample files are provided for ePOS-Device XML. ePOS-Device XML

User's Manual

Server Direct Print Sample files are provided for Server Direct Print. Server Direct Print

User's Manual

Chapter 3 Application Development Information

Software Description Manual

ePOS-Print XML Sample files are provided for ePOS-Print XML. ePOS-Print XML User's Manual

Device Data Notification

TM-i Firmware Update Tool

Sample files are provided for Device Data Notification.

Tool for updating the TM-i firmware. -

Device Data Notification User's Manual

Manual

Manual name Description Providing method

TM-T20II-i User’s Manual Describes how to use and set up this product. Included with the

product

TM-T20II-i Start Here Describes points to be checked before using this

product.

TM-T20II-i Technical Reference Guide

DM-D110/DM-D210 Technical Reference Guide

OT-WL01 User’s Manual Included in the wireless LAN cable set (OT-WL01). Included with the

This document. Describes how to handle and set up this product.

Describes how to handle and set up the DMD110/DM-D210.

Included with the product

Web

product

TM-i series WebConfig API User’s Manual

PHP Setup Manual Describes how to establish the PHP environment

TM-i series Easy Setup Guide

Packs an API for setting EPSON TMNet WebConfig for this product. Using this API, you can set and reference EPSON TMNet WebConfig values from your application.

with the this product.

Explains procedures that enable settings on the TM-i to be made in a simple manner.

You make the settings using a USB memory that contains a file of EPSON TMNet WebConfig setting values.

Web

How to Get Manuals and the Utility

Yo u can obtain manuals and the TM-T20II Utility from one of the following URLs.

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

http://www.epson.com/support/ and follow the on-screen instructions.

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

https://download.epso

n-biz.com/?service=pos

EPSON TMNet WebConfig

EPSON TMNet WebC on fig is a Utility to set the product on a web browser.

This section describes EPSON TMNet WebC onfig using Internet Explorer as a browser.

Starting EPSON TMNet WebConfig

Follow the steps below to start up EPSON TMNet WebC o nfig.

Start up a PC connected to the network.

Start up the web browser, and input the following.

When SSL is disabled: http://[This product's IP address]/webconfig When SSL is enabled: https://[This product's IP address]/webconfig EPSON TMNet WebCo nfig starts.

 For the product’s IP address, see the status sheet. For the status sheet, see "Con-

firming with a status sheet" on page 56

 A user name and a password will be required on the authentication screen. Enter

“epson” for both the user name and the password. You can change the password on the [Password Setting] screen (see

Password" on page 104

.).

"Admin Settings - Administrator Information -

Help Screen Display

Click [Help] to display the help screen for EPSON TMNet Web Config.

Vers ion Scr een Dis pla y

Click [About] to display the version screen for EPSON TMNet WebC on fig.

Chapter 3 Application Development Information

General Information

Yo u can check the general information of the TM-T20II-i.

Item Description

Administrator Name Displays the administrator name set by the user.

Location/Person Displays the product's installation location set by the

user.

Firmware Version Shows the TM-i firmware version of the TM-T20II-i.

ePOS-Device Version Shows the ePOS-Device service version.

Printer Serial Number Shows the serial number of the TM-T20II-i.

Wired MAC Address Shows the MAC address for wired LAN.

Wireless MAC Address Shows the MAC address for wireless LAN.

Hardware Version Shows the hardware version for wireless LAN.

Software Version Shows the software version for wireless LAN.

Communication Standard Shows the communication standard.

Network Mode Shows the communication mode.

SSID Shows the SSID.

Wireless LAN Frequency Region Shows region codes.

Ad-Hoc Channel Shows the ad-hoc channel.

Access Point (MAC Address) Shows the MAC address for the access point.

Signal Condition Shows the signal strength.

SSL SSL settings Shows whether the SSL is enable or disable.

Domain of the certificate Shows the domain of the certificate.

Validity period of the certificate Shows the validity period of the certificate.

Time Shows the date and the present time.

Refresh Refreshes the information.

Information - Wired - TCP/IP

You can check the TCP/IP setting for a wired LAN.

Item Description

Get IP Address Shows the method of getting the IP address.

Set using Automatic Private IP Addressing (APIPA)

IP Address Shows the IP address set with the wired LAN.

Subnet Mask Shows the subnet mask set with the wired LAN.

Default Gateway Shows the default gateway set with the wired LAN.

Acquire DNS Server Address Automatically Shows the method of getting the address of the DNS

DNS Server Address Shows the addresses of the DNS server in order of usage

Shows the APIPA setting.

Nothing is shown when the wireless LAN is enabled.

server.

when [Acquire DNS Server Address Automatically] is set to [Enable].

Information - Wireless - TCP/IP

You can check the TCP/IP setting for a wireless LAN when the optional wireless LAN cable set (OT-

WL01) is used.

Item Description

Get IP Address Shows the method of getting the IP address.

Set using Automatic Private IP Addressing (APIPA)

IP Address Shows the IP address set with the wireless LAN.

Subnet Mask Shows the subnet mask set with the wireless LAN.

Default Gateway Shows the default gateway set with the wireless LAN.

Acquire DNS Server Address Automatically

DNS Server Address Shows the addresses of the DNS server in order of usage

Shows the APIPA setting.

Nothing is shown when the wired LAN is enabled.

Nothing is shown when the LAN is enabled.

Nothing is shown when the wired LAN is enabled.

Shows the method of getting the address of the DNS server.

when [Acquire DNS Server Address Automatically] is set to [Enable].

Chapter 3 Application Development Information

Information - Web Contents

Yo u can check the update setting for web contents.

Item Description

Update Schedule Shows whether to enable or disable automatic update of Web

contents.

Shows the automatic update schedule when automatic update is enabled.

File URL Shows the URL for the web content file to update automatically.

Date of Installed Web Contents When automatic update setting is enabled:

Shows the date and time when the registered web contents were created.

When manual update setting is disabled:

Shows “-”.

Date of Last Automatic Update Shows the latest date and time when the web contents were

installed on the TM-T20II-i automatically.

Status of Last Automatic Update Shows the result of the last update of web contents on the TM-T20II-i.

Information - Time

Yo u can check the time setting.

Item Description

Time Shows the date and the present time.

Use Time Server Shows whether time server is used for time setting.

Get Time Server Shows the method of getting time server.

Time Server Shows the IP address or host name of the time server.

Time Server Status Shows the result of communication with the time server.

Web Service Settings - Device Admin - Printer

Yo u can set printers or check their operation.

 This product cannot be deleted from a device.  The "device ID" for this product can be changed. For detail, see to "Changing Device ID of

This Product" on page 63

Item Description

Printer to be registered

Registered printers Displays a list of registered printers.

Device ID Sets the ID of a printer to register.

Model Selects the model of a printer to register.

IP Address Sets the IP address of a printer to register.

Retry Interval (ms) Sets the retry interval of a printer to register.

Add Adds a printer to the Device List.

Test Print Performs a test printing.

When SSL is enabled on this product, make sure that the certificate issued by the signature source certification authority of the SSL certificate imported to this product is registered in the computer or device.

Delete Deletes a registered printer.

Chapter 3 Application Development Information

Web Service Settings - Device Admin - Customer Display

Yo u can use this to set communication with the customer display and check its operation.

Item Description

Customer Display Set whether to use the Customer Display.

Communications settings

Brightness settings Set the brightness of the customer display.

Test display Performs a test display to the customer display.

Apply Saves settings to TM-T20II-i.

Communications speed (bps)

Data bit Set the data bit length.

Parity Set the parity.

Communication speed and other items must be set for this product in order to control the customer display as an RS232C-compliant serial communication device. Set these items to match the communication conditions of the customer display connected to.

 There is no need to install a USB RS232 conversion driver.  If you use the default settings unchanged, there will be no need to alter the communication

settings.

Set the communication speed.

You can set 20%, 40%, 60%, or 100%. The maximum bright-ness is 100%.

Web Service Settings - Device Admin - Key Input Device

You can set the key input device or check their operation.

Item Description

Key input device to be registered

Add Adds a device to the Device List.

Registered key input devices Displays a list of registered key input devices.

Device ID Set the ID for the key input device.

Device name Set the device name for the key input device.

Control script Set the device control script to control the key input device.

Operating test Performs an operating test for a registered key input device.

Delete Deletes a registered key input device.

Web Service Settings - Device Admin - Serial Communication Device

You can use this to set communication with a serial communication device and check its operation.

Item Description

Serial communication device Set whether to use the Serial communication device.

Communications settings

Communications speed (bps)

Set the communication speed.

Data bit Set the data bit length.

Parity Set the parity.

Stop bit Set the stop bit.

Flow control Set the flow control.

Communication test Performs a communication test.

Apply Saves settings to TM-T20II-i.

Chapter 3 Application Development Information

Web Service Settings - Device Admin - Search Printer

Yo u can search and configure printers connected to this product through the network.

Item Description

List of detected printers

Refresh Updates information.

Printer Lists the printers connected to the same subnet network as this

product, and their information.

TCP/IP Setting For making the TCP/IP setting for printers detected.

Wireless LAN Setting

For making the wireless LAN setting for printers detected.

Web Service Settings - Spooler - Settings

Yo u can set the spooler settings.

 You can use with TM-i firmware Ver.4.3 or later for this product.  PHP cannot be used if the spooler is enabled.

Item Description

Basic Settings Spooler Enable or disable the spooler function.

Retry Settings Retry Count Set the number of retry times when a print error occurs.

When print forwarding is set and an error occurs the set number of times, printing is performed using the print forwarding route.

Interval(s) Set the retry interval when a print error occurs.

Apply Save settings to TM-T20II-i.

Web Service Settings - Spooler - Print forwarding

Yo u can set the print forwarding route when using print forwarding with this product.

 You can use with TM-i firmware Ver.4.3 or later for this product.  When using print forwarding, make sure you enable the spooler.

Item Description

Message Text Message Text Set the text printed on notification messages when print

forwarding occurs.

One-byte alphanumeric characters: 255

Text Attributes Set the text decorations for notification messages.

Position Set the print position for notification messages.

Cut Set whether or not to cut paper after printing a notification

message.

Apply Save the notification message settings for this product.

Print forwarding route to be registered

Primary Printer Set the printer used for the print forwarding route.

Secondary Printer

Tertiary Printer Set the printer for the print forwarding location when printing fails

Set the printer for the print forwarding location when printing fails on the primary printer.

on primary printer and secondary printer.

Registered Print forwarding routes Display a list of the registered print forwarding routes.

Delete Clears the settings for selected print forwarding routes.

Chapter 3 Application Development Information

Web Service Settings - Web Contents - Update Settings

Yo u can use this to register web contents in this product and set updating for them.

Web Service Settings - Server Access - Direct Print

You can set server direct print for the TM-T20II-i.

You can use with TM-i firmware Ver.4.3 or later for this product.

Item Description

Server Direct Print Sets whether to use the Server Direct Print function or not.

Select [Enable] or [disable].

ID Set ID for the server-side program to identify TM-T20II-i when [Server

Direct Print] is set to [Enable].

This ID becomes the user ID used for Digest access authentication.

The set value will also be passed as an ID parameter value for the form data posted to the server.

Password Set the user ID and password used for Digest authentication. Make sure

to set a password as Digest authentication cannot be performed for the user ID without a password.

Server1 to 3 URL Specifies the Web server URL and the application path when [Server

Direct Print] is set to [Enable].

Example: http://[IP address of Web server]/Test_print.php

Click the [Access Test] button to check if the address is accessible.

Interval(s) Set the request interval when [Server Direct Print] is set to [Enable].

Authenticate Server Sets whether the server authentication is performed with the registered

certificate when accessed through https.

Apply Saves settings to TM-T20II-i.

Chapter 3 Application Development Information

Web Service Settings - Server Access - Status Notification

Yo u can set Status Notification for the TM-T20II-i.

You can use with TM-i firmware Ver.4.3 or later for this product.

Item Description

Status Notification Sets whether to use the Status Notification function or not.

Select [Enable] or [Disable].

ID Set ID for the server-side program to identify TM-T20II-i when [Status

Notification] is set to [Enable]. This ID becomes the user ID used for Digest access authentication. The set value will also be passed as an ID parameter value for the form data posted to the server.

Password Set your password used for Digest access authentication when

[Status Notification] is set to [Enable].

URL Specify the Test_print.php address of the Web server when [Status

Notification] is set to [Enable].

Example: http://[IP address of the Web Server]/Test_status.php

Click the [Access Test] button to check if the address is accessible.

Interval(s) Set the request interval when [Status Notification] is set to [Enable].

Authenticate Server Sets whether the server authentication is performed with the

registered certificate when accessed through https.

Apply Saves settings to TM-T20II-i.

Web Service Settings - Server Access - Device Data Notification

You can set the device data notification for this product.

You can use with TM-i firmware Ver.4.3 or later for this product.

Item Description

Settings Device Data

Notification

Server Acces s

POST Error

ID Set ID for the server-side program to identify TM-T20II-i when

Password Set your password used for Digest access authentication when

URL Specify the Test_print.php address of the Web server when

Server Authentic ation

Box ID Set the Box ID for the communication device, when [Device Data

Print Message

Sets whether to use the Device Data Notification function or not.

Select [Enable] or [Disable].

[Device Data Notification] is set to [Enable]. This ID becomes the user ID used for Digest access authentication. The set value will also be passed as an ID parameter value for the form data posted to the server.

[Device Data Notification] is set to [Enable].

Example: http://[IP address of the Web Server]/Test_status.php

Click the [Access Test] button to check if the address is accessible.

Sets whether the server authentication is performed with the registered certificate when accessed through https.

Notification] is set to [Enable].

Set whether or not to print an error message, if POST fails.

Message Text

Text Attributes

Cut Set whether or not to cut paper after printing an error message.

Capture Devices

Apply Save settings to TM-T20II-i.

Devices Select the devices that use device data notification.

Set the text for the error messages.

Set the text decorations for the error messages.

Chapter 3 Application Development Information

System Settings - Network - Wired

You can make settings for a wired LAN network.

Item Description

Link Speed & Duplex Sets the speed of data link layer.

Apply Saves settings to TM-T20II-i.

System Settings - Network - Wired - TCP/IP

You can make settings for a wired LAN such as IP address.

Item Description

Get IP Address Sets the method of getting the IP address.

Set using Automatic Private IP Addressing (APIPA)

IP Address Sets the IP address when [Get IP Address] is set to [Manual].

Subnet Mask Sets the subnet mask when [Get IP Address] is set to [Manual].

Default Gateway Sets the default gateway when [Get IP Address] is set to

Acquire DNS Server Address Automatically

DNS Server Address Sets the addresses of the DNS server in order of usage when

Apply Saves settings to TM-T20II-i.

Enables or disables the APIPA setting when [Get IP address] is set to [Auto].

[Manual].

Sets the method of getting the address of the DNS server.

[Acquire DNS Server Address Automatically] is set to [Disable].

System Settings - Network - Wireless

You can make settings for a wireless LAN network when the optional wireless LAN cable set (OT-

WL01) is used.

Item Description

Network Mode Sets the communication mode.

SSID Sets the SSID.

Ad-Hoc Channel Sets the ad-hoc channel.

(Available only in the ad-hoc mode)

Communication Standard Sets the communication standard.

Authentication Method Sets the authentication algorithm.

Security Mode Sets the encryption algorithm.

Default WEP Key Sets the WEP key to use.

WEP Key 1 Sets the WEP key 1 when [Security mode] is set to [WEP].

WEP Key 2 Sets the WEP key 2 when [Security mode] is set to [WEP].

WEP Key 3 Sets the WEP key 3 when [Security mode] is set to [WEP].

WEP Key 4 Sets the WEP key 4 when [Security mode] is set to [WEP].

WPA/WPA2 Pre-Shared Key

Apply

 Initially, Authentication Method is set to Open System and Security Mode is set to None. To

ensure security, be sure to change the settings before use.

 The following character types can be used for the SSID, WP key and WPA/WPA2 pre-shared

key:  ASCII characters, including spaces

Enter the pass phrase of the pre-shared key when [Security mode] is set to "WPA" or "WPA2".

Saves settings to TM-T20II-i.

100

Epson TM-T20II-i Technical Reference Guide

Specifications and Main Features

Frequently Asked Questions

User Manual

For Safety

Key to Symbols

Warnings

Cautions

Restriction of Use

About this Manual

Aim of the Manual

Manual Content

Contents

Product Overview

Features

Product Configurations

Bundled items

Options

Part Names and Functions

Power switch

Power switch cover

Roll paper cover / Cover open lever

Cutter cover

Control Panel

Interfaces

Status LED

Push button

Wired LAN Status LED

Wireless LAN cable set (optional) LED

Online and Offline

Online

Offline

Error Status

Automatically Recoverable Errors

Recoverable Errors

Unrecoverable Errors

NV Memory

NV Graphics Memory

Memory Switches (Customized Value)

R/E (Receipt Enhancement)

Maintenance Counter

Setup

Flow of Setup

Installing the Product

Installing the product Vertically

Hanging the product on a Wall

Changing the Paper Width

Installing the microSD Card

Connecting the Product to the Network

For Wired LAN connection

For Wireless LAN Interface

Connecting the Peripherals

Connecting the Customer Display

Connecting the Optional External Buzzer

Connecting the Serial Communication Device

Key Input Device via a USB Interface

Connecting the Cash Drawer

Connecting the AC Adapter

Attaching the Power Switch Cover

Setting the Memory Switches/Receipt Enhancement

Functions

Network Setting

Confirming Network Setting

Initializing the Network Setting

Enabling PHP

Enabling HTTPS Communication

Settings for Server Direct Print

Setting for Connected Devices

Registering Web Contents

Creating Web Contents

Specifications for when PHP is enabled

Verifying the integrity of Web contents with md5 files

Certificate files

Registering Web Contents

Settings for Spooler

Settings for Print Forwarding

Settings for Device Data Notification

Application Development Information

Controlling the Printer

Epson ePOS SDK