home *** CD-ROM | disk | FTP | other *** search
/ HAM Radio 1 / HamRadio.cdr / misc / packwin / packwin.doc next >
Encoding:
Text File  |  1986-03-27  |  8.8 KB  |  199 lines
  1.  
  2.  
  3.  
  4.        
  5.        
  6.                              PACKWIN.EXE v1.2, 03/25/86
  7.                          Packet Radio TNC Control Software
  8.                          Copyright (c) Charles Stampf, 1986
  9.  
  10.             PACKWIN evolved as a result of a need for a simple yet functional
  11.        program to interface between my computer, and my TNC (Terminal Node
  12.        Controller).  As I surveyed the situation, I began to realize that
  13.        there was no single software product that was fun, fast and
  14.        uncomplicated to use.
  15.  
  16.             I plan to add several other more powerful functions to this
  17.        package as time goes by and hope to receive your input and
  18.        suggestions.  It seems that, at present, there is no standard or
  19.        agreed upon protocol for binary file transfer.  However the next level
  20.        of this program will contain some type of simple yet effective binary
  21.        file transfer routine.
  22.  
  23.             PACKWIN was written to operate on an IBM PC or a close compatible
  24.        with at least 128k available RAM.  It has been tested using the TAPR
  25.        1, TAPR 2 and GLB PK-1 TNC's.  Hardware handshaking between the
  26.        terminal and TNC has been implemented, as a result it is expected that
  27.        more than the  "3 wire hook-up" be used at the Async port.  A short
  28.        discussion of this requirement follows later on in this documentation.
  29.  
  30.             PACKWIN is a compiled BASIC program making extensive use of
  31.        ASSEMBLER calls.  Windows are used to provide an uncluttered area to
  32.        enter data and select program functions.  The screen is usually
  33.        restored to the state prior to activating a window so that continuity
  34.        and data flow is not lost.
  35.        
  36.        
  37.        HARDWARE REQUIREMENTS:
  38.  
  39.             An IBM PC or close compatible, 128k RAM, ASYNC port, graphics
  40.        display (preferred) and, a TNC compatible to those mentioned above is
  41.        all that is required.
  42.  
  43.             TAPR and GLB PK-1 are capable of hardware handshaking to prevent
  44.        buffer overflow during data transfer.  Both TNC's use the CTS signal
  45.        to indicate when they are ready to receive data.  PACKWIN uses this
  46.        signal to avoid sending data to an unwilling TNC.  This signal is
  47.        located at pin number 5 on your RS-232 connector and must be
  48.        functional for the proper operation of PACKWIN.
  49.        
  50.        TAPR 1, PK-1 and TAPR 2 use different signals to determine the status
  51.        of the terminal (whether or not the computer is ready for data).  TAPR
  52.        2 uses the signal DTR (pin 20, RS-232) whereas TAPR 1 and PK-1 use RTS
  53.        (pin 4, RS-232).  You should be sure that your configuration conforms
  54.        to these parameters.  PACKWIN will handle either of these conventions.
  55.        
  56.        
  57.        OPERATION:
  58.  
  59.             Turn on your TNC and invoke PACKWIN from the DOS prompt by typing
  60.        'PACKWIN'.  You will shortly see the sign-on message followed by the
  61.        HELP menu.  The HELP menu lists the available function keys and their
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68. PACKWIN - TNC Control Software
  69.  
  70.        operation.  In addition, the communication port data and the states of
  71.        three toggles are presented.  You are shown which port you are using,
  72.        the present baud rate and word length.  The ECHO, PRINTER and ASCII
  73.        SAVE status are also displayed.  These features are toggles, that is,
  74.        they can be turned on and off using the same function key.  The
  75.        default communications parameters are set to COMM2, 9600 baud, 8 bit
  76.        word NO parity.  They can be changed as described below.
  77.        
  78.        
  79.        FUNCTION KEYS:
  80.        
  81.        F1   Displays the HELP menu.
  82.        
  83.        F2   LOG drive.  Allows changing the currently logged drive.  Enter
  84.             your new drive letter (A - F).  The program responds with the new
  85.             logged drive and gives available free space.
  86.        
  87.        F3   Change SUBDIR.  Allows you to change the currently logged sub-
  88.             directory.  Enter the name of the new sub-directory preceded by
  89.             '\'; ie.'\newdir'(without the quotes).  Press ENTER without an
  90.             argument to exit without any changes.
  91.        
  92.        F4   Change COMM parameters.  Enter the desired parameters as they are
  93.             presented.  The present and new configuration are given.  Press
  94.             ENTER at the COMM port menu without an argument to exit without
  95.             any changes.
  96.        
  97.        F5   Immediately CLEARS the screen.
  98.        
  99.        F6   ECHO toggle.  Allows local echo to the screen.  Pressing F6
  100.             alternately turns echo on/off.  If you are getting double
  101.             characters on the screen when you type, either turn echo off at
  102.             your TNC or press F6.
  103.        
  104.        F7   File VIEW.  Allows you to view an ASCII file stored on disk.
  105.             Enter a valid filespec and press enter.  PACKWIN responds with
  106.             the file length and creation date and displays several lines of
  107.             the file.  To continue viewing simply press 'C' until the file is
  108.             complete.  To discontinue viewing just press ENTER.
  109.        
  110.        F8   Gives directory of currently logged disk and sub-directory.
  111.        
  112.        F9   ASCII Receive.  To store received data to disk press F9 and
  113.             supply PACKWIN with a valid file name.  PACKWIN will store all
  114.             subsequent data received to the file.  To stop saving data just
  115.             press F9 again.  A message will be printed to the screen
  116.             indicating that the function has completed.  In addition, the
  117.             status of this function is displayed on the HELP menu.
  118.        
  119.        F10  Xmit ASCII.  To transmit an ASCII file, you should first place
  120.             your TNC in the TRANSPARENT mode (MX/E on the PK-1, or TRANS on
  121.             TAPR).  Then press F10.  Supply a valid file name to transmit.
  122.             PACKWIN will open the file and get ready to transmit.  When the
  123.             other station is ready to receive your file press 'T' to begin
  124.             transmission.  PACKWIN will begin sending the file, stopping if
  125.             required, to honor a handshaking request (BUFFER FULL).  You will
  126.             see the file displayed on the screen as it is being loaded to the
  127.             TNC's buffer.  When the entire file is sent to the TNC you will
  128.  
  129.  
  130.  
  131.  
  132.  
  133.  
  134. PACKWIN - TNC Control Software
  135.  
  136.             be returned to the receive mode.  It may take a while for your
  137.             TNC to 'catch up' as the buffer is emptied.  You may then return
  138.             to conversational mode or continue in transparent.  Pressing
  139.             ENTER without an argument at the file name prompt will exit this
  140.             routine.
  141.        
  142.        Alt F1    EXIT the program.  Answering 'Y' to the prompt will exit
  143.             PACKWIN.  All files and devices are closed and a graceful exit to
  144.             DOS is performed.
  145.        
  146.        Alt F2    PRINTER toggle.  Pressing Alt-F2 will toggle printer echo.
  147.             Useful for capturing received data without saving it to a file.
  148.  
  149.             Most functions can be terminated at their first menu prompt by
  150.        simply pressing ENTER.
  151.        
  152.  
  153.             A primitive error reporting method will display any errors that
  154.        PACKWIN cannot handle.  The line and error number will be shown before
  155.        exiting to DOS.  Please include this info when writing to me.
  156.        
  157.  
  158.             I am distributing PACKWIN via the "FREEWARE" concept.  to prove
  159.        that the AMATEUR Radio community will support this method of program
  160.        development.  If you feel that PACKWIN is of use to you and if you
  161.        would like to receive the latest version, one that allows BINARY file
  162.        transfer and  customized COMM port parameters please consider the
  163.        donation of $15.00 to my efforts.  Send me your COMM port requirements
  164.        and a blank diskette and when it is completed I will return the latest
  165.        version of PACKWIN.
  166.  
  167.             Thanks to Thomas Hanlin III for his ADVBAS.LIB collection of
  168.        BASIC compiler subroutines and to Dave Evers for his ideas on pop-up
  169.        windows.
  170.  
  171.             Send any error indications and or suggestions.  I will attempt to
  172.        correct all errors an promise to review any and all suggestions.
  173.        73, Gud Luck
  174.        
  175.                                 Charlie Stampf, N2CJ
  176.                                 Bloomer Rd.
  177.                                 LaGrangeville NY 12540
  178.        
  179.        
  180.        
  181.        DISCLAIMER OF LIABILITY:
  182.        
  183.        I, Charles Stampf, as author of the PACKWIN.EXE software contained in
  184.        this package, hereby disclaim all responsibility for any consequence
  185.        arising out of the use, misuse, or non-use of any of the material
  186.        included herein.
  187.        
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.  
  196.  
  197.  
  198.  
  199.