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.         use this program, even if Patrick Swayne has been advised of  the
  66.         possibility of such damages, or for any claim by any other party.
  67.  
  68.         ** Operation
  69.  
  70.         To  use MAPLPT, you must first copy MAPLPT.COM from this disk  to
  71.         your system disk, in the root directory or a directory pointed to
  72.         by  your  PATH description.  The syntax for operating  MAPLPT  is
  73.         nearly identical to the one for MODE, when it is used for mapping
  74.         an  LPT port to a COM port.  The differences are that  there  are
  75.         more items you can specify, you do not use a colon (:) after  the
  76.         LPT  port designation, and only one command line is used  to  map
  77.         the  port  and  set the baud rate and  other  settings.   To  use
  78.         MAPLPT, enter a command in this form.
  79.  
  80.           MAPLPT LPTn=COMn,baud,handshake,parity,data bits,stop bits,time out
  81.  
  82.         Here  is a description of the command line arguments.  The  n  in
  83.         LPTn  and COMn is a number that designates the ports you want  to
  84.         use,  as  in LPT1 or COM2.  The defaults, if you do  not  specify
  85.         anything, are LPT1 and COM1.  MAPLPT supports printer ports  LPT1
  86.         to  LPT4 (regardless of how many you actually have),  and  serial
  87.         ports  COM1  and COM2.  It also supports COM3 and COM4  if  their
  88.         port  addresses  are recorded at memory locations 40:2  and  40:3
  89.         (hex).
  90.  
  91.         The  baud  rates supported are 110, 150, 300,  600,  1200,  2400,
  92.         4800, 9600, 19200 and 38400.  The default baud rate is 9600.
  93.  
  94.         The handshaking modes supported are
  95.  
  96.         RTS[-] -- hardware handshaking via the RTS/CTS line.  Include the
  97.              - after RTS if negative polarity is used to indicate ready.
  98.         DTR[-] -- hardware handshaking via the DTR/DSR line.  Include the
  99.              - after DTR if negative polarity is used to indicate ready.
  100.         CMP -- compatibility mode.  Both the RTS and DTR lines monitored.
  101.         ETX(burst)  -- ETX/ACK software handshaking.  An  optional  burst
  102.              count  from 1 to 32 can be specified in parentheses,  as  in
  103.              ETX(20).   The count you specify is multiplied by 32 to  ob-
  104.              tain the actual count used.  The default count is 1  (making
  105.              an  actual count of 32).  Diablo printers that  use  ETX/ACK
  106.              handshaking  will print bi-directionally if you specify  the
  107.              largest burst count the printer can handle.
  108.         XON --  XON/XOFF software handshaking.  This kind of  handshaking
  109.              is also called DC1/DC3.
  110.         NONE -- no handshaking is used.
  111.  
  112.         The default handshaking mode is RTS positive.  You should consult
  113.         your  printer manual to determine the handshaking mode(s) it  re-
  114.         quires.
  115.  
  116.         Parity  checking is specified by indicating E for even parity,  O
  117.         for odd parity, or N for no parity.  The default is no parity.
  118.  
  119.         You can specify 7 or 8 data bits.  The default is 8.
  120.  
  121.  
  122.                                         2
  123.  
  124.  
  125.  
  126.         You can specify 1 or 2 stop bits.  The default is 1.
  127.  
  128.         The  time out can be any number from 1 to 255.  It indicates  ap-
  129.         proximately  the number of seconds before MAPLPT returns  a  time
  130.         out error if the printer should signal that it is not ready for a
  131.         long time.  The default time out value is 20.
  132.  
  133.         As with MODE, you can leave out any of the command line arguments
  134.         by  typing  a comma in its place.  Here are  some  sample  MAPLPT
  135.         command entries.
  136.  
  137.           MAPLPT ,,DTR
  138.  
  139.         In  this  example, all of the defaults are used  except  for  the
  140.         handshaking, which is set to DTR positive.
  141.  
  142.           MAPLPT LPT1=COM2,,,,,,60
  143.  
  144.         In this example, LPT1 is mapped to COM2, and the time out is  set
  145.         to 60.  The defaults are used for the other settings.
  146.  
  147.           MAPLPT ,4800,RTS-,,,,40
  148.  
  149.         In this example, the baud rate is set to 4800, the handshaking is
  150.         set to RTS negative, and the time out is set to 40.  The defaults
  151.         are used for the other settings.
  152.  
  153.         MAPLPT  installs its resident portion into memory the first  time
  154.         you  run it after booting your operating system.  If you  run  it
  155.         again  later, it will make any changes required to  the  resident
  156.         part.   In addition to the settings described above, you can  use
  157.         these commands.
  158.  
  159.           MAPLPT D     To disable LPT to COM mapping.
  160.           MAPLPT       To  enable LPT to COM mapping (using current  set-
  161.                        tings).
  162.           MAPLPT  U    To  uninstall MAPLPT.  You can only  uninstall  if
  163.                        MAPLPT is the last TSR loaded.
  164.  
  165.         Each time you enter a MAPLPT command (except for the D or U  com-
  166.         mands), MAPLPT echoes the current settings so that you can verify
  167.         that they are correct.  For example, if you had just entered  the
  168.         third sample command line, MAPLPT would print
  169.  
  170.         LPT1=COM1,4800,RTS-,N,8,1,40
  171.  
  172.         You  can  take  advantage of this feature to  check  the  current
  173.         MAPLPT  settings  by entering MAPLPT with no  argument.   If  you
  174.         enter invalid information in a command line, MAPLPT will print
  175.  
  176.         Error in command line.
  177.  
  178.         It  will  accept any correct information up to the point  of  the
  179.         error,  and print the current settings so that you can  see  what
  180.         was accepted.
  181.  
  182.  
  183.                                         3
  184.  
  185.  
  186.  
  187.         If you forget the command syntax for MAPLPT, and you do not  want
  188.         to read these instructions again, just enter
  189.  
  190.           MAPLPT ?
  191.  
  192.         and MAPLPT will print a screen of instructions.
  193.  
  194.         Using Printer Software
  195.  
  196.         Once  you have installed MAPLPT, any software that you have  that
  197.         uses  your printer should be configured to use the LPT  port  you
  198.         have  mapped,  not COM1 or COM2.  If your LPT port is  LPT1,  the
  199.         software  may  also be configured to use PRN.  However,  you  may
  200.         find that printing via LPT1 is faster than printing via PRN.
  201.  
  202.  
  203.  
  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.                                        4
  245.  
  246.          ----------------end-of-author's-documentation---------------
  247.  
  248.                         Software Library Information:
  249.  
  250.                    This disk copy provided as a service of
  251.  
  252.                         The Public (Software) Library
  253.  
  254.          We are not the authors of this program, nor are we associated
  255.          with the author in any way other than as a distributor of the
  256.          program in accordance with the author's terms of distribution.
  257.  
  258.          Please direct shareware payments and specific questions about
  259.          this program to the author of the program, whose name appears
  260.          elsewhere in  this documentation. If you have trouble getting
  261.          in touch with the author,  we will do whatever we can to help
  262.          you with your questions. All programs have been tested and do
  263.          run.  To report problems,  please use the form that is in the
  264.          file PROBLEM.DOC on many of our disks or in other written for-
  265.          mat with screen printouts, if possible.  The P(s)L cannot de-
  266.          bug programs over the telephone.
  267.  
  268.          Disks in the P(s)L are updated monthly, so if you did not get
  269.          this disk  directly from the P(s)L,  you should be aware that
  270.          the files in this set may no  longer be the current versions.
  271.  
  272.          For a copy of the latest monthly software library newsletter
  273.          and a list of the 1,900+ disks in the library, call or write
  274.  
  275.                         The Public (Software) Library
  276.                               P.O.Box 35705 - F
  277.                            Houston, TX 77235-5705
  278.                                (713) 665-7017
  279.  
  280.