Elo TouchSystems Entuitive ET1725L Series User Manual

17" lcd desktop touchmonitor with magnetic swipe reader
Table of Contents

Advertisement

Quick Links

Advertisement

Table of Contents
loading

Summary of Contents for Elo TouchSystems Entuitive ET1725L Series

  • Page 2: User Guide

    Elo Entuitive Touchmonitor User Guide 17" LCD Desktop Touchmonitor with Magnetic Swipe Reader 1725L Series Revision A P/N 008583 Elo TouchSystems, Inc. 1-800-ELOTOUCH www.elotouch.com...
  • Page 3 Copyright © 2004 Elo TouchSystems, Inc. All Rights Reserved. No part of this publication may be reproduced, transmitted, transcribed, stored in a retrieval system, or translated into any language or computer language, in any form or by any means, including, but not limited to, electronic, magnetic, optical, chemical, manual, or otherwise without prior written permission of Elo TouchSystems.
  • Page 4: Table Of Contents

    Table of Contents Chapter 1 Chapter 4 Introduction Troubleshooting Precautions ....1 Solutions to Common Problems ..23 About the Product .
  • Page 5: Introduction

    H A P T E R NTRODUCTION HAPTER Congratulations on your purchase of an Elo TouchSystems Entuitive touchmonitor. Your new touchmonitor combines the reliable performance of Elo’s touch technology with the latest advances in LCD display design. This combination of features creates a natural flow of information between a user and your touchmonitor.
  • Page 6 • Auto adjustment capability • High quality full screen re-scaling • Multilingual OSD menus in six languages: English, French, German, Spanish, Italian and Japanese • Serial or USB touch interface (USB requires Windows 98, 2000, Me and XP.) • Built in speakers with volume, treble, bass And balance control thorough •...
  • Page 7: Installation And Setup

    H A P T E R NSTALLATION AND ETUP HAPTER This chapter discusses how to install your LCD touchmonitor and how to install Elo TouchSystems driver software. Unpacking Your Touchmonitor Check that the following 9 items are present and in good condition: USB touchscreen cable Serial cable LCD Display...
  • Page 8: Product Overview

    Product Overview Main Unit LCD Display Stand Rear View E l o E n t u i t i v e T o u c h m o n i t o r U s e r G u i d e...
  • Page 9: Side View

    Side View User Controls Base Bottom View 5X Stability Pad 23.6 M5 Mounting Holes (4X) 86.6 123.2 Base Bottom Scale 1:4...
  • Page 10: Touch Interface Connection

    Touch Interface Connection Your interface cables may have been pre-connected to your monitor at the factory. Your touchmonitor comes with one of the following touchscreen connector cables: Serial (RS-232) cable or USB cable. (For Windows 98, 2000, Me and XP systems only.) To set up this display, please refer to the following figures and procedures: Serial or USB Connection The following illustrations guide you step by step in connecting your...
  • Page 11: Removing The Back Cover

    Removing the Back Cover Bottom cut-out • The cables are routed through the back of the stand. • To remove the back cover, place one hand at the top of the stand and your other hand on the bottom cut-out. •...
  • Page 12: Routing The Cables

    Routing the Cables • The cables are routed through the cable management channel in the stand. E l o E n t u i t i v e T o u c h m o n i t o r U s e r G u i d e...
  • Page 13: Connecting The Video Cable Or Dvi-D Video Cable

    Connecting the Video Cable or DVI-D Video Cable Connections on underside Video cable Female 15 pin Video connector Video cable Connections on underside Video port Female DVI-D Video connector Video cable • Tilt the screen up and out (away from the stand) to access the connection ports.
  • Page 14: Connecting The Serial Or Usb Touchscreen Cable

    Connecting the Serial or USB Touchscreen Cable Connections on underside USB Touchscreen connector Serial Touchscreen cable Female 9-pin serial Touchscreen connector • Connect the female end of the serial (RS-232) cable to the serial port on the back of your PC, or connect the USB touchscreen cable to the USB touchscreen connector on the back of your touchmonitor.
  • Page 15: Connecting The Speaker Cable

    Connecting the Speaker Cable CONNECTIONS ON UNDERSIDE SPEAKER CABLE Speaker port If you do not wish to connect the speaker cable, go to step 5. • To use the built in speakers, you need to connect the speaker cable. Connect the light blue end of the speaker cable to thelight blue speaker port of the touchmonitor (audio in).
  • Page 16: Connecting The Power Cable

    Connecting the Power Cable Connections on Underside Power Cable Brick Power Supply Power Depending on where you live, you will use either the European or US/Canadian power cable. • Connect the female end of the power cable to theBrick power supply. •...
  • Page 17: Optimizing The Lcd Display

    Optimizing the LCD Display To ensure the LCD display works well with your computer, configure the display mode of your graphic card to make it less than or equal to 1024 x 768 resolution, and make sure the timing of the display mode is compatible with the LCD display.
  • Page 18: Accessing The Vesa Mounting Interface

    Accessing the VESA Mounting Interface If you want to convert your desktop monitor to a wall mount or kiosk monitor, follow the steps below to access the VESA mounting interface. You will need a screwdriver for the following steps. Remove the back cover of the stand by pulling forward on the bottom cut-out.
  • Page 19: Installing The Driver Software

    Installing the Driver Software Elo TouchSystems provides driver software that allows your touchmonitor to work with your computer. Drivers are located on the enclosed CD-ROM for the following operating systems: • Windows XP • Windows 2000 • Windows Me • Windows 98 •...
  • Page 20: Installing The Serial Touch Driver For Windows Xp, Windows 2000, Me, 95/98 And Nt

    Installing the Serial Touch Driver for Windows XP, Windows 2000 , Me, 95/98 and NT 4.0 For Windows 2000 and NT 4.0 you must have administrator access rights to install the driver. Insert the Elo CD-ROM in your computer’s CD-ROM drive. If the AutoStart feature for your CD-ROM drive is active, the system automatically detects the CD and starts the setup program.
  • Page 21: Installing The Serial Touch Driver For Ms-Dos And Windows 3.1

    Installing the Serial Touch Driver for MS-DOS and Windows 3.1 You must have a DOS mouse driver (MOUSE.COM) installed for your mouse if you wish to continue using your mouse along with your touchmonitor in DOS. To install Windows 3.x and MS-DOS from Windows 95/98, follow the directions below: Insert the Elo CD-ROM in your computer’s CD-ROM drive.
  • Page 22: Installing The Usb Touch Driver

    Installing the USB Touch Driver Installing the USB Touch Driver for Windows XP, Windows 2000 , Me and 98 Insert the Elo CD-ROM in your computer’s CD-ROM drive. If Windows 98, Windows Me or Windows 2000 starts the Add New Hardware Wizard: Choose Next.
  • Page 23: Operation

    H A P T E R PERATION HAPTER About Touchmonitor Adjustments Your touchmonitor will unlikely require adjustment. Variations in video output and application may require adjustments to your touchmonitor to optimize the quality of the display. For best performance, your touchmonitor should be operating in native resolution, that is 1280 x 1024 at 60-75 Hz.
  • Page 24: Side Bezel Buttons

    Side Bezel Buttons Control Function MENU Menu Display on exit the OSD menus. 1. Shortcut to Contrast adjustment Contrast/ 2. Increase value of adjustment items Up/Toggle 3. With menu on toggles OSD options 1. Shortcut to Volume adjustment Volume/Down 2. Decrease value of the adjustment items Toggle 3.
  • Page 25: Osd Menu Function

    OSD Menu Function CONTRAST Contrast Phase Controls the picture contrast Controls the vertical fine adjustment Brightness Clock Controls the picture brightness Controls the horizontal fine adjustment V-Position OSD H-Position Controls the vertical position Adjusts the horizontal position of the OSD menu H-Position OSD V-Position...
  • Page 26 3-22 E l o E n t u i t i v e T o u c h m o n i t o r U s e r G u i d e...
  • Page 27: Troubleshooting

    H A P T E R ROUBLESHOOTING HAPTER If you are experiencing trouble with your touchmonitor, refer to the following table. If the problem persists, please contact your local dealer or our service center. Solutions to Common Problems Problem Suggestion(s) No image appears on screen.
  • Page 28 Image has vertical flickering line bars. Use “PHASE” to make an adjustment. Check and reconfigure the display mode of the vertical refresh rate of your graphic card to make it compatible with the LCD display. Image is unstable and flickering Use “CLOCK”...
  • Page 29: Appendix A Native Resolution

    P P E N D I X ATIVE ESOLUTION HAPTER The native resolution of a monitor is the resolution level at which the LCD panel is designed to perform best. For the Elo LCD touchmonitor, the native resolution is 1280 x 1024 for the SXGA-17 inch size. In almost all cases, screen images look best when viewed at their native resolution.
  • Page 30 As an example, a SVGA resolution LCD panel has 800 pixels horizontally by 600 pixels vertically. Input video is also represented by the same terms. XGA input video has a format of 1024 pixels horizontally by 768 pixels vertically. When the input pixels contained in the video input format match the native resolution of the panel, there is a one to one correspondence of mapping of input video pixels to LCD pixels.
  • Page 31: Touchmonitor Safety

    P P E N D I X OUCHMONITOR AFETY HAPTER This manual contains information that is important for the proper setup and maintenance of your touchmonitor. Before setting up and powering on your new touchmonitor, read through this manual, especially Chapter 2 (Installation), and Chapter 3 (Operation).
  • Page 32: Care And Handling Of Your Touchmonitor

    Care and Handling of Your Touchmonitor The following tips will help keep your Elo Entuitive touchmonitor functioning at the optimal level. • To avoid risk of electric shock, do not disassemble the brick supply or display unit cabinet. The unit is not user serviceable. Remember to unplug the display unit from the power outlet before cleaning.
  • Page 33: Technical Specifications

    P P E N D I X ECHNICAL PECIFICATIONS HAPTER Compatible Video Modes Your Elo Entuitive touchmonitor is compatible with the following standard video modes: Mode Resolution H. Frequency (kHz) V. Frequency (Hz) IBM & VESA VGA 720 x 400 31.47 70.09 IBM &...
  • Page 34: Touchmonitor Specifications

    Touchmonitor Specifications 17" LCD Touchmonitor (ET17-XXWF-1) Specifications Active matrix, thin film transistor Display Type (TFT), liquid crystal display 17-inch diagonal Horizontal: 13.3” (338mm) useful screen Size area Vertical: 10.6” (270mm) useful screen area 1280 x 1024 Pixel Format 0.125-inch IntelliTouch and Touchscreen AccuTouch, anti-glare IntelliTouch or AccuTouch...
  • Page 35: Intellitouch Touchmonitor Specifications

    IntelliTouch Touchmonitor Specifications Mechanical Positional Accuracy Standard deviation of error is less than 0.080 in. (2.03 mm). Equates to less than ±1%. Touchpoint Density More than 100,000 touchpoints/in (15,500 touchpoints/cm Touch Activation Force Typically less than 3 ounces (85 grams). Surface Durability Surface durability is that of glass, Mohs’...
  • Page 36: Accutouch Touchmonitor Specifications

    AccuTouch Touchmonitor Specifications Mechanical Construction Top: Polyester with outside hard-surface coating with clear or antiglare finish. Inside: Transparent conductive coating. Bottom: Glass substrate with uniform resistive coating. Top and bottom layers separated by Elo-patented separator dots. Positional Accuracy Standard deviation of error is less than 0.080 in. (2.03 mm). This equates to less than ±1%.
  • Page 37: 17" Lcd Touchmonitor Dimensions

    17" LCD Touchmonitor Dimensions 270.3 C-33...
  • Page 38 67.7 See Detail A Detail A 5X Stability Pad 23.6 M5 Mounting Holes (4X) R3.25 10.8 86.6 123.2 R6.25 See Detail A Detail A Scale 1:1 Base Bottom Scale 1:4 C-34 E l o E n t u i t i v e T o u c h m o n i t o r U s e r G u i d e...
  • Page 39 EGULATORY NFORMATION HAPTER I. Electrical Safety Information: A) Compliance is required with respect to the voltage, frequency, and current requirements indicated on the manufacturer’s label. Connection to a different power source than those specified herein will likely result in improper operation, damage to the equipment or pose a fire hazard if the limitations are not followed.
  • Page 40 This Information Technology Equipment (ITE) is required to have a CE Mark on the manufacturer’s label which means that the equipment has been tested to the following Directives and Standards: This equipment has been tested to the requirements for the CE Mark as required by EMC Directive 89/336/EEC indicated in European Standard EN 55 022 Class B and the Low Voltage Directive 73/23/EEC as indicated in European Standard EN 60 950.
  • Page 41 N10051...
  • Page 42 E l o E n t u i t i v e T o u c h m o n i t o r U s e r G u i d e...
  • Page 43: Warranty

    ARRANTY HAPTER Except as otherwise stated herein or in an order acknowledgment delivered to Buyer, Seller warrants to Buyer that the Product shall be free of defects in materials and workmanship. The warranty for the touchmonitors and components of the product is 1 year. Seller makes no warranty regarding the model life of components.
  • Page 44 THESE REMEDIES SHALL BE THE BUYER’S EXCLUSIVE REMEDIES FOR BREACH OF WARRANTY. EXCEPT FOR THE EXPRESS WARRANTY SET FORTH ABOVE, SELLER GRANTS NO OTHER WARRANTIES, EXPRESS OR IMPLIED BY STATUTE OR OTHERWISE, REGARDING THE PRODUCTS, THEIR FITNESS FOR ANY PURPOSE, THEIR QUALITY, THEIR MERCHANTABILITY, THEIR NONINFRINGEMENT, OR OTHERWISE.
  • Page 45: Index

    Index Numerics Expected Life Performance, AccuTouch, 32 Expected Life Performance, IntelliTouch, 31 17" LCD Touchmonitor (ET17-XXWF-1) Specifications, 30 17" LCD Touchmonitor Dimensions, 33 GCX, 14 Gloss, AccuTouch, 32 About the Product, 1 Gloss, IntelliTouch, 31 About Touchmonitor Adjustments, 19 Accessing the VESA Mounting Interface, 14 AccuTouch Touchmonitor Specifications, 32 Agencies, 30 Haze, AccuTouch, 32...
  • Page 46: Regulatory Information

    Surface Durability, AccuTouch, 32 Surface Durability, IntelliTouch, 31 Native Resolution, 25 SVGA, 25 SXGA, 25 Operation, 19 Optical, AccuTouch, 32 Technical Specifications, 29 Optical, IntelliTouch, 31 Touch Activation Force, AccuTouch, 32 Optimizing the LCD Display, 13 Touch Activation Force, IntelliTouch, 31 OSD H-Position, 21 Touch Interface Connection, 6 OSD Language, 21...
  • Page 47 PORT POWERED SWIPE READER TECHNICAL REFERENCE MANUAL Manual Part Number 99875094 Rev 10 JULY 2001 20725 South Annalee Avenue Carson, CA 90746 Phone: (310) 631-8602 FAX: (310) 631-3956 Technical Support: (888) 624-8350 www.magtek.com...
  • Page 48 Copyright  1997-2001 MAG-TEK, Inc. Printed in the United States of America Information in this document is subject to change without notice. No part of this document may be reproduced or transmitted in any form or by any means, electronic or mechanical, for any purpose, without the express written permission of Mag-Tek, Inc.
  • Page 49 Limited Warranty Mag-Tek, Inc. (hereinafter “Mag-Tek”) warrants this Mag-Tek product IN ITS ENTIRETY, to be in good working order for a period of one year from the date of purchase from Mag-Tek. Should this product fail to be in good working order at any time during this warranty period, Mag-Tek will, at its option, repair or replace this product at no additional charge except as set forth below.
  • Page 50 FCC WARNING STATEMENT This equipment has been tested and found to comply with the limits for Class B digital device, pursuant to Part 15 of FCC Rules. These limits are designed to provide reasonable protection against harmful interference when the equipment is operated in a residential environment. This equipment generates, uses, and can radiate radio frequency energy and, if not installed and used in accordance with the instruction manual, may cause harmful interference to radio communications.
  • Page 51 TABLE OF CONTENTS SECTION 1. FEATURES AND SPECIFICATIONS --------------------------------------------------------------------- 1 MAG-TEK DEVICE DRIVERS FOR WINDOWS ---------------------------------------------------------------------- 1 FEATURES --------------------------------------------------------------------------------------------------------------------- 1 CONFIGURATION------------------------------------------------------------------------------------------------------------ 2 SPECIFICATIONS ------------------------------------------------------------------------------------------------------------ 3 SECTION 2. INSTALLATION ------------------------------------------------------------------------------------------------ 5 REQUIREMENTS------------------------------------------------------------------------------------------------------------- 5 MOUNTING--------------------------------------------------------------------------------------------------------------------- 5 INSTALLATION AND TEST ------------------------------------------------------------------------------------------------ 6 SECTION 3. OPERATION ----------------------------------------------------------------------------------------------------- 9 LED INDICATOR-------------------------------------------------------------------------------------------------------------- 9 CARD READ ------------------------------------------------------------------------------------------------------------------- 9 READER TO HOST MESSAGE FORMAT ----------------------------------------------------------------------------- 9...
  • Page 52: Figure 1-1. Port-Powered Swipe Reader

    Figure 1-1. Port-Powered Swipe Reader...
  • Page 53: Section 1. Features And Specifications

    SECTION 1. FEATURES AND SPECIFICATIONS The Port Powered Swipe Reader is a compact magnetic stripe card reader which conforms to ISO/ANSI standards. The Reader is compatible with the PC series of personal computers or any device with a serial RS-232 interface. A card is read by sliding it, stripe down and facing the LED side, through the slot either forward or backward.
  • Page 54: Configuration

    Port Powered Swipe Reader CONFIGURATION The Reader, LED Indicator, pin numbers for the 9-pin connector, and the Adapter are shown in Figure 1-2. Figure 1-2. Reader Cable and Optional Adapter Pin numbers and signal descriptions for the 9-pin (DE9) cable and 25-pin (DB25) adapter shown in the illustration are listed in Table 1-1.
  • Page 55: Specifications

    Section 1. Features and Specifications SPECIFICATIONS Table 1-2 lists the specifications for the Port Powered Swipe Reader. Figure 1-3 shows the dimensions for the standard product. Other sizes are available by special order. Table 1-2. Specifications OPERATING Reference Standards ISO/ANSI/ CDL/ AAMVA* Power Input From RS-232 interface Recording Method...
  • Page 56: Figure 1-3. Dimensions

    Port Powered Swipe Reader Figure 1-3. Dimensions...
  • Page 57: Section 2. Installation

    SECTION 2. INSTALLATION The hardware installation consists of plugging the cable into the PC and optional adapter, if required, Com Port setup, and testing the Reader. REQUIREMENTS • Port Powered Swipe Reader • Optional 9- to 25-pin Adapter, P/N 78200018 •...
  • Page 58: Installation And Test

    Port Powered Swipe Reader Figure 2-1. Mounting Hole Dimensions For Surface Mount the Reader. INSTALLATION AND TEST To install the Swipe Reader, perform the following steps: Connect the Swipe Reader cable connector into a 9-pin serial Com Port on the PC. If a 25-pin Adapter is required, plug the 9-pin connector on the Reader into the Adapter, and the adapter into the PC.
  • Page 59 Section 2. Installation Select 8 data bits, no parity, 1 stop bit. With the LED on, swipe a card. The data on the screen will show Track 1 beginning with “%” and ending with “?”. Track 2 begins with “;” and ends with “?”. Track 3 begins with “+”...
  • Page 60 Port Powered Swipe Reader...
  • Page 61: Section 3. Operation

    SECTION 3. OPERATION Included in this section are Indicator, Card Read, Reader to Host Message Format, and a timing diagram of sign-on ID. LED INDICATOR A green LED indicator on the panel gives the operator the status of the Reader. If the cabling is correct and the correct Com Port is selected, the indicator will be on.
  • Page 62: Timing For Id Sign

    Port Powered Swipe Reader TIMING FOR ID SIGN ON Timing for the ID Sign-on and transmission bursts (5 ms with 10 ms between bursts) are shown in Figure 3-1. 150 ms Sign-on ID Transmission Burst 5 ms 10 ms Figure 3-1. Timing For ID Sign-on and Transmission Bursts. The firmware controls the operation of Sign-on ID and Transmission bursts in the following format: 210888xxLnn <CR>...
  • Page 63: Table 3-2. Sign-On Id For Configurations

    Section 3. Operation Table 3-2 lists the available part number, firmware, and configuration. Table 3-2. Sign-on ID for Configurations Part Number Firmware Track Configuration Configuration* 21040071 21088811 Pearl White 21040073 21088812 Pearl White 21040074 21088817 1,2,3 Pearl White 21040075 21088814 Pearl White 21040077 21088817...
  • Page 64 USB (UNIVERSAL SERIAL BUS) SWIPE READER TECHNICAL REFERENCE MANUAL Manual Part Number 99875191 Rev 4 AUGUST 2001 20725 South Annalee Avenue Carson, CA 90746 Phone: (310) 631-8602 FAX: (310) 631-3956 Technical Support: (888) 624-8350 www.magtek.com...
  • Page 65 Copyright  2001 MAG-TEK, Inc. Printed in the United States of America Information in this document is subject to change without notice. No part of this document may be reproduced or transmitted in any form or by any means, electronic or mechanical, for any purpose, without the express written permission of Mag-Tek, Inc.
  • Page 66 Limited Warranty Mag-Tek, Inc. (hereinafter “Mag-Tek”) warrants this Mag-Tek product IN ITS ENTIRETY, to be in good working order for a period of one year from the date of purchase from Mag-Tek. Should this product fail to be in good working order at any time during this warranty period, Mag-Tek will, at its option, repair or replace this product at no additional charge except as set forth below.
  • Page 67 FCC WARNING STATEMENT This equipment has been tested and found to comply with the limits for Class B digital device, pursuant to Part 15 of FCC Rules. These limits are designed to provide reasonable protection against harmful interference when the equipment is operated in a residential environment. This equipment generates, uses, and can radiate radio frequency energy and, if not installed and used in accordance with the instruction manual, may cause harmful interference to radio communications.
  • Page 68 TABLE OF CONTENTS SECTION 1. FEATURES AND SPECIFICATIONS..................1 FEATURES ...............................1 CONFIGURATIONS..........................2 ACCESSORIES ............................2 REFERENCE DOCUMENTS........................2 SPECIFICATIONS ............................2 SECTION 2. INSTALLATION ........................5 USB CONNECTION..........................5 WINDOWS PLUG AND PLAY SETUP .....................6 MOUNTING...............................6 SECTION 3. OPERATION ...........................9 LED INDICATOR ............................9 CARD READ .............................9 SECTION 4.
  • Page 69 Figure 1-1. USB Swipe Reader...
  • Page 70: Section 1. Features And Specifications

    SECTION 1. FEATURES AND SPECIFICATIONS The USB (Universal Serial Bus) Swipe Reader is a compact magnetic stripe card reader which conforms to ISO standards. The Reader is compatible with the PC series of personal computers or any device with a USB interface. A card is read by sliding it, stripe down and facing the LED side, through the slot either forward or backward.
  • Page 71: Configurations

    USB Swipe Reader CONFIGURATIONS The Configurations are as follows: Part Number Tracks Color P/N 21040101 TK 1,2,3 Pearl White P/N 21040102 TK 1,2,3 Black P/N 21040103 TK 1,2 Pearl White P/N 21040104 TK 1,2 Black P/N 21040105 TK 2 Pearl White P/N 21040106 TK 2 Black...
  • Page 72 Section 1. Features and Specifications Table 1-2. Specifications Reference Standards ISO 7810 and ISO 7811/CDL/ AAMVA* Power Input 5V From USB port Recording Method Two-frequency coherent phase (F2F) Message Format ASCII Card Speed 3 to 50 IPS MTBF Electronics: 125,000 hours. Head: 1,000,000 passes ELECTRICAL Current Normal Mode...
  • Page 73 USB Swipe Reader...
  • Page 74: Section 2. Installation

    SECTION 2. INSTALLATION This section describes the cable connection, the Windows Plug and Play Setup, and the physical mounting of the unit. USB CONNECTION Connect the USB cable to a USB port on the host. The Reader, LED Indicator, and pin numbers for the 4-pin connector are shown in Figure 2-1.
  • Page 75: Windows Plug And Play Setup

    USB Swipe Reader WINDOWS PLUG AND PLAY SETUP On hosts with the Windows operating system, the first time the device is plugged into a specific USB port, Windows will pop up a dialog box, which will guide you through the process of installing a device driver for the device.
  • Page 76 Section 2. Installation Figure 2-2. Mounting Hole Dimensions For Surface Ensure the Reader is positioned on a flat, accessible surface with at least 4 inches clearance on either end for room to swipe a card. Orient the Reader so the side with the LED is facing the direction of intended use.
  • Page 77 USB Swipe Reader...
  • Page 78: Section 3. Operation

    SECTION 3. OPERATION This section describes the LED Indicator and Card Read. LED INDICATOR The LED indicator will be either off, red, or green. When the device is not powered, the LED will be off. When the device is first plugged in, the LED will be red. As soon as the device is plugged in, the host will try to enumerate the device.
  • Page 79 USB Swipe Reader...
  • Page 80: Section 4. Usb Communications

    SECTION 4. USB COMMUNICATIONS This device conforms to the USB specification revision 1.1. This device also conforms with the Human Interface Device (HID) class specification version 1.1. The device communicates to the host as a vendor defined HID device. The details about how the card data and commands are structured into HID reports follow later in this section.
  • Page 81: Report Descriptor

    USB Swipe Reader following table. The usage types are also listed. These usage types are defined in the HID Usage Tables document. Magnetic Stripe Reader usage page 0xff00: Usage ID Usage Name Usage Report (Hex) Type Type Decoding reader device Collection None Track 1 decode status...
  • Page 82: Card Data

    Section 4. USB Communications Item Value(Hex) Usage (Card encode type) 09 38 Report Count (7) 95 07 Input (Data, Variable, Absolute, Bit 81 02 Field) Usage (Track 1 data) 09 30 Report Count (110) 95 6E Input (Data, Variable, Absolute, 82 02 01 Buffered Bytes) Usage (Track 2 data)
  • Page 83: Track 1 Decode Status

    USB Swipe Reader TRACK 1 DECODE STATUS Bits Value Reserved Error This is a one-byte value, which indicates the status of decoding track 1. Bit position zero indicates there was an error decoding track 1 if the bit is set to 1. If it is zero, then no error occurred.
  • Page 84: Card Encode Type

    Section 4. USB Communications CARD ENCODE TYPE This one byte value indicates the type of encoding that was found on the card. The following table defines the possible values. Value Encode Type Description ISO/ABA ISO/ABA encode format AAMVA AAMVA encode format CADL CADL encode format Blank...
  • Page 85: Commands

    USB Swipe Reader COMMANDS Most host applications do not need to send commands to the device. Most host applications only need to obtain card data from the device as described previously in this section. This section of the manual can be ignored by anyone who does not need to send commands to the device.
  • Page 86: Result Code

    Section 4. USB Communications RESULT CODE This one byte field contains the value of the result code. There are two types of result codes: generic result codes and command specific result codes. Generic result codes always have the most significant bit set to zero. Generic result codes have the same meaning for all commands and can be used by any command.
  • Page 87: Software_Id Property

    USB Swipe Reader Property ID is a one byte field that contains a value that identifies the property. The following table lists all the current property ID values: Value Property ID Description SOFTWARE_ID The device’s software identifier SERIAL_NUM The device’s serial number POLLING_INTERVAL The interrupt pipe’s polling interval The Property Value is a multiple byte field that contains the value of the property.
  • Page 88 Section 4. USB Communications SERIAL_NUM PROPERTY Property ID: Property Type: String Length: 0 – 15 bytes Get Property: Set Property: Default Value: The default value is no string with a length of zero. Description: The value is an ASCII string that represents the device’s serial number. This string can be 0 –...
  • Page 89 USB Swipe Reader will be sent to the host when the host requests the device’s USB endpoint descriptor. When this property is changed, the unit must be power cycled to have these changes take effect for the USB descriptor. If a value other than the default value is desired, it can be set by the factory upon request.
  • Page 90: Section 5. Demo Program

    SECTION 5. DEMO PROGRAM The demo program, which is written in Visual Basic, can be used to do the following: • Read cards from the device and view the card data • Send command requests to the device and view the command responses •...
  • Page 91: Source Code

    USB Swipe Reader SOURCE CODE Source code is included with the demo program. It can be used as a guide for application development. It is described in detail, with comments, to assist developers. The book USB Complete by Jan Axelson is also a good guide for application developers, especially the chapter on Human Interface Device Host Applications (see “Reference Documents”...
  • Page 92: Programming Reference Manual

    MAGTEK DEVICE DRIVERS FOR WINDOWS PROGRAMMING REFERENCE MANUAL Manual Part Number: 99875125 Rev 6 NOVEMBER 2001 20725 South Annalee Avenue Carson, CA 90746 Phone: (310) 631-8602 FAX: (310) 631-3956 Technical Support: (888) 624-8350 www.MagTek.com...
  • Page 93 Copyright  1996-2001 MAG-TEK, Inc. Printed in the United States of America Information in this document is subject to change without notice. No part of this document may be reproduced or transmitted in any form or by any means, electronic or mechanical, for any purpose, without the express written permission of Mag-Tek, Inc.
  • Page 94 Limited Warranty Mag-Tek, Inc. (hereinafter “Mag-Tek”) warrants this Mag-Tek product IN ITS ENTIRETY, to be in good working order for a period of 90 days from the date of purchase from Mag-Tek. Should this product fail to be in good working order at any time during this warranty period, Mag-Tek will, at its option, repair or replace this product at no additional charge except as set forth below.
  • Page 95 TABLE OF CONTENTS SECTION 1. OVERVIEW ........................1 PROBLEMS WITH CONTROLLING DEVICES ................1 BENEFITS OF A CONTROL LANGUAGE AND DRIVER ............2 LANGUAGE OVERVIEW ......................3 Properties..........................3 COMMANDS ..........................4 TYPICAL OPERATION ........................5 Open a device..........................5 Query the device’s capabilities ....................5 Prepare the device for work .....................5 Use the device .........................5 Close the device ........................6 METHODS OF ACCESSING THE DEVICE ................6...
  • Page 96 enc_key..........................13 enc_key_sn..........................13 enc_mode ..........................13 entry_echo ..........................13 entry_len ..........................13 entry_tout ..........................13 events_on ..........................13 invalcmdrsp..........................13 key_parity..........................13 lasterr .............................13 max_pin_len...........................13 msg1 - msg4 ..........................13 oper_tout ..........................14 pin_blk_fmt..........................14 pinfilldig ..........................14 port_name..........................14 pwroffdelay..........................14 s_down_tout...........................14 track1ss..........................14 trivpinchk ..........................14 trk_enable ..........................14 trk1data ..........................14 trk2data ..........................14 trk3data ..........................14 visa_mac1..........................14 visa_mac2..........................14 visa_mac3..........................14...
  • Page 97 DESCRIPTION...........................30 LANGUAGE FORMAT .......................31 Format Name .........................31 Format Template........................31 Format Rules .........................31 DEFAULT FORMATS ........................35 EXAMPLE ..........................36 Retrieving properties from a magnetic card................36 SECTION 5. EXAMPLE APPLICATIONS ..................39 PROGRAMMING HINTS ......................39 VISUAL BASIC EXAMPLE......................39 C++ EXAMPLE ..........................45 POWER BUILDER EXAMPLE ....................50 APPENDIX A.
  • Page 98 MT-95 HICO ENCODER......................88 INDEX.............................89 FIGURES Figure 1-1. MagTek Devices and Device Drivers for Windows.............viii Figure A-1. Properties Settings, Windows 95 ................58 Figure A-2. Advanced Settings, Windows 95 .................58...
  • Page 99 MagTek Device Drivers for Windows Figure 1-1. MagTek Devices and Device Drivers for Windows viii...
  • Page 100 SECTION 1. OVERVIEW The MagTek Device (MTD) Drivers for Windows is a collection of individual drivers that support a number of MagTek products. These drivers provide a uniform application interface for controlling a wide range of MagTek devices. The drivers, combined with a device control language, solve many of the difficulties application developers face when attempting to control hardware devices.
  • Page 101 MagTek Device Drivers for Windows • MagTek devices are attached to the host in different ways. MagTek devices may be attached to a serial port, parallel port, to another device or even to the keyboard port. All these ports differ greatly in nature and would all have to be accessed by the application. Additionally, meaningful communication with a device attached to the keyboard port would be tricky at best.
  • Page 102 Section 1. Overview usually remain unchanged, even though the new device may be very different from the old one. The features of a driver that implement a device control language completely shield an application developer from the complexities of device-specific functionality. LANGUAGE OVERVIEW The device control language is text based and designed to utilize the read and write file I/O facilities of the underlying operating system.
  • Page 103 MagTek Device Drivers for Windows COMMANDS Like properties, commands are identified by a string name and have string arguments. All commands are terminated by line feed <LF> or a carriage return. To invoke a command, an application simply writes it to the driver in the same manner as writing to a file or serial port. If the command has a response defined for it, the application reads it from the driver using the same I/O handle as in the write.
  • Page 104 Section 1. Overview TYPICAL OPERATION This section describes a typical pattern that an application developer may use to operate a device. Although it is the most typical pattern, it is by no means the only viable one. Refer to Section 5, Example Applications, to see how to use the drivers in various applications.
  • Page 105 MagTek Device Drivers for Windows instruct the device to return the card data when swiped. All the facilities of the driver are utilized during this stage of operation. Close the device When the application is finished with the device, it simply closes the port using the handle obtained when it opened it.
  • Page 106 Section 1. Overview Settings tab. This gives both the Friendly Name and the port name ( ). It also COM<5-15> identifies the physical port that will be used to communicate with the device. Open the device using either of the previous names. Use whatever facility is provided by your development environment for opening files.
  • Page 107 MagTek Device Drivers for Windows ‘set up error handling On Error Resume Next ‘submit echo command Put #1, , "/echo Hello" + Chr$(10) ‘declare an input buffer a$ = String(2000, Chr$(0)) ‘read echo response from device Get #1, , a$ If Err.Number <>...
  • Page 108 Section 1. Overview It can prompt the user to repeat the action and re-submit the command. This is typical if the status does not indicate a failure, per se, but that the device may not be ready yet or first needs some other interaction by the user. It can reset the device and prompt the user to repeat the action.
  • Page 109 MagTek Device Drivers for Windows Installation And Setup) and select Properties. Click on the Version tab. Note the File Version, Part Number, and Description. INSTALLATION The drivers are installed by means of the Windows “Add New Hardware” facility in Windows 95/98/ME and the "INF"...
  • Page 110 SECTION 2. PROPERTIES This section lists the properties that are used in the MagTek Drivers. Properties can be interrogated by issuing a command and modified with a command. Refer to Section 3. Commands for complete description and examples of all commands. properties are set by the driver and reflect the device’s capabilities.
  • Page 111 MagTek Device Drivers for Windows Property Access Description c_write if the device can encode a magnetic card in either LoCo or HiCo; if the device can encode a magnetic card in only the setting indicated in wr_coer c_wr_secure if the device does not support secure mode; if the device can switch between secure and non-secure mode (see wr_secure...
  • Page 112: Enc_Key_Sn

    Section 2. Properties Property Access Description enc_key Encryption key to use for the next encryption process (IntelliPIN): for Master key for Session key for lower working keys for upper working keys enc_key_sn Serial number of encryption key. Used to specify key serial number for activating/deactivating PIN encryption in MSK mode and to return the key serial number in DUKPT mode.
  • Page 113: Oper_Tout

    MagTek Device Drivers for Windows Property Access Description offline_enc Set to to enable encode capability in standalone mode with keyboard; prevents standalone encoding (MT-95). oper_tout Operational timeout in seconds (15-255). (IntelliPIN) pin_blk_fmt PIN block format (IntelliPIN): (ANSI 9.8) or (IBM 3624) ansi pinfilldig PIN fill digit (0..9, A..F) when...
  • Page 114: Section 3. Commands

    SECTION 3. COMMANDS This section describes all of the commands that can be used with the MagTek Windows Device Drivers. Some commands require parameters to indicate to the driver exactly what function is to be performed. While there are a few device-specific commands, most commands can be used with any device.
  • Page 115: Notation Conventions

    MagTek Device Drivers for Windows Examples: 000000000011111111112222222222 012345678901234567890123456789 /read -00082 /get trk_enable NOTATION CONVENTIONS The following conventions are used in the tables that follow. Fixed Size (Bold) Used to represent literals (symbols, exactly as sent or received from driver) Italic Used to represent placeholders (variable fields) Expression parts in brackets are optional.
  • Page 116: Display

    Section 3. Commands display Function Show a single message or two alternating messages on the device’s display. Syntax /display The optional argument x indicates the message to be displayed. Errors none Remarks If the optional argument x is provided, this command displays it as a single message. If x is , the driver sends a command to the device to display the idle message (“Welcome”).
  • Page 117: Event

    MagTek Device Drivers for Windows event Function Response to an unsolicited event notification. Syntax none Errors none Remarks This response can occur when an unsolicited event, such as card inserted, occurs. The format of the response is: n data /event n is a numeric event code: –...
  • Page 118 Section 3. Commands load_key Function Load an encryption key into the device. Syntax n key /load_key n can be one of the following values: – master key (key is in clear text) – session key (key is encrypted under Master Key) –...
  • Page 119: Rawrecv

    MagTek Device Drivers for Windows rawrecv Function Receive data from the device. Syntax /rawrecv Errors /rawrecv 45<LF> If a command is already pending. /rawrecv 82<LF> If the command was canceled by the user (e.g., with CLEAR key) Remarks This command overrides the default processing of the next message that comes from the device and returns it to the application as a response.
  • Page 120: Rawsend

    Section 3. Commands rawsend Function Send arbitrary data to the device. Syntax /rawsend x x is an arbitrary string which is transmitted directly to the device. The string x is passed as-is to the device, except for ‘\’ which is used as an ‘escape’ character: •...
  • Page 121: Read

    MagTek Device Drivers for Windows read Function Read data from the device. Syntax [[x] y] /read The optional argument x specifies the data source; if x is missing, a card will be read. Refer to the Read Argument table below for a description data sources. The optional argument y is used to specify a message to be displayed on the LCD screen, if supported, before carrying out the command.
  • Page 122: Read Arguments

    Section 3. Commands Read Arguments The optional argument x used in the command specifies the type of data to read and y read specifies the text to be displayed. The following table describes the recognized x arguments for command: read Read Description Argument...
  • Page 123 MagTek Device Drivers for Windows Read Description Argument chk_or_card Read magnetic stripe card or check data. When a card or check is swiped through the device, the driver sends the respective response. key_press Display a message ( ) on the LCD screen, if available, and wait for a msg4 key on the keypad to be pressed.
  • Page 124 Section 3. Commands Read Description Argument Collect PIN from cardholder and read PIN data from the device. The following properties may be set before issuing this command: • – cardholder account number, including check digit, account_no if required • – transaction amount in cents, without punctuation, if amount required •...
  • Page 125: Reset

    MagTek Device Drivers for Windows reset Function Reset the device. Syntax /reset Errors none Remarks Clear any pending operations and reset the device to initial state (for mechanized card devices this command will also eject the card). This does not affect any of the properties.
  • Page 126: Write

    Section 3. Commands write Function Data encode command. Syntax data /write Errors /write 94<LF> Encode is not supported on this device. /write 34<LF> The data field was in the incorrect format. /write 82<LF> command was canceled. write /write 45<LF> Device in wrong mode (e.g., if /read already issued) /write 60<LF>...
  • Page 127 MagTek Device Drivers for Windows...
  • Page 128: Section 4. Magnetic Card Data Parsing

    SECTION 4. MAGNETIC CARD DATA PARSING This section describes the flexible data parsing language to be used by the MagTek device drivers to parse specific fields from magnetic card data and expose those fields as properties which may be retrieved by an application using the /get command. The data parsing language is flexible in that it can define both standard and custom formats to be parsed by the driver.
  • Page 129 MagTek Device Drivers for Windows • Property names specified in format rules are 11 characters or less, consisting of alphabetic characters, digits, and ‘_’. The property name begins with an alphabetic character. • Properties used in format strings do not conflict with properties defined by the driver. If there is a duplicate property (e.g., dev_version) specified in the format strings, the driver will return the value of the parsed property rather than the device version string.
  • Page 130 Section 4. Magnetic Card Data Parsing If the driver is successful in applying one of the rules, the name of the applied format is available in the property applied_fmt. LANGUAGE FORMAT Format Name (fmtx_name) The format name specifies an identifier by which to identify the format template and/or rules being applied.
  • Page 131 MagTek Device Drivers for Windows A format rule describes how the data is to be parsed. Characters that must be matched as literals are placed as is in the string or preceded with a ‘\’ if the character is one of the following: ‘[’, ‘]’, ‘(’, ‘)’, ‘*’, ‘_’, ‘<’, ‘>’, ‘:’, ‘.’, or ‘\’.
  • Page 132 Section 4. Magnetic Card Data Parsing Field Type Example Description Literal A literal is placed in the string as is and is used to determine if a particular format should be applied and to mark the end of a variable-length field. Non-ASCII literal \r, \n, \\, \xhh Specify an escape character or non-ASCII...
  • Page 133 MagTek Device Drivers for Windows The property name can also contain a modifier at the end preceded by a ‘:’ which specifies the type of data to store in that property. For example <cust_name:A> specifies that customer name should contain alphabetic characters, spaces, and punctuation. The modifier may also be used with ignore-fields (i.e., <*>).
  • Page 134 Section 4. Magnetic Card Data Parsing DEFAULT FORMATS The MTD drivers will be assigned parameters with default formats for parsing magnetic stripe data. The formats will be placed in the INF file for the driver and written to the registry when the driver is installed.
  • Page 135 MagTek Device Drivers for Windows fmt5_name "AAMVA" fmt5_template"%<*>?;<*>?{(+|%|#|!)<*>?}" fmt5_rules "{%<State[2]><City>^<LastName>$<FirstName>$<MidName>^<Adr>^<*>? ;<*[6]><DLID>=<ExpDate[4]><DateOfBirth[8]><*>? {(+|!|#|%)<*[2]><ZIP[11]><*[16]><Sex[1]><Hgt[3]><Wgt[3]><Hair[3]> <Eye[3]><*>?}}, {%<State[2]><City>^<LastName>$<FirstName>^<Adr>^<*>? ;<*[6]><DLID>=<ExpDate[4]><DateOfBirth[8]><*>? {(+|!|#|%)<*[2]><ZIP[11]><*[16]><Sex[1]><Hgt[3]><Wgt[3]><Hair[3]> <Eye[3]><*>?}}" In the examples for CADL (California Drivers License) and AAMVA (all other drivers licenses), the braces around the rules for track 3 indicate that track 3 is optional. EXAMPLE Retrieving properties from a magnetic card In this example, the rules above have been stored in the registry by the installation script.
  • Page 136 Section 4. Magnetic Card Data Parsing The application issues /get applied_fmt. The driver responds with /get applied_fmt BankCard. The application issues /get FirstName to the driver. The driver responds with /get FirstName JOHN. The application issues /get LastName to the driver. The driver responds with /get LastName SMITH.
  • Page 137 MagTek Device Drivers for Windows...
  • Page 138 SECTION 5. EXAMPLE APPLICATIONS While each application in this section is oriented toward a specific programming language, different devices are addressed in each example. It may be useful for the reader to look at all examples to understand how the MagTek Windows Drivers can operate with various MagTek devices. PROGRAMMING HINTS When opening a Keyboard Wedge device, the application must wait for any key press to complete, e.g., ALT-0.
  • Page 139 MagTek Device Drivers for Windows ' The form needs to contain: 1) an "MSComm" object named MSComm1 2) a button named btnStart, should be set to Enabled and Visible with the caption "Start" 3) a button named btnRead, should be set to Disabled and Visible with caption "Read"...
  • Page 140 Section 5. Example Applications MSComm1.Output = "/read card" & Chr$(10) ' If the device has check reading capability, then the ' following command would be used to read only the check ' data ' MSComm1.Output = "/read check" & Chr$(10) ' If the device can read only one media type (e.g.
  • Page 141 MagTek Device Drivers for Windows ' will hold the numeric port number Dim PortNumber As Integer ' prevent the Start button from being pressed again btnStart.Enabled = False txtInfo.Text = "Please wait. Opening the port as File IO" txtInfo.Refresh ' declare space for an input buffer buf$ = String(2000, Chr$(0)) ' If the virtual serial port number is unknown, it can be ' obtained by opening the driver in "File"...
  • Page 142 Section 5. Example Applications If Err.Number <> 0 Then ' Process error using Err.Description ' contains error description for the demo, ' we'll just display it txtInfo.Text = Err.Description ' Reset the error handling On Error GoTo 0 ' exit this sub Exit Sub End If ' reset the error handling...
  • Page 143 MagTek Device Drivers for Windows ' Set the com port number retrieved from the response MSComm1.CommPort = PortNumber ' Open the com port and establish communications with the device MSComm1.PortOpen = True ' enable the read button btnRead.Enabled = True txtInfo.Text = "Click on the Read button to read a”...
  • Page 144: C++ Example

    Section 5. Example Applications C++ EXAMPLE The following is an example of C++: /* -------------------------------------------------------------------------- */ TST: Test Application MTDTEST.C - Test module for Mag-Tek device drivers /* -------------------------------------------------------------------------- */ /* Version 1.00 $Revision:: $ */ /* -------------------------------------------------------------------------- */ #include <windows.h> #include <stdio.h>...
  • Page 145 MagTek Device Drivers for Windows /** clear overlapped structure */ memset ( &ov_r, 0, sizeof (ov_r) ); memset ( &ov_w, 0, sizeof (ov_w) ); if (argc < 2) drv_h = OPEN_DEVICE ("COM5"); /* Must Specify proper COM# as default */ else drv_h = OPEN_DEVICE (argv[1]);...
  • Page 146 Section 5. Example Applications NULL, // address of thread security attributes // initial thread stack size, in bytes (LPTHREAD_START_ROUTINE)input_thread,// addr of thread function NULL, // argument for new thread // creation flags 0-run immediately &retdw // address of returned thread identifier "Can't Create input thread"...
  • Page 147 MagTek Device Drivers for Windows #else gets(str); strcat(str, "\n"); ch = str[0]; #endif switch (ch) case 0x1a: // <Ctrl-Z> - emergency exit printf("\n---Exit---\n");//@@ quit = TRUE; break; default: if (ch < 0x100) BOOL DWORD ret_len; #ifdef SINGLE_CHARS rs = WriteFile(drv_h, &ch, 1, &ret_len, &ov_w); #else rs = WriteFile(drv_h, str, strlen(str), &ret_len, &ov_w);...
  • Page 148 Section 5. Example Applications DWORD read_len=0; char wbuff[1]; char* while (!quit) rs = ReadFile(drv_h, wbuff, sizeof(wbuff), &read_len, &ov_r); if ( !rs) rs = GetLastError (); if ( rs != ERROR_IO_PENDING) printf("DeviceIOControl (Read) Error : %i (0x%x)\n", rs, rs ); break; rs = WaitForSingleObject ( ov_r.hEvent, INFINITE);...
  • Page 149: Power Builder Example

    MagTek Device Drivers for Windows POWER BUILDER EXAMPLE The following example illustrates how to set up PowerBuilder (from Sybase) to read magnetic data from the IntelliPIN device. Since PowerBuilder does not interface to a serial port very easily, a third-party OCX is required.
  • Page 150 Section 5. Example Applications 8. Close the PowerScript Painter window and answer “Yes” to “Save changes…”. 9. Close the Window Painter window and answer “Yes” to “Save changes…”. At the “Save Window” dialog box, enter “ole_io” then click “OK”. 10. Open the PowerScript window for the main application and integrate the following commands into the application.
  • Page 151 MagTek Device Drivers for Windows...
  • Page 152: Appendix A. Installation And Setup

    APPENDIX A. INSTALLATION AND SETUP The distribution disks contain the MTD Driver files for many of the MagTek products. In addition to the drivers, there are number of files that are required to support the installation and operation of these drivers. The disk contents are listed in the tables below. Some of the Drivers support multiple configurations of the associated product.
  • Page 153: Installing Device Drivers (W95/98/Me)

    MagTek Device Drivers for Windows INSTALLING DEVICE DRIVERS (W95/98/ME) File or Directory Device Friendly DESCRIPTION Name Name Installation descriptor file OEMSETUP.INF README.TXT Describes the disk file contents and provides installation procedures The following Windows 95/98/ME device \W95_DRV Directory drivers are located in this directory: DriverMagic Advanced Part Library DMAPLD.VXD DMVXD.VXD...
  • Page 154 Appendix A. Installation and Setup General Notes: The computer and device should be powered off when connecting any devices. Although you do not have to have the device connected to install the driver, it is highly recommended. This allows the device and driver to be tested when the driver is installed. Note which hardware port each device is using on the computer as this information will be used later in the driver installation process.
  • Page 155 MagTek Device Drivers for Windows Select MagTek from the list of Hardware Types, then click the Next button. Select the device to be installed from the displayed list box and click the Next button. Click the Finish button. The computer will take a moment to install the driver. Please be patient.
  • Page 156 Appendix A. Installation and Setup Either accept the default selection for the virtual Port Name or select the desired port (COM5-COM15) to be associated with the device from the Port Name combo box and modify the device’s friendly name if the default is not acceptable. Select the port to which the device is connected (see General Notes in Installing Device Drivers (W95/98/ME) above) from the Connect to combo box.
  • Page 157 MagTek Device Drivers for Windows Figure A-1. Properties Settings, Windows 95/98/ME Figure A-2. Advanced Settings, Windows 95/98/ME...
  • Page 158 Appendix A. Installation and Setup Removing the Drivers (W95/98/ME) Caution The following assumes familiarity with the Registry Editor. Improper use of the Registry Editor can cause Windows to cease to function. Please follow the instructions carefully. Complete removal of the drivers requires two steps: (1) remove the drivers from the system using the Device Manager and (2) remove the driver files manually after all devices have been removed by the Device Manager.
  • Page 159 MagTek Device Drivers for Windows MAGCDFLT.DLL (locale specific) MAGCxxx.HLP (locale specific) MAGCxxx.DLL 7. Find and remove the copy of the Mag-TekOEMSETUP.INF file made by Windows. In release 1 of Windows 95, it is located in C:\Windows\inf\. With the OSR2 release of Windows 95 (Win95B) and Windows 98/ME, the files will be located in C:\Windows\inf\other\.
  • Page 160: Installing Device Drivers (Wnt)

    Appendix A. Installation and Setup INSTALLING DEVICE DRIVERS (WNT) File or Directory Friendly Name DESCRIPTION Name Installation descriptor file OEMSETUP.INF README.TXT Describes the disk file contents and provides installation procedures The following Windows NT device drivers \WNT_DRV Directory are located in this directory: DriverMagic Advanced Part Library DMAPLD.DLL DMNTK.DLL...
  • Page 161 MagTek Device Drivers for Windows Wizard. Open the Wizard by double clicking on the Add/Remove Programs icon in the Control Panel. On the Install/Uninstall tab. Find and select the entry that reads MTD preliminary release (uninstall) Mag-Tek Device Drivers (MTD) - uninstall then click on the Add/Remove button.
  • Page 162: Installing Device Drivers (W2000/Xp)

    Appendix A. Installation and Setup INSTALLING DEVICE DRIVERS (W2000/XP) File or Directory Friendly Name DESCRIPTION Name Keyboard hook installation descriptor file MTD_KBH.INF MTD_KBH.SYS Keyboard hook Driver OEMSETUP.INF Installation descriptor file Describes the disk file contents and README.TXT provides installation procedures \I386 Directory Microsoft keyboard drivers...
  • Page 163 MagTek Device Drivers for Windows In Windows 2000/XP, only users with Administrator privileges may install system components. Log on as Administrator (or as a user with full administrative privileges) before attempting to install the MTD driver. It is important to uninstall the previous version of MTD and re-boot the system before installing this version of the driver.
  • Page 164 Appendix A. Installation and Setup Click the “Next” button to advance to the next input screen. Click on "Yes" to the "Digital Signature Not Found". Click "Finish". Click "Close" on the "System" dialog. Answer "Yes" to the "Restart System" prompt. Note If, during the installation, a strange behavior is observed - failure, or some other unexpected error−a system reboot is necessary...
  • Page 165 MagTek Device Drivers for Windows 12. Uncheck all “Optional search locations” check boxes. 13. Click the “Next” button to advance to the next input screen. 14. Click the “Next” button to advance to the next input screen. 15. Answer "Yes" to the "Confirm Driver Install". (Note: This uninstallation procedure may hang at step 15.
  • Page 166 Appendix A. Installation and Setup MTD was successfully re-started. The changes you made are now in effect. Note Only a single keyboard device can be installed at a time. Adding a Serial Device (WNT/2000/XP) Mini MICR is used in the following example: 1.
  • Page 167 MagTek Device Drivers for Windows and MTD device will appear as COM7. The MICR+ device appears to the system as COM12 and has a friendly name : MICR+.) Two examples are shown: mtcfg COM7 "IntelliPIN MICR Aux" "UsePort=AUX port on MICR+" "FriendlyName=IntelliPIN AUX"...
  • Page 168: Command Syntax Summary

    Appendix A. Installation and Setup Command syntax summary Command Syntax Meaning list installed MagTek device drivers mtcfg display a help page mtcfg -? display a help page mtcfg -help list available MagTek device models mtcfg -models list settings for a given device mtcfg port-name verbose list of settings mtcfg port-name –allmore...
  • Page 169 MagTek Device Drivers for Windows model is the full name of the device model to be added. The name should be enclosed in quotes if it contains spaces. Use " " to see a mtcfg -models list of models. The model names used by MTCFG are the ones specified in the [Models] section of the MTD installation script (OEMSETUP.INF).
  • Page 170 Appendix A. Installation and Setup Configuration Examples for Windows NT/2000/XP These examples are for illustration only. Most of the command line entries will have to be modified to accommodate the actual installation. Device or driver Command Line Comment Generic RS-232 MTCFG COM5 "Generic Serial (RS- Be sure to specify the proper 232)"...
  • Page 171 MagTek Device Drivers for Windows Modifying a Device Driver's Settings (WNT/2000/XP) Use the following syntax to change settings of a device: mtcfg <port-name> <setting1> [<setting2> [<setting3>...]] each of the settings is specified as name=value if value contains spaces, the whole name=value string should be enclosed in quotes (not just the value), e.g., to specify the string “MT-85 on COM1”...
  • Page 172 Appendix A. Installation and Setup Removing a Device (WNT/2000/XP) To remove a MagTek device use the following command syntax: mtcfg port-name -delete The device is removed and all non-default settings specified for it are lost. This operation does not remove any files from the system. To remove all devices and uninstall the MTD driver, follow the instructions in the next section.
  • Page 173 MagTek Device Drivers for Windows...
  • Page 174: Appendix B. Command List Summary

    APPENDIX B. COMMAND LIST SUMMARY This is a consolidated list of all available commands for the MagTek Windows Drivers. Command Description Page Cancel a command. cmd can be any of the transaction /cancel commands. Display a message or two alternating messages on the LCD /display screen.
  • Page 175 MagTek Device Drivers for Windows...
  • Page 176: Appendix C. Status Codes

    APPENDIX C. STATUS CODES The following table defines the status codes returned in command responses. Note that it is not meant as a complete list of status codes–new codes may be added as necessary. Value Mnemonic and Description successful operation port already open wrong device ID value, buffer, whatever may overflow...
  • Page 177 MagTek Device Drivers for Windows...
  • Page 178: Appendix D. Device Driver Summaries

    APPENDIX D. DEVICE DRIVER SUMMARIES This section contains summaries of Device Drivers for the for the following models: • IntelliPIN and IntelliPIN PLUS • MagWedge Reader • MiniWedge Reader • MICR+ Reader • Mini-MICR Reader • Port Powered RS-232 Swipe Reader •...
  • Page 179: Intellipin Pinpad & Msr

    MagTek Device Drivers for Windows INTELLIPIN PINPAD & MSR File Name IPIN.VXD Part Number 30037395 Friendly Name(s) IntelliPIN RS-232, IntelliPIN Wedge & IntelliPIN MICR+ Aux Remarks The Automatic Settings in the properties sheet are not supported; the communications must be specified manually. When using the IntelliPIN on the MICR+ Aux port, the MICR+ driver must be installed before the IntelliPIN driver;...
  • Page 180: Magwedge Swipe Reader

    Appendix D. Device Driver Summaries MAGWEDGE SWIPE READER File Name Part Number MAGWEDGE.VXD 30037348 MagWedge Friendly Name(s) Remarks The driver cannot determine which tracks are supported on the device, so the properties will always c_tracks trk_enable indicate Commands Supported ✔ ✔ ✔ ✔ ✔...
  • Page 181: Miniwedge Msr

    MagTek Device Drivers for Windows MINIWEDGE MSR File Name Part Number MINIWEDG.VXD 30037340 Friendly Name(s) MiniWedge Remarks When operating in the Windows Driver mode, the MiniWedge transmits data as ASCII characters instead of scan codes in order to reduce the transmission time. (A full 3-track card can be transmitted in about 0.5 second whereas in the non-driver mode it would take almost 4 seconds.) If this creates problems in certain hardware implementations, the skip_ascii and dev_char_delay parameters in the registry...
  • Page 182: Micr+ Check Reader & Msr

    Appendix D. Device Driver Summaries MICR+ CHECK READER & MSR File Name Part Number MICRPLUS.VXD 30037349 Friendly Name(s) MICR+ Remarks These devices may or may not have an MSR installed. If not installed, the driver may not properly indicate the c_tracks capability.
  • Page 183: Mini Micr Check Reader & Msr

    MagTek Device Drivers for Windows MINI MICR CHECK READER & MSR File Name Part Number MINIMICR.VXD 30037344 Friendly Name(s) Mini MICR RS-232 & Mini MICR Wedge Remarks These devices may or may not have an MSR installed. If not installed, the driver may not properly indicate the c_tracks capability.
  • Page 184: Port-Powered Rs-232 Swipe Reader

    Appendix D. Device Driver Summaries PORT-POWERED RS-232 SWIPE READER File Name Part Number MTPPSWIP.VXD 30037346 Friendly Name(s) Port-powered swipe reader Remarks This driver supports all port-powered swipe readers. Commands Supported ✔ ✔ ✔ ✔ ✔ ✔ ✔ ✔ /cancel cmd /load_key n key /reset ✔...
  • Page 185: Port-Powered Rs-232 Insertion Reader

    MagTek Device Drivers for Windows PORT-POWERED RS-232 INSERTION READER File Name Part Number MTPPINSR.VXD 30037339 Friendly Name(s) Port-powered insert reader If events_on is enabled, the driver will send /event 1 M when the card is Remarks inserted. It is suggested that events be disabled (/set events_on 0) before the data is read to prevent the removal event from being included at the end of card data.
  • Page 186: Mt-85 Loco Encoder

    Appendix D. Device Driver Summaries MT-85 LOCO ENCODER MT85.VXD 30037337 File Name Part Number MT-85 Friendly Name(s) Remarks The driver attempts to connect to the device by automatically scanning all connection modes. Commands Supported ✔ ✔ ✔ ✔ ✔ ✔ ✔ ✔ /cancel cmd /load_key n key /reset...
  • Page 187 MagTek Device Drivers for Windows MT-95 HICO ENCODER File Name Part Number MT95.VXD 30037347 Friendly Name(s) MT-95 Remarks Commands Supported ✔ ✔ ✔ ✔ ✔ ✔ ✔ ✔ /cancel cmd /load_key n key /reset ✔ ✔ ✔ ✔ ✔ ✔ ✔ ✔ /display [x] /rawrecv /set prop val...
  • Page 188 INDEX Checksum ............ 1 chk_account..........12 Access to the device ........6 chk_amount ..........12 account_no ..........11 chk_bankid ..........12 Action properties ......... 3 chk_data ............ 12 Adding a Keyboard Device (WNT) ..66 chk_format ..........12 Adding a Serial Device (WNT)....67 chk_mod10 ..........
  • Page 189 MagTek Device Drivers for Windows Device control language......2 Device Driver Summaries ......79 Generic Driver......... 9, 61, 63 Device, close the ......... 6 Get Command ........... 18 Device, interacting with ......7 Device, methods of accessing ..... 6 Device, obtaining access to ......6 Idle message ..........
  • Page 190 MTCFG Utility (WNT), Using ....68 MTD (Mag-Tek Drivers) ......1 Raw commands ........2, 4 Rawrecv Command ........20 Rawsend Command........21 Non-interactive commands ......4 ........21 Rawxact Command Notation Conventions........ 16 Read Arguments........23 Read Command ......... 22 Read response..........
  • Page 191 MagTek Device Drivers for Windows Use Port ..........67, 72 Visual Basic Example ....... 39 Use the device ..........5 wr_coer............14 Ver Command ........... 26 wr_secure ..........14 Version, Driver..........9 Write Command ........27 Viewing the List of Configured Devices (WNT) ...........

Table of Contents