Epson TM-T88V-DT ePOS-Device XML Users Manual

Epson TM-T88V-DT Manual

Epson TM-T88V-DT manual content summary:

  • Epson TM-T88V-DT | ePOS-Device XML Users Manual - Page 1
    ePOS-Device XML User's Manual Overview Describes the features and development environment. Building Environment Describes environment building for ePOS-Device Service I/F. Programming Guide Describes how to write programs in Web application development. ePOS-Device XML Describes the ePOS-Device XML.
  • Epson TM-T88V-DT | ePOS-Device XML Users Manual - Page 2
    with Seiko Epson Corporation's operating and maintenance instructions. • Seiko Epson Corporation shall not be liable against any damages or problems arising users to build versatile POS systems. The system is compatible with all types of EPSON POS printers (excluding the TM-C100) and displays.
  • Epson TM-T88V-DT | ePOS-Device XML Users Manual - Page 3
    For Safety Key to Symbols The symbols in this manual are identified by their level of importance, as defined below. Read the following carefully before handling the product. Provides information that must be observed to
  • Epson TM-T88V-DT | ePOS-Device XML Users Manual - Page 4
    manual is a generic term for the TM-DT series and TM-i series. The TM-DT series is a generic term for the following printers.  TM-T88V-DT  TM-T70II-DT  TM-H6000IV-DT The TM-i series is a generic term for the following printers.  TM-T88V-i (TM-i firmware Ver.4.0 or later)  TM-T70-i (TM
  • Epson TM-T88V-DT | ePOS-Device XML Users Manual - Page 5
    16 TM-Intelligent ...16 TM Printer ...17 Customer Display...17 Peripheral Device ...18 ■ Contents in the Package 19 Manual...19 Sample Program ...19 Download ...19 ■ Restrictions ...20 Building Environment 21 ■ Updating the ePOS-Device 21 TM-DT Series ...21 TM-i Series...22 ■ Workflow ...23 TM-DT
  • Epson TM-T88V-DT | ePOS-Device XML Users Manual - Page 6
    Guide 33 ■ Programming Flow ...33 If Reconnecting to the TM-Intelligent when the Network was Cut Off 34 Programming flow for the Communication Box 35 ■ Service Interface Specifications for Printers 70 print ...70 onxmlresult ...70 ■ Message Data for Hybrid Printers 71
  • Epson TM-T88V-DT | ePOS-Device XML Users Manual - Page 7
    ...74 micrread ...75 micrcancel ...76 micreject ...76 micrcleaning ...76 onreceive ...77 ■ Printer Control XML ...79 ...79 ...81 ...84 ...90 ...92 ...94 ...95 ...99
  • Epson TM-T88V-DT | ePOS-Device XML Users Manual - Page 8
    ■ Message Data for the POS Keyboard 134 onkeypress
  • Epson TM-T88V-DT | ePOS-Device XML Users Manual - Page 9
    Printer specifications...187 TM-H6000IV-DT/ TM-H6000IV ...187 TM-T70II-DT/ TM-T70II ...189 TM-T88V-DT/ TM-T88V-i/ TM-T88V...191 TM-T20II-i...193 TM-T70-i/ TM-T70 ...195 TM-T82II-i/ TM-T82II ...197 TM-L90 ...199 TM-P60II ...201 TM-P60II with Peeler ...203 TM-P80...205 TM-T20 ...207 TM-T20II...209 TM
  • Epson TM-T88V-DT | ePOS-Device XML Users Manual - Page 10
    10
  • Epson TM-T88V-DT | ePOS-Device XML Users Manual - Page 11
    the features of and the specifications for ePOS-Device XML. ePOS-Device XML Terminal Native Application 1 Request (XML format) Response (XML format) TM-DT Socket I/F ePOS-Device Service I/F Request Response /Event Device Control Script Local Printer Serial Communication Device Customer
  • Epson TM-T88V-DT | ePOS-Device XML Users Manual - Page 12
    that run with the OS-standard driver can be used with a device control script without any drivers installed. ❏ Accessing a device You can shut down the TM-DT from the application. * (message data for device hub terminal) * TM-DT series is supported only. System Configuration Example System
  • Epson TM-T88V-DT | ePOS-Device XML Users Manual - Page 13
    Box is a virtual data space that is provided by the ePOS-Device Service I/F for sending and receiving data between applications. It is provided in ePOS application's specifications. App1 1 App2 The Communication Box can be used in the following ways.  Using a tablet terminal as a POS display
  • Epson TM-T88V-DT | ePOS-Device XML Users Manual - Page 14
    Example of data processing using the Communication Box App1 App2 1 The TM-Intelligent receives the barcode data scanned by the scanner. 2 The ePOS-Device Service I/F notifies App2 of the barcode data. 3 App2 acquires the barcode data and converts it to POS data. 4 App2 sends the display data to the
  • Epson TM-T88V-DT | ePOS-Device XML Users Manual - Page 15
    App2 -App1 -App2 1 App2 The ePOS-Device Service I/F manages Communication Boxes with Box IDs (BoxID in the figure above receive data with one another using the BoxID:1 Communication Box. Specifications of the Communication Box Maximum number of Communication Boxes that can
  • Epson TM-T88V-DT | ePOS-Device XML Users Manual - Page 16
    : Smartphones, tablet computers, personal computers) TM-Intelligent TM-DT Series ❏ TM-T88V-DT ❏ TM-T70II-DT ❏ TM-H6000IV-DT TM-i Series ❏ TM-T88V-i (TM-i firmware Ver.4.0 or later) ❏ TM-T70-i (TM-i firmware Ver.4.0 or later) ❏ TM-T20II-i ❏ TM-T82II-i TM-i Firmware Ver.4.0 is compatible with ePOS
  • Epson TM-T88V-DT | ePOS-Device XML Users Manual - Page 17
    printer, the TM printers below can be controlled. TM Printer TM-T20II-i TM-T70-i (TM-i firmware Ver.4.0 or later) TM-T82II-i TM-T88V-i (TM-i firmware Ver.4.0 or later) TM-H6000IV TM-L90 TM-P60II TM-P60II Peeler TM-P80 TM-T20 TM-T20II TM-T70 TM-T70II TM-T82II TM-T88IV TM-T88V TM-T90 TM-U220 TM-DT
  • Epson TM-T88V-DT | ePOS-Device XML Users Manual - Page 18
    level equivalent to serial communication devices * TM-DT Series ✔ TM-i Series - * Will require separate installation of a serial-USB conversion driver.  Serial-USB conversion drivers with certain specifications may not be usable. With the TM-DT Series, a peripheral device can be used
  • Epson TM-T88V-DT | ePOS-Device XML Users Manual - Page 19
    with TM-DT. It is not used with the TM-i Series. Download For customers in North America, go to the following web site: http://www.epsonexpert.com/ and follow the on-screen instructions. For customers in other countries, go to the following web site: https://download.epson-biz.com/?service=pos 19
  • Epson TM-T88V-DT | ePOS-Device XML Users Manual - Page 20
    printer supports the "ruled line command". ❏ The drawer and the buzzer cannot be used together. ❏ The buzzer function cannot be used if the printer registered in a TM-i Series printer. ❏ Serial communication devices cannot be used with a TM-i Series printer with the specification of "without Serial
  • Epson TM-T88V-DT | ePOS-Device XML Users Manual - Page 21
    for ePOS-Device Service I/F. Updating the ePOS-Device Once you have updated the ePOS-Device, you can use the new ePOS-Device functions. TM-DT Series Confirming the ePOS-Device version You can confirm the version of the ePOS-Device on the EPSON TMNet WebConfig title bar. 2 Downloading the ePOS-Device
  • Epson TM-T88V-DT | ePOS-Device XML Users Manual - Page 22
    support ePOS-Device. Confirming the TM-i Firmware version and the ePOS-Device version There are the following two ways of checking the TM-i Firmware version. ❏ Checking [Firmware] and [ePOS-Device] in the status sheet Firmware X.XX ePOS-Device X.XX Model ❏ Checking via EPSON
  • Epson TM-T88V-DT | ePOS-Device XML Users Manual - Page 23
    only one port for serial communication device, USB connection is available with a serial-USB conversion cable and driver.) 3. Registration of Device Control Script (TM-DT Series) (p.25) For devices for which the device control script prepared in advance cannot be used, register the device control
  • Epson TM-T88V-DT | ePOS-Device XML Users Manual - Page 24
    to Operating Environment (p.16). 2. Network Settings Configure the system and TM-i network settings. These settings can be made via the following. For details, refer to the Technical Reference Guide of each TM-i.  EPSON TMNet WebConfig  EpsonNet Config  Easy Kitting 3."Registration of Device" on
  • Epson TM-T88V-DT | ePOS-Device XML Users Manual - Page 25
    .192.168.  http://[IP address of TM-DT]/webconfig/ • Check the IP address of TM-DT with the status sheet. For checking method of the status sheet, refer to Technical Reference Guide of each TM-DT. • If the Windows Security screen appears while using EPSON TMNet WebConfig, enter your user name and
  • Epson TM-T88V-DT | ePOS-Device XML Users Manual - Page 26
    4 TMNet WebConfig starts. Click [Web Service Settings] - [Add/delete]. 5 The "Control Script" screen appears. Click [Browse] under [Control Script to be registered] and select the device control script to be registered. 6
  • Epson TM-T88V-DT | ePOS-Device XML Users Manual - Page 27
    the Web browser. http://[IP address of TM-DT]/webconfig/ • Check the IP address of TM-DT with the status sheet. For checking method of the status sheet, refer to Technical Reference Guide of each TM-DT. • If the Windows Security screen appears while using EPSON TMNet WebConfig, enter your user name
  • Epson TM-T88V-DT | ePOS-Device XML Users Manual - Page 28
    3 EPSON TMNet WebConfig starts. From [Web Service Settings] - [Device registration], click an applicable item according to the device type to be registered. Item Printer Customer Display Key input device Serial communication device Other Description Used to set a TM printer to be controlled by TM
  • Epson TM-T88V-DT | ePOS-Device XML Users Manual - Page 29
    Chapter 2 Building Environment ❏ Key Input Device Register the connected key input device in the following procedure: 1. Set the following items and click [Add]. Item Device ID Device name Control Script Description Enter the device ID (any character string). Select the device name of the key
  • Epson TM-T88V-DT | ePOS-Device XML Users Manual - Page 30
    of the status sheet, refer to Technical Reference Guide of each TM-i.  When accessing EPSON TMNet WebConfig, you are promoted to enter user name and password of EPSON TMNet WebConfig. The default is shown below. User name: epson Password: epson 3 EPSON TMNet WebConfig starts. From [Web serv
  • Epson TM-T88V-DT | ePOS-Device XML Users Manual - Page 31
    each device appears. Register the connected device into TM-i. ❏ Printer  Confirm that the local printer is registered using the following procedure: 1. Confirm that "TM-i" is registered for the device ID "local_printer" in [Registered printers]. 2. Click [Test printing]. Check that printing can be
  • Epson TM-T88V-DT | ePOS-Device XML Users Manual - Page 32
    ❏ Serial Communication Device The device ID of the customer display is fixed to "local_display". Register the connected serial communication device in the following procedure: 1. Select [Use]. 2. Set the following items for the connected serial communication device and click [Add]. Item
  • Epson TM-T88V-DT | ePOS-Device XML Users Manual - Page 33
    Chapter 3 Programming Guide Programming Guide This chapter describes how to write programs in the I/F from the native application 2 : connect message() Establish a communication path to ePOS-Device Service I/F Device 3 : open_device message(type_printer) 3.1 : Cmd() 4.1 : Response() 4 :
  • Epson TM-T88V-DT | ePOS-Device XML Users Manual - Page 34
    Network was Cut Off If network communication with the TM-Intelligent is cut off, the client application will application 2 : connect message(client_id=0001) Establish a communication path to ePOS-Device Service I/F 3 : open_device message(buffer=true) Response(data_id=1) 4.1 : device_data message(
  • Epson TM-T88V-DT | ePOS-Device XML Users Manual - Page 35
    Chapter 3 Programming Guide Programming flow for the Communication Box The following indicates the basic from the native application 2 : connect message() Establishes communication path with ePOS-Device Service I/F 3 : open_commbox message 1 : Establishment of TCP/IP connection() TCP connection
  • Epson TM-T88V-DT | ePOS-Device XML Users Manual - Page 36
    Application A ePOS-Device Application B 5 : close_commbox message 5.1 : Deletes Application A from members [2/2] 5.3 : Response() 5 : close_commbox message 5.1 : Deletes Application B from members 5.2 : Ends the Communication Box 6 : disconnect message() Disconnection of TCP/IP connection
  • Epson TM-T88V-DT | ePOS-Device XML Users Manual - Page 37
    Chapter 3 Programming Guide If automatically reconnecting the network If network communication with the TM-Intelligent was reconnected, the : connect message(client_id=0001) Establishes communication path with ePOS-Device Service I/F 3 : open_commbox message() 1 : Establishment of TCP/IP
  • Epson TM-T88V-DT | ePOS-Device XML Users Manual - Page 38
    Service Interface Specifications To enable control using ePOS-Device XML, use the following interface: Transport layer TCP Port No. 8009 Format The format and description of each data
  • Epson TM-T88V-DT | ePOS-Device XML Users Manual - Page 39
    Chapter 3 Programming Guide Communication Data Example Examples of communication data between the application and ePOS-Device are as shown below, where the NULL character is indicated as "\0". Applications
  • Epson TM-T88V-DT | ePOS-Device XML Users Manual - Page 40
    Applications sock3514555410 sock3514555411 3 keyboard01 "\0" ePOS-Device keyboard01 <
  • Epson TM-T88V-DT | ePOS-Device XML Users Manual - Page 41
    Applications sock3514555411 Chapter 3 Programming Guide ePOS-Device Description Disconnection of connection 3 41
  • Epson TM-T88V-DT | ePOS-Device XML Users Manual - Page 42
    Communication Box Message Example Application A  Opens the Communication Box 1 box1 member1 "\0" ePOS-Device 1 box1 OK
  • Epson TM-T88V-DT | ePOS-Device XML Users Manual - Page 43
    Chapter 3 Programming Guide Application A ePOS-Device 2 onreceive box1 member1 send_message 2 "\0" <
  • Epson TM-T88V-DT | ePOS-Device XML Users Manual - Page 44
    Application A  Closes the Communication Box 3 box1 "\0" ePOS-Device 3 box1 OK 3 "\0" <
  • Epson TM-T88V-DT | ePOS-Device XML Users Manual - Page 45
    This is an XML for request messages from the application to the TM-Intelligent and response messages from the TM-Intelligent to the application. ❏ Message Data for Communication Box (p. 46 ePOS-Device Service I/F Cut off communication route with 51 ePOS-Device Service I/F
  • Epson TM-T88V-DT | ePOS-Device XML Users Manual - Page 46
    are as in the table below. * Serial devices cannot be used with a TM-i Series printer with the specification of "without a Serial port". Device type Value for element Description TM-DT Series TM-i Series Page Device Hub Terminal (in ePOS-Device Ver.2.5 and later) shutdown onshutdown
  • Epson TM-T88V-DT | ePOS-Device XML Users Manual - Page 47
    type Value for element Description TM-DT Series TM-i Series Page lock  Locks the device port ✔ - 71 unlock  Unlocks the device port ✔ - 71 print  Print data and setting data to ✔ receipt printers - 72 onxmlresult  Data from
  • Epson TM-T88V-DT | ePOS-Device XML Users Manual - Page 48
    cannot be used with a TM-i Series printer with the specification of "without a Serial port". Device type Value for element Description TM-DT Series TM-i Series Page onkeypress  Input character strings from ✔ ✔ 134 the POS keyboard setprefix  Designates
  • Epson TM-T88V-DT | ePOS-Device XML Users Manual - Page 49
    message. ❏ data Sub-element client_id protocol_version Data type string string Description ID of the connected client Version of the connected TM-Intelligent ❏ Example 4 1234567890 2.0 49
  • Epson TM-T88V-DT | ePOS-Device XML Users Manual - Page 50
    Notifies the confirmation of reconnection for network communication with the TM-Intelligent. Request Requests confirmation of reconnection to the TM-Intelligent. Sub-element Data type old_client_id string new_client_id string received_id int Description Specifies the
  • Epson TM-T88V-DT | ePOS-Device XML Users Manual - Page 51
    Chapter 4 ePOS-Device XML Closes the TCP connection with the TM-Intelligent. Request Requests that the TM-Intelligent close the connection. Sub-element Data type data string Description Client information to close the connection. For details, refer to the data below. ❏ data
  • Epson TM-T88V-DT | ePOS-Device XML Users Manual - Page 52
    Returns the administrator information set in the TM-Intelligent. The information is set with EPSON TMNet WebConfig. Request Requests the administrator information from the TM-Intelligent. ❏ Example Response Returns the administrator information to the
  • Epson TM-T88V-DT | ePOS-Device XML Users Manual - Page 53
    ❏ Example Normal OK Administrator A Counter1&Counter2 Error "PARAM_ERROR" Chapter 4 ePOS-Device XML 4 53
  • Epson TM-T88V-DT | ePOS-Device XML Users Manual - Page 54
    Opens the Communication Box and enables communication between applications. (in ePOS-Device Ver.2.5 and later) Request Requests opening of the Communication Box. Sub-element sequence data Data type string string Description Sequence number Information of the Communication Box to
  • Epson TM-T88V-DT | ePOS-Device XML Users Manual - Page 55
    Chapter 4 ePOS-Device XML Response Returns the Communication Box open result to the application. Sub-element sequence data Data type string string data_id string Description The sequence number designated with the request. Information of the Communication Box open result. For details, refer
  • Epson TM-T88V-DT | ePOS-Device XML Users Manual - Page 56
    Closes the Communication Box. (in ePOS-Device Ver.2.5 and later) Request Requests closing of the Communication Box. Sub-element sequence data Data type string string Description Sequence number Information of the Communication Box to close. For details, refer to the data below.
  • Epson TM-T88V-DT | ePOS-Device XML Users Manual - Page 57
    Chapter 4 ePOS-Device XML Performs data communication between applications using the Communication Box.  (in ePOS-Device Ver.2.5 and later) Request Communicates with the Communication Box. Sub-element sequence data Data type string string Description Sequence number The data
  • Epson TM-T88V-DT | ePOS-Device XML Users Manual - Page 58
     "true" :Enable  "false" :Disable  With TM-i, the following devices are not supported:  "type_dt"  "type_hybrid_printer"  A TM-i Series printer with the specification of "without a Serial port" does not support "type_simple_serial". ❏ Example scanner_001
  • Epson TM-T88V-DT | ePOS-Device XML Users Manual - Page 59
    Chapter 4 ePOS-Device XML Response Returns the device open result to the application. Sub-element device_id code Data type string string data_id int Description The device ID designated with the request. The processing result. For details, refer to the code below. If "true" is designated for
  • Epson TM-T88V-DT | ePOS-Device XML Users Manual - Page 60
    Closes the opened device. Request Designates the device to close. Sub-element Data type device_id string Description The device ID designated with EPSON TMNet WebConfig. The customer display is "local_display". ❏ Example local_display 60
  • Epson TM-T88V-DT | ePOS-Device XML Users Manual - Page 61
    Chapter 4 ePOS-Device XML Response Returns the device close result to the application. Sub-element device_id code Data type string string data_id int Description The device ID designated with the request. The processing result. For details, refer to the code below. If "true" is designated for
  • Epson TM-T88V-DT | ePOS-Device XML Users Manual - Page 62
    Request Sends data to a device. Includes device control commands and print / display data. Sub-element Data type sequence string device_id data string string Description An arbitrary value to specify request messages during sending errors. If you designate a request message, it
  • Epson TM-T88V-DT | ePOS-Device XML Users Manual - Page 63
    device control message. Displays the error that occurred using a code. For details, refer to the following. The details of errors based on the driver are designated when a "DRIVER_ERROR" occurs. If "true" is designated for of the message, the sent data ID is set. If "false
  • Epson TM-T88V-DT | ePOS-Device XML Users Manual - Page 64
    transfer history of the Communication Box. Request Requests acquisition of transfer history of the Communication Box to the ePOS-Device Service I/F. Sub-element Data type box_id string Description Identifier of the Communication Box to acquire transfer history from ❏ Example
  • Epson TM-T88V-DT | ePOS-Device XML Users Manual - Page 65
    Chapter 4 ePOS-Device XML ❏ code Element value "OK" "NOT_OPENED" "SYSTEM_ERROR" ❏ history_list Element value senderId receiverId message ❏ Example Description Successfully acquired transfer history of the Communication Box. A Communication Box is not open. System error occurred Sender's member ID
  • Epson TM-T88V-DT | ePOS-Device XML Users Manual - Page 66
    send Forwards data to the Communication Box. Request Forwards messages to the Communication Box. Sub-element box_id message member_id Data type string string string Description Identifier of the Communication Box to forward the message to. Message to forward. Member ID to forward.
  • Epson TM-T88V-DT | ePOS-Device XML Users Manual - Page 67
    Chapter 4 ePOS-Device XML onreceive Acquires the data forwarded to the Communication Box. Response Returns the message transfer result. Sub-element box_id Data type string sender_id receiver_id string string message string Description Identifier of the Communication Box that
  • Epson TM-T88V-DT | ePOS-Device XML Users Manual - Page 68
    Series. • Available with ePOS-Device Ver.2.5 or later. • If sending this message data, use EPSON TMNet WebConfig to perform shutdown settings for the TM-DT.  ([Settings]-[System settings]-[Shutdown settings]-[ePOS-Device]) shutdown Request Shuts down the power source of the device
  • Epson TM-T88V-DT | ePOS-Device XML Users Manual - Page 69
    Chapter 4 ePOS-Device XML Message Data for the Barcode Scanner ondata Response Returns the scan data from the barcode scanner to the application. Sub-element Data type input string Description Scan data string received. Character strings in received data Escape processing is
  • Epson TM-T88V-DT | ePOS-Device XML Users Manual - Page 70
    60,000 (whole numbers) Designates the data to print. For details, refer to Printer Control XML (p.79). ❏ Example print 10000
  • Epson TM-T88V-DT | ePOS-Device XML Users Manual - Page 71
    Message Data for Hybrid Printers • Cannot be used with TM-i Series. • Available with ePOS-Device Ver.2.5 or later. Chapter 4 ePOS unlock, the next port cannot be locked for about five minutes until the ePOS-Device Service I/F unlocks the port.  The onreceive (p.77) message returns '
  • Epson TM-T88V-DT | ePOS-Device XML Users Manual - Page 72
    print Request Sends the print data and setting data to the receipt printer. Sub-element Data type timeout int printdata string Description Sets the time out limit for requests in milliseconds. 1,000 to 60,000 (whole numbers) Designates
  • Epson TM-T88V-DT | ePOS-Device XML Users Manual - Page 73
    > Request Sends the print data and setting data to the slip printer. Sub-element Data type timeout int printdata string Description Specifies the > slipprint 60000
  • Epson TM-T88V-DT | ePOS-Device XML Users Manual - Page 74
    for the paper insert wait status. 60,000 to 900,000 (whole numbers) Designates the data to print. For details, refer to Printer Control XML (p.79). ❏ 40cplmode true false Element value ❏ Example Description Enables the 40cpl mode. Disables the 40cpl mode. local_printer
  • Epson TM-T88V-DT | ePOS-Device XML Users Manual - Page 75
    Chapter 4 ePOS-Device XML micrread Request Executes MICR reading. If you set the paper after executing this message, MICR reading is performed. Sub-element Data type ignoreerror boolean font timeout string int Description Specifies the operation to perform when unreadable
  • Epson TM-T88V-DT | ePOS-Device XML Users Manual - Page 76
    micrcancel Request Cancels the paper insert wait status during MICR reading or MICR mechanism cleaning. ❏ Example local_printer micrcancel micreject Request Ejects the check paper. ❏ Example <
  • Epson TM-T88V-DT | ePOS-Device XML Users Manual - Page 77
    roll paper end sensor An unrecoverable error occurred  (During receipt printing only) The request document contains a syntax error (During receipt printing only) The printer with the specified device ID does not exist (During receipt printing only) An error occurred on the printing system (During
  • Epson TM-T88V-DT | ePOS-Device XML Users Manual - Page 78
    0x00004000" "0x00010000" "0x00020000" "0x00040000" "0x00080000" "0x00200000" "0x00400000" "0x01000000" "0x01000000" "0x02000000" "0x80000000" Description No response from the TM printer Printing is successfully completed Status of the 3rd pin of the drawer kick-out connector = "H" Offline The cover
  • Epson TM-T88V-DT | ePOS-Device XML Users Manual - Page 79
    XML document sent from the application to printers. It requests that the printer execute the designated function. contains the element. Attribute ❏ xmlns  We're announcing the epos-print namespace. Find the namespace below. http://www.epson-pos.com/schemas/2011/03/epos-print ❏ force
  • Epson TM-T88V-DT | ePOS-Device XML Users Manual - Page 80
    Receipt/ Label printing Slip printing Endorse printing Endorse printing 40cpl mode Standard mode Page mode Sub-element Subelement Function Printer tag added as a sub-element --> Hello world!! 80
  • Epson TM-T88V-DT | ePOS-Device XML Users Manual - Page 81
    paper end sensor "EPTR_UNRECOVERABLE" An unrecoverable error occurred "SchemaError" The request document contains a syntax error "DeviceNotFound" "PrintSystemError" The printer with the specified device ID does not exist An error occurred on the printing system 4 "EX_BADPORT" An error was
  • Epson TM-T88V-DT | ePOS-Device XML Users Manual - Page 82
    " "0x00000040" "0x00000100" "0x00000200" "0x00000400" "0x00000800" "0x00002000" "0x00004000" "0x00020000" "0x00080000" "0x01000000" "0x80000000" Description No response from the TM printer Printing is successfully completed  Status of the 3rd pin of the drawer kick-out connector = "H"  Battery
  • Epson TM-T88V-DT | ePOS-Device XML Users Manual - Page 83
    4 83
  • Epson TM-T88V-DT | ePOS-Device XML Users Manual - Page 84
    laid out in the current print position with the reference point being the character baseline dot (Printer specifications (p.187)). Entity Reference To write symbols required for printer control such as horizontal tab, line feed, and the following symbols, use their corresponding entity references
  • Epson TM-T88V-DT | ePOS-Device XML Users Manual - Page 85
    Attributes Available for Each Printing Method Chapter 4 ePOS-Device XML Receipt/ Label printing Slip printing Endorse printing Endorse printing 40cpl mode Attribute Description Page lang Language ● ● ▲ ▲ 86 font Character font ● ● ● ▲ 87 smooth smoothing ● ▲ ▲ ▲ 87 dw
  • Epson TM-T88V-DT | ePOS-Device XML Users Manual - Page 86
    for South Asia model.) English (ANK) Characters not installed in a printer cannot be printed. For printable character code, refer to the Technical Reference Guide of your printer. Depending on language specification, a part of characters is printed as follows. Language Japanese Korean Simplified
  • Epson TM-T88V-DT | ePOS-Device XML Users Manual - Page 87
    -sized width attribute and the width attribute are specified in one element at the same time, priority is given to the scale specification for the width attribute. 4  dh : Sets the double-sized height. Attribute value "true" or "1" "false" or "0" (default) Description Specifies the double
  • Epson TM-T88V-DT | ePOS-Device XML Users Manual - Page 88
    ) Specifies the vertical print start position of the text in dots. (in ePOS-Device Ver.2.2 and later)  In page mode, the specification is the same as the specification for the vertical print position by the position element, but the print position in the vertical direction only will be moved. Use
  • Epson TM-T88V-DT | ePOS-Device XML Users Manual - Page 89
    Chapter 4 ePOS-Device XML  align : Specifies the alignment. Attribute value "left" (default) "center" "right" Description Alignment to the left Alignment to the center Alignment to the right • For the standard mode, specify the align attribute "when at the start of a line". • In page mode,
  • Epson TM-T88V-DT | ePOS-Device XML Users Manual - Page 90
    line feed space can be set. Attributes Available for Each Printing Method Receipt/ Label printing Slip printing Endorse printing Endorse printing 40cpl mode Attribute Description Page unit line linespc pos Paper feed amount in dots ● ● ● ● 90 Paper feed amount in lines ● ● ● ▲ 90
  • Epson TM-T88V-DT | ePOS-Device XML Users Manual - Page 91
    ="3" /> Hello World 0001
  • Epson TM-T88V-DT | ePOS-Device XML Users Manual - Page 92
    at high speed, specify "left" for the align attribute and specify a multiple of 8 that does not exceed the printer paper width for the width attribute value. • Page mode does not support printing in multiple tones. Multiple tone graphics can only be printed in standard mode. • In page mode, a raster
  • Epson TM-T88V-DT | ePOS-Device XML Users Manual - Page 93
    Chapter 4 ePOS-Device XML  align : Specifies the print position. Attribute value "left" (default) "center" "right" Description Alignment to the left Alignment to the center Alignment to the right • In page mode, even if align is specified, it is disabled. • For the standard mode, specify the
  • Epson TM-T88V-DT | ePOS-Device XML Users Manual - Page 94
    registered in the NV memory of the printer. Page mode does not support printing in multiple tones. Multiple tone graphics can only be printed in standard mode. • Using model-dedicated utility or logo registration utility (TMFLogo), register a logo in the printer in advance. • In page mode, a logo
  • Epson TM-T88V-DT | ePOS-Device XML Users Manual - Page 95
    with the barcode standard are made, or if the barcode becomes larger than the printer's print area. And an error response will not be returned, either. • In The following barcodes can be specified: Barcode type Barcode data specification procedure UPC-A When an 11-digit number is specified, a
  • Epson TM-T88V-DT | ePOS-Device XML Users Manual - Page 96
    Barcode type CODE128 GS1-128 GS1 DataBar Omnidirectional GS1 DataBar Truncated GS1 DataBar Limited GS1 DataBar Expanded Barcode data specification procedure Specify a start character (CODE A, CODE B, CODE C). A stop character is automatically added. A check digit is automatically calculated and
  • Epson TM-T88V-DT | ePOS-Device XML Users Manual - Page 97
    Chapter 4 ePOS-Device XML To specify binary data that cannot be represented by character strings, use the following escape sequences. \xnn \\ String Control code Back slash Description Attribute  type : (Required attribute) Specifies the barcode type. Attribute value Description "upc_a"
  • Epson TM-T88V-DT | ePOS-Device XML Users Manual - Page 98
     align : Specifies the print position. Attribute value "left" (default) "center" "right" Description Alignment to the left Alignment to the center Alignment to the right The align attribute set in this element also applies to the align attribute in each of the text, image, logo, and symbol
  • Epson TM-T88V-DT | ePOS-Device XML Users Manual - Page 99
    -code will not be printed if settings not compliant with the 2D-code standard are made, or if the 2D-code becomes larger than the printer's print area. And an error response will not be returned, either. • In standard mode, a more than 831 dot high 2D-code cannot be printed. • In
  • Epson TM-T88V-DT | ePOS-Device XML Users Manual - Page 100
    In Mode 3 Postal code (1 to 6 pieces of data convertible by Code Set A)  GS:(\x1d)  ISO country code (1- to 3-digit number)  GS:(\x1d)  Service class code (1- to 3-digit number) Convert the character string to the string in UTF-8, apply the escape sequence, and then encode the string. Specify
  • Epson TM-T88V-DT | ePOS-Device XML Users Manual - Page 101
    Chapter 4 ePOS-Device XML Attribute  type : (Required attribute) Specifies the 2D-code type. Attribute value Type "pdf417_standard" Standard PDF417 "pdf417_truncated" Truncated PDF417 "qrcode_model_1" QR Code Model 1 "qrcode_model_2" QR Code Model 2 "maxicode_mode_2" MaxiCode Mode 2
  • Epson TM-T88V-DT | ePOS-Device XML Users Manual - Page 102
     level : Specifies the error correction level. Attribute value "level_0" "level_1" (default) "level_2" "level_3" "level_4" "level_5" "level_6" "level_7" "level_8" "level_l" "level_m" "level_q" "level_h" Integer from "5" to "95" "default" Description PDF417 error correction level 0 PDF417 error
  • Epson TM-T88V-DT | ePOS-Device XML Users Manual - Page 103
    Chapter 4 ePOS-Device XML  size : 2D-Code PDF417 QR Code MaxiCode 2-dimentional GS1 DataBar (Expanded Stacked) (Others) Aztec Code DataMatrix size="0" Default Ignored size="0" (auto) Ignored Ignored Description Specifies the number of code words for each row Specifies the maximum width for
  • Epson TM-T88V-DT | ePOS-Device XML Users Manual - Page 104
    Draws horizontal lines. Not available in page mode. Attribute  x1 :  x2 : (Required attribute) Specifies the draw start position of the horizontal line (in dots). (Required attribute) Specifies the draw end position of the horizontal line (in dots).  style : (Optional attribute)
  • Epson TM-T88V-DT | ePOS-Device XML Users Manual - Page 105
    Chapter 4 ePOS-Device XML Starts to draw vertical lines. Not available in page mode. A vertical line is drawn up to the end position specified by the vline-end element (p. 106). Use this element together with the vline-end element. Attribute  x:  style : (Required attribute)
  • Epson TM-T88V-DT | ePOS-Device XML Users Manual - Page 106
    Ends to draw vertical lines. Not available in page mode. Use this element together with the vline-begin element (p. 105). Attribute  x:  style : (Required attribute) Specifies the end position of the horizontal line (in dots). (Optional attribute) Specifies the line type.
  • Epson TM-T88V-DT | ePOS-Device XML Users Manual - Page 107
    Chapter 4 ePOS-Device XML Changes the mode from standard mode to page mode. Elements via Via , the following elements can be used. Element Prints text Paper feed
  • Epson TM-T88V-DT | ePOS-Device XML Users Manual - Page 108
    Specifies the page mode print area. Specifies the origin point, width, and height based on the absolute origin point to set the print area. The absolute origin point is a dot diagonally above the top left corner of the printable area. Absolute origin point Origin point(x,y) Width Height
  • Epson TM-T88V-DT | ePOS-Device XML Users Manual - Page 109
    Chapter 4 ePOS-Device XML Specifies the page mode print direction. Specifies the print direction and rotates the print area. Following the rotation of the print area, the start point of the print area moves. Use this element inside the page element. Attribute  dir : (Required
  • Epson TM-T88V-DT | ePOS-Device XML Users Manual - Page 110
    Specifies the page mode print position. Specifies the print position based on the start point of the print area. The start point of the print area moves by following the rotation of the print area. Use this element inside the page element. Attribute  x:  y: (Required attribute,
  • Epson TM-T88V-DT | ePOS-Device XML Users Manual - Page 111
    Draws a line in page mode. Diagonal lines cannot be drawn. Use this element inside the page element. Chapter 4 ePOS-Device XML Attribute  x1:  y1 : (Required attribute) Specifies the drawing start position of the horizontal line (in dots). (Required attribute) Specifies the drawing
  • Epson TM-T88V-DT | ePOS-Device XML Users Manual - Page 112
    Draws a rectangle in page mode. • Use this element inside the page element. • Not available in standard mode. Use the hline, vline-begin, and vline-end elements instead. Attribute  x1:  y1 : (Required attribute) Specifies the drawing start position of the horizontal line (in dots).
  • Epson TM-T88V-DT | ePOS-Device XML Users Manual - Page 113
    Chapter 4 ePOS-Device XML Sets paper cut. Available in standard mode. Not available in page mode. Execute "when at the top of a line". When the paper is cut, the state turns to "when at the top of a line". Attribute  type : (Optional attribute) Specifies the paper cut type. Attribute
  • Epson TM-T88V-DT | ePOS-Device XML Users Manual - Page 114
    Outputs signals to the drawer kick connector. Depending on the model, a buzzer can be sounded. • Not available in page mode. • The drawer and the buzzer cannot be used together. Attribute  drawer : (Optional attribute) Specifies the drawer kick connector. Attribute value "drawer_1" (
  • Epson TM-T88V-DT | ePOS-Device XML Users Manual - Page 115
    available in page mode. • The buzzer function and the drawer cannot be used together. • This element is not available if the printer is not provided with the buzzer. Attribute  pattern : (Optional attribut) Specifies the buzzer pattern. Attribute value Description "none" Stop "pattern_a
  • Epson TM-T88V-DT | ePOS-Device XML Users Manual - Page 116
     cycle : (in ePOS-Device Ver.2.2 and later) Specifies the buzzer sounding cycle (in units of milliseconds) "cycle" is enabled by any of "pattern_1" to "pattern_10" for the buzzer pattern. Example 116
  • Epson TM-T88V-DT | ePOS-Device XML Users Manual - Page 117
    Chapter 4 ePOS-Device XML Insert the ESC / POS command. ESC / POS command is specified in hexadecimal encoding. For information about ESC/POS commands, see the ESC/POS Command Reference.  You can view the ESC/POS Command Reference from https://reference.epson-biz.com/. 4 117
  • Epson TM-T88V-DT | ePOS-Device XML Users Manual - Page 118
     (without black mark) Receipt (with black mark) Die-cut label  (without black mark) Die-cut label (with black mark) Valid value range "0 "0" (auto) "284" to "1550" (manual) Description Setup not necessary Distance from the top of black mark to the top of next black mark Distance from the
  • Epson TM-T88V-DT | ePOS-Device XML Users Manual - Page 119
    from the bottom of label. When a paper has black mark, it is a distance from the beginning of black mark. Paper Type Receipt  (without black mark) Receipt (with black mark) Die-cut label  (without black mark) Die-cut label (with black mark) Valid value range Description "0" Setup not
  • Epson TM-T88V-DT | ePOS-Device XML Users Manual - Page 120
    , and the positions for those parameters. Mark sf sa sb se sc sd Parameter width height margin_top margin_bottom offset_cut offset_label sf Receipt Top position Cut sf sb sc sa Top position Label Cut Example sf Bottom edge of print area sb se sa sc
  • Epson TM-T88V-DT | ePOS-Device XML Users Manual - Page 121
    (p. 79) to use this element. Example Resets the printer. (in ePOS-Device Ver.2.2 and later) Cannot be written in the tag. Other printing commands in the print document are ignored. 4 Example
  • Epson TM-T88V-DT | ePOS-Device XML Users Manual - Page 122
    Message Data for the Customer Display For the display data, refer to Customer Display Control XML (p.124). display Request Sends the display data and setting data to the customer display. Sub-element Data type timeout int displaydata string Description Sets the time out limit
  • Epson TM-T88V-DT | ePOS-Device XML Users Manual - Page 123
    Chapter 4 ePOS-Device XML onxmlresult Response Returns the result of sending to the customer display to the application. Sub-element Data type resultdata string Description Receives the response from the data sent to the customer display. For details, refer to (p.125).
  • Epson TM-T88V-DT | ePOS-Device XML Users Manual - Page 124
    for controlling the customer display. Attribute ❏ xmlns  We're announcing the epos-display namespace. Find the namespace below. http://www.epson-pos.com/schemas/2012/09/epos-display Sub-element Sub-element
  • Epson TM-T88V-DT | ePOS-Device XML Users Manual - Page 125
    Chapter 4 ePOS-Device XML This is the XML document that returns from the customer display to the application. Attribute ❏ success  Acquires the display result. Attribute value "true" or "1" "false" or "0" Successfully displayed Failed to display Description ❏ code  Acquires the
  • Epson TM-T88V-DT | ePOS-Device XML Users Manual - Page 126
    Controls creating and deleting windows and moving the current window. ❏ If the attribute number, x, y, width, and height are designated, the designated window is created. When defining the window, define it so that it does not overlap with an already defined window. Specify the size to fit
  • Epson TM-T88V-DT | ePOS-Device XML Users Manual - Page 127
    Chapter 4 ePOS-Device XML ❏ scrollmode  Designates the scroll method of the created window when creating a window. Attribute value "overwrite" (Default) "v_scroll" "h_scroll" Description When characters are displayed while the display position is at the upper right end, the display position
  • Epson TM-T88V-DT | ePOS-Device XML Users Manual - Page 128
    Controls display of character strings. ❏ If attributes x and y are designated, display is performed from the designated cursor position. ❏ If attributes x and y are not designated, display is performed from the current cursor position. Attribute ❏x  Designates the x coordinate for text
  • Epson TM-T88V-DT | ePOS-Device XML Users Manual - Page 129
    Chapter 4 ePOS-Device XML Controls the cursor location and display settings. ❏ Designates the cursor coordinates in the customer display using the x, y designations. ❏ Designates the cursor location in the current window using the moveto designation. ❏ If x and y and moveto are
  • Epson TM-T88V-DT | ePOS-Device XML Users Manual - Page 130
    Controls screen blinking. Blinking is repeated at the interval designated by interval. The actual blinking interval is rounded up in 50 ms units. For example, if interval is 1 to 50, the actual interval is 50 ms, if 51 to 100, then 100 ms. Attribute ❏ interval  Designates the interval
  • Epson TM-T88V-DT | ePOS-Device XML Users Manual - Page 131
    Controls the customer display brightness. Attribute ❏ value  Designate brightness in percentage. Attribute value "20" "40" "60" "100" Brightness 20% Brightness 40% Brightness 60% Brightness 100% ❏ Example
  • Epson TM-T88V-DT | ePOS-Device XML Users Manual - Page 132
    Controls the marquee for character strings. Displays the designated character string 1 character at a time at the interval designated in uwait. After finishing the complete display, it waits the time designated by rwait, and then displays the character string again from the start.
  • Epson TM-T88V-DT | ePOS-Device XML Users Manual - Page 133
    screen. The local time managed by the TM-Intelligent's OS is displayed. ❏ Example POS command. Designate a command with a hexadecimal character string. For information about ESC/POS commands, see the ESC/POS Command Reference.  You can view the ESC/POS Command Reference from https://reference.epson
  • Epson TM-T88V-DT | ePOS-Device XML Users Manual - Page 134
    to the application. Sub-element Data type keycode int ascii string Description Receives the key code decimals input with the POS keyboard. For key code details, refer to the List of KeyCode (p.185) Receives the characters created by key codes. Characters converted into symbols and capital
  • Epson TM-T88V-DT | ePOS-Device XML Users Manual - Page 135
    key code to determine the start of character strings to detect input from the POS keyboard. If a key code designated by this message is input, the as the onstring message. This is used, for example, when using the POS keyboard for barcode alternate input. To stop the onstring message, send a
  • Epson TM-T88V-DT | ePOS-Device XML Users Manual - Page 136
    onstring Response Returns the input data from the POS keyboard to the application. Notifies you that input from one of the key codes designated with setprefix to Enter is detected. The detected key code
  • Epson TM-T88V-DT | ePOS-Device XML Users Manual - Page 137
    Chapter 4 ePOS-Device XML setMSRPrefix Specifies the key code to determine the card information reception with a keyboard with an MSR. If the key code specified by this message was input, the character strings of the card information received from there will be notified as an ondata
  • Epson TM-T88V-DT | ePOS-Device XML Users Manual - Page 138
    track2 Expiration date of JIS1 track2 Surname First name Middle name/initial Title Service code Desired data of JIS1track1 Desired data of JIS1track2 Character strings in received ❏ Example B4205296141577006^EPSON/TARO ^160410100000 00573000000 9999296999977006
  • Epson TM-T88V-DT | ePOS-Device XML Users Manual - Page 139
    Chapter 4 ePOS-Device XML Message Data for the Serial Device This message data cannot be used with a TM-i Series printer with the specification of "without a Serial port". sendcommand Request Sends commands to the serial device. Sub-element Data type command string ❏ Example
  • Epson TM-T88V-DT | ePOS-Device XML Users Manual - Page 140
    oncommandreply Response data from the device may be sent split up. If so, oncommandreply events will occur multiple times. Use the oncommandreply events to check that the whole of the response data has been received. If there is data still to be received, wait for it to arrive before
  • Epson TM-T88V-DT | ePOS-Device XML Users Manual - Page 141
    ClientConnection 5 Device When "open_device" message (p.58) is sent, an object is created so that the ePOS- Device Service I/F on TM-DT can use the device control script supported by the requested device. The device can be controlled with the created object. Device Control Script Object The
  • Epson TM-T88V-DT | ePOS-Device XML Users Manual - Page 142
    Object type :String) Set value group_hid group_serial group_other Description Specify this to use an input device that can run with an HID driver. Specify this to use a serial communication device. Specify this to use other device. ❏ The "onDeviceData" method is provided to receive data generated
  • Epson TM-T88V-DT | ePOS-Device XML Users Manual - Page 143
    Chapter 5 Device Control Script Configuration Example of Device Control Script exports.Keyboard_Generic = Keyboard_Generic; function Keyboard_Generic(clientConn, deviceConn){ this.DEVICE_TYPE = 'type_keyboard'; this.DEVICE_GROUP = 'group_hid'; this.clientConn = clientConn; this.deviceConn =
  • Epson TM-T88V-DT | ePOS-Device XML Users Manual - Page 144
    . Page 146 Device Control Script Name object Element Event API onDeviceData onDeviceData Any event Description Key input receipt event Data receipt event from a serial communication device API execution result receipt event of a device object that runs with a browser Page 147 147 148 144
  • Epson TM-T88V-DT | ePOS-Device XML Users Manual - Page 145
    Chapter 5 Device Control Script ClientConnection Object The object passed to the first parameter of the constructor of the device control script. send Sends data to a device object that can run with a browser. Syntax send(event, data); Parameter  event  data :Object type : (String)
  • Epson TM-T88V-DT | ePOS-Device XML Users Manual - Page 146
    the device control script. send Sends data to a serial communication device. No data is sent when an input device that can run with an HID driver is used. Syntax send(data); Parameter  data :Object type : (Buffer) Specifies the data to be sent to the device. 146
  • Epson TM-T88V-DT | ePOS-Device XML Users Manual - Page 147
    Chapter 5 Device Control Script Device Control Script Name Object onDeviceData event (Input Device That Can Run with a HID Driver) The event used to receive the data detected from a key input device. For the device control script for a key input device, describe an event in
  • Epson TM-T88V-DT | ePOS-Device XML Users Manual - Page 148
    Any event The event used to receive the API execution results of the device object that can run with a browser. Syntax Name specified with callEvent(data); Parameter  data :Object type : (Object) Receives the object specified with callEvent of the device object. 148
  • Epson TM-T88V-DT | ePOS-Device XML Users Manual - Page 149
    Chapter 6 Sample Program Sample Program This chapter describes the sample program. A sample program for an Android/ iOS environment is provided in the ePOS-Device XML. Outline The sample program provides the function to scan data with the barcode scanner and print this data. 6
  • Epson TM-T88V-DT | ePOS-Device XML Users Manual - Page 150
    for Android Environment Device ❏ TM-Intelligent  TM-DT Series  TM-i Series (TM-i firmware Ver.4.0 or later) ❏ Barcode Scanner Execution environment This section explains the following environments. Information such as the webpage URLs and versions of files to download is current as of February
  • Epson TM-T88V-DT | ePOS-Device XML Users Manual - Page 151
    TM-DT Series The following illustrates the flow of constructing the environment for the sample program. If the Windows Security screen appears while using EPSON as follows: User name : epson Password : epson 1. Installing Java SE Development Kit (p.155) Download and install Java SE Development Kit
  • Epson TM-T88V-DT | ePOS-Device XML Users Manual - Page 152
    7. Connection of barcode scanner to TM-DT Connect a barcode scanner to TM-DT. 8. Setting the Barcode Scanner (p.170) Register the barcode scanner to be connected into TM-DT. Make registration using an EPSON TMNet WebConfig. 152
  • Epson TM-T88V-DT | ePOS-Device XML Users Manual - Page 153
    TM-i Series The following illustrates the flow of constructing the environment for the sample program. If the Windows Security screen appears while using EPSON are as follows: User name : epson Password : epson 1. Installing Java SE Development Kit (p.155) Download and install Java SE Development Kit
  • Epson TM-T88V-DT | ePOS-Device XML Users Manual - Page 154
    7. Network Settings Make the network settings for the TM-i, using EPSON TMNet WebConfig. 8. Setting the Barcode Scanner (p.170) Register the barcode scanner to be connected into TM-i. Make registration using an EPSON TMNet WebConfig. 154
  • Epson TM-T88V-DT | ePOS-Device XML Users Manual - Page 155
    SE 6 JDK. http://www.oracle.com/technetwork/java/javase/downloads/index.html 2 The Java SE Downloads window appears. Select [Accept License Agreement] and select the file to be installed. Save the file to a desired location. (In this manual, download Windows x86 to construct the environment.) 6 155
  • Epson TM-T88V-DT | ePOS-Device XML Users Manual - Page 156
    Installing JDK 1 Start the downloaded file. The following window appears. Click the [Next] button. 2 Select the function to install and click the [Next] button. To change the installation destination, click the [Change] button and change the destination. (In this manual, the default destination is
  • Epson TM-T88V-DT | ePOS-Device XML Users Manual - Page 157
    Save the file to a desired location. (In this manual, download and set up Eclipse Classic) http://www.eclipse.org/downloads/ Installing Eclipse and Configuring Initial Settings 1 Extract the downloaded file to a desired location. (In this manual, extract the file under "C:".) 2 Double-click "eclipse
  • Epson TM-T88V-DT | ePOS-Device XML Users Manual - Page 158
    Setting Proxy for Eclipse Use this operation when proxy setting is required for Internet connection. If not required, this operation is unnecessary. 1 Select [Window] - [Preferences]. 2 Select [General]-[Network Connections] from the left column. Set the proxy and click the [OK] button. 158
  • Epson TM-T88V-DT | ePOS-Device XML Users Manual - Page 159
    Chapter 6 Sample Program Setting Up Android SDK Manager Download and install Android SDK Manager. Create Android Virtual Device. Downloading Android SDK Manager Access the following URL and download Android SDK Manager. (In this manual, download the installer for Windows.) http://developer.android.
  • Epson TM-T88V-DT | ePOS-Device XML Users Manual - Page 160
    3 Specify the user destination. Click the [Next] button. (In this manual, the default settings are used.) 4 Specify the Install location destination. Click the [Next] button. (In this manual, the default settings are used.) 5 Specify the name to be registered to Start Menu. Click the [Install]
  • Epson TM-T88V-DT | ePOS-Device XML Users Manual - Page 161
    6 When installation completes, click the [Next] button. Chapter 6 Sample Program 7 Clear the [Start SDK Manager] checkbox. Click the [Finish] button. 6 161
  • Epson TM-T88V-DT | ePOS-Device XML Users Manual - Page 162
    as the administrator, right-click Android SDK Manager and select [Run as administrator]. If Android SDK Manager is not run as the administrator, package download will fail. 2 When the proxy setting is required, select [Tools]-[Options]. 3 The proxy setting window appears. Set the proxy and click the
  • Epson TM-T88V-DT | ePOS-Device XML Users Manual - Page 163
    Chapter 6 Sample Program 5 Select [Accept All] and click the [Install] button. Installation of Virtual Device starts. 6 163
  • Epson TM-T88V-DT | ePOS-Device XML Users Manual - Page 164
    Installing ADT Plugin install ADT (Android Development Tools) Plugin. To execute this operation, the computer must be connected to the Internet. If the proxy setting is required for Internet connection, refer to Setting Proxy for Eclipse (p.158). 1 Start Eclipse. Select [Help]-[Install New Software
  • Epson TM-T88V-DT | ePOS-Device XML Users Manual - Page 165
    Chapter 6 Sample Program 4 Select the [Developer Tools] checkbox and click the [Next] button. 5 Confirm the plugin to be installed, and click the [Next] button. 6 After confirming the terms of the license agreement, select the [I accept...] checkbox and click the [Finish] button. 6 165
  • Epson TM-T88V-DT | ePOS-Device XML Users Manual - Page 166
    . 9 Select [Window] - [Preferences]. 10Select [Android] from the left column. Click the [Browse...] button to display the Android folder where SDK Manager is installed. (In this manual, display "C:\Program Files\Android\android-sdk".) 166
  • Epson TM-T88V-DT | ePOS-Device XML Users Manual - Page 167
    Chapter 6 Sample Program 11Click the [Apply] button. Confirm that the installed package is displayed. 6 167
  • Epson TM-T88V-DT | ePOS-Device XML Users Manual - Page 168
    Importing the Sample Program Import the sample program to Eclipse. 1 Extract ePOS-Device_Sample_XML_Vx.x.x.zip, and save it to any folder. 2 Start Eclipse. Select [File]-[Import]. 3 Select [General]-[Existing Projects into Workspace]. Click the [Next] button. 168
  • Epson TM-T88V-DT | ePOS-Device XML Users Manual - Page 169
    Chapter 6 Sample Program 4 Click the [Browse...] button to display the saved sample program. Select the [Copy projects into workspace] checkbox and click the [Finish] button. 5 Confirm that the application has been properly imported. 6 169
  • Epson TM-T88V-DT | ePOS-Device XML Users Manual - Page 170
    the status sheet. For checking method of the status sheet, refer to Technical Reference Guide of each TM-DT. 4 EPSON TMNet WebConfig starts. Select [Web Service Settings] - [Device registration] - [Key input device]. 5 The "Key Input Device" screen is displayed. Perform the following settings
  • Epson TM-T88V-DT | ePOS-Device XML Users Manual - Page 171
    refer to Technical Reference Guide of each TM-i.  When accessing EPSON TMNet WebConfig, you are promoted to enter user name and password of EPSON TMNet WebConfig. The default is shown below. User name: epson Password: epson 4 EPSON TMNet WebConfig starts. Select [Web Service Settings] - [Device
  • Epson TM-T88V-DT | ePOS-Device XML Users Manual - Page 172
    for iOS Environment Device ❏ TM-Intelligent  TM-DT Series  TM-i Series (TM-i firmware Ver.4.0 or later) ❏ Barcode Scanner Execution environment This section explains the following environments. Information such as the webpage URLs and versions of files to download is current as of February
  • Epson TM-T88V-DT | ePOS-Device XML Users Manual - Page 173
    , enter your user name and password. The default values are as follows: User name : epson Password : epson 1. Network Settings Configure the system and TM-DT network settings. For the TM-DT network settings, use either of the following procedures:  Configuring the Windows network settings with
  • Epson TM-T88V-DT | ePOS-Device XML Users Manual - Page 174
    Connect a barcode scanner to TM-i. 2. Network Settings Make the network settings for the TM-i, using EPSON TMNet WebConfig. 3. Setting the Barcode Scanner (p.175) Register the barcode scanner to be connected into TM-DT. Make registration using an EPSON TMNet WebConfig. 4. Setting the Sample Program
  • Epson TM-T88V-DT | ePOS-Device XML Users Manual - Page 175
    in the address for the Web browser. The default IP address for TM-DT is 192.168.192.168. http://[IP address of TM-DT]/webconfig/ 4 EPSON TMNet WebConfig starts. Select [Web service settings] - [Device registration] - [Key input device]. 5 The "Key input device" screen is displayed. Perform
  • Epson TM-T88V-DT | ePOS-Device XML Users Manual - Page 176
    refer to Technical Reference Guide of each TM-i.  When accessing EPSON TMNet WebConfig, you are promoted to enter user name and password of EPSON TMNet WebConfig. The default is shown below. User name: epson Password: epson 4 EPSON TMNet WebConfig starts. Select [Web Service Settings] - [Device
  • Epson TM-T88V-DT | ePOS-Device XML Users Manual - Page 177
    Chapter 6 Sample Program Setting the Sample Program Configure the settings in the following procedure: 1 Expand ePOS-Device_Sample_XML_Vx.x.x.zip. 2 Start XCode and open the [ePOS-DeviceXMLSample.xcodeproj] project file. 3 When the project is opened, the project settings and source files will be
  • Epson TM-T88V-DT | ePOS-Device XML Users Manual - Page 178
    Executing Sample Program The iOS can be run with iOS Simulator. Androiod You can execute the sample program using the following methods. ❏ Executing with an emulator(p.178) ❏ Executing with an Android device(p.181) Executing with an emulator Execute the program using the following procedure. 1 Start
  • Epson TM-T88V-DT | ePOS-Device XML Users Manual - Page 179
    Chapter 6 Sample Program 2 Select the name of the virtual device to create and the OS version of the virtual device. Input any value for [Name], and make selections for [Target] and [CPU/ ABI]. Then click the [Create AVD] button. 3 The created virtual device is displayed. 4 Click the button to run
  • Epson TM-T88V-DT | ePOS-Device XML Users Manual - Page 180
    5 For the initial startup, the window to confirm the execution type appears. Select [Android Application] and click the [OK] button. 6 The emulator starts and the application is executed. 180
  • Epson TM-T88V-DT | ePOS-Device XML Users Manual - Page 181
    , see the site at the following URL. http://developer.android.com/tools/extras/oem-usb.html If you are unable to find an ADB USB driver for the device you are using at the site linked to above, search the website of the manufacturer of your device. 2 Make the following settings
  • Epson TM-T88V-DT | ePOS-Device XML Users Manual - Page 182
    5 Click the Run button in Eclipse.  If it is being run for the first time, the following window will appear. Select [Android Application], and click the [OK] button. 6 The sample application is installed and run on the Android device. 182
  • Epson TM-T88V-DT | ePOS-Device XML Users Manual - Page 183
    procedure. 1 Perform application settings. Chapter 6 Sample Program Set as follows. Setting Item IP Address DeviceID Printer DeviceID Scanner Description Input the TM-Intelligent's IP address. Input "local_printer". Input "local_scanner". 2 Click or tap [connect]. 3 Confirm that "Connect to
  • Epson TM-T88V-DT | ePOS-Device XML Users Manual - Page 184
    5 If the barcode is properly scanned, the scan result is displayed in [OnData]. 6 Click or tap [print] to print the scan result. 7 If it is printed properly, "Print success" is displayed on the bottom of the screen. 184
  • Epson TM-T88V-DT | ePOS-Device XML Users Manual - Page 185
    Appendix Appendix List of KeyCode Key KeyCode (Decimal) Backspace 8 Tab 9 Enter 13 Shift 16 Ctrl 17 Alt 18 Caps Lock 20 Esc 27 Space 32 PgUp 33 PgDn 34 End 35 Home 36 ! 37 # 38 ! 39 $ 40 Insert 45 Delete 46 Numbers on the keyboard 0 48 1 49 2 50 3
  • Epson TM-T88V-DT | ePOS-Device XML Users Manual - Page 186
    Key KeyCode (Decimal) Alphabets on the keyboard Q 81 R 82 S 83 T 84 U 85 V 86 W 87 X 88 Y 89 Z 90 Numeric keypad * 106 + 107 / 109 Function key F1 112 F2 113 F3 114 F4 115 F5 116 Key Function key F6 F7 F8 F9 F10 F11 F12 Caps Lock KeyCode (Decimal) 117 118
  • Epson TM-T88V-DT | ePOS-Device XML Users Manual - Page 187
    Color Specification Raster Image Logo Barcode Receipt 80mm 58mm Slip Endorsement Ethernet, Wireless LAN 180 x 180 dpi - 512 dots - Font A, Font B For more information about what character codes can be printed, refer to the user's manual that came with the printer
  • Epson TM-T88V-DT | ePOS-Device XML Users Manual - Page 188
    Receipt 80mm 58mm 2D-Code PDF417, QR Code, MaxiCode, GS1 DataBar Stacked, GS1 DataBar Stacked Omnidirectional, GS1 DataBar Expanded Stacked, Composite Symbology Ruled Line , Not supported Page Mode Default Area 512 dots x 831 dots (W x H) 360 dots x 831 dots (W x
  • Epson TM-T88V-DT | ePOS-Device XML Users Manual - Page 189
    TM-T70II-DT/ TM-T70II 80mm Interface Ethernet, Wireless LAN Resolution 203 dpi x 203 dpi (W x H) Print Width 576 dots Font Font A, Font B For more information about what character codes can be printed, refer to the user's manual that came with the printer Specification Not supported Page
  • Epson TM-T88V-DT | ePOS-Device XML Users Manual - Page 190
    Paper layout setting Forced transmission mode Recovery from an error Reset Command Not supported Supported Supported Supported Supported 80mm 190
  • Epson TM-T88V-DT | ePOS-Device XML Users Manual - Page 191
    Appendix TM-T88V-DT/ TM-T88V-i/ TM-T88V Interface Resolution Print Width Font Characters in a Ethernet, Wireless LAN 180 dpi x 180 dpi (W x H) 512 dots 360 dots Font A, Font B For more information about what character codes can be printed, refer to the user's manual that came with the printer
  • Epson TM-T88V-DT | ePOS-Device XML Users Manual - Page 192
    , QR Code, MaxiCode, GS1 DataBar Stacked, GS1 DataBar Stacked Omnidirectional, GS1 DataBar Expanded Stacked (Composite Symbology not supported) Ruled Line , Not supported Page Mode Default Area 512 dots x 831 dots (W x H) 360 dots x 831 dots (W x H) Page Mode Maximum Area
  • Epson TM-T88V-DT | ePOS-Device XML Users Manual - Page 193
    TM-T20II-i 80mm Interface Ethernet, Wireless LAN Resolution 203 dpi x 203 dpi (W x H) Print Width (42 Column Mode) 576 dots (546 dots) Font For more information about what character codes can be printed, refer to the user's manual that came with the printer Color Specification First color
  • Epson TM-T88V-DT | ePOS-Device XML Users Manual - Page 194
    Paper Cut Drawer Kick-Out Buzzer Paper layout setting Forced transmission mode Recovery from an error Reset Command Cut, Feed cut Supported Optional Not supported Supported Supported Supported Supported 80mm 194
  • Epson TM-T88V-DT | ePOS-Device XML Users Manual - Page 195
    Forced transmission mode Recovery from an error 80mm Ethernet, Wireless LAN 180 dpi x 180 dpi (W x H) 512 dots For more information about what character codes can be printed, refer to the technical reference guide that came with the printer. ANK: 42 characters ANK: 56 characters ANK: 12
  • Epson TM-T88V-DT | ePOS-Device XML Users Manual - Page 196
    Reset Command Supported Supported 80mm 196
  • Epson TM-T88V-DT | ePOS-Device XML Users Manual - Page 197
    TM-T82II-i/ TM-T82II 80mm Interface Ethernet, Wireless LAN Resolution 203 dpi x 203 dpi (W x H) Print Width (42 Column Mode) 576 dots (546 dots) Font For more information about what character codes can be printed, refer to the user's manual that came with the printer Specification First
  • Epson TM-T88V-DT | ePOS-Device XML Users Manual - Page 198
    Paper Cut Drawer Kick-Out Buzzer Paper layout setting Forced transmission mode Recovery from an error Reset Command Cut, Feed cut Supported Optional Not supported Supported Supported Supported Supported 80mm 198
  • Epson TM-T88V-DT | ePOS-Device XML Users Manual - Page 199
    Appendix TM-L90 Receipt Die-cut label Interface Ethernet, Wireless LAN Resolution 203 dpi x 203 dpi (W x H) Print Width 256 to 576 dots 224 to 560 dots Font For more information about what character codes can be printed, refer to the user's manual that came with the printer. Characters
  • Epson TM-T88V-DT | ePOS-Device XML Users Manual - Page 200
    Receipt Die-cut label Page Mode Maximum Area 576 dots x 1476 dots (W x H) 560 dots x 1476 dots (W x H) when twocolor printing is set 576 dots x 738 dots (W x H) 560 dots x 738 dots (W x H) Page Mode Line Rectangle Not supported Paper Cut Cut, Feed cut Drawer
  • Epson TM-T88V-DT | ePOS-Device XML Users Manual - Page 201
    Line Rectangle Receipt 58mm Receipt 60mm Wireless LAN 203 dpi x 203 dpi (W x H) 420 dots 432 dots Font A, Font B, Font C For more information about what character codes can be printed, refer to the user's manual that came with the printer. ANK: 35 characters, ANK: 36
  • Epson TM-T88V-DT | ePOS-Device XML Users Manual - Page 202
    Kick-Out Buzzer Paper layout setting Forced transmission mode Recovery from an error Reset Command Receipt 58mm Cut, Feed cut Not supported Supported(Pattern 1 to 10, Stop) Not supported Supported Supported Supported Supported Receipt 60mm 202
  • Epson TM-T88V-DT | ePOS-Device XML Users Manual - Page 203
    Area Page Mode Maximum Area Receipt 58mm Receipt 60mm Die-cut label Wireless LAN 203 dpi x 203 dpi (W x H) 420 dots 432 dots 160 to 400 dots Font A, Font B, Font B For more information about what character codes can be printed, refer to the user's manual that came with the printer. ANK: 35
  • Epson TM-T88V-DT | ePOS-Device XML Users Manual - Page 204
    mode Recovery from an error Reset Command Receipt 58mm Receipt 60mm Supported (Only for solid line) Feed cut (Feeds paper to cutting position) Not supported Supported(Pattern 1 to 10, Stop) Supported Supported Supported Supported Supported Die-cut label 204
  • Epson TM-T88V-DT | ePOS-Device XML Users Manual - Page 205
    TM-P80 80mm Interface Wireless LAN Resolution 203 dpi x 203 dpi (W x H) Print Width 576 dots Font For more information about what character codes can be printed, refer to the user's manual that came with the printer Feed Space 30 dots Color Specification First color Page Mode Default
  • Epson TM-T88V-DT | ePOS-Device XML Users Manual - Page 206
    Forced transmission mode Recovery from an error Reset Command Supported Supported Supported Supported 80mm 206
  • Epson TM-T88V-DT | ePOS-Device XML Users Manual - Page 207
    Drawer Kick-Out Buzzer 58mm 80mm Ethernet 203 dpi x 203 dpi (W x H) 420 dots 576 dots Font A, Font B For more information about what character codes can be printed, refer to the user's manual that came with the printer. ANK: 35 characters, ANK: 48 characters ANK: 46
  • Epson TM-T88V-DT | ePOS-Device XML Users Manual - Page 208
    Paper layout setting Forced transmission mode Recovery from an error Reset Command 58mm Not supported Supported Supported Supported Supported 80mm 208
  • Epson TM-T88V-DT | ePOS-Device XML Users Manual - Page 209
    TM-T20II 58mm 80mm Interface Ethernet, Wireless LAN Resolution 203 dpi x 203 dpi (W x H) Print Width (42 Column Mode) 420 dots (378 dots) 576 dots (546 dots) Font For more information about what character codes can be printed, refer to the user's manual that came with the printer
  • Epson TM-T88V-DT | ePOS-Device XML Users Manual - Page 210
    Paper Cut Drawer Kick-Out Buzzer Paper layout setting Forced transmission mode Recovery from an error Reset Command 58mm Cut, Feed cut Supported Optional Not supported Supported Supported Supported Supported 80mm 210
  • Epson TM-T88V-DT | ePOS-Device XML Users Manual - Page 211
    Appendix TM-T88IV 80mm 58mm Interface Ethernet, Wireless LAN Resolution 180 dpi x 180 dpi (W x H) Print Width 512 dots 360 dots Font For more information about what character codes can be printed, refer to the user's manual that came with the printer. Characters in a Line Font A ANK:
  • Epson TM-T88V-DT | ePOS-Device XML Users Manual - Page 212
    Paper layout setting Forced transmission mode Recovery from an error Reset Command 80mm Not supported Supported Supported Supported Supported 58mm 212
  • Epson TM-T88V-DT | ePOS-Device XML Users Manual - Page 213
    Appendix TM-T90 58mm 60mm 80mm Interface Ethernet, Wireless LAN Resolution 180 dpi x 180 dpi (W x H) Print Width 360 dots 384 dots 512 dots Font For more information about what character codes can be printed, refer to the technical reference guide that came with the printer.
  • Epson TM-T88V-DT | ePOS-Device XML Users Manual - Page 214
    Out Buzzer Paper layout setting Forced transmission mode Recovery from an error Reset Command 58mm 60mm Not supported Cut, Feed cut Supported Supported via Drawer Kick-Out Not supported Supported Supported Supported Supported 80mm 214
  • Epson TM-T88V-DT | ePOS-Device XML Users Manual - Page 215
    TM-U220 76mm 70mm 58mm Interface Ethernet, Wireless LAN Resolution 80 dpi x 72 dpi (W x H) Print Width 200 dots 180 dots 150 dots Font Font A, Font B For more information about what character codes can be printed, refer to the user's manual that came with the printer Specification
  • Epson TM-T88V-DT | ePOS-Device XML Users Manual - Page 216
    Recovery from an error Reset Command 76mm Not supported Supported Supported 70mm 58mm 216
  • Epson TM-T88V-DT | ePOS-Device XML Users Manual - Page 217
    Appendix Paper setting function of TM-L90 Setting Paper Width It sets the paper width with memory switch setting mode. 1 Turn the printer's power off and set the receipt paper. 2 While the cover is opened, turn the power on while pressing the FEED button. 3 After confirming the ERROR LED lights up,
  • Epson TM-T88V-DT | ePOS-Device XML Users Manual - Page 218
    218
  • 1
  • 2
  • 3
  • 4
  • 5
  • 6
  • 7
  • 8
  • 9
  • 10
  • 11
  • 12
  • 13
  • 14
  • 15
  • 16
  • 17
  • 18
  • 19
  • 20
  • 21
  • 22
  • 23
  • 24
  • 25
  • 26
  • 27
  • 28
  • 29
  • 30
  • 31
  • 32
  • 33
  • 34
  • 35
  • 36
  • 37
  • 38
  • 39
  • 40
  • 41
  • 42
  • 43
  • 44
  • 45
  • 46
  • 47
  • 48
  • 49
  • 50
  • 51
  • 52
  • 53
  • 54
  • 55
  • 56
  • 57
  • 58
  • 59
  • 60
  • 61
  • 62
  • 63
  • 64
  • 65
  • 66
  • 67
  • 68
  • 69
  • 70
  • 71
  • 72
  • 73
  • 74
  • 75
  • 76
  • 77
  • 78
  • 79
  • 80
  • 81
  • 82
  • 83
  • 84
  • 85
  • 86
  • 87
  • 88
  • 89
  • 90
  • 91
  • 92
  • 93
  • 94
  • 95
  • 96
  • 97
  • 98
  • 99
  • 100
  • 101
  • 102
  • 103
  • 104
  • 105
  • 106
  • 107
  • 108
  • 109
  • 110
  • 111
  • 112
  • 113
  • 114
  • 115
  • 116
  • 117
  • 118
  • 119
  • 120
  • 121
  • 122
  • 123
  • 124
  • 125
  • 126
  • 127
  • 128
  • 129
  • 130
  • 131
  • 132
  • 133
  • 134
  • 135
  • 136
  • 137
  • 138
  • 139
  • 140
  • 141
  • 142
  • 143
  • 144
  • 145
  • 146
  • 147
  • 148
  • 149
  • 150
  • 151
  • 152
  • 153
  • 154
  • 155
  • 156
  • 157
  • 158
  • 159
  • 160
  • 161
  • 162
  • 163
  • 164
  • 165
  • 166
  • 167
  • 168
  • 169
  • 170
  • 171
  • 172
  • 173
  • 174
  • 175
  • 176
  • 177
  • 178
  • 179
  • 180
  • 181
  • 182
  • 183
  • 184
  • 185
  • 186
  • 187
  • 188
  • 189
  • 190
  • 191
  • 192
  • 193
  • 194
  • 195
  • 196
  • 197
  • 198
  • 199
  • 200
  • 201
  • 202
  • 203
  • 204
  • 205
  • 206
  • 207
  • 208
  • 209
  • 210
  • 211
  • 212
  • 213
  • 214
  • 215
  • 216
  • 217
  • 218

ePOS-Device XML
User’s Manual
M00055604
Rev.E
Overview
Building Environment
Programming Guide
ePOS-Device XML
Device Control Script
Describes the features and development environment.
Describes environment building for ePOS-Device
Service I/F.
Describes how to write programs in Web application
development.
Describes the ePOS-Device XML.
Describes the device control script.
Sample Program
Describes the sample program.
Appendix