Epson TM-i Series User guide

PHP Setup Manual
TM-i Series
M00051906
Rev.G
Overview
Setup
Sample Program
Describes features and the development environment.
Describes settings required for using PHP with a TM-i.
Describes how to use the sample program and perform
system configuration.

Cautions
• No part of this document may be reproduced, stored in a retrieval system, or transmitted in any form or
by any means, electronic, mechanical, photocopying, recording, or otherwise, without the prior written
permission of Seiko Epson Corporation.
• The contents of this document are subject to change without notice. Please contact us for the latest
information.
• While every precaution has taken in the preparation of this document, Seiko Epson Corporation assumes
no responsibility for errors or omissions.
• 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
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 designated as Original EPSON Products or EPSON
Approved Products by Seiko Epson Corporation.
Trademarks
EPSON and EXCEED YOUR VISION are registered trademarks of Seiko Epson Corporation in Japan and other
countries/regions.
Windowsis either registered trademarks or trademarks of Microsoft Corporation in the United States and
other countries.
microSD is registered trademarks of SD Card Association.
All other trademarks are the property of their respective owners and used for identification purpose only.
© Seiko Epson Corporation 2012-2014. All rights reserved.

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.
Restriction of Use
Whenthisproductisusedforapplicationsrequiringhighreliability/safetysuchastransportation
devicesrelatedtoaviation,rail,marine,automotiveetc.;disasterpreventiondevices;varioussafety
devicesetc;orfunctional/precisiondevicesetc,youshouldusethisproductonlyaftergiving
considerationtoincludingfail‐safesandredundanciesintoyourdesigntomaintainsafetyandtotal
systemreliability.Becausethisproductwasnotintendedforuseinapplicationsrequiringextremely
highreliability/safetysuchasaerospaceequipment,maincommunicationequipment,nuclearpower
controlequipment,ormedicalequipmentrelatedtodirectmedicalcareetc,pleasemakeyourown
judgmentonthisproduct’ssuitabilityafterafullevaluation.
Provides information that must be observed to avoid damage to your equipment or a
malfunction.
Provides important information and useful tips.

4
About this Manual
Aim of the Manual
The aim of this manual is to provide development engineers with the necessary information to
develop and design a system that registers and uses contents created using PHP (PHP: Hypertext
Preprocessor) in the TM-i series.
The TM-i series in this manual is a generic term for the following printers.
Manual Content
Themanualismadeupofthefollowingsections:
TM-T88V-i TM-T70-i TM-20II-i TM-T82II-i
TM-T83II-i TM-L90-i
Chapter 1 Overview
Chapter 2 Setup
Chapter 3 Sample Program

5
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
■PHP Operations..................................................................................................................... 8
■Operating Environment ....................................................................................................... 9
Supported Languages .......................................................................................................................... 9
Embedded Database........................................................................................................................... 9
TM-i........................................................................................................................................................... 9
microSD card.......................................................................................................................................... 9
■PHP Operating Specifications ........................................................................................... 10
Restrictions ............................................................................................................................................ 10
■Contents in the Package................................................................................................... 12
Download ............................................................................................................................................. 12
Setup .............................................................................................13
■Setup Flow........................................................................................................................... 13
Insert microSD Card............................................................................................................................. 13
Enable PHP ........................................................................................................................................... 14
Registering Web Contents .................................................................................................................. 14
■Setup without using EPSON TMNet WebConfig................................................................ 14

6
Sample Program..........................................................................15
■Sample Program System Overview.................................................................................. 15
Sample Program Screen......................................................................................................................15
Print Image ............................................................................................................................................16
Sample Program File Configuration....................................................................................................17
Program Flow ........................................................................................................................................18
■Operating Environment ..................................................................................................... 19
■Environment Settings.......................................................................................................... 20
Registering and Starting the Sample program (PHP_UM_E_Sample_Verx.xx.zip) .........................21
Sample Program Settings.....................................................................................................................22

7
Chapter 1 Overview
1
Overview
TM-i series can only register static contents (such as HTML files, CSS files, JavaScript or screen data). However,
by inserting a microSD card into a TM-i and enabling PHP, you can register contents created using PHP.
Use of contents created with PHP allows you to perform the following:
❏Create dynamic Web pages
❏Manage user data using file and database operations
UseamicroSDcardwithwearlevelingfunctionality.
DonotuseyourownapplicationtowritetothemicroSDcard.
DonotturnoffthepowerwhenwritingtothemicroSDcardvia[WebContentUpdate]in
EPSONTMNetWebConfig.
PHPcannotbeusedif[Spooler]‐[WebServiceSettings]inEPSONTMNetWebConfigʹsis
enabled.BesuretosetʺDisableʺforthisitem(intheinitialsettings).

8
PHP Operations
PHP operates on a Web Server as shown below.
1A request is sent to the HTTP Server of the TM-i.
Example: http://192.168.192.168/index.php
2The PHP module in the HTTP Server interprets the script language in the file,
dynamically generates HTML, and performs data processing.
3A response is returned to the device (client). Print data is included in the response.
4Print data is sent from the device to the TM-i.
5The TM-i prints the print data.
TM-i
Device
microSD card
Http Server
(Apache)
ePOS-Device
Service
1. Request
http://-----/index.php
3. Response
(HTML/JavaScript etc)
2. Data processing
Database
PHP module (SQLite3)
Web Browser
Web page
(HTML, CSS, JavaScript)
4. Print data
5. Print
HTML file
PHP script file
Database file
Application
information file
ePOS-Device SDK
for JavaScript

9
Chapter 1 Overview
1
Operating Environment
Supported Languages
❏PHP 5.3.5
Embedded Database
❏SQLite3
TM-i
❏TM-T88V-i
❏TM-T70-i
❏TM-T20II-i
❏TM-T82II-i
❏TM-T83II-i
❏TM-L90-i
microSD card
Supported microSD card standards.
❏FAT 16/32 format is supported.
❏2 to 32 GB capacity is supported.
For PHP, use TM-i firmware Ver. 2.0 or later.
microSD card Support
SD Support
SDHC Support
SDXC Not Support
UseamicroSDcardwithwearlevelingfunctionality.
EpsonrecommendsusingamicroSDcardhavinganerrordetectionandcorrection(ECC),
andwear‐levelingfunctions.
Besuretousethededicatedformattingtool(SDFormatter)toformatamicroSDcard.Ifa
microSDcardisformattedwithWindows,SDcardaccessmaybecomeslow.
YoucandownloadtheSDFormatterfromtheSDAssociationʹswebsite
(https://www.sdcard.org/home).

10
PHP Operating Specifications
PHP operating specifications are defined by Apache and PHP setting files.
Setting information of the TM-i is saved on a ROM and cannot be changed.
Restrictions
The TM-i is subject to some restrictions for security reasons.
Use the following procedure to check details regarding PHP restrictions.
1Save the following PHP script with a file name such as "phpinfo.php".
<?php phpinfo(); ?>
2Compress the file you created together with the other web content files into a
single ZIP folder.
3Register the file(s) in the TM-i series device.
For details about how to compress and register web content files, refer to Chapter 2 "Setup" in the
manual for the TM-i device you are using.
4You can display the restrictions screen by viewing the URL where you placed the
script file.
Example: If you placed the file phpinfo.php in the root folder for the web content, the URL is as shown
below.
http://<TM-i_IP_address>/webapp/phpinfo.php
The main restrictions are as shown below.
❏The following PHP functions cannot be used.
Functions
openlog
apache_child_terminate
apache_get_modules
apache_get_version
apache_getenv
apache_note
apache_setenv
virtual
eval
exec
passthru
popen
preg_replace
proc_open
shell_exec
system

11
Chapter 1 Overview
1
❏If using PHP date-related functions, specify the time zone by using date_default_timezone_set at the
beginning of PHP script. For details, refer to the PHP public Website. Do not use Etc/GMT time zones.
❏The dynamic load (dl function) of the PHP expansion module is disabled.
❏File uploading using PHP is disabled.
❏The fopen wrapper for URLs read by an external file cannot be used.
❏PHP values defined by .htaccess files cannot be changed.
❏This system does not support PHP Data Object (PDO) as a method for connecting to SQLite.
❏The maximum PHP script execution time is 30 seconds. When more than 30 seconds pass, the PHP script
will be forcibly terminated and return "500 Internal Server Error" as HTTP response.
Writing to microSD card
Some PHP functions and class methods write to microSD card.
If you use the following functions and class methods, develop your application so that they do not write to
microSD card.
Functions, Class methods
openssl_pkey_export_to_file SQLite3::querySingle
openssl_x509_export_to_file SimpleXMLElement::asXML
openssl_pkcs12_export_to_file SimpleXMLElement::saveXML
openssl_csr_export_to_file Phar::convertToData
openssl_pkcs7_sign Phar::unlinkArchive
openssl_pkcs7_encrypt PharData::addEmptyDir
gzwrite PharData::addFile
gzputs PharData::addFromString
session_save_path PharData::buildFromDirectory
unlink PharData::buildFromIterator
rmdir PharData::compress
ftruncate PharData::decompress
fwrite PharData::convertToData
fputs PharData::copy
mkdir PharData::delete
rename PharData::extractTo
copy PharData::offsetSet
tempnam PharData::offsetUnset
file_put_contents PharData::unlinkArchive
stream_context_create PharFileInfo::chmod
fputcsv PharFileInfo::compress
chmod PharFileInfo::decompress
touch PharFileInfo::delMetadata
xmlwriter_open_uri PharFileInfo::setMetadata
SQLite3::exec XMLWriter::openUri
SQLite3::query

12
Contents in the Package
Manual
❏TM-i Series PHP Setup Manual (This Document)
❏TM-T88V-i Technical Reference Guide
❏TM-T70-i Technical Reference Guide
❏TM-T20II-i Technical Reference Guide
❏TM-T82II-i Technical Reference Guide
❏TM-T83II-i Technical Reference Guide
❏TM-L90-i Technical Reference Guide
❏TM-i Series WebConfig API User's Manual
Software Developer's Kit
❏ePOS-Device SDK for JavaScript *
❏ePOS-Device XML *
❏ePOS-Print XML
*: TM-i Firmware Ver.4.0 or later
Sample Program
PHP_UM_E_Sample_Verx.xx.zip
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

13
Chapter 2 Setup
2
Setup
This chapter describes the settings necessary to use PHP with the TM-i.
Setup Flow
Insert microSD Card
Insert a microSD card to the TM-i. Remove the rubber cover from the back of the TM-i and insert a microSD
card.
AlwaysbesuretoturnoffthepoweroftheTM‐iwheninsertingamicroSDcard.
1. Insert microSD Card
Insert a microSD card to the TM-i.
2. Enable PHP
Set the TM-i so that PHP can be used.
3. Registering Web Contents
Register the web content in TM-i.
microSDcardslot
microSDcardslot
For TM-T88V-i / TM-T70-i / TM-L90-i
For TM-T20II-i / TM-T82II-i / TM-T83II-i

14
Enable PHP
To use PHP on this product, enable PHP using EPSON TMNet WebConfig. This section briefly explains the
setup procedure.
For the detailed procedure, see Chapter 2 [Setup] in the Technical Reference Guide for the TM-i used.
1. Connecting TM-i to Network
Connect the TM-i, with the micro SD card inserted in it, to the same network as the setting computer, and
turn its power on.
2. Start EPSON TMNet WebConfig
Access the address bar of the Web browser on the PC for setting to start EPSON TMNet WebConfig.
TM-i Firmware Ver.4.0 or later
http://TM-i's IP address/webconfig/PHPSetting
TM-i Firmware Ver.3.x or earlier
http://TM-i's IP address/PHPSetting
3. PHP Settings
Select [Enable] from "PHP". After setting, click [Apply] at the bottom of the screen. Then the settings are
written to the product.
If [Apply] is not clicked, the settings are not applied.
Registering Web Contents
For the method for registering web contents, see Chapter 2 [Setup] in the Technical Reference Guide for
the TM-i used.
Setup without using EPSON TMNet WebConfig
You can alternatively do the setup without using EPSON TMNet WebConfig.
For the method for doing the setup from an application using the WebConfig API, see "TM-i Series
WebConfig API User's Manual".
For the method for doing the setup using Easy Setup, see "TM-i Series Easy Setup Guide".

15
Chapter 3 Sample Program
3
Sample Program
This chapter describes how to use the sample program.
Sample Program System Overview
Sample Program Screen
Product name, price, discount, and other settings are saved to the SQLite database. This information is then
obtained from the database with a PHP program. Products, prices, and total price can be printed using the
ePOS-Print API.
Item Description
1 Product list
Displays a list of products.
If you select a product, the product name is added to
the purchase list on the left side.
2 Purchase list
Products selected from the product list are added to
the purchase list.
The product name, price, and total are displayed.
3 Delete line The product at the bottom of the purchase list is
deleted.
4 Delete all All products in the purchase list are deleted.
5 Enter A receipt is printed.
34
2
1
5
6

16
Print Image
The sample program prints the following:
6 Settings
Displays the "Settings" screen. The screen is used to set
the following:
IP address of the TM-i
(Default :
192.168.192.168(Up to the firmware Ver.2.x.)
DHCP(Firmware Ver.3.0 or later)
(If an address fails to be assigned via DHCP, the
value becomes "192.168.192.168".)
)
Device ID of the target printer
(Default : local_printer)
Print timeout( milliseconds )
(Default : 10000)
Item Description
Sample Shop
Thank you for shopping
Jul-09-2014 17:59:59
Cream puff
Cheese cake
Eclair
Cinnamon roll
Dobosh torte
$1.10
$3.45
$2.00
$3.00
$3.10
Amount $12.65
5 items 0003

17
Chapter 3 Sample Program
3
Sample Program File Configuration
The sample program has the following file configuration.
File name Description
css Stores the style sheet for the main screen.
js Stores the JavaScript used for the main screen.
index.html The main screen of a Web page.
This screen is displayed from the TM-i via a browser.
JavaScript is used for processing related to operations such as button clicking.
The PHP file saved in the HTTP Server of the TM-i is called out from this file.
phpsample.sqlite3 SQLite 3 database file that stores product information.
itemLookup.php PHP file that acquires a menu list from the database and respond.
priceLookup.php PHP file that acquires product names and price information from the database
and respond.

18
Program Flow
From its initial display state up to print job completion, the sample program flows as below.
4. Request issued
Requests product information as a parameter for the ID of the menu that was clicked.
5. Sending of response data
Acquires product names and prices for the ID with priceLookup.php. Then, adds the
data acquired from the response to the list.
3. Click a product in the product list.
2. Settings
❏IP address of the TM-i
❏Device ID of the printer to be controlled
1. Open the sample program Web page
Action on the sample program
Action on the customer
7. Prints (ePOS-Print Object)
6. Click [Enter]

19
Chapter 3 Sample Program
3
Operating Environment
The system configuration diagram for the sample programs is as below.
❏Computer to configure the settings
❏Wireless LAN Router
❏TM-i (1 set)
TM-T88V-i/ TM-T70-i/TM-L90-i/TM-T20II-i/TM-T82II-i/TM-T83II-i
❏Terminal
Terminal with an HTML5-supported Web browser
The figure below also describes an example of IP address settings as network settings.
Computer to configure the settings
[192.168.192.10]
Terminal
[192.168.192.XXX]*
Wireless LAN Router
[192.168.192.1]
TM-i
[192.168.192.20]
Wireless
Network
*:When DHCP is used for the terminal

20
Environment Settings
A flow for configuring the environment settings for the sample program is shown as follows:
5. Device ID Settings
Set the device ID of the printer to be controlled by ePOS-Print on the TM-i.
Set the device ID using EPSON TMNet WebConfig.
For the setting method, see Chapter 2 [Setup] in the Technical Reference Guide for the TM-i
used.
With this sample program, "Device ID Settings" is not required. Reference as necessary.
1. Router Settings
Configure the settings such as SSID, IP address, DHCP, and allocated IP address. For
details, refer to the manual for the device you are using.
3. Network Settings for the TM-i
Configure the network settings of the TM-i.
Set the IP address and other network settings on the printer using EPSON TMNet WebConfig. 
For the setting method, see Chapter 2 [Setup] in the Technical Reference Guide for the TM-i used.
2. Enable PHP
Refer to Chapter 2 to setup the TM-i.
4. Terminal settings
Configure the wireless LAN (Wi-Fi) settings of the terminal to match the router settings so as to
enable network connection. For details, refer to the manual for the device you are using.
7. Sample Program Setup
Configuration is done from a Web browser. These settings are not required in this sample
program. (Sample Program Settings (p.22))
6. Sample Program Registration
Register the sample program in the TM-i.
(Registering and Starting the Sample program (PHP_UM_E_Sample_Verx.xx.zip) (p.21))