home *** CD-ROM | disk | FTP | other *** search
/ HAM Radio 1 / HamRadio.cdr / misc / thenet_d / thenet.man < prev   
Text File  |  1988-11-01  |  9KB  |  242 lines
  1.  
  2. By popular request, here is the early documentation on TheNet program.  The
  3. Binary file will be uploaded to local BBSs and the remarked code in "C" and
  4. Assembly language will be promulgated when received.   As one can see, it is
  5. truly a new and innovative program with many new features.
  6.  
  7.  
  8. NORD><LINK The northern german packet group
  9.  
  10.  
  11. TheNet Version 1.0                07-04-88
  12.  
  13. TheNet is fully compatible to NET/ROM (*) version 1.3. The following descrip-
  14. tion contains only the changes for users and sysops.
  15.  
  16.  
  17. Userinterface
  18. =============
  19.  
  20. The command "IDENT" has been replaced by a new command "INFO".
  21. The digipeater will send:
  22.      1. it's mnemonic identifier and the call
  23.      2. a message contained in the EPROM
  24.      3. a remote programable message
  25.  
  26. Example:
  27.  
  28. BS:DB0FC> NORD><LINK
  29. Braunschweig <JO55GH>
  30. 5W, GP, 144.675 MHz
  31. OP: DF2AU @DK0MAV
  32.  
  33. APR-01: meeting of all packeteers
  34.  
  35.  
  36. All system messages contain no characters with special national meaning (e.g.
  37. 7e HEX).
  38.  
  39.  
  40. Sysop interface:
  41. ================
  42.  
  43. All sysop commands will only work after a successfull execution of "SYSOP".
  44.  
  45. changed commands:
  46. -----------------
  47.  
  48. 1. INFO  (former IDENT)
  49. Store a message of up to 80 characters. Longer input will be truncated.
  50. Minimum length is 1 character. To clear the message you have to input a new
  51. message. A period is sufficient. Only after a coldstart this message will be
  52. cleared. So a power failure is easily detectible.
  53.  
  54. 2. RESET
  55. RESET will do a coldstart. The whole RAM is initialized. All parameters are
  56. taken from EPROM. The INFO message is cleared. The password is taken from
  57. EPROM.
  58. Unlike with NET/ROM there is no argument necessary.
  59.  
  60.  
  61. new commands
  62. ------------
  63.  
  64. 1. HIGH portnumber
  65. Output portnumber is activated (relais engaged, LED on).
  66. Portnumber = 0 activates the CONNECT-LED output, portnumber = 1 the STATUS-
  67. LED output.
  68.  
  69. 2. LOW portnumber
  70. Output portnumber is deactivated (relais disengaged, LED off).
  71. Portnumber = 0 desactivates the CONNECT-LED output, portnumber = 1 the
  72. STATUS-LED output.
  73.  
  74.  
  75. other changes:
  76. -------------
  77.  
  78. 1. TheNet is capable of fullduplex activity. The commands may only be given on
  79. the host terminal. With <ESC> F 0 you switch to halfduplex and with <ESC> F 1
  80. you switch to fullduplex. By a constant in EPROM you decide to send flags
  81. while there is no activity on the transmitter or keep the transmitter quiet.
  82.  
  83. 2. All default parameters are contained in a list at the beginning of the
  84. EPROM. This includes call and mnemonic identifier of the digipeater as well as
  85. the default password. So remote access is possible even after a total power
  86. failure.
  87.  
  88.  
  89.  
  90. If you have further questions or any other comments, feel free to contact
  91.  
  92. NORD><LINK
  93. c/o Hans Georg Giese
  94. DF2AU
  95. Hinter dem Berge 5
  96. 3300 Braunschweig
  97. FRG
  98.  
  99. -----
  100. * NET/ROM is a registered trademark of Software 2000 Inc.
  101.  
  102.  
  103.  
  104. +---------------------------------------------------------------------+
  105. ö                                                                     ö
  106. ö Default-parameters. Starting at EPROM address 3B-HEX                 ö
  107. ö                                                                     ö
  108. +---------------------------------------------------------------------+
  109.  
  110. 003B   'NO1DE ', 60h; Call of the TNC, SSID shifted left one position
  111. 0042   'THENET'     ; Mnemonic identifier of the TNC
  112. 0048   50           ; Length of destination list ÄnodesÅ
  113. 004A   1            ; minimum quality for autoupdate
  114. 004C   100          ; HDLC channel quality
  115. 004E   255          ; RS232 channel quality
  116. 0050   6            ; initial node lifetime ÄbroadcastintervalsÅ
  117. 0052   5            ; mimimum lifetime for broadcast ÄbroadcastintervalsÅ
  118. 0054   1800         ; Broadcastinterval ÄsecondsÅ
  119. 0056   10           ; time-to-live initializer
  120. 0058   300          ; Level3 timeout ÄsecondsÅ
  121. 005A   2            ; Level3 retries
  122. 005C   6            ; Level3 acknowledge delay ÄsecondsÅ
  123. 005E   180          ; Level3 busy delay ÄsecondsÅ
  124. 0060   4            ; Level3 windowsize
  125. 0062   4            ; number of buffered frames per connection
  126. 0064   900          ; no-activity-timeout ÄsecondsÅ
  127. 0066   64           ; persistance
  128. 0068   10           ; timeslot size ÄmillisecondsÅ
  129. 006A   5            ; Level2, Timer1 ÄsecondsÅ
  130. 006C   2            ; Level2, windowsize
  131. 006E   10           ; Level2, retries
  132. 0070   100          ; Level2, Timer2 ÄsecondsÅ
  133. 0072   18000        ; Level2, Timer3 ÄsecondsÅ
  134. 0074   0            ; Level2 digipeating. 1 = enabled, 0 = disabled
  135. 0076   1            ; validate calls. 1 = yes, 0 = no
  136. 0078   2            ; Beaconmode. 0 = no beacon, 1 = after traffic, 2 = always
  137. 007A   1            ; CQ-calling enable. 1 = yes, 0 = no
  138. 007C   0            ; Full-Duplex. 1 = yes, 0 = no
  139. 007D   0            ; send flags if no data needed. 1 = yes, 0 = no
  140. 007E   01Bh         ; Command lead-in character (Host)
  141. 007F   30           ; Transmitterdelay Ä* 10 millisecondsÅ
  142.  
  143. 0080   'ABCDEFGHIJKLMNOPQRSTUVWXYZ 0123456789   '
  144.        'ABCDEFGHIJKLMNOPQRSTUVWXYZ 0123456789   ',0   ; Password
  145.                     ; 0 terminated, maximum length 80 characters
  146.  
  147. 00D1   'SOFTWARE VON NORD><LINK  -  SOFTWARE VON'
  148.        ' NORD><LINK  -  SOFTWARE VON NORD><LINK ',0   ; Infomessage
  149.                     ; 0 terminated, maximum length 80 characters
  150.                     ; CR = 0D-HEX will be a CR-LF on the user screen
  151. 0121   00           ; definitely the last byte to patch!
  152.  
  153.  
  154. TheNet, version 1.0, 12-APR-88, DF2AU
  155.  
  156.  
  157. Notes from K3AKK:
  158.  
  159.  
  160. To spare you the chore of converting bytes to display the SSID (left one bit
  161. and OR with 60Hex), the values for byte 0041 are:
  162. Basic callsign  60 Hex
  163. SSID of 1       62
  164.         2       64
  165.         3       66
  166.         4       68
  167.         5       6A
  168.         6       6C
  169.         7       6E
  170.         8       70
  171.         9       72
  172. Starting at byte 003B, there are six places for the callsign (e.g. WA6ABC)
  173. use trailing Hex 20s to fill unused bytes for shorter callsigns.
  174.  
  175. Starting at byte 0042 there are six spaces for a mnemonic ID.  Use trailing
  176. Hex 20s to fill unused bytes for shorter IDs.
  177.  
  178. Starting at byte 0080 there are 80 spaces for a default pass phrase.  (A new
  179. one can be uploaded by the host).  Use Hex 20s to fill unused spaces and
  180. byte 00D0 must be Hex 00 to terminate.
  181.  
  182. Starting at byte 00D1 there are 80 spaces for a hardcoded message.  (An
  183. additional 80 character message can be uploaded by the SYSOP using the Info
  184. command).  Use trailing Hex 20s to fill unused spaces and byte 0021 must be
  185. Hex 00 to terminate.  A Hex 0D will be a CR/LF on the users screen.
  186.  
  187. In the parameter list, the normally used value for length of destination
  188. nodelist is 100, the minumum quality for auto-update is 100 and the HDLC
  189. channel quality is 192.  All others are normally used values.
  190.  
  191. When displaying the routing for a particular node, the following notation is
  192. used.  > indicates a route in use.  The first number is the route quality,
  193. next is the obsolescence count (0=locked route) and the last number is the
  194. port 0=HDLC 1=RS232.  Next is the neighboring node.  An entry might look
  195. like this:
  196.  
  197. NODES ABC
  198. DEF:W1XXX) Routes to ABC:W1YYY
  199. >192 6 0 W1YYY
  200.  110 4 1 W1XXX-5
  201.  0  4  0 W1XXX-4     .......this is known as a "trivial" route and is not
  202.                             useable.
  203.  
  204. The information displayed by the NODES command can be edited by the sysop.
  205. The comands are:
  206. NODES nodecall + ident quality count port neighbor
  207.             e.g. Nodes W1AAA + DEF 192 6 0 W1AAA     (to add)
  208. NODES nodecall - ident quality count port neighbor
  209.             e.g. Nodes W1AAA - DEF 192 6 0 W1AAA     (to remove)
  210.  
  211. The information displayed by the ROUTES command  can also be edited and a
  212. route "locked" to a specific value by the sysop.
  213. The commands are:
  214. ROUTES port nodecall + pathquality
  215. ROUTES port nodecall - pathquality
  216.              e.g.  Nodes 0 W1AAA + 188
  217.              (this will place an ! after the pathquality denoting
  218.              a locked route.
  219.              Locking a route at a lower or higher quality can provide
  220.              precedence of selection when several routes are available
  221.              and the node is doing autorouting.
  222.  
  223. Remote operations available to the sysop:  parameters, 80 character message,
  224. route and node editing & locking, control of toggles on the STA and CON
  225. lights (locally modified to relay switching) and a true hard RAM reset,
  226. reinitializing the RAM to default parameters.
  227.  
  228. When connected thru the RS-232 port, the sysop is connected as host.  The
  229. commands are ESC C = connect, ESC P to change the password, ESC T to change
  230. the TX Delay, P to set the parameters, ESC D to disconnect and finally,
  231. ESC Y 0 to reset the RS232 port.
  232.  
  233. A letter from the program's authors, DF2AU and DC4OX advise that the
  234. annotated source code (written in "C" and Assembly) will be available
  235. in a few weeks (from 23 April).  The code is commented in "Germish" and
  236. needs some translation!  Both the binary and the commented code are in the
  237. public domain.  The authors will welcome modificatons and will incorporate
  238. worthy ones in future releases.  The detailed instructions for the mechanics
  239. of making modifications and suggestions will be included with the commented
  240. code.
  241.  
  242.