home *** CD-ROM | disk | FTP | other *** search
/ Toolkit for DOOM / DOOMTOOL.ISO / net_doom / ser4.txt < prev    next >
Text File  |  1994-04-25  |  6KB  |  125 lines

  1.                                    SER4.EXE
  2.                            DOOM SERIAL DEVICE DRIVER
  3.  
  4.  
  5. FEATURES:
  6.  
  7.    - Baud rates: 9600, 14400, 19200, 38400, 57600, 115200.
  8.    - Uses 'extratics=1' (whatever it is) which removes delays on some machines.
  9.    - All 'mod' operations removed which fixes slowdowns after 2 minutes.
  10.    - Many functions optimized to speed up communication.
  11.    - Compiled with several speed optimizations plus 80386 instructions instead
  12.      of 8088/8086.
  13.    - 'Talk' feature -- type msgs to your partner to debug com port setup, or
  14.      to decide on game features.
  15.    - 'Configure' option allows game settings to be modified after connecting.
  16.    - Port stays connected after game ends, allowing settings to be
  17.      re-configured and a new game started.
  18.    - Extensive statistics available at end of each game.
  19.    - Episode AND map settings to allow warping to another level.
  20.    - Lots of msgs printed during startup to help with debugging.
  21.    - 'Phonebook' list of names and numbers in modem.cfg, allowing dial-by-name.
  22.    - Two modem init strings in modem.cfg.
  23.    - Modem init strings sent slower - some modems had problems if sent too fast.
  24.    - All command-line arguments moved to modem.cfg file.
  25.  
  26. INSTALLATION:
  27.  
  28.    - Make a backup copy of your modem.cfg file.
  29.    - Copy ser4.exe and modem.cfg to your doom directory.
  30.    - Edit the modem.cfg file to change computer/port settings (see help at
  31.      bottom of file).
  32.    - Run "ser4.exe" WITHOUT arguments.
  33.  
  34. NOTES:
  35.  
  36.    - Yes, this means setup.exe won't work with ser4.  But that's ok, because
  37.      ser4 has far surpassed setup, so you don't need it anyway.  I tried
  38.      making it use the modem.cfg file, plus command-line args, plus being able
  39.      to re-confure at run-time, and the amount of code was becoming enormous.
  40.      I decided that a 63K executable was pushing it already, and the extra
  41.      prompting in ser4 probably removes the need for setup anyway.  Settings
  42.      for the computer/port should only need to be done occasionally, so they're
  43.      in the modem.cfg file.  Game settings are configurable on the fly.
  44.    - I removed the code that reset the port back to 9600 at shutdown, in
  45.      case you want to check it with a 'portinfo' type of program afterwards.
  46.    - A couple of people suggested a way of having one side send the game
  47.      settings to the other computer.  Because of code space, I decided to leave
  48.      that complicated feature out.  The 'Talk' and 'Configure' features should
  49.      take care of it.
  50.  
  51. CREDITS:
  52.  
  53.    - This program uses a lot of ideas from the following sources:
  54.      - My head.
  55.      - Several people on the net.
  56.      - Other sersetup-hack programs.
  57.      - And a little bit from Id software :-) :-)
  58.  
  59.      I am in no-way claiming this to be an original work.  Many people
  60.      contributed to ser4.  (and my mailbox, which has been over a hundred
  61.      messages lately :-)
  62.  
  63.      If you'd like to modify/fix/add something, have at it!  The source has
  64.      been uploaded to:
  65.       - wuarchive.wustl.edu  in /pub/MSDOS_UPLOADS/games/doomstuff/ser4_src.zip
  66.       - ocf.unt.edu  in  /pub/incoming/ser4_src.zip
  67.  
  68.      Many thanks to the following people for their help, suggestions, and
  69.      contributions:  (In no particular order)
  70.       - Dave Thomson <David.Thomson@newcastle.ac.uk>
  71.       - Michael Corrigan <corrigan@vnet.ibm.com>
  72.       - Steve Simpson <ssimpson@world.std.com>
  73.       - Brian "Paco" Hope <paco@cs.wm.edu>
  74.       - Z_VANDERBIJC@CCSVAX.SFASU.EDU
  75.       - Ron Zika <Ron_Zika.MMI@notes.worldcom.com>
  76.       - William Lewis <lewisw@oasys.dt.navy.mil>
  77.       - Steve Snyder <76447.3264@CompuServe.COM>
  78.       - DucK Whitney <quack@lobby.ti.com>
  79.       - Srinivas Thakkilapati <dz836@cleveland.Freenet.Edu>
  80.       - Vesselin Bontchev <bontchev@informatik.uni-hamburg.de>
  81.       - John Van Essen <vanes002@maroon.tc.umn.edu>
  82.       - BRYENTON  T <M0T3@UNB.CA>
  83.       And tons of others that I probably left out...
  84.  
  85. TROUBLESHOOTING:
  86.  
  87.    - For modem connections:
  88.      - Use the correct init strings!  Turn off compression, error correction,
  89.        and flow control.  Also fix the baud rate at the desired speed.  There
  90.        have been several cases of modems working at 9600, but not at 14400. 
  91.        If this happens to you, check the init string again.
  92.      - Be aware that some modems won't process anything after ATZ -- use the
  93.        second init string for other commands, or better yet, use AT&F instead.
  94.      - 8250 UARTs do not support 115200 baud.
  95.      - I tried 4800 baud with two 66's, and it was unplayable, so I left it out.
  96.      - The only two init strings I know for sure are:
  97.        - Gateway Telepath I (8250 UART):
  98.          AT &F S37=9 &K0 &Q0 %C0 N0 \G0 &D2 S46=0  (S37=11 for 14400 baud)
  99.        - Gateway Telepath II (16550 UART):
  100.          AT &F &K0 &M0 &N6   (&N8 for 14400 baud)
  101.    
  102.    - For null modem connections:
  103.      - Use a null modem (well, I had to say that).
  104.      - Select "Connected already", and then use the "Talk" feature to send
  105.        characters back and forth to check the line.  If they're not coming
  106.        across clearly, something's wrong -- check IRQs and base addresses for
  107.        conflicts with other ports or devices.
  108.       
  109.    - On 8250 UARTs, expect overrun errors, especially with higher baud rates.
  110.      The 8250 (=16450) UARTs only have a one byte send/receive buffer, so it
  111.      will occasionally overwrite a byte if Doom doesn't read it fast enough.
  112.      If this happens, you'll probably notice it as a slight delay while
  113.      playing, and it'll be reported as a UART Overrun Error in the stats.
  114.  
  115.    - With a 66 Mhz machine using a 16550 UART, I've seen "Read Bytes Per
  116.      Interrupt" around 3 to 3.5, and "Write Bytes Per Interrupt" around 7 to 8.
  117.      With a 66 Mhz machine using an 8250 UART, both numbers are usually 0.9.
  118.  
  119.    - Still won't work???  Well, I've run out of suggestions.  If you *do* get
  120.      it working, post your success story to the net to help someone else.
  121.  
  122. Good luck, I hope it works for you...
  123.  
  124. Russell Gilbert    (gilbert@esd.dl.nec.com)
  125.