home *** CD-ROM | disk | FTP | other *** search
/ D!Zone (Collector's Edition) / D_ZONE_CD.ISO / programs / editors / bnudm125 / sersetup.txt < prev   
Text File  |  1994-12-06  |  25KB  |  652 lines
  1.   │
  2.  ││ BNU DOOM Serial driver version 1.2.5
  3. │││ DOOM Network interface is copyright 1994 by Id Software Inc.
  4.  ││ BNU SIO Driver is copyright 1994 by David L Nugent
  5.   │                                   & Unique Computing P/L
  6.  
  7. BNU for DOOM is a drop-in replacement for Id Software's
  8. SERSETUP.EXE provided with DOOM 1.2. This version, however,
  9. provides a full and complete interrupt driven serial driver
  10. implementation and therefore does not suffer many of the
  11. shortcomings in Id's original driver which was much too
  12. simplistic to provide the services necessary for running on
  13. today's typical modem configurations or at faster speeds
  14. than 9600 baud.
  15.  
  16. This work is a derivative and blending of Id's published
  17. source for SERSETUP and my own BNU FOSSIL driver plus some
  18. useful enhancements to the original dialer. This driver
  19. provides full support for the 8250 family of UARTs, including
  20. the 8250, 16450, 16550 (original, used in older PS/2's),
  21. 16550A(FN), 16551-4 (CMOS and packaged versions of the 16550)
  22. Intel 82510 and the TYPE3. It provides hardware flow control,
  23. the ability to run at *any* baud rate supported by the UART,
  24. configurable inbound/outbound buffer sizes.
  25.  
  26. Before you ask, BNU is an acronym for Basic Networking
  27. Utility, referring to its use in the FidoNet community as
  28. the base level of communications. FOSSIL in this context
  29. means "Fido Opus SEAdog Standard Interface Layer", which is
  30. a phrase used to describe the set of common interrupt
  31. functions developed as a common layer for many FidoNet
  32. applications. SIO (which you'll see in SERSETUP's banner)
  33. means "serial input/output".
  34.  
  35. This driver does not use FOSSIL services, so you need not
  36. install one nor need to even know what one is.
  37.  
  38.  
  39. INSTALLATION
  40.  
  41. This driver is almost a drop-in replacement for Id's
  42. original. First, rename Id's version to "SERSETUP.OLD" and
  43. copy in SERSETUP.EXE from this archive into your DOOM
  44. directory.
  45.  
  46. If you have used your modem to call other DOOM players and
  47. have an init string that works, then all the rules have
  48. just changed - you will almost certainly have to change your
  49. initialisation string from the one you used with Id's
  50. SERSETUP.
  51.  
  52. Specifically, you'll need to:
  53.  
  54.  - Enable V42bis (if available)
  55.  - Enable error correction (optional)
  56.  - ENABLE HARDWARE FLOW CONTROL
  57.    (ALSO REFERRED TO AS RTS/CTS HANDLING)
  58.  
  59. The latter is the most important if you intend to use an error
  60. corrected link, the others optional. Error correction and
  61. compression are transparent to the data stream. BNU automatically
  62. provides CTS/RTS signal handling to take care of the "spurts" of
  63. data it receives as a result of the protocol used between the
  64. modems. If you only have MNP5 compression, try it since it may
  65. work fine - disable it if play becomes too jerky. Compression is
  66. likely to slow down the game and make it less responsive, but
  67. implementations vary so trying it won't hurt.
  68.  
  69.    - You need 9600 baud or greater!
  70.  
  71. Don't consider attempting to run DOOM at any lesser speed -
  72. it just doesn't work. You'll get a connect, but movement is
  73. so slow that it is entirely unplayable. At 4800 baud it's
  74. like molasses at 50 fathoms! At 2400, it's like attempting
  75. to play DOOM inside a Jupiter Mining Corps' stasis booth -
  76. i.e. pretty much a waste of time. Try it on a direct connect
  77. if you like, it is amusing, but don't donate money to your
  78. PTT provider trying it out if you only have 2400 baud modems
  79. or less. At 7200 you might get a slow moving game going, but
  80. 9600 is really where it becomes playable. In fact, if you
  81. have a 16450 and/or a slower 386, you may find that 9600
  82. provides the most playable game (it is, after all, the speed
  83. for which the networking interface was developed by Id).
  84.  
  85.    - If you use error correction and/or compression, use a baud
  86.      rate greater than the actual connect speed.
  87.  
  88. For V32 modems, use 19200 (more probably won't be an
  89. advantage and makes your system work harder - sometimes
  90. causing jerky play). V32b modems should use 38400 or 19200.
  91. This driver *may* work with the HST protocols (but probably
  92. not brilliantly) and will certainly do just fine with ZYXEL
  93. 16.8K and 19.2K. VFC and V34 modems will probably need the
  94. port set at 38400 or 57600 (incidentally, if anyone has parallel
  95. port specs for use with these modems, or knows where these can
  96. be obtained, please let me know at the Email address noted
  97. at the end of this document).
  98.  
  99. MODEM.CFG has some additional (optional) lines which you can use:
  100.  
  101.   Line 1: Modem init string (+)
  102.   Line 2: Modem hang up string (+)
  103.   Line 3: Default baud rate (if not specified, 9600 is used)
  104.   Line 4: Receive buffer size (defaults to 2048 bytes)
  105.   Line 5: Transmit buffer size (defaults to receive buffer size)
  106.  
  107.   + Also present in Id's SERSETUP
  108.  
  109. Anything after the fifth line is ignored. Note that to make your
  110. existing MODEM.CFG compatible with this driver, it is advisable
  111. to either complete the above values or add empty lines for the
  112. additional fields as numbers starting on the additional lines may
  113. cause spurious options to be set.
  114.  
  115. As far as possible, this rework of SERSETUP is compatible with
  116. DOOM's SETUP.EXE. In fact, with the addition of configurable port
  117. settings via the environment (see below 'nonstandard settings')
  118. this version should be more compatible than the original, allowing
  119. SETUP to be used with non-standard port configurations.
  120.  
  121.  
  122. SERIAL CONNECTIONS
  123.  
  124. SERSETUP's dialer has been reworked into something that may work
  125. a little more intelligently than the original. Specifically, it
  126. supports these types of connections:
  127.  
  128.   - Direct connection (no modem)
  129.  
  130.     Run SERSETUP with none of the following present on the command
  131.     line: -modem, -voice, -dial, -answer
  132.     In the absence of these options, direct connect is the default.
  133.  
  134.   - Dialup and answer via modem (answer mode, dial mode)
  135.  
  136.     One end uses "-dial <number>" (where <number> is replaced by the
  137.     telephone number to dial), and the other and uses "-answer".
  138.     The dialing end's modem will call out to the other, and the
  139.     answering end attempts to pick up the phone line and establish
  140.     carrier when it sees "RING".
  141.  
  142.   - Connection via an existing modem <-> modem connection
  143.  
  144.     This is similar to the direct connect. However, if you use the
  145.     -modem switch, you may optionally hang up the telephone line
  146.     on completion of the game.
  147.  
  148.   - Switching voice -> data prior and data -> voice after play
  149.  
  150.     This avoids making unnecessary calls by allowing easy switching
  151.     between voice and data.
  152.  
  153.     As with dialup, this requires an originating (dialing) end
  154.     and an answering end, the difference between them being that
  155.     some parts of establishing the connection aren't present.
  156.     The originating system is told to 'pick up' the line immediately
  157.     and the answering end told to issue connection tones without
  158.     waiting for RING.
  159.  
  160.     At the originating end, use "-voice D" on the command line to
  161.     force originate mode. Your modem may offer other parameters
  162.     which do the same thing, perhaps a little better. In that case,
  163.     use "-voice <command>" where '<command>' is the recommended
  164.     string to place the modem into originate mode.
  165.  
  166.     At the answering end, use "-answer -noinit", which skips the
  167.     modem initialisation and sends the command "ATA" (answer call)
  168.     to the modem immediately without waiting for RING.
  169.  
  170. All responses now have time-outs, and redial is automatic should the
  171. number called result in "BUSY" or "NO CARRIER".  SERSETUP also
  172. understands response strings such as "VOICE" and "NO DIAL TONE",
  173. failing the call should they be detected and exiting cleanly.
  174.  
  175. Note that hanging up after a call is now optional. The default (by
  176. hitting ENTER at the prompt presented at the time) is to hang up.
  177.  
  178.  
  179. NONSTANDARD SETTINGS
  180.  
  181. DOOM 1.2's SETUP.EXE did not allow any but the standard port (1-4)
  182. selections. This means that those use run their modem on other
  183. serial ports, or ports configured slightly differently than standard
  184. had to either change these to the standard settings or use SERSETUP
  185. from the command line. The original SERSETUP did attempt to provide
  186. a way to use non-standard configurations; however, the code