home *** CD-ROM | disk | FTP | other *** search
/ HAM Radio 3 / hamradioversion3.0examsandprograms1992.iso / packet / tn116 / tn1160.doc < prev   
Text File  |  1991-02-14  |  14KB  |  347 lines
  1. Here is the file TN116.DOC:
  2.  
  3. Hello sysops,
  4.  
  5. Version 1.16 is a forerunner of version 1.2, which will be little changed
  6. from this version.  It has been pointed out to me that in versions 1.0 and
  7. 1.1, it is possible for a user, by means of "bombardment" of the nodes with
  8. many commands at one time (for example, sending a file that contained the
  9. NODES-command 50 times), to send the node into reset for lack of free
  10. buffer. That is corrected in ver 1.16.  With free buffer less than 300 the
  11. access to the command interpreter is simply blocked.  That is, of the 50
  12. commands none would be executed until there is again free buffer space.
  13.  
  14. Due to lack of storage space in EPROM the Host-Interface has been omitted.
  15. The RS-232 connector is for connection to another TNC and not a terminal, as
  16. in earlier versions.  Since all the parameters can be accessed remotely, the
  17. Host-Interface is no longer necessary.
  18.  
  19. Password is now copied into RAM with a block-move (LDIR). Because of that
  20. the order of parameters in the EPROM has been changed.
  21.  
  22. See PARMS.DOC
  23.  
  24. !!!The password in EPROM must have 80 characters!!! In return, the 0-
  25. terminator is left off.  Whoever wants a shorter password can fill the rest
  26. with spaces.   The info-text in the EPROM is omitted from its usual place;
  27. in return, however, the INFO-command becomes somewhat expanded (see below).
  28.  
  29. The list of remotely switched parameters has been expanded from 26 to 30.
  30. The parameters 'fullduplex', 'pausenflags' and 'TXDelay' are now also
  31. remotely switchable.  In addition a bit-transparent 16-bit-systemflag is
  32. added.  (Variable name 'Flags') (Parameter 30)
  33.  
  34. The changes of version 1.16 compared to 1.01 follow:
  35.  
  36. Each and every parameter with the exception of Call and Password are
  37. remotely switchable.  It is possible to define 2 different ID's at one time
  38. for the HDLC (RF)-port and for the RS232-port.  Also these ID's are remotely
  39. changeable.
  40.  
  41. Since some new options are provided over whose meaning and purpose one could
  42. argue, most of them are also made remotely switchable.  In order to not get
  43. an additional flood of parameters, these software switches are summarized
  44. bit transparent in the new Parameter 30.
  45.  
  46. See the file PARM30.DOC!
  47.  
  48. New Commands:
  49. ----------------------------------------------------------------
  50.  
  51. Command INFO (I):
  52. =================
  53. The default info text is dropped from the EPROM.  In its place an
  54. info text with a variable number of characters can be entered
  55. remotely under sysop control.  This text is limited to 250
  56. characters including CR LF.  The info text is enter line by line.
  57.  
  58. Example:
  59. I line 1
  60. I line 2
  61. etc.
  62.  
  63. Additional I lines will be appended.  Should one want to enter a completely
  64. new info text, the CLINFO-command is used to clear out the old text. (see
  65. below)
  66.  
  67. If an empty line is to be inserted the character '@' is used.
  68.  
  69. Example:
  70. I @    (gives a blank line)
  71.  
  72. ----------------------------------------------------------------
  73.  
  74. Command CTEXT (CT):
  75. ===================
  76. Analogous to info text, connect text of 250 characters can be entered
  77. remotely under sysop control, except the command here is called 'CT' rather
  78. than 'I'.
  79.  
  80. Example:
  81. CT line 1
  82. CT line 2
  83. etc.
  84.  
  85. also 'CT @' etc. is usable.  Cancel with the CLINFO command.
  86.  
  87. A file might be prepared with both the CText and InfoText and transmitted to
  88. the node to upload both texts.
  89.  
  90. Attention sysops (in Europe)!
  91. The connect text can result in problems with users of DIGICOM. This can be
  92. avoided however, by ending EACH text line with a '>'. To be certain, this is
  93. not very attractive but it does make the DIGICOM user happy. With SP up to
  94. 4.0, with YAPP and with TurboPacket there are no problems.
  95.  
  96.  
  97. ----------------------------------------------------------------
  98.  
  99. Command CLINFO (CL):
  100. ====================
  101. Under sysop control:
  102. CL 0      cancel connect text
  103. CL 1      cancel info text
  104.  
  105. ----------------------------------------------------------------
  106.  
  107. Command FLAG (F):
  108. =================
  109.  
  110. Here we find the system flags of the newly introduced Parameters 30.
  111.  
  112. Without sysop authorization the system flags of Parameter 30 are displayed.
  113. Under sysop control, these flags can be set.
  114.  
  115. Example:
  116. F 5 1     sets Parameter 30 bit 5 to 1.
  117. F 12 0    sets Parameter 30 bit 12 to 0.
  118.  
  119. For the meaning of the various flags see PARM30.DOC.
  120.  
  121. -----------------------------------------------------------------
  122.  
  123.  
  124. Command TEST (T):
  125. =================
  126.  
  127. This command is similar to the CALIBRATE command of TAPR-Soft. The node
  128. radiates a signal which at 1200 baud corresponds to a key ratio of 1:1. It
  129. keys high-low tones alternately.  Normally this occurs under sysop control.
  130. However, in Parameter 30 if the bit 0 were set on 1 ('F 0 1'), each user
  131. could call up this routine. The thought is that in some cases, for example, a
  132. user could request the sysop to permit it for testing purposes.  The
  133. duration of this routine is be entered with the command, for example:
  134.  
  135. 'T 50'    the test signal would be radiated for 50 seconds.
  136.  
  137. By the execution of this TEST-command the SIO of the TNC is completely
  138. reprogrammed.  In order to avoid problems the internal timer (interrupts) of
  139. the TNC are switched off during the running of this routine.  The TNC
  140. operates during this time in a timing loop and for other activities is dead.
  141. Therefore, the time duration would also be limited to 2 minutes ('T 120').
  142. Please take note also that the watchdog is done with the control time.  The
  143. time is for a TNC with a crystal frequency of 4.9152 MHz.
  144.  
  145. ----------------------------------------------------------------
  146.  
  147. Command Y (Y):
  148. ==============
  149. Normally the maximum number of connects to a node is 25.  If this number is
  150. exceeded, the user receives a 'Node Busy'.  If in certain situations it
  151. seems a restriction of the maximum permissible connects should be offered,
  152. the maximum can be set here with the Y-command.  (naturally under sysop
  153. control).
  154.  
  155. Example:
  156. 'Y 10"    sets the max. possible connects to 10.
  157.  
  158. Attention:  It can only be set lower, but never above 25.
  159.  
  160. ----------------------------------------------------------------
  161.  
  162. Command ID (ID):
  163. ================
  164. With this both ID's of the node can be changed.
  165.  
  166. Example:
  167. 'ID HUGO #OTTO'     sets the ID on the HDLC (RF)-port to HUGO and
  168. the ID on the RS232-port to #OTTO.
  169.  
  170. Normally both ID's are the same.  In that case the ID would appear also in
  171. the prompt before the double period.  If the ID's were different, no ID
  172. would appear in the prompt. Meaning and purpose are illustrated by an
  173. example: The node DB0XYZ stands on the border between DL and F (the
  174. countries and callsign are arbitrarily chosen).  Now the nodes near the
  175. border in DL have a quantity of F-callsigns in the node list and the nodes
  176. near the border in F each a quantity of DL-callsigns.  This can lead to
  177. disarrangement relatively quickly. Therefore sysop Waldheini, the caretaker
  178. of DB0XYZ, decides to introduce 2 ID's.  In the direction of F the node is
  179. called DLLINK:DB0XYZ and in the direction of DL it is called FLINK:DB0XYZ.
  180. Furthermore in each direction the passing on of the corresponding nodes in
  181. the nodes list would be spread by means of Parameter 30 bit 4,5,6 and 7 (see
  182. PARM30.DOC).
  183.  
  184. Also, if more nodes link to the same box, whose ID's thereafter, for example
  185. XXXBOX would be listed by all nodes, 2 ID's are very useful.
  186.  
  187. ----------------------------------------------------------------
  188.  
  189. Command QUIT (Q):
  190. =================
  191.  
  192. Generally accessible command.  Causes the node to disconnect for its part at
  193. that time.  In connection with RECONNECT (see PARM30.DOC) its meaning and
  194. purpose are here illustrated:
  195.  
  196. OM Waldheini has connected with considerable effort step by step through
  197. from Munich to Kiel to DB0IL.  From there he has connected to DB0IL-1 and
  198. the BBS DB0OQ, then abandoned it with the command 'QUIT'.  If DB0IL were now
  199. reconnectable (version 1.16) OM Waldheini would again end up on DB0IL and
  200. could connect from there to other OM's in Kiel without having to renew, with
  201. great effort, the connection from Munich to Kiel. In that DB0IL does not
  202. have at this time version 1.16, OM Waldheini would end up on the next
  203. reconnectable node, WHICH HE HAD CONNECTED TO MANUALLY, in this case for
  204. example DB0HHW (Hamburg-west).  If he wanted now to go back further, for
  205. example to Verden, he would enter a 'QUIT' to DB0HHW and end up on the
  206. Verden node (always assuming that he had connected to Verden manually).
  207.  
  208. This idea originated from DB2OS and DL8ZAW and has been installed
  209. into TheNetNode.
  210.  
  211. ----------------------------------------------------------------
  212.  
  213. Command LED (L):
  214. ================
  215. The routine for remote control of the CON LED and the STA LED was
  216. removed from its customary location. (111 Bytes saved...).
  217. The new command is called:
  218.  
  219. 'LED 0':       Both LED's off.
  220. 'LED 1':       STA LED on, CON LED off.
  221. 'LED 2':       CON LED on, STA LED off.
  222. 'LED 3':       Both LED's on.
  223.  
  224. The current supplied to light the LED may be used to actuate external relays
  225.      ---------------------------------------------------------------
  226.  
  227. Command NODES expanded:
  228. =======================
  229.  
  230. The command 'N callsign' would bring up, in the case of a callsign not in
  231. the list, not the entire list but rather the announcement 'no entry for:
  232. callsign'.
  233.  
  234. ------------------------------------------
  235. Here is the file PARM30.DOC
  236.  
  237.  
  238. Parameter 30 (16 bit) is bit-transparent, that is each bit is a
  239. particular flag.
  240.  
  241. Bit 0 (Value 1):  TEST-diddle available
  242.                   The command TEST generally available (without
  243.                   sysop)  For details see TN116.DOC.
  244.  
  245. Bit 1 (Value 2):  Downlink blocked
  246.                   The node can indeed be connected to, however
  247.                   a level 2 connect for a user from there on
  248.                   out is not possible. (significant with a
  249.                   clean interlink-node).
  250.  
  251. Bit 2 (Value 4):  Uplink blocked
  252.                   The node can indeed be connected by way of
  253.                   level 2, any other command with the exception
  254.                   of the sysop's leads to a disconnect. (should
  255.                   prevent a user entering on an interlink,
  256.                   similar to version 1.1-i from DF3AV.
  257.  
  258. Bit 3 (Value 8):  Connect by means of ID not possible.
  259.                   Anyone who is of the opinion that the ID is
  260.                   not an official callsign although it appears
  261.                   in the address field and so the user should
  262.                   be permitted to enter a node only with the
  263.                   call and not with the ID, should set this
  264.                   flag on 1.
  265.  
  266. Bit 4 (Value 16): Broadcast on the HDLC-port completely shut off.
  267.                   Significant for the entered node.  Then in
  268.                   general no node list would be sent on the
  269.                   RF-port (also not the particular node
  270.                   callsign!).  Users of simple terminal programs
  271.                   will be thankful that no control characters
  272.                   mess up the screen or completely wipe it out.
  273.  
  274. Bit 5 (Value 32): Broadcast on the RS232-port completely shut
  275.                   down.  As with bit 4, so again on the
  276.                   RS232-port.  Can be useful, in order to
  277.                   separate a net immediately and to permit
  278.                   manual entry of only certain connections.
  279.                   See also TN116.DOC under 'Command ID'.
  280.  
  281. Bit 6 (Value 64): Broadcast on the HDLC-port shut down with
  282.                   the exception of the passing on of certain
  283.                   node-calls.
  284.  
  285. Bit 7 (Value 128):  Broadcast on the RS232-port shut down with
  286.                     the exception of certain node-calls.
  287.  
  288.                     Bits 6 and 7 set together have the same
  289.                     effect as parameter 6 > parameter 5.  Only
  290.                     it is now possible to separate each port.
  291.  
  292. Bit 8 (Value 256):  User prompt enable
  293.                     User prompt on as with TheNetNode.  In that
  294.                     some terminal programs have had trouble with
  295.                     older versions, it is made switchable.
  296.  
  297. Bit 9 (Value 512):  Start prompt disable
  298.                     The prompt at the beginning of a node
  299.                     announcement (for example INFO) can appear
  300.                     not good visually.  Now it can be shut down,
  301.                     except for a few cases, where certain
  302.                     terminal programs have an allergic reaction.
  303.                     (for example PAR on a terminal program with
  304.                     parameter values)
  305.  
  306. Bit 10 (Value 1024):  Reconnect enable.
  307.                       Brought over from TheNetNode.
  308.                       See TN116.DOC, QUIT and RECONNECT
  309.  
  310. Bit 15             :  PTT - disable
  311.                       Shuts down the node transmitter.  Results
  312.                       directly in the level 1 partition.
  313.                       CAUTION!!!  There is now no possibility to
  314.                       re-enable the PTT over the HDLC (radio) port.
  315.                       It can be accessed only through a node that is
  316.                       connected to its RS-232 port.
  317.  
  318. The value of the Parameter 30 can be set from the various values
  319. together.
  320.  
  321. Example:
  322.  
  323. Par 30 = 0:  TEST-diddle only for sysop
  324.              Downlink available
  325.              Uplink available
  326.  
  327. Par 30 = 1:  TEST-diddle generally available
  328.  
  329. Par 30 = 6:  TEST-diddle only for sysop
  330.              Downlink and uplink blocked
  331.  
  332. I hope this is generally clear.
  333. (Translator's note:  Not at all clear to me, but the following is better:)
  334.  
  335. For everyone who does not understand this, in order to facilitate
  336. it the FLAG-command is newly introduced under sysop control.
  337.  
  338. 'F 5 0' for example means par 30 bit 5 would be set to 0.
  339.  
  340. 'F 15 1':  PTT would be closed down
  341.            This can be a one-way street!!!!!!!!!!!!!!
  342.  
  343. 'F' displays the individual flags
  344.  
  345. DL2LAY @ DB0HB     Translation to English by W9BVD
  346.                    Additional editing by K3AKK
  347.