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