home *** CD-ROM | disk | FTP | other *** search
/ Bila Vrana / BILA_VRANA.iso / 019A / ONEFOS09.ZIP / ONEFOS.TXT < prev    next >
Text File  |  1996-06-15  |  45KB  |  852 lines
  1.              ONEFOSsil FOSSIL 5 Communications Driver Revision 9
  2.           (C) Copyright 1995-96 by Carl Morris and Morris Softronics,
  3.                              all rights reserved
  4.          Published and released by Morris Softronics on June 15, 1996
  5.  
  6.                               Table of Contents
  7.     Topic---------------------------------------------------------Location
  8.     What is ONEFOSsil?...................................................1
  9.     Warranty.............................................................2
  10.     Licensing Information................................................3
  11.          Distribution..................................................3-1
  12.          Registration..................................................3-2
  13.          Benefits of Registering.......................................3-3
  14.     System Requirements..................................................4
  15.     Installation.........................................................5
  16.          Port Argument.................................................5-1
  17.          Command Line Options..........................................5-2
  18.               Locking Port Settings..................................5-2-1
  19.               Setting Buffer Sizes...................................5-2-2
  20.               Setting Multitasker Options............................5-2-3
  21.               Controlling FIFO's.....................................5-2-4
  22.               Holding the Interrupt..................................5-2-5
  23.               Controlling Time-outs..................................5-2-6
  24.               Controlling Carrier-Detection..........................5-2-7
  25.     After Installation...................................................6
  26.          Un-installing.................................................6-1
  27.          Getting Status................................................6-2
  28.          Changing Port Settings........................................6-3
  29.          Forcing Port Opened...........................................6-4
  30.          Forcing Port Closed...........................................6-5
  31.     Examples of Installation and Use.....................................7
  32.     Compatibility Notes..................................................8
  33.          Shared IRQ's..................................................8-1
  34.          Pretested Software............................................8-2
  35.          Windows Tips..................................................8-3
  36.     Troubleshooting (obtaining support)..................................9
  37.     Credits.............................................................10
  38.  
  39.                         Section 1: What is ONEFOSsil?
  40.  
  41.     ONEFOSsil is a high speed serial communications driver for 8250 series
  42.     UARTs.  The 8250 series includes all compatible UARTs, such as the
  43.     8250A, 8250B, 16450, 16550, 16550A, and the 82510 in 16450
  44.     compatibility mode.  Other UARTs are sure to exist that may be
  45.     compatible.
  46.  
  47.     ONEFOSsil provides services for FOSSIL compliant software.  ONEFOSsil
  48.     supports most of the FOSSIL 5 specification and the Extended X00
  49.     FOSSIL specification.  ONEFOSsil will probably work with any program
  50.     that is designed to use a FOSSIL driver.  Some differences do exist
  51.     between ONEFOSsil and a full FOSSIL 5 driver, and the technical
  52.     document, ONEREF.TXT, describes these differences.  Very few of these
  53.     differences should cause problems.
  54.  
  55.     ONEFOSsil is special (it can't be called unique) in that it only
  56.     supports one FOSSIL port at a time.  This provides the best solution
  57.     for multitasking environments such as DESQview or Windows where only
  58.     one port is needed in each task.  Just because ONEFOSsil is a single
  59.     port driver, that does not stop it from being useful for multiport or
  60.     multiline systems.  ONEFOSsil can even handle multiple ports that
  61.     share the same IRQ (read Compatibility Notes - Shared IRQ's.)
  62.  
  63.     Some people ask why there is a need for another FOSSIL driver.  Other
  64.     people are finally relieved to see new FOSSIL drivers.  Its been
  65.     nearly two years since the last update of any FOSSIL driver.  Most
  66.     drivers are much older than that yet.  Many of the current drivers are
  67.     loaded with bugs, and the versions that are bug free are lacking
  68.     needed features.  Most drivers are not even supported by their authors
  69.     anymore.
  70.  
  71.     ONEFOSsil was wrote to fill this gap completely.  ONEFOSsil not only
  72.     provides an alternative, but a better solution.  The author stands
  73.     behind ONEFOSsil, promotes it and FOSSIL compliant software, and is
  74.     willing to take the heat.  In a time where more and more software is
  75.     becoming less and less DOS based, it is hard for anyone to provide and
  76.     support such a product as ONEFOSsil.  It is only for this reason that
  77.     ONEFOSsil has been produced as a shareware product.  By supporting the
  78.     author, you show the author your support of his work in supporting the
  79.     product.
  80.  
  81.                              Section 2: Warranty
  82.  
  83.     The shareware version of ONEFOSsil comes with absolutely no warranty.
  84.     Due to the instability of modern media and the unreliability of
  85.     communications devices, it can not be guaranteed that this copy of
  86.     ONEFOSsil is in the same state as when it was released.  Use of this
  87.     software and/or documentation is at your own risk.
  88.  
  89.     Carl Morris, Morris Softronics, or any of their distributors can not
  90.     be held responsible for any accidental or consequential damages this
  91.     product may cause, including destruction of data, or damage to
  92.     equipment.  No warranties exist on the use of this product, either
  93.     expressed or implied, and is hereby disclaimed of any and all implied
  94.     warranties of merchantability and fitness for a particular purpose.
  95.  
  96.     The only expressed warranty of the registered version of ONEFOSsil is
  97.     if ONEFOSsil ever performs incorrectly, ONEFOSsil will be corrected
  98.     and a new registered version will be made available.  This is based on
  99.     Morris Softronics judgment of "performing incorrectly."
  100.  
  101.                        Section 3: Licensing Information
  102.  
  103.     Since ONEFOSsil is primarily a shareware product, several licenses
  104.     apply to its distribution and use.  ONEFOSsil is protected by U.S.
  105.     copyright laws and international copyright treaties and is licensed,
  106.     not sold.
  107.  
  108.                           Section 3-1: Distribution
  109.  
  110.     Distribution rights of this copy of ONEFOSsil is described in the file
  111.     DISTRIB.TXT supplied with this copy.
  112.  
  113.                           Section 3-2: Registration
  114.  
  115.     The shareware version of ONEFOSsil is for evaluation only.  After the
  116.     evaluation period, the full version of ONEFOSsil must be licensed for
  117.     use, or the shareware version must be removed from use.  The file
  118.     REGISTER.TXT supplied with ONEFOSsil will detail the registration
  119.     process.
  120.  
  121.                      Section 3-3: Benefits of Registering
  122.  
  123.     Registration of a shareware product is usually done to extend the
  124.     usefulness or enjoyment of a product.  Shareware products usually come
  125.     crippled, or with some form of a reminder, or both.  ONEFOSsil is not
  126.     crippled in any way.  ONEFOSsil will display a registration reminder
  127.     every time it is ran.  ONEFOSsil will delay 5 seconds when it is
  128.     installed.  This is a small price to pay to evaluate cripple free high
  129.     performance software such as ONEFOSsil.
  130.  
  131.     Registration of ONEFOSsil will include, but not be limited to:  an
  132.     indefinite license agreement, an executable without the delay and
  133.     reminder, free (from registration costs) upgrades to newer versions,
  134.     enhanced support from the author, and discounts and specials on other
  135.     products from Morris Softronics.
  136.  
  137.                         Section 4: System Requirements
  138.  
  139.     To be effective and useful, ONEFOSsil requires the following: MS DOS
  140.     3.0 or compatible operating system, a minimum of 64k of memory(uses 4k
  141.     minimum for installation), an 80286 or compatible processor, an 82