Elo Entuitive Touchmonitor User Guide 15" LCD Desktop Touchmonitor with Magnetic Swipe Reader (serial) 1525L Series Revision A P/N 008568 Elo TouchSystems, Inc. 1-800-ELOTOUCH www.elotouch.
Copyright © 2002 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. Disclaimer The information in this document is subject to change without notice.
Table of Contents Chapter 1 Introduction Chapter 3 1 Precautions . . . . . . . . . . . . . . . . . . . . 1 Chapter 2 Installation and Setup 3 Unpacking Your Touchmonitor. . . . . . . . . . . 3 Product Overview . . . . . . . . . . . . . . . . . 4 Main Unit . . . . . . . . . . . . . . . . . . . . 4 Rear View . . . . . . . . . . . . . . . . . . . 4 Side View. . . . . . . . . . . . . . . . . . . . 5 Base Bottom View . . . . . . . . . . . . . . . 5 Touch Interface Connection . . . . . . . . . . . .
CHAPTER 1 INTRODUCTION CHAPTER 1 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. Precautions Follow all warnings, precautions and maintenance as recommended in this user’s manual to maximize the life of your unit.
• Auto adjustment capability • High quality full screen re-scaling • Multilingual OSD menus in four languages: English, French, German, Spanish, and Japanese • Serial or USB touch interface (USB requires Windows 98, 2000, Me and XP.) • Built in speakers • Patented touch technology of Elo TouchSystems • VESA DDC 1/2B data communication • VESA DPMS power saving • Stand with minimum 45° angle of tilt.
CHAPTER 2 INSTALLATION AND SETUP CHAPTER2 This chapter discusses how to install your LCD touchmonitor and how to install Elo TouchSystems driver software.
Product Overview Main Unit LCD Display Stand Rear View 2-4 Elo Entuitive Touchmonitor User Guide
Side View User Controls Base Bottom View 2-5
Touch Interface Connection NOTE: 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 Connection The following illustrations guide you step by step in connecting your touchmonitor using a serial cable connection.
STEP 1-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. • Pull forward from the bottom cut-out and twist the cover until it snaps off. The cable ports are located on the underside of your touchmonitor.
STEP 2-Connecting the Video Cable Connections on underside Female video connector Cable management clip Video cable Video port Ferrite bead • Tilt the screen up and back to access the connection ports. • Connect the 15-pin video cable (the ferrite bead end) to the video port on your PC. • Connect the other end of the video cable to the video connector on your touchmonitor by routing the cable through the hole in the stand.
STEP 3-Connecting the Serial Touchscreen Cable Connections on underside Female 9-pin Serial Touchscreen connector Serial Touchscreen cable • Connect the female end of the serial (RS-232) cable to the serial port on the back of your PC. • Connect the male end of the cable to the serial touchscreen connector on your touchmonitor. • Secure the cable to your touchmonitor and PC by turning the screws on the connector. • Route the cable through the cable management clip.
STEP 4-Connecting the Speaker Cable Connections on underside Speaker port Speaker cable NOTE: 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 speaker cable to the speaker port inside the back of your touchmonitor. • Connect the other end of the cable to the speaker connector on your PC.
STEP 5-Connecting the Power Cable Connections on underside AC power cable port Cable management clip Power cable 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 the power port on the touchmonitor. • Route the cable through the cable management clip.
USB Connection NOTE: A USB connection can only be used if your PC is running Windows 98, 2000, Me or XP. The following illustrations guide you step by step in connecting your touchmonitor using a USB cable connection. CAUTION Before connecting the cables to your touchmonitor and PC, be sure that the computer and the touchmonitor are turned off.
STEP 1-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. • Pull forward from the bottom cut-out and twist the cover until it snaps off. The cable ports are located on the underside of your touchmonitor.
STEP 2-Connecting the Video Cable Connections on underside Female 15-pin video connector Cable management clip Video cable Video port Ferrite bead • Tilt the screen up and back to access the connection ports. • Connect the 15-pin video cable (the ferrite bead end) to the video port on your PC. • Connect the other end of the video cable to the video connector on your touchmonitor by routing the cable through the hole in the stand.
STEP 3-Connecting the USB Touchscreen Cable Connections on underside USB touchscreen connector Cable management clip USB touchscreen cable • Connect the USB touchscreen cable to the USB touchscreen connector on the touchmonitor. • Connect the other end of the USB touchscreen cable to your PC. • The touchscreen cable connectors should fit snugly into the connectors on your touchmonitor and PC. • Route the cable through the cable management clip.
STEP 4-Connecting the Speaker Cable Connections on underside Speaker port Speaker cable NOTE: 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. Both ends of the speaker cable are identical, so you can connect either end of the speaker cable to the speaker port inside the stand of your touchmonitor. • Connect the other end of the cable to the speaker connector on your PC.
STEP 5-Connecting the Power Cable Connections on underside Power cable Depending on where you live, you will use either the European or US/Canadian power cable. • Connect the female end of the power cable into the power port on the touchmonitor. • Route the cable through the cable management clip.
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. Refer to Appendix A for more information about resolution. Compatible video modes for your touchmonitor are listed in Appendix C.
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. NOTE: You will need a screwdriver for the following steps. 1 Remove the back cover of the stand by pulling forward on the bottom cut-out. 2 Carefully lay the monitor face down. At the top of the mounting screw cover there are two slots. With a screwdriver, pry open the mounting screw cover.
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 • Windows 95 • Windows NT 4.0 Additional drivers and driver information for other operating systems (including MS DOS, Windows 3.x, OS/2, Macintosh and Linux) are available on the Elo TouchSystems web site at www.elotouch.com.
Installing the Serial Touch Driver for Windows XP, Windows 20001, Me, 95/98 and NT 4.0 NOTE: For Windows 2000 and NT 4.0 you must have administrator access rights to install the driver. 1 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. 2 Follow the directions on the screen to complete the driver setup for your version of Windows.
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: 1 Insert the Elo CD-ROM in your computer’s CD-ROM drive. 2 From DOS, type d:\EloDos_W31 to change to the correct directory on the CD-ROM (your CD-ROM drive may be mapped to a different drive letter).
Installing the USB Touch Driver Installing the USB Touch Driver for Windows XP, Windows 2000, Me and 98 1 Insert the Elo CD-ROM in your computer’s CD-ROM drive. If Windows 98 or Windows 2000 starts the Add New Hardware Wizard: 2 Choose Next. Select “Search for the best driver for your device (Recommended)” and choose Next. 3 When a list of search locations is displayed, place a checkmark on “Specify a location” and use Browse to select the \EloUSB directory on the Elo CD-ROM. 4 Choose Next.
2-24 Elo Entuitive Touchmonitor User Guide
CHAPTER 3 OPERATION CHAPTER3 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 1024 x 768 at 60-75 Hz. Use the Display control panel in Windows to choose 1024 x 768 resolution. Operating in other resolutions will degrade video performance.
Side Bezel Buttons 1 2 3 4 5 1 Function Menu Display on exit the OSD menus. 2 Contrast/ Up/Toggle 3 Volume/Down Toggle 4 5 3-26 MENU Control SELECT 1. Shortcut to Contrast adjustment 2. Increase value of adjustment items 3. With menu on toggles OSD options 1. Shortcut to Volume adjustment 2. Decrease value of the adjustment items 3. With menu on toggles OSD options Enter Select item 1. Shortcut to Auto Adjust 2. Select- To select the adjustment items from the OSD menus. 3.
OSD Menu Function CONTRAST 50 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 Controls the horizontal position Adjust the vertical position of the OSD menu Recall Defaults OSD Time Recalls factory settings of the image parameters Determ
3-28 Elo Entuitive Touchmonitor User Guide
CHAPTER 4 TROUBLESHOOTING CHAPTER4 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. Check that all the I/O and power connectors are properly connected as described in Chapter 2. Make sure the pins of the connectors are not crooked or broken.
4-30 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” to make an adjustment. Image is scrolling Make sure the VGA signal cable (or adapter) is well connected. Check and reconfigure the display mode of the vertical refresh rate of your graphic card to make it compatible with the LCD display.
APPENDIX A NATIVE RESOLUTION CHAPTER4 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 1024 x 768 for the XGA-15 inch size. In almost all cases, screen images look best when viewed at their native resolution. You can lower the resolution setting of a monitor but not increase it.
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.
APPENDIX B TOUCHMONITOR SAFETY CHAPTER 4 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). 1 To reduce the risk of electric shock, follow all safety notices and never open the touchmonitor case.
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. • Do not use alcohol (methyl, ethyl or isopropyl) or any strong dissolvent. Do not use thinner or benzene, abrasive cleaners or compressed air.
APPENDIX C TECHNICAL SPECIFICATIONS CHAPTER4 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 IBM & VESA VGA 640 x 350 640 x 400 31.47 31.47 70.09 70.09 IBM & VESA VGA IBM & VESA VGA IBM & VESA VGA 720 x 400 640 x 480 640 x 480 31.47 31.47 37.86 70.09 59.94 72.81 IBM & VESA VGA VESA SVGA 640 x 480 800 x 600 37.50 35.16 75.00 56.
Touchmonitor Specifications Table C.1 15" LCD Touchmonitor (ET15-XXWA-1) Specifications Display Type Size Pixel Format Touchscreen Colors 0.
Table C.2 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 Touch Activation Force Surface Durability Expected Life Performance More than 100,000 touchpoints/in2 (15,500 touchpoints/cm2). Sealing Typically less than 3 ounces (85 grams). Surface durability is that of glass, Mohs’ hardness rating of 7.
Environmental Chemical Resistance Electrostatic Protection (per EN 61 000-4-2, 1995) C-38 The active area of the touchscreen is resistant to all chemicals that do not affect glass, such as: Acetone Toluene Methyl ethyl ketone Isopropyl alcohol Methyl alcohol Ethyl acetate Ammonia-based glass cleaners Gasoline Kerosene Vinegar Meets Level 4 (15 kV air/8 kV contact discharges).
Table C.3 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%. More than 100,000 touchpoints/in² (15,500 touchpoints/cm²).
15" LCD Touchmonitor (ET15-XXWA-1) Dimensions C-40 Elo Entuitive Touchmonitor User Guide
See Detail A Detail A C-41
C-42 Elo Entuitive Touchmonitor User Guide
REGULATORY INFORMATION CHAPTER4 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. B) There are no operator serviceable parts inside this equipment.
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.
N10051 45
46 Elo Entuitive Touchmonitor User Guide
WARRANTY CHAPTER4 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. Seller’s suppliers may at any time and from time to time make changes in the components delivered as Products or components.
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. NO EMPLOYEE OF SELLER OR ANY OTHER PARTY IS AUTHORIZED TO MAKE ANY WARRANTY FOR THE GOODS OTHER THAN THE WARRANTY SET FORTH HEREIN.
INDEX Numerics 15" LCD Touchmonitor (ET15-XXWA-1) Dimensions, 40 15” LCD Touchmonitor (ET15-XXWA-1) Specifications, 36 Expected Life Performance, AccuTouch, 39 Expected Life Performance, IntelliTouch, 37 G A About the Product, 1 About Touchmonitor Adjustments, 25 Accessing the VESA Mounting Interface, 19 AccuTouch Touchmonitor Specifications, 39 Agencies, 36 Auto Adjust, 27 B Back-light Lamp Life, 36 Base Bottom View, 5 Brightness, 27 C C1/C2/USER (Color), 27 Care and Handling of Your Touchmonitor, 34 C
O Operation, 25 Optical, AccuTouch, 39 Optical, IntelliTouch, 37 Optimizing the LCD Display, 18 OSD H-Position, 27 OSD Language, 27 OSD Menu Function, 27 OSD Time, 27 OSD V-Position, 27 Out of Range display, 29 Touchmonitor Safety, 33 Touchmonitor Specifications, 36 Touchpoint Density, AccuTouch, 39 Touchpoint Density, IntelliTouch, 37 Troubleshooting, 29 U Unpacking Your Touchmonitor, 3 USB Connection, 12 Using the On-Screen Display (OSD) Menus, 25 UXGA, 31 P V Phase, 27 Pixel Format, 36 Plus/Clockwis
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.
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. Mag-Tek is a registered trademark of Mag-Tek, Inc. Procomm is a registered trademark of Datastorm Technologies, Inc.
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.
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.
TABLE OF CONTENTS SECTION 1.
Figure 1-1.
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. A green LED (Light Emitting Diode) indicator on the Reader panel provides the operator with continuous status of the Reader operations.
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. Also listed is the pin list OEM version, P/N 21040077. Table 1-1.
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.
Port Powered Swipe Reader Figure 1-3.
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 PC with Com Port Procomm, Hyper Terminal, Mag-Tek Windows Drivers, or other RS-232 communications program MOUNTING 1.
Port Powered Swipe Reader Figure 2-1. Mounting Hole Dimensions For Surface 3. Mount the Reader. INSTALLATION AND TEST To install the Swipe Reader, perform the following steps: 1. 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. 2.
Section 2. Installation 6. Select 8 data bits, no parity, 1 stop bit. 7. 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 “+” (normal) or "!" (CDL) and ends with “?”.
Port Powered Swipe Reader 64
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. If the indictor does not come on, check the cabling and the Com Port. The LED is turned off during a card swipe and while the unit is transmitting.
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. DTR 150 ms Sign-on ID Transmission Burst 5 ms 10 ms Figure 3-1. Timing For ID Sign-on and Transmission Bursts.
Section 3. Operation Table 3-2 lists the available part number, firmware, and configuration. Table 3-2.
Port Powered Swipe Reader 68
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.
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. MagTek is a registered trademark of Mag-Tek, Inc.
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.
TABLE OF CONTENTS SECTION 1. OVERVIEW ..............................................................................................................77 PROBLEMS WITH CONTROLLING DEVICES .........................................................................77 BENEFITS OF A CONTROL LANGUAGE AND DRIVER .........................................................78 LANGUAGE OVERVIEW ...........................................................................................................79 Properties...........
enc_key..................................................................................................................................89 enc_key_sn............................................................................................................................89 enc_mode ..............................................................................................................................89 entry_echo ......................................................................................
DESCRIPTION...........................................................................................................................106 LANGUAGE FORMAT ...............................................................................................................107 Format Name .........................................................................................................................107 Format Template...........................................................................................
MT-95 HICO ENCODER............................................................................................................164 INDEX.............................................................................................................................................165 FIGURES Figure 1-1. MagTek Devices and Device Drivers for Windows......................................................76 Figure A-1. Properties Settings, Windows 95 ..................................................................
MTD MagTek Device Drivers for Windows Figure 1-1.
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.
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.
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.
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 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.
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. Open a device Access to the device is obtained by opening the comxx: port that the device was installed as.
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. The driver shuts down the device if required. Note In some cases with Windows 95, the Driver may not be closed properly.
Section 1. Overview Settings tab. This gives both the Friendly Name and the port name (COM<5-15>). It also 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. For Visual Basic, do the following: 'set error handling On Error Resume Next ‘open the port for binary access Open “\\.\micr+” For Binary Access Read Write As #1 If Err.
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 <> 0 Then <> End If Note File I/O interaction with the device is synchronous; the read operation will block until a response is received from the device or is returned by the driver (as in a property request).
Section 1. Overview 1. 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. 2. It can reset the device and prompt the user to repeat the action. Typically, this action is necessary if the device’s state or configuration has been corrupted, but is otherwise functioning correctly. 3.
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" installation feature in Windows NT/2000/XP. Refer to "Appendix A. Installation And Setup" for a full description of the installation procedure.
SECTION 2. PROPERTIES This section lists the properties that are used in the MagTek Drivers. Properties can be interrogated by issuing a get command and modified with a set command. Refer to Section 3. Commands for complete description and examples of all commands. The c_xxx properties are set by the driver and reflect the device’s capabilities. However, the c_xxx properties do not indicate the configuration of the device.
MagTek Device Drivers for Windows Property c_write c_wr_secure capitalize card_stat chk_account chk_amount chk_bankid chk_data chk_format chk_mod10 chk_number chk_routing chk_status chk_transit cmd_pending Access Description R 1 if the device can encode a magnetic card in either LoCo or HiCo; 2 if the device can encode a magnetic card in only the setting indicated in wr_coer R 0 if the device does not support secure mode; 1 if the device can switch between secure and non-secure mode (see wr_secure); 2
Section 2. Properties Property Access Description enc_key R/W Encryption key to use for the next encryption process (IntelliPIN): M for Master key S for Session key 0-3 for lower working keys A-J for upper working keys enc_key_sn R/W 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. The key serial number is specified in clear text (IntelliPIN).
MagTek Device Drivers for Windows Property Access Description offline_enc R/W Set to 1 to enable encode capability in standalone mode with keyboard; 0 prevents standalone encoding (MT-95). oper_tout R/W Operational timeout in seconds (15-255). (IntelliPIN) pin_blk_fmt R/W PIN block format (IntelliPIN): ansi (ANSI 9.8) or ibm (IBM 3624) pinfilldig R/W PIN fill digit (0..9, A..F) when pin_blk_fmt is ibm (IntelliPIN) port_name R Indicates the virtual port number (e.g.
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. DATA FORMAT All commands sent to the driver and all responses received are strings of printable ASCII characters delimited by . The driver will also accept as a delimiter.
MagTek Device Drivers for Windows Examples: 000000000011111111112222222222 012345678901234567890123456789 /read -00082 /get trk_enable 110 NOTATION CONVENTIONS The following conventions are used in the tables that follow. Fixed Size (Bold) Italic [] (a|b) Used to represent literals (symbols, exactly as sent or received from driver) Used to represent placeholders (variable fields) Expression parts in brackets are optional. The brackets are never a part of the syntax ASCII control character.
Section 3. Commands display Function Syntax Show a single message or two alternating messages on the device’s display. /display [x] 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 00 (“Welcome”). If x is omitted, the command uses the values of the msg1 and msg2 properties for the message texts.
MagTek Device Drivers for Windows event Function Syntax Errors Remarks Response to an unsolicited event notification. none none This response can occur when an unsolicited event, such as card inserted, occurs.
Section 3. Commands load_key Function Syntax Errors Load an encryption key into the device. /load_key n key n can be one of the following values: M – master key (key is in clear text) S – session key (key is encrypted under Master Key) 0 ... 3 – lower working keys (key is encrypted under Session Key) A ... J – upper working keys (key is encrypted under Session Key) key is the 16- or 32-character value of the key to be loaded.
MagTek Device Drivers for Windows rawrecv Function Syntax Errors Receive data from the device. /rawrecv /rawrecv 45 If a command is already pending. /rawrecv 82 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 rawrecv response.
Section 3. Commands rawsend Function Syntax Send arbitrary data to the device. /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: • \r is converted to • \n is converted to • \\ is converted to \ • \xhh is converted to a character with ASCII value hh (always two hex digits), e.g., \x20 is converted to a space.
MagTek Device Drivers for Windows read Function Syntax Read data from the device. /read [[x] y] 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. If y is omitted and the device supports a display, the text in the msg1 property is shown.
Section 3. Commands Read Arguments The optional argument x used in the read command specifies the type of data to read and y specifies the text to be displayed. The following table describes the recognized x arguments for the read command: Read Argument any card card_w_pin check Description Read any type of data. This option is equivalent to read without any arguments. Read magnetic stripe card. Display message (msg 1) if defined.
MagTek Device Drivers for Windows Read Argument chk_or_card key_press key_string 100 Description Read magnetic stripe card or check data. When a card or check is swiped through the device, the driver sends the respective response. Display a message (msg4) on the LCD screen, if available, and wait for a key on the keypad to be pressed. The device will wait for entry_tout seconds for the key press (by default 0 for no timeout).
Section 3. Commands Read Argument pin Description Collect PIN from cardholder and read PIN data from the device. The following properties may be set before issuing this command: • account_no – cardholder account number, including check digit, if required • amount – transaction amount in cents, without punctuation, if required • enc_key – (MSK mode only) encryption key to use: M for master, S for session, 0-3 for lower working keys, A-J for upper working keys.
MagTek Device Drivers for Windows reset Function Syntax Errors Remarks Reset the device. /reset none 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. Example To return a device to its initial state: Command Response /reset none set Function Syntax Set a property. /set prop val prop is one of the valid properties (R/W) shown in Section 2.
Section 3. Commands write Function Syntax Errors Data encode command. /write data /write 94 Encode is not supported on this device. /write 34 The data field was in the incorrect format. /write 82 The write command was canceled. /write 45 Device in wrong mode (e.g., if /read already issued) /write 60 Error during write operation (e.g.
MagTek Device Drivers for Windows 104
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.
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.
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. The maximum length of this property is 11 characters. The names can be repeated on subsequent templates.
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 ‘\’. Fields that are either to be parsed or ignored are contained within <>. The format rules string cannot exceed 1027 characters.
Section 4. Magnetic Card Data Parsing Field Type Literal Example ^ Non-ASCII literal \r, \n, \\, \xhh Optional choice (x|y|…) Optional field [x] Optional track {xy} Description 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. Specify an escape character or non-ASCII character.
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 specifies that customer name should contain alphabetic characters, spaces, and punctuation. The modifier may also be used with ignore-fields (i.e., <*>). If no modifier is provided, any type of characters is assumed.
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. Some examples are shown below; more are included with the drivers. In these examples, spaces are inserted between fields for readability; they should not be included in the actual rules.
MagTek Device Drivers for Windows fmt5_name "AAMVA" fmt5_template"%<*>?;<*>?{(+|%|#|!)<*>?}" fmt5_rules "{%^$$^^<*>? ;<*[6]>=<*>? {(+|!|#|%)<*[2]><*[16]> <*>?}}, {%^$^^<*>? ;<*[6]>=<*>? {(+|!|#|%)<*[2]><*[16]> <*>?}}" In the examples for CADL (Califo
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. The application issues /get PAN to the driver. The driver responds with /get PAN 1234567890074589. The application issues /get ExpDate to the driver.
MagTek Device Drivers for Windows 114
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. The application should wait until all keys have been released.
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" ' ' 4) a button named btnExit, should be set to Enabled and Visible with caption "Exit" ' ' ' 5) a text box named txtInfo, should be set to Visible, Enabled and MultiLine containing initial text of "Click the Start butto
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. a card reader) then the read command "/read" command can be is issued by itself. MSComm1.
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. txtInfo.Refresh Opening the port as File IO" ' 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" mode with ' the "Friendly Name" and asking for the virtual COM port number.
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.
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” _ & “card or Exit to quit." Else ' If we got here, then the device did not open correctly ' as a file IO so some kind of error handling is needed txtInfo.
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 #include #include #include
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]); if (drv_h == INVALID_HANDLE_VALUE) { ws = GetLastError(); printf("Can NOT open device : %s. Error : 0x%lx", "", ws); return ( stage); } { DCB dcb; GetCommState(drv_h, &dcb); dcb.BaudRate = CBR_9600; dcb.Parity = NOPARITY; dcb.ByteSize = 8; dcb.
Section 5. Example Applications NULL, // address of thread security attributes 0L, // initial thread stack size, in bytes (LPTHREAD_START_ROUTINE)input_thread,// addr of thread function NULL, // argument for new thread 0L, // creation flags 0-run immediately &retdw // address of returned thread identifier ), "Can't Create input thread" ); in_threadh = ret_h; Sleep(100); printf("\nTest Console started. (press <^Z> to terminate).
MagTek Device Drivers for Windows } #else gets(str); strcat(str, "\n"); ch = str[0]; #endif switch (ch) { case 0x1a: // - emergency exit printf("\n---Exit---\n");//@@ quit = TRUE; break; default: if (ch < 0x100) { BOOL rs; 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); #endif if (!rs) { ws = GetLastError (); if ( ws != ERROR_IO_PENDING) printf("DeviceIOControl (Write) Error : %i (0x%x)\n", ws, ws );
Section 5. Example Applications DWORD char char* read_len=0; wbuff[1]; p; 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.
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. The first part of this application note shows how to load an ActiveX component. The main program script shows how to interface with the OCX, the MTD Windows Driver, and the MagTek device (in this case the IntelliPIN).
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. (This demo application prompts the user to read a card. The program will continue to loop until the “Cancel” button is pushed.
MagTek Device Drivers for Windows 128
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. For example, the IntelliPIN Driver (IPIN.VXD) provides an interface vehicle for three different interface configurations.
MagTek Device Drivers for Windows INSTALLING DEVICE DRIVERS (W95/98/ME) File or Directory Name Device Friendly Name DESCRIPTION OEMSETUP.INF Installation descriptor file README.TXT Describes the disk file contents and provides installation procedures \W95_DRV Directory The following Windows 95/98/ME device drivers are located in this directory: DMAPLD.VXD DriverMagic Advanced Part Library DMVXD.VXD DriverMagic engine DMVXDD.VXD DriverMagic Windows 9x/ME Driver Part Kit GENERIC.
Appendix A. Installation and Setup General Notes: 1. 2. 3. 4. 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.
MagTek Device Drivers for Windows 5. 6. 7. 8. 9. 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. If the installation file cannot be found, click Browse and point to where the installation file (oemsetup.inf) is located; click the OK button on the dialog box.
Appendix A. Installation and Setup 1. 2. 3. 4. 5. 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.
MagTek Device Drivers for Windows Figure A-1. Properties Settings, Windows 95/98/ME Figure A-2.
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.
MagTek Device Drivers for Windows MAGCDFLT.DLL MAGCxxx.HLP (locale specific) MAGCxxx.DLL (locale specific) 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\. 8. Run the Registry Editor by clicking on Start button then select Run. Type REGEDIT into the text box and press the Enter key. 9.
Appendix A. Installation and Setup INSTALLING DEVICE DRIVERS (WNT) File or Directory Name Friendly Name DESCRIPTION OEMSETUP.INF Installation descriptor file README.TXT Describes the disk file contents and provides installation procedures \WNT_DRV Directory The following Windows NT device drivers are located in this directory: DMAPLD.DLL DriverMagic Advanced Part Library DMNTK.DLL DriverMagic engine DMNTKD.DLL DriverMagic Windows 9x/ME Driver Part Kit GENERIC.
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) or Mag-Tek Device Drivers (MTD) - uninstall, then click on the Add/Remove button. Re-boot the system after uninstalling the old version. Installing the Driver Binaries (WNT) To install the driver binaries (*.SYS), follow these steps: 1.
Appendix A. Installation and Setup INSTALLING DEVICE DRIVERS (W2000/XP) File or Directory Name Friendly Name DESCRIPTION MTD_KBH.INF Keyboard hook installation descriptor file MTD_KBH.SYS Keyboard hook Driver OEMSETUP.INF Installation descriptor file README.TXT Describes the disk file contents and provides installation procedures \I386 Directory Microsoft keyboard drivers \W2K_DRV Directory The following Windows 2000/XP device drivers are located in this directory: DMNTK.
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. The installation script provided cannot upgrade MTD from versions prior to version 1.10.
Appendix A. Installation and Setup 19. Click the “Next” button to advance to the next input screen. 20. Click on "Yes" to the "Digital Signature Not Found". 21. Click "Finish". 22. Click "Close" on the "System" dialog. 23. 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 before continuing or repeating the failed operation.
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. This is a non-disruptive hang-up. User should wait 10 seconds and do a hard reboot. Windows 2000/XP should recover without a system check or scan disk.) 16. Click "Finish". 17.
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. Select an unused COM port number for the device. Choose any number between 5 and 255 that is not used by other devices (if in doubt, check the Ports Control panel−it displays all COMx names currently used).
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" or mtcfg COM7 "IntelliPIN MICR Aux" "UsePort=AUX port on COM12" "FriendlyName=IntelliPIN AUX" Viewing the List of Configured Devices (WNT/2000/XP) Execute MTCFG with no command line arguments.
Appendix A.
MagTek Device Drivers for Windows 146 model is the full name of the device model to be added. The name should be enclosed in quotes if it contains spaces. Use "mtcfg -models" to see a list of models. The model names used by MTCFG are the ones specified in the [Models] section of the MTD installation script (OEMSETUP.INF). settings specifies one or more device settings in the form name=value. The syntax for these is identical to the syntax used when modifying the settings of an already installed device.
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.
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 [ [...]] 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.
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.
MagTek Device Drivers for Windows 150
APPENDIX B. COMMAND LIST SUMMARY This is a consolidated list of all available commands for the MagTek Windows Drivers. Command /cancel cmd /display [x] /echo string /event n data /get prop /load_key n key /rawrecv /rawsend x /rawxact x /read [[x] y] /reset /set prop val /ver /write data Description Cancel a command. cmd can be any of the transaction commands. Display a message or two alternating messages on the LCD screen. Driver test command. Response to an unsolicited event notification. Get a property.
MagTek Device Drivers for Windows 152
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.
MagTek Device Drivers for Windows 154
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 Port Powered RS-232 Insertion Reader MT-85 Encoder MT-95 Encoder The summary for each model contains a list of the commands properties supported.
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; also the IntelliPIN driver must be closed before the MICR+ driver is closed.
Appendix D. Device Driver Summaries MAGWEDGE SWIPE READER File Name Part Number 30037348 MAGWEDGE.VXD Friendly Name(s) MagWedge Remarks The driver cannot determine which tracks are supported on the device, so the c_tracks and trk_enable properties will always indicate 111.
MagTek Device Drivers for Windows MINIWEDGE MSR File Name Part Number MINIWEDG.VXD Friendly Name(s) MiniWedge Remarks 30037340 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.
Appendix D. Device Driver Summaries MICR+ CHECK READER & MSR File Name Part Number 30037349 MICRPLUS.VXD 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.
MagTek Device Drivers for Windows MINI MICR CHECK READER & MSR File Name Part Number 30037344 MINIMICR.VXD 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.
Appendix D. Device Driver Summaries PORT-POWERED RS-232 SWIPE READER File Name Part Number 30037346 MTPPSWIP.VXD Friendly Name(s) Port-powered swipe reader Remarks This driver supports all port-powered swipe readers.
MagTek Device Drivers for Windows PORT-POWERED RS-232 INSERTION READER File Name Part Number MTPPINSR.VXD Friendly Name(s) Port-powered insert reader Remarks 30037339 If events_on is enabled, the driver will send /event 1 M when the card is 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.
Appendix D. Device Driver Summaries MT-85 LOCO ENCODER Part Number 30037337 MT85.VXD Friendly Name(s) MT-85 Remarks The driver attempts to connect to the device by automatically scanning all connection modes.
MagTek Device Drivers for Windows MT-95 HICO ENCODER File Name Part Number MT95.
INDEX A Access to the device .................................... 82 account_no .................................................. 87 Action properties ......................................... 79 Adding a Keyboard Device (WNT) .......... 142 Adding a Serial Device (WNT)................. 143 Adding an ‘IntelliPIN MICR Aux’ Device (WNT) ................................................... 143 Adding Another Device Driver (W95/98) 131 Adding New Devices (WNT)......................
MagTek Device Drivers for Windows Device control language.............................. 78 Device Driver Summaries ......................... 155 Device, close the ......................................... 82 Device, interacting with .............................. 83 Device, methods of accessing ..................... 82 Device, obtaining access to ......................... 82 Device, open................................................ 81 Device, prepare for work.............................
MTCFG Utility (WNT), Using ................. 144 MTD (Mag-Tek Drivers) ............................ 77 N Non-interactive commands ......................... 80 Notation Conventions.................................. 92 O offline_enc................................................... 90 Open a device ........................................ 81, 83 oper_tout...................................................... 90 Operational Timeout (oper_tout) ................ 90 P Packets communication.......................
MagTek Device Drivers for Windows Use Port ............................................. 143, 148 Use the device ............................................. 81 Visual Basic Example ............................. 115 V wr_coer...................................................... 90 wr_secure ................................................... 90 Write Command ....................................... 103 Ver Command ........................................... 102 Version, Driver.........................