Epson TM-T88V-DT User Manual

Server direct print
Hide thumbs Also See for TM-T88V-DT:

Advertisement

Quick Links

Server Direct Print
User's Manual
Overview
Describes the operating environment and system
configuration of Server Direct Print.
Sample Program
Describes how to use the sample program and how to
configure the system.
Request and Response
Describes the requests and responses of Server Direct
Print.
Status Notification
Describes the Status Notification function.
M00062904
Rev.E

Advertisement

Table of Contents
loading

Summary of Contents for Epson TM-T88V-DT

  • Page 1 Server Direct Print User’s Manual Overview Describes the operating environment and system configuration of Server Direct Print. Sample Program Describes how to use the sample program and how to configure the system. Request and Response Describes the requests and responses of Server Direct Print.
  • Page 2 • Neither is any liability assumed for damages resulting from the use of the information contained herein. • Neither Seiko Epson Corporation nor its affiliates shall be liable to the purchaser of this product or third parties for damages, losses, costs, or expenses incurred by the purchaser or third parties as a result of: accident, misuse, or abuse of this product or unauthorized modifications, repairs, or alterations to this product, or (excluding the U.S.) failure to strictly comply with Seiko Epson Corporation’s operating and...
  • Page 3: For Safety

    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 avoid damage to your equipment or a malfunction.
  • Page 4: About This Manual

    This manual presents information that is necessary information for using the TM-Intelligent. The TM-Intelligent series in this manual is a generic term for the TM-DT series and TM-i series. The TM-DT series in this manual is a generic term for the following printers.  TM-T88V-DT  TM-T70II-DT  TM-H6000IV-DT The TM-i series in this manual is a generic term for the following printers.
  • Page 5: Table Of Contents

    Contents ■ For Safety ..........................3 Key to Symbols ............................3 ■ Restriction of Use ........................3 ■ About this Manual ........................ 4 Aim of the Manual ..........................4 Manual Content ............................ 4 ■ Contents..........................5 Overview ..................7 ■ Overview of Server Direct Print ................... 7 Printing Process............................
  • Page 6 Initial OS Settings...........................31 Initializing the ePOS-Device.........................32 IP Address Settings..........................33 Service startup settings ........................34 Server Direct Print Settings ........................35 Registration of TM Printer ........................37 ■ Execution of Sample Program ..................39 Request and Response ............... 41 ■ Request (Print Request)...................... 41 ■...
  • Page 7: Overview

    Chapter 1 Overview Overview This chapter describes the overview of Server Direct Print and Status Notification. Overview of Server Direct Print Server Direct Print function enables the TM intelligent printer (TM-i and TM-DT) to obtain the print data from the Web server and print the data. TM intelligent printer can be used also for controllable printers in the network.
  • Page 8 Difference from General Printing System In general printing systems, the application sends a print instruction to the printer. With Server Direct Print, the printer sends an Inquiry of print request to the Web application, and the Web application returns a response that has print data included in it. Server Direct Print Traditional Printing Computer...
  • Page 9: Printing Process

    Chapter 1 Overview Printing Process TM intelligent printer asks the Web server whether data to be printed exists. When data to be printed exists, the Web server application creates an XML-format response containing the data to be printed, and returns it to the TM intelligent printer.
  • Page 10: Overview Of Status Notification

    Overview of Status Notification Status Notification is the function used to periodically notify the printer status to the Web server. The web server registers status from TM intelligent printer to database, then responds with an empty response to TM intelligent printer. Operating the printer management application created by the user with the Web server enables grasp of the status of the printers installed in a shop from a remote place.
  • Page 11: Operating Environment

    Chapter 1 Overview Operating Environment How to Access the Web server How to access TM-DT TM-i ● ● Proxy server ▲ ● Proxy authentication ● ● Digest authentication ● ● HTTPS communication ▲ ● HTTPS communication with server authentication ●: Supported, ▲: Not supported *1: Available only for Web contents automatic updating *2: TM-i firmware ver.4.0 or later *3: Available only for Server Direct Print and Status Notification...
  • Page 12: Tm Intelligent Printer

    TM Intelligent Printer TM Intelligent Printer ePOS-Print TM-T88V-DT ● TM-DT TM-T70II-DT TM-H6000IV-DT TM-T88V-i TM-T70-i ● TM-i TM-T82II-i TM-L90-i ●: Supported, ▲: Not supported *1: ePOS-Device ver.2.2 or later *2: TM-i firmware ver.3.0 or later TM Printer TM Printer TM-i TM-DT ●...
  • Page 13: Contents In The Package

    The sample program is included in the Server Direct Print User's Manual package. ❏ epsonsample_eposprint.zip: Sample Program for ePOS-Print XML Utility Used to register NV logo to the printer. Utility TM printer  TM-T88V-i/ TM-T88V-DT/ TM-T88V TM-T88V Utility  TM-T70II-DT/ TM-T70II TM-T70II Utility  TM-H6000IV/ TM-H6000IV-DT TM-H6000IV Utility ...
  • Page 14: Tm-Dt Version

    If you update the ePOS-Device, you will be able to use Server Direct Print's new functions. Confirming the ePOS-Device version You can confirm the version of the ePOS-Device on the EPSON TMNet WebConfig title bar. Downloading the ePOS-Device update program Download the following file from the Epson website and save it in your local environment.
  • Page 15: Tm-I Version

    Confirming the TM-i firmware version You can confirm the version of the ePOS-Device on the EPSON TMNet WebConfig title bar. Make sure that this printer is ready to print (the paper is set and the power is turned on), and hold down the push button at the rear of this printer for at least 3 seconds before releasing it.
  • Page 16: Restriction

    Restriction ❏ If power is restored the device or the cover is open during printing, printing may not occur properly. ❏ To turn the device power off and on, be sure to allow an interval of five seconds or more between power off and on.
  • Page 17: Sample Program

    Chapter 2 Sample Program Sample Program This chapter describes how to use the sample program for Server Direct Print. • In this chapter, a system configuration using a Web server is explained as an example. • In this chapter, the Web server is described as a Web server configured with IIS (Microsoft Internet Information Services)....
  • Page 18: Hardware Configuration

    [192.168.192.21] ❏ Web Server (Its operation has already been checked using IIS and XAMP .) ❏ Router ❏ TM Intelligent Printer  TM-T88V-i, TM-T70-i, TM-L90-i, TM-T88V-DT, TM-T70II-DT or TM-H6000IV-DT ❏ TM Printer File Configuration File Name Description The server returns a response containing print data when the Test_print.php...
  • Page 19: Printing Result

    Chapter 2 Sample Program Printing Result Cooking Slip Delivery Slip Program Flow The flow from the initial display to the print completion of the sample program is as shown below. 1. Start the browser. 2. Enter the order. 3. Receive a request from the printer. 4.
  • Page 20: Environment Settings

    Environment Settings The environment setting flow of the sample program is as shown below. 1. Router Settings Set information such as SSID, IP address, DHCP and allocated IP address. For details, see the manual for each device. 2. Web Server Settings 1.
  • Page 21: Sample Program Configuration

    Chapter 2 Sample Program 4.TM Intelligent Printer Settings ❏ TM-i  IP Address Setting  Register the TM Printers (Device ID, IP Address)  Server authentication setting * (set this as necessary)  Proxy server setting * (set this as necessary) ...
  • Page 22: Tm Printer Network Settings

    TM printer]/PrinterConfigurationPage/ • The default ID address of TM printer is "192.168.192.168". • The login name for the TM printer is “epson”, and the default password is “epson”. EPSON TMNet WebConfig starts. Select as [Configuration] - [Network] - [TCP/IP].
  • Page 23: Tm-I Settings

    <TM-i Firmware ver.4.0 or later> http://[IP address of the TM-i]/webconfig EPSON TMNet WebConfig will start. Make the network setting. For detail, refer to Technical Reference Guide of each TM-i. After making the setting, click [Apply]. Print the TM-i status sheet and check the network setting.
  • Page 24: Registration Of Tm Printer

    Registration of TM Printer Register the device ID and IP address of the controlled TM printer to TM-i. Use EPSON TMNet WebConfig to register the device ID. • TM-i printer cannot be deleted from the device. • The device ID of TM-i printer can be changed.
  • Page 25 Chapter 2 Sample Program The “Device Settings” screen appears. Set the following items and click [Submit]. Item Description Device ID Set the ID for the controlled printer. (Any character string) Model Select the model for the controlled printer. IP Address Set the printer IP address for each device ID.
  • Page 26 TM-i]/PrinterConfigurationPage/ For details about the IP address settings for TM-i, see IP Address Settings (p.23). EPSON TMNet WebConfig starts. Select [Web Service Settings] - [Printer]. The “Printer” screen appears. Configure the following items, click [Add]. Item...
  • Page 27: Server Direct Print Settings

    Chapter 2 Sample Program Server Direct Print Settings Configure the Server Direct Print settings using EPSON TMNet WebConfig. TM-i firmware ver.3.x or earlier    Use the following procedure for registration. Start the setup computer. Connect the TM-i to the network and turn the power ON.
  • Page 28 The “Server Direct Print Setting” screen appears. Set the following items and click [Submit]. Item Description Server Direct Print Select the [Enable]. Set ID for the server-side program to identify TM-i. This ID becomes the user ID used for Digest access authentication. The set value will also be passed as an ID parameter value for the form data posted to the server.
  • Page 29 TM-i]/PrinterConfigurationPage/ For details about the IP address settings for TM-i, see IP Address Settings (p.23). EPSON TMNet WebConfig starts. Select [Web Service Settings] - [Direct Print]. The “Direct Print” screen appears. Set the following items and click [Apply].
  • Page 30 Item Description Sets whether the server authentication is performed with the Authenticate Server registered certificate when accessed through https. When using Server, select [System Settings] - [Proxy].   The “Proxy” screen appears. Set the following items, then click [Apply]. Item Description Enter the proxy server URL and port number in the following:...
  • Page 31: Tm-Dt Settings

    Chapter 2 Sample Program TM-DT Settings Configure the following settings to TM-DT. ❏ Initial OS Settings ❏ Initializing the ePOS-Device ❏ IP Address Settings ❏ Service Startup Settings ❏ Server Direct Print Settings ❏ Registration of TM Printer Initial OS Settings This section describes the procedure for making OS settings when the TM-DT is turned on for the first time.
  • Page 32: Initializing The Epos-Device

    Initializing the ePOS-Device Use the shortcut on the desktop to enable the ePOS-Device. [Enabled] is set in the default factory settings. Enabling the ePOS-Device Select the [ePOS-Device Enabled] shortcut on the desktop.
  • Page 33: Ip Address Settings

    Set an IP address. This setting is the same as for Windows computers. Use the following procedure.  Setting in Windows  Setting in EPSON TMNet WebConfig (TM-DT software ver. 2.x or later)  Setting in EPSONNet Config (TM-DT software ver. 2.x or later) Setting in Windows Click [Start] - [Control Panel] - [View network status and tasks] and make a "Network connection".
  • Page 34: Service Startup Settings

    Service startup settings To make service startup settings, use EPSON TMNet WebConfig and the following procedure. Start EPSON TMNet WebConfig from the shortcut on the desktop. EPSON TMNet WebConfig starts. If you are making settings from an external device, set the TM-DT IP address in the address for the Web browser.
  • Page 35: Server Direct Print Settings

    Chapter 2 Sample Program Server Direct Print Settings Configure the Server Direct Print settings using EPSON TMNet WebConfig.   Start EPSON TMNet WebConfig from the shortcut on the desktop. EPSON TMNet WebConfig starts. If you are making settings from an external device, set the TM-DT IP address in the address for the Web browser.
  • Page 36 Set the following items and click [OK]. Item Description Set ID for the server-side program to identify TM-DT. This ID becomes the user ID used for Digest access authentication. The set value will also be passed as an ID parameter value for the form data posted to the server.
  • Page 37: Registration Of Tm Printer

    Sample Program Registration of TM Printer Register the device ID and IP address of the controlled TM printer to TM-DT. Use EPSON TMNet WebConfig to register the device ID. This printer is already registered with the "local_printer" device ID, and therefore this setting is not required.
  • Page 38 Set the following items and click [Add]. Item Description Device ID Set the ID for the controlled printer. (Any character string) Model no. Select the model for the controlled printer. IP address Set the printer IP address for each device ID. Set the timeout retry interval.
  • Page 39: Execution Of Sample Program

    Chapter 2 Sample Program Execution of Sample Program Using EPSON TMNet WebConfig, confirm that Server Direct Print settings are valid. Open the sample program page from the Web browser. Example: http://[IP address of the Web server]/demo/index.html Click [Order Entry]. In response to a request from the TM intelligent printer, print data is sent and a slip is printed from the printer.
  • Page 41: Request And Response

    Chapter 3 Request and Response Request and Response This chapter describes requests from the TM intelligent printer and responses from the Web server. User's application can start printing by returning a response containing print data to a HTTP POST request (print request) from the printer.
  • Page 42: Response (Print Request)

    Response (Print request) This section describes the response (print request) containing the print data from the Web server. Web Server TM Intelligent Printer 1 : HTTP Request (Print request) 2.1 : Create XML from a database or other system 2.2 : HTTP Response (Print request) The application responds by creating response data as shown below.
  • Page 43 <PrintRequestInfo> <ePOSPrint> <Parameter> Specify the <devid>local_printer</devid> device ID <timeout>10000</timeout> </Parameter> <PrintData> <epos-print xmlns="http://www.epson-pos.com/schemas/2011/03/epos-print"> <text lang="en" /> <text smooth="true" /> <text align="center" /> <text font="font_b" /> <text width="2" height="2" /> <ePOSPrint>tag <text reverse="false" ul="false" em="true" color="color_1" /> <text>DELIVERY TICKET</text> <feed unit="12" />...
  • Page 44 <epos-print xmlns="http://www.epson-pos.com/schemas/2011/03/epos-print"> <text lang="en" /> <text smooth="true" /> <text rotate="true" /> <text align="center" /> <barcode type="code39" hri="none" font="font_a" width="2" height="60">0001 </barcode> <feed unit="30" /> <text align="left" /> <text>0001</text> <text>03-19-2013 13:53:15</text> <text reverse="true" /> <text>Kitchen</text> <text reverse="false" /> <text /> <text>[New Order]</text>...
  • Page 45: Response When No Printing Is Performed

    Chapter 3 Request and Response Response When No Printing Is Performed When no printing is required, to notify no print data, the following response is returned for a HTTP request (print request) sent from the TM intelligent printer. See Test_print.php of the sample program. HTTP/1.1 200 OK Content-Type: text/xml;...
  • Page 46: Print Data

    <PrintRequestInfo> <ePOSPrint> <Parameter> Specify the <devid>local_printer</devid> device ID <timeout>10000</timeout> </Parameter> <PrintData> <epos-print xmlns="http://www.epson-pos.com/schemas/2011/03/epos-print"> <text lang="en" /> <text smooth="true" /> <text align="center" /> <text font="font_b" /> <text width="2" height="2" /> <ePOSPrint>tag <text reverse="false" ul="false" em="true" color="color_1" /> <text>DELIVERY TICKET</text> <feed unit="12" />...
  • Page 47 Chapter 3 Request and Response </ePOSPrint> <ePOSPrint> <Parameter> <devid>kitchen_printer</devid> <timeout>10000</timeout> </Parameter> <PrintData> <epos-print xmlns="http://www.epson-pos.com/schemas/2011/03/epos-print"> <text lang="en" /> <text smooth="true" /> <text rotate="true" /> <text align="center" /> <barcode type="code39" hri="none" font="font_a" width="2" height="60">0001</barcode> <feed unit="30" /> <text align="left" /> <text>0001</text> <text>03-19-2013 13:53:15</text>...
  • Page 48: Request (Printing Result)

    POST /demo/Test_print.php HTTP/1.1 Host: 192.168.192.10 Content-Type: application/x-www-form-urlencoded Content-Length: xxx ConnectionType=SetResponse&ID=&ResponseFile=Printing Result Check the <response> tag for the printing result. <?xml version="1.0" encoding="utf-8"?> <PrintResponseInfo Version="1.00"> #Success <response>tag <response xmlns="http://www.epson-pos.com/schemas/2011/03/epos-print" success="true" code="" status="251854870" battery="0"/> #Failed <response xmlns="http://www.epson-pos.com/schemas/2011/03/epos-print" success="false" code="EX_BADPORT" status="1" battery="0"/> </PrintResponseInfo>...
  • Page 49 Check if the <response> tag indicates "success" or "failed". Item Description true Success false Failed On failure, an error code is described in "code". For details, see "Error code" (p.50). <PrintResponseInfo Version="1.00"> #Success <response xmlns="http://www.epson-pos.com/schemas/2011/03/epos-print" success="true" code="" status="251854870" battery="0"/> #Failed <response xmlns="http://www.epson-pos.com/schemas/2011/03/epos-print" success="false" code="EX_BADPORT" status="1" battery="0"/> </PrintResponseInfo>...
  • Page 50: Error Code

    Error code Request Error This occurs when the device has a problem. The following table shows errors that can occur. Code Message Cause An automatically recoverable Continuous printing of high-density EPTR_AUTOMATICAL error occurred. printing EPTR_COVER_OPEN The device has a problem. The cover is open.
  • Page 51: Digest Access Authentication

    Digest access authentication requires settings for the TM intelligence printer and the server. TM Intelligent Printer Use EPSON TMNet WebConfig of TM-i/TM-DT to set your user ID and password required for Digest access authentication. For details, see "Server Direct Print Settings" for individual TM intelligent printers.
  • Page 52: Program Example

    Program Example See the following programming data (file name: Test_print.php) <?php header('Content-Type: text/xml; charset=UTF-8'); define("REQUEST_XML_PATH", "demo/request/sample.xml"); define("RESPONSE_XML_PATH", "demo/response/sample.xml"); if (isset($_POST["ConnectionType"])) { $http_request = $_POST["ConnectionType"]; if ($http_request == 'GetRequest') { # send print data # ID $shop_id = $_POST["ID"]; # create print data if (file_exists(REQUEST_XML_PATH)) { # return print data $handle = fopen(REQUEST_XML_PATH, "r");...
  • Page 53: Status Notification

    Web Server 1 : HTTP Request (Status Information) 2 : Register the status to the database 2.1 : HTTP Response (Status Information) For TM-DT, enable the following settings in EPSON TMNet WebConfig. • ePOS-Device • Service startup settings • Device control •...
  • Page 54: Overview Of Status Notification Sample Program

    • "TM-i Settings" (p.54) • "TM-DT Settings" (p.57) TM-i Settings TM-i firmware ver.3.x or earlier Configure the Status Notification settings using EPSON TMNet WebConfig.    Use the following procedure for registration. Start the setup computer. Connect the printer to the network and turn the power ON.
  • Page 55 Chapter 4 Status Notification EPSON TMNet WebConfig starts. Select [Status Notification]. The "Status Notification Settings" screen appears. Set the following items and click [Submit]. Item Description Status Notification Select the [Enable]. Set ID for the server-side program to identify TM-i. This ID becomes the user ID used for Digest access authentication.
  • Page 56 EPSON TMNet WebConfig starts. Select [Web Service Settings] - [Status Notification]. The "Status Notification" screen appears. Set the following items and click [Submit]. Item Description Status Notification Select the [Enable]. Set ID for the server-side program to identify TM-i. This ID becomes the user ID used for Digest access authentication.
  • Page 57 Configure the Status Notification settings using EPSON TMNet WebConfig.   Use the following procedure for registration. Connect the TM-DT to the network and turn the power ON. Start EPSON TMNet WebConfig from the shortcut on the desktop. EPSON TMNet WebConfig starts. If you are making settings from an external device, set the TM‐DT IP address 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/ Select as [Settings]-[Web service settings]-[Status notification].
  • Page 58 Set the following items and click [Apply]. Item Description Set ID for the server-side program to identify TM-DT. This ID becomes the user ID used for Digest access authentication. The set value will also be passed as an ID parameter value for the form data posted to the server. Not required for the sample program.
  • Page 59: Execution Of Sample Program

    Chapter 4 Status Notification Execution of Sample Program Confirm that Status Notification of TM intelligent printer is set. Open the sample program page from the Web browser. Example: http://[IP address of the Web Server]/demo/indexStatus.html The “resultPrint.log” is created from the message from the TM intelligent printer and the result is displayed on the screen.
  • Page 60: Status Type

    Status Type The following types of ASB (AutoStatusBack) status can be obtained from the TM-i. Code Description 0x00000001 No printer response 0x00000002 Print complete 0x00000004 Status of the drawer kick number 3 connector pin = "H" 0x00000008 Offline status 0x00000020 Cover is open 0x00000040 Paper feed switch is feeding paper...
  • Page 61 Chapter 4 Status Notification Program Example Refer to the programming below. (File name: Test_status.php) <?php header('Content-Type: text/xml; charset=UTF-8'); # Open the file to save status. $fhandle = @fopen("ResultStatus.log", "wt"); # Update the printer status. if (isset($_POST["Status"])) { $status = $_POST["Status"]; $xml = simplexml_load_string($status);...
  • Page 62 if (($asb & 0x00002000) == 0x00002000) $strmsg .= " Unrecoverable error generated \n"; if (($asb & 0x00004000) == 0x00004000) $strmsg .= " Auto recovery error generated \n"; if (($asb & 0x00020000) == 0x00020000) $strmsg .= " No paper in the roll paper near end detector \n"; if (($asb &...
  • Page 63: Request And Response

    Chapter 4 Status Notification Request and Response Request The format of request message is URL-encoded form data (application/x-www-form-urlencoded). Parameter Value ConnectionType Status The ID set with WebConfig ResponseFile Status Information POST /demo/Test_status.php HTTP/1.1 Host: 192.168.192.10 Content-Type: application/x-www-form-urlencoded Content-Length: xxx ConnectionType=SetStatus&ID=&Status=Status Information The status information configuration is as follows: <?xml version="1.0"...

Table of Contents