USBMSR Program Information

Version 1.04.00



This file contains the following information:

1) Overview

2) System requirements

3) Installation instructions

4) Operating instructions

5) Source Code

6) Release information



Overview:

The demo program, which is written in Visual Basic 6.0, 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
· Guide application developers in their application development by providing examples, in source code, of how to properly communicate with the device using the standard Windows APIs



System requirements:

This software will run on Windows 98, Me, 2000 and XP.



Installation instructions:

To install the demo program, run the setup.exe file and follow the instructions given on the screen.



Operating instructions:

To operate the demo program perform the following steps:

· Plug the device into a USB port on the host
· 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.  After this process is completed once, Windows will no longer request this process as long as the device is plugged into the same USB port.  The device driver that Windows will install for this device is the driver used for  HID devices and it is part of the Windows operating system.  When the dialog box pops up, follow the instructions given to you in the dialog box.  Sometimes Windows will find all the files it needs on its own without giving you any prompts.  Other times Windows will need to know the location of the files it needs.  If Windows prompts you for the file locations, insert the CD that was used to install Windows on your PC and point Windows to the root directory of the CD.  Windows should find all the files it needs there.
· Run the demo program.
· To read cards and view the card data, click on the Read Cards button and swipe a card when prompted to do so.
· When finished reading cards, close the dialog box.
· To send command to the device, click on the send commands button.
· Enter a command in the Message edit box.  All data entered should be in hexadecimal bytes with a space between each byte.  Enter the command number followed by the command data if there is any.  The application will automatically calculate and send the command data length for you.  For example, to send the GET_PROPERTY command for property SOFTWARE_ID enter 00 00.
· Press Enter or click on Send message to send the command and receive the result.
· The command request and the command result will be displayed in the Communications Dialog edit box.
· The Clear Dialog button clears the Communication Dialog edit box.



Source Code:

Source code for the demo program is located in the Source folder.  This is on disk 2 of diskette releases.  It can be used as a guide for application development.  It is commented well 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.



Release information:

Version   Programmer  Date        Description
1.0.0     Ted Logan   04/20/01    First Release
1.1.0     Ted Logan   07/09/01    Added support for insertion style readers
1.2.0     Ted Logan   09/17/03    Implemented Paul Deignan's fix that allows commands
                                  to be sent to keyboard emulation readers on Windows
                                  2000 and XP.
1.3.0     Ted Logan   02/10/05    Added support for MagnePrint Swipe reader.
                                  Added support for reset and hot re-plugging when
                                  sending commands to the device.
1.4.0     Ted Logan   04/04/05    Fixed bug introduced in version 1.3.0 that would cause
                                  the installation to fail on all versions of Windows
                                  earlier than XP service pack 2.


