home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 4 Drivers / 04-Drivers.zip / s2kv201a.zip / SAMPLE.CFG < prev    next >
Text File  |  2001-11-06  |  15KB  |  304 lines
  1. ; THIS CONFIG FILE IS FOR ADVANCED USERS.  START WITHOUT ANY CONFIG FILE
  2. ; AND ADVANCE SLOWLY FROM THERE.
  3. ;
  4. ; This sample configuration file should reflect the defaults used by
  5. ; SIO2K.SYS.  That is, using this configuration file should be the same as
  6. ; using no configuration file at all.  If you wish to start your own
  7. ; configuration file, copy this file to SIO2K.CFG and start the modification
  8. ; process.
  9. ;
  10. ; Basically, there are two elements in the config file.  The option type
  11. ; which starts in the first column below, and the specific option within
  12. ; that type.  Data may be entered into this file in upper and lower case or
  13. ; any mixture.
  14. ;
  15. ; Anything following a semicolon (;) is ignored, additionally blank lines
  16. ; are ignored.
  17. ;
  18. ; The option types are:
  19. ;    Os2Device - The specific options in this group define and specify an OS/2 
  20. ;                proper device, such as COM1, COM2 etc.
  21. ;
  22. ; Specific options available under the "Os2Device" type are:
  23. ;    Name
  24. ;      Example, Name=com1.  SIO2K.SYS allows users to define the device names
  25. ;      that it will service.  The name need NOT be com1, com2 etc.  It can be
  26. ;      any name (valid file name) up to 8 characters.  This feature allows
  27. ;      SIO2K.SYS to be coresident with other drivers that define standard
  28. ;      device names.  Example, COM.SYS can control com1 to com4, and SIO2K.SYS
  29. ;      can start at com5.
  30. ;
  31. ;    AltDriver
  32. ;      Example, AltDriver=UART$,3.  This option is telling SIO2K.SYS that
  33. ;      another device driver, that identifies itself as UART$,  is
  34. ;      controlling the actual hardware, AND that the third device within
  35. ;      UART$ is to be used.  Among other things, this option gives
  36. ;      drivers without a virtual Dos interface access to SIO2K's virtual
  37. ;      drivers.  The name UART$ is an inter device driver name and must be
  38. ;      obtained from the drivers documentation.  The name is usually NOT
  39. ;      the same as the device drivers name.  For example, the IDC name for
  40. ;      UARTS.SYS is UART$.
  41. ;
  42. ;    LockedBitRate
  43. ;      Example, LockedBitRate=57600.  This option will cause SIO2K.SYS to set
  44. ;      the bit (baud) rate to the specified value and to ignore attempted
  45. ;      changes made by application programs.  NO CHECKING OF THE VALUE IS
  46. ;      DONE.
  47. ;
  48. ;    Os2Shares
  49. ;      Normally when an OS/2 application open a comm port, Dos/Windows cannot
  50. ;      access the comm port, even if the OS/2 app specified sharing is
  51. ;      allowed.  This option overrides the restriction and allows Dos to
  52. ;      have access to the port.
  53. ;
  54. ; EXPERIMENT AT LEAST A WEEK BEFORE ASKING FOR SUPPORT.
  55. ;
  56. ;-----------------------;----------------------------------------------------
  57. Os2Device        ;
  58.  Name=com1        ;System name to assigned to port (max 8 chars).
  59.             ;
  60.  AltDriver=uart$,1    ;The name and logical port number (1 relative) of
  61.                         ;an alternate device driver that will control the
  62.             ;hardware, see the manual.
  63. ;-----------------------;----------------------------------------------------
  64. Os2Device        ;
  65.  Name=com2        ;System name to assigned to port (max 8 chars).
  66.             ;
  67.  AltDriver=uart$,2    ;The name and logical port number (1 relative) of
  68.                         ;an alternate device driver that will control the
  69.             ;hardware, see the manual.
  70. ;-----------------------;----------------------------------------------------
  71. Os2Device        ;
  72.  Name=com3        ;System name to assigned to port (max 8 chars).
  73.             ;
  74.  AltDriver=uart$,3    ;The name and logical port number (1 relative) of
  75.                         ;an alternate device driver that will control the
  76.             ;hardware, see the manual.
  77. ;-----------------------;----------------------------------------------------
  78. Os2Device        ;
  79.  Name=com4        ;System name to assigned to port (max 8 chars).
  80.             ;
  81.  AltDriver=uart$,4    ;The name and logical port number (1 relative) of
  82.                         ;an alternate device driver that will control the
  83.             ;hardware, see the manual.
  84. ;----------------------------------------------------------------------------
  85. ;
  86. ; This section of the config file is for UARTS.SYS, aka UART$
  87. ;
  88. ; The option types are:
  89. ;    BaseUart - This option signals the end of the SIO2K.SYS config
  90. ;    information and the start of the UARTS.SYS section of the config file.
  91. ;
  92. ; Specific options available under the "BaseUart" type are:
  93. ;   SuperIO - Many motherboards and IDE controller cards have uarts with
  94. ;   enhance capabilities, such as faster bit (baud) rates.  If this option
  95. ;   is included below, it enables the searching for these type of uarts and
  96. ;   the use of their extended features.  This option is global and need to
  97. ;   be given only once.
  98. ;
  99. ;    ExclusiveIRQ
  100. ;      Device drivers can choose to use an IRQ exclusively, or to allow other
  101. ;      device drivers to use the IRQ at the same time.  Conflicts can occur
  102. ;      either way.  UARTS.SYS defaults to sharing IRQs with other drivers.
  103. ;      Using this option will cause UARTS.SYS to use an IRQ exclusively.
  104. ;      Thus other drivers are NOT allowed to have access to the IRQ.
  105. ;
  106. ;    Hardware
  107. ;      Example, Hardware=AutoDetect.  This options tells UARTS.SYS to
  108. ;      automatically (in this example) determine if the UART is an 8250, 16450
  109. ;      or a 16550.  You can force the UART to by specifying the device type.
  110. ;      For example: Hardware=16550.  At this writting, UART.SYS supports
  111. ;      the 8250/16450, 16550, 16650, 16650A, 16654, 16750, 16850 and their
  112. ;      variants.
  113. ;      In addition, you may specify Hardware=PCI.  In this case, the driver
  114. ;      will select the next available PCI device and use that UART.  If
  115. ;      Hardware=PCI is used, then IO_Address setting (if any) is ignored.
  116. ;
  117. ;    IO_Address
  118. ;      Example, IO_Address=3f8.  This option tells UARTS.SYS the I/O port
  119. ;      to use, OR the method that UARTS.SYS is to use the assign a default
  120. ;      address.  The COMMON addresses for COM1 through COM4 are 3f8, 2f8, 3e8
  121. ;      and 3e8 respectively.  See the appendix in the user documentation for
  122. ;      other common I/O addresses, like PS/2 systems.
  123. ;
  124. ;      COM.SYS, and many other drivers and programs use a strage method of
  125. ;      assigning the DEFAULT addresses for COM1 to COM4.  They extract the
  126. ;      default addresses from memory locations in Bios Ram.  See the users
  127. ;      manual for more discussion on this.  If you desire to use the COM.SYS
  128. ;      method of setting the DEFAULT I/O address, then specify BiosRamCom1
  129. ;      through BiosRamCom4 as the option.  Example: IO_Address=BiosRamCom1.
  130. ;
  131. ;      Defults only apply to COM1 through COM4.  You MUST give a specific
  132. ;      I/O address for all other devices.
  133. ;
  134. ; As defined in the examples below, UARTS.SYS will setup COM1 to COM4 in
  135. ; the same same manner as com.sys does.
  136. ;------$UART,1----------;----------------------------------------------------
  137. BaseUart        ;define the first device to UARTS.SYS
  138.  SuperIo        ;enable usage of features on enahnced uarts.
  139.  IO_Address=BiosRamCom1    ;I/O port address or method of assignment.
  140.             ;Valid I/O port Address options are:
  141.             ;  BiosRamComN - assign like com.sys, com1 to com4 only.
  142.             ;  nnnn - a hexidecimal number like 2F8.
  143.             ;
  144.  Hardware=AutoDetect    ;Valid types are (see manual too):
  145.             ;  AutoDetect - autodetect 8250, 16450, or 16550 etc
  146.             ;  PCI - Select the next PCI device
  147.             ;  8250 - force uart to 8250
  148.             ;  16450 - force uart to 16450
  149.             ;  16550 - force uart to 16550
  150. ;------$UART,2----------;----------------------------------------------------
  151. BaseUart        ;define a second device to UARTS.SYS
  152.  SuperIo        ;enable usage of features on enahnced uarts.
  153.  IO_Address=BiosRamCom2    ;I/O port address or method of assignment.
  154.             ;Valid I/O port Address options are:
  155.             ;  BiosRamComN - assign like com.sys, com1 to com4 only.
  156.             ;  nnnn - a hexidecimal number like 2F8.
  157.             ;
  158.  Hardware=AutoDetect    ;Valid types are (see manual too):
  159.             ;  AutoDetect - autodetect 8250, 16450, or 16550 etc
  160.             ;  PCI - Select the next PCI device
  161.             ;  8250 - force uart to 8250
  162.             ;  16450 - force uart to 16450
  163.             ;  16550 - force uart to 16550
  164. ;------$UART,3----------;----------------------------------------------------
  165. BaseUart        ;define a third device to UARTS.SYS
  166.  SuperIo        ;enable usage of features on enahnced uarts.
  167.  IO_Address=BiosRamCom3    ;I/O port address or method of assignment.
  168.             ;Valid I/O port Address options are:
  169.             ;  BiosRamComN - assign like com.sys, com1 to com4 only.
  170.             ;  nnnn - a hexidecimal number like 2F8.
  171.             ;
  172.  Hardware=AutoDetect    ;Valid types are (see manual too):
  173.             ;  AutoDetect - autodetect 8250, 16450, or 16550 etc
  174.             ;  PCI - Select the next PCI device
  175.             ;  8250 - force uart to 8250
  176.             ;  16450 - force uart to 16450
  177.             ;  16550 - force uart to 16550
  178. ;------$UART,4----------;----------------------------------------------------
  179. BaseUart        ;define a fourth device to UARTS.SYS
  180.  SuperIo        ;enable usage of features on enahnced uarts.
  181.  IO_Address=BiosRamCom4    ;I/O port address or method of assignment.
  182.             ;Valid I/O port Address options are:
  183.             ;  BiosRamComN - assign like com.sys, com1 to com4 only.
  184.             ;  nnnn - a hexidecimal number like 2F8.
  185.             ;
  186.  Hardware=AutoDetect    ;Valid types are (see manual too):
  187.             ;  PCI - Select the next PCI device
  188.             ;  AutoDetect - autodetect 8250, 16450, or 16550 etc
  189.             ;  8250 - force uart to 8250
  190.             ;  16450 - force uart to 16450
  191.             ;  16550 - force uart to 16550
  192. ;----------------------------------------------------------------------------
  193. ; This section of the config file is for dos sessions, ie VSIO2K.SYS.
  194. ;
  195. ; The option types are:
  196. ;    DosDevice - This option signals the end of the UARY.SYS config
  197. ;    information and the start of the VSIO2K.SYS section of the config file.
  198. ;
  199. ; Specific options available under the "BaseUart" type are:
  200. ;
  201. ;    Os2DevName
  202. ;      Example, Os2DevName=com1.  This option tells vsio2k.sys the name of
  203. ;      the OS/2 device (eg com1, com2 etc) that is to be associated with
  204. ;      the DOS device being defined.
  205. ;
  206. ;    VirtualIO
  207. ;      Example, VirtualIO=2f8 or VirtualIO=BiosRamCom1.  This option tells
  208. ;      vsio2k.sys the I/O address that this DOS device is to virtualize.
  209. ;      If a DOS or Windows program touches this I/O port, the accesses
  210. ;      will be intercepted by vsio2k.sys and translated into calls to
  211. ;      SIO2K.SYS (the OS/2 driver).  Note that the virtual address NEED NOT
  212. ;      be the same as the address of the (real) OS/2 device.
  213. ;
  214. ;    VirtualIRQ
  215. ;      Example, VirtualIRQ=4.  This option tells vsio2k.sys which virtual
  216. ;      IRQ to associate with the dos device being defined.  All DOS devices
  217. ;      can share virtual IRQs.  However, your application software must
  218. ;      be configured to use the same IRQ.  The virtual IRQ need not be the
  219. ;      same as the IRQ that the associated OS/2 device is using.
  220. ;
  221. ;    DosShares
  222. ;      This option tells vsio2k.sys to allow OS/2 sessions to have access to
  223. ;      this DOS device.  Note that the OS/2 kernel prevents two DOS sessions
  224. ;      from using the same device, so two DOS sessions can never share a
  225. ;      communications port.
  226. ;
  227. ;    VirtualUart
  228. ;      Example, VirtualUart=16550.  This option tells vsio2k.sys the type of
  229. ;      uart to emulate.  Generally, 16550 should be specified.
  230. ;-----------------------;----------------------------------------------------
  231. DosDevice        ;
  232.  Os2DevName=com1    ;This name must match a name given in an Os2Device
  233.             ;name statement.  The Os2Device name statement must
  234.             ;preceed this statement in the config file.
  235.             ;
  236.  VirtualIO=BiosRamCom1    ;Virtual I/O port address or method of assignment.
  237.             ;Valid I/O port Address options are:
  238.             ;  BiosRamComN - assign like com.sys, com1 to com4 only.
  239.             ;  nnnn - a hexidecimal number like 2F8.
  240.             ;
  241.  VirtualIRQ=4        ;Decimal number from 3 to 15. Virtual IRQ for this port.
  242.             ;
  243.  DosShares        ;OS/2 can access DOS opened port.
  244.             ;
  245.  VirtualUart=16550    ;Valid types are (see manual too):
  246.             ;  16450 - simulate a 16450 uart
  247.             ;  16550 - simulate a 16550 uart
  248. ;-----------------------;----------------------------------------------------
  249. DosDevice        ;
  250.  Os2DevName=com2    ;This name must match a name given in an Os2Device
  251.             ;name statement.  The Os2Device name statement must
  252.             ;preceed this statement in the config file.
  253.             ;
  254.  VirtualIO=BiosRamCom2    ;Virtual I/O port address or method of assignment.
  255.             ;Valid I/O port Address options are:
  256.             ;  BiosRamComN - assign like com.sys, com1 to com4 only.
  257.             ;  nnnn - a hexidecimal number like 2F8.
  258.             ;
  259.  VirtualIRQ=3        ;Decimal number from 3 to 15. Virtual IRQ for this port.
  260.             ;
  261.  DosShares        ;OS/2 can access DOS opened port.
  262.             ;
  263.  VirtualUart=16550    ;Valid types are (see manual too):
  264.             ;  16450 - simulate a 16450 uart
  265.             ;  16550 - simulate a 16550 uart
  266. ;;-----------------------;----------------------------------------------------
  267. ;DosDevice        ;
  268. ; Os2DevName=com3    ;This name must match a name given in an Os2Device
  269. ;            ;name statement.  The Os2Device name statement must
  270. ;            ;preceed this statement in the config file.
  271. ;            ;
  272. ; VirtualIO=BiosRamCom3    ;Virtual I/O port address or method of assignment.
  273. ;            ;Valid I/O port Address options are:
  274. ;            ;  BiosRamComN - assign like com.sys, com1 to com4 only.
  275. ;            ;  nnnn - a hexidecimal number like 2F8.
  276. ;            ;
  277. ; VirtualIRQ=4        ;Decimal number from 3 to 15. Virtual IRQ for this port.
  278. ;            ;
  279. ; DosShares        ;OS/2 can access DOS opened port.
  280. ;            ;
  281. ; VirtualUart=16550    ;Valid types are (see manual too):
  282. ;            ;  16450 - simulate a 16450 uart
  283. ;            ;  16550 - simulate a 16550 uart
  284. ;;-----------------------;----------------------------------------------------
  285. ;DosDevice        ;
  286. ; Os2DevName=com4    ;This name must match a name given in an Os2Device
  287. ;            ;name statement.  The Os2Device name statement must
  288. ;            ;preceed this statement in the config file.
  289. ;            ;
  290. ; VirtualIO=BiosRamCom4    ;Virtual I/O port address or method of assignment.
  291. ;            ;Valid I/O port Address options are:
  292. ;            ;  BiosRamComN - assign like com.sys, com1 to com4 only.
  293. ;            ;  nnnn - a hexidecimal number like 2F8.
  294. ;            ;
  295. ; VirtualIRQ=3        ;Decimal number from 3 to 15. Virtual IRQ for this port.
  296. ;            ;
  297. ; DosShares        ;OS/2 can access DOS opened port.
  298. ;            ;
  299. ; VirtualUart=16550    ;Valid types are (see manual too):
  300. ;            ;  16450 - simulate a 16450 uart
  301. ;            ;  16550 - simulate a 16550 uart
  302. ;;-----------------------;----------------------------------------------------
  303.  
  304.