home *** CD-ROM | disk | FTP | other *** search
/ Programmer 7500 / MAX_PROGRAMMERS.iso / PROGRAMS / UTILS / MOUSE / MAPLPT.ZIP / MAPLPT.DOC < prev    next >
Encoding:
Text File  |  1989-08-11  |  10.4 KB  |  280 lines
  1.  
  2.  
  3.  
  4.                                 Instructions for
  5.                         MAPLPT -- LPT to COM port mapper
  6.             Copyright (C) Patrick Swayne 1988.  All Rights Reserved.
  7.  
  8.         ** Introduction
  9.  
  10.         MAPLPT is a program that allows you to use a serial printer on an
  11.         IBM compatible computer.  It maps output intended for a  parallel
  12.         (LPT)  port to one of the serial (COM) ports.  Like MODE, it  in-
  13.         stalls  a portion of itself into memory as a resident (TSR)  pro-
  14.         gram  to perform the mapping.  It goes beyond MODE,  however,  in
  15.         that  it supports all forms of handshaking likely to be  required
  16.         by a printer, and it supports baud rates to 38,400.
  17.  
  18.         MAPLPT was written by a user of Zenith computer equipment,  which
  19.         has the ability to map an LPT port to a COM port with handshaking
  20.         support  built  into the ROM BIOS.  This  capability  was  sorely
  21.         missed  when  I  aquired some non-Zenith equipment,  so  I  wrote
  22.         MAPLPT originally for my own benefit, and it has served me well.
  23.  
  24.         ** Distribution
  25.  
  26.         This program is distributed under the "Shareware" concept.   Feel
  27.         free  to use this program and give copies to others, as  long  as
  28.         you  include this documentation with the program, and as long  as
  29.         you do not modify either the program or this documentation.
  30.  
  31.         You may not sell this program for any amount, but you may  charge
  32.         a nominal fee (e.g. $5.00) for the disk on which it is distribut-
  33.         ed.   If you are a shareware distributor, it is recommended  that
  34.         you  combine this program with other utilities on a disk to  pro-
  35.         vide your customer a greater service.
  36.  
  37.         If you feel that this program is of value to you, please register
  38.         your copy by sending a contribution of $15 to
  39.  
  40.         Patrick Swayne
  41.         155 Baker St.
  42.         Coloma, MI 49038
  43.  
  44.         Registered users will receive a disk containing a copy of  MAPLPT
  45.         without the "Please register" message, and a copy of the assembly
  46.         source code for MAPLPT.
  47.  
  48.         Warranty
  49.  
  50.         This program is provided AS IS without any warranty, expressed or
  51.         implied,  including but not limited to fitness for  a  particular
  52.         purpose.
  53.  
  54.         Disclaimer
  55.  
  56.         In no event will Patrick Swayne be liable to you for any damages,
  57.         including any lost profits, lost savings, or other incidental  or
  58.         consequential  damages arising out of the use of or inability  to
  59.  
  60.  
  61.                                         1
  62.  
  63.  
  64.  
  65.  
  66.         use this program, even if Patrick Swayne has been advised of  the
  67.         possibility of such damages, or for any claim by any other party.
  68.  
  69.         ** Operation
  70.  
  71.         To  use MAPLPT, you must first copy MAPLPT.COM from this disk  to
  72.         your system disk, in the root directory or a directory pointed to
  73.         by  your  PATH description.  The syntax for operating  MAPLPT  is
  74.         nearly identical to the one for MODE, when it is used for mapping
  75.         an  LPT port to a COM port.  The differences are that  there  are
  76.         more items you can specify, you do not use a colon (:) after  the
  77.         LPT  port designation, and only one command line is used  to  map
  78.         the  port  and  set the baud rate and  other  settings.   To  use
  79.         MAPLPT, enter a command in this form.
  80.  
  81.           MAPLPT LPTn=COMn,baud,handshake,parity,data bits,stop bits,time out
  82.  
  83.         Here  is a description of the command line arguments.  The  n  in
  84.         LPTn  and COMn is a number that designates the ports you want  to
  85.         use,  as  in LPT1 or COM2.  The defaults, if you do  not  specify
  86.         anything, are LPT1 and COM1.  MAPLPT supports printer ports  LPT1
  87.         to  LPT4 (regardless of how many you actually have),  and  serial
  88.         ports  COM1  and COM2.  It also supports COM3 and COM4  if  their
  89.         port  addresses  are recorded at memory locations 40:2  and  40:3
  90.         (hex).
  91.  
  92.         The  baud  rates supported are 110, 150, 300,  600,  1200,  2400,
  93.         4800, 9600, 19200 and 38400.  The default baud rate is 9600.
  94.  
  95.         The handshaking modes supported are
  96.  
  97.         RTS[-] -- hardware handshaking via the RTS/CTS line.  Include the
  98.              - after RTS if negative polarity is used to indicate ready.
  99.         DTR[-] -- hardware handshaking via the DTR/DSR line.  Include the
  100.              - after DTR if negative polarity is used to indicate ready.
  101.         CMP -- compatibility mode.  Both the RTS and DTR lines monitored.
  102.         ETX(burst)  -- ETX/ACK software handshaking.  An  optional  burst
  103.              count  from 1 to 32 can be specified in parentheses,  as  in
  104.              ETX(20).   The count you specify is multiplied by 32 to  ob-
  105.              tain the actual count used.  The default count is 1  (making
  106.              an  actual count of 32).  Diablo printers that  use  ETX/ACK
  107.              handshaking  will print bi-directionally if you specify  the
  108.              largest burst count the printer can handle.
  109.         XON --  XON/XOFF software handshaking.  This kind of  handshaking
  110.              is also called DC1/DC3.
  111.         NONE -- no handshaking is used.
  112.  
  113.         The default handshaking mode is RTS positive.  You should consult
  114.         your  printer manual to determine the handshaking mode(s) it  re-
  115.         quires.
  116.  
  117.         Parity  checking is specified by indicating E for even parity,  O
  118.         for odd parity, or N for no parity.  The default is no parity.
  119.  
  120.         You can specify 7 or 8 data bits.  The default is 8.
  121.  
  122.  
  123.                                         2
  124.  
  125.  
  126.  
  127.  
  128.         You can specify 1 or 2 stop bits.  The default is 1.
  129.  
  130.         The  time out can be any number from 1 to 255.  It indicates  ap-
  131.         proximately  the number of seconds before MAPLPT returns  a  time
  132.         out error if the printer should signal that it is not ready for a
  133.         long time.  The default time out value is 20.
  134.  
  135.         As with MODE, you can leave out any of the command line arguments
  136.         by  typing  a comma in its place.  Here are  some  sample  MAPLPT
  137.         command entries.
  138.  
  139.           MAPLPT ,,DTR
  140.  
  141.         In  this  example, all of the defaults are used  except  for  the
  142.         handshaking, which is set to DTR positive.
  143.  
  144.           MAPLPT LPT1=COM2,,,,,,60
  145.  
  146.         In this example, LPT1 is mapped to COM2, and the time out is  set
  147.         to 60.  The defaults are used for the other settings.
  148.  
  149.           MAPLPT ,4800,RTS-,,,,40
  150.  
  151.         In this example, the baud rate is set to 4800, the handshaking is
  152.         set to RTS negative, and the time out is set to 40.  The defaults
  153.         are used for the other settings.
  154.  
  155.         MAPLPT  installs its resident portion into memory the first  time
  156.         you  run it after booting your operating system.  If you  run  it
  157.         again  later, it will make any changes required to  the  resident
  158.         part.   In addition to the settings described above, you can  use
  159.         these commands.
  160.  
  161.           MAPLPT D     To disable LPT to COM mapping.
  162.           MAPLPT       To  enable LPT to COM mapping (using current  set-
  163.                        tings).
  164.           MAPLPT  U    To  uninstall MAPLPT.  You can only  uninstall  if
  165.                        MAPLPT is the last TSR loaded.
  166.  
  167.         Each time you enter a MAPLPT command (except for the D or U  com-
  168.         mands), MAPLPT echoes the current settings so that you can verify
  169.         that they are correct.  For example, if you had just entered  the
  170.         third sample command line, MAPLPT would print
  171.  
  172.         LPT1=COM1,4800,RTS-,N,8,1,40
  173.  
  174.         You  can  take  advantage of this feature to  check  the  current
  175.         MAPLPT  settings  by entering MAPLPT with no  argument.   If  you
  176.         enter invalid information in a command line, MAPLPT will print
  177.  
  178.         Error in command line.
  179.  
  180.         It  will  accept any correct information up to the point  of  the
  181.         error,  and print the current settings so that you can  see  what
  182.         was accepted.
  183.  
  184.  
  185.                                         3
  186.  
  187.  
  188.  
  189.  
  190.         If you forget the command syntax for MAPLPT, and you do not  want
  191.         to read these instructions again, just enter
  192.  
  193.           MAPLPT ?
  194.  
  195.         and MAPLPT will print a screen of instructions.
  196.  
  197.         Using Printer Software
  198.  
  199.         Once  you have installed MAPLPT, any software that you have  that
  200.         uses  your printer should be configured to use the LPT  port  you
  201.         have  mapped,  not COM1 or COM2.  If your LPT port is  LPT1,  the
  202.         software  may  also be configured to use PRN.  However,  you  may
  203.         find that printing via LPT1 is faster than printing via PRN.
  204.  
  205.  
  206.  
  207.  
  208.  
  209.  
  210.  
  211.  
  212.  
  213.  
  214.  
  215.  
  216.  
  217.  
  218.  
  219.  
  220.  
  221.  
  222.  
  223.  
  224.  
  225.  
  226.  
  227.  
  228.  
  229.  
  230.  
  231.  
  232.  
  233.  
  234.  
  235.  
  236.  
  237.  
  238.  
  239.  
  240.  
  241.  
  242.  
  243.  
  244.  
  245.  
  246.  
  247.                                        4
  248.  
  249.          ----------------end-of-author's-documentation---------------
  250.  
  251.                         Software Library Information:
  252.  
  253.                    This disk copy provided as a service of
  254.  
  255.                         The Public (Software) Library
  256.  
  257.          We are not the authors of this program, nor are we associated
  258.          with the author in any way other than as a distributor of the
  259.          program in accordance with the author's terms of distribution.
  260.  
  261.          Please direct shareware payments and specific questions about
  262.          this program to the author of the program, whose name appears
  263.          elsewhere in  this documentation. If you have trouble getting
  264.          in touch with the author,  we will do whatever we can to help
  265.          you with your questions. All programs have been tested and do
  266.          run.  To report problems,  please use the form that is in the
  267.          file PROBLEM.DOC on many of our disks or in other written for-
  268.          mat with screen printouts, if possible.  The P(s)L cannot de-
  269.          bug programs over the telephone.
  270.  
  271.          Disks in the P(s)L are updated monthly, so if you did not get
  272.          this disk  directly from the P(s)L,  you should be aware that
  273.          the files in this set may no  longer be the current versions.
  274.  
  275.          For a copy of the latest monthly software library newsletter
  276.          and a list of the 1,900+ disks in the library, call or write
  277.  
  278.                         The Public (Software) Library
  279.                               P.O.Box 35705 - F
  280.                            Houston, TX 77235-5705
  281.                                (713) 665-7017
  282.  
  283.