home *** CD-ROM | disk | FTP | other *** search
/ HAM Radio 1 / HamRadio.cdr / misc / thenet_d / thenet.doc next >
Text File  |  1988-10-24  |  48KB  |  1,177 lines
  1.  
  2.  
  3.                                NORD><LINK
  4.  
  5.                    User Documentation for TheNet Network Software
  6.                           Version 1.0 dated 05.27.88
  7.  
  8. Originators                   : DB2OS Peter, DC4OX Michael, DF2AU Georg.
  9. Edited by                     : DB2OR Peter
  10. Reprints with CC allowed for noncommercial use
  11. ----------------------------------------------
  12.  
  13.                    1. Commands for the User
  14.                    ---------------------------
  15.                    ---------------------------
  16.  
  17.                              1.1 USER
  18.                              --------
  19.  
  20. After entering 'U' (for USER) you should see:
  21.  
  22. H:DB0FD> TheNet 1.0 (736)
  23. Uplink(DB2OS)              <--> Circuit(BS:DB0FC-8 DB2OS)
  24. Uplink(DC4OX)              <..> Downlink(DC4OX-15 DC8AM)
  25. Circuit(BS:DB0FC DF2AU)    <--> Circuit(DJ9KD-10 DF2AU)
  26. Uplink(DB2OR)              <..> CQ(DB2OR-15)
  27. Circuit(BS:DK4EG-1)        <--> Host(H:DB0FD)
  28. Uplink(DF3AV)
  29.  
  30.                                   DB0FD
  31.  
  32. is the official node-id of the TheNet-node.
  33.  
  34.  
  35.  
  36.                                     H
  37.  
  38. is the "Ident" of the node, a kind of pseudonym. This for once shall be
  39. a geographical information which allows to figure out the area where a
  40. unknown call is coming from. The Ident in addition to the function of the
  41. call-sign allows multiple connecting of nodes. So you can connect H, H-1,
  42. H-2, and so on at the same time but only DB0FD and not DB0FD-1, DB0FD-2.
  43. The other way, to do multiconnect on a TheNet-node, is to use your own
  44. call-sign with different SSIDs at the same time - but that is not supported
  45. by any TNC firmware nowadays.
  46. We also use the car license plate id of the area and for a 70cm-node, "70"
  47. is added. That seems most meaningful to us because other alternatives like
  48. ZIP-codes are not very mnemonic. This is NOT an abuse of call-signs because
  49. idents don't have a format following international standards.
  50. That is the same a a call to CQ or a test or a 4-digit call with Amtor which
  51. are not considered wrong used of the call-sign.
  52. The required use of call-sign every 10 minutes is taken care for and the
  53. idents in the AX.25 address field are limited to end-users and in between
  54. the nodes, the official call-sign is used.
  55. Every TheNet node can also be identified using the INFO, USER and NODES
  56. commands. The use of area license plate ids would increase the transparency
  57. of our networks considerably.
  58.  
  59.  
  60.                                   736
  61.  
  62. is the actual number of free buffers in the node. One buffer consists of 32
  63. bytes data and a 4 byte list-pointer, 36 bytes in total. Every stored
  64. information used up one buffer and the list of other known nodes takes up
  65. buffers too. The reason why this # of free buffers is made known to the
  66. user, is to tell him not to make any attempts if the # of buffers available
  67. is very small. Because, if TheNet does not have any free buffers, a reset
  68. is activated which clears all pending connects causing total loss of stored
  69. information. During regular operation, this case is almost impossible,
  70. as with TheNet parameters set to the default, there will never be a shortage
  71. of buffers (you cannot load many packets after another into the node).
  72.  
  73.  
  74.                                   Uplink
  75.  
  76. indicates that the user with call-sign in () entered the network on this note.
  77. An eventually used digipeater is not shown.
  78.  
  79.  
  80.                                   Downlink
  81.  
  82. indicates that the user with call-sign in () exits the network on this note.
  83. An eventually used digipeater is not shown.
  84.  
  85.  
  86.                                   Circuit
  87.  
  88. on the left side means that the user with call-sign in () is coming from
  89. the following node and has entered that node with the call-sign as follows.
  90.  
  91.  
  92.                                   Circuit
  93.  
  94. on the left side means that a connection to the node mentioned in () before
  95. is active and that the user there has the following call-sign.
  96.  
  97.  
  98.                                   Host
  99.  
  100. means a connection to the operator terminal of the node.
  101.  
  102.  
  103.                                   CQ
  104.  
  105. can only show on the right side and indicates that user "CQ" is calling.
  106. To activate a connection the call on the right hand side has to be
  107. issued in a connect command.
  108.  
  109.  
  110.                                   <-->
  111.  
  112. indicates an active connection.
  113.  
  114.  
  115.                                   <..>
  116.  
  117. indicates a connection being established.
  118.  
  119.  
  120. An entry without a right hand portion means that this is where the
  121. connection ends right now and the user is connected with the command
  122. interpreter of this node.
  123.  
  124.  
  125.                              1.2 NODES
  126.                              ---------
  127.  
  128. If you enter 'N' (for NODES) you should see:
  129.  
  130. H:DB0FD> Nodes:
  131. H70:DB0FD-7            DB0FC        DB0FE       DL0TEL    DB0JD
  132.  
  133. The shown idents:call-signs are other TheNet-nodes which can be reached
  134. by entering C H70 or C DB0DJ e.g. The path taken to such a node is
  135. of no interest; it is known to H (DB0FD) and that is enough.
  136. In order to get to DB0DJ you don't have to enter C DL0TEL and from there
  137. C DB0DJ as DB0DJ can only be reached via DL0TEL.
  138.  
  139. To learn about the exact path to DB0DJ you can enter:
  140.  
  141. N DB0DJ, and you should see:
  142.  
  143. H:DB0FD> Routes to: DB0DJ
  144.   0 2 0 DL0TEL via DJ4KW
  145.  
  146. That means that the path to DB0DJ from DB0FD leads to DL0TEL first via the
  147. non-TheNet-Digi DJ4KW. To learn about the rest of the path you have to
  148. connect to DL0TEL, entering C DL0TEL. The fact that you get there via
  149. an ordinary Digi is known to H and doesn't have to be entered.
  150. One also had to enter DJ4KW in addition, if DL0TEL is not known via DK4KW
  151. so its not showing up in NODES commands. At DL0TEL you can enter N DB0DJ
  152. again and so trace the rest of the path.
  153. Once again: This method is only necessary if you really have to know the
  154. path or if node DB0DJ is unknown to H. In order to run a QSO via node
  155. DB0DJ known to H, DB0DJ is sufficient.
  156.  
  157. Now there is one question:
  158. "If the path to DB0DJ is known to DB0FD, why can't I be told that when
  159. entering N DB0DJ ?"
  160.  
  161. That makes sense, but TheNet is organized in a way, so that a path is known
  162. only so far that the node knows about the destination and the next node
  163. to reach that destination.
  164. If all nodes are organized that way, the path is completely defined.
  165. This organization is meaningful because storing the complete path with
  166. many nodes involved used up too much space and the information is not
  167. really needed to build the connection.
  168.  
  169. Say you want to establish a connection to DB0DJ and enter C DB0DJ.
  170. The result might be:
  171.  
  172. H:DB0FD> Failure with DB0DJ
  173.  
  174. You could have guessed that in advance knowing about the parameters in
  175. detail:
  176.  
  177. H:DB0FD> Routes to: DB0DJ
  178.   0 2 0 DL0TEL via DJ4KW
  179.   | | |
  180.   | | +---------------"Port"- Indicates if the path is via the packet-channel
  181.   | |                  on to (0) or via RS232 on the node directly to the
  182.   | |                  next node (1, e.g. H-> H70).
  183.   | |
  184.   | +-----------------"obsolescence count" - for the user meaningful in so
  185.   |                    far 0 indicates that the path is fixed, i.e. won't
  186.   |                    be affected by automatic updates in TheNet.
  187.   |
  188.   +-------------------"quality" - Quality of the connection. This is the
  189.                        most important parameter for the user. 255 is max.
  190.                        and means it's a 99% connection, 128 stands for 50%,
  191.                        a real bad connection which certainly won't connect.
  192.                        (0 for newly established connections may also mean
  193.                        that a quality index is not available yet - and there
  194.                        is not much chance of a connection either).
  195.  
  196. If you enter N DL0CCC, you might see:
  197.  
  198. H:DB0FD> Routes to: DL0CCC
  199. > 0 2 0 DL0CCC via DJ4KW
  200.  
  201. The '>' preceding Route tells you that this Route is in use. Which doesn't
  202. mean a lot in this example as the quality was too bad for a connect.
  203. The '>' only means a lot if there are several paths (Routes) to a given
  204. destination and then it indicates which one is in use.
  205. TheNet automatically tries the one with the highest quality first.
  206.  
  207.  
  208.                              1.3 INFO
  209.                              --------
  210.  
  211. If you enter I (for INFO) you should see:
  212.  
  213. BS:DB0FC>
  214. NORD><LINK
  215. Braunschweig <JO52FG>
  216. 144.625 MHz, 5W, GP
  217. OPs: DF2AU, DK4EG 9 DK0MAV
  218.  
  219. This shows the identification of a node on request. So it is always
  220. possible to find out which node is involved and what it's official
  221. node-id is if it was connected with the ident pseudonym.
  222. For a better orientation in the network, the ident usually is preset
  223. by the caller using the license plate id of the area.
  224. In addition, TheNet automatically sends a beacon to "ID", to comply with
  225. the law.
  226.  
  227.  
  228.                              1.4 ROUTES
  229.                              ----------
  230.  
  231. If you enter R (for ROUTES) you should see:
  232.  
  233. BS:DB0FC> Routes:
  234.     0 DB0FD 0 0 |
  235.     0 DB0FE 0 0 |
  236.   > 1 DB0FC-7 248 1
  237.   > 1 DB0FC-7 248 15
  238.  
  239. This command gives an overview which paths are in use from this Digi
  240. right now and what their load is.
  241.  
  242. for every entry in the list of neighbors, it shows:
  243.  
  244. * ">" in case there is an active connection
  245. * the used port (0=HDLC Port, 1=RS232 Port)
  246. * the path to this neighbor (Call + eventually digipeater)
  247. * the quality of the path (255 = best, 0 = worst)
  248. * the # of connections which exist to this neighbor
  249. * "|" if the entry is fixed
  250.  
  251. If you only want to see the path to a specific neighbor, you have to
  252. enter:
  253.  
  254. ROUTES 1 DB0FC-7
  255. BS:DB0FC> Routes:
  256.   > 1 DB0FC-7 248 27
  257.  
  258.  
  259.  
  260.  
  261.                              1.5 PARMS
  262.                              ---------
  263.  
  264. If you enter P (for PARMS) you'll see:
  265.  
  266. BS:DB0FC>  50 1 100 248 6 5 1800 15 300 2 12 180 8 8 900 64 10 5 2 10 100
  267. 18000 0 1 2 1
  268.  
  269.  
  270. For users with an IBM PC and the program (TURBO PACKET) from
  271. DL1BHO the PARMS are evaluated right away and that looks like:
  272.  
  273. BS:DB0FC>  50 1 100 248 6 5 1800 15 300 2 12 180 8 8 900 64 10 5 2 10 100
  274. 18000 0 1 2 1
  275.  
  276. NET/ROM PARMS-evaluation:
  277.  
  278. 01: Max-Nodes 50    02: min-Quality 1   03: HF-Quality 100
  279. 04: V24-Quality 248 05: Obs-Init 6      06: min-BCast 5
  280. 07: Broadcast 1800  08: Lifetime 15     09: T-Timeout 300
  281. 10: T-Retry 2       11: T-AckDelay 12   12: T-BsyDelay 180
  282. 13: T-Window 8      14: NoAckBuf 8      15: Timeout 900
  283. 16: Persistance 64  17: SlotTime 10     18: FRACK 5
  284. 19: MAXFRAME 2      20: L2-Retry 10     21: T2-Timer 100
  285. 22: T3-Timer 18000  23: L2-Digi 0       24: CallCheck 1
  286. 25: ID-Beacon 2     26: CQ-UI-Frame 1
  287.  
  288.  
  289. This listing shows only constant values which only the operator of a system
  290. can change. There are no parameters which change during operation.
  291. The parameters listed above have turned out to be optimal.
  292. Otherwise it should be obvious that calling for those parameters all the
  293. time doesn't make much sense.
  294.                 -------------------------------------------
  295.                                 1
  296.  
  297.                         default  min  max
  298.                            50     1   400
  299.  
  300. 1. Max. # of entries in the destination node list. Every entry of a
  301. dest. node takes up 36 Byte in storage, so this parameter takes care
  302. for limiting this list so there is enough frame-buffer-space left.
  303.                 -------------------------------------------
  304.                                 2
  305.  
  306.                         default  min  max
  307.                            1      0   255
  308.  
  309. 2. Worst quality for automatic update of the destination node list.
  310. 0 = no auto-update. The destination node list is automatically kept
  311. up to date. To include only meaningful paths within a certain quality
  312. range, only paths with the defined quality (this parameter) are used.
  313. If this parameter is 0, automatic update is completely switched off.
  314.                 -------------------------------------------
  315.                                  3
  316.  
  317.                         default  min  max
  318.                           100     0   255
  319.  
  320. 3. Channel 0 (HDLC packet-channel) quality. Quality of the packet-channel
  321. normally the channel, to which the radio is connected.
  322.                 -------------------------------------------
  323.                                 4
  324.  
  325.                         default  min  max
  326.                           255     0   255
  327.  
  328. 4. Channel 1 (RS232, direct crosslink) quality. If 2 or more nodes are attached
  329. directly via the RS232-interface, this is the  quality of the RS232-channel.
  330.                 -------------------------------------------
  331.  
  332.                                 5
  333.  
  334.                         default  min  max
  335.                            6      0   255
  336.  
  337. 5. Initial value of the aging-count, 0 = aging count is not maintained.
  338. If a new node is found or updated or if a successful connect to a destination
  339. node is done, the aging count for this node is set to its initial value.
  340. Any time the auto-update-round-robin-interval (see below) expires, without
  341. having had a connection with the destination node in between, this count
  342. is decremented.
  343.                 -------------------------------------------
  344.  
  345.                                 6
  346.  
  347.                         default  min  max
  348.                            5      1   255
  349.  
  350. 6. Min. value of the count, for the path information to be sent to other
  351. nodes too. Only the nodes with a count exceeding this parameter are shared
  352. with neighbor nodes during automatic update.
  353. This parameter prevents the sharing of old paths. It should never exceed
  354. parameter 5, otherwise only the local node is shared with others.
  355.                 -------------------------------------------
  356.  
  357.                                 7
  358.  
  359.                         default  min  max
  360.                          1800     0  65535
  361.  
  362. 7. Destination-list-auto-update round-robin-interval in seconds,
  363. 0 = switched off. Within this interval, the reachable destination nodes
  364. are shared and the counts for all nodes reached are decremented.
  365. If this parm is 0, no sharing of reachable nodes with others is done.
  366.                 -------------------------------------------
  367.  
  368.                                 8
  369.  
  370.                         default  min  max
  371.                            10     0   255
  372.  
  373. 8. Initial count of network  packet-lifetime-counter. All network-
  374. (layer-4-) packets have a lifetime count, which indicates how long this
  375. packet is supposed to live. It defines, how many times this packet may
  376. be handed over from node to node. With every transfer through a node, the
  377. count is decremented. If it gets to 0, the packet is thrown away.
  378. If a packet originates locally, the lifetime-counter is initialized with
  379. this parameter. The counter is to prevent a packet from being transferred
  380. throughout the network in an endless loop. It should be set slightly higher
  381. than the number of nodes on the longest known path.
  382.                 -------------------------------------------
  383.  
  384.                                 9
  385.  
  386.                         default  min  max
  387.                           300     5   600
  388.  
  389. 9. Transport FRACK in seconds. Similar to FRACK on layer 2, but the time
  390. is much longer as the transport-layer starts at layer 2, so that no packets
  391. should get lost and retries should only be caused by brief interruptions
  392. (e.g. reset) or total loss of a node.
  393.                 -------------------------------------------
  394.  
  395.                                 10
  396.  
  397.                         default  min  max
  398.                            10     2   127
  399.  
  400. 10. Transport RETRY. Similar to RETRY on layer 2. After this number of
  401. retries, it is assumed that a node is down. Because, as mentioned in 9.,
  402. the transport-layer starts at layer 2, this counter can only be exceeded
  403. if a node fails for a short time or completely.
  404.                 -------------------------------------------
  405.                                 11
  406.  
  407.                         default  min  max
  408.                             6     1    60
  409.  
  410. 11. Transport acknowledge delay in in seconds. This number of seconds
  411. is used to wait for an acknowledge of incoming transport-layer packets.
  412. Its meaning is to eventually package the acknowledge into transport-layer
  413. packets to be sent thus saving one additional packet if one waits a while
  414. until maybe another transport-layer packet is to be sent.
  415.                 -------------------------------------------
  416.                                 12
  417.  
  418.                         default  min  max
  419.                           180     1  1000
  420.  
  421. 12. Transport busy-delay in seconds. If there are many transport-layer packets
  422. arriving at a destination node (see 14.), the transport-layer goes busy or
  423. "choke". This state is communicated to the local node, so the node won't
  424. send any more packets. If the choke is released that will be communicated too.
  425. If the release info does not come through because maybe a node in the path
  426. is down, the flag for the choke state is deleted after the busy-delay time
  427. anyway, even if there was no release message.
  428.                 -------------------------------------------
  429.                                 13
  430.  
  431.                         default  min  max
  432.                            4      1   127
  433.  
  434. 13. Transport window-size in # of frames. Number ot the transport-layer
  435. packets not within the expected transport-send-sequencenumbers which are
  436. stored on receiving. The number of transport packets which can be sent
  437. in sequence without an acknowledge.
  438.                 -------------------------------------------
  439.                                 14
  440.  
  441.                         default  min  max
  442.                            4      1   127
  443.  
  444. 14. Overfill-limit in # of frames. Number of packets which can be stored
  445. on the transport-layer, until a choke-info is sent to the connected node.
  446. This identifies also the number of frames which can be stored on the link-
  447. layer, before the link-layer goes busy.
  448. This limit prevents an overload of a TheNet-node in case of too many incoming
  449. transport-layer packets or in case a station in a link is trying too many
  450. packets all at once.
  451.                 -------------------------------------------
  452.                                 15
  453.  
  454.                         default  min  max
  455.                           900     0   65535
  456.  
  457. 15. No-activity-timeout in seconds, (0 = switched off). If ther is no
  458. exchange of information on layer-2-link for that amount of time, the
  459. link is cancelled.
  460.                 -------------------------------------------
  461.                                 16
  462.  
  463.                         default  min  max
  464.                            64     0   255
  465.  
  466. 16. P-persistance value. This parameter serves for decision making for
  467. the transmitter control and to avoid collisions.
  468. Every time, a packet is going to be transmitted, you must wait until the
  469. channel is free (no DCD). If the channel is free, a random number between
  470. 0 and 255 is generated. If this random number is smaller of equal the
  471. p-persistance value, the TNC will acknowledge the PTT-line and data transfer
  472. is started. If the random number is not within the p-persistence range,
  473. the TNC won't start transmitting and will wait for some time and then
  474. repeat the above algorithm. The duration of the delay is defined by the
  475. next parameter.
  476.                 -------------------------------------------
  477.                                 17
  478.  
  479.                         default  min  max
  480.                            10     0   127
  481.  
  482. 17. Slot time interval in 10ms. This parameter defines the duration of the
  483. time slot for the p-persistance-control.
  484. Every time the TNC transmits a packet and the random number mentioned in 16.
  485. is not within the des p-persistance-range, a wait is performed for the
  486. slot time and then the procedure is started all over.
  487.                 -------------------------------------------
  488.                                 18
  489.  
  490.                         default  min  max
  491.                             5     1   15
  492.  
  493. 18. User-Link FRACK in seconds. Defines the number of seconds between
  494. repetition of not acknowledged packets or between polls.
  495. If ordinary digipeaters are used, this number is calculated as follows:
  496.  
  497. (# of digipeaters * 2 + 1) * FRACK.
  498.  
  499. To avoid collisions (see FRACK-text in this paragraph) there is another
  500. multiplication with a random number <= 1.
  501.                 -------------------------------------------
  502.                                 19
  503.  
  504.                         default  min  max
  505.                             2     1    7
  506.  
  507. 19. User-Link MAXFRAME in # of frames. Number of packets on layer-2
  508. which may be sent in sequence without receiving an acknowledge.
  509.                 -------------------------------------------
  510.                                 20
  511.  
  512.                         default  min  max
  513.                           10      0   127
  514.  
  515. 20. User-Link RETRY, 0 fore always. Defines the number of retries to
  516. establish layer-2 contact to another station (answer on commands and
  517. poll). After this number of retries the link is recorded as down.
  518. 0 set on an 24h-QRV-station would cause a disaster, so be warned.
  519.                 -------------------------------------------
  520.                                 21
  521.  
  522.                         default  min  max
  523.                           100     0   65535
  524.  
  525. 21. User-link T2 in milliseconds * 10. This timer defines the waiting time
  526. following which an incoming packet is acknowledged with a RR/REJ/RNR-packet.
  527. This delay should improve throughput because there is a chance to send for
  528. someone also during that time and there is also a chance for the send-layer,
  529. to add a pending acknowledge into another packet thus saving one link-layer
  530. packet.
  531.                 -------------------------------------------
  532.                                 22
  533.  
  534.                         default  min  max
  535.                         18000     0   65535
  536.  
  537. 22. User-link T3 (timer 3 ) in milliseconds * 10. This parameter defines
  538. the time after which layer-2 will check if a link is still active, if
  539. ther have been no activities. It is used similarly to the transport-layer
  540. to overcome deadlocks on layer-2.
  541.                 -------------------------------------------
  542.                                 23
  543.  
  544.                         default  min  max
  545.                            0      0    1
  546.  
  547. 23. AX.25 digipeating on (1) / off (0). If switched to on, the node can
  548. be used as a "normal" digipeater. As normal digipeating is not used
  549. in TheNet and has disadvantages over real TheNet-connections (see FRACK
  550. in another text in this section) it's not necessary. It only made sense
  551. at a time when there were almost only mailboxes which were doing store-and-
  552. forward operations following the fixed W0RLI-scheme.
  553. In the meantime there is mailboxsoftware from DF3AV (Die BOX) as well as
  554. W0RLI which can handle TheNet too.
  555.                 -------------------------------------------
  556.                                 24
  557.  
  558.                         default  min  max
  559.                            1      0    1
  560.  
  561. 24. Call-sign-check on (1) / off (0). If set to on, the call-signs
  562. except the idents have to meet the following requirements when
  563. they are entered:
  564. a) The length of a call-signs must be from 4 to 6 characters.
  565. b) All characters must be numeric or alphanumeric.
  566. c) The call-sign must contain one or two numerics.
  567. d) The last character of the call-sign must be alphanumeric.
  568. e) SSID, if used, must be between  0 and 15.
  569.                 -------------------------------------------
  570.                                 25
  571.  
  572.                         default  min  max
  573.                            2      0    2
  574.  
  575. 25. Stations identification bake.
  576.  
  577.         0 = NONE    , no ID-Bake.
  578.         1 = AFTER   , only after transmitting.
  579.         2 = EVERY   , always.
  580.  
  581. I set to on, a packet by which the node identities itself with call-sign
  582. and ident is sent every 10 minutes. The necessity of this bake results
  583. from the use of an ident and also from the requirement for a special
  584. TheNet watchdog which has to become active after there has been no PTT
  585. activity for more then 10 minutes. Attention: If the parameter is set to
  586. "1" the ID-bake is transmitted only if there is any activity via the node
  587. or if the nodes-bake is transmitted. If the TNC does not transmit for some
  588. time, then there is no nodes-bake either.
  589. So if you are operating in watchdog mode, this parameter has to be set to "2".
  590.                 -------------------------------------------
  591.                                 26
  592.  
  593.                         default  min  max
  594.                            1      0    1
  595.  
  596. 26. CQ-call UI-frame on (1) / off (0). If set to on, the optional text
  597. following the CQ-command is sent as UI-packet (with sender call-sign
  598. "call-15" and destination call-sign "CQ"). This does only make sense
  599. on the network entrance node.
  600.  
  601.  
  602.                             1.6 CQ
  603.                             ------
  604.  
  605. By entering  CQ you can start a CQ-call via every TheNet node.
  606.  
  607. SYNTAX:       CQ
  608.               CQ text... (optional with Text, not more than 75 char)
  609.                          (no additional digipeater allowed)
  610.  
  611.  
  612. How do I start a CQ-call ?
  613.  
  614. Let's assume DB2OS in Hannover would like to place a general CQ-call to a
  615. node in Braunschweig. First he makes requests a connection to BS:DB0FC and
  616. there he enters the CQ-command:
  617.  
  618.  
  619. example:
  620.  
  621. * c db0fd
  622. * (1) CONNECTED to DB0FD *
  623.  
  624. c bs
  625. H:DB0FD> Connected to BS:DB0FC
  626.  
  627. cq CQDX de DB2OS HANNOVER JO42VG/EM60G VIA BS -- PSE CONNECT DB2OS-15
  628.  
  629.  
  630. IMPORTANT: By a command following it or a RETURN, the CQ-state is cancelled!
  631. ----------
  632.  
  633.  
  634. VERSION A)
  635. -----------
  636. OM Karl, DK7AL is connected to BS at the same time and will see the
  637. following data:
  638.  
  639. BS:DB0FC> TheNet 1.0 (731)
  640. Uplink(DF3AV)                     <--> Circuit(BS77:DB0FC-8 DF3AV)
  641. Uplink(DF2AU)                     <..> Downlink(DF2AU-15 DK4EG-1)
  642. CircuitH:DB0FD DB2OS)             <..> CQ(DB2OS-15)
  643. Uplink(DK7AL)
  644.  
  645. "<..> CQ(DB2OS-15)" indicates that DB2OS (via node H:DB0FD) is looking
  646. for a connection into the BS area and has entered the CQ-command.
  647.  
  648. DK7AL now has to enter only "C DB2OS-15" and will at once be connected
  649. to DB2OS !!! The troublesome backtracking of the path is not necessary
  650. any more.
  651.  
  652. VERSION B)
  653. ----------
  654. OM Wolfgang, DB3AN is monitoring  the frequency and suddenly sees the following
  655. packets on the screen (WA8DED Firmware):
  656.  
  657. fm DB2OS-15 to CQ ctl UI^
  658. CQDX de DB2OS HANNOVER JO42VG/EM60G via BS -- PSE CONNECT DB2OS-15
  659.       |         |
  660.       |         |
  661.       |         +--------------------------CQ CQ CQ...probably with text
  662.       |
  663.       +------------------------------------sender, OM Peter, DB2OS
  664.  
  665. This packet has been transmitted from BS:DB0FC right after receiving the
  666. CQ-command (with text) as a UI-packet.
  667.  
  668. In order to answer the CQ-call, Wolfgang did not have to connect the node
  669. BS first, but enters with his TNC the command to establish a connection with
  670. DB2OS-15 (Connect DB2OS-15, careful with SSID |), as if DB2OS-15 was a direct
  671. neighbor. After BS:DB0FC received the SABM-packet from DB3AN, the connection
  672. with DB0OS is installed at once and on the other end there is the message:
  673.                       "BS:DB0DC> Connected to DB3AN".
  674.  
  675. As you see. the connection can be build on the user-level of a node or
  676. directly after viewing the CQ-call.
  677.  
  678.  
  679.  
  680.  
  681.                              1.7 CONNECT
  682.                              -----------
  683.  
  684. The connect command is used to establish a connection with another node,
  685. another user or with the host-terminal of the TNC. That's the sequence
  686. in which the command is analysed.
  687.  
  688.  
  689. CONNECT DB0FD
  690.  
  691. means to scan the list of known destinations for the call DB0FD. If found,
  692. a connection is established and the following message is displayed:
  693.  
  694. BS:DB0FC> connected to DB0FD
  695.  
  696. If DB0FD cannot be found in the destination list, the node assumes that
  697. DB0FD must be another user and transmits SABMs to this call-sign.
  698. If there is an acknowledge, the following message is displayed:
  699.  
  700. BS:DB0FC> connected to DB0FD
  701.  
  702. A user can also be connected via digipeater. Then you would have to
  703. enter:
  704.  
  705. CONNECT DB3AN via DC4OX
  706.  
  707. The term "via" maybe omitted or abbreviated. Up to 8 digipeaters are
  708. possible. The call-signs then have to be separated by blanks.
  709.  
  710.  
  711.  
  712. To connect to a host-terminal you have to enter:
  713.  
  714. CONNECT
  715.  
  716. without further parameters
  717.  
  718. Potential error messages are:
  719.  
  720. Failure with .....: the destination requested did not answer
  721. Busy from.........: the destination refused to establish a connection
  722.  
  723. The following messages indicate that the node is overloaded and that's
  724. why the connection could not be established:
  725.  
  726. Node busy
  727. Link table full
  728. Circuit table full
  729. Host table full
  730.  
  731. A connect command can be cancelled any time by entering arbitrary data,
  732. e.g. a blank line.
  733.  
  734.  
  735.  
  736.                    2. Commands for the User
  737.                    ------------------------
  738.                    ------------------------
  739.  
  740.  
  741.                              2.1 NODES
  742.                              ---------
  743.  
  744. Syntax: NODES nodecall + ident quality Count Port neighbor (digicall...)
  745.     or: NODES nodecall - ident quality Count Port neighbor (digicall...)
  746.  
  747. where:
  748.      nodecall = Destination call
  749.      ident    = Destination pseudonym (or *, if unknown or none given)
  750.      quality  = path quality
  751.      Count    = Initial lifetime of this destination. If 0, the destination
  752.                 is assumed to be permanent.
  753.      Port     = Port to the next neighbor. 0 is the HDLC port, 1 is the
  754.                 RS232 port.
  755.      neighbor = neighbor's call-sign, via which the destination shall be
  756.                 reached. If the destination cannot be reached directly,
  757.                 the call-sign of the destination has to be repeated.
  758.      digicall = max. 2 digipeater for the path to the neighbor. The call-
  759.                 signs are separated by blanks.
  760.  
  761. The Nodes command allows for manually changing entries in the destination
  762. list or to delete them without defining new ones.
  763.  
  764. The command with "+" adds a new destination to the list or updates a given
  765. entry with new parameters.
  766.  
  767. The command with "-" deletes an entry. A destination will only vanish
  768. completely from the list after the last path to it has been deleted.
  769.  
  770. Invalid entries do not result in error messages but they are simple skipped.
  771.  
  772.  
  773.                              2.2 INFO
  774.                              --------
  775.  
  776. Syntax: INFO text
  777.  
  778.  where: text = char. string, <CR> = 0D HEX as end-character.
  779.  
  780. The text may be max. 80 characters. Longer strings are cut off. The minimum
  781. length is 1 character. Deleting is only possible by entering another message.
  782. After a cold start, the message is empty. Thus a loss of power can be detected
  783. easily. The message is appended to the message contained in the EPROM
  784. (a user's I command).
  785.  
  786.  
  787.                              2.3 ROUTES
  788.                              ----------
  789.  
  790. Syntax: ROUTES port nodecall (digicall...) + quality
  791.     or: ROUTES port nodecall (digicall...) - quality
  792.  
  793. where:
  794.      port        = port to the next neighbor. 0 is the HDLC port, 1 is
  795.                    the RS232 port.
  796.      nodecall    = Destination call.
  797.      digicall    = max. 2 digipeater for path to reach the neighbor. The
  798.                    call-signs are separated by blanks.
  799.      quality     = path quality.
  800.  
  801. Entries into the neighbors list are created automatically if the round
  802. robin call by the neighbor is received. They can also be created manually
  803. using a NODES + command. Every new entry is marked "free" and is set to
  804. the standard quality of the used channel. With the ROUTES command, it is
  805. possible to update the quality and to lock the paths.
  806.  
  807. The command "+" locks the entry given by port, nodecall and digicall
  808. and sets the quality parm of this path.
  809. If the referenced entry does not yet exist, it is created, initialized
  810. with the values mentioned above and locked.
  811.  
  812. The command "-" releases the entry. If the path to the destination is not
  813. used, the entry is deleted at once. Otherwise the parameters are used like
  814. in the "+" version. A not locked entry is deleted the very moment it is
  815. not used by a channel any more.
  816.  
  817. The quality of a path is used when searching for the best path to a given
  818. destination. By changing this entry using the ROUTES+ command, the search
  819. via certain neighbors can be made easier or more difficult.
  820. By setting the quality of a path to 0 and locking it, you can force the
  821. system to ignore the path completely and even round robin calls by those
  822. neighbors won't then be received.
  823.  
  824.  
  825.  
  826.  
  827.                              2.4 PARMS
  828.                              ---------
  829.  
  830. Synatx: PARMS parmlist
  831.  
  832.  where: parmlist = sequence of new settings for the parameters in the
  833.         same format as used with the PARMS command.
  834.         Entering "*" instead of a value, won't change the parameter defined
  835.         by this position.
  836.         The variables must be separated by blanks.
  837.  
  838.  
  839. Using the PARMS command, the user can adjust the parameters of a node to
  840. actual requirements ore do some experiments without having to program an
  841. EPROM for every change.
  842.  
  843. Invalid (i.e. not within the allowed range) values will cause a command abort.
  844. It is not necessary to enter the complete list all the time. It is okay to
  845. enter the values up to the last parameter to be changed.
  846.  
  847. As there are no error messages for invalid entries, the setting should be
  848. be checked afterwards with the PARM command (without argument).
  849. During all experiments, you should carefully consider in advance, what you
  850. want to achieve. With a bad combination of settings it is perfectly possible
  851. to block the whole node, even for users being actually logged on.
  852.  
  853.  
  854.                              2.5 SYSOP
  855.                              ---------
  856.  
  857. Syntax: SYSOP
  858.  
  859. With the SYSOP command, a user request being accepted as a participating
  860. user. In return, he is sent 5 numbers from the node and has to answer
  861. giving the 5 numbers of his own password. There is no feedback about
  862. success or failure of this command.
  863. It is perfectly legal to intentionally do several attempts with wrong
  864. passwords, followed by a correct one and then wrong ones again. That
  865. is to confuse others which might be listening. The acceptance as a user
  866. will be kept until a disconnect.
  867.  
  868.  
  869.  
  870.                              2.6 HIGH
  871.                              --------
  872.  
  873.  
  874. Syntax: HIGH portnumber
  875.  
  876.  where: portnumber = number of the port desired. The connect exit is 0,
  877.         the status exit 1.
  878.  
  879. The exit portnumber will be activated. (relay on, LED on).
  880.  
  881. After a reset, both ports are inactive.
  882.  
  883. Using this and the LOW command, a power or antennae switch can be done.
  884.  
  885.  
  886.                              2.7 LOW
  887.                              -------
  888.  
  889. Syntax: LOW portnumber
  890.  
  891.  where: portnumber = number of the port desired. The connect exit is 0,
  892.         the status exit 1.
  893.  
  894. The exit port will be inactivated (relay off, LED off).
  895.  
  896.  
  897.                              2.8 RESET
  898.                              ---------
  899.  
  900. Syntax: RESET
  901.  
  902. RESET causes a cold start. All RAM will be initialized. All lists are
  903. deleted, all connections (even the user's own) are disconnected. All
  904. parameters are initialized with the EPROM settings. The INFO is cleared.
  905. The password is fetched from the EPROM.
  906.  
  907.  
  908.  
  909.  
  910.     3. Commands which can only be entered from a Terminal
  911.     -----------------------------------------------------
  912.     -----------------------------------------------------
  913.  
  914. All commands are started with a special character (see patch list).
  915. The default is <ESC> = 1B HEX. On access from a terminal, the user
  916. authorization is set automatically.
  917.  
  918. 3.1. F
  919. ------
  920.  
  921. The network works full duplex. This can be switched from the host terminal
  922. only. The command is <ESC> F 0 to switch to half duplex and <ESC> F 1 to
  923. switch to full duplex. Via a constant in the EPROM, you can select if the
  924. sender is quiet during breaks (PTT = off) or if flags are sent then.
  925.  
  926.  
  927. 3.2. C
  928. ------
  929.  
  930. The terminal is connected to the command processor of the node. All
  931. commands like during a normal HF connect are possible.
  932.  
  933.  
  934. 3.3. D
  935. ------
  936.  
  937. The terminal is disconnected from the command processor of the node.
  938.  
  939.  
  940. 3.4. P
  941. ------
  942.  
  943. Syntax: P text
  944.  where: text = char. string. End char is <CR> = 0D HEX.
  945.  
  946. Using this command, you can enter a new password. It consists of max.
  947. 80 characters. All characters except <CR> = 0D and <LF> = 0A HEX are
  948. valid, even control characters. Upper and lower case makes a difference.
  949. Please consider in advance, if you will later be able to send those characters
  950. from your TNC! On SYSOP the blanks within a password are not checked.
  951.  
  952. The command P without argument, will show the current password framed by
  953. two asterisks.
  954.  
  955.  
  956. 3.5. T
  957. ------
  958.  
  959. Syntax: T value
  960.  where: value = number from 0 to 255
  961.  
  962. T determines the delay from PTT active to the start of transmitting the first
  963. data via the HDLC port. The delay is (value * 10 milliseconds).
  964.  
  965. The command T without argument displays the actual setting.
  966.  
  967. The default after reset is taken from the EPROM (300 ms):
  968.  
  969.  
  970. 3.6. Y
  971. ------
  972.  
  973. Syntax: Y flag
  974.  where: flag = 0 or 1
  975.  
  976. The command Y allows external connect requests to be handled or inhibited
  977. ( the requestor gets a "Busy from ...").
  978.  
  979. Flag 0 = inhibits connections, flag = 1 permits them.
  980.  
  981. The command Y without argument displays the actual setting.
  982.  
  983.  
  984.  
  985.                                 4. Remarks
  986.                                 ----------
  987.                                 ----------
  988.  
  989.                              4.1 Default Settings
  990.                              --------------------
  991.  
  992. All default parameter are contained in a list at the beginning of the EPROM.
  993. These also contain the call-sign, the sign of the digipeater and a default
  994. password. Thus a remote access of the owner is possible even after a complete
  995. loss of the operation parameters.
  996.  
  997.  
  998.                         4.2 Quality of a connection
  999.                         ---------------------------
  1000.  
  1001. The quality can be in the range of 0 to 255 and reflects the reliability and
  1002. the speed of a channel, that is finally the overall throughput.
  1003. The quality value is more or less a matter of experience.
  1004.  
  1005. quality / 256 * 100% = quality in %
  1006.  
  1007. Recommended values:                                quality  % "perfect"
  1008.  
  1009. 9600 Baud RS232 cable between two nodes              255         99%
  1010. 9600 Baud RS232 diode matrix between 3 nodes         248         96%
  1011. 9600 Baud Packet-channel, only 2 nodes have access   240         93%
  1012. 1200 Baud Packet-channel, only 2 nodes have access   224         87%
  1013. 1200 Baud Packet-channel, User and several nodes     192         75%
  1014.  300 Baud Packet-channel, shortwave                  128         50%
  1015.  
  1016. rough estimate: 255 = 99% = "almost every packet makes it"
  1017.                 128 = 50% = "only every second packet makes it"
  1018.  
  1019. The quality of a path via several nodes is composed of the single qualities
  1020. of the connections:
  1021.  
  1022. Overall quality = (Q1/256 * Q2/256 * ... * Qn/256) / * 256
  1023.  
  1024. Example : node 1 <-> node 2   =  255 (99%)
  1025.           node 2 <-> node 3   =  255 (99%)
  1026.           node 3 <-> node 4   =  224 (88%)
  1027.           node 4 <-> node 5   =  224 (88%)
  1028.  
  1029. gesamt (255/256 * 255/256 * 224/256 * 224/256) / 256 = 192 (75%)
  1030.  
  1031.  
  1032. --------------------------------------------------------------------------
  1033.  
  1034.          Hints to make changes to a TNC for operation as a network node
  1035.                           following DL1BHO
  1036.  
  1037. Clock rate of the SIO-SyncB-clock
  1038. ---------------------------------
  1039.  
  1040. If the TNC is operated with 2.4576 MHz, the BR1 connection on the board
  1041. must be removed and SyncB (SIO Pin 29) must be connected to Pin 1 of 74HC4060.
  1042. This change is also described in the TNC2c-guide.
  1043.  
  1044. If the TNC is operated with 4.9152 MHz, the following changes are necessary:
  1045.  
  1046. -   Change quartz
  1047. -   remove 27pF capacitor
  1048. -   replace 100pF capacitor with 50pF
  1049. -   Remove BR1 connection and SyncB (SIO Pin 29) to Pin 2 (Pin 2 !!!) of the
  1050.     HC4060. Pin 2 is not positioned close to BR1, but the change is necessary
  1051.     for the SyncB-clock to be 600 Hz.
  1052.  
  1053.  
  1054. Change for Operation with Network-Software
  1055. ------------------------------------------
  1056.  
  1057. From Pin 2 of the MAX232, connect a 4,7K resistor to pin 8 of the MAX232
  1058. (often already in place in newer TNCs, ... beneath the board).
  1059.  
  1060. The connection of SIO-pin 22 has to be changed as follows:
  1061.  
  1062. -   Remove the connection from SIO-pin 22 to the through contact
  1063. -   10K resistor from SIO-pin 22 to the through contact
  1064. -   Connect SIO-pin 22 with a piece of wire to pin 23 of the V24-connector
  1065. -   With a wire from pin 8 of the V24-connector to pin 10, tie pin 10 of the
  1066.     connector to +5V.
  1067.  
  1068. If only one connector cable between the TNCs is used, as it it recommended
  1069. in the TheNet manual, then the wire from pin 10 to pin 23 ties pin 22 to
  1070. +5V and the software is able to understand that a TNC is connected to the
  1071. port.
  1072.  
  1073.  
  1074.  
  1075.  
  1076.  
  1077. --------------------------------------------------------------------------
  1078.  
  1079.               Connector Cable for 2 TNCs Interlink Operation
  1080.  
  1081.  
  1082. TNC 1                                        TNC 2     signal
  1083. +----+                                       +----+
  1084. I 1  I---------------------------------------I 1  I    prot. ground
  1085. I    I                                       I    I
  1086. I 2  I-------------.    .--------------------I 2  I    Tx data
  1087. I    I             .----+----.               I    I
  1088. I 3  I------------------.    .---------------I 3  I    Rx data
  1089. I    I                                       I    I
  1090. I 5  I---                                 ---I 5  I    CTS
  1091. I    I                                       I    I
  1092. I 20 I---                                 ---I 20 I    DTR
  1093. I    I                                       I    I
  1094. I 7  I---------------------------------------I 7  I    signal ground
  1095. I    I                                       I    I
  1096. I 10 I---.                               .---I 10 I    V-
  1097. I    I   I                               I   I    I
  1098. I 23 I---.                               .---I 23 I    DRS
  1099. I    I                                       I    I
  1100. +----+                                       +----+
  1101.  
  1102.  
  1103. --------------------------------------------------------------------------
  1104.  
  1105.               Connector Cable for 3 TNCs Interlink Operation
  1106.  
  1107.  
  1108. TNC 1
  1109. +----+
  1110. I    I
  1111. I 1  I--------.
  1112. I    I        I
  1113. I 2  I--------+---------------------------------------------------X----.
  1114. I    I        I                                                   I    I
  1115. I 3  I--------+----------------------------------------X------.   I    I
  1116. I    I        I                                        I      I   K    K
  1117. I 5  I--------+-----------X--------------.             I      I   A    A
  1118. I    I        I           I              I             I      I   I    I
  1119. I 20 I--------+-----------+--------------+-----X---.   I      I   I    I
  1120. I    I        I           I              I     I   I   I      I   I    I
  1121. I 7  I--------+---.       I              I     I   I   I      I   I    I
  1122. I    I        I   I       I              I     A   A   I      I   I    I
  1123. I 10 I---.    I   I       I              I     K   K   I      I   I    I
  1124. I    I   I    I   I       I              I     I   I   I      I   I    I
  1125. I 23 I---.    I   I       I              I     I   I   I      I   I    I
  1126. I    I        I   I       I              I     I   I   I      I   I    I
  1127. +----+        I   I       I              I     I   I   I      I   I    I
  1128.               I   I       I              I     I   I   I      I   I    I
  1129.               I   I       I              I     I   I   I      I   I    I
  1130.               I   I       I              I     I   I   I      I   I    I
  1131. TNC 2         I   I       I              I     I   I   I      A   I    I
  1132. +----+        I   I       I              I     I   I   I      K   I    I
  1133. I    I        I   I       I              I     I   I   I      I   I    I
  1134. I 1  I--------X   I       I              I     I   I   I      I   I    I
  1135. I    I        I   I       I              I     I   I   I      I   I    I
  1136. I 2  I--------+---+-------+--------------+-----+---+---+------X   I    I
  1137. I    I        I   I       I              I     I   I   I      I   I    I
  1138. I 3  I--------+---+-------+--------------+-----+---+---+--X---+---.    I
  1139. I    I        I   I       I              I     I   I   I  I   I        I
  1140. I 5  I--------+---+--X----+--------------+-----.   I   I  I   I        I
  1141. I    I        I   I  I    I              I         I   A  A   I        I
  1142. I 20 I--------+---+--+----+--------------X----.    I   K  K   K        I
  1143. I    I        I   I  I    I                   I    I   I  I   A        I
  1144. I 7  I--------I---X  I    I                   I    I   I  I   I        I
  1145. I    I        I   I  I    I                   I    I   I  I   I        I
  1146. I 10 I---.    I   I  I    I                   I    I   I  I   I        I
  1147. I    I   I    I   I  I    I                   A    I   I  I   I        I
  1148. I 23 I---.    I   I  I    K                   K    I   I  I   I        I
  1149. I    I        I   I  I    A                   I    I   I  I   I        I
  1150. +----+        I   I  K    I                   I    I   I  I   I        I
  1151.               I   I  A    I                   I    I   I  I   I        I
  1152.               I   I  I    I                   I    I   I  I   I        I
  1153. TNC 3         I   I  I    I                   I    I   I  I   I        I
  1154. +----+        I   I  I    I                   I    I   I  I   I        I
  1155. I    I        I   I  I    I                   I    I   I  I   I        I
  1156. I 1  I--------.   I  I    I                   I    I   I  I   I        I
  1157. I    I            I  I    I                   I    I   I  I   I        I
  1158. I 2  I------------+--+----+-------------------+----+---X--.   I        I
  1159. I    I            I  I    I                   I    I          I        I
  1160. I 3  I------------+--+----+-------------------+----+----------X--------.
  1161. I    I            I  I    I                   I    I
  1162. I 5  I------------+--+----+-------------------X---.I
  1163. I    I            I  I    I
  1164. I 20 I------------+--X----.
  1165. I    I            I
  1166. I 7  I------------.
  1167. I    I
  1168. I 10 I---.                                 X = connection
  1169. I    I   I                                 + = cross over
  1170. I 23 I---.                                 A = anode of a 4148 diode
  1171. I    I                                     K = cathode of a 4148 diode
  1172. +----+
  1173.  
  1174.  
  1175. --------------------------------------------------------------------------
  1176. 
  1177.