Epson TM-T88VI-i Users Manual - Server Direct Print
Epson TM-T88VI-i Manual
View all Epson TM-T88VI-i manuals
Add to My Manuals
Save this manual to your list of manuals |
Epson TM-T88VI-i manual content summary:
- Epson TM-T88VI-i | Users Manual - Server Direct Print - 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 - Epson TM-T88VI-i | Users Manual - Server Direct Print - Page 2
to this product, or (excluding the U.S.) failure to strictly comply with Seiko Epson Corporation's operating and maintenance instructions. • Seiko Epson Corporation shall not be liable against any damages or problems arising from the use of any options or any consumable products other than those - Epson TM-T88VI-i | Users Manual - Server Direct Print - 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-T88VI-i | Users Manual - Server Direct Print - Page 4
for developing and designing systems with the Server Direct Print and Status Notification function for TM printers with SDP (Server Direct Print) support. Manual Content The manual is made up of the following sections: Chapter 1 Overview Chapter 2 Sample Program Chapter 3 Request and - Epson TM-T88VI-i | Users Manual - Server Direct Print - Page 5
■ Operating Environment ...12 TM printers with SDP support...12 TM Printer...12 How to Access the Web server ...13 Number of URLs accessible for Server Direct Print 13 Customer Display ...13 ■ Contents In the Package 14 Manual ...14 Sample Program ...14 Utility ...14 Download ...14 ■ Restriction - Epson TM-T88VI-i | Users Manual - Server Direct Print - Page 6
Authentication Settings 55 ■ Program Example...56 Status Notification 57 ■ Overview...57 ■ Overview of Status Notification Sample Program 58 TM Printers with SDP Support Settings 58 Execution of Sample Program ...64 ■ Status Type ...65 ■ Request and Response ...68 Request...68 Response ...71 - Epson TM-T88VI-i | Users Manual - Server Direct Print - Page 7
it cannot be printed from the printer. *1 It also allows you to control display of a Customer Display connected to the printer. *2 *1: TM-i series (TM-i Firmware Ver.4.0 or earlier) and TM-DT series (TM-DT Software Ver.2.6 or earlier) are not supported. *2: Only for TM-T88VI and TM-T88VI-iHUB. 7 - Epson TM-T88VI-i | Users Manual - Server Direct Print - Page 8
to the Web application, and the Web application returns a response that has print data included in it. General Printing Server Direct Print Computer Application Specifies a printer Print layout data TM Printer Print data Web Server Application Global IP Address TM printers with SDP support 8 - Epson TM-T88VI-i | Users Manual - Server Direct Print - Page 9
upon receipt of a response (print request). (For TM-i Firmware Ver.4.1 or later of the TM-i series. For TM-DT Software Ver.3.0 or later of the TM-DT series. For TM-T88VI) The printing flow is as follows: TM printers with SDP support Web Server 1 : HTTP Request (Print request) 2.2 : HTTP - Epson TM-T88VI-i | Users Manual - Server Direct Print - Page 10
Response Data When the Web server creates HTTP response (print request) data, the following points must be considered 00"> TM printers with SDP support TM-i series TM-DT series TM-T88VI/ TM-T88VI- iHUB All version All version All version TM-i firmware Ver.4.1 or later TM-DT software Ver.3.0 - Epson TM-T88VI-i | Users Manual - Server Direct Print - Page 11
with an empty response to the TM printers with SDP support. 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. 1 TM printers with SDP support Web Server 1 : HTTP Request (Status - Epson TM-T88VI-i | Users Manual - Server Direct Print - Page 12
below. TM printers with SDP support TM-L90-i TM-T20II-i TM-T70-i TM-i series TM-T82II-i TM-T83II-i TM-T88V-i TM-U220-i TM-H6000IV-DT TM-DT series TM-T70II-DT TM-T88V-DT TM-T88VI TM-T88VI-iHUB Software TM-i firmware Ver.3.0 or later TM-i firmware Ver.4.3 or later TM-i firmware Ver - Epson TM-T88VI-i | Users Manual - Server Direct Print - Page 13
the Web server How to access Proxy server Proxy authentication Digest authentication HTTPS communication HTTPS communication with server authentication TLS 1.2 support *: SSL3.0 is not support. TM-i series TM-DT series TM-T88VI/ TM-T88VI-iHUB TM-i firmware Ver.4.0 or later TM-DT software Ver - Epson TM-T88VI-i | Users Manual - Server Direct Print - Page 14
T88V-DT, TM-T88V-i TM-T88VI, TM-T88VI-iHUB TM-L90-i TM-T70-i TM-U220-i For the utility to register the NV logo to a printer other than the TM printers with SDP support, refer to the Technical Reference Guide for each printer. Download For customers in North America, go to the following web - Epson TM-T88VI-i | Users Manual - Server Direct Print - Page 15
and TM-T88VI-iHUB 2 MB TM-i series/ TM-DT series These values depend on the TM-i firmware or TM-DT software version, and on the printing speed of the printer. For details regarding the printing speed of the printer, refer to the Technical Reference Guide for each TM printer. TM-i series TM-DT - Epson TM-T88VI-i | Users Manual - Server Direct Print - Page 16
16 - Epson TM-T88VI-i | Users Manual - Server Direct Print - Page 17
Internet Information Services). When using other environment, interpret the descriptions accordingly. Overview Use the sample program screen to enter orders. The Web server sends a response containing print data for a request sent from the TM printers with SDP support. The TM printers with SDP - Epson TM-T88VI-i | Users Manual - Server Direct Print - Page 18
Version 2.00 Supported printers are below. • TM-i series TM-i firmware Ver.4.1 or later • TM-DT series TM-DT software ver.3.0 or later • TM-T88VI • TM-T88VI-iHUB 18 - Epson TM-T88VI-i | Users Manual - Server Direct Print - Page 19
Version 3.00 Supported printers are below. • TM-T88VI • TM-T88VI-iHUB Chapter 2 Sample Program 2 19 - Epson TM-T88VI-i | Users Manual - Server Direct Print - Page 20
Ver.1.00 or Ver.2.00) The system configuration of the sample program is as shown below. Web Server [192.168.192.10] TM printers with SDP support [192.168.192.20] Router [192.168.192.1] TM Printer [192.168.192.21] ❏ Web Server (Its operation has already been checked using IIS and XAMPP.) ❏ Router - Epson TM-T88VI-i | Users Manual - Server Direct Print - Page 21
.168.192.10] Chapter 2 Sample Program TM printers with SDP support [192.168.192.20] Customer Display 2 Router [192.168.192.1] ❏ Web Server (Its operation has already been checked using IIS and XAMPP.) ❏ Router ❏ TM printers with SDP support (TM-T88VI) ❏ Customer Display File Configuration File - Epson TM-T88VI-i | Users Manual - Server Direct Print - Page 22
program is as shown below. 1. Start the browser. 2. Enter the order. 3. Receive a request from the printer. 4. Responses print data (sample.xml) to the printer. 5. Output the printing result sent from the printer to resultPrint.log after printing. 6. Display the printing result on the screen. 22 - Epson TM-T88VI-i | Users Manual - Server Direct Print - Page 23
settings such as IP address to the TM printer to be connected. Configure the network settings such as IP address to the printer by using EPSON TMNet WebConfig from a Web browser on the setup computer. For the configuration procedure, refer to the Technical Reference Guide for each TM printer. 23 - Epson TM-T88VI-i | Users Manual - Server Direct Print - Page 24
the TM Printers (Device ID, IP Address) ❏ TM-DT series (p. 30) IP Address Setting Initial OS Settings Initializing the ePOS-Device Service Startup Settings Server Direct Print Setting Register the TM Printers (Device ID, IP Address) ❏ TM-T88VI, TM-T88VI-iHUB (p. 33) IP Address Setting - Epson TM-T88VI-i | Users Manual - Server Direct Print - Page 25
Chapter 2 Sample Program Sample Program Configuration Save the sample program files to the Web server. Save the files directly under the following folders: Environment IIS Folder inetpub ) For details about how to create a zip file, refer to the Technical Reference Guide for each printer. 2 25 - Epson TM-T88VI-i | Users Manual - Server Direct Print - Page 26
with SDP support Settings ❏ TM-i series (p. 26) ❏ TM-DT series (p. 30) ❏ TM-T88VI, TM-T88VI-iHUB (p. 33) TM-i Series Settings ❏ IP Address Setting ❏ Server Direct Print Setting : Refer to the Technical Reference Guide for each printer. : p. 26 Server authentication setting (TM-i Firmware Ver - Epson TM-T88VI-i | Users Manual - Server Direct Print - Page 27
access cannot be authenticated for user IDs without passwords. To authenticate the Digest access, configure a password that is not empty. Not required for the sample program. Specify the Test_print.php address of the Web server. Example: http:///Test_print.php Click the - Epson TM-T88VI-i | Users Manual - Server Direct Print - Page 28
The Digest access cannot be authenticated for user IDs without passwords. To authenticate the Digest access, configure a password that is not empty. Not required for the sample program. Enable Proxy for following services Automatic Update Direct Print Status Notification Sets whether the - Epson TM-T88VI-i | Users Manual - Server Direct Print - Page 29
Registration of TM Printer Register the device ID and IP address of the controlled TM printer to TM-i series. 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. 1 Connect all TM printers to the - Epson TM-T88VI-i | Users Manual - Server Direct Print - Page 30
. EPSON TMNet WebConfig starts. If you are making settings from an external device, set the TM-DT series IP address in the address for the Web browser. The default IP address for TM-DT series is 192.168.192.168. http:///webconfig/ 2 Select as [Settings]-[Web service - Epson TM-T88VI-i | Users Manual - Server Direct Print - Page 31
]-[Web service settings]-[Direct print]. 2 The "Server direct print" screen appears. Set the following items and click [OK]. For TM-DT Software Ver.3.0 or later: Item ID Password Server1 Interval (sec.) Server Authentication Description Set ID for the server-side program to identify TM-DT series - Epson TM-T88VI-i | Users Manual - Server Direct Print - Page 32
Connect all TM printers to the network and power on. 2 EPSON TMNet WebConfig starts. Select [Settings]-[Web service settings]-[Device Admin]-[Device registration]-[Printer]. 3 The "Printer" screen appears. Set the following items and click [Add]. Item Device ID Model no. IP address Retry interval - Epson TM-T88VI-i | Users Manual - Server Direct Print - Page 33
Program TM-T88VI and TM-T88VI-iHUB Settings Configure the following settings to TM-T88VI. ❏ IP Address Settings : Refer to the Technical Reference Guide. ❏ Server Direct Print Settings : p. 33 Server authentication setting Proxy server setting ❏ Registration of TM Printer : p. 35 - Epson TM-T88VI-i | Users Manual - Server Direct Print - Page 34
When using the proxy server, click the [TM-Intelligent] - [Server Access] - [Proxy user ID used for Digest authentication. Enter the authentication password. This password will be the password used for Digest authentication. Port Enter the proxy server port number. Service to Enable a Proxy Web - Epson TM-T88VI-i | Users Manual - Server Direct Print - Page 35
of TM Printer Register the device ID and the IP address of the TM printer to be controlled. Use the following procedure for registration. 1 Connect the Customer Display to the TM printers with SDP support. 2 Connect all TM printers to the network and power on. 3 Starting the TM-T88VI Utility. Click - Epson TM-T88VI-i | Users Manual - Server Direct Print - Page 36
Direct Print function is enabled for TM printers with SDP support. 2 Open the sample program page from the Web browser. Example: http:///demo/index.html 3 Click [Order Entry]. 4 In response to a request from the TM printers with SDP support, print data is sent and - Epson TM-T88VI-i | Users Manual - Server Direct Print - Page 37
and Response This chapter describes requests from the TM printers with SDP support 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. It can also check if printing is properly - Epson TM-T88VI-i | Users Manual - Server Direct Print - Page 38
request) This section describes the response (print request) containing the print data from the Web server. TM printers with SDP support 1 : HTTP Request (Print request) 2.2 : HTTP Response (Print request) Web Server 2.1 : Create XML from a database or other system Response data created in XML - Epson TM-T88VI-i | Users Manual - Server Direct Print - Page 39
10000 . . . Note: Enclosing the tag in the tags enables sending multiple print requests to the printer. 39 - Epson TM-T88VI-i | Users Manual - Server Direct Print - Page 40
Supported printers are below. • TM-i series TM-i firmware Ver.4.1 or later • TM-DT series TM-DT software ver.3.0 or later • TM-T88VI • TM-T88VI-iHUB Specify the print job ID with the tag in the tab. Create the tag for each - Epson TM-T88VI-i | Users Manual - Server Direct Print - Page 41
Chapter 3 Request and Response Supported printers are below. • TM-T88VI • TM-T88VI-iHUB Printing to the printer and control of customer display can be performed. ❏ tag: Printer control ❏ tag: Customer display control The /< - Epson TM-T88VI-i | Users Manual - Server Direct Print - Page 42
Supported printers are below. • TM-i series TM-i firmware Ver.4.1 or later • TM-DT series TM-DT software ver.3.0 or later • TM-T88VI • TM-T88VI-iHUB • TM-T88VI • TM-T88VI-iHUB see ePOS-Print XML User's Manual. Tag The - Epson TM-T88VI-i | Users Manual - Server Direct Print - Page 43
utf-8" ?> local_printer 10000 - Epson TM-T88VI-i | Users Manual - Server Direct Print - Page 44
00"> local_printer 10000 ABC123 - Epson TM-T88VI-i | Users Manual - Server Direct Print - Page 45
local_printer 10000 ABC123 - Epson TM-T88VI-i | Users Manual - Server Direct Print - Page 46
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 printers with SDP support. See Test_print.php of the sample program. HTTP/1.1 200 OK Content-Type: text/xml; charset=utf-8 Content-Length: 0 46 - Epson TM-T88VI-i | Users Manual - Server Direct Print - Page 47
Chapter 3 Request and Response Request (Printing Result) A TM printer with SDP support sends a HTTP POST request (printing result) shown below after printing. A TM printers with SDP support Web Server 1 : HTTP Request (Print request) 2.2 : HTTP Response (Print request) 2.1 : Create XML from a - Epson TM-T88VI-i | Users Manual - Server Direct Print - Page 48
by the TM printers SDP support are different depending on the version contained in the response (print request) from the Web server. < utf-8"?> #Success - Epson TM-T88VI-i | Users Manual - Server Direct Print - Page 49
Chapter 3 Request and Response The printer confirms the data when it receives an HTTP response (print tag tag - Epson TM-T88VI-i | Users Manual - Server Direct Print - Page 50
the code element and the status element, refer to the ePOS-Print XML User's Manual. true false Item Description Success Failed On failure, an error code is described failure - Epson TM-T88VI-i | Users Manual - Server Direct Print - Page 51
ABC123 - Epson TM-T88VI-i | Users Manual - Server Direct Print - Page 52
The device power is off. The device is not connected. Other device control software exists on the system. The process was not completed within a certain period of time . Inaccessible due to a problem in the operation status in the TM printers with SDP support. Error occurs in - Epson TM-T88VI-i | Users Manual - Server Direct Print - Page 53
obtained from the server is incorrect, an error notification is sent to the server with SetResponse. Supported printers are below. • TM-T88VI • TM-T88VI-iHUB Error Description Details of ResponseFile in SetResponse The XML obtained with GetRequest exceeds 2MB. - Epson TM-T88VI-i | Users Manual - Server Direct Print - Page 54
server sends a response (print result) upon receipt of print result to the TM printers with SDP support. TM Printers with SDP support Web Server 1 : HTTP Request (Print request) 2.2 : HTTP Response (Print request) 2.1 : Create XML from a database or other system 3 : Create print data 4 : Print - Epson TM-T88VI-i | Users Manual - Server Direct Print - Page 55
requires settings for the TM printers with SDP support and the server. TM Printers with SDP Support Set the user ID and password necessary for Digest authentication in the TM printers with SDP support. For details, see "TM printers with SDP support Settings" (p.26). Web Server Settings For detailed - Epson TM-T88VI-i | Users Manual - Server Direct Print - Page 56
Program Example See the following programming data (file name: Test_print.php) - Epson TM-T88VI-i | Users Manual - Server Direct Print - Page 57
TM printers with SDP support status to the Web server. The Web server automatically responds with an empty response. 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. TM printers - Epson TM-T88VI-i | Users Manual - Server Direct Print - Page 58
http:///webconfig/ For TM-i Firmware Ver.3.x or earlier http:///PrinterConfigurationPage/ 3 EPSON TMNet WebConfig starts. For TM-i Firmware Ver.4.0 or later, select [Web Service Settings] - [Status Notification]. For TM-i Firmware Ver - Epson TM-T88VI-i | Users Manual - Server Direct Print - Page 59
cannot be authenticated for user IDs without passwords. To authenticate the Digest access, configure a password that is not empty. Not required for the sample program. Specify the Test_print.php address of the Web server. URL Example: http:///Test_status.php Click - Epson TM-T88VI-i | Users Manual - Server Direct Print - Page 60
IP address of the TM-DT series>/webconfig/ 3 EPSON TMNet WebConfig starts. Select [Settings]-[Web service settings]-[Server access]-[Status notification]. 4 The "Status Notification" screen appears. Set the following items and click [Apply]. For TM-DT Software Ver.3.0 or later Item ID Password - Epson TM-T88VI-i | Users Manual - Server Direct Print - Page 61
Chapter 4 Status Notification For TM-DT Software Ver.2.6 or earlier Item ID Password URL Interval (sec) Description Set ID for the server-side program to identify TM-DT series. This ID becomes the user ID used for Digest access authentication. The set value will also be passed as an ID parameter - Epson TM-T88VI-i | Users Manual - Server Direct Print - Page 62
Web server URL and the application path. Example: http:///Test_print.php ID Enter the ID. This ID will be the user ID used for Digest authentication. Password Set your password instructions regarding the certificate registration, refer to TM-T88VI Utility User's Manual. - Epson TM-T88VI-i | Users Manual - Server Direct Print - Page 63
ID. This ID will be the user ID used for Digest authentication. Enter the authentication password. This password will be the password used for Digest authentication. Port Enter the proxy server port number. Service to Enable a Proxy Web Contents Automatic Update Server Direct Print Set - Epson TM-T88VI-i | Users Manual - Server Direct Print - Page 64
that Status Notification of a TM printer with SDP support is set. 2 Open the sample program page from the Web browser. Example: http:///demo/indexStatus.html 3 The "resultPrint.log" is created from the message from the TM printers SDP support and the result is displayed - Epson TM-T88VI-i | Users Manual - Server Direct Print - Page 65
Status Notification Status Type The following types of ASB (AutoStatusBack) status can be obtained from the TM printers with SDP support. Code 0x00000004 0x00000008 0x00000020 0x00000040 0x00000100 0x00000200 0x00000400 0x00000800 0x00002000 0x00004000 0x00020000 0x00080000 0x01000000 0x04000000 - Epson TM-T88VI-i | Users Manual - Server Direct Print - Page 66
-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); foreach ($xml->printerstatus as $printerstatus) { $asb - Epson TM-T88VI-i | Users Manual - Server Direct Print - Page 67
model only) \n"; } if (($asb & 0x04000000) == 0x04000000) { $strmsg .= " No paper in label peeling sensor (supported model only) \n"; } $result = fprintf($fhandle, "Printer name = %s : Status ASB value is %s \n", $printerstatus['devicename'], $asb); $result = fprintf($fhandle, "%s\n", $strmsg); if - Epson TM-T88VI-i | Users Manual - Server Direct Print - Page 68
= "0x00000001"/> Battery Status With TM-T88VI and TM-T88VI-iHUB, a battery status notification is sent for the controlled mobile printer. Code 0x30XX 0x31XX 0xXX36 0xXX35 0xXX34 0xXX33 0xXX32 0xXX31 0xXX30 - Epson TM-T88VI-i | Users Manual - Server Direct Print - Page 69
TM-T88VI and TM-T88VI-iHUB, a notification can be sent for errors that occur when the server is accessed. Code Description %Function% Server Direct Print Server Direct Print Web Contents Updater Web Contents Updater Network Network Status Notification Status Notification %Code% Service - Epson TM-T88VI-i | Users Manual - Server Direct Print - Page 70
and ServerCrt.crt in the sslservercerts folder in the web contents Unable to update the web contents because the PHP application is running on the printer Elements other than the wireless dongle have been installed When %Function%=Network The wireless dongle has been removed When %Function%=Network - Epson TM-T88VI-i | Users Manual - Server Direct Print - Page 71
Status Notification Response The format of response message is XML(text/xml). To indicate that the server received the status notification, the Web server returns a response as follows: HTTP/1.1 200 OK Content-Type: text/xml; charset=utf-8 Content-Length: 0 Digest Access Authentication Digest access - Epson TM-T88VI-i | Users Manual - Server Direct Print - Page 72
72
Server Direct Print
User’s Manual
M00062910
Rev.K
Overview
Sample Program
Request and Response
Status Notification
Describes the operating environment and system
configuration of Server Direct Print.
Describes how to use the sample program and how to
configure the system.
Describes the requests and responses of Server Direct
Print.
Describes the Status Notification function.