Epson TM-T20II-i Technical Reference Guide

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
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.
© Seiko Epson Corporation 2014-2016. All rights reserved.
2

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

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

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 paperWhen 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.
5

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
6

Contents

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
7
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
8
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
9
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
10
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.
*1
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
1
*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
11
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
*1
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.
*2
•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
*2
*2
•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".
*2
•Enables HTTPS *2 communication.
•Supports TLS1.2. SSL3.0 is not supported.
*3
*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.
12

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
1
•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)
13

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

1
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.)
15

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.
16
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
1
•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.
17

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.
18
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
1
19

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
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.
20
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
1
21

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
22
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)
2
23
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)
24
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
2
25
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)
26
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
2
27

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.
28
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
1
cover.
Install the wall hanging bracket on the product, and fix it using 2 included
2
screws.
Attach 2 rubber feet in the rectangular indents in the product case, and
3
attach 2 rubber feet within the scribed line on the hanging bracket.
Place the product with the wall-hanging-bracket-side down.
4
Control panel label for vertical installation
3
Rubber feet
2
1
207 mm {8.15"}
2
Wall hanging bracket
29

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
1
paper cover.
Install 2 screws (screw diameter: 4 mm, head diameter: 7 to 9 mm) in the
2
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.
30
Remove the screws retaining the printer case, install the wall hanging
3
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
4
hook it securely.
Wall hanging bracket
2
31

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.
1
Align 3 projections on the 58-mm width paper guide plate with the
2
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.
3
For information about the memory switch, see "Setting the Memory Switches/Receipt
Enhancement" on page 45
.
32

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
1
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
2
Close the protective cover.
2
Removing the microSD Card
Open the protective cover on this product and gently push the microSD
1
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.
2
Close the protective cover.
3
33

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
34
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
1
cable into which the wireless LAN unit will be inserted, to prevent the unit from coming off.
Chapter 2 Setup
2
Insert the wireless LAN unit into the connector of the cable.
2
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.
35
Connect the USB extension cable to the USB port of the product.
3
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.
36
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.
2
37

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.)
38
Chapter 2 Setup
Affixing tape
Drawer kick connector
Installation Procedures
Turn off the product.
1
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
2
installed.
With 2 pieces of the affixing tape combined, peel off the sticker on one
3
side, and paste it around the center of the attaching surface of the optional external buzzer.
2
Connect the cable of the optional external buzzer to the drawer kick
4
connector on the product.
Do not connect both the optional external buzzer and the drawer by using a splitter or similar device.
39
Peel off the sticker on the other side of the affixing tape, and attach and fix
Printer case
Volume adjustment knob
High
Low
5
the optional external buzzer to the printer case.
Turn on the product.
6
When and how to beep can be set by TM-T20II Utility or the product's
7
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.
40
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.
2
41

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
1
2
3
4
5
6
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
42

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
1
connectors of the product.
2
Push the connector of the power code all the way into the AC inlet of the
2
AC adapter.
Push the power plug all the way into the grounded outlet.
3
Place the AC adapter with the label facing down.
4
43

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
on
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.
44
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
*2
*1
USB power-saving function
Release condition of receive buffer BUSY
Memory Switches
Error signal output
*1
Paper width
Print density
Print speed
Character code table default
International character default
Interface selection
*2
*1
*1
*1
Software Setting
Mode
-
-
-
-
-
-
-
✔✔
✔✔
✔✔
✔✔
✔✔
✔✔
2
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
*1
*2
✔✔
✔✔
✔✔
✔✔
-
-
✔✔
✔✔
✔✔
✔✔
45
Auto top logo
Function TM-T20II Utility
*3
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
*3
-
-
"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.
46
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
2
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.
47
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.
48
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)
2
•25%
•50%
•75%
Barcode height reduction rate
•Not reduced (initial setting)
•25%
•50%
•75%
49
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)
50
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
2
• 19200 bps
• 38400 bps (initial setting)
• 57600 bps
• 115200 bps
[bps: bits per second]
51
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
52
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 positionTop logo print while clearing the buffer to recover from a recoverable errorTop logo print after paper feeding with the Feed button has finished
Chapter 2 Setup
2
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
53

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 -
.
54
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.
2
55

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
56
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
.
86
•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".
2
•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.)
57
Initialization procedure
Push button
Load the paper on the product and turn on the product.
1
Push and hold the push button for 10 seconds or longer.
2
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
3
printed out.
58
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
2
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.
59

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):
Register the certificate issued by the certification authority (signature source for the Web 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.
60
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.
2
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.
61

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)
62
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.
2
63

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
<Example for sample program>
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.
64
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.htmlhttp://[This product’s IP address]/webpage/index.php
When SSL is enabled:
https://[This product’s IP address]/index.htmlhttps://[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:
2
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
*1
*1
Replacement with existing file
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.
*2
*2
65

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
66
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
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.
67
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
68
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
2
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].
69

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
70

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.
2
71
72
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
3
73

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.
74
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
3
Operation environment
Application
Environment capable of performing socket communications and handling XML documents
OS
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.
75
The package includes:
•ePOS-Device XML User’s Manual
•Sample program
How to obtain
Download from our web site.
76
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
3
Environment that allows HTTP/HTTPS communication and that can handle XML documents
OS
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.
77

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.
78
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,
3
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.
79

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.
80
Chapter 3 Application Development Information
Print data
Spooler
operation setting
Print processing
Secondary Printer
print processing
Spooler disabled
Spooler enabled
Print forwarding enabled
Print
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.
3
81
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 rec­ommend 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
.
82
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
3
•Printing failed: [JobID, Print result = false, Error code = Printer status]
•Printing or print forwarding: [JobID, Print result = false, Error code = Printing]
83

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
84
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 DM­D110/DM-D210.
Included with the product
Web
Web
product
3
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
Web
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
85

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.
1
Start up the web browser, and input the following.
2
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.
86
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.
3
87

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.
Nothing is shown when the wireless LAN is enabled.
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].
88
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.
3
89

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.
90
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.
Communica­tions 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 cus­tomer 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%.
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.
3
91

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.
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 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.
Communica­tions 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.
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.
Apply Saves settings to TM-T20II-i.
92
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.
3
93

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 regis­tered
Register Save the settings for the print forwarding route to TM-T20II-i.
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.
94
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.
See also
Automatic Update Settings
"Registering Web C o ntents" on page 64.
Item Description
Automatic Update Selects the method of updating web contents.
Selecting [Enable] enables "Automatic Update Settings".
Selecting [Disable] enables "Web Contents Manual Update".
Frequency Sets the frequency of automatic update for web contents.
Timing Sets the timing of automatic update for web contents.
Update Time Sets the start time of automatic update for web contents.
ID Sets ID for identifying this product at the Web server when
[Automatic Update] is set to [Enable].
This ID will be the user ID used for Digest authentication. This 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.
File URL Specifies the URL for a file to update automatically.
After specifying it, clicking [File Access Test] checks whether the URL is specified correctly.
3
Web Contents Manual Update
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 Contents Archive File (*.zip)
Upload Registers the specified web contents on the TM-T20II-i.
Specifies the web content files to register.
95

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.
96
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.
3
97

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].
[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.
98
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].
3
99

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