EPSON

EPSON OPOS ADK MANUAL

APPLICATION DEVELOPMENT GUIDE POSPrinter(TM-U950 and TM-U375)

Version 2.00 Dec. 2000

Copyright 2000 SEIKO EPSON CORPORATION

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 NT, Visual Basic are trademarks and registered trademarks of Microsoft Corporation, USA. EPSON and ESC/POS are registered trademarks of SEIKO EPSON CORPORATION. All other company names and trademarks mentioned in this documentation are the property of their respective owners. Copyright 2000 SEIKO EPSON CORPORATION

Version 2.00 Dec. 2000

Contents
SECTION 1. INTRODUCTION....................................................................................................1 SECTION 2. DETAILS ON SETTINGS ......................................................................................2 2.1. REFERENCE VERSIONS OF FIRMWARE ...................................................................................2 2.2. SETTINGS OF DIP SWITCHES .................................................................................................2 2.3. PORT INFORMATION...............................................................................................................5 2.4. DEVICE SETTINGS ...................................................................................................................7 2.4.1. Usable Device Specific Settings.........................................................................................7 SECTION 3. FUNCTION DETAILS ............................................................................................8 3.1. PROPERTY SET VALUES AND DEFAULT VALUES ..................................................................8 3.1.1. Capability Set Values ........................................................................................................8 3.1.2. List Properties..................................................................................................................10 3.1.3. Width and Height Properties...........................................................................................11 3.1.4. Common Property Strings...............................................................................................11 3.2. METHODS ..............................................................................................................................12 3.3. ESCAPE SEQUENCES ..............................................................................................................13 3.4. POWER CONDITIONS REPORTING .......................................................................................14 3.5. SYNCHRONOUS PROCESSING ..............................................................................................14 3.6. PRINT POSITION ....................................................................................................................14 3.7. ELECTRONIC LOGO FUNCTION (NVRAM)........................................................................14 3.8. PRINTABLE BITMAP TYPES AND THE SPECIFIED SIZE ..........................................................14 3.9. MAINTENANCE COUNTER ....................................................................................................15 3.10. AUTOMATIC RECOVERY FUNCTION ..................................................................................15 SECTION 4. WARNINGS............................................................................................................16

iii APPLICATION DEVELOPMENT GUIDE POSPrinter(TM-U950 and TM-U375)

Version 2.00 Dec. 2000

Section 1. Introduction

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

Before reading the manual, see the following explanation about the characteristic of the TM-U950 and TM-U375 model. TM-U950 model Station: Receipt / Journal / Slip (9 pin Serial impact dot matrix) TM-U375 model Station: Receipt / Slip (9 pin Serial impact dot matrix) Rotate printing function Throughout the manual, the various model names will be referred to as TM-U950 and TM-U375.

1 APPLICATION DEVELOPMENT GUIDE POSPrinter(TM-U950 and TM-U375)

Version 2.00 Dec. 2000

Section 2. Details on Settings

This section describes connection configurations and how to make the settings for the TM-U950 and TM-U375 Series printers. 2.1. Reference Versions of Firmware 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 * TM-U950 DIP-SW 1 No. 1 2 3 4 5 6 7 8 Setting OFF OFF OFF OFF OFF OFF OFF OFF Fixed at OFF Settable Settable Settable Settable Settable Recommended Fixed at OFF DIP-SW 2 No. 1 2 3 4 5 6 7 8 Setting OFF OFF ON OFF OFF ON OFF OFF Recommended Recommended Fixed at ON Recommended Settable Fixed at ON Fixed at OFF Fixed at OFF

It is possible to change the settings of 7 (Processing of the data input error) of DIP-SW1 and 2 (Specification of the received buffer capacity) of DIP-SW2 but it is recommended to leave them at OFF. Set 8 (Handshake) of DIP-SW1 to DTR/DSR. Set 1 (Bit length) of DIP-SW1 to 8. Set 2, 3, 4 and 5 of DIP-SW1 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 6 of DIP-SW1 in accordance with whether or not a customer display is 2 APPLICATION DEVELOPMENT GUIDE POSPrinter(TM-U950 and TM-U375)

Version 2.00 Dec. 2000

connected. If connected, set to ON. If not, set to OFF. It is possible to change the settings of 1(Auto line feed) of Dip-SW2 and 4(Carriage Moving Speed) of Dip-SW2 but it is recommended to leave them at OFF. Make other settings in accordance with the settings described above. * TM-U375 DIP-SW 1 No. 1 2 3 4 5 6 7 8 Setting OFF OFF OFF OFF OFF OFF OFF OFF Recommended Recommended Fixed at OFF Fixed at OFF Settable Settable Settable Settable DIP-SW 2 No. 1 2 3 4 5 6 7 8 Setting OFF OFF OFF OFF OFF Settable Fixed at OFF Settable Fixed at OFF Fixed at OFF

It is possible to change the settings of 1 (Processing of the data input error) and 2 (Specification of the received buffer capacity) of DIP-SW1 but it is recommended to leave them at OFF. Set 3 (Handshake) of DIP-SW1 to DTR/DSR. Set 4 (Bit length) of DIP-SW1 to 8. Set 5, 6, 7, and 8 of DIP-SW1 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 1 of DIP-SW2 in accordance with whether or not a customer display is connected. If connected, set to ON. If not, set to OFF. 4, 5, and 6 of DIP-SW2 should not be change from current settings. Make other settings in accordance with the settings described above.

3 APPLICATION DEVELOPMENT GUIDE POSPrinter(TM-U950 and TM-U375)

Version 2.00 Dec. 2000

2) Parallel Port * TM-U950 DIP-SW 1 No. 1 2 3 4 5 6 7 8 Setting OFF OFF OFF OFF OFF OFF OFF OFF Fixed at OFF Fixed at OFF Fixed at OFF Fixed at OFF Fixed at OFF Fixed at OFF Fixed at OFF Fixed at OFF DIP-SW 2 No. 1 2 3 4 5 6 7 8 Setting OFF OFF ON OFF OFF ON OFF ON Recommended Recommended Fixed at ON Recommended Settable Fixed at ON Fixed at OFF Fixed at ON

It is possible to change the settings of 2 (Specification of the received buffer capacity) of DIP-SW2 but it is recommended to leave them at OFF. It is possible to change the settings of 1(Auto Line Feed) of Dip-SW2 and 4(Carriage Moving Speed) of Dip-SW2 but it is recommended to leave them at OFF. Make other settings in accordance with the settings described above. * TM-U375 DIP-SW 1 No. 1 2 3 4 5 6 7 8 Setting OFF OFF OFF OFF OFF OFF OFF OFF Recommended Recommended Fixed at OFF Fixed at OFF Fixed at OFF Fixed at OFF Fixed at OFF Fixed at OFF DIP-SW 2 No. 1 2 3 4 5 6 7 8 Setting OFF ON OFF ?? ?? ?? OFF ON Fixed at OFF Fixed at ON Settable Not settable Not settable Not settable Fixed at OFF Fixed at ON

It is possible to change the settings of 2 (Specification of the received buffer capacity) of DIP-SW1but it is recommended to leave them at OFF. It is possible to change the settings of 1(Auto line feed) of Dip-SW2 and 4(Carriage Moving Speed) of Dip-SW2 but it is recommended to leave them at OFF. 4 APPLICATION DEVELOPMENT GUIDE POSPrinter(TM-U950 and TM-U375)

Version 2.00 Dec. 2000

Make other settings in accordance with the settings described above.

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] Setting range 1200,2400,4800,9600 8 NONE,ODD,EVEN 1 DTR/DSR 2 to 64 (TM-U375) 32 to 1024 (TM-U950) Output interval time [ms] 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 Output buffer length [byte] 9600 8 NONE 1 DTR/DSR 10 (TM-U375) 1024 (TM-U950) Output interval time [ms] 2500 Setting range

5 APPLICATION DEVELOPMENT GUIDE POSPrinter(TM-U950 and TM-U375)

Version 2.00 Dec. 2000

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] Setting range 2 to 64 (TM-U375) 32 to 1024 (TM-U950) Output interval time [ms] 0 to 9999

The default settings are as shown in the following table. Item Output buffer length [byte] Setting range 10 (TM-U375) 1024 (TM-U950) Output interval time [ms] 2500

6 APPLICATION DEVELOPMENT GUIDE POSPrinter(TM-U950 and TM-U375)

Version 2.00 Dec. 2000

2.4. Device Settings The following explanation is about the settings for TM-U950 and TM-U375. 2.4.1. Usable Device Specific Settings For the TM-U950 and TM-U375, the following Device Specific Settings are settable by the SetupPOS utility. For more details on each setting, refer to the Section 2 in the Application Development Guide (POSPrinter EPSON TM series).

Tab General Disable panel buttons

Settings

Assume print complete when data output finishes Ignore firmware version check Homogenize Error Codes Output complete timeout Bitmap Color Bitmap Download Method Brightness Primary Status Log ERROR OFFLINE Log file name (full path name) Maximum file size [KB]
*1

Settable only for the TM-U950.

7 APPLICATION DEVELOPMENT GUIDE POSPrinter(TM-U950 and TM-U375)

Version 2.00 Dec. 2000

Section 3. Function Details

This section describes the functions of the TM-U950 and TM-U375 printer in details. Supplementary explanation of the parts not described in detail in the APG is also given here. 3.1. Property Set Values and Default Values The following explanation is about the property setting 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 CapCharacterSet CapJrnUnderline CapJrnNearEndSensor CapJrnItalic CapJrnEmptySensor CapJrnDwideDhigh CapJrnDwide CapJrnDhigh CapJrnColor TM-U950 TRUE TRUE FALSE FALSE TRUE PTR_CCS_ASCII TRUE TRUE FALSE TRUE TRUE TRUE TRUE PTR_COLOR_P RIMARY CapJrnCartridgeSensor CapJrnBold CapJrn2Color CapJrnPresent 8 APPLICATION DEVELOPMENT GUIDE POSPrinter(TM-U950 and TM-U375) 0 TRUE FALSE TRUE 0 FALSE FALSE FALSE TM-U375 TRUE TRUE FALSE FALSE FALSE PTR_CCS_ASCII FALSE FALSE FALSE FALSE FALSE FALSE FALSE 0

Version 2.00 Dec. 2000

CapRecUnderline CapRecStamp CapRecRotate180 CapRecRight90 CapRecPapercut CapRecNearEndSensor CapRecMarkFeed CapRecLeft90 CapRecItalic CapRecEmptySensor CapRecDwideDhigh CapRecDwide CapRecDhigh CapRecColor

TRUE FALSE TRUE FALSE TRUE TRUE 0 FALSE FALSE TRUE TRUE TRUE TRUE PTR_COLOR_P RIMARY

TRUE FALSE TRUE TRUE FALSE TRUE 0 TRUE FALSE TRUE TRUE TRUE TRUE PTR_COLOR_P RIMARY 0 TRUE TRUE FALSE FALSE TRUE TRUE TRUE TRUE TRUE TRUE FALSE TRUE TRUE TRUE TRUE PTR_COLOR_P RIMARY 0

CapRecCartridgeSensor CapRecBold CapRecBitmap CapRecBarCode CapRec2Color CapRecPresent CapSlpUnderline CapSlpRotate180 CapSlpRight90 CapSlpNearEndSensor CapSlpLeft90 CapSlpItalic CapSlpEmptySensor CapSlpDwideDhigh CapSlpDwide CapSlpDhigh CapSlpColor

0 TRUE TRUE FALSE FALSE TRUE TRUE TRUE FALSE TRUE FALSE FALSE TRUE TRUE TRUE TRUE PTR_COLOR_P RIMARY

CapSlpCartridgeSensor 9

APPLICATION DEVELOPMENT GUIDE POSPrinter(TM-U950 and TM-U375)

Version 2.00 Dec. 2000

CapSlpBothSidesPrint CapSlpBold CapSlpBitmap CapSlpBarCode CapSlp2Color CapSlpFullslip CapSlpPresent

FALSE TRUE TRUE FALSE FALSE TRUE TRUE

FALSE TRUE TRUE FALSE FALSE TRUE TRUE

3.1.2. List Properties The List Properties are explained in the following. *TM-U950 List Property CharacterSetList JrnLineCharsList RecLineCharsList SlpLineCharsList Settings 255,437,850,858,860,863,865,998 30,40 30,40 66,88

RecBarCodeRotationList SlpBarCodeRotationList FontTypefaceList

*TM-U375 List Property CharacterSetList JrnLineCharsList RecLineCharsList SlpLineCharsList Settings 437,850,858,860,863,865,998 33,40 33,40

RecBarCodeRotationList SlpBarCodeRotationList FontTypefaceList

10 APPLICATION DEVELOPMENT GUIDE POSPrinter(TM-U950 and TM-U375)

Version 2.00 Dec. 2000

3.1.3. Width and Height Properties The width and height properties are described below. Property Settings Default Value Maximum Minimum value[dot] value[dot] RecLineSpacing JrnLineSpacing
*1

12 12 12 9 9 9

127 127 127

0 0 0

SlpLineSpacing SlpLineHeight[dot] RecLineHeight[dot] JrnLineHeight[dot] *1 SlpLineWidth[dot] RecLineWidth[dot] JrnLineWidth[dot] *1 RecSidewaysMaxLines RecSidewaysMaxChars*1 RecLinesToPaperCut SlpSidewaysMaxLines SlpSidewaysMaxChars SlpMaxLines
X : No settings
*1 *2 *3 *4

400(TM-U950), 200(TM-U375) 180(TM-U950), 200(TM-U375) 180 0(TM-U950), 16(TM-U375) *3 0(TM-U950), 117(TM-U375) *4 10(TM-U950), 9(TM-U375) *2 0(TM-U950), 16(TM-U375) *3 0(TM-U950), 117(TM-U375) *4 0

Available only for the TM-U950. On the other models, there is no setting. 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. It can be changed by the settings of the font width. *When the RecLineSpacing is 0, the RecLinesToPaperCut is to be --1. *When the XxxLineSpacing is 0, the XxxSidewaysMaxLines is to be --1. -

3.1.4. Common Property Strings The Device information properties are described below. TM-U950 I/F S P DeviceName TM-U950 TM-U950P DeviceDescription EPSON TM-U950 POS Printer EPSON TM-U950P POS Printer 11 APPLICATION DEVELOPMENT GUIDE POSPrinter(TM-U950 and TM-U375)

Version 2.00 Dec. 2000

TM-U375 I/F S P DeviceName TM-U375 TM-U375P DeviceDescription EPSON TM-U375 POS Printer EPSON TM-U375P POS Printer

I/F shows the connected interface. There are four types of the connecting interfaces as follows: S: Serial P: Parallel

3.2. Methods The following explanation is about supported/unsupported Methods, and the detailed information. Method PrintNormal PrintTwoNormal*1 PrintImmediate PrintBarCode PrintBitmap CutPaper
*1

Supported/Unsupported O O O X O O (1-79:Tree point remains uncut. 80-100:One point remains uncut.)

MarkFeed ChangePrintSide ValidateData TransactionPrint SetLogo SetBitmap RotatePrint EndRemoval BeginRemoval EndInsertion BeginInsertion
O : Supported X : Unsupported
*1

X X O O O O O O O O O

Available only for the TM-U950. On the other models, there is no setting.

12 APPLICATION DEVELOPMENT GUIDE POSPrinter(TM-U950 and TM-U375)

Version 2.00 Dec. 2000

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

TM-U950 0~100 0~100 X X O O O 0-9999 0-approx. 50cm 1/6 X O 1 X 1 X X O O O O 1-2 1-2 O O O

TM-U375 X X X X O O O 0~9999 0~ approx. 50cm X X O 1 X 1 X X O O O O 1-2 1-2 O O O

13 APPLICATION DEVELOPMENT GUIDE POSPrinter(TM-U950 and TM-U375)

Version 2.00 Dec. 2000

3.4. Power Conditions Reporting The TM-U950 and TM-U375 do not support Power Conditions Reporting. 3.5. Synchronous Processing The TM-U950 and TM-U375 do not use Process ID to determine output completion. 3.6. Print Position The TM-U950 and TM-U375 support the function for setting printing position. Function Left margin Print position
O : Supported X : Unsupported

TM-U950 X O

TM-U375 O O

When supports the left margin setting function, it is possible to specify the horizontal printing position of the bitmap or barcode by dots unit. When supports the printing position settings, 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.7. Electronic Logo Function (NVRAM) The TM-U950 and TM-U375 do not support the Electronic Logo Function. 3.8. Printable bitmap types and the specified size The TM-U950 and TM-U375 support the following bitmap commands. For the detailed information about the each command, refer to the Section 2 in the Application Development guide (POS Printer EPSON TM Series). The allowance ranges for bitmaps are as follows. TM-U950 Bitmap command type Download bitmap X (dot) 1-2040 One-line bitmap 1-384 No setting range Allowance range y (dot) xy <= 98304

14 APPLICATION DEVELOPMENT GUIDE POSPrinter(TM-U950 and TM-U375)

Version 2.00 Dec. 2000

TM-U375 Bitmap command type Download bitmap X (dot) 1-2040 One-line bitmap 3.9. Maintenance Counter The TM-U950 and TM-U375 do not support the Maintenance Counter. 3.10. Automatic Recovery Function The TM-U950 and TM-U375 do not have a function for automatic recovery when the power is turned on again after an interruption of power. Allowance range y (dot) 1-2040 No setting range xy <= 32768

15 APPLICATION DEVELOPMENT GUIDE POSPrinter(TM-U950 and TM-U375)

Version 2.00 Dec. 2000

Section 4. Warnings

This section describes precautions in use of TM-U950 and TM-U375. Use the PTR_TWO_RECEIPT_JOURNAL when the print data is output both on the Receipt and the Journal, in order to keep a high compatibility in the PrintTwoNormal method. The PTR_S_JOURNAL_RECEIPT is still available to be compatible with the old version. The operation with the PTR_S_JOURNAL_RECEIPT is same as the PTR_TWO_RECEIPT_JOURNAL.

16 APPLICATION DEVELOPMENT GUIDE POSPrinter(TM-U950 and TM-U375)