fx2readme.txt

这是一个简单的usb基于WDM的驱动源码及测试应用程序。固件采用fx2构架的usb控制器。

---------------------------------
Softare:	osrfx2LK Sample Driver
Authors:	OSR Staff
Email:		[e-mail]
---------------------------------

PACKAGE CONTENTS
================

This ZIP archive includes source and binaries for the USBFX2LK WDM driver
and test applications for use with OSR's USB FX2 Learning Kit.  If you
don't already have the hardware associated with this driver, you can find
it for sale (a cost) in the OSR Online store (www.osronline.com, select
the STORE section).


When unzipped, you should have the following directory structure:

.\install
 
 Includes everything necessary to install the driver included in the kit and 
 exercise the functionality of the board. Checked and free versions of the 
 driver are available, along with OSRBULK.EXE for use in testing bulk transfers
 on the board and USBFXTEST for the various other features of the board.

.\src

 Includes the source code for the USBFX2 driver and its test applications

.\src\bulkapp

 Source for the OSRBULK application. This application is a modified version
 of the bulk test application supplied with the DDK.

.\src\driver

 Source for the WDM driver supplied with the board. Support is provided 
 for all of the advanced features you would expect in a USB WDM driver, 
 including Wait/Wake, Selective Suspend, and Perfmon integration.

.\src\inc

 Include files shared across the driver and applications

.\src\test

 Source for the USBFXTEST application that shows the use of various IOCTLs
 supported by the driver.


DESCRIPTION
===========
The OSRFX2LK driver demonstrates sample techniques for developing a Windows
WDM USB driver.  You can find the the documentation for the associated hardware
(describing the various endpoints and vendor specific commands in the hardware
docs at:

http://www.osronline.com/hardware/OSRFX2_32.pdf

Please refer to the above documentation for any hardware questions.

SUPPORT
=======
If you have general questions about this driver or general WDM USB development
issues, please direct them to the NTDEV list that we administer.  If you're
not already a member, you'll want to join this highly interactive peer-support
community resource.  You can find information about NTDEV (and it's associated
file-system related list NTFSD) at:

http://www.osronline.com/page.cfm?name=ListServer


If you find bugs in this driver, we will welcome receiving a clear, thorough,
bug report describing the expected and witnessed behavior of the driver, as well
as instructions from you describing how we can reproduce the problem.  Feel
free to cite source code line number, or to send us sample code that will help
us reproduce the problem.  Send ALL this to [e-mail].  NOTE: PLEASE,
only send detailed, specific, bug reports to this alias.  Please do not send
general driver-related questions to this alias (they will be ignored).



WARRANTY AND LIMITATION OF LIABILITY
====================================
This sofware is supplied for instructional purposes only.

OSR Open Systems Resources, Inc. (OSR) expressly disclaims any warranty
for this software.  THIS SOFTWARE IS PROVIDED  "AS IS" WITHOUT WARRANTY
OF ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING, WITHOUT LIMITATION,
THE IMPLIED WARRANTIES OF MECHANTABILITY OR FITNESS FOR A PARTICULAR
PURPOSE.  THE ENTIRE RISK ARISING FROM THE USE OF THIS SOFTWARE REMAINS
WITH YOU.  OSR's entire liability and your exclusive remedy shall not
exceed the price paid for this material.  In no event shall OSR or its
suppliers be liable for any damages whatsoever (including, without
limitation, damages for loss of business profit, business interruption,
loss of business information, or any other pecuniary loss) arising out
of the use or inability to use this software, even if OSR has been
advised of the possibility of such damages.  Because some states/
jurisdictions do not allow the exclusion or limitation of liability for
consequential or incidental damages, the above limitation may not apply
to you.



LICENSE
=======

IMPORTANT-READ CAREFULLY: This License Agreement (揂greement