Epson TM-T88VI-iHUB Reference Manual

Epson TM-T88VI-iHUB Reference Manual

Hide thumbs Also See for TM-T88VI-iHUB:
Table of Contents

Advertisement

Quick Links

Technical Reference Guide

Product Overview

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

Advertisement

Table of Contents
loading

Summary of Contents for Epson TM-T88VI-iHUB

  • Page 1: Product Overview

    Technical Reference Guide Product Overview Describes features of the product. Setup Describes setup and installation of the product and peripherals. Advanced Usage Describes advanced usage methods for the product. Application Development Information Describes how to control the printer and necessary information when you develop applications.
  • Page 2  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...
  • Page 3: For Safety

    Provides important information and useful tips. Warnings 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.
  • Page 4: Cautions

    Cautions 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. CAUTION  Do not press your hands or fingers against the cutter when removing printed paper or loading/ replacing roll paper.
  • Page 5: Caution Labels

    - 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.
  • Page 6: About This Manual

    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...
  • Page 7: Table Of Contents

    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 ..................................
  • Page 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 ■...
  • Page 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...
  • Page 10 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...
  • Page 11 Procedure..................................143 Changing the Bluetooth Low Energy Technology Advertising Packet............144 ■ Character Code Tables....................... 155...
  • Page 13: Product Overview

     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).
  • Page 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. ...
  • Page 15: Product Configurations

    Chapter 1 Product Overview 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 ...
  • Page 16: Part Names And Functions

    NFC tag, refer to "Useful Functions for Smart Devices" on page  There is no data rewriting function.  Use Epson ePOS SDK to build this function into your application. Roll paper cover Open this cover to install/replace the roll paper.
  • Page 17: Control Panel

    Chapter 1 Product Overview 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. Do not turn on by using the power switch while waiting for the power to turn off (when the Power LED is flashing).
  • Page 18: Interfaces

    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. Drawer kick Connects the cash drawer or the optional external buzzer.
  • Page 19: Online And Offline

    Chapter 1 Product Overview 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 ...
  • Page 20: Status And Errors

    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. Error Error description Error LED flash code...
  • Page 21: Status Display

    Chapter 1 Product Overview Unrecoverable Errors Printing is no longer possible when unrecoverable errors occur. The printer must be repaired. 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 LED ON correctly.
  • Page 22 Power LED Error LED Paper LED Paper near end While updating firmware Flashing Power off standing by Flashing Waiting to print status sheet Flashing -: Changes depending on whether or not paper is detected.
  • Page 23: Nv Memory

    Use the Setup Utilities to register graphics. You can confirm the registered graphics in the NV graphics information print mode.  For detailed information about the Epson TM-T88VI Utility for Windows, see the TM-T88VI Utility User’s Manual.  For information about how to use the NV graphics information print mode, see "NV Graphics...
  • Page 24: Maintenance Counter

    Maintenance Counter With this function, printer information, such as the number of lines printed, the number of autocuts, and printer operation time after the printer starts working, is automatically stored in NV memory. You can also check the head running length and number of times of autocutting with the self-test (see "Self-test Mode"...
  • Page 25: Simple Setup For Wireless Lan

    This allows you to easily setup a wireless LAN for the printer by using a printer settings tool (Epson TM Utility for iOS/Android or EpsonNet Config) even without a network environment such as access points.
  • Page 26: Useful Functions For Smart Devices

    Useful Functions for Smart Devices The Epson TM Utility for iOS/Android app provides useful functions for iOS and Android smart devices. ™ You can download the Epson TM Utility for iOS/Android from Google Play or the App Store. Wizard Guidance...
  • Page 27: Quick Pairing By Nfc/Qr Code

    Touch your device to the NFC tag built-in to the printer, or capture the QR code with the camera on your smart device to select the printer.  Use Epson ePOS SDK to build this function into your application. By using the Printer Easy Select API, you can acquire the printer information necessary for printing (device name, interface, and address) from the NFC or QR code data.
  • Page 28: Easy Print By Nfc/Qr Code

    Touch your device to the NFC tag built-into the printer, or capture the QR code with the camera on your smart device to start printing.  Use Epson ePOS SDK to build this function into your application. This function is created by combining NFC touch and QR code capturing operations, the target printer specifications using Printer Easy Select API, and the print job.
  • Page 29: Printing Using Ibeacon (Available From Ios Only)

    All you need to do is specifying the target printer by using Beacon information and the EasySelect API that allows you to easily select the printer, then adding a print process. For more details, refer to “Epson ePOS SDK for iOS User’s Manual” and sample programs of Epson ePOS SDK.
  • Page 30: Printing Using Multiple Interfaces

    Printing Using Multiple Interfaces You can use all interfaces without any limitations on which interface is to be used. You can use this function to temporarily connect a smart device to a nearby printer and print. The printer provides each interface with an independent receive buffer and switches the active interface depending on the priority, while handling data in each receive buffer.
  • Page 31: Setup

    Chapter 2 Setup Setup This chapter describes setup and installation of the product and peripherals. Flow of Setup This chapter consists of the following sections along with the setup flow of the product and peripherals. Installing the Printer (page 32) Adjusting the Paper Roll Near-End Sensor (page 33) Connecting the AC adapter (page 34) Connecting the Printer to the Host (page 35)
  • Page 32: Installing The Printer

    Installing the Printer Important Notes on Installation  The printer must be installed horizontally on a flat surface (not tilted).  Do not place the printer in dusty locations.  Do not catch cables or place foreign matter under the printer.
  • Page 33: Adjusting The Paper Roll Near-End Sensor

    Chapter 2 Setup Adjusting the Paper Roll Near-End Sensor Below are two situations where a roll paper NE sensor adjustment is required.  To adjust the detection position to suit the diameter of the roll paper core used.  To adjust the detection position of remaining amount of paper. ...
  • Page 34: Connecting The Ac Adapter

    Connecting the AC adapter  Be sure to use the specified AC adapter. Connection to an improper power source may lead to equipment damage, fire, or electric shock.  Never insert the AC cable plug into a socket that does not meet the input voltage of the AC WARNING adapter.
  • Page 35: Connecting The Printer To The Host

    Ethernet Interface Use ethernet cable to connect the printer to network via a hub. Use Epson TM-T88VI Utility for Windows, EpsonNet Config, or EpsonNet Config (Web version) to set net- work. For details on the network settings, see "Network Settings" on page ...
  • Page 36: Wireless Lan Interface

    When setting up multiple printers, you can connect using a wired cable (LAN/USB) and setup a wireless LAN using the Epson Deployment Tool. Using Epson TM Utility for iOS/Android, you can easily connect the printer to the network from an iOS or Android devices.
  • Page 37 When connecting to the printer is complete, setup the Wireless LAN using the network setup tool, Epson TM-T88VI Utility for Windows or EpsonNet Config. For details about Epson TM-T88VI Utility for Windows, see TM-T88VI Utility User's Manual. For details about EpsonNet Config, see EpsonNet Config User's Manual.
  • Page 38 Setting up from a Smart Device Necessary Items Prepare the following items.  Device for setting: iOS or Android device  Utility for setting: Epson TM Utility for iOS/Android Running Epson TM Utility for iOS/Android Run the Epson TM Utility for iOS/Android.
  • Page 39 Chapter 2 Setup Set from “Wi-Fi Setup Wizard” in the menu. Setup and Operation Workflow Select the network you want to connect to. Enter the passkey. Perform a test print.
  • Page 40: Connecting The Peripherals

    Connecting the Peripherals Connecting the Cash Drawer  Do not connect both the optional external buzzer and the cash drawer to the printer at the same time by using a branched connector.  When the optional external buzzer is enabled with the memory switch (customized values) (see "Software Settings"...
  • Page 41: Setting The Built-In Buzzer (For Model With A Built-In Buzzer)

    Chapter 2 Setup Connecting the drawer kick cable  Use a shield cable for the drawer kick cable.  When using cash drawer, make sure to use the power supply for printer (connector pins 4).  Do not insert a telephone line into the drawer kick connector. WARNING Doing so may damage the telephone line or printer.
  • Page 42: Connecting The Optional External Buzzer

    Connecting the Optional External Buzzer When the optional external buzzer (model: OT-BZ20) is connected to the drawer kick connector of the printer, you can set the printer so that it beeps when you send commands, when an error occurs, when executed autocutting, and when detected paper end.
  • Page 43: Connecting The Optional Wireless Lan Unit

    Chapter 2 Setup Connecting the Optional Wireless LAN Unit The optional Wireless LAN cable set (OT-WLxx) enables you to use the product with a Wi-Fi connection. For more information, refer to Technical Reference Guide of the Wireless LAN cable set. ...
  • Page 44: Connecting A Key Input Device

    Connecting a Key Input Device You can connect a key input devices using the USB port. Up to five devices can be registered. To register, change, or delete the device, use the TM-T88VI Utility for Windows or EpsonNet Config (Web ver- sion).
  • Page 45: Connecting A Serial Communication Device

    Chapter 2 Setup Keyboard Setting Item Setting VID & PID 0x046a & 0x0037 Interface Number Device ID local_keyboard Device Type Keyboard Control Script Keyboard_Generic.js Card reader Setting Item Setting VID & PID 0x046a & 0x0037 Interface Number Device ID local_scanner Device Type Barcode reader Control Script...
  • Page 46: Attaching The Connector Cover

    Attaching the Connector Cover When using the connector cover, attach the connector cover. Follow the steps below to attach the connector cover to protect cables. Turn over the printer. Position the two hooks on both sides of the connector cover so that they hook the printer case.
  • Page 47 Chapter 2 Setup  You can use the enclosed screw to fix the connector cover.  To remove the connector cover, turn the printer over, remove the screw, and push the connector cover down while pushing both sides of the connector cover inward to detach the hooks from the printer case.
  • Page 48: Arranging The Cables

    Arranging the Cables Route the cables when using the connector cover. Pass the cables through cable exits in the connector cover. The connector cover has cable exits on the back and both sides. You can also route the cables out the front by passing them through the notch in the printer bottom. When using cables without lock, use of the bundled cable lock band is recommended.
  • Page 49 Chapter 2 Setup After the cable arrangement, turn over the printer, and make sure the cables are not pinched.
  • Page 50: Attaching The Power Switch Cover

    Attaching the Power Switch Cover By attaching the power switch cover supplied, you can prevent accidental operations of the power switch. You can press the power switch by inserting a sharp-pointed object in the holes on the power switch cover. To detach the cover, use a sharp-pointed object.
  • Page 51: Changing The Paper Width

    Chapter 2 Setup Changing the Paper Width You can change the paper width from 80 to 58 mm by installing the included 58-mm width roll paper guides. Follow the steps below to change the paper width. Turn off the printer when installing the roll paper guides. Open the roll paper cover.
  • Page 52: Rtc Settings

    RTC Settings The time for the RTC (Real Time Clock) may be initialized when starting up for the first time. If the time is initialized, make settings using the Setup Utilities. For details on making settings using the Setup Utilities, see the TM-T88VI Utility User's Manual.
  • Page 53: Tm-Intelligent Function Settings

    To use the TM-Intelligent functions of the printer, enable the functions you want to use using Espon TM-T88VI Utility for Windows or EpsonNet Config (Web version). For instructions on how to set it using Epson TM-T88VI Utility for Windows, see the TM-T88VI Utility User's Manual.
  • Page 55: Advanced Usage

    Chapter 3 Advanced Usage Advanced Usage Setting the DIP Switches On this printer, you can make various settings with DIP switches. The DIP switches are already set. Change the setting if necessary. For models with the buzzer function, see also "Setting the Built-in Buzzer (for Model with a Built-in Buzzer)"...
  • Page 56: Settings

    Settings Default Function setting Auto line feed Always enabled Always disabled Receive buffer capacity 45 bytes 4 KB Selects print density " Selecting the Print Density (DIP Switches 3/4)". Releases the BUSY state Releases the BUSY state Sets the release condition of the when the remaining when the remaining receive buffer BUSY state.
  • Page 57: Software Settings

    Chapter 3 Advanced Usage Software Settings For an outline of the functions, see the following section. Use the Epson TM-T88VI Utility for Windows, Epson TM Utility for iOS/Android, EpsonNet Config (Web version), or Software Setting Mode to set the memory switches.
  • Page 58 Epson Epson TM EpsonNet Software TM-T88VI Utility for Config Item\Method Setting Utility for iOS/ (Web Mode Windows Android version) ✔ ✔ ✔ ✔ Print Data Parsing Setting* ✔ ✔ Cut Error Release Method ✔ ✔ Logo ✔ ✔ ✔ ePOS-Print ✔...
  • Page 59: Software Setting Mode Functions

    Chapter 3 Advanced Usage Software Setting Mode Functions USB power saving function  Disabled  Enabled (default setting) The USB power-saving function is valid only when the USB interface communication condition is set to the vendor-defined class and the system configuration is set so that the USB driver can support the USB power-saving function.
  • Page 60: Buzzer Function

    Amount of reduction in character height  Not reduced (default setting)  Reduces space within the characters by 25%  Reduces space within the characters by 50%  Reduces space within the characters by 75%  Reduces space within the characters by 75% + Reduces the height of the font Amount of reduction in barcode height ...
  • Page 61 Chapter 3 Advanced Usage Buzzer frequency (Error)  Does not sound  Sounds 1 time  Sounds continuously (default setting) Sound pattern (Autocut) Selectable from Patterns A to E Default setting: Pattern A Buzzer frequency (Autocut)  Does not sound ...
  • Page 62: Print Density

    Font A auto replacement  Does not replace (default setting)  Font B Font B auto replacement  Does not replace (default setting)  Font A Print density Selectable from 70% to 130% (5% increment) Default setting: 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.
  • Page 63: Paper Width

    Chapter 3 Advanced Usage Print density during multi-tone printing Selectable from 70% to 130% (5% increment) Default setting: 100% Power supply output Selectable from levels 1 to 3 low power load Default setting: level 3 Paper width  80mm (default setting) ...
  • Page 64 USB IEEE1284 device ID  Do not output IEEE1284 Device ID  Output IEEE1284 Device ID (default setting) Settings for USB port with charging function  Disable the charging function, Enable USB communication (default)  Enable the charging function, Disable USB communication Print data parsing setting ...
  • Page 65: Network Settings

    Chapter 3 Advanced Usage Network Settings The following explains the procedure for network settings in order to connect the product to your network. Setup methods There are three methods for set up. Method 1: Setup using TM-T88VI Utility for Windows This method uses the setup utility "TM-T88VI Utility"...
  • Page 66: Setup Using Tm-T88Vi Utility For Windows

     When DHCP is enabled, the provided IP address is printed automatically. However, if the Ethernet cable is not connected, and the Wireless LAN unit is not installed, printing is not performed. Connect the printer to the same network as the computer where you installed Epson- Net Config.
  • Page 67: Setup Using Epsonnet Config (Web Version)

    Input your user name and password on the authentication window. Input "epson" for both the user name and password. You can change the password in the [Optional] setting menu, under [Password]. Change the settings based on the network setting information you received from the network administrator.
  • Page 68: Mac Address Confirmation

    Click the [Reset] button on the Web page displayed after sending. The sent contents are enabled. Depending on the changes, such as the IP address, the connection with the setting computer may be cut and the EpsonNet Config window may not be displayed. To reconnect, you need to set the net- work settings of the setting computer to the same network segment as the printer for which settings were changed.
  • Page 69: Setting/Checking Modes

    Chapter 3 Advanced Usage Setting/Checking Modes As well as print mode, the following modes are also provided for making various printer settings and checking items.  Self-test mode  NV graphics information print mode  Receipt Enhancement information print mode ...
  • Page 70 In 1 and 2, the following guidances are printed, the Paper LED flashes, and instructs the user's operations. 1. Continuing self-test guidance 2. Mode selection guidance Mode Selection Modes 0: Exit and Reboot Printer 1: NV Graphics Information 2: Receipt Enhancement Information 3: Customize Value Settings 4: Restore Default Values 5: Interface Setup...
  • Page 71: Self-Test Mode

    Chapter 3 Advanced Usage Self-test Mode You can check the following items using the self-test.  Product name  Firmware version  Product serial number  Interface information  Resident fonts  Maintenance counter information (head running length, number of times of autocutting) Follow the steps below.
  • Page 72: Receipt Enhancement Information Print Mode

    Follow the steps below. After running a self-test, hold down the Feed button for at least one second, and then select the Mode selection. The Mode selection guidance is printed, and the Paper LED flashes. After briefly (less than one second) pressing the Feed button once, hold it down for at least one second, to print the NV graphics information.
  • Page 73: Software Setting Mode

    Chapter 3 Advanced Usage Software Setting Mode Set the printer's memory switches and customized values.  Print density  Auto reduction of amount of paper to use  Enabling/disabling paper autocutting at cover close  Paper width setting  Auto replacement of font ...
  • Page 74 Customize Value Settings Modes 0: Exit 1: Print Current Settings 2: Print Density 3: Print Speed 4: Automatic Paper Reduction 5: Auto Paper Feed&Cut at cover close 6: Paper Width 7: Top Margin 8: Character/Font Settings 10: Interface Settings 11:Intelligent Settings 12: Command Execution (Offline) 13: Power Supply Output 14: Other Settings...
  • Page 75: Restore Default Values Mode

    Chapter 3 Advanced Usage Restore Default Values Mode In Restore default values mode, following values saved on NV Memory will be set back to default settings. When any error occurs, you can use to specify the reason. Restore Default Values Setting Contents Setting Items and Delete Defined Data...
  • Page 76: Interface Setup Mode

    To finish, turn off the power. Interface Setup Mode Use this mode to setup the interface and other settings. Follow the steps below. After running a self-test, hold down the Feed button for at least one second to enter the Mode selection. The Mode selection guidance is printed, and the Paper LED flashes.
  • Page 77: Tm-Intelligent Settings Information Print Mode

    Chapter 3 Advanced Usage TM-Intelligent Settings Information Print Mode This function allows you to print TM-Intelligent setting information currently registered in the printer. Follow the steps below. After running a self-test, hold down the Feed button for at least one second to enter the Mode selection.
  • Page 78: Hexadecimal Dumping Mode

    Hexadecimal Dumping Mode In hexadecimal dumping mode, data from the host device is printed in hexadecimal numbers and characters. By comparing the print outs and the program, you can check whether or not data is being sent to the printer correctly.
  • Page 79: Printing A Status Sheet

    Chapter 3 Advanced Usage Printing a Status Sheet Follow the steps below to check the interface settings. When the power LED is flashing, wait until it remains lit to start printing. Using the Status Sheet Button Check that the printer is turned on. Make sure the roll paper cover is closed.
  • Page 80 ---Server access test result--- Device * * * Wi-Fi & Ethernet Interface * * * local_printer Model :TM-T88VI Wi-Fi Status Connection :Success MAC Address : Unmounted network_printer1 SSID : EPSON_Printer Model :TM-Txx Network Mode : Infrastructure IP Address :192.168.192.100 Comm Standard : 802.11b/g/n Connection :Success...
  • Page 81: Resetting The Interface Settings

    Chapter 3 Advanced Usage Resetting the Interface Settings Follow the steps below to reset the interface settings.  You can return the interface settings to their defaults from the Interface Setup mode. See "Interface Setup Mode" on page 76 for details on the Interface Setup mode. ...
  • Page 82: Tm-Intelligent Function

    You can change the settings for each of the TM-Intelligent functions using Epson TM-T88VI Utility for Windows or EpsonNet Config (Web version). For details on the setting method for Epson TM-T88VI Utility for Windows, see the TM-T88VI Utility User's Manual.
  • Page 83: Controlling For Pos Peripherals

    POS peripherals from smart device applications, which until now was difficult to do. For details on controllable POS peripherals, see the Epson ePOS SDK User's Manual. Device control script file The following device control script files are registered to this product.
  • Page 84: Spooler And Print Forwarding

    Spooler and Print Forwarding Spooler A spooler for saving print data and conducting background printing is implemented in the TM-Intelligent soft- ware. Even in systems where multiple print jobs are concentrated, an application system can be configured where response is not impeded. General printing applications finish transactions upon confirming the printing.
  • Page 85 Chapter 3 Advanced Usage Devices A to C request printing of data A to C almost simultaneously. The TM-Intelligent software saves the print data in the spooler in the order it receives it, and returns the printing results (JobID, printing result = true) to each device. Each device application completes the printing process and executes the next opera- tion.
  • Page 86 Print Forwarding Print forwarding, which enables printing to be performed from a different printer if it cannot be performed on another one is implemented in the TM-Intelligent software. You can configure a secure system that enables printing to be performed on a separate printer even if one printer cannot be used. All you need to do is specify the forwarded printer in the case where printing cannot be performed to the TM-T88VI Utility for Windows or the EpsonNet Config (Web version).
  • Page 87 Chapter 3 Advanced Usage 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 per- formed, the job ID, print results, and error code are returned. When the spooler is enabled ...
  • Page 88 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. Printing succeeded (1) Print data Printing failed (2) Print processing Spooler disabled Disabled Spooler operation setting Enabled Spooler enabled Spooling...
  • Page 89 Chapter 3 Advanced Usage When spooler is disabled 1: Printing success [JobID, Print result = true] is returned to the application. 2: Printing failed [JobID, Print result = false, Error code = Printer status] is returned to the application. When spooler is enabled 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.
  • Page 90: Communication Box

    ID, to applications. The box ID can be used by multiple applications, making it possible to easily configure a sys- tem for exchanging data between applications. The communication box can be set and used from applications compatible with Epson ePOS SDK and ePOS- Device XML.
  • Page 91 Chapter 3 Advanced Usage An example for processing the data using communication box The product receive a barcode data scanned from scanner. TM-Intelligent Software notify the barcode data to App2. App2 acquire the barcode data, then convert to POS data. App2 sends display data to communication box of TM-Intelligent Software.
  • Page 92: Server Direct Print

    Server Direct Print Server Direct Print is implemented in the TM-Intelligent software. The function allows the TM-Intelligent soft- ware to issue printing requests to Web server applications, conduct printing upon directly acquiring print data from the Web server, and notify the printing results to applications. General printing system applications perform printing upon designating the printer.
  • Page 93 Chapter 3 Advanced Usage Setting Items Setting Items  Enabling ePOS-Device Service Enabling / Disabling ePOS-Device Service  Enabling device control Web service  Enabling server direct print  Enabling status notification  Application server settings Server direct print  Application server settings Status notification ...
  • Page 94: Device Data Notification

    Device Data Notification A device data notification function for using input data from a barcode scanner, etc. connected to this product as a trigger to receive print data or other data for controlling a device directly from the Web server and notifying the control results to the application is implemented in the TM-Intelligent software.
  • Page 95 Chapter 3 Advanced Usage Items to be Prepared by the Customer  Web server  Application for including device control data in response to requests from the TM-Intelligent software Setting Items Setting Items  Enabling ePOS-Device Service Enabling / Disabling ePOS-Device Service ...
  • Page 96: Web Server

    Web Server You can configure a Web server system which mounts the server-side scripting (php) Web contents. You can also use the SQLite database. Moreover, you can configure an automatic update system of Web contents for automatically updating Web contents from a separate Web server at regular intervals. Preparation of Web content File format ...
  • Page 97 Chapter 3 Advanced Usage  When you access to registered web contents from an input terminal and so on, the URL differs depending on the folder structure of the zip file. ➀ http://[the product’s IP address]/webapp/index.html ➁ http://[the product’s IP address]/webapp/webpage/index.html ➀...
  • Page 98: Controlling Pos Peripherals From Ios Applications

    A function for controlling this product's POS peripherals and network printers from iOS applications is imple- mented in the TM-Intelligent software. Utilizing Epson ePOS SDK for iOS included in Epson ePOS SDK, you can easily configure an application sys- tem using API for controlling POS peripherals and printers.
  • Page 99: Controlling Pos Peripherals From Android Applications

    A function for controlling this product's POS peripherals and network printers from Android applications is implemented in the TM-Intelligent software. Utilizing Epson ePOS SDK for Android included in Epson ePOS SDK, you can easily configure an application system using API for controlling POS peripherals and printers.
  • Page 100: Controlling Pos Peripherals From Web Applications

    HTML5 Canvas from a HTML5-compatible Web browser. Using the Epson ePOS SDK for JavaScript included in the Epson ePOS SDK, you can easily construct an appli- cation system by utilizing APIs for controlling POS peripherals and printers.
  • Page 101: Printing From Web Service Compatible Applications

    Chapter 3 Advanced Usage Printing from Web Service Compatible Applications A function for controlling this product's POS peripherals and network printers from applications compatible with Web services is implemented in the TM-Intelligent software. Through using the ePOS-Print XML system, you can perform printing from various device applications com- patible with SOAP/HTTP communications.
  • Page 102: Controlling Pos Peripherals From Socket Communication Compatible Applications

    Controlling POS Peripherals from Socket Communication Compatible Applications A function for controlling this product's POS peripherals and network printers from applications compatible with Web services is implemented in the TM-Intelligent software. There is no need to install drivers and plug-ins to terminals. Through using the TM-Intelligent system, you can perform printing from various device applications compati- ble with socket communications.
  • Page 103: Application Development Information

     Epson ePOS SDK ePOS-Print XML ePOS-Print XML is the Epson original control command system for POS printers defined in XML. With ePOS Print XML commands, you can print in environments where http communication is available and from OS applications. For detailed information about ePOS-Print XML, see the ePOS-Print XML User's Manual.
  • Page 104: Esc/Pos

    ESC/POS ESC/POS is the Epson original printer command system for POS printers and customer display. With ESC/POS commands, you can directly control all the printer functions, but detailed knowledge of printer specifications or combination of commands is required, compared to using drivers and applications.
  • Page 105: Controlling The Cash Drawer

    Register a cash drawer using the SetupPOS Utility, and control using the OpenDrawer method or the DirectIO function. For details, see the "EPSON OPOS ADK for .NET MANUAL Application Development Guide Cash Drawer (EPSON Standard)" and the "UnifiedPOS Specification". Epson ePOS SDK The output command for the drawer kick pulse and the status transmission command are provided in each SDK library.
  • Page 106: Controlling The Built-In Buzzer

    (TM Series)". OPOS for .NET Register a POS printer using the SetupPOS Utility and control using the DirectIO function. For details, see the "EPSON OPOS ADK for .NET MANUAL Application Development Guide POSPrinter (TM-T88VI)". Epson ePOS SDK Use the output command for the drawer kick pulse provided in each SDK library. For details, see the user's manuals provided with each SDK.
  • Page 107: Controlling The Optional External Buzzer

    (TM Series)". OPOS for .NET Register a POS printer using the SetupPOS Utility and control using the DirectIO function. For details, see the "EPSON OPOS ADK for .NET MANUAL Application Development Guide POSPrinter (TM-T88VI)". Epson ePOS SDK The command for the buzzer function is provided in each SDK library. For details, see the user's manuals provided with each SDK.
  • Page 108: Software

    Because controlling POS peripherals with original commands is not required on the application side, efficient system development is possible. EPSON OPOS ADK for .NET The OPOS ADK for .NET is a POS industry standard printer driver compatible with Microsoft POS for .NET. It allows you to develop applications that are compatible with the UPOS (Unified POS) specification.
  • Page 109: Drivers

    In addition to ordinary Windows printer driver functions, this driver has controls Windows Printer Driver (APD) specific to POS. The Status API (Epson original DLL) that monitors printer status and sends ESC/POS commands is also attached to this driver. EPSON TM Virtual...
  • Page 110: Others

    Operating Software Description environment Epson Monitoring Use to check a list of status for the Epson printers connected to the network. Windows Tool You can also update certificates for multiple printers used for WPA2-Enterprise in a batch. TM-T88VI Printer This tool allows you to change the model name for the TM-T88VI-iHUB to TM-...
  • Page 111: Handling

    Chapter 5 Handling Handling This chapter describes basic handling of the printer. Installing and Replacing Roll Paper  Do not open the roll paper cover during printing. The printer may be damaged.  Do not touch the manual cutter with your hands when installing or replacing the roll WARNING paper.
  • Page 112 Install the roll paper in the correct direction. When roll paper is loaded, feed the paper for at least 20 mm. Pull out some roll paper, and close the roll paper cover.
  • Page 113 Chapter 5 Handling Tear off the paper.
  • Page 114: Removing Jammed Paper

    Removing Jammed Paper Do not touch the thermal head and its surroundings. After printing, the thermal head and its surroundings can be very hot. CAUTION When a paper jam occurs, never pull out the paper forcibly. Follow the steps below if the roll paper is jammed. Turn off the printer.
  • Page 115 Chapter 5 Handling Remove the jammed paper. Close the covers.
  • Page 116: If Roll Paper Cover Does Not Open

    If Roll Paper Cover does not Open If a foreign substance has entered the autocutter or the roll paper jams, the autocutter blade cannot return to the correct position and it locks in place. In this situation, the roll paper cover does not open even if you pull the cover open lever.
  • Page 117: Cleaning The Printer

    Doing so may damage or break the parts made of plastic and rubber. Cleaning the Thermal Head/Platen Roller Epson recommends cleaning the thermal head periodically (generally every 3 months) to maintain receipt print quality. Depending on the roll paper used, paper dust may stick to the platen roller and cause an irregular paper feed. To remove the paper dust, clean the platen roller with a cotton swab moistened with water.
  • Page 118: Preparing For Transport

    Preparing for Transport Follow the steps below to transport the printer. Turn off the printer. Remove the power supply connector. Remove the roll paper. Pack the printer upright.
  • Page 119: Replacement Of The Tm-T88V-I

    Chapter 6 Replacement of the TM-T88V-i Replacement of the TM-T88V-i This chapter describes differences in function between TM-T88VI-iHUB and TM-T88V-i. Functional Comparison The table below is the summary of functional differences between the two models. TM-T88VI-iHUB vs TM-T88V-i Comparison Table...
  • Page 120: Additional Functions And Functional Improvements

    LAN unit without having to use a wireless LAN access point. The SimpleAP function is for making settings only. The TM-T88VI-iHUB supports NFC. Epson TM Utility for iOS/Android The TM-T88VI-iHUB allows you to make a variety of settings using the Epson TM Utility for iOS/Android for smart devices running iOS/Android.
  • Page 121: Tm-Intelligent Settings

    Chapter 6 Replacement of the TM-T88V-i TM-Intelligent Settings TM-T88VI-iHUB allows you to configure TM-Intelligent function settings using TM-T88VI Utility, Epson TM Utility for iOS/Android, EpsonNet Config for Windows, and EpsonNet Config (Web version). Beacon Packet Broadcasting With the Beacon dongle connected, TM-T88VI-iHUB can broadcast Beacon packets (Bluetooth low energy...
  • Page 123: Appendix

    Appendix Appendix Product Specifications Printing method Thermal line printing Cutting method Partial cut (cutting with one point in left edge left uncut) Roll paper (single-ply) width 80 mm width paper printing: 79.5 ± 0.5 mm (3.13 ± 0.02") 58 mm width paper printing: 57.5 ± 0.5 mm (2.26 ± 0.02") Interfaces USB: USB 2.0 Full-speed (12Mbps) Wired LAN: 10BASE-T/100BASE-TX...
  • Page 124: Printing Specifications

    Printing Specifications Printing method Thermal line printing Dot density 180 × 180 dpi Printing direction Unidirectional with friction feed (Reverse feed is not supported.) Printing width 80 mm width paper printing: 72.0 mm (2.83"), 512 dots 58 mm width paper printing: 50.8 mm (2.0"), 360 dots Characters per line Font A (12 ×...
  • Page 125: Character Specifications

    Appendix Character Specifications Number of characters Alphanumeric characters: 95 Extended graphics: 128 × 43 pages (including user-defined page) International characters: 18 sets Korean Kanji (KC C5601): 8,366 (for Korean model) Character structure Font A (default): 12 × 24 (including 2-dot horizontal spacing) (W x H dots) Font B: 9 ×...
  • Page 126: Printable Area

    Printable Area 80 mm paper width printing The printable area of paper with a width of 79.5 ± 0.5 mm {3.13 ± 0.02"} is 72.2 ± 0.2 mm {2.84 ± 0.008"} (512 dots), and the space on the right and left sides is approximately 3.7 mm {0.15"}. 79.5±0.5 mm {3.13±0.02”} 0.141±0.05 mm {0.0056±0.002”} 72.2±0.2 mm {2.84±0.008}...
  • Page 127 Appendix 58 mm paper width printing The printable area of paper with a width of 57.5 ± 0.5 mm {2.26 ± 0.02"} is 50.8 ± 0.2 mm {2.00 ± 0.008"} (360 dots), and the space on the left side is approximately 3.7 mm {0.15"} and the space on the right side is approximately 3.0 mm {0.12"}.
  • Page 128: Printing And Cutting Positions

    Printing and Cutting Positions Last line of a previous receipt Manual-cutter position Approx. 29 Approx. 15 Autocutter blade position Center of the print dotline Printable area Paper feed direction [units: mm (All the numeric values are typical.)]  The values above may vary slightly as a result of paper slack or variations in the paper. Take this into account when setting the cutting position of the autocutter.
  • Page 129: Paper Specifications

    AF50KS-E (Jujo Thermal Oy) F5041 (Mitsubishi HiTec Paper Flensburg GmbH) KT55FA, KT48FA (Koehler Paper Group) Epson Certified Media List for Thermal Receipt Printers ☞ https://download.epson-biz.com/?content=sht_tm_media  Paper must not be pasted to the roll paper spool.  The remaining amount of the roll paper when a roll paper near-end is detected differs...
  • Page 130: Electrical Characteristics

    Electrical Characteristics AC Adapter,V Input voltage AC 100-240V Rated frequency 50-60Hz Supply current from the product USB port with charging function 2.1A Power consumption Operating 27.4W (AC100-230 V / 50-60 Hz) Standby 1.5W  Continuously printing high coverage data may activate the over-current protection. Make sure to configure so that print length of high-coverage print does not exceed the values described below.
  • Page 131: Environmental Conditions

    Acoustic noise (operating) Approximately 55 dB (bystander position) Note: The values above are measured in the Epson evaluation condition. Acoustic noise differs depending on the paper used, printing contents, and the setting values, such as print speed or print density.
  • Page 132: External Dimensions And Mass

    External Dimensions and Mass  Width: Approximately 145 mm {5.71"}  Depth: Approximately 195 mm {7.68"}  Height: Approximately 148 mm {5.83"}  Mass: Approximately 1.6 kg {3.53 lb} (except for roll paper) [Units: mm]...
  • Page 133 Appendix [Units: mm]...
  • Page 134: Controllable Peripherals

    Following printer models can be registered as network printer. World Simplified Traditional South Asia Korean wide Chinese Chinese models models models models models ✔ ✔ TM-T88VI-iHUB ✔ ✔ ✔ ✔ ✔ TM-T88VI ✔ ✔ ✔ ✔ ✔ TM-m10 ✔ ✔ ✔...
  • Page 135: Supported Keyboard Layouts

    Appendix Other Device Customer display DM-D30, DM-D110, DM-D210 Key input device Barcode scanner, Keyboard (English, Japanese, German, French, Italian, Spanish, English (UK)) Serial communication device Automatic change dispenser, USB-Serial conversion cable The other devices Cash drawer, MSR (Omron V3TU-FK), Keyboard with MSR (Tipro MID-QM128A), USB composite device (Cherry SPOS) Supported Keyboard Layouts Keyboard type...
  • Page 136 Keyboard type Key layout Italian Spanish English (UK)
  • Page 137: Specifications Of Interfaces

    USB vendor-defined class USB printer class Vendor ID 04b8h 04b8h Product ID 0202h 0E21h String Descriptor Manufacturer EPSON EPSON Product TM-T88VI TM-T88VI Serial number Character string based on the Character string based on the product serial number product serial number...
  • Page 138: Ethernet Interface

    Ethernet Interface Communication specifications 10BASE-T/100BASE-TX Support protocols Protocols Usage IP, ARP, ICMP, UDP, TCP Basic communication protocols LP, LPR, TCP Socket Port Printing protocols HTTP/HTTPS Used in EpsonNet Config (Web version) SNMP, ENPC Used in setting and monitoring DHCP, APIPA Used in automatic setting for the IP address and so on Used to encrypt HTTPS traffic Digital certificate...
  • Page 139: Wi-Fi Interface

    Appendix Item Default settings Community name (Read Only) no value Community name (Read/Write) no value SNMP IP Trap 1 Disabled SNMP IP Trap 2 Disabled Communication mode Auto negotiation IP Filter Disabled * Initial value when "Acquiring the IP Address" is set to "Manual." Wi-Fi Interface ...
  • Page 140: Printing Communication Protocol

    Security Security can be selected from among the following:  WEP  WPA-PSK(AES): WPA-PSK(AES),WPA-PSK(TKIP),WPA2-PSK(AES),WPA2-PSK(TKIP) can be connected  WPA2-PSK: WPA2-PSK(AES),WPA2-PSK(TKIP) can be connected  WPA2-Enterprise Settings in SimpleAP mode (Factory default settings) Parameter Setting value SSID EPSON_Printer Passphrase 12345678 IP Address 192.168.192.168 Subnet mask 255.255.255.0...
  • Page 141 Appendix Socket communication  Port type: TCP communication port for direct printing  Port number: 9100  Port communication direction: bidirectional  Max. simultaneous connections:  Number of connections for which printing is 1 (Other users need to wait until printing is available: completed.) ...
  • Page 142: Nfc Tag

    Notes on Wi-Fi connection Because not all the combinations of the printer and Wireless LAN units have been checked for operation, the operation of the printer in combination with all the Wireless LAN units is not guaranteed. Especially in the ad- hoc mode, the printer may not operate normally, depending on the combination of the device to connect with.
  • Page 143: Bluetooth Low Energy Technology Advertising

    Bluetooth Low Energy Technology Advertising Introduction When you connect the BT820 from Lairedtec to the USB A port on the TM-T88VI-iHUB and turn it on, the Bluetooth low energy technology Advertising Packet is transmitted. By default, the TM-T88VI-iHUB transmits the packet according to the iBeacon Format from Apple. You can also change the data that is transmitted by following the steps in "Changing the Bluetooth Low Energy Technology Advertising Packet"...
  • Page 144 The method of changing settings via an HTTP Request is explained below. Digest authentication You need Digest authentication to communicate with the printer. The default ID and Password are ID: epson, Pass: epson and are the same as the administrator for Network settings.
  • Page 145 Appendix Escape processing for configuration scripts When reading/writing a configuration script for a printer, the strings (content of the configuration script) being transmitted and received uses the following escape processing. However, escape is not performed for uXXXX (hexadecimal strings) such as Japanese. Table 2 Escape Processing Escape Description...
  • Page 146 Response Table 5 Response Header Content-Type: application/json; charset=utf-8 Access-Control-Allow-Origin: * Access-Control-Allow-Methods: POST, GET, OPTIONS, HEADER Access-Control-Allow-Headers: Content-Type, Content-Length, Authorization X-Content-Type-Options: nosniff X-XSS-protection: 1; mode=block X-Frame-Options: deny Content-Security-Policy: default-src 'none' WWW-Authenticate: Digest realm="<IPaddr>", nonce="xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx", qop="auth" Table 6 Response Function GET Parameter Results Response Acquires the configuration script...
  • Page 147 Appendix Response Status Response Body 404 Not Found "message": "Requested file not found" "detail": null "description" : null 400 Bad Request "message": "Invalid Parameter" "detail": null "description" : null Table 8 GET Response Body (Type=status) Response Status Response Body 200 OK "message": "Success", The HCI Version for the Bluetooth "detail": null,...
  • Page 148 When changing using a low frequency less than once an hour, you can save to non-volatile memory; however, when changing at a higher frequency, you need to save to volatile memory. When the change is successful, the advertising data is changed. Request Content-Type: text/json;...
  • Page 149 Appendix Function POST Parameters Results Response Updates the configuration Update successful 200 OK script in non-volatile “type” : “static”, memory “description”: “<The It has following header: string for the configura- X-RateLimit-Limit: 1 tion script that per- X-RateLimit-Remaining: 0 formed escape X-RateLimit-Reset: xx processing>”...
  • Page 150 Table 11 POST Response Body Response Status Body 200 OK "message": "Success", "detail": null, "description" : < The string for the configuration script that performed escape processing > 400 Bad Request "message": "Invalid Parameter", "detail": “***”, (see Table 12) "description" : null 413 Request Entity Too Large "message": "Request Entity Too Large", "detail": null,...
  • Page 151 Appendix Case Body No Type specified Or an invalid parameter has been "message": " Invalid Parameter ", specified "detail": “A parameter ‘type’ or ‘description’ is not specified”, "description" : null When detecting a string with invalid escape processing "message": " Invalid Parameter ", "detail": “Invalid parameter is found”, "description": null Table 13 500 Internal Server Error Details...
  • Page 152 Starting and stopping Bluetooth low energy technology Advertising Format: cmd 0x08 0x000A n Function: Starting and stopping transmission of the Advertising packet. Parameter n Length Function 2 characters Advertising stop 2 characters Advertising start When specifying a start point, make sure you start Advertising using this command before "Bluetooth low energy technology Advertising Packet specifications"...
  • Page 153 Appendix Bluetooth low energy technology Advertising Packet specifications Format: cmd 0x08 0x0008 d1 d2 … d32 Function: Sets the Data for the Bluetooth low energy technology Advertising packet. Specify all from d1 to d32. If these are not necessary, specify 00 for each one. Definition Length Default (iBeacon)
  • Page 154 1 byte ID value assigned to the 02h is used for the TM-T88VI. printer model. 00: no use 01: reserve 02: TM-T88VI 03: TM-T88VI-iHUB $MACn 1 byte Value for #n in the MAC Available range: address. $MAC1,$MAC2, $MAC3, $MAC4, $MAC5, $MAC6...
  • Page 155: Character Code Tables

    Appendix Character Code Tables Refer to the following URL regarding the character code table. http://www.epson-biz.com/pos/reference/charcode/...

Table of Contents