home *** CD-ROM | disk | FTP | other *** search
/ HAM Radio 3 / hamradioversion3.0examsandprograms1992.iso / mods / tnc2doc / soft111.txt < prev    next >
Text File  |  1988-12-16  |  17KB  |  482 lines
  1. TAPR TNC 2 Software Release Notes . . . . . . . . . Release 1.1.1
  2.  
  3. 1)   The correct sign-on message for this release of TNC 2  soft-
  4.      ware is:
  5.  
  6.        |A
  7.  
  8.      Tucson Amateur Packet Radio TNC 2
  9.      AX.25 Level 2 Version 2.0
  10.      Release 1.1.1 - 16K RAM
  11.      Checksum $7F
  12.      cmd:
  13.  
  14. NOTE:     The  "|A" may display as a vertical-bar and any capital 
  15.           letter from "A" through "J".
  16.  
  17. 2)   New messages not documented in the System Manual are:
  18.  
  19.      ?not while disconnected
  20.  
  21.      You attempted to perform an operation that can only be  done 
  22.      while  connected.   This  message may appear when issuing  a 
  23.      RECONNECT or CONPERM command.
  24.  
  25.      ?already connected to that station
  26.  
  27.      The multi-connect software will not permit you to connect to 
  28.      the same station using multiple streams.
  29.  
  30. 3)   New commands have been added since the System Manual went to 
  31.      press.  These commands are listed on the following pages.
  32.  
  33. 4)   A brief description of multi-connect operation is  presented 
  34.      at the end of this addendum entitled "Multi-Connect Survival 
  35.      Guide."
  36.  
  37. 5)         TNC 2 SOFTWARE SOURCE CODE and TNC 2 FIRMWARE
  38.                        Copyright (c) 1985
  39.                              Systek
  40.                       All rights reserved.
  41.  
  42.      Reproduction  or translation of any part of this work beyond 
  43.      that  permitted by Sections 107A or 108 of the  1976  United 
  44.      States  Copyright  Act (or its legal successor) without  the 
  45.      express permission of the copyright owner is unlawful.   Re-
  46.      quests  for  permission to copy or for  further  information 
  47.      should be addressed to:
  48.  
  49.                    Tucson Amateur Packet Radio
  50.                           PO Box 22888
  51.                       Tucson AZ  85734-2888
  52.                        ATTN TNC 2 SOFTWARE
  53.  
  54. There  are  a  few operational changes from  release  1.1.0  that 
  55. should be noted:
  56.  
  57. 1)   All connect requests from stations with totally blank  call-
  58.      signs are rejected with a busy response.
  59.  
  60. 2)   The  *** DISCONNECT prompt is DAYTIME stamped  according  to 
  61.      the CONSTAMP setting.
  62.  
  63. 3)   TNC  1-like  transparent  mode is supported  only  when  one 
  64.      connection is established and USERS is set to 1.
  65.  
  66. 4)   The CON and STA LEDs (and RS232 DCD line if JMP1 not placed) 
  67.      now apply to the currently selected input stream.
  68.  
  69. 5)   "%" and "&" may now be used to clear the LCALLS list.
  70.  
  71. 6)   Hardware flow control is now always available.
  72.  
  73. 7)   A  bug  in the operation of 8BITCONV has been  fixed.   This 
  74.      command  used  to take effect in COMMAND mode  with  unhappy 
  75.      results!
  76.  
  77. There are also some questions that cropped up often with  Release 
  78. 1.1.0.
  79.  
  80. 1)   You  cannot  connect to yourself and see your  CTEXT.   CMSG 
  81.      only takes effect if you are connected to by another TNC.
  82.  
  83. 2)   CALSET was erroneously documented as having a default value.  
  84.      It  is correctly documented in the System Manual  after  the 
  85.      first printing.
  86.  
  87. An  error in the System Manual documentation for the MHEARD  com-
  88. mand slipped past us during this edit.   Please change Chapter 6, 
  89. page 37, third sentence from
  90.  
  91.      "Stations that are heard digipeating are marked with a *  in 
  92.      the heard log."
  93.  
  94. to
  95.  
  96.      "Stations that are heard through digipeaters are marked with 
  97.      a * in the heard log."
  98.  
  99. CLKADJ n                                               Default: 0
  100.  
  101.  
  102. Parameters:
  103.  
  104.      n         0 - 65535,  specifying the correction factor to be 
  105.                applied to the real-time clock routine.
  106.  
  107. A  value of "0" is a special case and means no correction  factor 
  108. will  be applied.   If the value of CLKADJ is non-zero,  then the 
  109. correction factor is calculated as:
  110.  
  111.                                                        1
  112.      relative clock speed in % =  100 - ( 9.16667 *  ----- )
  113.                                                        n
  114.  
  115. The real-time clock routine is used to keep track of year, month, 
  116. day, hour, minute and second as specified in the DAYTIME command.  
  117. It should be noted that the real-time clock is not intended to be 
  118. your  ham-shack reference clock,  but is useful  for  approximate 
  119. time stamping information.
  120.  
  121.  
  122.  
  123. CONPERM ON|OFF                                      Default: OFF
  124.  
  125.  
  126. Parameters:
  127.  
  128.      ON        The  current connection on the current stream will 
  129.                not be allowed to enter the disconnected state.
  130.  
  131.      OFF       The current stream may be connected to and discon-
  132.                nected from other stations.
  133.  
  134. This command, when switched ON, forces the TNC to always maintain 
  135. the  current  connection,  even when frames to the other  station 
  136. exceed  RETRY  attempts to get an  acknowledgment.   RESTART  and 
  137. power off/on cycling will not affect this connected state.
  138.  
  139. This  command only takes effect when a connection is established.  
  140. It  functions on a stream-by-stream basis when  multiple  connec-
  141. tions are allowed.
  142.  
  143. It is useful for certain networking applications,  meteor scatter 
  144. and other noisy,  less-reliable links,  while still allowing con-
  145. nections  on other streams to operate normally (automatic discon-
  146. nect based on RETRY, etc.).
  147.  
  148.  
  149. CSTATUS
  150.  
  151. CSTATUS is an immediate command which shows the stream identifier 
  152. and link state of all ten streams (links),  the current input and 
  153. output  streams,  and whether or not each stream  is  "permanent" 
  154. (see CONPERM).
  155.  
  156. An  example fo a display resulting from issuing a CSTATUS command 
  157. is:
  158.  
  159.      cmd:CS
  160.      A stream - IO Link state is: CONNECTED to 305MLB
  161.      B stream -    Link state is: CONNECTED to AD7I P
  162.      C stream -    Link state is: DISCONNECTED
  163.      D stream -    Link state is: CONNECTED to N0ADI via K9NG-2
  164.  
  165.      ...
  166.  
  167.      I stream -    Link state is: CONNECT in progress
  168.      J stream -    Link state is: CONNECTED to KV7B via NK6K-1
  169.  
  170. The  example above shows the A stream is assigned both the  input 
  171. and  output streams.   The B stream is connected to AD7I  "perma-
  172. nently."   All  other  streams' states are shown  as  they  might 
  173. normally appear with multiple connections.
  174.  
  175.  
  176.  
  177. MYALIAS call[-n]                                 Default: <blank>
  178.  
  179.  
  180. Parameters:
  181.  
  182.      call      Alternate identity of your TNC.
  183.  
  184.      n         0  - 15,  an  optionally specified sub-station  ID 
  185.                (SSID).
  186.  
  187. This  command specifies an alternate callsign (in addition to the 
  188. callsign specified in MYCALL) for use as a digipeater only.
  189.  
  190. In some areas,  wide coverage digipeaters operators have  changed 
  191. the  callsign of their machine to a shorter and (usually)  easier 
  192. to  remember identifier.   International Civil Aviation Organiza-
  193. tion  (ICAO) airport identifiers,  sometimes combined with  tele-
  194. phone area codes, have been used.
  195.  
  196. Use  of  this command permits HID to identify normally  with  the 
  197. MYCALL-specified callsign yet permit an alternate (alias) repeat-
  198. only "callsign."
  199.  
  200.  
  201. RECONNECT call1 [VIA call2[,call3...,call9]]
  202.  
  203.  
  204. Parameters:
  205.  
  206.      call1     Callsign of TNC to be reconnected to.
  207.  
  208.      call2     Optional  callsign(s)  of TNC(s)  tobe  digipeated 
  209.                through.   As many as eight digipeat addresses can 
  210.                be specified.
  211.  
  212. RECONNECT is an immediate command.   It may be used to change the 
  213. path through which you are currently connected to a station.   It 
  214. may only be used when your TNC is connected on the current stream 
  215. to the station you wish to RECONNECT to.
  216.  
  217. Integrity  of  frames  in flight between  your  station  and  the 
  218. RECONNECTed station at the time of RECONNECT is not assured.
  219.  
  220. For details regarding the parameter list, see the CONNECT command 
  221. inthe System Manual.
  222.  
  223.  
  224. RESTART
  225.  
  226.  
  227. RESTART is an immediate command.  It re-initializes the TNC using 
  228. the defaults stored in bbRAM.   The effect of this command is the 
  229. same as turing the TNC OFF then ON again.
  230.  
  231. RESTART  does not cause a reset of the parameters in bbRAM.   See 
  232. also the RESET command.
  233.  
  234.  
  235. STREAMCA ON|OFF                                      Default: OFF
  236.  
  237.  
  238. Parameters:
  239.  
  240.      ON        Callsign of other station displayed.
  241.  
  242.      OFF       Callsign of other station not displayed.
  243.  
  244. This  command is used to enable the display of  the  connected-to 
  245. station after the stream identifier.  This is particularly useful 
  246. when operating with multiple connections allowed.  It is somewhat 
  247. analogous  to  the use of MRPT to show digipeat paths  when  mon-
  248. itoring.
  249.  
  250. In the example below,  the charaters inserted by enabling STREAM-
  251. CAll are shown in bold face type.
  252.  
  253.      |A:K4NTA:hi howie
  254.      hello ted how goes it?
  255.      |B:WA7GXD:*** CONNECTED to WA7GXD
  256.      |Bmust be a dx record. ge lyle
  257.      |Aunreal ted! fl-az no digis!
  258.      |B:WA7GXD:big band opening...ge
  259.  
  260. etc.
  261.  
  262. The  same  sequence with STREAMCAll OFF would look like the  fol-
  263. lowing:
  264.  
  265.  
  266.      |Ahi howie
  267.      hello ted how goes it?
  268.      |B*** CONNECTED to WA7GXD
  269.      |Bmust be a dx record. ge lyle
  270.      |Aunreal ted! fl-az no digis!
  271.      |Bbig band opening...ge
  272.  
  273. etc.
  274.  
  275. Thus,   what  would  have  looked  like  "|B"  now   appears   as 
  276. "|B:<callsign>:".  This option is very useful for human operators 
  277. trying to operate multiple simultaneous connections.   It is pro-
  278. bably less useful for "host" operations.
  279.  
  280. Note that, in the first example, the STREAMSWitch characters "|A" 
  281. and  "|B" with no ":" after them were entered by the operator  of 
  282. the  TNC to switch streams for his multiple-connect  QSO(s).   If 
  283. you  intend to operate multiple connections (as opposed to having 
  284. your "host" computer operate multiple connections),  use of  this 
  285. option is recommended.
  286.  
  287.  
  288. STREAMDBL ON|OFF                                     Default: OFF
  289.  
  290.  
  291. Parameters:
  292.  
  293.      ON        Double all received STREAMSWitch characters.
  294.  
  295.      OFF       Do not "double" received STREAMSWitch characters.
  296.  
  297. This  command is used to display received STREAMSWitch characters 
  298. by "doubling" them.  The example below illustrates this action.
  299.  
  300. With  STREAMDBL on,  and STREAMSWitch set to "|",  the  following 
  301. might be displayed from your TNC:
  302.  
  303.      || this is a test.
  304.  
  305. In this case the sending station actually transmitted
  306.  
  307.      | this is a test.
  308.  
  309. The same frame received with STREAMDBL OFF would be displayed as:
  310.  
  311.      | this is a test.
  312.  
  313. When  operating  with multiple connections,  this is  useful  for 
  314. differentiating  between  STREAMSWitch characters  received  from 
  315. other  stations and STREAMSWitch characters internally  generated 
  316. by your TNC.
  317.  
  318. NOTE:     The  STREAMSWitch  character  must NOT be  one  of  the 
  319.           stream  letters  (A - J) for this command  to  function 
  320.           properly.
  321.  
  322.  
  323.  
  324. STREAMSW n                                     Default: $7C < | >
  325.  
  326.  
  327. Parameters:
  328.  
  329.      n         0  - $FF,  usually specifying an  ASCII  character 
  330.                code.
  331.  
  332. This  command selects the character used by both the TNC and  the 
  333. user that a new "stream" (connection channel) is being addressed.
  334.  
  335. The  character can be PASSed in CONVERS mode.   It is always  ig-
  336. nored as a user-initiated stream switch in TRANSPARENT mode,  and 
  337. flows through as data.   This means that the outgoing stream  can 
  338. not  be  changed  while "on line" in TRANSPARENT mode  (you  must 
  339. escape to COMMAND mode to switch streams).
  340.  
  341. For  further  usage  of this character,  see  teh  STREAMDBL  and 
  342. STREAMCA commands.
  343.  
  344.  
  345. TRIES n                                             Default: NONE
  346.  
  347.  
  348. Parameters:
  349.  
  350.      n         0 -15,  specifying the current RETRY level on  the 
  351.                currently selected input stream.
  352.  
  353. This  command is used to retrieve (or force) the count of "tries" 
  354. on the currently selected input stream.
  355.  
  356. When used with no argument:  if the TNC has an outstanding unack-
  357. nowledged frame,  it will return the current number of tries;  if 
  358. the TNC has no outstanding unacknowledged frames,  it will return 
  359. the  number of tries required to obtain an acknowledgment for the 
  360. previous frame.
  361.  
  362. If  RETRY  is set to 0,  the value returned by  issuing  a  TRIES 
  363. command will always be 0.
  364.  
  365. This  command is useful for obtaining statistics on  the  perfor-
  366. mance of a given path or channel.  It should be especially useful 
  367. for  automatic  optimizing os such parameters as PACLEN and  MAX-
  368. FRAME  by computer-operated stations,  such as automatic  message 
  369. forwarding  stations using less-than-optimum paths (noisy  HF  or 
  370. satellite channels, for example).
  371.  
  372. When used with an argument,  TRIES will force the "tries" counter 
  373. to  the entered value.   Use of this command to force a new count 
  374. of tries is NOT recommended.
  375.  
  376.  
  377.  
  378. USERS n                                                Default: 1
  379.  
  380.  
  381. Parameters:
  382.  
  383.      n         0  - 10,  specifying the number of active  connec-
  384.                tions that may be established to this TNC by other 
  385.                TNCs.
  386.  
  387. USERS affects only the manner in which incoming connect  requests 
  388. are  handled,  and  has  no effect on the number or  handling  of 
  389. connections you may initiate with this TNC.
  390.  
  391. For example,
  392.  
  393.      USERS 0   allows incoming connections on any free stream
  394.      USERS 1   allows incoming connections on stream A only
  395.      USERS 2   allows incoming connections on streams A & B
  396.      USERS 3   allows incoming connections on streams A, B & C
  397.  
  398. and so on through USERS 10.
  399.  
  400. Multi-Connect Survival Guide
  401.  
  402. This section is a very brief tutorial on the use of the multiple-
  403. connection capability included with this software release.
  404.  
  405. Why Multi-Connect?
  406.  
  407. Multiple  connection  capability is a very powerful  addition  to 
  408. your TNC 2.   It is very useful for traffic net operation, multi-
  409. user bulletin boards, path checking and so forth.
  410.  
  411. What is Multi-Connect?
  412.  
  413. Multiple connection operation is not the same as multi-way opera-
  414. tion.  With multiple connect, you may establish several point-to-
  415. point  "links" with various stations.   Multi-way,  which is  not 
  416. available,  would  enable multiple stations to be  simultaneously 
  417. interconnected  to each other,  with each station seeing all data 
  418. passed from any station in the group, error free.
  419.  
  420. Multiple  connection  operation is another step on  the  road  to 
  421. proper networking, and networking should eventually allow mlulti-
  422. way operation.
  423.  
  424. What Commands Set my TNC 2 to Normal Operation?
  425.  
  426. Your  TNC  2 defaults the multi-connect-related commands  to  the 
  427. following parameters:
  428.  
  429.      CONPERM        OFF
  430.      STREAMCAll     OFF
  431.      STREAMDouBLe   OFF
  432.      STREAMSWitch   |
  433.      USERS          1
  434.  
  435. This sets up your TNC 2 to act just like a "normal" TNC does that 
  436. doesn't support multiple connections.   The key to obtaining this 
  437. traditional operation is to set USERS 1.
  438.  
  439. How Do I Invoke Multi-Connect?
  440.  
  441. If  USERS  is not 1,  you are telling the TNC to  allow  multiple 
  442. connections to your stations from other stations.   In  addition, 
  443. TRANSPARENT mode will operate differently,  in that incoming data 
  444. will  be  prefixed  with the current STREAMSWitch  character  and 
  445. identifier (such as "|A").   Thus, truly transparent operation is 
  446. not  possible  with  this software  release  supporting  multiple 
  447. connections.
  448.  
  449. The STREAMSWitch character,  defaulted to "|", should be set to a 
  450. character you won't normally use.   Note that this character  may 
  451. be set to a hex value between $80 and $FF.  This may allow you to 
  452. use  8-bit  characters (AWLEN 8) if your terminal or computer  is 
  453. capable of generating such "characters."  This could help prevent 
  454. confusion  in  interpreting incoming data from other stations  if 
  455. they happen to send data that includes your selected STREAMSWitch 
  456. character.
  457.  
  458. Although  not  foolproof,  enabling  STREAMDBL may also  help  in 
  459. sorting out STREAMSWitch characters included in the received data 
  460. from a valid stream switches generated by your TNC 2.
  461.  
  462. STREAMCAll should be especially helpful when manually operating a 
  463. station in which you allow multiple connections.
  464.  
  465. When  in  CONVERSE mode,  you may switch streams by entering  the 
  466. STREAMSWitch character (default "|"),  followed by a stream iden-
  467. tifier ("A" through "J"),  followed by the data you wish to  send 
  468. to  the station on that stream.   See the example in the descrip-
  469. tion of STREAMCAll for an illustration of this.
  470.  
  471. If all this seems a bit confusing,  don't worry, it is!  The only 
  472. way  to really understand multiple connect operationis to try it!  
  473. Once you have your TNC 2 assembled,  tested and  on-the-air,  and 
  474. have gained confidence in "normal" packet operation,  try setting 
  475. USERS 2 and get a couple of friends to connect to you.  Play with 
  476. the  commands (you can't hurt the TNC by issuing commands to it!) 
  477. and see their effects.
  478.  
  479. Happy packeting!
  480.  
  481.                                                                          
  482.