HID DTC 1500, FARGO User Manual

FARGO® DTC®1500 Linux

User Guide

PLT-04870, A.1 September 2020

FARGO®D TC®1500Linux User Guide

Powering

Trusted Identities

FARGO®DTC®1500 Linux

Powering

Trusted Identities

FARGO® DTC®1500 Linux

User Guide

This document may not be reproduced, disseminated or republished in any form without the prior written permission of HID Global Corporation.

Trademarks

HID GLOBAL, HID, the HID Brick logo, the Chain Design, DTC, FARGO, HoloMark, and VenMark are trademarks or registered trademarks of HID Global, ASSA ABLOY AB, or its affiliate(s) in the US and other countries and may not be used without permission. All other trademarks, service marks, and product or service names are trademarks or registered trademarks of their respective owners.

Contacts

For additional offices around the world, see www.hidglobal.com/contact/corporate-offices.

Americas and Corporate Asia Pacific

611 Center Ridge Drive Austin, TX 78753 USA Phone: +1866 607 7339

Europe, Middle East and Africa (EMEA) Brazil

3 Cae Gwyrdd Green Meadow Springs Cardiff CF15 7AB United Kingdom Phone: +44 (0) 2920 528 500

HID Global Technical Support: www.hidglobal.com/support.

19/F 625 King’s Road North Point, Island East Hong Kong Phone: +852 3160 9833

Condomínio Business Center Av. Ermano Marchetti, 1435 Galpão A2 - CEP 05038-001 Lapa - São Paulo / SP Brazil Phone: +55 11 5514-7100

What's new

Date Description Revision

September 2020 Added printer firmware upgrade to Section 2. A.1

A complete list of revisions is available in Revision history.

PLT-04870, A.1 2 September 2020

Powering

Trusted Identities

FARGO®DTC® 1500LinuxUser Guide

FARGO® DTC®1500 Linux

User Guide

Introduction 5

1.1 Supported CUPS versions 6

1.2 Firmware requirements 6

1.2.1 Linux with USB connection 6

Installation and maintenance 7

2.1 CUPS Linux driver download 8

2.2 CUPS Linux driver manual installation 8

2.3 CUPS Linux driver automatic installation 8

2.4 Upgrade the CUPS driver from an older version 9

2.5 Remove a driver 9

2.6 Upgrade the printer firmware 10

2.7 Determine the printer IP address 10

2.8 Add a printer connection using a USB cable 10

2.9 Maintenance procedures 15

2.9.1 Performing a ribbon sensor calibration 15

2.9.2 Cleaning the printer 15

Managing the printer 16

3.1 CUPS web interface 17

3.2 Printers tab 17

3.3 Option configuration 19

3.4 Setting default options 20

3.5 View printer specific options from the command line 21

3.6 Set printer-specific options from the command line 21

3.7 Printing from the command line 21

3.8 Printing with magnetic stripe encoding 21

Print job configuration options 22

4.1 Card option 24

4.2 Print options 25

4.3 Image color options 28

4.4 Image position options 30

4.5 Overlay print area options 31

4.5.1 Pre-defined print area omit regions 34

4.6 K-Panel options 35

4.7 Global magnetic encoding options 37

4.8 Magnetic track encoding options 38

4.8.1 Card printer driver magnetic encoder settings 40

4.9 Magnetic stripe encode data 41

4.9.1 Magnetic stripe encoding - format details 41

PLT-04870, A.1 3 September 2020

Powering

Trusted Identities

4.9.2 URL character encoding mode 41

4.9.3 ISO magnetic encoding mode 42

4.9.4 JIS II magnetic encoding mode 43

4.9.5 Custom magnetic encoding mode 43

4.9.6 Raw magnetic encoding mode 43

4.10 Banners option 44

4.11 Policies options 46

FARGO® DTC®1500 Linux

User Guide

Licenses 47

5.1 Copyright notices 48

5.2 The ICC software license, version 0.1 48

5.3 Boost software license - version 1.0 - August 17th, 2003 49

5.4 Apache license - version 2.0, January 2004 49

PLT-04870, A.1 4 September 2020

Section 01

Introduction

Powering

Trusted Identities

Powering

Trusted Identities

This User Guide covers how to use the CUPS system on a Linux machine to install and maintain a DTC1500 Linux printer driver Rev. B (v1.3.6.4). It describes the installation of the Linux driver, how to add and maintain the printer, manage the printer, and configure the available job options.

FARGO® DTC®1500 Linux

User Guide

1.1 Supported CUPS versions

Common Unix Printing System (CUPS) is a modular printing system for Unix-like computer operating systems. CUPS allows a computer to act as a print server. A computer running CUPS as a host that can accept print jobs from client computers, process these jobs, and send them to the appropriate printer.

The minimum required CUPS version for this driver is 1.7.2. If a previous version of the CUPS interface is being used, contact HID Global Technical Support at https://www.hidglobal.com/support.

The operating systems able to use CUPS include 64-bit Linux versions:

n Ubuntu 16.04

n Ubuntu 18.04

1.2 Firmware requirements

Printer firmware 1.0.4.10 is required to use CUPS with a DTC1500 connected by USB. To verify the firmware version, press and hold the Pause button on the DTC1500 for four seconds to print a printer settings card.

1.2.1 Linux with USB connection

For each Linux host machine, only one USB connection to a printer is supported.

PLT-04870, A.1 6 September 2020

Section 02

Installation and maintenance

Powering

Trusted Identities

Powering

Trusted Identities

Important: It is important that the DTC® card printer is not connected to the computer using a USB

cable before the Linux driver is installed.

FARGO® DTC®1500 Linux

User Guide

2.1 CUPS Linux driver download

1. Open a web browser and go to: https://www.hidglobal.com/drivers.

2. Select FARGO® from the All Brands list.

3. Select Linux or Linux x64 from the All OSs list.

4. Select HID®FARGO® DTC1500 Linux driver from the list of driver files and click DOWNLOAD.

5. Read the End User License Agreement and click I Accept to download the driver.

2.2 CUPS Linux driver manual installation

1. Copy the downloaded driver archive file into the root directory of the system.

2. With root privileges, run the following command:

sudo tar xf /DTC1500-x64.tar.gz -C /

2.3 CUPS Linux driver automatic installation

1. Ensure that the "driver_install.sh" file is stored in the same directory as the downloaded driver file.

2. Add execution privileges to the script file:

chmod +x driver_install.sh

3. Execute the script file:

sudo ./driver_install.sh

PLT-04870, A.1 8 September 2020

Powering

Trusted Identities

The installation begins. As the installation progresses, messages are displayed on the screen. When the installation has completed, you are prompted to reboot your system.

FARGO® DTC®1500 Linux

User Guide

2.4 Upgrade the CUPS driver from an older version

Follow the installation instructions in "Installation and maintenance " on page7 to download the driver file. Then, see "CUPS Linux driver manual installation" on the previous page or "CUPS Linux driver automatic installation" on the previous page to overwrite the existing driver with the new driver.

Note: Depending upon the desired configuration options, you may have to delete and reinstall the printer

using the new PPD file. Additional modification of the default print job configuration options may be necessary.

2.5 Remove a driver

There is not an uninstall process to remove a driver. Therefore, the driver files must be deleted manually. The following table shows the locations and names of the files that are installed on the Linux system for the driver.

To remove a driver, locate these files and delete them from your Linux system.

File Description

/usr/share/cups/model/DTC1500.ppd PPD file for the DTC1500 card printer.

/usr/libexec/cups/filter/rastertofargo-x.y.z Raster filter driver for the FARGO DTC Card Printers. "x.y.z" is major,

minor, and minor extension.

/etc/udev/rules.d/92-FARGO.rules Linux device management rules file.

PLT-04870, A.1 9 September 2020

Powering

Trusted Identities

FARGO® DTC®1500 Linux

User Guide

2.6 Upgrade the printer firmware

1. Download the new firmware zip package from https://www.hidglobal.com/drivers.

2. Unzip the archive to extract the *.frm file.

3. From a terminal window, enter one of the following (modifying the path as needed):

lpr -P DTC1500 FIRMWAREFILE NAME.frm

lp -d DTC1500 FIRMWAREFILE NAME.frm

4. Wait for the printer to complete the upgrade procedure.

Note: The .frm file is not located in the driver package.

2.7 Determine the printer IP address

The printer IP address must be determined prior to adding a network connected printer. The printer IP address may be determined using the following procedure:

1. Power on the printer.

2. Ensure that the printer is connected to the network using the RJ45 connector on the back of the printer.

3. Wait for the printer to obtain an IP address from DHCP. This may take up to a minute.

4. Press and hold Pause for at least four seconds to print a settings card.

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

2.8 Add a printer connection using a USB cable

1. Connect the USB cable to the printer.

2. Power on the printer.

3. Open a web browser and go to http://localhost:631/.

PLT-04870, A.1 10 September 2020

Powering

Trusted Identities

4. Open the CUPS home page and click the Administration tab.

FARGO® DTC®1500 Linux

User Guide

PLT-04870, A.1 11 September 2020

Powering

Trusted Identities

5. Click Add Printer.

FARGO® DTC®1500 Linux

User Guide

6. If the CUPS Authentication Required message is displayed when adding a printer, enter your login username and password to continue. See your CUPS documentation for more information about

permissions and authentication procedures.

7. Select the USB-connected printer or the http printer.

PLT-04870, A.1 12 September 2020

Powering

FARGO® DTC®1500 Linux

Trusted Identities

8. If you selected

n A USB printer, make sure the USB connections between the printer and the Linux workstation are

firm and that the printer is powered on.

n An http printer, enter the IP address for the printer followed by the port number 9100 using the

format

socket://aaa.bbb.ccc.ddd:9100

where aaa.bbb.ccc.ddd is the IP address of the printer.

User Guide

9. Depending upon the requirements, the printer data can be modified in the Add Printer window:

n Enter a new name for the printer, if needed.

n Enter a brief description of the printer.

n Enter a brief description of the location of the printer.

PLT-04870, A.1 13 September 2020

Powering

Trusted Identities

10. In the Make list, select HID and click Continue.

FARGO® DTC®1500 Linux

User Guide

11. In the Model list, select the DTC1500 model and click Add Printer.

PLT-04870, A.1 14 September 2020

Powering

Trusted Identities

2.9 Maintenance procedures

2.9.1 Performing a ribbon sensor calibration

1. Remove all cards from the card hopper and close the hopper door.

2. Open the front cover, remove the ribbon cartridge, and close the printer front cover.

3. From a terminal window enter one of the following (modifying the path, as needed):

lpr -P DTC1500 CalibrateRibbon.prn

lp -d DTC1500 CalibrateRibbon.prn

4. When completed, the printer beeps twice.

Note: The .prn file is located in the driver package.

2.9.2 Cleaning the printer

1. Remove all cards from the card hopper and close the hopper door.

FARGO® DTC®1500 Linux

User Guide

2. Open the front cover and remove the ribbon cartridge.

3. Remove the paper backing from both sides of the cleaning card.

4. Place the cleaning card into the single feed slot.

5. From a terminal window, enter one of the following (modifying the path, as needed):

lpr -P DTC1500 CleanPrinter.prn

lp -d DTC1500 CleanPrinter.prn

Note: The .prn file is located in the driver package.

PLT-04870, A.1 15 September 2020

Section 03

Managing the printer

Powering

Trusted Identities

+ 37 hidden pages