---------------------------------
Softare: osrfx2LK Sample Driver
Authors: OSR Staff
Email: HWSupport@osr.com
---------------------------------
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 HWSupport@osr.com. 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 (Agreement) is a legal agreement
between you (either an individual or a single entity, referred to in this Agreement
as Recipient) and OSR Open Systems Resources, Inc. (OSR) for the OSR software that
accompanies this Agreement (as defined below). An amendment or addendum to this
Agreement may accompany the Software. YOU AGREE TO BE BOUND BY THE TERMS OF THIS
AGREEMENT BY INSTALLING, COPYING, OR OTHERWISE USING THE SOFTWARE. IF YOU DO NOT AGREE,
DO NOT INSTALL, COPY, OR USE THE SOFTWARE. OSR may, in its sole discretion, also provide
further releases of the Software or related information to Recipient hereunder, in
which case such further releases and related information shall also be covered
hereunder as Software.
OSR OPEN SYSTEMS RESOURCES LICENSE AGREEMENT
OSR Software: OSR USB FX2 Learning Kit Sample Driver
Accompanying this Agreement is the OSR software identified above, which may include
software and related documentation and information (collectively the Software).
The Software is protected by copyright laws and international copyright treaties,
as well as other intellectual property laws and treaties. The Software is licensed,
not sold.
GRANT OF LICENSE: This Agreement grants Recipient the following rights provided that
Recipient complies with all terms and conditions of this Agreement:
(a) OSR grants to Recipient a limited, non-exclusive, nontransferable, royalty-free
license to install, use and make derivative copies of the Software for the purpose of
learning how to write Windows drivers.
(b) OSR further grants to Recipient a limited, non-exclusive, nontransferable,
royalty-free license to make derivative works based on the Software for the purposes
of supporting Recipient-developed or licensed hardware device(s), provided that
(i) All OSR copyrights remain intact and as provided in all source files, (ii) OSR's
copyright appears anywhere Recipient's copyright appears, and (iii) Recipient's
additions or changes to the OSR Software provide significant added-value over and
above that provided by the Sofware as originally supplied by OSR.
(c) All other rights are reserved to OSR. Recipient shall not rent, lease, sell,
sublicense, assign, or otherwise transfer any portion of the Software. Recipient may
not reverse engineer, decompile or disassemble any portion of the Software, except and
only to the extent that this limitation is expressly prohibited by applicable law
notwithstanding this limitation.
TERM OF AGREEMENT: The term of this Agreement shall commence on the date accepted
by Recipient and shall continue until terminated by OSR at any time, with or without
cause.
SOFTWARE MAINTENANCE/UPDATES: OSR is not obligated to provide maintenance, technical
support or updates to Recipient for the Software provided to Recipient pursuant to this
Agreement.
INTELLECTUAL PROPERTY RIGHTS: All title and intellectual property rights in and to the
Software, and any copies of the Software that Recipient is expressly permitted to make herein,
are owned by OSR. If the Software contains documentation which is provided only in
electronic form, Recipient may print one copy of such electronic documentation. Recipient
may not copy the printed materials accompanying the Software. All rights not expressly
granted are reserved by OSR.