home *** CD-ROM | disk | FTP | other *** search
/ The Complete Doom Accessory Pack 4 / TheCompleteDoomAccessoryPackVolumeIvCd.bin / miscutil / ser6 / ser6.txt < prev    next >
Text File  |  1994-11-21  |  13KB  |  231 lines
  1.                                    SER6.EXE
  2.                            DOOM SERIAL DEVICE DRIVER
  3.  
  4. NEW from SER5 to SER6:
  5.    - Full Compatability with Doom ][: Hell on Earth
  6.    - Added Player number setting in Configure
  7.    - Added a prompt before exiting
  8.    - Bug Fixes
  9.  
  10. FEATURES:
  11.    - "Talk" feature is now SPLIT screen...no more overwriting each other :)
  12.    - Dos Shell 
  13.    - Directory Listing and File Flagging  
  14.    - Displaying WadFile Map Directories.
  15.    - Configure Option almost completly rewritten.
  16.    - Autowarping for Pwads
  17.    - Configuration file now called SER6.CFG (instead of modem.cfg)
  18.      New Items to the CFG file:
  19.      * DOOM2=  To make SER6 compatable with DOOM ][: Hell on Earth.
  20.      * DOOMEXE=  To specify the Doom EXE to run if not 'doom'. 
  21.      * DOOMVER1_2= To tell SER6 not to use response files when calling doom.
  22.      * DIRECTORY=  To set the default location of Pwad files.
  23.      * WADNAME= If you play one Pwad all of the time, you can specify it here.
  24.      * NODROPDTR=  To tell SER6 not to drop DTR when exiting SER6. 
  25.      * ALTDEATH=  To enable the DeathMatch 2.0 (altdeath) feature.
  26.      * ALTBAUD=  For a secondary Baud rate, selectable at runtime.
  27.      * ALTBAUDINIT=  For a third init string, to be used with ALTBAUD.
  28.    - ZMODEM File Transfers:  To send files while in SER6.
  29.      ******PLEASE READ SER6.HLP, IT CONTAINS IMPORTANT NOTES******
  30.  
  31. FEATURES:  (As retained from SER4)
  32.    - Baud rates: 9600, 14400, 19200, 38400, 57600, 115200.
  33.    - Uses 'extratics=1' (whatever it is) which removes delays on some machines.
  34.    - All 'mod' operations removed which fixes slowdowns after 2 minutes.
  35.    - Many functions optimized to speed up communication.
  36.    - Compiled with several speed optimizations plus 80386 instructions instead
  37.         of 8088/8086.
  38.    - 'Talk' feature -- type msgs to your partner to debug com port setup, or
  39.         to decide on game features.
  40.    - 'Configure' option allows game settings to be modified after connecting.
  41.    - Port stays connected after game ends, allowing settings to be
  42.         re-configured and a new game started.
  43.    - Extensive statistics available at end of each game.
  44.    - Episode AND map settings to allow warping to another level.
  45.    - Lots of msgs printed during startup to help with debugging.
  46.    - 'Phonebook' list of names and numbers in modem.cfg, allowing dial-by-name.
  47.    - Two modem init strings in modem.cfg.
  48.    - Modem init strings sent slower - some modems had problems if sent too fast.
  49.    - All command-line arguments moved to modem.cfg file.
  50.  
  51. INSTALLATION:
  52.    - Change to your DOOM directory and unzip SER6.ZIP.
  53.    - Make a subdirectory named "TRANSFER" directly below your DOOM directory.
  54.    - Move DSZ0529X.ZIP to the TRANSFER directory and unzip it there.
  55.    - Read SER6.HLP for information regarding the new .CFG file switches and for
  56.         important information about the File Transfer option.
  57.    - Edit SER6.CFG to change computer/port settings(see help at bottom of file)
  58.    - Run "SER6" WITHOUT arguments.
  59.  
  60. NEW NOTES:
  61.    - Any parameter can be passed on to Doom by using the DEVPARM string in
  62.      either the SER6.CFG file or the Configure feature at runtime, whether it
  63.      requires -devparm or not.  See the list of other parameters in the Doom
  64.      FAQ which is included in the latest version of Doom, and on the ftp sites.
  65.      The Doom FAQ is currently DMFAQ58.TXT by Hank Leukart
  66.      <ap641@cleveland.freenet.edu>.
  67.    - For the problem of saving a game, and then getting different player
  68.      numbers (colors) when re-loading...  Use the PLAYER= line in SER6.CFG
  69.      to force each player number to either 0 or 1.  Note that this number is
  70.      zero-based, while the Doom startup screen is 1-based (1 or 2), and that
  71.      this is inconsistent because of Id's original SERSETUP code.  We decided
  72.      to keep it this way to avoid (further) confusion.  Also, note that Id's
  73.      original suggestion of using player number 1 on the slower computer
  74.      refers to the number in the SER6.CFG file, not the doom startup screen.
  75.    - About 3- and 4-player games...  The answer is, yes, it is possible, but
  76.      not with SER6, or any other code based off of SERSETUP.EXE.  There is a
  77.      program called RMSSETUP on the ftp sites that's supposed to allow more
  78.      than 2 players using serial com ports, and is based off of IPXSETUP.EXE,
  79.      which is the network code.  It has to use the net code because data
  80.      packets need to be sent to a particular player, rather than just the
  81.      "other player" as in the serial code.  RMSSETUP is currently RMS255B.ZIP
  82.      by Antony Suter <antony@werple.apana.org.au>, please ask him, not us :-) 
  83.  
  84. NOTES:  (As retained from SER4)
  85.    - Yes, this means id's setup.exe won't work with ser4.  But that's ok, 
  86.      because ser4 has far surpassed setup, so you don't need it anyway.  
  87.      I tried making it use the modem.cfg file, plus command-line args, plus 
  88.      being able to re-configure at run-time, and the amount of code was 
  89.      becoming enormous.  I decided that a 63K executable was pushing it 
  90.      already, and the extra prompting in ser4 probably removes the need 
  91.      for setup anyway.  Settings for the computer/port should only need 
  92.      to be done occasionally, so they're in the modem.cfg file.  Game 
  93.      settings are configurable on the fly.
  94.    - I removed the code that reset the port back to 9600 at shutdown, in
  95.      case you want to check it with a 'portinfo' type of program afterwards.
  96.    - A couple of people suggested a way of having one side send the game
  97.      settings to the other computer.  Because of code space, I decided to leave
  98.      that complicated feature out.  The 'Talk' and 'Configure' features should
  99.      take care of it.
  100.  
  101. TROUBLESHOOTING:
  102.    - For modem connections:
  103.     - Use the correct init strings!  Turn off compression and error correction.
  104.       Also fix the baud rate at the desired speed.  There have been several
  105.       cases of modems working at 9600, but not at 14400. If this happens to
  106.       you, check the init string again.
  107.     - Be aware that some modems won't process anything after ATZ -- use the
  108.       second init string for other commands, or better yet, use AT&F instead.
  109.     - 8250 UARTs do not support 115200 baud.
  110.     - You also might try using a separate communications program set to N81
  111.       to make the original connection and to test the link, then exit
  112.       without hanging up and start SER6 with "Connected already".
  113.     - For a list of Modem Init Strings, please see the list that comes with
  114.       the latest version of Doom, or the latest Doom FAQ.
  115.      
  116.    - For null modem connections:
  117.     - Use a null modem cable (well, I had to say that).
  118.     - Select "Connected already".
  119.  
  120.    - Try 9600 baud.  Slow computers may not be able to handle the higher rates.
  121.  
  122.    - Use the "Talk" feature to send characters back and forth to check the
  123.      line.  If they're not coming across clearly, something's wrong -- check
  124.      IRQs and base addresses for conflicts with other ports or devices.  Try
  125.      changing to another port, or disabling/removing the sound card, mouse,
  126.      etc. to check for a conflict.  Also try using a diagnostic program such
  127.      as Microsoft's MSD.EXE which comes with the later versions of DOS.
  128.       
  129.    - On 8250 UARTs, expect overrun errors, especially with higher baud rates.
  130.      The 8250 (=16450) UARTs only have a one byte send/receive buffer, so it
  131.      will occasionally overwrite a byte if it doesn't get read fast enough.
  132.      If this happens, you'll probably notice it as a slight delay while
  133.      playing, and it'll be reported as a UART Overrun Error in the stats.
  134.      However, you should be able to play just fine with any combination of
  135.      8250's and/or 16550's.
  136.  
  137.    - With a 66 Mhz machine using a 16550 UART, I've seen "Read Bytes Per
  138.      Interrupt" around 3 to 3.5, and "Write Bytes Per Interrupt" around 7 to 8.
  139.      With a 66 Mhz machine using an 8250 UART, both numbers are usually 0.9.
  140.  
  141.    - Still won't work???  Well, I've run out of suggestions.  If you *do* get
  142.      it working, post your success story to the net to help someone else.
  143.  
  144. SOURCE CODE:
  145.    - Full source code is available in SER6_SRC.ZIP (see below).
  146.    - SER6, SER4 and Id's original SERSETUP were all compiled using Borland's
  147.      C/C++ Compiler with a .PRJ project file (included in the source), which
  148.      contains the compile and link settings used.  We've also included a .MAK
  149.      makefile in case you'd like to use that instead.
  150.  
  151. WHERE TO GET IT:
  152.    - SER6.ZIP and SER6_SRC.ZIP are available by anonymous FTP from the usual
  153.      doom sites, including (as of Sep. 1, 1994):
  154.      - wuarchive.wustl.edu  /pub/MSDOS_UPLOADS/games/doomstuff/...
  155.      - infant2.sphs.indiana.edu  /pub/doom/...
  156.      - and infant2's current  /pub/doom mirrors:
  157.        ftp.cdrom.com  /pub/doom                                   California
  158.        ftp.iglou.com  /doom                                       Kentucky
  159.        ftp.orst.edu  /pub/gaming/doom     (weekly)                Oregon
  160.        nctuccca.edu.tw  /PC/games/DOOM                            Taiwan
  161.        ftp.luth.se  /pub/msdos/games/doom                         Sweden
  162.        ftp.uni-erlangen.de  /pub/pc/msdos/games/ID/doom-stuff     Germany
  163.      (Check the 'incoming' directories also in case it hasn't been moved yet.)
  164.    - We're also posting SER6.ZIP to alt.binaries.doom, but only once.  Please
  165.      try the FTP BY MAIL option below if you miss it and don't have ftp access.
  166.  
  167. FTP BY MAIL:
  168.    - If you don't have FTP access, try the FTP mail server.  Send mail to:
  169.      ftpmail@decwrl.dec.com   with the following as the msg:
  170.           reply <your.mail.address>
  171.           connect <ftp.site.name>
  172.           binary
  173.           chdir <directory>
  174.           uuencode
  175.           chunksize 49000   (Use this if on CompuServe. Default is 64000 bytes)
  176.           get <filename>
  177.  
  178.      The file will then be uuencoded and mailed to you in chunks.  Put the mail
  179.      msgs in order into one file and uudecode it to create the requested file.
  180.      To get a directory listing, use the command "dir <directory>".
  181.      To have a full help file mailed to you, use the command "help".
  182.  
  183. THANKS:
  184.    - Many Thanks to Id Software for releasing the original SERSETUP source,
  185.         and making an incredible game.  (Without Doom, we'd have no reason to
  186.         spend weeks working on this code)
  187.    - To the progrmamers of DEU.....whose nicely documented source code
  188.         helped me track down some discrepencies in Borland C++'s documentation.
  189.    - To Jeff Baker:  A good friend who helped me catch my errors and for 
  190.         letting me use his computers with a NULL modem.
  191.    - To Brian Plumb <r3bmp@dax.cc.uakron.edu>:  Helped me with Beta Testing
  192.         and gave me a few ideas.
  193.    - This program uses a lot of ideas from the following sources:
  194.      - Many late nights of trying to be creative.
  195.      - Several people from "alt.games.doom" on the internet.
  196.      - Other SERSETUP-hack programs.
  197.  
  198. HISTORY:
  199.    - 03/19/94 - SER4 released by Russell Gilbert.
  200.    - 09/09/94 - SER5 released. The new user interface was programmed by
  201.                   Paul Hermann and debugged by Paul Hermann and 
  202.                   Russell Gilbert. 
  203.    - 11/22/94 - SER6 released
  204.  
  205. COPYRIGHT INFORMATION:
  206.    - Doom and Doom ][ are copyrighted by Id Software.
  207.    - Pkzip is copyrighted by PKWARE Inc.
  208.    - DSZ is copyrighted by Omen Technologies Inc.  The DSZ archive 
  209.         distributed with SER6 MUST be distributed in its original form.
  210.    - SER6 is based on the SERSETUP source code provided by Id Software.
  211.         SER6 is Freeware and may be distributed any way that you wish, 
  212.         provided that the archive is distributed in its original form.
  213.    - Source code is freely provided, and you are allowed to make 
  214.         modifications for personal use ONLY.  If you are interested in 
  215.         modifying SER6 for a public release, please contact the authors for
  216.         permission.
  217.    Note: Although SER6 is freeware, donations will be freely accepted.  
  218.         Feel free to contact us through our E-mail address if you are
  219.         interested in making a donation.
  220.  
  221. DISCLAIMERS:
  222.    - Id Software will not provide support for SER6, so don't ask them.
  223.    - Although it should never happen... the authors of SER6 will not be held
  224.      liable for any loss of data or damage to hardware that may be caused by
  225.      using SER6.
  226.  
  227. Good luck, we hope it works for you...
  228.  
  229. Paul Hermann       (hermann@vision.poly-eng.uakron.edu)
  230. Russell Gilbert    (NEW ADDRESS---> b804683@csc1.ftw.bnr.com)
  231.