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...
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.
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.
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 ■...
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...
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.
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.
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...
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 ...
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.
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.
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.
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)....
[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...
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.
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.
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) ...
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].
<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.
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...
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:...
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.
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.
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".
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.
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.
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.
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.
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.
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.
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;...
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>...
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.
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.
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");...
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 •...
• "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.
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.
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 &...
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"...