Epson T88IVP - TM Two-color Thermal Line Printer User guide

EPSON OPOS ADK MANUAL
APPLICATION DEVELOPMENT
GUIDE
POSPrinter
(TM-T88IV)
Version 2.65 Jul. 2009

Notes
(1) Reproduction of any part of this documentation by any means is prohibited.
(2) The contents of this documentation are subject to change without notice.
(3) Comments and notification of any mistakes in this documentation are gratefully
accepted.
(4) This software cannot be used with other equipment that the specified.
(5) EPSON will not be responsible for any consequences resulting from the use of any
information in this documentation.
Trademarks
Microsoft®, Windows®, Windows Vista™, Visual Basic® and Visual C++® are trademarks
or registered trademarks of Microsoft Corporation in the United States and/or other
countries.
QR Code is a registered trademark of Denso Wave Incorporated.
EPSON® and ESC/POS® are registered trademarks of SEIKO EPSON CORPORATION.
Other product and company names used herein are for identification purposes only and
may be trademarks or registered trademarks of their respective companies.
Copyright © 2000-2009 SEIKO EPSON CORPORATION

Version 2.65 Jul. 2009
APPLICATION DEVELOPMENT GUIDE
POSPrinter (TM-T88IV)
iii
Contents
SECTION 1. INTRODUCTION.......................................................................................1
SECTION 2. DETAILS ON SETTINGS..........................................................................2
2.1 References of Firmware Versions ............................................................................2
2.2 Settings of DIP Switches .......................................................................................... 2
2.3 Port Information ....................................................................................................... 6
2.4 Device Settings .........................................................................................................8
2.4.1 Usable Device Specific Settings.........................................................................8
2.4.2 Paper Type Setting.............................................................................................8
SECTION 3. FUNCTION DETAILS ...............................................................................9
3.1 Property Set Values and Default Values.................................................................9
3.1.1 Capability Set Values.........................................................................................9
3.1.2 List Properties..................................................................................................11
3.1.3 Width and Height Properties .......................................................................... 12
3.1.4 Common Property Strings ............................................................................... 13
3.1.5 PageMode Print Properties.............................................................................. 13
3.2 Methods...................................................................................................................14
3.3 Escape Sequences ................................................................................................... 15
3.4 Printable Barcode Type .......................................................................................... 16
3.5 Power Condition Reports........................................................................................ 16
3.6 Synchronous Processing ......................................................................................... 16
3.7 Printing Positions ................................................................................................... 17
3.8 Electronic Logo Function (NVRAM) ...................................................................... 17
3.9 Printable bitmap types and sizes........................................................................... 18
3.10 Color Bitmap Printing .......................................................................................... 18
3.11 Maintenance Counter ........................................................................................... 19
3.12 Automatic Recovery Function .............................................................................. 19
3.13 Output without Flow Control on the USB/Ethernet Interfaces ......................... 19
SECTION 4. WARNINGS..............................................................................................20

Version 2.65 Jul. 2009
APPLICATION DEVELOPMENT GUIDE
POSPrinter (TM-T88IV)
1
Section 1. Introduction
This manual describes the method of use and related items, as well as machine-specific
precautions, when the EPSON TM-T88IV Series POS Printers are used with the EPSON
OPOS ADK program.
This manual applies to the following devices.
Device List
Serial Parallel USB Ethernet
TM-T88IV TM-T88IVP TM-T88IVU TM-T88IVE
TM-T88IVM TM-T88IVPM TM-T88IVMU TM-T88IVME
Before reading the manual, see the following explanation about the characteristic of the
TM-T88IV models.
•TM-T88IV
Station: Receipt (Line Thermal 180 dpi X 180 dpi)
Color printing: 2-Color Printing
Throughout the manual, the various model names will be referred to as TM-T88IV.
Compatibility mode
The compatibility mode for upward compatibility was added in OPOS Ver2.60.
For the details of the compatibility mode, please refer to “EPSON OPOS ADK MANUAL
APPLICATION DEVELOPMENT GUIDE Compatibility Mode”.

Version 2.65 Jul. 2009
APPLICATION DEVELOPMENT GUIDE
POSPrinter (TM-T88IV)
2
Section 2. Details on Settings
This section describes connection configurations and how to make the settings for the
TM-T88IV Series printers.
2.1 References of Firmware Versions
Refer to the release notes (Relnote.txt).
2.2 Settings of DIP Switches
Confirm that the following settings have been made correctly.
1) Serial port
DIP-SW1 DIP-SW2
No. Setting No. Setting
1 OFF Recommended 1 OFF Settable
2 OFF Recommended 2 OFF Settable
3 OFF Fixed at OFF 3 OFF Settable
4 OFF Fixed at OFF 4 OFF Settable
5 OFF Settable 5 OFF Fixed at OFF
6 OFF Settable 6 OFF Fixed at OFF
7 ON Settable 7 OFF Fixed at OFF
8 OFF Settable 8 OFF Fixed at OFF
It is possible to change the settings of DIP-SW1-1 (Processing of the data input
error) and DIP-SW1-2 (Specification of the received buffer capacity), but it is
recommended to leave them OFF.
Set DIP-SW1-3 (Handshake) to DTR/DSR.
Set DIP-SW1-4 (Bit length) to 8 bits.
Set DIP-SW1-5 to DIP-SW1-8 in accordance with the port information.
The described set values are the default values. For the details, refer to the
product manual of the POSPrinter. Also, if these settings are changed, make sure
to change the port information using the SetupPOS utility.
Set DIP-SW2-2 in accordance with whether or not a customer display is
connected. If connected, set to ON. If not, set to OFF.

Version 2.65 Jul. 2009
APPLICATION DEVELOPMENT GUIDE
POSPrinter (TM-T88IV)
3
Set DIP-SW2-3 and DIP-SW2-4 (Specification of the print density) to match the
environment of use.
Make other settings in accordance with the settings described above.
When using with the power saving mode, set DIP-SW2-3 and DIP-SW2-4 to ON.
2) Parallel Port
DIP-SW 1 DIP-SW 2
No. Setting No. Setting
1 OFF Recommended 1 OFF Settable
2 OFF Recommended 2 OFF Fixed at OFF
3 OFF Fixed at OFF 3 OFF Settable
4 OFF Fixed at OFF 4 OFF Settable
5 OFF Fixed at OFF 5 OFF Fixed at OFF
6 OFF Fixed at OFF 6 OFF Fixed at OFF
7 OFF Fixed at OFF 7 OFF Fixed at OFF
8 OFF Fixed at OFF 8 ON Fixed at ON
It is possible to change the settings of DIP-SW1-1 (Auto line feed) and
DIP-SW1-2 (Specification of the received buffer capacity), but it is recommended
to leave them OFF.
Set DIP-SW2-3 and DIP-SW2-4 (Specification of the print density) to match the
environment of use.
Make other settings in accordance with the settings described above.
When using with the power saving mode, set DIP-SW2-3 and DIP-SW2-4 to ON.
When parallel I/F is used with Windows 2000, Windows XP or Windows Vista,
please set DIP-SW2-1 (BUSY condition) to ON (Receive buffer full).

Version 2.65 Jul. 2009
APPLICATION DEVELOPMENT GUIDE
POSPrinter (TM-T88IV)
4
3) USB Port
DIP-SW1 DIP-SW2
No. Setting No. Setting
1 OFF Recommended 1 OFF Recommended
2 OFF Recommended 2 OFF Fixed at OFF
3 OFF Fixed at OFF 3 OFF Settable
4 OFF Fixed at OFF 4 OFF Settable
5 OFF Fixed at OFF 5 OFF Fixed at OFF
6 OFF Fixed at OFF 6 OFF Fixed at OFF
7 OFF Fixed at OFF 7 OFF Fixed at OFF
8 OFF Fixed at OFF 8 ON Fixed at ON
It is possible to change the settings of DIP-SW1-1 (Auto line feed) and
DIP-SW1-2 (Specification of the received buffer capacity), but it is recommended
to leave them OFF.
Set DIP-SW2-3 and DIP-SW2-4 (Specification of the print density) to match the
environment of use.
Make other settings in accordance with the settings described above.
When using with the power saving mode, set DIP-SW2-3 and DIP-SW2-4 to ON.

Version 2.65 Jul. 2009
APPLICATION DEVELOPMENT GUIDE
POSPrinter (TM-T88IV)
5
4) Ethernet Port
DIP-SW1 DIP-SW2
No. Setting No. Setting
1 OFF Recommended 1 OFF Recommended
2 OFF Recommended 2 OFF Fixed at OFF
3 OFF Fixed at OFF 3 OFF Settable
4 OFF Fixed at OFF 4 OFF Settable
5 OFF Fixed at OFF 5 OFF Fixed at OFF
6 OFF Fixed at OFF 6 OFF Fixed at OFF
7 OFF Fixed at OFF 7 OFF Fixed at OFF
8 OFF Fixed at OFF 8 ON Fixed at ON
It is possible to change the settings of DIP-SW1-1 (Auto line feed) and
DIP-SW1-2 (Specification of the received buffer capacity), but it is recommended
to leave them OFF.
Set DIP-SW2-3 and DIP-SW2-4 (Specification of the print density) to match the
environment of use.
Make other settings in accordance with the settings described above.
When using with the power saving mode, set DIP-SW2-3 and DIP-SW2-4 to ON.

Version 2.65 Jul. 2009
APPLICATION DEVELOPMENT GUIDE
POSPrinter (TM-T88IV)
6
2.3 Port Information
1) Port information when serial port is used
The port information that can be set with the SetupPOS utility is as follows.
Item Setting range
Baud rate [bps] 4800, 9600, 19200, 38400,57600, 115200
Bit length [bit] 8
Parity NONE, ODD, EVEN
Stop bit [bit] 1
Handshake DTR/DSR
Output buffer length [byte] 32 to 1024
Output interval time [ms] 0 to 9999
The default settings are as shown in the following table.
Item Setting range
Baud rate [bps] 9600
Bit length [bit] 8
Parity NONE
Stop bit [bit] 1
Handshake DTR/DSR
Output buffer length [byte] 1024
Output interval time [ms] 2500
2) Port information when using parallel port
The port information that can be set with the SetupPOS utility is as follows.
Item Setting range
Output buffer length [byte] 32 to 1024
Output interval time [ms] 0 to 9999
The default settings are as shown in the following table.
Item Setting range
Output buffer length [byte] 1024
Output interval time [ms] 2500

Version 2.65 Jul. 2009
APPLICATION DEVELOPMENT GUIDE
POSPrinter (TM-T88IV)
7
3) Port information when using USB port
The port information that can be set with the SetupPOS utility is as follows.
Item Setting range
Output interval time [ms] 0 to 9999
The default setting is as shown in the following table.
Item Setting range
Output interval time [ms] 2500
4) Port information when using Ethernet port
The port information that can be set with the SetupPOS utility is as follows.
Item Setting range
Output buffer length [byte] 32 to 1024
Output interval time [ms] 0 to 9999
The default settings are as shown in the following table.
Item Setting range
Output buffer length [byte] 1024
Output interval time [ms] 2500

Version 2.65 Jul. 2009
APPLICATION DEVELOPMENT GUIDE
POSPrinter (TM-T88IV)
8
2.4 Device Settings
The following explanation is about the settings for TM-T88IV.
2.4.1 Usable Device Specific Settings
For the TM-T88IV, the following device specific settings are settable by the
SetupPOS utility. For the detail, please refer to the corresponding part of the
Section 2 of “EPSON OPOS ADK MANUAL APPLICATION DEVELOPMENT
GUIDE POSPrinter (TM Series)”
Tab Settings
Disable panel buttons
Assume print complete when data output finishes
Ignore firmware version check
Homogenize Error Codes *1
General
Output complete timeout [s]
Paper TypePaper Paper Width [mm]: LineWidth [dot]: LineCharsList
Bitmap TMFlogo...
Method
Brightness
Color Bitmap
Primary
ERROR
OFFLINE
Log file name (full path name)
Status Log
Maximum file size [KB]
Default Value *2 Multilingual font
Receipt Characters per LinePrinting Properties Receipt Line Spacing [dots]
*1 The operations differ by the firmware versions. See the corresponding part of the
section 2 of this manual.
*2 Available only for the Multilingual character model.
2.4.2 Paper Type Setting
The TM-T88IV models support the following paper type. After adding the
TM-T88IV by the SetupPOS utility, open the “Device Specific Settings” dialog box.
In the “Paper” tab the paper type could be selected..
The settable paper types are as follows:
•Normal
•2-Color Thermal
The default paper type is set to Normal.

Version 2.65 Jul. 2009
APPLICATION DEVELOPMENT GUIDE
POSPrinter (TM-T88IV)
9
Section 3. Function Details
This section describes the functions of the TM-T88IV printers in details. Supplementary
explanation of the parts not described in detail in the "UPOS" is also given here.
3.1 Property Set Values and Default Values
The following explanation is about the property set values and the default values.
3.1.1 Capability Set Values
The following values are the Capability set values.
Capability Name Setting Value
CapTransaction TRUE
CapCoverSensor TRUE
CapConcurrentRecSlp FALSE
CapConcurrentJrnSlp FALSE
CapConcurrentJrnRec FALSE
CapConcurrentPageMode FALSE
CapCharacterSet *1 PTR_CCS_
ASCII
CapMapCharacterSet FALSE
CapJrnUnderline FALSE
CapJrnNearEndSensor FALSE
CapJrnItalic FALSE
CapJrnEmptySensor FALSE
CapJrnDwideDhigh FALSE
CapJrnDwide FALSE
CapJrnDhigh FALSE
CapJrnColor 0
CapJrnCartridgeSensor 0
CapJrnBold FALSE
CapJrn2Color FALSE
CapJrnPresent FALSE
CapRecPageMode TRUE
CapRecUnderline TRUE
CapRecStamp FALSE
CapRecRotate180 TRUE
CapRecRight90 TRUE

Version 2.65 Jul. 2009
APPLICATION DEVELOPMENT GUIDE
POSPrinter (TM-T88IV)
10
CapRecPapercut TRUE
CapRecNearEndSensor TRUE
CapRecMarkFeed 0
CapRecLeft90 TRUE
CapRecItalic FALSE
CapRecEmptySensor TRUE
CapRecDwideDhigh TRUE
CapRecDwide TRUE
CapRecDhigh TRUE
CapRecColor PTR_COLOR_PRIMARY |
PTR_COLOR_CUSTOM1 *2 *3
CapRecCartridgeSensor 0
CapRecBold TRUE
CapRecBitmap TRUE
CapRecBarCode TRUE
CapRec2Color TRUE *2 *4
CapRecPresent TRUE
CapSlpUnderline FALSE
CapSlpRotate180 FALSE
CapSlpRight90 FALSE
CapSlpNearEndSensor FALSE
CapSlpLeft90 FALSE
CapSlpItalic FALSE
CapSlpEmptySensor FALSE
CapSlpDwideDhigh FALSE
CapSlpDwide FALSE
CapSlpDhigh FALSE
CapSlpColor 0
CapSlpCartridgeSensor 0
CapSlpBothSidesPrint FALSE
CapSlpBold FALSE
CapSlpBitmap FALSE
CapSlpBarCode FALSE
CapSlp2Color FALSE
CapSlpFullslip FALSE
CapSlpPresent FALSE
CapSlpPageMode FALSE
*1 If Multilingual character model, “PTR_CCS_KANJI” is set.
*2 Accordance with the selected paper in the SetupPOS utility, the set value will differ.
When selecting Normal Paper (Default), two colors print cannot be executed.
*3 If using to the power saving mode by setting of DIP-SW2-3 and DIP-SW2-4,

Version 2.65 Jul. 2009
APPLICATION DEVELOPMENT GUIDE
POSPrinter (TM-T88IV)
11
CapRecColor property is set to PTR_COLOR_PRIMARY.
*4 If using to the power saving mode by setting of DIP-SW2-3 and DIP-SW2-4,
CapRec2Color property is set to FALSE.
3.1.2 List Properties
The List Properties are explained in the following.
List Property Settings
CharacterSetList (TM-T88IV)
”255,437,850,852,858,860,863,865,866,998,999,
1252” *1
(TM-T88IVM)*2
“120,121,126,130,131,437”*3
JrnLineCharsList “”
RecLineCharsList (Font A) “42” <Default>
(Font B) “56”
SlpLineCharsList “”
RecBarCodeRotationList “0,R90, L90, 180”
RecBitmapRotationList ”0,R90, L90, 180”
SlpBarCodeRotationList “”
SlpBitmapRotationList “”
FontTypefaceList “”
*1 If Multilingual character model, “936” or “950” is added to the list.
*2 Device is limited to South Asia model.
*3 This list is for South Asia character model.

Version 2.65 Jul. 2009
APPLICATION DEVELOPMENT GUIDE
POSPrinter (TM-T88IV)
12
3.1.3 Width and Height Properties
The width and height properties are described below. Settings
Property Default
Value Maximum value [dot] Minimum value [dot]
RecLineSpacing 30 127 24
*1
JrnLineSpacing X X X
SlpLineSpacing X X X
SlpLineHeight [dot] X
RecLineHeight [dot] (Font A) 24
(Font B) 17
JrnLineHeight [dot] X
SlpLineWidth [dot] X
RecLineWidth [dot] 512
JrnLineWidth [dot] X
RecSidewaysMaxLines 17
*2
RecSidewaysMaxChars (Font A) 69 *3
(Font B) 92 *3
RecLinesToPaperCut 5
*4
SlpSidewaysMaxLines X
SlpSidewaysMaxChars X
SlpMaxLines X
X: No settings
*1 When Font A is selected. In the case of a line thermal station, the Line Spacing setting is
identical with the height of the characters which means that it can be set at up to 17
when Font B is selected.
*2 It can be changed by the settings of the RecLineSpacing or the RecLineHeight.
*3It can be changed by the settings of the font width.
•When the RecLineSpacing is 0, the RecLinesToPaperCut is –1.
*4 It can be changed by the settings of the RecLineSpacing or the character height.

Version 2.65 Jul. 2009
APPLICATION DEVELOPMENT GUIDE
POSPrinter (TM-T88IV)
13
3.1.4 Common Property Strings
The Device information properties are described below.
I/F DeviceName DeviceDescription
TM-T88IV EPSON TM-T88IV POS Printer
S TM-T88IVM EPSON TM-T88IVM POS Printer
TM-T88IVP EPSON TM-T88IVP POS Printer
P TM-T88IVPM EPSON TM-T88IVPM POS Printer
TM-T88IVU EPSON TM-T88IVU POS Printer
U TM-T88IVMU EPSON TM-T88IVMU POS Printer
TM-T88IVE EPSON TM-T88IVE POS Printer
E TM-T88IVME EPSON TM-T88IVME POS Printer
I/F indicate the connected interface.
The following is the list of the four connecting interfaces.
S: Serial
P: Parallel
U: USB
E: Ethernet
3.1.5 PageMode Print Properties
The Device information properties are described below.
Station *2
Property Journal Receipt Slip
PageModeArea - <monochrome>
“512”, “1662”
<2-color>
“512”, “831”
-
PageModeDescriptor *1 - BM/BC/BMR/BCR -
*1 Following setting values are used for the PageModeDescriptor property.
BM: Bitmap printing is available.
BC: Barcode printing is available.
BMR: Rotated printing of bitmap is available.
BCR: Rotated printing of barcode is available.
*2 If the Station’s CapRecPageMode property value is FALSE, the PageModeArea
property shall have ” ” and the PageModeDescriptor property shall have ”0” respectively
as a setting value.

Version 2.65 Jul. 2009
APPLICATION DEVELOPMENT GUIDE
POSPrinter (TM-T88IV)
14
3.2 Methods
The following explanation is about supported/unsupported Methods, and the
detailed information.
Method Supported/Unsupported Compatibility with the
PageMode printing
PrintNormal O O
PrintTwoNormal X X
PrintImmediate O O*1
PrintBarCode O O*2
PrintBitmap O O*3
PrintMemoryBitmap O O*3
CutPaper O
(1~100: Cutting with one point
of the bottom left corner uncut)
X
MarkFeed X X
ChangePrintSide X X
ValidateData O O
TransactionPrint O O
SetLogo O O
SetBitmap O O
RotatePrint O X
EndRemoval X X
BeginRemoval X X
EndInsertion X X
BeginInsertion X X
ClearPrintArea O O
PageModePrint O O
O:Supported
X :Unsupported
*1 If the specified Station is ready to print, the printing data shall not be stored in the
PageMode printing buffer but, instead, go straight to printing. If the Station is not ready
to print, an error is returned.
*2 If other than “LEFT” is specified for the printing position of barcode, the printing shall be
done, regardless of the PageModeHorizontalPosition property setting, based on the
PageModePrintArea property setting in the horizontal direction.
*3 If other than “LEFT” is specified for the printing position of bitmap, the printing shall be
done, regardless of the PageModeHorizontalPosition property setting, based on the
PageModePrintArea property setting in the horizontal direction.

Version 2.65 Jul. 2009
APPLICATION DEVELOPMENT GUIDE
POSPrinter (TM-T88IV)
15
3.3 Escape Sequences
The following figure is about supported/unsupported Escape Sequences.
Escape Sequence Supported/Unsupported Compatibility with the
PageMode printing
#P 0~100 X
#fP 0~100 X
#sP X X
sL X X
#B O O
tL O O
bL O O
#R O O
#lF 0~9999 O
#uF Base Pitch [inch] 0~ equiv. 50 cm O
#rF Maximum [inch] X X
#E 0~65535 X
#fT X X
bC O O
!bC O O
#uC 1~2 O
iC X X
!iC X X
#rC 1~2 O
rvC O O
!rvC O O
#sC X X
#fC X X
tbC X X
!tbC X X
tpC X X
!tpC X X
1C O O
2C O O
3C O O
4C O O
#hC 1~8 O
#vC 1~8 O
cA O O
*1
rA O O
*1
lA O O
N O O
O :Supported
X :Unsupported
Numbers: Settable range
*1 Regardless of the PageModeHorizontalPosition property setting, center or right adjust
what is to be printed based on the PageModePrintArea property setting in the horizontal
direction.

Version 2.65 Jul. 2009
APPLICATION DEVELOPMENT GUIDE
POSPrinter (TM-T88IV)
16
3.4 Printable Barcode Type
The TM-T88IV allows the following barcode types.
•Code 128
•Code 128 Parsed
•Code 93
•Codabar
•ITF
•Code 39
•JAN 13 (EAN 13)
•JAN 8 (EAN 8)
•UPC-E
•UPC-A
•PDF417
•QRCODE
3.5 Power Condition Reports
The TM-T88IV supports Power Condition Reports as follows.
Powered on reporting: Supported
Powered off reporting: Unsupported
3.6 Synchronous Processing
The TM-T88IV uses Process ID to determine output completion.
Use of the Process ID allows multiple print commands to be queued to the printer
simultaneously. For this reason, Asynchronous output (AsyncMode = TRUE)
gives a performance improvement.

Version 2.65 Jul. 2009
APPLICATION DEVELOPMENT GUIDE
POSPrinter (TM-T88IV)
17
3.7 Printing Positions
The TM-T88IV supports the function for setting printing position.
Function Receipt
Left margin O
Printing Position O
O: Supported
X: Unsupported
When the left margin setting function is supported, it is possible to specify the
horizontal printing position of the bitmap or barcode by dots unit.
When the printing position settings are supported, it is possible to specify the
horizontal printing position of the text, bitmap, or the barcode to the left, center, or
the right side of the paper.
3.8 Electronic Logo Function (NVRAM)
The TM-T88IV models feature an electronic logo function (NVRAM). To use
NVRAM, start up TMFlogo utility from “Device Specific Settings” of SetupPOS
utility, and register image files (BMP style) with NVRAM in advance.
For the details of the registration, please refer to the “Help” of “TMFlogo utility”
and/or “EPSON OPOS ADK MANUAL User’s Manual TMFlogo Utility”.
To print image files registered with NVRAM, please use the either of the following
DirectIO:
PTR_DI_FLASH_BITMAP
PTR_DI_FLASH_BITMAP2.
Please refer to the corresponding part of the Section 4 of “EPSON OPOS ADK
MANUAL APPLICATION DEVELOPMENT GUIDE POSPrinter (TM Series)” for
detail. The available NVRAM sizes are as follows:
TM-T88IV : 262144 bytes