EPSON OPOS ADK MANUAL

APPLICATION DEVELOPMENT GUIDE POSPrinter (TM-L60II)

Version 2.61 Feb. 2008

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. 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-2008 SEIKO EPSON CORPORATION

Version 2.61

Feb. 2008

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..........................................................................................................4 2.4 Device Settings ............................................................................................................5

2.4.1 Usable Device Specific Settings ..........................................................................5

SECTION 3. FUNCTION DETAILS ..............................................................................6 3.1 Property Set Values and Default Values ..................................................................6

3.1.1 Capability Set Values...........................................................................................6 3.1.2 List Properties ......................................................................................................8 3.1.3 Width and Height Properties ..............................................................................8 3.1.4 Common Property Strings ...................................................................................9 3.1.5 PageMode Print Properties .................................................................................9
3.2 Methods......................................................................................................................10 3.3 Escape Sequences......................................................................................................11 3.4 Printable Barcode Type ............................................................................................12 3.5 Power Condition Reports..........................................................................................12 3.6 Synchronous Processing ...........................................................................................12 3.7 Printing Positions .....................................................................................................12 3.8 Electronic Logo Function (NVRAM)........................................................................13 3.9 Printable Bitmap Types and Sizes ..........................................................................13 3.10 Maintenance Counter .............................................................................................13 3.11 Automatic Recovery Function ................................................................................13 3.12 MarkFeed Function ................................................................................................13 3.13 Label Receipt DirectIO ...........................................................................................13 3.14 Label receipt Usage ................................................................................................14 SECTION 4. WARNINGS .............................................................................................15

iii APPLICATION DEVELOPMENT GUIDE POSPrinter (TM-L60II)

Version 2.61

Feb. 2008

Section 1. Introduction

This manual describes the method of use and related items, as well as machine-specific precautions, when the EPSON TM-L60II Series POS Printers are used with the EPSON OPOS ADK program. This manual applies to the following devices. Device List Serial TM-L60II Parallel TM-L60IIP

Before reading the manual, see the following explanation about the characteristic of the TM-L60II models. Station: Receipt (Line thermal 180 dpi X 180 dpi) Label printing. Throughout the manual, the various model names will be referred to as TM-L60II. 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.

1 APPLICATION DEVELOPMENT GUIDE POSPrinter (TM-L60II)

Version 2.61

Feb. 2008

Section 2. Details on Settings

This section describes connection configurations and how to make the settings for the TM-L60II 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 No. 1 2 3 4 5 6 7 8 Setting OFF OFF OFF OFF OFF OFF ON OFF Recommended Recommended Fixed at OFF Fixed at OFF Settable Settable Settable Settable DIP-SW2 No. 1 2 3 4 5 6 7 8 Setting OFF OFF OFF OFF ON ON OFF OFF Settable Settable Settable Settable Fixed at ON Settable Fixed at 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 and DIP-SW2-3 (Specification of the print density) to match the environment of use. 2 APPLICATION DEVELOPMENT GUIDE POSPrinter (TM-L60II)

Version 2.61

Feb. 2008

Set DIP-SW2-6 (Select paper) to match the environment of use. Make other settings in accordance with the settings described above. 2) Parallel Port DIP-SW1 No. 1 2 3 4 5 6 7 8 Setting OFF OFF OFF OFF OFF ON OFF OFF Recommended Recommended Settable Settable Settable Fixed at ON Settable Fixed at OFF

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-SW1-4 and DIP-SW1-5 (Specification of the print density) of to match the environment of use. Set DIP-SW1-7 (Select paper) to match the environment of use. When parallel I/F is used with Windows 2000, Windows XP or Windows Vista, please set Busy Condition of DIP-SW1-3 to ON (Buffer full). Make other settings in accordance with the settings described above.

3 APPLICATION DEVELOPMENT GUIDE POSPrinter (TM-L60II)

Version 2.61

Feb. 2008

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 Baud rate [bps] Bit length [bit] Parity Stop bit [bit] Handshake Output buffer length [byte] Output interval time [ms] Setting range 2400,4800,9600,19200 8 NONE, ODD, EVEN 1 DTR/DSR 32 to 1024 0 to 9999

The default settings are as shown in the following table. Item Baud rate [bps] Bit length [bit] Parity Stop bit [bit] Handshake Input buffer length [byte] Output buffer length [byte] Output interval time [ms] 9600 8 NONE 1 DTR/DSR 1024 1024 2500 Setting range

2) Port information when using parallel port The port information that can be set with the SetupPOS utility is as follows. Item Output buffer length [byte] Output interval time [ms] 32 to 1024 0 to 9999 Setting range

The default settings are as shown in the following table. Item Output buffer length [byte] Output interval time [ms] 1024 2500 4 APPLICATION DEVELOPMENT GUIDE POSPrinter (TM-L60II) Setting range

Version 2.61

Feb. 2008

2.4 Device Settings The following explanation is about the settings for TM-L60II. 2.4.1 Usable Device Specific Settings For the TM-L60II, the following device specific settings are settable by the SetupPOS utility. For the detail, please refer to the Section 2 of EPSON OPOS ADK MANUAL APPLICATION DEVELOPMENT GUIDE POSPrinter (TM Series). Tab General Disable panel buttons Assume print complete when data output finishes Ignore firmware version check Homogenize Error Codes Output complete timeout Color Bitmap Method Brightness Primary Status Log ERROR OFFLINE Log file name (full path name) Maximum file size [KB] Settings

5 APPLICATION DEVELOPMENT GUIDE POSPrinter (TM-L60II)

Version 2.61

Feb. 2008

Section 3. Function Details

This section describes the functions of the TM-L60II 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 CapTransaction CapCoverSensor CapConcurrentRecSlp CapConcurrentJrnSlp CapConcurrentJrnRec CapConcurrentPageMode CapCharacterSet CapMapCharacterSet CapJrnUnderline CapJrnNearEndSensor CapJrnItalic CapJrnEmptySensor CapJrnDwideDhigh CapJrnDwide CapJrnDhigh CapJrnColor CapJrnCartridgeSensor CapJrnBold CapJrn2Color CapJrnPresent CapRecPageMode CapRecUnderline CapRecStamp CapRecRotate180 CapRecRight90 CapRecPapercut 6 APPLICATION DEVELOPMENT GUIDE POSPrinter (TM-L60II) Set Value TRUE TRUE FALSE FALSE FALSE FALSE PTR_CCS_ASCII FALSE FALSE FALSE FALSE FALSE FALSE FALSE FALSE 0 0 FALSE FALSE FALSE TRUE TRUE FALSE TRUE TRUE FALSE

Version 2.61

Feb. 2008

CapRecNearEndSensor CapRecMarkFeed CapRecLeft90 CapRecItalic CapRecEmptySensor CapRecDwideDhigh CapRecDwide CapRecDhigh CapRecColor CapRecCartridgeSensor CapRecBold CapRecBitmap CapRecBarCode CapRec2Color CapRecPresent CapSlpUnderline CapSlpRotate180 CapSlpRight90 CapSlpNearEndSensor CapSlpLeft90 CapSlpItalic CapSlpEmptySensor CapSlpDwideDhigh CapSlpDwide CapSlpDhigh CapSlpColor CapSlpCartridgeSensor CapSlpBothSidesPrint CapSlpBold CapSlpBitmap CapSlpBarCode CapSlp2Color CapSlpFullslip CapSlpPresent CapSlpPageMode

TRUE PTR_MF_TO_TAKEUP PTR_MF_TO_NEXT_TOF TRUE FALSE TRUE TRUE TRUE TRUE PTR_COLOR_PRIMARY 0 TRUE TRUE TRUE FALSE TRUE FALSE FALSE FALSE FALSE FALSE FALSE FALSE FALSE FALSE FALSE 0 0 FALSE FALSE FALSE FALSE FALSE FALSE FALSE FALSE

7 APPLICATION DEVELOPMENT GUIDE POSPrinter (TM-L60II)

Version 2.61

Feb. 2008

3.1.2 List Properties The List Properties are explained in the following. List Property CharacterSetList JrnLineCharsList RecLineCharsList (Label Paper) *1 RecLineCharsList (Normal Paper) *1 SlpLineCharsList RecBarCodeRotationList RecBitmapRotationList SlpBarCodeRotationList SlpBitmapRotationList FontTypefaceList
*1

Settings 437,850,858,860,863,865,998 30,40 32,42 0,R90, L90, 180 0,R90, L90, 180

In selecting paper type with the DIP-SW, specified paper type (Label Paper or Normal Paper) is settable.

3.1.3 Width and Height Properties The width and height properties are described below. Settings Property RecLineSpacing JrnLineSpacing SlpLineSpacing SlpLineHeight[dot] RecLineHeight[dot] JrnLineHeight[dot] SlpLineWidth[dot] RecLineWidth[dot] (Label Paper) *1 RecLineWidth[dot] (Normal Paper) *1 JrnLineWidth[dot] RecSidewaysMaxLines RecSidewaysMaxChars (Select Font A) RecSidewaysMaxChars (Select Font B) RecLinesToPaperCut SlpSidewaysMaxLines SlpSidewaysMaxChars SlpMaxLines
*1

Default Value 30 X X

Maximum value [dot] 127 X X X 24 X X 368 384 X 12 *3 94 *4 123 *4 5 *2 X X X

Minimum value [dot] 24 X X

X : No settings In selecting paper type with the DIP-SW, specified paper type (Label Paper or Normal Paper) is settable.

8 APPLICATION DEVELOPMENT GUIDE POSPrinter (TM-L60II)

Version 2.61

Feb. 2008

*2 *3

It can be changed by the settings of the RecLineSpacing or the character height. It can be changed by the settings of the XxxLineSpacing or the XxxLineHeight. Also, it depends on the paper setting (Label Paper or Normal Paper). *4 It can be changed by the settings of the font width.

3.1.4 Common Property Strings The Device information properties are described below. I/F S P DeviceName TM-L60II TM-L60IIP DeviceDescription EPSON TM-L60II POS Printer EPSON TM-L60IIP POS Printer

I/F indicate the connected interface. The following is the list of the two connecting interfaces. S: Serial P: Parallel

3.1.5 PageMode Print Properties The Device information properties are described below. TM-L60II (Roll paper) Property PageModeArea PageModeDescriptor *1 Station *2 Journal Receipt 384, 1108 BM/BC/BMR/BCR Slip -

TM-L60II (Label paper) Property PageModeArea PageModeDescriptor *1

*1

Station *2 Journal Receipt 368, 1108 BM/BC/BMR/BCR Slip -

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 Stations CapRecPageMode and/or CapSlpPageMode property values are FALSE, the PageModeArea property shall have and the PageModeDescriptor property shall have 0 respectively as a setting value.

9 APPLICATION DEVELOPMENT GUIDE POSPrinter (TM-L60II)

Version 2.61

Feb. 2008

3.2 Methods The following explanation is about supported/unsupported Methods, and the detailed information. Method PrintNormal PrintTwoNormal PrintImmediate PrintBarCode PrintBitmap PrintMemoryBitmap CutPaper MarkFeed ChangePrintSide ValidateData TransactionPrint SetLogo SetBitmap RotatePrint EndRemoval BeginRemoval EndInsertion BeginInsertion ClearPrintArea PageModePrint
O : Supported X : Unsupported
*1 *2

Supported/Unsupported O X O O O O X O *1 X O O O O O X X X X O O

Compatibility with the PageMode printing O X O *2 O *3 O *4 O *4 X O X O O O O X X X X X O O

Available only for select label paper. On the other models, there is X setting. 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.

*3

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.

*4

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.

10 APPLICATION DEVELOPMENT GUIDE POSPrinter (TM-L60II)

Version 2.61

Feb. 2008

3.3 Escape Sequences The following figure is about supported/unsupported Escape Sequences. Escape Sequence Value Compatibility with the PageMode printing #P #fP #sP sL #B tL bL #R #lF #uF Base Pitch [inch] #rF Maximum [inch] #E #fT bC !bC #uC iC !iC #rC rvC !rvC #sC #fC tbC !tbC tpC !tpC 1C 2C 3C 4C #hC #vC cA rA lA N
O : Supported X : Unsupported Numbers: Settable range

X X X X O O O O 0~9999 0~ approx. 50 cm X 0~65535 X O O 1~2 X X 1 O O X X X X X X O O O O 1~8 1~8 O O O O

X X X X O O O O O O X X X O O O X X O O O X X X X X X O O O O O O O *1 O *1 O O

11 APPLICATION DEVELOPMENT GUIDE POSPrinter (TM-L60II)

Version 2.61

Feb. 2008

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

3.4 Printable Barcode Type The TM-L60II models allow 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

3.5 Power Condition Reports The TM-L60II models do not support Power Condition Reports. 3.6 Synchronous Processing The TM-L60II models do not use Process ID to determine output completion. 3.7 Printing Positions The TM-L60II models support the function for setting printing position. Function Left margin Printing Position
O : Supported X : Unsupported

Support O O

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. 12 APPLICATION DEVELOPMENT GUIDE POSPrinter (TM-L60II)

Version 2.61

Feb. 2008

3.8 Electronic Logo Function (NVRAM) The TM-L60II models do not support the Electronic Logo Function. 3.9 Printable Bitmap Types and Sizes The TM-L60II models support the following bitmap commands. For the detail, please refer to the Section 3 of EPSON OPOS ADK MANUAL APPLICATION DEVELOPMENT GUIDE POSPrinter (TM Series). The allowance ranges for bitmaps are as follows. Bitmap command type Download bitmap x (dot) 1~2040 One-line bitmap Allowance range y (dot) 1~384 No setting range xy <= 98304

Even if meet with the limitation described above, a bitmap that extend the paper width cannot be printed. 3.10 Maintenance Counter The TM-L60II models do not support the Maintenance Counter. 3.11 Automatic Recovery Function The TM-L60II models do not have a function for automatic recovery when the power is turned on again after an interruption of power. 3.12 MarkFeed Function The TM-L60II models support the MarkFeed function. When executing the PTR_MF_TAKEUP, the power status becomes OFFLINE. The printer will remain OFFLINE until the [FEED] button is pressed. 3.13 Label Receipt DirectIO The TM-L60II models support the following DirectIO commands. For usage information, please refer to the Section 4 of "EPSON OPOS ADK MANUAL APPLICATION DEVELOPMENT GUIDE POSPrinter (TM Series)". PTR_DI_LABEL_REMOVE PTR_DI_LABEL_SET_PRINT_MODE PTR_DI_LABEL_SET_COUNT_MODE PTR_DI_LABEL_PRINT_COUNT PTR_DI_LABEL_SET_COUNT_VALUE 13 APPLICATION DEVELOPMENT GUIDE POSPrinter (TM-L60II)

Version 2.61

Feb. 2008

3.14 Label receipt Usage When using label receipt paper with TM-L60II (Serial), set DIP-SW2-6 to ON, with TM-L60IIP (Parallel), set DIP-SW1-7 to ON. If the label receipt paper DIP-SW is set, be sure label receipt paper is in the printer. When using label receipt paper, the Escape Sequence ESC|#IF feeds the receipt the specified length, or to the head of the next label. After executing MarkFeed (PTR_MF_TO_TAKEUP), the power state of the printer becomes OFFLINE. The printer will remain OFFLINE until the [FEED] button is pressed. After the [FEED] button is pressed operation continues.

14 APPLICATION DEVELOPMENT GUIDE POSPrinter (TM-L60II)

Version 2.61

Feb. 2008

Section 4. Warnings

This section describes precautions in use of the TM-L60II. The width limitation on 90-degree rotated printing dots. Horizontal printing range differs in selecting Label Paper or Normal Paper. For this reason, values of the RecLineWidth, RecLineChars, and the RecSideWaysMaxLines properties depend on the selected paper type. When using Label Paper, values of those properties are to be modified to the specific values for Label Paper after executing the ClaimDevice method. It takes time until the printing start when the printing data which contain bitmap data. However, it is the influence of the firmware specification. to the right is up to 831

15 APPLICATION DEVELOPMENT GUIDE POSPrinter (TM-L60II)