                       WinUSB 32-bit VC Build 
                        1-Wire Public Domain 
                        V3.11 Beta2 R2 11/11/2011

This is a build of all of the current (3.11) 1-Wire Public
Domain demo applications using interface modules to 
communicate directly with the DS2490 based USB adapters 
such as the DS9490R/DS9490B on Windows 32-bit platforms 
that support WinUSB, Microsoft's generic userland USB driver.
The platforms that support WinUSB at the time of this writing are:
(Windows XP SP2/3, Vista, 7, and 2008 Server).

This build will be of most interest to security-conscious applications
such as Software Authorization that do not want to go through intermediate 
software layers (DLLs) to access the USB adapters.  

This build is not strictly a 'userial' or 'general' build as
defined in the 1-Wire Public Domain kit but is somewhere
in between.  The interface modules were written in a way to take
advantage of the features of the DS2490 chip which has built-in
1-Wire search capabilities. For example, instead of constructing
the 1-Wire search using single 'bit' operations, it translates
owFirst directly into calls to Microsoft's WinUSB API/Driver.
The main interface modules are:

  winusbds2490.h
  winusbds2490.c
  winusblnk.c
  winusbnet.c
  winusbtran.c
  winusbses.c

Note that the port name to provide on the command line to the demos 
is in the format DS2490-X where X is a number starting at 0. 
This is the USB enumeration number. For example, running the demo 
"tstfind" on a command-line on the first USB port device enumerated would 
entail typing the following string (followed by tapping the "return" key):

tstfind.exe ds2490-0

These other files are also required for most applications:

  crcutil.c
  ioutil.c
  owerr.c
  ownet.h

The different demos are documented in the main 1-Wire Public Domain
3.XX kit that can be found here:
  http://www.ibutton.com/software/1wire/wirekit.html

The binaries for the demos can be found in the 'release' folder.

Installation
============

Installation of the WinUSB service for DS2490-based adapters is simple. 
When plugging in a USB adapter for the first time, just point the "Hardware 
Install" wizard to the appropriate directory (either "Install\i386" 
for 32-bit operating systems or "Install\AMD64" directory for x64 operating 
systems).

Installation is also explained in 
White Paper #6: 1-Wire Drivers Installation Guide for Windows
  http://www.maxim-ic.com/appnotes.cfm/appnote_number/1740/ln/en


Compiling Programs
==================
To compile the example programs, simply load the Microsoft Visual Studio 2005 
solution file (double-click on the winusbvc.sln).  Then, follow the instructions 
found in the ..\..\lib\other\WinUSB directory called "How_To_Compile.pdf".