home *** CD-ROM | disk | FTP | other *** search
/ HAM Radio 3 / hamradioversion3.0examsandprograms1992.iso / packet / tnc14 / tnc.doc < prev   
Text File  |  1986-11-27  |  14KB  |  425 lines
  1.  
  2.  
  3.  
  4.         -------------------------------------------------
  5.  
  6.  
  7.           P A C K E T   T E R M I N A L   P R O G R A M
  8.  
  9.                            Version 1.4
  10.         -------------------------------------------------
  11.  
  12.  
  13.         Welcome   to the world of Packet Radio.    Say,   all you 
  14. HAMS   will surely appreciate the time and effort we  have  spent 
  15. designing and perfecting  this program.   We certainly don't care 
  16. if  you  pass  a copy of this program  to  a  friend,   relative,  
  17. fiance,   or even an enemy.   It is intended to further the cause 
  18. of Packet Radio  and stir up additional interest.
  19.  
  20.         Now  for the BAD news.   This program is written in Turbo  
  21. Pascal  and  the  source  code is available for  PURCHASE!    The  
  22. authors  reserve   the  right to limit the  distribution  of  the  
  23. source  code and  DEMAND  that it not be FREELY distributed.   We 
  24. reserve  all rights  to  this program and are not responsible for  
  25. any   damage caused by the use of this program.   Use it at  your 
  26. own risk!
  27.  
  28.         Copies  of  the source code diskettes are available   for  
  29. $25.00, from:  
  30.  
  31.               WD0DUD                        KA0DMJ
  32.               Garry Kraemer                 Larry Kraemer
  33.               1631 A South 6th              R 2 Box 190
  34.               Blytheville AFB, AR           Jackson, MO
  35.                           72315                        63755
  36.  
  37.  
  38.          This  program  will  send  128  byte  sectors  to  the  
  39. TNC.  Hardware handshake is mandatory to keep extraneous 
  40. characters out of the file being transfered. See TNC SETTINGS for 
  41. expanded settings.
  42.  
  43.  
  44.               NOTE:   IF  YOU SELECT ECHO ON,  WHAT IS DISPLAYED  
  45. IN  THE TRANSMIT WINDOW IS ALSO ECHO'D TO THE RECEIVE SCREEN.   
  46. YOU MIGHT LIKE THIS DISPLAY BETTER.
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.          COMMANDS
  59.  
  60.         The program is menu driven and should not be difficult to  
  61. figure out.    Use  the  UP & DOWN ARROW keys or the first letter 
  62. of  the desired menu item to select that function.
  63.  
  64.         INITIAL OPENING MENU.
  65.  
  66.         The following functions are available:
  67.  
  68.  
  69.                               TERMINAL MODE
  70.  
  71.                               SEND FILE
  72.                         
  73.                               RECEIVE FILE
  74.  
  75.                               LOG DRIVE and PATH
  76.  
  77.                               DIRECTORY
  78.  
  79.                               COMM PORT SETTINGS
  80.  
  81.                               OPTIONS
  82.  
  83.                               QUIT
  84.  
  85.  
  86.  
  87.         SEND   FILE  - Transmits any disk file to  another  MSDOS  
  88. machine using  this  program.   If using TNC Protocol, the 
  89. TRANSPARENT mode will be required  to allow transmission of 
  90. control codes.  You will have to manually enter the TRANSPARENT 
  91. Mode.  Use THREE rapid ^C (CONTROL C)  commands  to return to the 
  92. command mode  of  the  TNC.   This program  will  ask  for the 
  93. filename to send and  then  send  the filename to the receiving 
  94. system.  ^X (Control X) will cancel the send function.  If you 
  95. are using the XMODEM Protocol and a telephone modem, you can send 
  96. to any compatible system using XMODEM Protocol.  CRC is the 
  97. default error setting.  If an error is encountered when the 
  98. filename is specified, the procedure will be exited and you will 
  99. have to re-enter the procedure to send a file. 
  100.  
  101.         RECEIVE  FILE  - Receives any disk file to another  MSDOS  
  102. machine using  this program.   If using the TNC Protocol, the 
  103. TRANSPARENT mode will be  required  to allow reception of control 
  104. codes.  Use THREE rapid ^C (CONTROL C) commands to return to the 
  105. command mode of the TNC.   This program will  receive the 
  106. filename from the sending system and then write the  file to the 
  107. logged disk drive.   ^X (Control X) will  cancel the receive 
  108. function.  If you are using the XMODEM Protocol, this program 
  109. will receive using either CRC or CHECKSUM error checking.  
  110.  
  111.         TERMINAL  MODE - A SPLIT screen terminal  program.    The 
  112. TOP  screen  section displays the RECEIVED characters  while  the  
  113. BOTTOM section  displays  the  TRANSMITTED  characters.   
  114.        
  115.      TERMINAL COMMANDS:
  116.    
  117.          CONTROL P - Toggle printer output ON/OFF.
  118. A print spooler (BUFFER) needs to be utilized to eliminate  loss 
  119. of characters.   Most printers can not keep ahead of  the  TNC at 
  120. 1200 BAUD.   Issuing a second ^P  will terminate output.
  121.  
  122.          CONTROL B - Toggle buffer ON/OFF.  A Buffer Open/Closed 
  123. message is displayed in the Transmit screen.  The Buffer must be 
  124. CLOSED to SAVE contents to DISK!  Max buffer size is 32 K BYTES.  
  125. If 32 K is received, a BUFFER FULL message is displayed, a beep 
  126. sounds, and a reminder to save contents to disk is displayed.  
  127.  
  128.          CONTROL T - Send ASCII/TEXT file from the terminal mode.  
  129. CONTROL X will terminate transmission.  A Cancellation message 
  130. will be displayed on the  Transmit screen.  ONLY files that can 
  131. be 'TYPED' from DOS can be sent.
  132.  
  133.           CONTROL W - Save buffer data to disk.  Limited filename 
  134. checking is performed.  Filename must conform to MSDOS standards, 
  135. ie., Filename.Ext.     
  136.  
  137.          CONTROL C - Return the TNC to COMMAND MODE!  This 
  138. command will allow you to control the TNC!
  139.  
  140.          CONTROL E - Exit Terminal mode and return to the COMMAND 
  141. MENU.  
  142.  
  143. NOTE:  This terminal section DOES NOT provide CRC or CHECKSUM 
  144. error checking; since the TNC performs this function.  
  145.  
  146.         I HIGHLY recommend the JRAM 3 board.   It will support 2 
  147. MEG  and allow  you to set up any size file for a printer buffer.   
  148. I have 128 K set aside in memory disk for a printer spooler.
  149.  
  150.  
  151.         LOG DRIVE and PATH - This function will change the 
  152. default drive and path.  Logging a new drive allows the 
  153. SEND/RECEIVE function to access the LOGGED drive via the 
  154. specified path.  If you wish to receive to a specified sub-
  155. directory, it MUST be created before entering the program.
  156.  
  157.  
  158.         DIRECTORY  - This  function  will display the  directory  
  159. of the specified drive.  The LOGGED and Logged drive's path 
  160. remains unchanged.
  161.  
  162.  
  163.  
  164.  
  165.  
  166.         COMM  PORT SETTINGS - This function will allow you  to  
  167. configure the  comm port.   A submenu is displayed and you can 
  168. use the UP & DOWN  ARROW  keys  or the first letter of the item  
  169. you  wish  to change.  The current selection (default) is 
  170. displayed to the left of the initial COMM Parameter menu.  
  171. Submenus containing new comm parameter  settings  will be 
  172. displayed when individual items  are selected.   These  new 
  173. settings will be implemented when QUIT  is selected on the 
  174. COMMUNICATIONS PARAMETERS menu.
  175.  
  176.  
  177.         COMM PORT SETTINGS SUBMENUS 
  178.  
  179.  
  180.         BAUD RATE - BAUD RATES of 300,  1200,  2400,  4800 are 
  181. displayed.  Use the arrow keys to highlight the desired setting 
  182. or enter  the first number of the desired BAUD RATE.
  183.  
  184.         COMM  PORT NUMBER - PORTS 1,  2,  and 3 are displayed.   
  185. Use  the arrow  keys to highlight the desired settings or enter 
  186. the number of the port desired.
  187.  
  188.         WORD  LENGTH - 8 and 7 BIT WORD options are displayed.   
  189. Use  the arrow keys to highlight the desired settings or enter 
  190. the  number of the port desired.
  191.  
  192.         PARITY  - EVEN,  ODD,  and NONE options are displayed.   
  193. Use  the arrow  keys to highlight the desired settings or enter 
  194. the number of the port desired.
  195.  
  196.         STOP  BITS  - 1 and 2 STOP BIT options are  displayed.   
  197. Use  the arrow keys to highlight the desired settings or enter 
  198. the  number of the port desired.
  199.  
  200.         RTS - HIGH and LOW options are displayed.  REQUEST TO 
  201. SEND should default  to the proper setting.   This signal should 
  202. be PIN 4  of the  RS-232.   RTS  is  used to control TNC 
  203. TRANSMISSION  to  the Computer.   If  RTS  is LOW,  the TNC will 
  204. not  TRANSMIT  to  the Computer.  
  205.  
  206.         DTR  - HIGH and LOW options are displayed.   DATA 
  207. TERMINAL  READY should default to the proper setting.   This 
  208. signal should be PIN 20 of the RS-232.  If your modem does not 
  209. work,  try changing the DTR state.   DTR HIGH is compatible with 
  210. the PROMODEM 1200 (HAYES compatible).
  211.  
  212.  
  213.  
  214.         OPTIONS
  215.  
  216.         TNC PROTOCOL - No ERROR checking provided to the TNC.  
  217. RTS/CTS hardware control of the TNC.  The filename and number of 
  218. records are provided to the receiving TNC.  The receivine TNC 
  219. must use this program to send files in the TRANSPARENT Mode.
  220.  
  221.         XMODEM - Standard Protocol as designed by Ward 
  222. Christensen. The following submenu options are displayed:
  223.  
  224.              CRC - CRC Error checking selected.
  225.  
  226.              SUM - CHECKSUM Error checking selected.
  227.  
  228.  
  229.  
  230.  
  231.         ADD LF to CR - The following two options are displayed:
  232.  
  233.              ADD LF to CR - Selecting this option will cause a 
  234. Line Feed (LF) to be added to all Carriage Returns (CR).  Only 
  235. valid while in the Terminal mode.             
  236.  
  237.              CR Only - Selecting this option will display 
  238. received data just as received, ie., no  LF will be added.  Only 
  239. vaild while in the Terminal mode.  
  240.  
  241.  
  242.         QUIT - EXIT Submenu or EXIT program. 
  243.  
  244.  
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.  
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.  
  269.  
  270.  
  271.  
  272.  
  273.  
  274.  
  275.  
  276.          Now,  for  one  BUG in the HEATHKIT TNC.   When the RTS 
  277. line  is toggled to inhibit the TNC transmitting to the Computer,  
  278. the TNC will  immediately  stop transmission and will  SOMETIMES  
  279. lose  a character.  We have verified this with the folks at TAPR 
  280. and they are working on a modification to help us out.  Heathkit 
  281. claims no BUG spray needed!   Boy, are they wrong!  Just try 
  282. using the file send/receive  mode  to  send  a  .com or  .exe  
  283. file  to  another computer.   I'll bet a new Boeing B-52 that the 
  284. program will  not function  properly after several bytes are 
  285. dropped  out.   (LARRY and  I have more hours in the B-52 than 
  286. any other 'TWINS' in  the world!   Larry has approx 750 hours and 
  287. I have 3000+ B-52,  4000+ total,  and  2000+ Instructor Pilot 
  288. hours.   Now,  if that  don't impress  you nothing will!).  Yes,  
  289. we have tested this program  by connecting  RS-232 direct to 
  290. another RS-232 (FULL HANDSHAKE)  and have verified that it is not 
  291. our program.
  292.  
  293.  
  294.  
  295.  
  296.  
  297.  
  298.  
  299.  
  300.  
  301.  
  302.  
  303.  
  304.  
  305.  
  306.  
  307.  
  308.  
  309.  
  310.  
  311.  
  312.  
  313.  
  314.  
  315.  
  316.  
  317.  
  318.  
  319.  
  320.  
  321.  
  322.  
  323.  
  324.  
  325.  
  326.  
  327.  
  328.  
  329.  
  330.  
  331.                           TNC SETTINGS
  332.  
  333.  
  334.          This  program will send ANY disk file from one MSDOS 
  335. machine  to another  MSDOS machine.  (Source code,  Object code,  
  336. ASCII,  any disk  file!!!!).    NOTE:   BOTH  MSDOS  MACHINES 
  337. MUST  RUN  THIS PROGRAM, IF USING THE TNC PROTOCOL !!!!!  
  338.  
  339.  
  340. The TNC should be set to:
  341.  
  342.         ABAUD 1200           ECHO OFF             PARITY 4
  343.         ABIT 1               ESCAPE OFF           PASS $16
  344.         AUTOLF ON            FLOW ON              REDISP $12
  345.         AWLEN 8              FRACK 4              RETRY 8
  346.         AX25 ON              FULLDUP OFF          SCRENL 78
  347.         AXDELAY 0            HBAUD 1200           SENDPAC $0D
  348.         AXHANG 0             LCOK ON              START $11
  349.         BKONDEL ON           LFADD OFF            STOP $13
  350.         CANLINE $18          MONITOR OFF          TRACE $1000
  351.         CANPAC $19           MALL ON              TXDELAY 4
  352.         CMDTIME 1            MAXFRAME 1           TXFLOW 0FF
  353.         COMMAND $03          MCON ON              VDIGIPEA OFF
  354.         CONOK ON             MFROM ALL            VRPT OFF
  355.         CAPTIME OFF          MTO ALL              XFLOW OFF
  356.         CR ON                MYVADR $1F           XMITOK ON
  357.         CWID OFF             NULLS 0              XOFF $13
  358.         DEBUG $05            NUCR ON              XON $11
  359.         DELETE OFF           NULF ON
  360.         DIGIPEAT ON          PACLEN 128
  361.         DWAIT 2              PACTIME AFTER 4
  362.  
  363.  
  364.  
  365. RS-232C WIRING
  366.  
  367. MFJ  TNC            MSDOS COMPUTER(DTE)    HEATHKIT TNC
  368.  
  369. FG   1        not req'd1  FG   not req'd1  FG
  370. RX   2<---------------------2  TX------------->2  RX
  371. TX   3--------------------->3  RX<-------------3  TX
  372. CTS 20<---------------------4  RTS  ------------->4  CTS
  373. RTS  5--------------------->5  CTS<-------------5  RTS
  374. DTR  6---- always high ---->6  DSR<-------------6  DTR
  375. GND  7<-------------------->7  GND<------------>7  GND
  376. DCD  8 --------------------->8  DCD------------->8  DCD
  377.        20  DTR-------------> 20  DSR
  378.  
  379. NOTE:   The above wiring is required for proper hardware
  380. handshake.  This allows the TNC to operate in the
  381. TRANSPARENT Mode.
  382.  
  383.  
  384.  
  385.  
  386.  
  387.  
  388.   8 Sep 86 ver 1.4 - Added Exit routines if error is 
  389.                      encountered in the file send modes.  
  390.                      Added Paths to the Log Disk selection.
  391.                      GGK.
  392.  
  393. 31 Aug 86 ver 1.3  - Added Menu selection of XMODEM Protocol 
  394.                      for XMODEM, CRC and CHECKSUM, Send & 
  395.                      Receive.  GGK.
  396.  
  397. 22 Aug 86 ver 1.2  - Corrected CR/LF Transmission during send from
  398.                      Terminal mode.  Added code to enable LFADD
  399.                      boolean operator.  Tested FULL HANDSHAKE between
  400.                      two computers.  1200 BAUD checks ok. No problems
  401.                      capturing data to buffer and printing when using
  402.                      print buffer.  Added Counter reset when Buffer is
  403.                      saved to disk (Reset Counters).  GGK.
  404.  
  405. 21 Aug 86 ver 1.1  - Added Buffer capture and Transmit file from
  406.                      Terminal mode.  Also corrected ASYNC_SEND(CH)
  407.                      to loop until CTS and THRE.  GGK.
  408.  
  409.  1 AUG 86 ver 1.0  - Added DTR and RTS options to COMM PARM MENU.
  410.                      Allows program to be used with external/internal
  411.                      modems.  NO ERROR CHECKING!
  412.  
  413.  
  414.  
  415.  
  416.     Written by GARRY KRAEMER (WD0DUD)  and LARRY KRAEMER (KA0DMJ)
  417.  
  418.    Dedicated to our loving families.   They have suffered many 
  419. days while we discussed,  corrected,  debugged,  and perfected  
  420. this program.
  421.  
  422.                   ----------8 SEP 86----------
  423.                           Latest Update
  424.  
  425.