home *** CD-ROM | disk | FTP | other *** search
/ DOS/V Power Report 1997 August / VPR9708B.ISO / DRIVER / HP / WIN95 / Sjc_v21 / Disk1 / ASPI416.TXT < prev    next >
Text File  |  1996-06-06  |  15KB  |  398 lines
  1. ASPI416.DOC
  2. ------------
  3.  
  4. Introduction:
  5. This document details information about ASPI416.SYS.  ASPI416.SYS
  6. is a DOS ASPI Manager for the SYM53C416 series of chips from Symbios
  7. Logic, and complies with the Advanced SCSI Programming Interface
  8. (ASPI) for DOS specification.  ASPI416.SYS must be loaded in the
  9. CONFIG.SYS file before any other ASPI drivers are loaded that may
  10. require the ASPI interface.  For example: both CDROM.SYS and
  11. SCSIDISK.SYS require an ASPI interface, as provided by ASPI416.SYS.
  12.  
  13.  
  14. Hardware Requirements:
  15. -----------------------
  16.     o Intel 80386SX based system or higher
  17.     o SYM53C416 SCSI Host Adapter
  18.  
  19.  
  20. Software Requirements:
  21. -----------------------
  22.     o DOS 5.0 or Higher
  23.  
  24.  
  25. Software Compatibility:
  26. ------------------------
  27.     o Microsoft Windows 3.1 or 3.11
  28.     o Microsoft Windows for Workgroups 3.11
  29.  
  30.  
  31. Features:
  32. ----------
  33.     o Releases initialization code for smaller runtime size
  34.     o Has smaller runtime size that DOSCAM.SYS
  35.     o Supports the following SCSI controller chips:
  36.         SYM53C416
  37.  
  38.     o Performs synchronous negotiation (including FAST-20)
  39.     o Allows Disconnect/Reselect
  40.     o Supports single-threaded I/O
  41.     o Does not support tagged command queuing.
  42.     o Does not support SCSI Command Linking.
  43.  
  44.  
  45. Installation:
  46. --------------
  47.     1. Use the COPY command to copy the appropriate driver from the
  48.        SDMS SCSI Drivers disk to your boot disk.
  49.  
  50.     2. Add this line to your system's CONFIG.SYS file:
  51.         DEVICE=C:[PATH]ASPI416.SYS
  52.  
  53.  
  54. Command Line Options:
  55. ----------------------
  56. The ASPI416.SYS device driver has several configurable settings which can
  57. be changed via switches on the command line.
  58.  
  59. All references in the USAGE descriptions to "path" refer to the adapter number.
  60. All references in the USAGE descriptions to "id" refer to the SCSI device ID.
  61. The below options use the following conventions:
  62.     []  items in brackets are optional
  63.     *   items followed by a "*" means repeat 0 or more times
  64.  
  65.  
  66. * * * * * IMPORTANT * * * * * * * IMPORTANT * * * * * * * IMPORTANT * * * * * *
  67. *                                                                             *
  68. * No spaces are allowed in specifying any of the below command line options.  *
  69. * Spaces should ONLY be used between different command line options.          *
  70. *                                                                             *
  71. * * * * * IMPORTANT * * * * * * * IMPORTANT * * * * * * * IMPORTANT * * * * * *
  72.  
  73.  
  74. Using the /ASK Option:
  75. -----------------------
  76.  
  77.     Usage:
  78.         /ASK
  79.  
  80.     This option prompts the user at system boot-up whether to load ASPI416.SYS
  81.     or not.
  82.  
  83.     For example, if you wish to be prompted to load the driver when you boot,
  84.     the line in CONFIG.SYS that loads ASPI416.SYS would look like this:
  85.  
  86.     DEVICE=C:[PATH]ASPI416.SYS /ASK
  87.  
  88. Using the /SYNCH_RATE ( or /SR ) Option:
  89. -----------------------------------------
  90.  
  91.     Usage:
  92.         /SYNCH_RATE=n<path[:id]>[,n<path[:id]>]*
  93.         (n = 0, 5, 10, or 20)
  94.  
  95.     This sets the maximum synchronous transfer rate (in mega transfers per
  96.     second) to negotiate with a particular device.  The allowable values for
  97.     this setting are 0, 5, 10, and 20 mega transfers per second, if the
  98.     adapter is capable of the specified speed.  The 416 supports 10  mega
  99.     transfers per second.  To turn off synchronous transfers for a particular
  100.     device, "0" should be specified.  The value set by this option only defines
  101.     the maximum transfer rate that will be attempted to negotiate.  This means
  102.     that the device must also be capable of this speed, and so we can't
  103.     guarantee that the given rate will succeed.  The default value is the
  104.     fastest transfer rate that is supported by a particular host adapter.
  105.  
  106.     For example, if you want to turn off synchronous transfers to
  107.     HA=0, ID=3, the line in CONFIG.SYS that loads ASPI416.SYS would
  108.     look like this:
  109.  
  110.     DEVICE=C:[PATH]ASPI416.SYS /SYNCH_RATE=0<0:3>
  111.  
  112.     As another example, if you want to set synchronous transfers to 10 mega
  113.     transfers per second on all devices on adapter 1, the line in CONFIG.SYS
  114.     that loads ASPI416.SYS would look like this:
  115.  
  116.     DEVICE=C:[PATH]ASPI416.SYS /SYNCH_RATE=10<1>
  117.  
  118.  
  119. Using the /DISCONNECT ( or /DC ) Option:
  120. -----------------------------------------
  121.  
  122.     Usage:
  123.         /DISCONNECT=n<path[:id]>[,n<path[:id]>]*
  124.         (n = ON or OFF)
  125.  
  126.     SCSI devices have the ability to disconnect from the bus during an I/O
  127.     transfer.  This option is used to allow (or not allow) a device to
  128.     disconnect during an I/O.  If a particular adapter has parity checking
  129.     disabled, then all devices on that adapter that do not generate parity
  130.     must be forced to have disconnects disabled (OFF) by using this option,
  131.     since the /PARITY option will not change the disconnect states for any
  132.     device on that adapter.  See the /PARITY option for more information.
  133.  
  134.     Valid options are "ON" (allow disconnects) and "OFF" (do not allow
  135.     disconnects).  The default for all devices is "ON".
  136.  
  137.     For example, if you would like to disable disconnects on the device at
  138.     HA=0, ID=2, then the line in CONFIG.SYS that loads ASPI416.SYS would
  139.     look like this:
  140.  
  141.     DEVICE=C:[PATH]ASPI416.SYS /DISCONNECT=OFF<0:2>
  142.  
  143.  
  144. Using the /PARITY ( or /P ) Option:
  145. ------------------------------------
  146.  
  147.     Usage:
  148.         /PARITY=n<path[,path]*>[,n<path[,path]*>]*
  149.         (n = ON or OFF)
  150.  
  151.     The SYM53C416 chip is capable of enabling or disabling the SCSI bus
  152.     data integrity checking feature know as "parity".  Some non-SCSI
  153.     compliant devices sold as SCSI devices do not generate parity, and
  154.     therefore, this option may be used to disable parity checking.  The
  155.     SYMC53416 chips will always generate parity (for outputs), but may
  156.     optionally check the parity (for inputs).  Valid options are "ON"
  157.     (check parity) and "OFF" (do not check parity).  The default for all
  158.     devices is "ON", which enables parity checking for all devices.
  159.  
  160.     Note:  When disabling parity checking, it is necessary to disable
  161.     disconnects for any devices that do not generate parity, as the
  162.     SYM53C416 chips cannot disable parity checking for that device during
  163.     the reselection phase.  Please refer to using the /DISCONNECT option
  164.     for more information on how to disable disconnects for a device.  If a
  165.     device does not generate parity, and it disconnects, the I/O will never
  166.     complete as the reselection will never complete.
  167.  
  168.     For example, if you want to turn off parity checking on host adapter
  169.     number 0, the line in CONFIG.SYS that loads ASPI416.SYS would look like
  170.     this:
  171.  
  172.     DEVICE=C:[PATH]ASPI416.SYS /PARITY=OFF<0>
  173.  
  174.  
  175. Using the /HOST_ID ( or /ID ) Option:
  176. --------------------------------------
  177.  
  178.     Usage:
  179.         /HOST_ID=n<path[,path]*>[,n<path[,path]*>]*
  180.         (n = SCSI ID for specified path (adapter) )
  181.  
  182.     This option enables the user to alter the SCSI ID that the host adapter
  183.     will use.  On an 8 bit SCSI card, SCSI ID's 0..7 are available, on a 16
  184.     bit card, SCSI ID's 0..15 are available.  This option will not allow the
  185.     user to select a SCSI ID that is already in use by some other device on
  186.     the SCSI bus.  It is recommended that SCSI ID's 8..15 not be used, because
  187.     8 bit devices may not work properly if the SCSI Host ID is greater than 7.
  188.  
  189.     The default SCSI Host ID is 7.
  190.  
  191.     For example, if you want to change the value of adapter's 1 SCSI ID to 6,
  192.     and that adapter is not controlled by the Boot ROM, then you may change
  193.     it to ID=6 as in the following example:
  194.  
  195.     DEVICE=C:[PATH]ASPI416.SYS /HOST_ID=6<1>
  196.  
  197.  
  198. Using the /TIMEOUT=n ( or /T=n ) Option:
  199. -----------------------------------------
  200.  
  201.     Usage:
  202.         /TIMEOUT=n<path[:id]>[,n<path[:id]>]*
  203.         (n = timeout value in seconds for device, n=(0..65535), 0=infinite)
  204.  
  205.     ASPI416.SYS uses a timeout mechanism to detect certain errors.  When
  206.     ASPI416.SYS issues a command to a SCSI device, a timer is started.  If
  207.     the timer expires before the command completes, ASPI416.SYS assumes that
  208.     something has gone wrong with the device, and takes steps to recover.
  209.     The default value for this is 10 seconds, and the maximum setting
  210.     for this switch is 0, which represents no timeout.
  211.  
  212.     For example, if you have a particularly slow device on adapter 1 (HA=1),
  213.     and ID=3 that you wish to extend the timeout on this device to 60 seconds,
  214.     then the line in CONFIG.SYS that loads ASPI416.SYS would look like this:
  215.  
  216.     DEVICE=C:[PATH]ASPI416.SYS /TIMEOUT=60<1:3>
  217.  
  218.  
  219. Using the /VERBOSE ( or /V ) Option:
  220. -------------------------------------
  221.  
  222.     Usage:
  223.         /VERBOSE
  224.  
  225.     This switch is used to output more detailed information than is usually
  226.     shown, after the ASPI416.SYS is initialized.  This is especially usefull
  227.     if you have multiple SYM53C416 adapters in your system and would like to
  228.     see the Device ID, the serial number for each SYM53C416 adapter found in
  229.     the system.
  230.  
  231.     For example, if you wish to see more detailed information displayed when
  232.     you boot, the line in CONFIG.SYS that loads ASPI416.SYS would look like
  233.     this:
  234.  
  235.     DEVICE=C:[PATH]ASPI416.SYS /VERBOSE
  236.  
  237.  
  238. Using the /IRQ Option:
  239. -------------------------------------
  240.  
  241.     Usage:
  242.         /IRQ=n
  243.  
  244.     This switch is used to set the Irq Channel of the host adapter when the
  245.     Plug and Play configuration manager is not installed.  If this Irq
  246.     Channel is available, the host adapter will be configured with this Irq.
  247.     
  248.     If the Plug and Play configuration manager is installed, you should use
  249.     the ICU facility to change card settings.
  250.  
  251.     If you do not specify an Irq, and the Plug and Play configuration manager
  252.     is not installed, the first available Irq channel will be assigned to the
  253.     host adapter.
  254.  
  255.  
  256. Using the /NO_IRQ (or /NI) Option:
  257. -------------------------------------
  258.  
  259.     Usage:
  260.         /NO_IRQ (or /NI)
  261.  
  262.     This switch is used to specify that the host adapter card is to work
  263.     without an Irq Channel.  This means that no resource will be allocated on
  264.     the Irq lines for this adapter card.
  265.  
  266.  
  267. Using the /IO Option:
  268. -------------------------------------
  269.  
  270.     Usage:
  271.         /IO=n
  272.  
  273.     This switch is used to set the Io Address of the host adapter when the
  274.     Plug and Play configuration manager is not installed.  If this Io Address
  275.     is available, the host adapter will be configured with this value.
  276.  
  277.     If the Plug and Play configuration manager is installed, you should use
  278.     the ICU facility to change card settings.
  279.  
  280.     If you do not specify an Io Address, and the Plug and Play configuration
  281.     manager is not installed, the first available Io Address will be assigned
  282.     to the host adapter.
  283.  
  284. ===============================================================================
  285. ***     For Developers/Support Use ONLY! ***
  286. ***     NOT TO BE USED BY AN END USER    ***
  287.  
  288. Using the /DB Option:
  289. ----------------------
  290.  
  291.     Usage:
  292.         /DB
  293.  
  294.     This is DEBUG mode.  This is an undocumented switch that may be used
  295.     for developers and/or support engineers to provide additional debug
  296.     information and/or special debug modes in the driver.  The exact
  297.     details of what this will do is currently unknown and may be changed
  298.     at any time.  Its purpose should remain the same.
  299.  
  300.  
  301. Using the /SYNCH_OFFSET ( or /SO ) Option:
  302. -----------------------------------------
  303.  
  304.     Usage:
  305.         /SYNCH_OFFSET=n<path[:id]>[,n<path[:id]>]*
  306.         (n = 0..maximum synchronous offset for the adapter)
  307.  
  308.     This sets the maximum synchronous offset to negotiate with a particular
  309.     device.  The allowable values for this setting are 0 to the maximum
  310.     synchronous offset supported by the specified path.  The 53C416 controller
  311.     chip support offsets up to 8.  If 0 is specified for the synchronous offset
  312.     value, then synchronous transfers will be turned off for the specified
  313.     device(s).  The value set by this option only defines the maximum offset
  314.     that will be attempted to be negotiated.  This means that the device must
  315.     also be capable of this offset, and so we can't guarantee that the given
  316.     offset will succeed.  The default value is the maximum offset that is
  317.     supported by a particular host adapter.
  318.  
  319.     For example, if you want to change the synchronous offset to 6 for
  320.     HA=0, ID=3, the line in CONFIG.SYS that loads ASPI416.SYS would
  321.     look like this:
  322.  
  323.     DEVICE=C:[PATH]ASPI416.SYS /SYNCH_OFFSET=6<0:3>
  324.  
  325. ***     For Developers/Support Use ONLY! ***
  326. ***     NOT TO BE USED BY AN END USER    ***
  327. ===============================================================================
  328.  
  329. ===============================================================================
  330. ***     May possibly be used in the future ***
  331. ***           NOT CURRENTLY USED!           ***
  332.  
  333. Using the /OVERRIDE Option:
  334. -------------------------------------
  335.  
  336.    Usage:
  337.         /OVERRIDE
  338.  
  339.     This option enables the user to specify that any settings on the card that
  340.     were done by a PnP BIOS or Intel's Configuration Manager are to be
  341.     overridden and ignored.  If command line options for setting either the
  342.     Irq or I/O Address are present, these settings will be used.  Otherwise,
  343.     default settings (No Irq, or auto-locate I/O Address) will be used.
  344.  
  345.  
  346. Using the /INCLUDE ( or /I ) Option:
  347. -------------------------------------
  348.  
  349.     Usage:
  350.         /INCLUDE=path[,path]*
  351.  
  352.     This option enables the user to include support for a specified adapter.
  353.     If you have support for a specified adapter excluded by the BIOS, you
  354.     may change the default of excluding the specified adapter from exclude to
  355.     include by using this option.
  356.  
  357.     For example, if you have host adapter 0 excluded in the BIOS, and you
  358.     want ASPI416.SYS to add support for it, then you may include it as in
  359.     the following example:
  360.  
  361.     DEVICE=C:[PATH]ASPI416.SYS /INCLUDE=1
  362.  
  363.  
  364. Using the /EXCLUDE ( or /X ) Option:
  365. -------------------------------------
  366.  
  367.     Usage:
  368.         /X<a:b>[,<a:b>]*
  369.         (a= Device ID, b= Serial Number)
  370.  
  371.     This option enables the user to exclude support for a specified adapter.
  372.     This option has two parameters that are all required:
  373.         1.) Device ID
  374.         2.) Serial Number
  375.  
  376.     These parameters will identify a specific adapter that you wish to
  377.     exclude, and may be obtained in the following manner:
  378.         Step 1.) Boot using the "/VERBOSE" switch to find the correct
  379.                  parameters that correspond to the device you wish to exclude.
  380.         Step 2.) Edit your config.sys and add the "/EXCLUDE" switch with the
  381.                  parameters that you obtained above (in Step 1).
  382.  
  383.     For example, if you booted with the /VERBOSE switch as in Step 1,
  384.     and found that the adapter that you want to exclude had:
  385.         Device ID               = 3
  386.         Serial Number           = 5
  387.     then, the line in CONFIG.SYS that loads ASPI416.SYS would look like this:
  388.  
  389.     DEVICE=C:[PATH]ASPI416.SYS /X<3:5>
  390.  
  391.  
  392. ***     May possibly be used in the furture ***
  393. ***           NOT CURRENTLY USED!           ***
  394. ===============================================================================
  395.  
  396.  
  397.  
  398.