home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 4 Drivers / 04-Drivers.zip / s2kv201.zip / INSTALL.TXT < prev    next >
Text File  |  2001-10-15  |  8KB  |  176 lines
  1.  
  2.  
  3.                            The Install.cmd script
  4.  
  5. The distribution zip contains an installation program that should install
  6. the sio2k drivers on your system.  To use the install program, create a
  7. temporary subdirectory and unzip the files into that directory.  Then
  8. change into that directory and type INSTALL followed by ENTER.
  9.  
  10. The installation program will create a subdirectory on your OS/2 boot drive
  11. named sio2k and copy the distribution into that directory.  Your existing
  12. CONFIG.SYS is copied (backed up) to CONFIG.S2K and then scanned for other
  13. serial drivers, like COM.SYS and SIO.SYS.  The statements that will load
  14. other serial drivers are commented out.  The install program then adds
  15. statements to the end of your config.sys that will load the sio2k drivers. 
  16. If your config.sys already contains statements loading the sio2k drivers,
  17. the will not be changed.
  18.  
  19. If the install program does not meet your needs, you can manually install
  20. the drivers, or modify the install program source.  To install the sio2k
  21. drivers manually, continue reading.
  22.  
  23.                    Manual SIO2K Installation instructions
  24.  
  25. First create a subdirectory on your OS/2 boot drive named SIO2K. Then place
  26. all of the files from the sio2k distribution into this directory.
  27.  
  28. Edit your CONFIG.SYS file and REM out all other serial drivers such as
  29. COM.SYS and VCOM.SYS, or SIO.SYS, VSIO.SYS and VX00.SYS.
  30.  
  31. Applying appropriate modifications (for boot drive), add the following
  32. lines to the end of your CONFIG.SYS:
  33.  
  34. device=c:\sio2k\uart.sys logfile=c:\sio2k\sio2k.log
  35. device=c:\sio2k\vsio2k.sys logfile=c:\sio2k\vsio2k.log vIrqList(3,4)
  36. device=c:\sio2k\sio2k.sys logfile=c:\sio2k\sio2k.log
  37.  
  38. NOTE THAT SIO2K.SYS MUST BE THE LAST DRIVER LOADED IN THE SIO2K SET.
  39.  
  40. The simplest form of loading the drivers is:
  41.  
  42. device=c:\sio2k\uart.sys
  43. device=c:\sio2k\vsio2k.sys
  44. device=c:\sio2k\sio2k.sys
  45.  
  46. The above assumes your boot drive is drive C.
  47.  
  48. If you wish to use Vmodem, see VMODEM.TXT.
  49.  
  50. Common command line options:
  51. All of the drivers in the sio2k set share some common command line options. 
  52. They are:
  53.  
  54.      NOPAUSE - This command line option instructs the driver not to pause
  55.      (at boot time) when a command line option error is detected.
  56.  
  57.      LOGFILE - In the form LogFile=c:\path\filename.log.  This command line
  58.      option tells the driver where to place information that may be useful
  59.      to the user.
  60.  
  61.  
  62. SIO2K.SYS - In addition to the common command line options, SIO2K.SYS has
  63. the following additional command line option(s):
  64.  
  65.      VIOPORTS - In the form VioPorts=400.  Some devices like vmodem ports
  66.      have no real hardware I/O ports.  In the absence of a config file
  67.      these ports cannot be accessed from Dos/Windows sessions unless a
  68.      virtual I/O address is assigned.  This option specifies where the
  69.      virtual I/O address are to start.  If no VioPorts command line option
  70.      is used, the virtual ports will begin at 400(hex).
  71.  
  72.      OS2SHARES - When this option used in the sio2k.sys command line,
  73.      DOS/Windows sessions will be allowed access ports that have already
  74.      been opened by an OS/2 session.
  75.  
  76. VSIO2K.SYS - In addition to the common command line options, SIO2K.SYS has
  77. the following additional command line option(s):
  78.  
  79.      VIRQLIST - in the form vIrqList(3,4).  Vsio2k.sys must know at load
  80.      time (before a config file is processed) which virtual IRQs it is to
  81.      manage. NOTE that virtual IRQs 3 and 4 are the default IRQs managed by
  82.      vsio2k.sys.  The "vIrqList(3,4)" fragment says that any Dos/Win comm
  83.      port is going to use either virtual IRQ 3, or virtual IRQ 4.  Note
  84.      that the virtual IRQs have nothing to do with the real (hardware)
  85.      IRQs.  Additionally the vIrqList can be used to specify the exact
  86.      virtual IRQ that given virtual COMn port is to use.  The form is
  87.      vIrqList(1=4,2=4,3).  This form specifies that virtial IRQs 4 and 3
  88.      can be used by vsio2k.sys.  Additionally, it specifies that COM1 and
  89.      COM2 are to use virtual IRQ 4.
  90.  
  91. VMODEM.SYS - In addition to the common command line options, VMODEM.SYS has
  92. the following additional command line option(s):
  93.  
  94.      NPORTS - In the form nPorts=5.  This example informs VMODEM.SYS to
  95.      define 5 virtual modem ports.  If the NPORTS option is missing,
  96.      VMODEM.SYS will define 1 virtual modem port.
  97.  
  98. UART.SYS - In addition to the common command line options, UART.SYS has the
  99. following additional command line option(s):
  100.  
  101.      LEGACYISA - In the form LegacyIsa(0E80,1a0,208), where 0E80, 1a0, and
  102.      208 are the I/O address of uarts.  DO NOT specify legacy ISA ports
  103.      that are at standard addresses like 3f8, 2f8, 3e8 and 2e8 unless these
  104.      ports are not automatically being detected by UART.SYS.  UART.SYS will
  105.      automatically detect the uart type, fifo size and IRQ that the uart is
  106.      using, so only the I/O port address is needed.
  107.  
  108.      SUPERIO - This option enables the detection of SuperIo chips with
  109.      uarts, and the resulting enabling of the uart's enhanced functions,
  110.      such as bit rates to 921600.  When this option is NOT used, the uarts
  111.      on SuperIo chips will function as a normal 16550A.  If you use
  112.      programs (like the kernel debugger) that directly set the bit rate in
  113.      the uarts, then you SHOULD NOT use this option.  If "SuperIo" option
  114.      is in the uart.sys command line, the kernel debugger does not set the
  115.      bit rate correctly.
  116.  
  117.      Additionally, this command line option (SuperIo) replaces the SuperIo
  118.      option in the config file.
  119.  
  120. The CONFIG file:
  121.  
  122. The vast majority of users DO NOT need a config file.  The drivers will
  123. probably do a better job of automatically self configuring than you can do. 
  124. The log files can be examined to see exactly how the posts have been
  125. configured.  Additionally, you can use the "modes" command to swap the
  126. ports into any order that you desire (see modes.txt).
  127.  
  128. However, for those of you that insist on complete control, and have self
  129. masochistic tendencies, you can create a config file.  If you choose to use
  130. a config file, then the SIO2K drivers assume almost nothing and you MUST
  131. define everything.
  132.  
  133. Also, I do not have time to create a config file for you, you are on your
  134. own.  You may however, report errors in the config file processing.
  135.  
  136. First, install as above (with no config file).  With no config file, you
  137. access COM1 to COM4 at their standard I/O addresses, ports on PCI cards and
  138. ports defines in the LegacyIsa command line option.
  139.  
  140. After testing using no config file, one can play with additional features
  141. of SIO version 2, by using an optional config file.  Currently, the config
  142. file must be in the same directory that the driver files were loaded from,
  143. and the config file name must be SIO2K.CFG.
  144.  
  145. Currently, the only documentation for the config file is located in
  146. SAMPLE.CFG.
  147.  
  148. First, one should simply copy SAMPLE.CFG to SIO2K.CFG, reboot and see what
  149. happens.  If the boot is successful, you can SLOWLY make changes to the
  150. config file (re-booting often) to test/use additional features of SIO
  151. version 2.
  152.  
  153. If you have a Hayes ESP card (note the ESP is NOT a modem) then change the
  154. AltDriver statement (in the config file) to AltDriver=esp$,n in place of
  155. AltDriver=uart$,n.  The command line parameters for ESP.SYS are the same as
  156. for UART.SYS.  Note that BOTH UART.SYS and ESP.SYS will have to be loaded
  157. if you have a mixture of normal UARTs and ESP ports.  Also note that once a
  158. Hayes ESP port has been used in enhanced mode, it will not work correctly
  159. in compatibility mode until the computer has been powered off, then on.
  160.  
  161. The number ("n") in the AltDriver=xxxx$,n fragment has been confusing to
  162. some.  The "n" need NOT match the "n" in COMn.  For example, it one is
  163. defining a single vmodem port at COM3, then AltDriver=vmodem$,1 would be
  164. used in the definition of COM3 in the config file. A more complete example:
  165.  
  166. ;-----------------------;-----------------------------------------
  167. Os2Device
  168.  Name=com3
  169.  
  170.  AltDriver=vmodem$,1
  171. ;-----------------------;-----------------------------------------
  172.  
  173. The above config file fragment is specifying that COM3 is the first device
  174. (first vmodem port) in the driver vmodem$.
  175.  
  176.