home *** CD-ROM | disk | FTP | other *** search
/ Action Ware 12: Heretic & Hexen / actionware12.iso / acware12 / network / ser7 / ser7.txt < prev    next >
Text File  |  1995-07-27  |  11KB  |  223 lines
  1.                                    SER7.EXE
  2.                 DOOM, DOOM ][, and HERETIC SERIAL DEVICE DRIVER
  3.  
  4. New Features from SER6 to SER7
  5. -Completely New Mouse Driven Interface(sorry only mouse driven for now)
  6. -Make configuration changes while you Chat
  7. -Works with All Current Versions of Doom, Doom ][ and Heretic
  8. -Works with Ultimate Doom (Supports episode 4)
  9. -Works with Heretic
  10. -One Copy of SER7 can interface All games
  11. -Phone Book (SER7.PBK) with Capability of Changing Options
  12.  from Person to Person
  13. -Select Files from Multiple Directories
  14. -Display Text from Saved Game Files.
  15. -Advanced Configuration capability for those who want to play with 
  16.     Extratics and TicDup parameters.
  17. -Many other Changes to the SER7.CFG file.  Explanations in the CFG file.
  18.  
  19. Changes from SER6 to SER7
  20. -File Transfers have been removed from the Core Program
  21.     It was too much code to include in SER7, and it is extremely easy to 
  22.     send files from a Ser7 Dos Shell.  I just felt that a few hundred lines
  23.     code was not worth something that could be done from Dos Shell in one
  24.     Command.  Examples will be included.
  25.  
  26. FEATURES:  (As retained from SER4, SER5, SER6)
  27.   - "Talk" feature is now SPLIT screen...no more overwriting each other :)
  28.   - Dos Shell 
  29.   - Directory Listing and File Flagging  
  30.   - Displaying WadFile Map Directories.
  31.   - Autowarping for Pwads
  32.   - Baud rates: 9600, 14400, 19200, 38400, 57600, 115200.
  33.   - Uses 'extratics=1' by default 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.   - 'Configure' option allows game settings to be modified after connecting.
  37.   - Port stays connected after game ends, allowing settings to be
  38.        re-configured and a new game started.
  39.   - Extensive statistics available at end of each game.
  40.   - Episode AND map settings to allow warping to another level.
  41.   - Lots of msgs printed during startup to help with debugging.
  42.   - Two modem init strings in modem.cfg.
  43.   - Modem init strings sent slower - some modems had problems if sent too fast.
  44.   - All command-line arguments moved to modem.cfg file.
  45.  
  46. INSTALLATION
  47.    - Unzip SER7.ZIP into any Subdirectory
  48.    - Edit SER7.CFG and Set the Following
  49.     - ALL Game Executables and Locations
  50.     - Default Wad Directory for Each Game
  51.     - Hardware Settings
  52.     - Default values for SER7
  53.    - Edit SER7.PBK
  54.     - Add Phonebook entries for people you call
  55.         - Include any Configuration Changes from the Defaults for that person
  56.    - Play
  57. *NOTE The configuration Files have Changed Significantly, please Do not
  58.   use your SER6 Config files.  Edit the included SER7.CFG with your old
  59.   CFG file as a reference.
  60.  
  61. NOTES:
  62.    - Any parameter can be passed on to Doom by using the MISC string in
  63.      either the SER7.CFG file or the Configure feature at runtime, whether it
  64.      requires -devparm or not.  See the list of other parameters in the Doom
  65.      FAQ which is included in the latest version of Doom, and on the ftp sites.
  66.      The Doom FAQ is currently DMFAQ666.TXT by Hank Leukart
  67.      <ap641@cleveland.freenet.edu>.
  68.    - For the problem of saving a game, and then getting different player
  69.      numbers (colors) when re-loading...  Use the PLAYER= line in SER6.CFG
  70.      to force each player number to either 0 or 1.  Note that this number is
  71.      zero-based, while the Doom startup screen is 1-based (1 or 2), and that
  72.      this is inconsistent because of Id's original SERSETUP code.  We decided
  73.      to keep it this way to avoid (further) confusion.  Also, note that Id's
  74.      original suggestion of using player number 1 on the slower computer
  75.      refers to the number in the SER6.CFG file, not the doom startup screen.
  76.    - About 3- and 4-player games...  The answer is, yes, it is possible, but
  77.      not with SER6, or any other code based off of SERSETUP.EXE.  There is a
  78.      program called RMSSETUP on the ftp sites that's supposed to allow more
  79.      than 2 players using serial com ports, and is based off of IPXSETUP.EXE,
  80.      which is the network code.  It has to use the net code because data
  81.      packets need to be sent to a particular player, rather than just the
  82.      "other player" as in the serial code.  RMSSETUP is currently RMS255B.ZIP
  83.      by Antony Suter <antony@werple.apana.org.au>, please ask him, not us :-) 
  84.  
  85.    - A couple of people suggested a way of having one side send the game
  86.      settings to the other computer.  I have really thought about that and
  87.      decided not to put this in due to code constraints and I don't feel like 
  88.      coding it :)
  89.  
  90. TROUBLESHOOTING:
  91.    - For modem connections:
  92.     - Use the correct init strings!  Turn off compression and error correction.
  93.       Also fix the baud rate at the desired speed.  There have been several
  94.       cases of modems working at 9600, but not at 14400. If this happens to
  95.       you, check the init string again.  Check the DOOM FAQ for proper settings.
  96.     - Be aware that some modems won't process anything after ATZ -- use the
  97.       second init string for other commands, or better yet, use AT&F instead.
  98.     - 8250 UARTs do not support 115200 baud.
  99.     - You also might try using a separate communications program set to N81
  100.       to make the original connection and to test the link, then exit
  101.       without hanging up and start SER6 with "Connected already".
  102.     - For a list of Modem Init Strings, please see the list that comes with
  103.       the latest version of Doom, or the latest Doom FAQ.
  104.      
  105.    - For null modem connections:
  106.     - Use a null modem cable (well, I had to say that).
  107.     - Select "Connected already".
  108.  
  109.    - Try 9600 baud.  Slow computers may not be able to handle the higher rates.
  110.  
  111.    - Use the "Talk" feature to send characters back and forth to check the
  112.      line.  If they're not coming across clearly, something's wrong -- check
  113.      IRQs and base addresses for conflicts with other ports or devices.  Try
  114.      changing to another port, or disabling/removing the sound card, mouse,
  115.      etc. to check for a conflict.  Also try using a diagnostic program such
  116.      as Microsoft's MSD.EXE which comes with the later versions of DOS.
  117.       
  118.    - On 8250 UARTs, expect overrun errors, especially with higher baud rates.
  119.      The 8250 (=16450) UARTs only have a one byte send/receive buffer, so it
  120.      will occasionally overwrite a byte if it doesn't get read fast enough.
  121.      If this happens, you'll probably notice it as a slight delay while
  122.      playing, and it'll be reported as a UART Overrun Error in the stats.
  123.      However, you should be able to play just fine with any combination of
  124.      8250's and/or 16550's.
  125.  
  126.    - With a 66 Mhz machine using a 16550 UART, I've seen "Read Bytes Per
  127.      Interrupt" around 3 to 3.5, and "Write Bytes Per Interrupt" around 7 to 8.
  128.      With a 66 Mhz machine using an 8250 UART, both numbers are usually 0.9.
  129.  
  130.    - Still won't work???  Well, I've run out of suggestions.  If you *do* get
  131.      it working, post your success story to the net to help someone else.
  132.  
  133. SOURCE CODE:
  134.    - Source Code is not Currently Availiable.  I put many many hours into
  135.      creating my own Graphics Libraries and really do not wish to distribute
  136.      them.  This is not to say I'll never release them....just not right now.
  137.  
  138. WHERE TO GET IT:
  139.    - SER7.ZIP is available by anonymous FTP from the usual doom sites:
  140.      - ftp.cdrom.com  /pub/doom/...
  141.      - Mirrors of the Doom Archive.        
  142.      (Check the 'incoming' directories also in case it hasn't been moved yet.)
  143.  
  144. World Wide Web:
  145.    - The SER7 Homepage at http://www.poly-eng.uakron.edu/~hermann
  146.    - I have some Screen Shots from SER7 on my home Page...feel free to take a
  147.      look.  Of course you'll need a Browser Compatable with NETSCAPE v1.1N
  148.    - A Full Color Jpeg of the SER7 Title Screen is availiable there.
  149.    - SER7 will be availiable here unless the traffic becomes too heavy, but
  150.      please get it from the FTP sites.
  151.  
  152. FTP BY MAIL:
  153.    - If you don't have FTP access, try the FTP mail server.  Send mail to:
  154.      ftpmail@decwrl.dec.com   with the following as the msg:
  155.           reply <your.mail.address>
  156.           connect <ftp.site.name>
  157.           binary
  158.           chdir <directory>
  159.           uuencode
  160.           chunksize 49000   (Use this if on CompuServe. Default is 64000 bytes)
  161.           get <filename>
  162.  
  163.      The file will then be uuencoded and mailed to you in chunks.  Put the mail
  164.      msgs in order into one file and uudecode it to create the requested file.
  165.      To get a directory listing, use the command "dir <directory>".
  166.      To have a full help file mailed to you, use the command "help".
  167.  
  168. THANKS:
  169.    - Many Thanks to Id Software for releasing the original SERSETUP source,
  170.         and making an incredible game.  (Without Doom, we'd have no reason to
  171.         spend weeks working on this code)
  172.    - To Brian Plumb <brian@hobbes.polymer.uakron.edu>:  Who created that COOL
  173.         SER7 Title Screen, and Helped me with Beta Testing.
  174.    - To Jeff Baker:  A good friend who helped me catch my errors and for 
  175.         letting me use his computers with a NULL modem.
  176.    - This program uses a lot of ideas from the following sources:
  177.      - Many late nights of trying to be creative.
  178.      - Several people from "alt.games.doom" on the internet.
  179.      - Other SERSETUP-hack programs.
  180.  
  181. Title Screen:
  182.    - The Screen Shots are from Ultimate Doom, DOOM ][ and Heretic, please note the 
  183.      copyright info below.
  184.    - The screen was created using AutoCad Release 13 and Autovision to render the
  185.      objects.
  186.  
  187. HISTORY:
  188.    - 03/19/94 - SER4 released by Russell Gilbert.
  189.    - 09/09/94 - SER5 released. The new user interface was programmed by
  190.                   Paul Hermann and debugged by Paul Hermann and 
  191.                   Russell Gilbert. 
  192.    - 11/22/94 - SER6 released adding Doom ][ Support
  193.    - 07/28/95 - SER7 released.  All Programming Done by Paul Hermann with
  194.                   moral support from Russell Gilbert.
  195.  
  196. COPYRIGHT INFORMATION:
  197.    - Doom and Doom ][ are copyrighted by Id Software. 
  198.         http://www.idsoftware.com
  199.    - Heretic is Copyrighted by Raven and Id Software.
  200.    - Pkzip is copyrighted by PKWARE Inc.
  201.    - DSZ is copyrighted by Omen Technologies Inc. (I'm sure I'll mention them)
  202.    - AutoCad and AutoVision are copyrights of AutoDesk Inc.
  203.    - SER7 is based on the SERSETUP source code provided by Id Software.
  204.         SER7 is Freeware and may be distributed any way that you wish, 
  205.         provided that the archive is distributed in its original form.
  206.    - All graphical Aspects of SER7 and its interface is entirely my original
  207.         work with the exeption of the mouse routines in which I derived my
  208.         routines from MOUSE ++ v4.0 Copyright (c)1992 by Carl Moreland.
  209.    Note: Although SER7 is freeware, donations will be freely accepted.  
  210.         Feel free to contact us through our E-mail address if you are
  211.         interested in making a donation.
  212.  
  213. DISCLAIMERS:
  214.    - Id Software will not provide support for SER7, so don't ask them.
  215.    - Although it should never happen... the authors of SER7 will not be held
  216.      liable for any loss of data or damage to hardware that may be caused by
  217.      using SER7.
  218.  
  219. Good luck, hope it works for you...
  220.  
  221. Paul Hermann       (hermann@poly-eng.uakron.edu)
  222.  
  223.