                         1-Wire Public Domain Kit

                           Parallel Port Build 
                              Version 3.10

Introduction
------------

   The port was targeted for Windows and tested on a machine running 
   Windows XP.   The provided workspace file will build the example 
   programs distributed in the 3.10 1-Wire Public Domain release using 
   the DS1410E or DS1410D 1-Wire adapter.

   The new link file for the Parallel Port build is:
   
       llpwin32.c


QuickStart
------------

   1)  Determine which Microsoft 32-bit operating system you will be 
        using.
   2)  See the "Driver Installation" for instructions on how to install the 
        appropriate device driver for your operating system.
   3)  Reboot computer.
   4)  Connect the DS1410E (or DS1410D) to the computer.  Either snap 
        in an iButton or appropriate connector cable to the DS1410E.
   5)  Run the examples listed below at a command prompt (a.k.a., a "windows" 
        DOS prompt).  Type in the name of the program and the appropriate 
        LPT number such as:

        TstFind 1

    

Driver Installation
------------

   Two Microsoft 32-bit drivers (and their source files) are included in this 
   example build.  The first is the DS1410D.sys driver and is for 
   Windows NT-based operating systems such as Windows XP, 2000, 
   and NT.  The second is the VSauthD.vxd virtual device driver.  It is to be 
   installed on non-NT-based operating systems, such as Windows ME, 98, 
   and 95.  Their source files can be found in the Drivers\Source directory and their 
   binaries can be found in the Drivers\Bin directory.

   Installation:
   These are installed correctly by default through the 1-Wire Drivers installation 
   package found on iButton.com.

   Manual Installation for DS1410D.SYS:  
   1)  Copy DS1410D.SYS to the %WIN\SYS%\Drivers directory.
        (Note: %win\sys% stands for the system directory, usually
        C:\Windows\System or C:\WinNT\System32 or 
        C:\Windows\System32)
   2)  Create the proper registry keys for the part.  We have provided 
        a simple .reg file that will do this for you. In the Drivers\Reg folder,
        simply right-click on the InstallWinNT2KXP.reg file and choose 
        "Merge".  This will update the registry appropriately for you.
        Please note that doing the same with the UnInstallWinNT2KXP.reg 
        file will delete the keys (to be used in an uninstall process).
   3)  Reboot the computer for the changes to take effect.
   
   Manual Installation for VSauthD.vxd:  
   1)  Copy VSauthD.vxd to the %WIN\SYS% directory.
   2)  Reboot the computer for the changes to take effect.


   For more info on the parallel port drivers files and writing your own 
   custom install program with them, please see White Paper 6:
   "1-Wire Drivers Installation Guide for Windows".  It can be downloaded 
   from:
   http://www.maxim-ic.com/appnotes.cfm/appnote_number/1740

   
Examples 
--------

   atodtst
   counter
   coupler
   debit
   debitvm
   fish
   gethumd
   humalog
   initcopr
   initcoprvm
   initrov
   initrovvm
   memutil
   mweather
   ps_check
   ps_init
   sha_chck
   sha_init
   shaapp
   swtduo
   swtloop
   swtmain1c
   swtmulti
   swtsngl
   temp
   thermodl
   thermoms
   tm_check
   tm_init
   tstfind


Tool Versions
-------------

   Microsoft Visual C++ 6.0 Standard Edition was used in
   building the applications executables.
        
    
General Notes
-------------

   - Relevant 1-Wire Information:
     http://www.ibutton.com
     http://www.maxim-ic.com/

   - 1-Wire Discussion Forum:
     http://discuss.dalsemi.com

