HID DTC1000, DTC4000, DTC4500 User Manual

15370 Barranca Parkway Irvine, CA 92618-2215

USA

DTC1000/4000/4500

CUPS Driver User Guide

LINUX & MAC OS

L001452 Rev 1.2

Revision Control Number

Date

Document Title

Revision 1.2

Sept 2011

New .ppd file Attributes for Localization and Status Monitor

Enhanced Print Options EnableStatusMonitor and AutoDetectRibbon

Status Monitor section Added graphical instructions for setting up a

DTC printer on a Linux system

Revision 1.1

Nov 2010

DTC1000/4000/4500 CUPS Driver User Guide LINUX & MAC OS

Added MAC OS sections

Revision 1.0

July 2010

DTC1000/4000/4500 CUPS Driver User Guide LINUX

and distribute this copyrighted document to authorized HID Global customers, who have signed a “no disclosure agreement” regarding the restricted, proprietary use of said document.

The revision number for this document will be updated to reflect changes, corrections, updates and enhancements to this document.

These reference documents were thoroughly reviewed to provide HID Global with professional and international standards, requirements, guidelines and models for our technical, training and user documentation. At all times, the Copyright Protection Notice for each document was adhered to within our HID Global documentation process. This reference to other documents does not imply that HID Global is an ISO-certified company at this time.

ANSI/ISO/ASQ Q9001-2000 American National Standard, (sub-title) Quality Management

Systems - Requirements (published by the American Society of Quality, Quality Press, P.O. Box 3005, Milwaukee, Wisconsin 53201-3005)

The ASQ ISO 9000:2000 Handbook (editors, Charles A. Cianfrani, Joseph J. Tsiakals and John E.

West; Second Edition; published by the American Society of Quality, Quality Press, 600 N. Plankinton Avenue, Milwaukee, Wisconsin 53203)

Juran's Quality Handbook (editors, Joseph M. Juran and A. Blanton Godfrey; Fifth Edition,

McGraw-Hill)

Any questions regarding changes, corrections, updates or enhancements to this document should be forwarded to:

HID Global Support Services 6533 Flying Cloud Drive Eden Prairie, MN 55344 (USA) (866)607-7339 Ext #6 FAX: (952) 946-8492

www.hidglobal.com

DTC1000/DTC4000/DTC4500 CUPS Driver User Guide - LINUX (L001452, Rev 1.2)

Table of Contents

Section 1: Supported Distributions CUPS ..................................................................................... 5

32-bit Linux versions: ................................................................................................................................ 5

64-bit Linux versions: ................................................................................................................................ 5

MAC OS X versions: ................................................................................................................................. 5

Section 2: Installation Procedures for Linux ................................................................................. 6

Installing the CUPS Driver ................................................................ ............................................................. 6

Determining the Printer IP Address................................................................................................................ 7

Setting up a DTC printer on a Linux system .................................................................................................. 8

Reviewing the File Listing ........................................................................................................................... 14

Section 3: Installation Procedure for MAC OS X ....................................................................... 15

Section 4: Printer Maintenance ..................................................................................................... 20

Performing a Ribbon Sensor Calibration ...................................................................................................... 20

Performing a Lamination Sensor Calibration ............................................................................................... 20

Cleaning the Printer ...................................................................................................................................... 21

Section 5: Managing the Printer ................................................................................................... 22

Printing on the Command Line: ................................................................................................................... 22

Printing a Test Card ................................................................................................................................. 22

Simply Print Commands: ......................................................................................................................... 23

Printing with Magnetic Stripe Encoding: ................................................................................................ 23

Printing with F-Panel: .............................................................................................................................. 23

Print to File: ............................................................................................................................................. 23

Managing from the Cups Web Interface ...................................................................................................... 24

Setting Options with Cups using Command-Line ........................................................................................ 24

Printer-Specific Options: ......................................................................................................................... 24

Setting Printer Options: ........................................................................................................................... 24

Section 6: Driver Options .............................................................................................................. 25

Reviewing the Card Options ........................................................................................................................ 25

Reviewing the Print Options ........................................................................................................................ 26

Reviewing the Print Options .................................................................................................................... 27

Reviewing the Print Options .................................................................................................................... 28

Reviewing the Image Color Options ............................................................................................................ 29

Reviewing the Image Position Options ........................................................................................................ 31

Reviewing the Overlay and Print Area Options ........................................................................................... 33

Reviewing the Front Area ........................................................................................................................ 34

Reviewing the Back Area ........................................................................................................................ 36

Reviewing the Print Area Examples ........................................................................................................ 39

Reviewing the Print Area Examples ........................................................................................................ 40

Defining Overlay/Print Area Options ...................................................................................................... 41

Reviewing the K-Panel Options ................................................................................................................... 42

Reviewing the F-Panel Options .................................................................................................................... 45

Reviewing the Lamination Options .............................................................................................................. 45

Reviewing the Lamination Position and Speed ....................................................................................... 46

Reviewing the Lamination Side ................................................................ ................................ ............... 46

Reviewing the Lamination Film Types Per Cartridge ............................................................................. 47

Reviewing the Lamination Transfer Temperatures per Cartridge ........................................................... 48

Reviewing the Global Magnetic Encoding Options ..................................................................................... 49

Sending ISO Magnetic Encoding Information ........................................................................................ 50

DTC1000/DTC4000/DTC4500 CUPS Driver User Guide - LINUX (L001452, Rev 1.2)

Sending JIS II Magnetic Encoding Information ................................ ................................ ...................... 51

Sending RAW Magnetic Encoding Information ...................................................................................... 51

Reviewing the URL Encoding Reference ................................................................................................ 51

Reviewing the ASCII Code and Character Table .................................................................................... 52

Reviewing the Magnetic Track Encoding Options ....................................................................................... 53

Section 7: Status Monitor .............................................................................................................. 55

Section 8: Licenses .......................................................................................................................... 56

Copyright Notices......................................................................................................................................... 56

The ICC Software License, Version 0.1 ....................................................................................................... 56

Boost Software License - Version 1.0 - August 17th, 2003 ......................................................................... 57

Apache License - Version 2.0, January 2004 ............................................................................................... 58

DTC1000/DTC4000/DTC4500 CUPS Driver User Guide - LINUX (L001452, Rev 1.2)

Section 1: Supported Distributions CUPS

The Common Unix Printing System (CUPS), a modular printing system for Unix-like computer operating systems, allows a computer to act as a print server. A computer running CUPS is a host that can accept print jobs from client computers, process them, and send them to the appropriate printer. The minimum required CUPS version for this driver is 1.2.0, if a previous version of the CUPS interface is being used please contact the support team at HID Global.

The driver has been testes on the following operating systems:

32-bit Linux versions:

Ubuntu 8.04, 9.04 & 10.10 Debian 5.04 Fedora 7, 8, 9, 10 & 14 Mandriva One 2009 Red Hat Enterprise 5 & 6 openSuse 10.3 SUSE 11.4

64-bit Linux versions:

Ubuntu 9.04 & 10.10 Debian 5.03 Fedora 11 & 14 Mandriva One 2009 Red Hat Enterprise 6 openSuse 11.1 SUSE 11.4

MAC OS X versions:

MAC OS X 10.5 MAC OS X 10.6

DTC1000/DTC4000/DTC4500 CUPS Driver User Guide - LINUX (L001452, Rev 1.2)

Step

Procedure

Unpack the driver tar-ball by running the following command as root from the directory the file was downloaded to:

tar -xzvPf fargoDTC4000-1.0.0.x.tar.gz (Note: If an existing driver was already present on the system, it may be

necessary to restart CUPS to allow the file changes to take effect.)

Section 2: Installation Procedures for Linux

Please follow these same procedures for the DTC1000, DTC4000, and DTC4500. The DTC4500 will refer to Lamination Options not used with the DTC1000 and DTC4000 Card Printers.

Please see Lamination Options for the DTC4500 specifics.

Installing the CUPS Driver

On some Linux Distributions, it may be necessary to disable SELinux capabilities in order to install or use the CUPS Driver. Refer to the SELinux web site at:

http://www.nsa.gov/research/selinux/index.shtml

or the documentation for your specific distribution for more information. Once the CUPS driver is installed, the Printer’s Options are accessible by following the

instructions (provided in this section under Installing the CUPS Driver).

Upgrading the CUPS Driver from an Older Version:

Just install the new driver, it will overwrite the old version. Then you have to delete and reinstall or modify the printer using the new .ppd file in the CUPS user interface.

Requirement of CUPS 1.4 Version:

Using the following two attributes in .ppd file require CUPS 1.4 version. Localization and Status Monitor messages are dependent from these attributes.

"Nickname" - used by CUPS to display the driver name "Reason" - needed for the localization

DTC1000/DTC4000/DTC4500 CUPS Driver User Guide - LINUX (L001452, Rev 1.2)

Step

Procedure

Apply power to the Printer.

Ensure that the Printer is connected to the network via the RJ45 jack on the back of the Printer.

Wait up to one minute for the Printer to allow the Printer to obtain an IP address from DHCP.

Click Menu (Pause button) to start the menu.

Select Info (Pause button) to start the information menu.

Click Next (On/Off button) info until you reach the IP address entry.

If your model does not have a display, then press and hold the Pause button for 4+ seconds to print a settings card.

The printer must be ready and idle for the card to print.

Determining the Printer IP Address

DTC1000/DTC4000/DTC4500 CUPS Driver User Guide - LINUX (L001452, Rev 1.2)

Setting up a DTC printer on a Linux system

Make sure that the printer is turned on and connected. For a network printer get the IP address as described above.

Open your web browser and go to "http://localhost:631/" to open the CUPS (Common Unix Printing System) home page and click the "Administration" tab.

Click the "Add Printer" button to start the add printer process.

DTC1000/DTC4000/DTC4500 CUPS Driver User Guide - LINUX (L001452, Rev 1.2)

If CUPS request for authentication: If you are super user enter your username and password. Otherwise enter the root username and password. Then click "Ok".

DTC1000/DTC4000/DTC4500 CUPS Driver User Guide - LINUX (L001452, Rev 1.2)

CUPS is looking for printers now. If you want to install a local printer select the detected printer. If you want to install a network printer select "Internet Printing Protocol (http)".

DTC1000/DTC4000/DTC4500 CUPS Driver User Guide - LINUX (L001452, Rev 1.2)

Enter the IP address for the printer followed by the Port number (9100) using the format "socket://aaa.bbb.ccc.ddd:9100" where the "aaa.bbb.ccc.ddd" section is the IP address of the printer. Then click the "Continue" button.

DTC1000/DTC4000/DTC4500 CUPS Driver User Guide - LINUX (L001452, Rev 1.2)

Fill the printer data in the Add Printer window: 1: Enter a name for the printer 2: Enter a brief description of the printer itself 3: Enter a brief description of the printer's location

DTC1000/DTC4000/DTC4500 CUPS Driver User Guide - LINUX (L001452, Rev 1.2)

In the Make/Manufacturer list select "Fargo". Then click the "Continue" button.

DTC1000/DTC4000/DTC4500 CUPS Driver User Guide - LINUX (L001452, Rev 1.2)

/usr/share/cups/profiles/sRGB.icm

Reference Color Profile

/usr/share/cups/profiles/DTC4000CLR.icm

Printer Specific Color Profile

/usr/share/cups/model/ DTC4000.ppd

PPD File for the DTC4000 Card Printer

/usr/lib/cups/filter/rastertofargo-x.y

Raster Filter for Fargo Card Printers. X.y is major and minor version of the

In the Model list select your DTCxxxx model. Then click the "Add Printer" button.

This completes the installation of the DTC printer.

Reviewing the File Listing

These files should have been installed to your computer. (Note: Replace DTC4000 by DTC1000 or DTC4500 for the file listings of the other printer models.)

DTC1000/DTC4000/DTC4500 CUPS Driver User Guide - LINUX (L001452, Rev 1.2)