home *** CD-ROM | disk | FTP | other *** search
/ CP/M / CPM_CDROM.iso / cpm / mex / mxo-kp50.lbr / MXO-KP50.IZF / MXO-KP50.INF
Text File  |  1987-03-08  |  9KB  |  196 lines
  1.     Title  MEX Overlay for the Kaypro Computer Version 5.0
  2.  
  3.     NOTE:  formerly this overlay provided Smartmodem
  4.   support and was thus a 'MIXED' overlay.  This reduced it's usefulness.
  5.   All smartmodem code has been removed, and the user must, if planning
  6.   to use an external modem, obtain the appropriate modem overlay
  7.   (MXM-xxxx.ASM) to use with this overlay.  Without one you can still
  8.   use the int modem (and the external serial port for direct connections),
  9.   but dialing on an external modem will not work through MEX.
  10.  
  11.     This overlay has only been tested using MEX114.COM.  Although
  12.   a MexPlus equate has been added, using existing MXH-*.ASM overlays
  13.   as a guide, the effect of this has not been fully tested.  Hopefully
  14.   some MEX guru out there will test this with MexPlus and verify that
  15.   it works:  I currently don't have access to MexPlus.    --Tim Farley
  16.  
  17.     If you plan to use both the internal and external modems,
  18.   you must MLOAD the modem overlay AFTER this overlay, so this
  19.   overlay can find the modem overlay's dialing code, etc.  Example:
  20.  
  21.         MLOAD MEX.COM=MEXxxx.COM,MXO-KPyy,MXM-zzzz
  22.  
  23.   would prepare MEX to be used with the internal modem, and an external
  24.   modem (assuming both overlays were assembled properly).  The modem
  25.   overlay (MXM-zzzz.ASM) must org above 0B00h or it will conflict
  26.   with this overlay. (Some modem overlays ORG at 0A00 or even as
  27.   low as 0900, you need to check yours.)
  28.  
  29. ------------------------------------------------------------
  30.  
  31.         SPECIAL FEATURES OF THIS OVERLAY:
  32.  
  33.   * Supports both internal and external modems, with easy switching
  34.     between the two.  You can even have both of them active
  35.     at the same time and switch 'on the fly', assuming you have
  36.     two phone lines, and don't get timed out by the host(s)!
  37.   * Automatically detects drop of carrier on a modem connection
  38.     and informs the user, disconnecting the phone in the process.
  39.     Avoids 'typing at a dial tone' when you don't realize you've
  40.     lost a connection (esp. on internal modem & during file xfers).
  41.   * Automatically detects active modem(s) when re-entering from CP/M,
  42.     notifies the user, and selects the modem in question for a speedier
  43.     return to your connection.  'Live' modems will be flagged with '(*)'.
  44.   *  Flags communication paramaters and baud rate as possibly being wrong
  45.     when examined via SET, but connection will not be affected as
  46.     paramaters are NOT changed on a live connection.  (Parameters so
  47.     affected will be marked with '(?)' until changed with SET).
  48.   * Strips DEL, '{' and '}' from input stream (converts to nulls) to clean
  49.     up noisy 1200 and 2400 baud lines.  Shuts this off during file xfers.
  50.   * Supports use of most dial modifier characters in dial strings for
  51.     the internal modem: 'T' switches to tone, 'P' switches to pulse,
  52.     ',' sends a delay set by DIALWT, '*' and '#' send the appropriate
  53.     Touch-Tone characters if dialer is currently in tone mode.
  54.     (Note that 'A,' 'B,' 'C,' and 'D' can't be generated by the chip.)
  55.     Exclamation mark sends a 'Flash' (1/2 second on hook--used for
  56.     three way calling and for call transfers on PBX systems),
  57.     'R' at end of string initiates call in answer mode (Reverse), and
  58.     ';' at end of string returns to command mode with phone still off
  59.     hook.  (NOTE: other Smartmodem dial modifiers 'W' and '@'
  60.     are physically impossible with internal modem.    Also, since ';'
  61.     is the default multiple command separator for MEX, you
  62.     either have to STAT SEP to some other character than ';', or
  63.     assign the dial string to a label in a .PHN file.)
  64.   * Hit any key to manually time-out current dial, ^C to abort all dialing.
  65.     This allows you to manually skip to next number when auto-dialing,
  66.     when you hear a busy signal or no answer, avoiding the long wait
  67.     for a time-out.
  68.   * Software emulation of many Smartmodem features for 'dumb' internal
  69.     modem, including auto-answer.
  70.   * Designed to automatically work with logical modem overlays without
  71.     setting of any special equates.
  72.  
  73. ------------------------------------------------------------
  74.  
  75.     A full-featured SET command processor is implemented to select
  76.   between modems as well as set specific characteristics of the internal
  77.   modem and the communication characteristics of the external modem.
  78.   The following table outlines the SET command options:
  79.  
  80.                        Available for
  81.     SET Command             Internal          External
  82.  
  83.     INTERNAL            YES        YES
  84.     EXTERNAL            YES        YES
  85.  
  86.     TONE (dialing)            YES        YES (*)
  87.     PULSE (dialing)         YES        YES (*)
  88.  
  89.     ANSWER (Auto-answer phone)    YES        NO  (use SSET)
  90.     MANO (Manually turn on carrier    YES        NO
  91.         tone for Originate mode)
  92.     MANA (Manually turn on carrier    YES        NO
  93.         tone for Answer mode)
  94.  
  95.     DELAY <n> (seconds)        YES        NO  (use SSET)
  96.  
  97.     BAUD <rate>            NO        YES
  98.     LENGTH (5, 6, 7, or 8)        YES        YES
  99.     PARITY (Odd, Even, None)    YES        YES
  100.     STOPBITS (1, 1.5, 2)        YES        YES
  101.  
  102.     (*)  Be sure your modem overlay maintains a TONE/PULSE
  103.     flag at the standard location TPULSE at 105H.  Most
  104.     overlays do, but if yours doesn't, SET TONE and SET
  105.     PULSE will not affect the external modem.
  106.  
  107. ------------------------------------------------------------
  108.  
  109.   NOTE ON INSTALLATION:
  110.  
  111.         (1) To make the garbage character strip work, the
  112.     overlay also ALWAYS strips the parity bit, regardless of
  113.     FILTER setting, except during file transfers.
  114.     Since MEX never sends high bits to the screen anyway,
  115.     this only effects DEBUG displays and TERM files.  Set BADCH1,
  116.     BADCH2 and BADCH3 all to nulls and re-assemble if you need
  117.     to disable parity stripping for some application.  (You
  118.     might want to do this if you plan only to use the internal
  119.     modem, since it never operates at 1200 or 2400 baud).
  120.  
  121.         (2) Note that your external modem must operate
  122.     DCD for the Carrier detect logic to work properly.  If
  123.     it always keeps DCD high (like the Hayes will on default
  124.     settings) when you enter from CP/M, MEX will 'think' you
  125.     have an active line.  It will never erroneously hang up
  126.     your connection, unless your modem drops DCD low erroneously,
  127.     but it will keep flagging the modem with (*) because it
  128.     will think carrier is present.    On the Hayes 1200, set
  129.     switch 6 (Carrier status detect) UP to enable carrier
  130.     detect.  On the Hayes 2400, issue the command "AT&C1&W"
  131.     On other modems, consult your manual.
  132.  
  133. ------------------------------------------------------------
  134.  
  135.   NOTE ON COMPATIBILITY, FOR
  136.   OWNERS OF OLDER MODEL KAYPRO II OR 4
  137.  
  138.   This overlay will work with ALL Kaypro 8-bit CP/M
  139.   computers released to date including the original
  140.   Kaypro II & 4 and the more recent models with graphics -
  141.   the 1, New 2, 2X, 4-84 and 10.
  142.  
  143.   Version 5.0 has specifically been tested on old (1983 models)
  144.   2 and 10 (CP/M 2.2G and H); and on newest (1985) 1, 2X and 10
  145.   (CP/M 2.2u1).
  146.  
  147.   Obviously, if your Kaypro has no internal modem, the
  148.   SET INTERNAL command will be non-functional.
  149.   If you never intend to use MEX on a Kaypro with such a
  150.   modem, you can set the symbol INTRN to NO and all internal
  151.   modem code will be left out at assembly time, saving room
  152.   in the overlay area.    This also avoids erroneous carrier
  153.   detect on non-existant internal modem (DCD floats high on
  154.   many models without the SIO and modem chips present).
  155.  
  156.   If you do leave the internal modem code in and use MEX on
  157.   units without internal modems, (maybe you have more than one Kaypro?)
  158.   typing DSC while the internal is selected will make MEX
  159.   attempt to recognize whether the internal modem is present.
  160.   If it can determine, that no internal modem is actually
  161.   present, it will flag all future references to
  162.   the internal modem as errors.  You can put "SET INTERNAL;DSC"
  163.   in your INI.MEX file to do this every session, and only have
  164.   to have one version of MEX.COM around.
  165.  
  166. ------------------------------------------------------------
  167.  
  168.   This overlay is intended to be fully compatible with the
  169.   MEX structure and should be readily upward compatible with
  170.   the predicted MEX 2.0.
  171.  
  172.   Calling conventions for the various overlay entry points
  173.   are detailed more fully in the PMMI overlay (MXO-PMxx.ASM,
  174.   where xx=revision number).
  175.  
  176. ------------------------------------------------------------
  177.  
  178.   Credits:
  179.  
  180.   M7KP-1 overlay structure by Irv Hoff
  181.   Internal modem support by John Smith.
  182.   MXO-KP overlay structure also by John Smith.
  183.  
  184. ------------------------------------------------------------
  185.  
  186.   Updates, Bug Reports:
  187.  
  188.     Previous 'owners' of this overlay seem to have
  189.     abandoned it, so I will take bug/update reports
  190.     on Tom Brady's Decibel RCP/M, 404-288-6858, 300/1200/2400.
  191.  
  192.                     --Tim Farley
  193.                       Atlanta, GA
  194.  
  195. ------------------------------------------------------------
  196.