home *** CD-ROM | disk | FTP | other *** search
/ Dave Lowe: Master IDE Device Driver Intel PIIX 3 / Lowe_MasterIDEDeviceDriverIntelPIIX3.img / os2warp / README.TXT < prev    next >
Encoding:
Text File  |  1996-05-09  |  21.7 KB  |  615 lines
  1. ****************************************************************************
  2. ****************************************************************************
  3. *                                                                          *
  4. *       PIIX Bus Master IDE Drivers for OS/2*                              *
  5. *       Installation, Usage, and Release Note Information                  *
  6. *                                                                          *
  7. *       NOTE:                                                              *
  8. *            In this document, the term "PIIX" refers to any/all of the    *
  9. *            following Intel PCIset devices:                               *
  10. *            82371FB (PIIX1) or 82371SB (PIIX3) in conjunction with        *
  11. *            the following Intel PCIsets:                                  *
  12. *            430FX, 430HX, 430VX and 440FX                                 *
  13. *                                                                          *
  14. *            Also, the term "processor" refers to the Intel Pentium(R)     *
  15. *            and Pentium(R) Pro devices ONLY.                              *
  16. *                                                                          *
  17. ****************************************************************************
  18. ****************************************************************************
  19.  
  20. ***     Document Header Revision Information:
  21. ***         $Revision:   1.10  $
  22. ***         $Date:   May 09 1996 15:13:16  $
  23.         
  24. ****************************************************************************
  25. *       INTRODUCTION                                                       *
  26. ****************************************************************************
  27. This document describes the installation procedure and usage information
  28. for the PIIX Bus Master IDE Drivers for OS/2. Also included 
  29. are release notes describing any problems or issues with the software which 
  30. were known at the time of shipment.
  31.  
  32. ****************************************************************************
  33. *       CONTENTS OF THIS DOCUMENT                                          *
  34. ****************************************************************************
  35. This document contains the following sections:
  36.  
  37.     System Requirements
  38.     Installing the Software
  39.     Command Line Switches
  40.     Un-installing the Software
  41.     Troubleshooting
  42.     Identifying the Software Version Number
  43.     Contents of the Distribution Package
  44.     Storage Devices Supported
  45.     Release Notes
  46.  
  47. ****************************************************************************
  48. *       SYSTEM REQUIREMENTS                                                *
  49. ****************************************************************************
  50. Hardware:
  51.  
  52. 1.  The system must contain a supported processor and PIIX device as specified 
  53.     by the NOTE at the beginning of this document.
  54.  
  55. 2.  Ensure that a mouse is connected to the system.
  56.  
  57. 3.  Do not use any other add-in IDE (PCI or ISA) card in the system during 
  58.     installation.
  59.  
  60. Operating System:
  61.  
  62. 1.  IBM OS/2 2.x or Warp* 3.x must be installed on the system prior to
  63.     installing the driver.
  64.  
  65. 2.  Perform installation off of the on-board primary PIIX IDE interface.
  66.  
  67.  
  68. BIOS:
  69.  
  70. The BIOS must properly initialize the PIIX IDE interface for bus master
  71. operation.
  72.  
  73. ****************************************************************************
  74. *       INSTALLING THE SOFTWARE                                            *
  75. ****************************************************************************
  76. The following procedures for the installation of the PIIX Bus Master IDE
  77. Drivers for OS/2 (PIIXIDE.ADD and PIIXIDE.FLT) are specific only to the
  78. version of the drivers currently contained within this package.  
  79.  
  80. The following procedures assume that the OS/2 operating system was installed 
  81. properly on the target system, and that the standard PIIX IDE driver, 
  82. IBM1S506.ADD, and ATAPI CD-ROM filter driver, IBMIDECD.FLT, were used.
  83. If IBM1S506.ADD or IBMIDECD.FLT were not used, the drivers which replaced them
  84. should be un-installed before installing PIIXIDE.ADD and PIIXIDE.FLT.
  85. Furthermore, if IBM1S506.ADD and IBMIDECD.FLT were not originally installed
  86. on the target system, they should be installed first, and the system re-tested
  87. with them, before installing PIIXIDE.ADD and PIIXIDE.FLT.
  88.  
  89. By default, bus mastering is disabled on ATAPI CD-ROM devices.  For DMA capable
  90. CD-ROM devices, it should be enabled using command line parameters on the
  91. PIIXIDE.ADD line in CONFIG.SYS.  For example, if the CD-ROM device is
  92. connected as slave on the secondary IDE cable, bus mastering can be enabled
  93. by installing PIIXIDE.ADD as follows:
  94.  
  95.     BASEDEV=PIIXIDE.ADD /A:1 /U:1 /BM
  96.  
  97. Note: For special conditions that may apply to your system, please review the
  98.       RELEASE NOTES section, before installing the PIIX Bus Master IDE Drivers
  99.       for OS/2.
  100.  
  101. Automatic Install Procedure:
  102. ****************************
  103.  
  104. 1.  Run the install utility (INSTALL.EXE).  INSTALL.EXE copies PIIXIDE.ADD 
  105.     and PIIXIDE.FLT from the source directory to the target directory,
  106.     and changes the CONFIG.SYS file to install them.
  107.  
  108.     Command line format:   install [options]
  109.  
  110.     Command line options:
  111.  
  112.     /s:<source path>   Specifies the path to the directory containing
  113.            PIIXIDE.ADD.  The default source is the directory 
  114.            containing INSTALL.EXE.
  115.  
  116.     /t:<target path>   Specifies the path to the directory where 
  117.            INSTALL.EXE will copy PIIXIDE.ADD.  The default 
  118.            target is the \OS2 directory on the boot drive.
  119.  
  120.     /tu:<boot path>    Specifies the path to the directory containing
  121.            the CONFIG.SYS file.  The default directory is 
  122.            the root of the boot drive.
  123.  
  124.     /l:<logfile>       Specifies an optional log file.  If this option 
  125.            is used, the output will be redirected to the 
  126.            specified file, and INSTALL.EXE will run 
  127.            unattended.
  128.  
  129.     /p:<option>        Specifies a command line parameter for PIIXIDE.ADD.
  130.            The command line parameters will be inserted in the
  131.            PIIXIDE.ADD command line in the same order as the
  132.            corresponding /p:<option> parameters on the INSTALL
  133.            command line.
  134.  
  135.     /fp:<option>       Specifies a command line parameter for PIIXIDE.FLT.
  136.            The only command line parameter supported
  137.            by the ATAPI CD-ROM filter driver is /v (verbose).
  138.     
  139.     All command line parameters are optional.  The install utility will not 
  140.     install the PIIX Bus Master IDE drivers if it cannot detect one of the
  141.     supported Intel PCIsets.
  142.  
  143. 2.  Shutdown and reboot the system.
  144.  
  145.  
  146. Manual Install Procedure:
  147. *************************
  148.  
  149. 1.  Copy PIIXIDE.ADD and PIIXIDE.FLT to the \OS2 directory on the boot drive.
  150.  
  151. 2.  Make the following changes to the CONFIG.SYS file:
  152.  
  153.     Replace:
  154.     BASEDEV=IBM1S506.ADD
  155.  
  156.     with:
  157.     BASEDEV=PIIXIDE.ADD
  158.  
  159.     Replace:
  160.     BASEDEV=IBMIDECD.ADD
  161.  
  162.     with:
  163.     BASEDEV=PIIXIDE.FLT
  164.  
  165. 3.  Shutdown and reboot the system.
  166.  
  167.  
  168. Note: PIIXIDE.ADD auto-detects DMA capable hard disk drives and configures
  169.       them and the Intel PCIset for bus master DMA transfers.
  170.  
  171. ****************************************************************************
  172. *       PIIXIDE.ADD COMMAND LINE SWITCHES                                  *
  173. ****************************************************************************
  174.  
  175. 1.  Adapter Switch:            /A:x       where x is 0, 1, 2, or 3.
  176.  
  177.     This selects the adapter that will be referenced by subsequent
  178.     switches.
  179.  
  180. 2.  Unit Switch:               /U:x       where x is 0, 1, 2, or 3.
  181.  
  182.     This selects the unit that will be referenced by subsequent switches.
  183.  
  184. 3.  Bus Master Disable Switch: /!BM
  185.  
  186.     This will disable the bus master DMA feature.  This capability is fully
  187.     auto-detected by the driver.  If for any reason it is desirable to
  188.     disable bus master DMA transfers, this switch can be used on a per
  189.     adapter or per unit basis.  If used after a /A:x switch but prior to
  190.     any /U:x or /UNIT:x switch, then bus master DMA transfers will be 
  191.     disabled for all units on the adapter.  If the bus master disable switch 
  192.     follows both /A:x and /U:x (or /UNIT:x) switches, then bus master DMA 
  193.     transfers will be disabled only on the specified unit.
  194.  
  195. 4.  All other option switches are same as for the "IBM1S506.ADD" driver.
  196.  
  197. ****************************************************************************
  198. *       PIIXIDE.FLT COMMAND LINE SWITCHES                                  *
  199. ****************************************************************************
  200.  
  201.     All option switches are the same as for the "IBMIDECD.FLT" driver.
  202.  
  203. ****************************************************************************
  204. *     UN-INSTALLING THE SOFTWARE                                           *
  205. ****************************************************************************
  206. The following procedures are specific only to the version of the drivers 
  207. currently contained within this package.  These procedures assume that the 
  208. OS/2 operating system was installed properly on the target system, and that 
  209. the PIIX Bus Master IDE drivers, PIIXIDE.ADD and PIIXIDE.FLT, were properly
  210. installed according to the procedure described above.  
  211.  
  212. Automatic Un-install Procedure:
  213. *******************************
  214.  
  215. 1.  Run the un-install utility (UNINST.EXE).  UNINST.EXE removes 
  216.     PIIXIDE.ADD and PIIXIDE.FLT from the target directory, and changes the
  217.     CONFIG.SYS file to re-install IBM1S506.ADD and IBMIDECD.FLT.
  218.  
  219.     Command line format:   uninst [options]
  220.  
  221.     Command line options:
  222.  
  223.     /t:<target path>   Specifies the path to the directory containing
  224.            PIIXIDE.ADD.  The default target is the \OS2 
  225.            directory on the boot drive.
  226.  
  227.     /tu:<boot path>    Specifies the path to the directory containing
  228.            the CONFIG.SYS file.  The default directory is the
  229.            root of the boot drive.
  230.  
  231.     /l:<logfile>       Specifies an optional log file.  If this option is
  232.            used, the output will be redirected to the 
  233.            specified file, and UNINST.EXE will run 
  234.            unattended.
  235.  
  236.     All command line parameters are optional.
  237.  
  238. 2.  Shutdown and reboot the system.
  239.  
  240.  
  241. Manual Un-install Procedure:
  242. ****************************
  243.  
  244. 1.  Make the following changes to the CONFIG.SYS file:
  245.  
  246.     Replace:
  247.     BASEDEV=PIIXIDE.ADD
  248.  
  249.     with:
  250.     BASEDEV=IBM1S506.ADD
  251.  
  252.     Replace:
  253.     BASEDEV=PIIXIDE.FLT
  254.  
  255.     with:
  256.     BASEDEV=IBMIDECD.FLT
  257.  
  258. 2.  Delete PIIXIDE.ADD and PIIXIDE.FLT from the \OS2 directory on the boot 
  259.     drive.
  260.  
  261. 3.  Shutdown and reboot the system.
  262.  
  263. ****************************************************************************
  264. *       TROUBLESHOOTING                                                    *
  265. ****************************************************************************
  266.  
  267. Common Problems:
  268. ****************
  269.  
  270. 1.  Some ATAPI CD-ROM devices require vendor-specific filter drivers.  These
  271.     drivers should be loaded in conjunction with the PIIX Bus Master IDE
  272.     driver, PIIXIDE.ADD.
  273.  
  274. 2.  Verify the length of the cables that are being used to connect the IDE or
  275.     ATAPI devices to the primary and secondary PIIX IDE interfaces.  The
  276.     length of these cables from END-TO-END should not exceed 18 inches
  277.     (0.46 m).  Furthermore, the capacitance of the cable should not exceed
  278.     35 pF.
  279.  
  280. ****************************************************************************
  281. *        IDENTIFYING THE SOFTWARE VERSION NUMBER                           *
  282. ****************************************************************************
  283. The following procedure uses the SEEVER.EXE utility to identify the version
  284. number and build date of the PIIX Bus Master IDE drivers.  This procedure
  285. assumes that the SEEVER.EXE utility and the driver files (PIIXIDE.ADD and 
  286. PIIXIDE.FLT) are in the same working directory.
  287.  
  288. 1.  From within OS/2, open the folder containing the PIIX Bus Master IDE
  289.     driver.
  290.  
  291. 2.  Double click on the SEEVER.EXE icon.
  292.  
  293. By default, SEEVER will display the version and build information of
  294. PIIXIDE.ADD. To display the version and build information of the ATAPI CD-ROM
  295. filter driver, it must be explicitly specified on the SEEVER command line.
  296. Open an OS/2 Window and from within the directory containing the PIIX Bus
  297. Master IDE Drivers kit, enter the following command:
  298.  
  299.     SEEVER PIIXIDE.FLT
  300.  
  301. ****************************************************************************
  302. *       CONTENTS OF THE DISTRIBUTION PACKAGE                               *
  303. ****************************************************************************
  304. The distribution package contains the following items:
  305.  
  306. 1.  Driver Software:
  307.     PIIXIDE.ADD
  308.     PIIXIDE.FLT
  309.  
  310. 2.  Install Utility:
  311.     INSTALL.EXE
  312.  
  313. 3.  Un-install Utility:
  314.     UNINST.EXE
  315.  
  316. 4.  Reassume File:
  317.     README.TXT
  318.  
  319. 5.  Version Identification Utility:
  320.     SEEVER.EXE
  321.  
  322. ****************************************************************************
  323. *       STORAGE DEVICE SUPPORT                                             *
  324. ****************************************************************************
  325. In general, bus mastering is possible for ATA fixed disk and ATAPI devices
  326. that support the following DMA timing modes:
  327.  
  328.     Multi-Word DMA Mode 1
  329.     Multi-Word DMA Mode 2
  330.  
  331. These devices will be accessed by the driver in either a bus mastering or a
  332. PIO-fashion, depending on the specific transfer conditions.
  333.  
  334. Devices that do not support the DMA timing modes listed above, or whose PIO
  335. timings are faster than their DMA timings, will be accessed in a PIO-fashion
  336. ONLY.
  337.  
  338. For more information and a list of tested devices, see the RELEASE NOTES
  339. section of this document.
  340.  
  341. ****************************************************************************
  342. *       RELEASE NOTES                                                      *
  343. ****************************************************************************
  344.  
  345. ****************************************************************************
  346. *       RELEASE NOTE OVERVIEW                                              *
  347. ****************************************************************************
  348. The release notes describe the current, known state of the PIIX Bus Master 
  349. IDE Driver for IBM OS/2.  The release notes are divided into three sections:
  350.  
  351.         General Release Information
  352.         Release-Specific Troubleshooting Information
  353.         Release Testing Information
  354.  
  355. ****************************************************************************
  356. *       GENERAL RELEASE INFORMATION                                        *
  357. ****************************************************************************
  358.  
  359. ATAPI tape drives have not been tested with this driver and are not supported
  360. in the current release of this driver.
  361.  
  362. ****************************************************************************
  363. *       RELEASE-SPECIFIC TROUBLESHOOTING INFORMATION                       *
  364. ****************************************************************************
  365. Verifying the installation of the driver and other generic troubleshooting is
  366. discussed in the "TROUBLESHOOTING" section above.  This section describes
  367. release-specific troubleshooting.
  368.  
  369. This section contains a list of known problems with certain system
  370. configurations discovered during testing of the driver.  A list of all
  371. storage devices tested with the driver is given below in the "RELEASE
  372. TESTING INFORMATION" section of this document.
  373.  
  374. If the solution given to any of the problems listed below is to un-install the
  375. driver, follow the un-installation instructions outlined above in the
  376. section "UN-INSTALLING THE SOFTWARE".
  377.  
  378.  
  379.     Issue:      If four devices are connected to the PIIX IDE controller, and 
  380.         the verbose switch is present on the PIIXIDE.ADD command line
  381.         in CONFIG.SYS, the system may hang during boot.
  382.  
  383.     Solution:   Do not use the verbose switch on the PIIXIDE.ADD command line
  384.         if four devices are connected to PIIX IDE.
  385.  
  386.  
  387.     Issue:      If two ATAPI CD-ROM devices are connected on the same cable
  388.         and the BM command line switch is used to turn on bus mastering
  389.         on both of them, bus mastering will be enabled only on the slave
  390.         CD-ROM drive if the following command line is used:
  391.  
  392.         BASEDEV=PIIXIDE.ADD /A:? /U:0 /BM /U:1 /BM
  393.  
  394.     Solution:   Whenever two DMA capable ATAPI CD-ROM devices are connected
  395.         on the same cable, use the following command line syntax to
  396.         enable bus mastering on both devices:
  397.  
  398.         BASEDEV=PIIXIDE.ADD /A:? /U:1 /BM /U:0 /BM
  399.  
  400.  
  401.     Issue:      The driver is not compatible with EZ-Drive floppy boot
  402.                 protection option. 
  403.  
  404.     Solution:   If EZ-Drive is installed on the boot drive, the floppy boot
  405.                 protection option must be disabled prior to installing the
  406.                 PIIX Bus Master IDE Drivers for OS/2.  If, for any reason,
  407.                 the floppy boot protection can not be disabled, the PIIX
  408.                 Bus Master IDE Drivers for OS/2 should not be installed.
  409.                                 
  410.  
  411.     Issue:      The system does not operate reliably or fails to boot when the
  412.                 driver is installed. 
  413.  
  414.     Solution:   Un-install the driver.
  415.                                 
  416.  
  417.     Issue:      The driver does not support the following fixed disk drives:
  418.  
  419.                     Maxtor 7245AV
  420.                     Maxtor 71626AP
  421.                     Maxtor 71260AT
  422.                 
  423.     Solution:   Do not install the driver in configurations equipped with
  424.                 these fixed disk drives.
  425.  
  426.  
  427.     Issue:      The driver does not support Quantum Maverick drives in DMA
  428.                 mode.
  429.  
  430.     Solution:   Force the drive into PIO-mode operation by using PIIXIDE.ADD
  431.                 command line parameters in the CONFIG.SYS.  For example, if
  432.                 this drive is set up as a slave on the primary cable, the
  433.                 following command line should be used to load the driver:
  434.  
  435.                 BASEDEV=PIIXIDE.ADD /A:0 /U:1 /!BM
  436.  
  437.                 NOTE: For a description of the command line parameters see the
  438.                       above section titled "Command Line Switches".
  439.  
  440.  
  441.     Issue:      The driver does not support Maxtor 7850AV and 7840AV drives
  442.                 with the multi-sector option enabled.
  443.  
  444.     Solution:   Turn off the multi-sector feature using PIIXIDE.ADD command
  445.                 line parameters in the CONFIG.SYS.  For example, if the drive
  446.                 is the master on the secondary cable, the following command
  447.                 line should be used:
  448.  
  449.                 BASEDEV=PIIXIDE.ADD /A:1 /U:0 /!SMS
  450.  
  451.                 NOTE: For a description of the command line parameters see the
  452.                       above section titled "Command Line Switches".
  453.  
  454.  
  455.     Issue:      The driver does not support the Conner CFS425A drive in DMA
  456.                 mode.
  457.  
  458.     Solution:   Force the drive into PIO-mode operation by using PIIXIDE.ADD
  459.                 command line parameters in the CONFIG.SYS.  For example, if
  460.                 this drive is set up as a slave on the primary cable, the
  461.                 following command line should be used to load the driver:
  462.  
  463.                 BASEDEV=PIIXIDE.ADD /A:0 /U:1 /!BM
  464.  
  465.                 NOTE: For a description of the command line parameters see the
  466.                       above section titled "Command Line Switches".
  467.  
  468.     Issue:      The system does not recognize the CDD44E TEAC CD-ROM drive.
  469.  
  470.     Solution:   Prevent the driver from changing device settings by using
  471.                 PIIXIDE.ADD command line parameters in the CONFIG.SYS.
  472.                 For example, if this drive is connected to the secondary cable,
  473.                 the following command line should be used to load PIIXIDE.ADD:
  474.  
  475.                 BASEDEV=PIIXIDE.ADD /A:1 /!BM
  476.  
  477.                 NOTE: This work around will disable bus mastering for the
  478.                       devices connected on the same cable with the CD-ROM drive.
  479.  
  480.                       For a description of the command line parameters see the
  481.                       above section titled "Command Line Switches".
  482.  
  483. ****************************************************************************
  484. *       RELEASE TESTING INFORMATION                                        *
  485. ****************************************************************************
  486. This section contains information on how the driver was tested, including a
  487. list of storage devices used in testing.  If any problems are encountered
  488. running the driver with devices listed below, refer to the
  489. "RELEASE-SPECIFIC TROUBLESHOOTING INFORMATION" section above for more
  490. detailed information.
  491.  
  492. The following fixed disk drives were tested with the PIIX Bus Master IDE
  493. Driver:
  494.  
  495. Conner*:
  496.  
  497.     CFA540A
  498.     CFA850A 
  499.     CFA1275A
  500.     CFS425A
  501.     CFS850A
  502.     CFS1275A
  503.  
  504. IBM*:
  505.  
  506.     DALA-3540
  507.     DALA-31080
  508.  
  509. Maxtor*:
  510.  
  511.     7245AT
  512.     7540AV
  513.     71260AT 
  514.     71626AP 
  515.  
  516. Quantum*:
  517.  
  518.     FB540A
  519.     FB640A
  520.     FB1080A
  521.     FB1280A
  522.     LPS270A
  523.     TRB420A
  524.     TRB850A
  525.  
  526. Seagate*:
  527.  
  528.     ST5660A
  529.     ST5850A
  530.     ST51080A
  531.     ST31220A
  532.     ST31270A
  533.     ST32140A
  534.  
  535. Western Digital*:
  536.  
  537.     AC2420
  538.     AC2510
  539.     AC2700
  540.     AC2850
  541.     AC31000
  542.     AC31600
  543.     AC21000
  544.  
  545.  
  546. The following ATAPI CD-ROM drives were tested with the PIIX Bus Master IDE
  547. Driver:
  548.  
  549. Gallant*:
  550.  
  551.     GCD-R542B 
  552.  
  553. Hitachi*:
  554.  
  555.     7730
  556.  
  557. Matshita*:
  558.     CR581
  559.  
  560. Mitsumi*:
  561.  
  562.     FX001DE
  563.     FX400 
  564.     FX400B
  565.     FX400C
  566.     FX600S
  567.     FX600T
  568.  
  569. NEC*:
  570.  
  571.     CDR260R
  572.     CDR271
  573.     CDR272
  574.  
  575. Panasonic*:
  576.  
  577.     CD-574B
  578.  
  579. Philips*:
  580.  
  581.     CM207
  582.  
  583. Sanyo*:
  584.     
  585.     CRD-S54P
  586.  
  587. Sony*:
  588.  
  589.     CDU55E
  590.     CDU76E
  591.     CDU77E
  592.  
  593. TEAC*:
  594.  
  595.     CD44E
  596.     CD56E
  597.  
  598. Torisan*:
  599.  
  600.     S1G 
  601.     C3G 
  602.  
  603. Toshiba*:
  604.  
  605.     XM5302B
  606.  
  607. Vertos*:
  608.  
  609.     V300HPD
  610.  
  611. Wearnes*:
  612.  
  613.     CDD-120
  614.     CDD-220 
  615.