home *** CD-ROM | disk | FTP | other *** search
/ Doom Magazine 1 / Doom_magazine_01.bin / utils / dmmaster / dmserdrv.doc < prev    next >
Text File  |  1994-04-06  |  13KB  |  463 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.          DMSERDRV - Replacement Serial Driver for DOOM 1.2
  28.          ─────────────────────────────────────────────────
  29.          (c) 1994, Simply Silly Software
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.  
  71.  
  72.  
  73.          About is DMSERDRV
  74.          ─────────────────
  75.  
  76.            When ID  Software  shipped  DOOM  1.2,  many  people looked
  77.            forward to playing 2 player's  via  serial.   We  had heard
  78.            about network  users  playing  multi-player   and  we  were
  79.            jealous.  Unfortunately,   when  the  MODEM  patch  finally
  80.            shipped, most player found it hard to configure and or use.
  81.  
  82.            The reason, SERSETUP was ID's programmer's first attempt at
  83.            creating a serial driver; and  it was not bad.  Most of the
  84.            problems resulted  from  not  having the right  modem  INIT
  85.            string.
  86.  
  87.            DMSERDRV, was  created to not only attempt to solve several
  88.            of the small bugs in the original  SERSETUP  code,  but  to
  89.            also add  upon it.  DMSERDRV is capable of supporting  baud
  90.            rates from  9600  to  115.2k  (included  16.8k).   It fixes
  91.            several of the slowdown bugs,  and expands on the MODEM.CFG
  92.            file.  But most importantly, it is 100% compatible with the
  93.            original SERSETUP.
  94.  
  95.  
  96.          COPYRIGHT AND WARRANTEE NOTICE
  97.          ──────────────────────────────
  98.  
  99.            The name DMSERDRV is (c) 1994, Simply Silly  Software,  but
  100.            the actual  program  has  been  released  in  to the public
  101.            domain.  All  we  ask, is you  distribute  it  without  any
  102.            modifications.
  103.  
  104.            The source code to DMSERDRV is available, but  only  if you
  105.            request it  from  us.   See  the section titled "Contacting
  106.            Simply Silly Software" for more information.
  107.  
  108.            There is no warrantee, either  expressed  or  implied.   We
  109.            have done  our  best  to test DMSERDRV, but  hey,  bugs  do
  110.            occur.  If  you  have a problem, or find a bug, then please
  111.            contact us.
  112.  
  113.  
  114.          SYSTEM REQUIREMENTS
  115.          ───────────────────
  116.            DMSERDRV has the same requirements  as  SERSETUP, except it
  117.            requires 65k of memory to run instead of 45k.   It has been
  118.            optimized for   size,  and  compiled  with  for  the  80386
  119.            instruction set for power.
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.  
  137.  
  138.  
  139.          INSTALLING DMSERDRV
  140.          ───────────────────
  141.  
  142.            If you are going to use DMSERDRV with either ID's SETUP.EXE
  143.            or a second party shell (such as MoDoom or Doom/Master 1.0)
  144.            other than  Doom/Master  2.0, then you will need to replace
  145.            SERSETUP.EXE with DMSERDRV.
  146.  
  147.            First, copy DMSERDRV in to your DOOM 1.2 directory.
  148.  
  149.            Next, rename SERSETUP.EXE to  SERSETUP.$$$  (ie: at the DOS
  150.            prompt, type "REN SERSETUP.EXE SERSETUP.$$$").
  151.  
  152.            Finally, rename DMSERDRV.EXE to SERSETUP.EXE  (ie:  at  the
  153.            DOS prompt, type "REN DMSERDRV.EXE SERSETUP.EXE").
  154.  
  155.            If you   are  going  to  use  DMSERDRV  with  Simply  Silly
  156.            Software's DOOM/MASTER 2.0,  then  simply copy DMSERDRV.EXE
  157.            in to your Doom directory, and in DM, select  Use  DMSERDRV
  158.            from the configuration menu.
  159.  
  160.  
  161.          DMSERDRV Command Line Switches
  162.          ──────────────────────────────
  163.  
  164.            DMSERDRV was  designed to be 100% compatible with SERSETUP,
  165.            from both the command line,  and  in  MODEM.CFG!  But there
  166.            have been  some  additional command line parameters  added.
  167.            Here is  a  full listing of DMSERDRV's parameters, and what
  168.            they do.
  169.  
  170.               -h             : displays an online help screen
  171.  
  172.               -com<x>        : Tell DMSERDRV which com port to use.
  173.                                <x> can be any value from 1-4.
  174.                                ex:  -com2
  175.  
  176.               -baud <rate>   : Selects the baud rate to communicate
  177.                                at.  Can be any value between 9600
  178.                                and 115200.  NOTE: It does not check
  179.                                to see if the baud rate is valid.
  180.  
  181.               -null          : Sets DMSERDRV up for a game via a
  182.                                null-serial cable.  It sets the
  183.                                baud rate automatically to 115200 and
  184.                                bypasses the dial or answer screens.
  185.  
  186.               -dial <number> : Dial a phone # and attempt to connect
  187.                                and play DOOM.
  188.  
  189.               -answer        :  Wait  for  the  phone  to  ring,  then
  190.                                attempt to connect and play DOOM.
  191.  
  192.  
  193.  
  194.  
  195.  
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.  
  203.  
  204.  
  205.          DMSERDRV Command Line Switches cont.
  206.          ────────────────────────────────────
  207.  
  208.            The following  switches,  are  used to help get DMSERDRV to
  209.            work with strange modems or serial ports.
  210.  
  211.               -uart <portaddr> : Selects the UART port address to use.
  212.                                  It must be entered in HEX, and be
  213.                                  proceeded with a "0x", ie: 0x3F8.
  214.  
  215.              -irq <number>     : Which irq to use.
  216.  
  217.              -vector <number>  : What interrupt vector do you wish to
  218.                                  use to  communicate  with  DOOM.   It
  219.                                  also must be entered  in  HEX  like -
  220.                                  uart.
  221.  
  222.              -sendwait <xx>     : When this command is added, DMSERDRV
  223.                                  will wait for xx milliseconds between
  224.                                  each character  when  sending a modem
  225.                                  command.  This fixes the problem with
  226.                                  several modems.
  227.  
  228.              -cmdwait <xx>      :  If  you  use  the cmdwait  command,
  229.                                  DMSERDRV will     wait     for     xx
  230.                                  milliseconds after sending the entire
  231.                                  modem command.
  232.  
  233.              -nofifo           : Forces DMSERDRV in to 8250 mode even
  234.                                  if a 16550 exists.
  235.  
  236.              -extratics        : Used to help slower modems
  237.  
  238.            All command line parameters,  will override anything in the
  239.            MODEM.CFG.
  240.  
  241.  
  242.          MODEM.CFG
  243.          ─────────
  244.  
  245.            When we  updated the serial routines, we also  expanded  on
  246.            the modem configuration file MODEM.CFG!  But, in order to
  247.            keep DMSERDRV  100%  compatible  with SERSETUP, the first 2
  248.            lines of MODEM.CFG remain the same.  So, the first line,
  249.            is your modem INIT string, and the second line is the modem
  250.            HANGUP string.
  251.  
  252.            We have added a third line.  This only, hold the modem DIAL
  253.            string.  The  original SERSETUP  forced  you  to  use  TONE
  254.            dialing, now you can select it.
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.  
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.  
  269.  
  270.  
  271.            After the  first  3  lines,  you  can  add  other  DMSERDRV
  272.            parameters.  They take the form "command=value".  Here is a
  273.            complete listing...
  274.  
  275.               comport=<x>         : Use COMx (-com)
  276.               baud=<rate>         : Switch to <rate> bps (-baud)
  277.               uart=<x>            : Use a different UART port (-uart)
  278.               irq=<x>             : Use a different IRQ isr (-irq)
  279.               vector=<xx>         : INT to talk to DOOM (-vector)
  280.               sendwait=<xx>       :  Pause  sending  char  (-sendwait)
  281.               cmdwait=<xx>        : Pause after sending (-cmdwait)
  282.               force8250=1         : Make 16550's act liek 8250's
  283.  
  284.            Notice how  all  of  the  options in the MODEM.CFG  have  a
  285.            command line  switch.   This  allows  you  to override your
  286.            MODEM.CFG at run time.  For  a  better  description of what
  287.            the option  does,  refer  to the section "DMSERDRV  Command
  288.            Line Switches."
  289.  
  290.  
  291.          Exiting DMSERDRV
  292.          ────────────────
  293.  
  294.            From anywhere  in DMSERDRV, if you press the <ESC> key, you
  295.            will exit back to dos, hanging  up  the  phone, and closing
  296.            down the serial port.
  297.  
  298.  
  299.          DMSERDRV, DOOM, and Modems
  300.          ──────────────────────────
  301.  
  302.            DOOM, is  a picky program when it comes to  how  you  setup
  303.            your modem.    This  is  because  of  the  way  DOOM  sends
  304.            information via modem (or serial).   Every time your screen
  305.            is refreshed, a data packet is sent out.  If  you  have any
  306.            extra features  of  your modem turned on, it will slow DOOM
  307.            down to a crawl.
  308.  
  309.            This is why the following 3 things  MUST (I REPEAT MUST) be
  310.            turned off.  Flow Control (also called handshaking), Error-
  311.            Correction protocol, and Compression.  IF YOU  DO  NOT TURN
  312.            THESE OFF,  neither  DMSERDRV or SERSETUP will work.  Refer
  313.            to your manual on how to turn them off.
  314.  
  315.            So other  important  things  we  found  out  while  testing
  316.            DMSERDRV.  First,  Doom  plays poorly when  hooked  from  a
  317.            486dx2-66 to  a  386-dx40.  Also, if you do not have a high
  318.            speed 16550 UART chip, then you  may not want to use 115200
  319.            bps when playing via null-serial.  It will lose  characters
  320.            on many machines.
  321.  
  322.  
  323.  
  324.  
  325.  
  326.  
  327.  
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334.  
  335.  
  336.  
  337.          What is Simply Silly Software
  338.          ─────────────────────────────
  339.  
  340.            Simply Silly   Software,   is  a  small  shareware  company
  341.            consisting of 2 people.  We are dedicated to creating
  342.            add-ons, trainers, cheats, and utilities for popular games
  343.            and may even produce a game or two ourselves.
  344.  
  345.  
  346.          Contacting Simply Silly Software
  347.          ────────────────────────────────
  348.  
  349.            The best way to contact SIMPLY  SILLY  SOFTWARE, is to send
  350.            us EMAIL at SILLYSFT@AOL.COM!  You can also phone us at
  351.            (914)336-4735 from  10:00am to 7:00pm est.   But  we  would
  352.            prefer email.
  353.  
  354.  
  355.          Coming Soon from Simply Silly Software
  356.          ──────────────────────────────────────
  357.  
  358.            Doom/Master 2.0 - avail now
  359.  
  360.              - DM  2.0  is the best DOOM shell out there.  It supports
  361.                both SERSETUP and DMSERDRV,  has  a  built in terminal,
  362.                phone book,  random  Episode/map, and network  support.
  363.                You can  also  configure not only the modem, but all of
  364.                the features of doom such  as  SoundCard, input device,
  365.                etc.  It is the perfect replacement for SETUP.EXE.
  366.  
  367.                registration fee: $5.00
  368.  
  369.  
  370.            Lands of Lord CD trainer - due April
  371.  
  372.              - This is a mega trainer to Virgin's Lands  of  Lore  CD.
  373.                It includes  the  ability  to  edit  characters online,
  374.                includes stats,  equipment,  and  spells.   Many  added
  375.                functions like no-clipping, god mode, etc.
  376.  
  377.                registration fee: $5.00
  378.  
  379.            Ultima 8 Pagan Character Editor - avail now
  380.  
  381.              - A character editor for Ultima 8, Pagan.
  382.  
  383.                registration fee: $5.00
  384.  
  385.  
  386.  
  387.  
  388.  
  389.  
  390.  
  391.  
  392.  
  393.  
  394.  
  395.  
  396.  
  397.  
  398.  
  399.  
  400.  
  401.  
  402.  
  403.                         And coming Spring/Summer of 94,
  404.  
  405.                      pcGAMEGOD - The ultimate cheat machine
  406.  
  407.                - supports simply codes that can be traded in magazines
  408.                  via BBS, or Email.
  409.                - also included MEGA-MODULES that include online
  410.                  character editors, and super trainers.
  411.                - the ability to view DOS text files without leaving
  412.                  the game.
  413.                - a BOSS key
  414.                - A  full  screen,  mouse driven interface that working
  415.                  inside the game.
  416.  
  417.          Special Thanks, and credits
  418.          ───────────────────────────
  419.  
  420.            DMSERDRV is a modified version of SERSETUP by ID software.
  421.            It was modified by Joseph M. Wilcox.
  422.  
  423.            I would like to thank the following people who help test
  424.            various version, or help with  sections  of  code I did not
  425.            understand.
  426.  
  427.            Andy, Rob, Lou, Cliff, Mike-D for help testing.
  428.  
  429.            To Sean  and  John at ID software for putting  up  with  my
  430.            questions.
  431.  
  432.            And many thanks to RUSSEL GILBERT (author for SER4) for the
  433.            help on the serial routines.
  434.  
  435.            And of course, Holly, for putting up with me for the past 2
  436.            weeks.
  437.  
  438.  
  439.  
  440.  
  441.  
  442.  
  443.  
  444.  
  445.  
  446.  
  447.  
  448.  
  449.  
  450.  
  451.  
  452.  
  453.  
  454.  
  455.  
  456.  
  457.  
  458.  
  459.  
  460.  
  461.  
  462.  
  463.