Epson TM Series Impact Dot Printer Driver for Linux User Manual

Contents

  1. License agreement
  2. Product descriptions
  3. File configuration
  4. Supported models
  5. Operational environment
  6. How to install
  7. How to set
  8. Transmission function for a user-defined file
  9. List of installation packages
  10. How to uninstall
  11. Notes and restrictions
  12. Support information
  13. Revision history

1. License agreement

This software is distributed under a non-free proprietary license. Refer to the attached EULA.en.txt for the license details.

Copyright of all source code composing binary files of this software is held by SEIKO EPSON CORPORATION, and binary files are distributed under the SEIKO EPSON CORPORATION SOFTWARE LICENSE AGREEMENT (refer to EULA.en.txt).


2. Product descriptions

This software is a printer driver for printing on Epson TM series impact dot printers from Linux using CUPS (hereinafter called "this driver").

The following describes features of this driver.

Features:

*1: Device fonts, barcode printing, and multi-color printing are not supported.


3. File configuration

This driver package (tmu-cups-1.0.0.0.tar.gz) includes the following.

EULA.en.txt License file.
manual/ The manual storage directory.
manual/UsersManual.en.html The user manual. This file.
manual/BackendManual.en.txt The back-end manual.
manual/[model_name]_Manual.en.html Manuals for each model.

Example) For TM-U220: TM-U220_Manual.en.html

install.sh The installation script file. A program to install the printer driver.
uninstall-tmu.sh The uninstallation script file. A program to uninstall the printer driver.
ppd/ The PPD file storage directory. PPD files for supported models are stored.
filter/ The CUPS filter package storage directory.
backend/ The back-end and communication module storage directory.

4. Supported models

This driver supports the following model.

Check the manual for the given model for model specific print setting conditions.


5. Operational environment

5.1. Supported environments

This driver supports the following environments. Operations in an unsupported environment are not guaranteed.

5.2. Operation test environment

Operations have been confirmed in the following environments.

5.3. Operation test method

You can check information on the above packages for your environment as follows.


6. How to install

6.1. Installing required package

Install the package which is required in your environment.

Check to see if you are connected to the Internet before obtaining the required package.

openSUSE 11.1 environment

Download the package for libusb-1_0-0. You can download the package for openSUSE from the following site at the time of writing, August 2010.

Install the downloaded package.

Example) x86 (32-bit) architecture
# rpm -i libusb-1_0-0-1.0.2-2.2.i586.rpm

Note)
! You need root privileges for the installation.

Ubuntu 9.04 environment

Use the following command to install libusb-1.0-0.
# apt-get install libusb-1.0-0=2:1.0.0-1

Use the following command to update the CUPS package.
# apt-get install cups

Note)
! You need root privileges for the installation.
! If the necessary package is not installed by the above procedure, run the following command and reinstall the package.
# apt-get update

6.2. Installing driver

Run install.sh.

Run install.sh by either clicking the install.sh icon, or typing the following in the command line prompt.
# ./install.sh

Note)
! You need root privileges for the installation. If you do not have root privileges, install.sh will execute the sudo command. Type the password.
! Switch the printer off before installing the driver.

The terminal displays distribution information on the software which is about to be installed. If the information is correct, enter "y" and press the Enter key.

Example) openSUSE 11.1 x86 (32-bit) architecture

Install openSUSE 11.1 x86(32bit) [y/n]?      <- Message

If the displayed distribution is not the one you are installing, enter "n" and press the Enter key. The distribution selection screen is displayed. Enter a number between 1 and 4, and press the Enter key. Enter "0" and press the Enter key to cancel the installation.

Please select your distribution.
1.Ubuntu 9.04 x86(32bit)
2.Ubuntu 9.04 x86_64(64bit)
3.openSUSE 11.1 x86(32bit)
4.openSUSE 11.1 x86_64(64bit)
Select number [0(cancel)/1/2/3/4]?

Installation will start as you select the distribution.


7. How to set

7.1. Device port setting

You need to set a port when not using a USB port. Run /opt/epson/epuras/EPPortConfig.

Refer to the back-end manual for details on EPPortConfig.

Note)
! Turn the printer off while setting the port.

7.2. Registering the printer to CUPS

Turn the printer on before registering the printer to CUPS.

Open CUPS WebAdmin (http://localhost:631/) on a web browser to register the printer to CUPS.

Refer to CUPS information using the following URLs.

http://localhost:631/help/
http://www.cups.org/

Select "Epson TM/BA/EU Printer" in the printer device selection screen.

Example) For USB TM-U220

Epson TM/BA/EU Printer (USB TM-U220)

Select the PPD file directly in the printer model selection screen. PPD files are stored in the ppd directory in this driver package.

Note)
! Cancel the automatic recognition screen if it is displayed by the printer setting tool included in the distribution.

7.3. Print settings

Refer to the manual for each model for available print settings.

Example) For TM-U220:
TM-U220_Manual.en.html


8. Transmission function for a user-defined file

8.1. Overview

An ESC/POS command file created by a user is called a user-defined file. Placing a user-defined file at the designated location enables the user to transmit command data in the file to the printer at a fixed timing for each page or job.

8.2. Transmission timing and naming conventions for the user-defined file

File storage directory: /var/lib/tmu-cups-filter/

File naming conventions Transmission timing
[printer_name]_StartJob.prn When starting to print (after the printer initialization)
[printer_name]_EndJob.prn When finishing the print job (before cutting the document)
[printer_name]_StartPage.prn When starting to print each page (after the page initialization)
[printer_name]_EndPage.prn When finishing each page (before cutting the page)

printer_name indicates the registered printer name to CUPS.

Example) When the registered printer name is "tmu220printer" and you want to output a logo at the beginning, register the following file.
/var/lib/tmu-cups-filter/tmu220printer_StartJob.prn

Note)
! You need root privileges to store the user-defined file in /var/lib/tmu-cups-filter/.
! Grant the appropriate permissions to the user-defined file according to its function. Transmission is not carried out if the printing user does not have read permission to the user-defined file.
! The printer may malfunction if the user-defined file contains any graphic commands whose pattern matches real-time commands.
! If a user-defined file is stored in any of the subordinate directories, uninstallation of this driver package does not delete the directory which contains the file.

8.3. Printing text data

You can print the text data if the user-defined file contains text data.

Example) When tmu220printer_StartJob.prn contains the following line of text data.

Note)
! The text data may not be printed correctly if the specified character code is other than ASCII.
! Use "LF"(0x0A) for a line feed. Printing operations are not guaranteed if "CR"(0x0D) is used.
! The text data may not be printed correctly if a line feed "LF" is not present at the end of a line.
! The printing result is not guaranteed if the user-defined file is edited or deleted while printing. Do not change the user-defined file until printing is complete.

The above line is printed each time you print from "tmu220printer" at the top of the page.


9. List of installation packages

When you install this driver, some binary packages are also installed. Use the provided uninstallation script when you want to uninstall. Some of these packages may be left behind if installation or uninstallation is canceled for some reason.


10. How to uninstall

The following describes how to uninstall this driver.

Run uninstall-tmu.sh. Run install.sh by either clicking the uninstall-tmu.sh icon, or typing the following in the command line prompt.
# ./uninstall-tmu.sh

Note)
! You need root privileges for the uninstallation. If you do not have root privileges, uninstall-tmu.sh will execute the sudo command. Type the password.
! Delete the CUPS printer definition which is using this driver before uninstalling this driver.

The terminal displays the driver which is about to be uninstalled. If the information is correct, enter "y" and press the Enter key.

Example) openSUSE 11.1 x86 (32-bit) architecture

Uninstall tmu-cups-1.0.0.0  [y/n]?      <- Message

Uninstallation will start as you select "y".


11. Notes and restrictions


12. Support information


13. Revision history


Copyright © Seiko Epson Corporation 2010. All rights reserved.

Linux is the registered trademark or trademark of Linus Torvalds in the U.S.A. and other countries.

CUPS and the CUPS logo are trademarks of Apple Inc. registered in the U.S.A. and other countries.

Novell and openSUSE are trademarks of Novell, Inc. which is the founder and sponsor of the openSUSE Project and has been designated by the project.

Ubuntu and Canonical are registered trademarks of Canonical Ltd.

Other product names in this document are trademarks or registered trademarks of respective companies.