Epson UB-E04 User manual

Product Overview
This chapter explains features.
Set up
This chapter explains how to connect the
UB-E04 to the TM printer and use it.
Application Development
Information
This chapter explains necessary information
when you develop applications.
Programming Samples
This chapter explains information for
programming.
Product Specifications
This chapter explains product specifications.
Appendix
This chapter explains network parameters
and a comparison of the UB-E03 and UB-E04.
M00091201
Rev.B
Technical Reference Guide

2
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, EXCEED YOUR VISION, and ESC/POS are registered trademarks of Seiko Epson Corporation.
Wi-Fi®, WPA™ and WPA2™ are either registered trademarks or trademarks of Wi-Fi Alliance®.
IOS is a trademark or registered trademark of Cisco in the U.S. and other countries and is used under license.
Android is a trademark of Google, Inc.
Microsoft® and Windows® are registered trademarks of Microsoft Corporation in the United States, Japan,
and other countries.
All other product names and company names are the trademarks or registered trademarks of their
respective owners.
ESC/POS® Command System
Epson ESC/POS is a proprietary POS printer command system that includes patented or patent-pending
commands. ESC/POS is compatible with most Epson POS printers and displays.
ESC/POS is designed to reduce the processing load on the host computer in POS environments.
It comprises a set of highly functional and efficient commands and also offers the flexibility to easily make
future upgrades.

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.
WARNING
You must follow warnings carefully to avoid serious bodily injury.
CAUTION
Provides information that must be observed to prevent damage to the equipment or
loss of data.
•Possibility of sustaining physical injuries.
•Possibility of causing physical damage.
•Possibility of causing information loss.
Provides information that must be observed to avoid damage to your equipment or a
malfunction.
Provides important information and useful tips.

4
Warnings
WARNING
•To avoid risk of electric shock, do not set up this product or handle cables during a
thunderstorm.
•Never insert or disconnect the power plug with wet hands.
Doing so may result in severe shock.
•Handle the power cable with care.
Improper handling may lead to fire or electric shock.
∗Do not modify or attempt to repair the cable.
∗Do not place any heavy object on top of the cable.
∗Avoid excessive bending, twisting, and pulling.
∗Do not place the cable near heating equipment.
∗Check that the plug is clean before plugging it in.
∗Be sure to push the plug all the way in.
•Be sure to use the specified power source.
Connection to an improper power source may cause fire or shock.
•Do not place multiple loads on the power outlet.
Overloading the outlet may lead to fire.
•Shut down your equipment immediately if it produces smoke, a strange odor, or
unusual noise.
Continued use may lead to fire. Immediately unplug the equipment and contact
your dealer or a Seiko Epson service center for advice.
•Never attempt to repair this product yourself. Improper repair work can be
dangerous
•Never disassemble or modify this product.
Tampering with this product may result in injury or fire.
•Do not allow foreign matter to fall into the equipment.
Penetration by foreign objects may lead to fire.
•If water or other liquid spills into this equipment, do not continue to use it. Unplug
the power cord immediately and contact your dealer or a Seiko Epson service
center for advice.
Continued use may lead to fire.
•Do not use aerosol sprayers containing flammable gas inside or around this
product.
The gas may stagnate and ignite, causing a fire.

5
Cautions
Product Servicing
This product cannot be serviced at the component level. In case of a fault, replace the UB-E04 itself.
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.
Wireless LAN Connection
With the UB-E04, you can connect an optional Wireless LAN unit to the USB Type-A connector to support
wireless LAN (IEEE802.11b/g/n).
Be aware of the following matters if using a wireless LAN connection.
Cautions for Use
•Connect the Wireless LAN unit to the USB Type-A connector before turning the printer on.
•Do not connect a device other than the Wireless LAN unit to the UB-E04's USB Type-A connector.
•If you connect a device other than the Wireless LAN unit to the UB-E04's USB Type-A connector, or if you
remove the Wireless LAN unit while the printer is operating, the printer will experience an unrecoverable
error. In that case, re-connect the Wireless LAN unit to the USB Type-A connector, and then turn on the
power again.
CAUTION
•Connecting an outdoor over head LAN cable directly to your product may lead to
lightning damage. If you need to connect such a cable to your product, the cable
must be protected against an electrical surge between the cable and your product.
You should avoid connecting your product to a non-surge protected outdoor
overhead LAN cable.
•Do not connect cables in ways other than those mentioned in this manual.
Doing so may cause product faults or a fire.
•Be sure to set this equipment on a firm, stable, horizontal surface.
The product may break or cause injury if it falls.
•Do not install the product in a location with excessive humidity or dust.
Excessive humidity and dust may cause equipment damage or fire.
•To ensure safety, unplug this product before leaving it unused for an extended
period.

6
•To prevent the Wireless LAN unit from being removed accidentally by some external force, be sure to
attach the connector cover to TM printers where a connector cover can be installed.
•Wireless LAN connections using the Wireless LAN unit have not been confirmed to operate with all
wireless LAN devices, and operation with all wireless LAN devices cannot be guaranteed. Thoroughly
research the specifications of the wireless LAN device you want to connect before using it.
•Wireless LAN operations may not be able to connect properly depending on the radio waves of the
surroundings. In particular, wireless LAN operations in ad hoc mode may not connect properly
depending on the combination of the device to be connected. Therefore, be sure to thoroughly check
and evaluate the device before using it.
•The UB-E04 cannot use wired LAN and wireless LAN at the same time. If using the wireless LAN, do so
without connecting a LAN cable.
Cautions about Interference
•Use the included USB extension cable to connect the UB-E04 and the Wireless LAN unit. If you insert the
Wireless LAN unit directly into the UB-E04, it will cause interference with other cables and negatively
affect transmissions.
•Perform adjustments so that the unit does not use the same channel as other wireless LAN devices
nearby.
•Keep the following points in mind when using the Wireless LAN unit in an environment with devices that
generate radio interference, such as a kitchen microwave.
Install the printer as far away from devices that generate radio interference as possible.
Use the USB extension cable included with the Wireless LAN unit, and install the Wireless LAN unit as
far away from devices that generate radio interference as possible.
Install a shielding plate between the printer and a device that generates radio interference.
When setting the auto-channel of the access point, be sure to set it so it does not generate radio
interference.
•If the Wireless LAN unit generates interference for other devices, such as your TV or radio, use the
following methods to remove the interference.
Install the product away from the TV or radio.
Connect this product to an outlet different from the outlet the TV or radio is connected to.
Cautions about Security
Important Cautions about Your Privacy Protection
A wireless LAN uses radio waves instead of a LAN cable to transmit information between the computer and
the wireless access point. Therefore, LAN connections can easily be made within the radio waves' range.
However, radio waves easily go beyond obstacles such as walls and can create security problems such as
the following.

7
Communication data can be received by stealth
A third party may intentionally intercept the radio waves to illicitly read your transmission information,
including the print data output to the printer, e-mail contents, and personal information such as passwords
and credit card numbers.
Illegal access
A third person can access the network and cause damage such as the following:
•Stealing of personal information and confidential information (Information leaks)
•Stealing the identity of a certain person to transmit illicit information (Identity theft)
•Replacing intercepted information and transmitting it (Falsification)
•Inserting a computer virus to destroy data or the system (Destruction)
Security Settings
The wireless LAN card and access point have a security settings function to deal with these problems. You
can reduce the possibility these problems will occur by performing security settings before use.
Security settings are performed immediately after purchase (Initial setting: WPA2-PSK).
Limitations
•You cannot stop the transmission of radio waves. If you need to stop the transmission of radio waves,
turn off the TM printer.
•The following limitations exist when using ad hoc mode.
The authentication type cannot be set to WPA2-PSK or WPA2-Enterprise.
When you print the status sheet, even if there is not a device to connect to nearby, the Link Status is
shown as Connect.
•The channels that can be set vary by country.
Even with security settings, there is a possibility the security can be breached using
particular methods.
We recommend that you have full understanding regarding security problems and
perform security settings at your own judgment and liability.

8
About this Manual
Aim of the Manual
This manual is aimed to provide all the necessary information for development engineers to develop,
design, and install POS system, or to develop and design printer applications.
Manual Content
The manual is made up of the following sections:
Chapter 1 Product Overview
Chapter 2 Set up
Chapter 3 Application Development Information
Chapter 4 Programming Samples
Chapter 5 Product Specifications
Chapter 6 Appendix

9
Contents
■For Safety..................................................................................................................3
Key to Symbols............................................................................................................................................................... 3
Warnings .......................................................................................................................................................................... 4
Cautions............................................................................................................................................................................ 5
■Product Servicing.....................................................................................................5
■Restriction of Use .....................................................................................................5
■Wireless LAN Connection ........................................................................................5
Cautions for Use............................................................................................................................................................. 5
Cautions about Interference ..................................................................................................................................... 6
Cautions about Security ............................................................................................................................................. 6
■About this Manual....................................................................................................8
Aim of the Manual ........................................................................................................................................................ 8
Manual Content............................................................................................................................................................. 8
■Contents....................................................................................................................9
Product Overview............................................................................. 11
■Features ................................................................................................................. 11
■Parts Name and Function ..................................................................................... 12
LAN connector .............................................................................................................................................................12
LED....................................................................................................................................................................................12
USB Type-A Connector (For connecting Wireless LAN unit)........................................................................13
Push button...................................................................................................................................................................13
Set up ................................................................................................ 15
■Set up methods ..................................................................................................... 15
■Flow of Setup......................................................................................................... 16
■Printing the status sheet (Check Settings).......................................................... 17
■Set up using EpsonNet Config ............................................................................. 18
■Set up using EpsonNet Config (Web version) ..................................................... 19
■Set up using arp/ping commands........................................................................ 21
■Initializing.............................................................................................................. 22
■EpsonNet Config (Web version) ........................................................................... 23
Information Menu.......................................................................................................................................................23
Configuration Menu...................................................................................................................................................24
■MAC Address Confirmation.................................................................................. 28

10
Application Development Information .......................................... 29
■Controlling the Printer ..........................................................................................29
ePOS-Print XML ........................................................................................................................................................... 29
■Software .................................................................................................................29
Development Kit......................................................................................................................................................... 29
Utilities............................................................................................................................................................................ 29
Others ............................................................................................................................................................................. 30
Downloads .................................................................................................................................................................... 30
Programming Samples .................................................................... 31
■Printing to a TM printer.........................................................................................31
■Direct printing by PORT9100................................................................................32
For Windows Console................................................................................................................................................ 32
For Linux ........................................................................................................................................................................ 33
■Monitoring of the ASB Status ...............................................................................34
■Multiple connection requests...............................................................................34
Product Specifications ..................................................................... 35
■Software Specifications.........................................................................................35
Supported Protocols ................................................................................................................................................. 35
Printing Protocols ....................................................................................................................................................... 35
Automatic IP Address Assignment Protocols ................................................................................................... 36
Protocol for acquiring status and setting .......................................................................................................... 36
HTTP/HTTPS ................................................................................................................................................................. 37
■System Bootup Time..............................................................................................38
■Supported TM Printers ..........................................................................................38
■Environmental Specifications...............................................................................38
■Limitations .............................................................................................................38
TM Printer Settings..................................................................................................................................................... 38
Communication .......................................................................................................................................................... 38
Customer Display Use ............................................................................................................................................... 39
■Open Source Software License .............................................................................39
Appendix........................................................................................... 41
■Ethernet and Wireless LAN Shared Settings and Browsable Items ...................41
■Ethernet Settings and Browsable Items...............................................................42
■Wireless LAN Settings and Browsable Items .......................................................42
■UB-E03 and UB-E04................................................................................................43

11
Chapter 1 Product Overview
1
Product Overview
This chapter describes the features of this product, as well as the parts name and function of each part.
Features
The UB-E04 is an Ethernet interface board for Epson TM printers.
The features of the UB-E04 are as follows:
Ethernet
•10Base-T, 100Base-TX Ethernet
•Full duplex/half-duplex (Supports auto negotiation)
•Supports Auto-MDIX
Wireless LAN
•You can connect an optional Wireless LAN unit to the USB Type-A connector to support wireless LAN.
•It is IEEE802.11b/g/n (2.4 GHz) compliant.
•It supports infrastructure mode and 802.11 ad hoc mode.
•It also supports WEP (64/128 bit), WPA2-PSK, and WPA2-Enterprise.
Network Function
•It supports TCP/IP protocol.
•It supports DHCP and APIPA.
•It supports ENPC and SNMP. You can use ENPC and SNMP to acquire the printer status.
•It supports IPv4.
Setting
•The settings utility, EpsonNet Config, is available. Please download it from the Epson Web site and use it.
•You can use your Web browser to access EpsonNet Config (Web version) to browse and set network
parameters.
•You can use the push button to initialize the current network parameters or print settings.
CAUTION
Do not connect a device other than the Wireless LAN unit to the USB Type-A
connector.

12
Others
•It supports the XML print function (ePOS-Print) via HTTP/HTTPS communication.
•It is equipped with a CPU low-power consumption mode.
•It supports IEEE802.3az (Energy Efficient Ethernet: EEE).
Parts Name and Function
LAN connector
You can connect a LAN cable (RJ45 plug) to the LAN connector. When connecting the LAN cable, insert it all
the way until you hear the click.
LED
The two LEDs light up in the following situations. However, both are off during the CPU low-power
consumption mode.
The green LED: when the Ethernet link is established.
The yellow LED: when transmitting or receiving data.
What is the CPU low-power consumption mode?
If there is no data transmission or receiving and the push button is not operated for 3 seconds
or longer, the UB-E04 transitions to CPU low-power consumption mode. While in CPU low-
power consumption mode, the UB-E04 uses less power than usual. You cannot disable the
CPU low-power consumption mode function.
To use the EEE power-reducing function, you must have a computer that supports EEE
available.
CAUTION
Do not insert a customer display cable, drawer kick cable, or a general public circuit
cable into the LAN connector.
LED (Green) LED (Yellow) Push button
USB Type-A connector
(For connecting Wireless LAN unit)
LAN connector

13
Chapter 1 Product Overview
1
USB Type-A Connector (For connecting Wireless LAN unit)
You can connect an optional Wireless LAN unit to the USB Type-A connector.
Push button
The push button has the following functions.
Press the push button with a thin object such as a tweezers.
Status sheet printing
When the TM printer is ready to print (with paper loaded and the power on), press and hold the push
button for 3 seconds or longer to print the network parameters status.
Setting initialization
While holding the push button, turn the printer's power on and continue to hold the push button until the
initialization start message is printed (approx. 10 seconds) to restore all settings to their factory default.
After turning the printer's power on, it can take about 15 to 20 seconds until the UB-E04
functions are enabled. If printing the status sheet, turn the printer on and wait for 20
seconds or longer, then press the push button.
However, in case of the initial bootup after the setting initialization, it may take about 1
minute longer for the initial setting until the bootup.

14

15
Chapter 2 Set up
2
Set up
The following explains the procedure for network settings (set up) in order to connect the product to your
network.
Set up methods
There are three methods for set up.
Method 1: Set up using EpsonNet Config
This method involves installing the network configuration tool, EpsonNet Config, on your computer for
setting.
As it does not require any settings in advance to allow set up, you can easily perform set up using a
computer already connected to the network.
To download EpsonNet Config, see "Downloads" on page 30.
Method 2: Set up using EpsonNet Config (Web version)
This method involves opening the Web application equipped in the UB-E04 from a Web browser to
perform settings.
Because you specify the printer's IP address to open it, you need to set your computer to the same
network segment as the printer.
With EpsonNet Config (Web version), you can set more items than with EpsonNet Config.
Method 3: Set up using arp/ping commands
This method involves setting the printer's IP address in the setting computer's arp/ping commands,
then using the setting tool to change the other settings.
The setting computer must be in the same segment as the printer. Also, settings can be done only
when the printer's arp+ping IP setting is set to Enable.
Use EpsonNet Config or EpsonNet Config (Web version) for settings other than the IP address.
For the set up of the optional Wireless LAN unit, see the Wireless LAN unit's manual.

16
Flow of Setup
Change network settings
on setting computer
Set up using EpsonNet
Config
Printing the status sheet (check settings)
Method 1 Method 2 Method 3
- Use EpsonNet Config to perform
other settings
- Use EpsonNet Config (Web
version) to perform other settings
Use arp/ping command to set
printer IP address
Finish Finish Finish
Use EpsonNet Config
(Web version) to perform settings

17
Chapter 2 Set up
2
Printing the status sheet (Check Settings)
Turn on the printer equipped with the UB-E04, then after 20 seconds or longer, press and hold the push
button to the right of the LAN connector for about 3 seconds to print the status sheet. Once printing
starts, release the push button.
Press the push button with a thin object such as a tweezers.
Example status sheet
After turning the printer's power on, it can take about 15 to 20 seconds until the UB-E04
functions are enabled. Do not start pushing the push button during this time.
Push button

18
Set up using EpsonNet Config
Execute EpsonNet Config, select the target printer from the displayed device list, then check and
change the settings.
If the printer is still set to factory defaults, the printer's MAC address is listed up, even if the computer
does not have the same network address.
Download EpsonNet Config from the Epson website.
1Connect the printer to the same network as the computer where you installed
EpsonNet Config.
2Start up EpsonNet Config.
The tool automatically detects printers connected to the network and displays a list.
It may take up to a minute for the printer to be displayed in the list.
If it is not displayed, check that [Filter] is set to "(All)" or "Network-connected devices", then click
[Refresh]. Or, select [Tools], then [Option], and check the settings of [Search Parameters].
3Select the target printer, then click [Configuration].
If you cannot determine the target printer from the product name or the IP address, use the MAC
address. You can check the printer's MAC address on the status sheet.
4Change the printer's settings based on the network setting information you
received from the network administrator.
Select an item from the menu and change the setting.
5Once you set the necessary items, click [Transmit].
The changed contents are sent to the printer and the printer settings are changed.
For details about EpsonNet Config, see the manual (operation guide) installed together with
the tool or the online help.

19
Chapter 2 Set up
2
Set up using EpsonNet Config (Web version)
Specify the printer's IP address in the web browser and open EpsonNet Config (Web version) to check
and change settings.
If performing set up using EpsonNet Config (Web version), you need to set the network settings of the
setting computer to the same network segment as the printer to be connected to.
1Connect the setting computer and the printer to the same network.
2Perform network settings on the computer so that it is in the same segment as the
printer's IP address.
Subnet mask: Same subnet mask as the printer
IP address: Same segment (same network address) as the printer, different host address
Check the values set in the printer on the status sheet.
3Start up your Web browser and input the printer's IP address into the address field.
E.g.) http://192.168.192.168
4Input your user name and password on the authentication window.
Input "epson" for both the user name and password. You can change the password in the [Optional]
setting menu, under [Password].
By factory default, all UB-E04 devices are set to the same IP address (192.168.192.168).
If setting multiple printers for which the IP address has not been changed, turn on one
printer at a time and perform settings. If the power is on for multiple printers on a single
network, they will compete for the IP address and you cannot perform set up.
E.g.) Printer Setting computer
Subnet mask 255.255.255.0 255.255.255.0
IP address 192.168.192.168 192.168.192.2
Under initial settings, when you access EpsonNet Config (Web version) from your browser, an
authentication warning message may be displayed.

20
5Change the settings based on the network setting information you received from
the network administrator.
Select an item from [Configuration] and change the setting.
6After changing the necessary parameters, click the [Send] button.
The changes are sent to the printer.
7Click the [Reset] button on the Web page displayed after sending.
The sent contents are enabled.
Depending on the changes, such as the IP address, the connection with the setting computer may be
cut and the EpsonNet Config window may not be displayed. To reconnect, you need to set the net-
work settings of the setting computer to the same network segment as the printer for which settings
were changed.