Epson TM-T88VI-iHUB User manual

Technical Reference Guide
Describes features of the product.
Describes setup and installation of the product and
peripherals.
Describes advanced usage methods for the product.
Describes how to control the printer and necessary
information when you develop applications.
Describes how to handle the product.
Describes precautions for replacement.
Describes general specications and character code tables.
M00105001
Rev. B
Product Overview
Setup
Handling
Advanced Usage
Replacement of the TM-T88V-i
Appendix
Application Development Information

2
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.
Microsoft, Windows, and Windows Vista are registered trademarks of Microsoft Corporation in the United
States and/or other countries.
Wi-Fi, WPATM, and WPA2TM are either registered trademarks or trademarks of Wi-Fi Alliance.
The Bluetoothword mark and logos are registered trademarks owned by Bluetooth SIG, Inc. and any use of
such marks by Seiko Epson Corporation is under license.
IOS is a trademark or registered trademark of Cisco in the U.S. and other countries and is used under license.
iBeacon is a trademark of Apple Inc.
Android and Google Play are trademarks of Google, Inc.
All other trademarks are the property of their respective owners and used for identification purpose only.
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 2016. All rights reserved.

3
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.
Warnings
WARNING
You must follow warnings carefully to avoid serious bodily injury.
CAUTION
Provides information that must be observed to prevent damage to the equipment or loss of data.
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.
WARNING
In the following cases, immediately unplug the AC cable and contact your dealer or a Seiko Epson
service center for advice. Continued use may lead to fire or electric shock.
If the product emits smoke, a strange odor, or unusual noises.
If water or other liquid spills into the product.
If the product is too hot to touch or the case is deformed.
Note the following points to avoid accidents such as fire, electric shock, or burn.
Do not use this product where flammable fumes from gasoline, benzine, thinner, or other
flammable liquids may be in the air.
Do not use aerosol sprayers containing flammable gas inside or around the product.
Do not cover the product with cloth, or place the product in locations subject to high levels of
humidity or dust.
Do not allow foreign objects or flammable objects to fall into the equipment.
Do not touch the inside of the product except where mentioned in the manual.
Do not use the product with any power supply or voltage other than the ones specified.
Do not connect cables in ways other than those mentioned in the manual.
Never disassemble or modify the product.
Do not use the power plug if there is dust or foreign matter attached.
Do not bend, twist, pull with excessive force, or place heavy object on the power cable.
Do not use the cables if they are damaged.
Do not place multiple loads on the power outlet (wall outlet).
Never insert or disconnect the power plug with wet hands.

4
Cautions
CAUTION
Note the following points to avoid injury or malfunction.
Setup the product on a firm, stable, horizontal surface.
Do not place heavy objects on top of the product. Never stand or lean on the product.
Do not press your hands or fingers against the cutter when removing printed paper or loading/
replacing roll paper.
Do not put your hands between the cover and the body of the product when opening/closing
the cover.
Never attempt to repair the product yourself.
Do not connect a telephone line to the drawer kick connector.
To ensure safety, unplug this product before leaving it unused for an extended period.

5
Caution Labels
The caution labels on the product indicate the following precautions.
CAUTION:
Do not touch the thermal head and the frame on its side because it can be very hot after printing.
CAUTION:
Touching the manual cutter may cause injury.
Restriction of Use
When this product is used for applications requiring high reliability/safety, such as transportation devices
related to aviation, rail, marine, automotive, etc.; disaster prevention devices; various safety devices, etc.; or
functional/precision devices, etc., you should use this product only after giving consideration to including fail-
safes and redundancies into your design to maintain safety and total system reliability. Because this product was
not intended for use in applications requiring extremely high reliability/safety, such as aerospace equipment,
main communication equipment, nuclear power control equipment, or medical equipment related to direct
medical care, etc., please make your own judgment on this product's suitability after a full evaluation.
Note about interference
 This product generates, uses, and can radiate radio frequency energy and, if not installed and used in
accordance with the instruction manual, may cause harmful interference to radio communications.
 If this equipment does cause harmful interference to radio or television reception, which can be determined by
turning the equipment off and on, the user is encouraged to try to correct the interference by one or more of the
following measures:
- Reorient or relocate the receiving antenna for the radio/TV.
- Increase the separation between the equipment and the radio/TV.
- Connect the equipment into an outlet on a circuit different from that to which the receiver is connected.
- Consult your dealer or an experienced radio/TV technician for help.

Never disassemble or modify this product.
 Seiko Epson Corporation shall not be liable for interference to radio/TV resulting from changes or
modifications to this product not expressly approved by Seiko Epson Corporation.
Open Source Software License
This product uses open source software in addition to Epson proprietary software.
For information of the open source software used in this product, see the following URL.
http://xxx.xxx.xxx.xxx/webconfig/licenses.html
For “xxx.xxx.xxx.xxx” in the above URL, input your printer’s IP address.

6
About this Manual
Aim of the Manual
This manual provides developers/engineers with all the necessary information for design, development and
installation of a POS system, and also design and development of a printer application.
Manual Content
The manual is made up of the following sections:
Chapter 1 Product Overview
Chapter 2 Setup
Chapter 3 Advanced Usage
Chapter 4 Application Development Information
Chapter 5 Handling
Chapter 6 Replacement of the TM-T88V-i
Appendix Product Specifications
Specifications of Interfaces
Bluetooth Low Energy Technology Advertising
Character Code Tables

7
Contents
■For Safety..................................................................................................................................3
Key to Symbols.................................................................................................................................................................... 3
Warnings ............................................................................................................................................................................... 3
Cautions................................................................................................................................................................................. 4
■Caution Labels .........................................................................................................................5
■Restriction of Use ....................................................................................................................5
■Note about interference ........................................................................................................5
■Open Source Software License.............................................................................................5
■About this Manual ..................................................................................................................6
Aim of the Manual ............................................................................................................................................................. 6
Manual Content.................................................................................................................................................................. 6
■Contents....................................................................................................................................7
Product Overview ..........................................................................................13
■Features ................................................................................................................................. 13
■Product Configurations ...................................................................................................... 15
Models..................................................................................................................................................................................15
Accessories .........................................................................................................................................................................15
■Part Names and Functions ................................................................................................. 16
Control Panel .....................................................................................................................................................................17
Interfaces.............................................................................................................................................................................18
Online and Offline............................................................................................................................................................19
■Status and Errors .................................................................................................................. 20
Error Status .........................................................................................................................................................................20
Status Display ....................................................................................................................................................................21
■NV Memory ........................................................................................................................... 23
NV Graphics Memory......................................................................................................................................................23
User NV Memory ..............................................................................................................................................................23
Memory Switches.............................................................................................................................................................23
R/E (Receipt Enhancement)..........................................................................................................................................23
Maintenance Counter.....................................................................................................................................................24
Web contents.....................................................................................................................................................................24
■Simple Setup for Wireless LAN .......................................................................................... 25
■Useful Functions for Smart Devices.................................................................................. 26
Wizard Guidance ..............................................................................................................................................................26
Quick pairing by NFC/QR code....................................................................................................................................27
Easy print by NFC/QR code...........................................................................................................................................28
Printing using iBeacon (available from iOS only) .................................................................................................29

8
■Printing Using Multiple Interfaces.................................................................................... 30
Setup............................................................................................................... 31
■Flow of Setup ........................................................................................................................ 31
■Installing the Printer............................................................................................................ 32
Important Notes on Installation................................................................................................................................. 32
■Adjusting the Paper Roll Near-End Sensor...................................................................... 33
■Connecting the AC adapter................................................................................................ 34
Connecting the AC adapter ......................................................................................................................................... 34
■Connecting the Printer to the Host................................................................................... 35
USB Interface..................................................................................................................................................................... 35
Ethernet Interface............................................................................................................................................................ 35
Wireless LAN Interface................................................................................................................................................... 36
■Connecting the Peripherals................................................................................................ 40
Connecting the Cash Drawer ...................................................................................................................................... 40
Setting the Built-in Buzzer (for Model with a Built-in Buzzer) ......................................................................... 41
Connecting the Optional External Buzzer .............................................................................................................. 42
Connecting the Optional Wireless LAN Unit.......................................................................................................... 43
Connecting the Optional Customer Display.......................................................................................................... 43
Connecting a Key Input Device .................................................................................................................................. 44
Connecting a Serial Communication Device......................................................................................................... 45
■Attaching the Connector Cover......................................................................................... 46
■Arranging the Cables........................................................................................................... 48
■Attaching the Power Switch Cover ................................................................................... 50
■Changing the Paper Width ................................................................................................. 51
■RTC Settings .......................................................................................................................... 52
■TM-Intelligent Function Settings ...................................................................................... 53
How to Start EpsonNet Config (Web version)....................................................................................................... 53
Advanced Usage............................................................................................ 55
■Setting the DIP Switches..................................................................................................... 55
Setting Procedure............................................................................................................................................................ 55
Settings ............................................................................................................................................................................... 56
■Software Settings................................................................................................................. 57
Software Setting Mode Functions............................................................................................................................. 59
■Network Settings.................................................................................................................. 65
Setup methods................................................................................................................................................................. 65
Flow of Setup .................................................................................................................................................................... 65
Setup using TM-T88VI Utility for Windows ............................................................................................................. 66

9
Setup using EpsonNet Config......................................................................................................................................66
Setup using EpsonNet Config (Web version).........................................................................................................67
MAC Address Confirmation ..........................................................................................................................................68
■Setting/Checking Modes .................................................................................................... 69
Self-test Mode ...................................................................................................................................................................71
NV Graphics Information Print Mode........................................................................................................................71
Receipt Enhancement Information Print Mode ....................................................................................................72
Software Setting Mode ..................................................................................................................................................73
Restore Default Values Mode.......................................................................................................................................75
Interface Setup Mode.....................................................................................................................................................76
TM-Intelligent Settings Information Print Mode ..................................................................................................77
Peripheral Device Information Print Mode.............................................................................................................77
Hexadecimal Dumping Mode .....................................................................................................................................78
■Printing a Status Sheet........................................................................................................ 79
■Resetting the Interface Settings ....................................................................................... 81
■TM-Intelligent Function ...................................................................................................... 82
Network Printer Control.................................................................................................................................................82
Controlling for POS Peripherals ..................................................................................................................................83
Spooler and Print Forwarding .....................................................................................................................................84
Communication Box .......................................................................................................................................................90
Server Direct Print............................................................................................................................................................92
Device Data Notification................................................................................................................................................94
Web Server .........................................................................................................................................................................96
Controlling POS Peripherals from iOS Applications ............................................................................................98
Controlling POS Peripherals from Android Applications...................................................................................99
Controlling POS Peripherals from Web Applications ....................................................................................... 100
Printing from Web Service Compatible Applications....................................................................................... 101
Controlling POS Peripherals from Socket Communication Compatible Applications......................... 102
Application Development Information.................................................... 103
■Controlling the Printer ...................................................................................................... 103
ePOS-Print XML.............................................................................................................................................................. 103
ePOS-Device XML.......................................................................................................................................................... 103
ESC/POS............................................................................................................................................................................ 104
■Controlling the Cash Drawer............................................................................................ 105
■Controlling the Built-in Buzzer ........................................................................................ 106
■Controlling the Optional External Buzzer ..................................................................... 107
■Software............................................................................................................................... 108
Development Kits ......................................................................................................................................................... 108
Drivers ............................................................................................................................................................................... 109
Utilities .............................................................................................................................................................................. 109
Others................................................................................................................................................................................ 110
Download ........................................................................................................................................................................ 110

10
Handling ...................................................................................................... 111
■Installing and Replacing Roll Paper................................................................................111
■Removing Jammed Paper.................................................................................................114
■If Roll Paper Cover does not Open .................................................................................. 116
■Cleaning the Printer...........................................................................................................117
Cleaning the Printer Case ...........................................................................................................................................117
Cleaning the Thermal Head/Platen Roller ............................................................................................................117
■Preparing for Transport.....................................................................................................118
Replacement of the TM-T88V-i................................................................... 119
■Functional Comparison.....................................................................................................119
TM-T88VI-iHUB vs TM-T88V-i Comparison Table ................................................................................................119
■Additional Functions and Functional Improvements .................................................120
Print Speed.......................................................................................................................................................................120
USB port with charging function .............................................................................................................................120
SimpleAP Function........................................................................................................................................................120
NFC......................................................................................................................................................................................120
Epson TM Utility for iOS/Android.............................................................................................................................120
TM-Intelligent Settings................................................................................................................................................121
Beacon Packet Broadcasting .....................................................................................................................................121
Appendix ...................................................................................................... 123
■Product Specifications ......................................................................................................123
Printing Specifications .................................................................................................................................................124
Character Specifications..............................................................................................................................................125
Printable Area..................................................................................................................................................................126
Printing and Cutting Positions..................................................................................................................................128
Paper Specifications .....................................................................................................................................................129
Electrical Characteristics .............................................................................................................................................130
Environmental Conditions .........................................................................................................................................131
External Dimensions and Mass.................................................................................................................................132
Controllable Peripherals..............................................................................................................................................134
Supported Keyboard Layouts ...................................................................................................................................135
■Specifications of Interfaces ..............................................................................................137
USB Interface...................................................................................................................................................................137
Ethernet Interface..........................................................................................................................................................138
Wi-Fi Interface.................................................................................................................................................................139
NFC Tag..............................................................................................................................................................................142
■Bluetooth Low Energy Technology Advertising...........................................................143
Introduction.....................................................................................................................................................................143
Dongle specifications...................................................................................................................................................143

11
Procedure......................................................................................................................................................................... 143
Changing the Bluetooth Low Energy Technology Advertising Packet...................................................... 144
■Character Code Tables....................................................................................................... 155

12

13
Chapter 1 Product Overview
1
Product Overview
This chapter describes features of the product.
Features
Printing
High speed printing (350 mm/s maximum).
Shifting from 80 mm width paper printing to 58 mm width paper printing is available.
Multi-tone graphic printing.
Handling
Easy drop-in paper loading
Software
 TM-Intelligent functions are available.
Equipped with USB and serial interface which enable connection with peripheral devices such as a cus-
tomer display and barcode scanner.
Supports Server Direct Print that sends a request for print data from the product to the Web server at
regular intervals.
Since print data can be saved in the spooler, applications can be released from processing print jobs
regardless of the printer status.
When a network printer is registered, print forwarding process can be realized. Also, if the printer is not
ready to print, you can print from another printer.
Supports Device Data Notification function that enables your application on a Web server to start upon
input of data from a peripheral device such as a barcode scanner.
Equipped with Web server that supports the scripting language "PHP" and database "SQLite3".
Epson ePOS SDK is available. You can develop an application that runs on iOS, Android, Windows, or that
runs in a Web browser (Web application).
Command protocol is based on the ESC/POS Proprietary Command System.
OPOS ADK, OPOS ADK for .NET, JavaPOS ADK, and Windows printer drivers (APD) are available.
A maintenance counter function is supported.
Various utility software are provided.

A utility for iOS/Android
TM
(Epson TM Utility for iOS/Android) for making printer settings is also provided.

14
Environment
Compliant with International ENERGY STAR Program.
Paper saving function is available.
Functions
NFC tag built into the printer unit for printing to a touched printer.
Printing triggered by bar code scan by smart device camera.
Supports printing using multiple interfaces.
Enables HTTPS communication.
Supports TLS1.2.
Others
Optional Wireless LAN cable set, customer display, and external buzzer are available.
The TM-T88VI Software & Documents Disc containing drivers, utility, and manuals is available.
* It may not be supplied depending on the model.

15
Chapter 1 Product Overview
1
Product Configurations
Models
Standard model: Ethernet interface, USB interface
Wi-Fi®model: Ethernet interface, USB interface , Wireless LAN interface
Accessories
Included
Roll paper (for operation check)
Power switch cover
Connector cover
Bottom cover for Connector cover
Roll paper guide
Screws
Cable lock band
TM-T88VI Software & Documents Disc (drivers, utilities, and documentation) *
AC adapter*
AC cable*
Warranty certificate*
Start Here
* May not be included depending on the model.
Options
Optional external buzzer (Model: OT-BZ20)
Wireless LAN cable set (Model: OT-WLxx)
Customer display (Model: DM-D30, DM-D110, DM-D210)

16
Part Names and Functions
.
1 NFC Tag A mark is printed here to indicate the position of the NFC tag. To establish communication
with an NFC device, bring the device close to this mark. For details on functions that use the
NFC tag, refer to "Useful Functions for Smart Devices" on page 26.
There is no data rewriting function.
Use Epson ePOS SDK to build this function into your application.
2 Roll paper cover Open this cover to install/replace the roll paper.
3 Manual cutter Use this cutter when you cut the roll paper manually.
4 Cutter cover Open this cover to unlock the autocutter blade when the roll paper cover does not open due
to a paper jam.
5 Power switch Turns the printer on or off.
6 Power switch cover Install the power switch cover onto the printer to prevent inadvertent changing of the
power switch, to prevent tampering, and to improve the appearance of the printer.
To operate the power switch, insert an object with a pointed tip such as a ballpoint pen into
the hole on the power switch cover.
For attaching the power switch cover, refer "Attaching the Power Switch Cover" on page 50.
7 Connector cover Use the printer with this cover attached to protect cables.
8 Cover open button Use this button to open the roll paper cover.
9 Feed button Pressing this button once feeds roll paper for one line. Hold down this button to continue
feeding roll paper.
10 Control Panel For details on LED, see "Control Panel" on page 17.
11 Dip switch cover Open the cover to view the dip switches for settings.
11
2
4
5
6
7
1
3
8
9
10

17
Chapter 1 Product Overview
1
Control Panel
Power LED
Lights when the power supply is on.
Off when the power supply is off.
Flashes during the network to start up, when waiting for power off, or updating firmware.
Error LED
Lights or flashes when an error occurs. (For information about the flashing patterns, see "Status and Errors"
on page 20.)
Lights after the power is turned on or after a reset (offline). Automatically goes out after a while to indicate
that the printer is ready.
Off when the printer is in standard mode (online).
Paper LED
Lights when the roll paper is out.
Flashes to urge user to operate the Feed button.
Do not turn on by using the power switch while waiting for the power to turn off (when the Power
LED is flashing). Otherwise, it may not startup correctly.

18
Interfaces
All interfaces are located on the lower rear of the printer.
Do not insert a Type-B USB connector into the Ethernet port or the drawer kick connector. If it is
inserted, the port, printer, and the system may malfunction.
1Drawerkick
connector
Connects the cash drawer or the optional external buzzer.
See "Connecting the Cash Drawer" on page 40, and "Connecting the Optional External Buzzer" on
page 42.
2 Ethernet port Connects the 10BASE-T/100BASE-TX ethernet cable.
3 Serial port Use only for connecting external devices.
4USBport
(Type A)
Use only for connecting external devices.
CAUTION:
It may be hard to disconnect some types of USB cable. Do not forcibly pull the cable, or the USB
port and USB cable may be damaged. Contact your dealer if you encounter the trouble.
5USBportwith
charging func-
tion
Connects a USB cable for connecting to an external USB device, or for charging a connected smart
device or USB device. By using the setting utilities, you can configure whether to use the port for
connecting a device or charging a device.
CAUTION:
It may be hard to disconnect some types of USB cable. Do not forcibly pull the cable, or the USB
port and USB cable may be damaged. Contact your dealer if you encounter the trouble.
Make sure you use the genuine cable for the tablet, smartphone, or USB device you are using.
Depending on how the device is being used, it may not charge to 100%.
It may take a few seconds before charging starts as the device searches for the most suitable
amperage.
Charging may not be performed depending on the device's charging specifications.
Charging stops if it exceeds the rating for the USB port.
6 Power supply
connector
Connect the AC adapter.
See "Connecting the AC adapter" on page 34.
7USBport
(Type B)
Connects the USB cable for connecting to a computer.
See "Connecting the Printer to the Host" on page 35.
2
1
34567

19
Chapter 1 Product Overview
1
Online and Offline
Online
The printer is online and ready for normal printing unless there is a reason to go offline.
Offline
The printer automatically goes offline under the following conditions:
While the printer power is turning on/off
While a self-test is running
While roll paper is fed using the Feed button
When the printer stops printing due to a paper end (when the paper out detector detected the paper out)
During an operation standby state
When an error has occurred (See "Status and Errors" on page 20)
While the roll paper cover is open

20
Status and Errors
Error Status
There are three possible error types: automatically recoverable errors, recoverable errors, and unrecoverable
errors.
Automatically Recoverable Errors
Printing is no longer possible when automatically recoverable errors occur. They can be recovered easily, as
described below.
Recoverable Errors
Printing is no longer possible when recoverable errors occur. They can be recovered easily by turning the power
on again or sending an error recovery command from the driver after eliminating the cause of the error.
Error Error description Error LED flash code Recovery measure
Roll paper
cover open
error
The roll paper cover was
opened during printing.
Recovers automatically
when the roll paper cover is
closed.
Print head
temperature
error
A high temperature
outside the head drive
operating range was
detected.
Recovers automatically
when the print head cools.
TM-Intelligent
function error
Cannot connect to the
server.
Recovers automatically
when the printer settings
are corrected.
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, send the error
recovery command, or turn
the power on to recover.
The error recovery command is valid only if a recoverable error (excluding automatically recoverable
errors) occurs.
LED ON
LED OFF
Approx. 320 ms
LED ON
LED OFF
Approx. 320 ms
Power LED ON
LED OFF
Approx. 160 ms
Approx. 5120 ms
Error LED OFF
LED ON
LED OFF
Approx. 320 ms
Approx. 5120 ms