Epson BA-T500II Thermal Printer Driver Users Manual

Contents

  1. License agreement
  2. Product overview
  3. File configuration
  4. Operational environment
  5. How to Install
  6. How to Set
  7. Transmission function for a user-defined file
  8. List of installation packages
  9. How to Uninstall
  10. Notes and restrictions
  11. Support information
  12. 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 overview

This software is a printer driver for printing on a BA-T500II thermal printer from Linux using CUPS.

Features:


3. File configuration

The package (tmt-cups-1.2.1.1.tar.gz) includes the following.

manual The manual storage directory. This directory contains the "Epson BA-T500II Thermal Printer Driver Users Manual" (this manual), "BA-T500II Thermal Printer Driver Manual", and "Epson BA-T500II Customized Thermal Printer Backend Manual".
install.sh The installation script file. A program to install the printer driver.
ppd The PPD file storage directory. The directory stores PPD files.
tmt-cups The printer driver package storage directory.
backend The back-end and communication module storage directory.

4. Operational environment

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

Note)
! You cannot use this product with other TM series printers, and also you cannot upgrade them using this product.


5. How to Install

5.1 Install the package which is required in your environment.

5.2 Installing driver


6. How to Set

6.1 Device port setting

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

Refer to the "Epson BA-T500II Customized Thermal Printer Backend Manual" for details. The "Epson BA-T500II Customized Thermal Printer Backend Manual" is stored in the manual directory in this package.

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

6.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 BA-T500II

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

Select the PPD file directly in the printer model selection screen.
The PPD file is stored in the ppd directory in this package.

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

6.3 Print settings

Refer to the "BA-T500II Thermal Printer Driver Manual" stored in the manual directory for the available print settings.


7. Transmission function for a user-defined file

7.1 Overview

An ESC/POS command file created by a user is called a user-definition 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.

7.2 Transmission timing and naming conventions for the user-defined file

File storage folder: /var/lib/tmt-cups/

Naming convention Transmission timing
{printer_name}_StartJob.prn When starting to print (after initializing the printer)
{printer_name}_EndJob.prn After printing (before cutting the document)
{printer_name}_StartPage.prn When starting to print each page (after initializing the page)
{printer_name}_EndPage.prn After printing a page (before cutting the page)

The printer_name indicates the registered printer name to CUPS.

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

Note)
! You need root privilege to store the user-defined file in /var/lib/tmt-cups/.
! 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 package does not delete the directory which contains the file.

7.3 Printing text data

You can print the text data if the user-defined file under /var/lib/ contains text data.

Example) When bat500IIprinter_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 "bat500IIprinter" at the top of the page.


8. List of installation packages

This installer installs multiple binary packages. Use the dpkg command when you want to uninstall. Some of the packages may have already been installed even if the installation is canceled for some reason.


9. How to Uninstall

The following describes how to uninstall this software.


10. Notes and restrictions


11. Support information


12. Revision history


— Copyright © Seiko Epson Corporation 2010-2011. 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.

Ubuntu and Canonical are registered trademarks of Canonical Ltd.

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