home *** CD-ROM | disk | FTP | other *** search
/ CP/M / CPM_CDROM.iso / mbug / mbug156.arc / X25.LBR / AX25RPTR.DQC / AX25RPTR.DOC
Text File  |  1979-12-31  |  7KB  |  153 lines
  1.  
  2. DOC FILE LAST UPDATED MARCH 15, 1983
  3.  
  4. THIS FILE IS SOME SCANTY DOCUMENTATION FOR THE LEVEL 2 AX.25
  5. REPEATER, ORIGINALLY WRITTEN BY JON BLOOM, KE3Z.  THE REPEATER
  6. HAS BEEN MODIFIED BY TERRY FOX, WB4JFI TO BE AX.25 COMPATIBLE.
  7. THE SOFTWARE IS SLIGHTLY INELEGANT (KLUDGED), AND WHEN WE HAVE
  8. TIME IT WILL BE UPDATED (ESPECIALLY THE MOVING OF THE ID FRAMES
  9. TO THE BUFFER AREA BEFORE SENDING THEM).
  10.  
  11.     BECAUSE OF THE ADDITIONS TO MAKE IT AX.25 COMPATIBLE,
  12. THE REPEATER NOW IS SLIGHTLY LARGER THAN 1K.  WHEN THE MOVING
  13. ROUTINE IS ELIMINATED, THE REPEATER SHOULD AGAIN FIT IN ONE 2708
  14. EPROM.  KEEP IN TOUCH WITH AMRAD FOR NEWS ON THE NEW VERSION
  15. OF THE REPEATER.
  16.  
  17.     THERE ARE TWO BASIC AREAS IN THE REPEATER CODE THAT MUST
  18. BE CHANGED FOR VARIOUS VERSIONS OF THE REPEATER.
  19.  
  20.     THE FIRST AREA IS IMMEDIATELY FOLLOWING THE MOD. LOG.
  21. IT CONTAINS SOME OF THE VARIABLES THAT PERTAIN TO TIMING
  22. REQUIREMENTS OF THE REPEATER.
  23.  
  24.     DELAY IS USED IF ADDITIONAL DELAY IS NEEDED WHEN GOING
  25. FROM RECEIVE TO TRANSMIT, SUCH AS FOR RELAY TYPE RIGS.
  26.  
  27.     CBDLY IS A DELAY OPTIONALLY USED TO WAIT A SHORT TIME
  28. AFTER RECEIVING TO MAKE SURE SOMEONE ELSE DOESNT GRAB THE
  29. CHANNEL.  IT IS NORMALLY SET TO TRUE.
  30.  
  31.     NORMAL IS USED TO SHOW WHERE THE TNC RAM IS LOCATED.
  32. IF NORMAL IS TRUE, THE TNC RAM IS LOCATED AT THE STANDARD
  33. LOCATION (1000-1FFF HEX).  IF NORMAL IS FALSE, RAM IS ASSUMED
  34. TO BE AT 8000-8FFF HEX.
  35.  
  36.     SEPRFC IS USED TO TELL IF A SEPERATE MODEM AND RF CARRIER
  37. DETECT ARE TO BE USED.  IF RF CARRIER IS USED IN ADDITION TO
  38. MODEM CD, RF CARRIER DETECT SHOULD COME IN ON THE DSR PIN OF THE
  39. LINK SIDE DB-25.  SEPERATE RF CARRIER DETECT IS USEFUL (NEEDED) IF
  40. THE REPEATER IS TO BE USED ON TOP OF A VOICE REPEATER TO PREVENT
  41. THE REPEATER FROM TRANSMITTING THE CW AND FRAME ID WHEN VOICERS
  42. ARE ON THE REPEATER.  THE MODEM CARRIER DETECT IS STILL USED
  43. TO DETECT WHEN IT IS OK TO REPEAT RECEIVED FRAMES.
  44.  
  45.     ADJBD IS USED ONLY ON MODIFIED TNC BOARDS THAT HAVE THE
  46. BAUD RATE OF THE LINK SELECTABLE BY SOFTWARE PER A MOD OF MINE
  47. IN AN AMRAD NEWSLETTER.  IT IS GENERALLY SET FALSE.
  48.  
  49.     DLYVAL IS THE AMOUNT USED IN THE TRANSMIT DELAY ROUTINE.
  50. IT IS NORMALLY SET TO ABOUT 2000 HEX.
  51.  
  52.     CBDLYV IS THE VALUE USED BY THE CBDLY ROUTINE TO WAIT
  53. BETWEEN RECEIVE AND TRANSMIT.  NORMAL VALUE IS 1500 HEX.
  54.  
  55.     BUFSIZ IS THE MAXIMUM RECEIVED BYTE LENGTH.  IT
  56. INCLUDES THE ADDRESS AND CONTROL FIELDS.  THE MAXIMUM AMOUNT
  57. INCLUDES 21 BYTES OF ADDRESS FIELD, ONE BYTE OF CONTROL DATA,
  58. A PID BYTE, AND 255 BYTES OF USER DATA, WHICH ADDS UP TO 279
  59. BYTES TOTAL.
  60.  
  61.     MAXPKT IS THE MAXIMUM PACKETS ALLOWED TO BE RECEIVED BEFORE
  62. THE REPEATER SHOULD TRANSMIT THE FRAMES.  IT IS NORMALLY 8.
  63.  
  64.  
  65.     THE OTHER AREA THAT SHOULD BE CHANGED IS TOWARD THE END
  66. OF THE FILE.  IT CONTAINS THE ADDRESS INFORMATION FOR THE REPEATER
  67. AND THE CW AND FRAME ID INFORMATION.
  68.  
  69.     THE FIRST LOCATION IS IDNUM.  IT IS USED TO SET THE SPEED
  70. OF THE CW ID INFORMATION.  IT IS PRESENTLY SET TO 1200 BAUD, AND
  71. NEEDS TO BE CHANGED ONLY IF THE LINK SPEED IS OTHER THAN 1200 BD.
  72.  
  73.     THE NEXT LOCATION TO BE CHANGED IS RPTADR.  THIS CONTAINS
  74. ADDRESS OF THIS REPEATER, AND AS SUCH IT MUST CONTAIN THE EXACT!!
  75. MATCH OF THE REPEATER ADDRESS IN THE REPEATER ADDRESS FIELD.  THE
  76. ONLY EXCEPTION TO THIS IS IF A REPEATER ADDRESS MATCHES EXCEPT FOR
  77. THE SSID, AND IF THE SSID IS SET TO ALL ONES, INDICATING THAT ANY
  78. REPEATER WITH THE CORRECT AMATEUR CALL SHOULD REPEAT THE FRAME.
  79. THE ADDRESS LOCATED HERE SHOULD BE A SHIFTED VERSION OF THE CALLSIGN.
  80. AS AN EXAMPLE, USE THE WB4JFI1 SHOWN IN THE ORIGINAL VERSION.
  81.  
  82. NORMALLY, A WB4JFI1 IN HEX ASCII WOULD LOOK LIKE THE FOLLOWING:
  83.  
  84. W=57  B=42  4=34  J=4A  F=46  I=49  1=31
  85.  
  86.                THE W IN BINARY IS 01010111 OR 57 HEX.
  87. AFTER SHIFTING ONCE, THE W IS NOW 10101110, OR AE HEX.
  88.  
  89.          THE B IN BINARY ASCII IS 01000010 OR 42 HEX
  90. AFTER SHIFTING ONCE, THE B IS NOW 10000100, OR 84 HEX.
  91.  
  92. THIS CONTINUES UNTIL THE LAST (SSID) BYTE.  IT IS AS FOLLOWS:
  93.   7 6 5 4 3 2 1 0
  94.   H R R(S S I D)1
  95.  
  96. WHERE, BIT 7 IS THE HAS-BEEN-REPEATED BIT.  IT IS SET TO ZERO BY
  97. THE ORIGINATING STATION, AND SET TO ONE BY THE REPEATER.  AS SUCH,
  98. IT SHOULD BE SET TO ZERO IN THE RPTADR LOCATION.
  99.  
  100. BITS 6 AND 5 ARE RESERVED AND SET TO ONE IN NORMAL OPERATION.  THE
  101. PRESENT REPEATER CONFIGURATION LOOKS FOR ONES IN THIS FIELD.
  102.  
  103. BITS 4, 3, 2, AND 1 ARE THE SSID.  THEY ARE USED TO ALLOW AN
  104. AMATEUR TO HAVE MORE THAN ONE PACKET RADIO STATION.  AS AN
  105. EXAMPLE, THE ENCODED RPTADR HERE IS WB4JFI1, AS OPPOSED TO
  106. WB4JFI0, WHICH IS MY NORMAL STATION.  BIT 1 IS LSB, 4 IS MSB.
  107. AN EXCEPTION TO THIS IS MENTIOND ABOVE.  IF THE SSID IS SET TO
  108. ALL ONES, ANY REPEATER WHERE THE REST OF THE CALL HAS MATCHED
  109. SHOULD REPEAT THE FRAME.  THIS IS TAKEN CARE OF INTERNALLY, NOT
  110. IN RPTADR.
  111.  
  112. BIT 0 IS THE HDLC EXTENDER BIT.  IT IS SET TO ZERO ON ALL BUT
  113. THE LAST OCTET.  SINCE THE SSID OCTET IN THE REPEATER ADDRESS
  114. IS THE LAST OCTET OF THE ADDRESS FIELD, IT SHOULD BE SET TO ONE.
  115.  
  116.  
  117. NOW FOLLOWS THE ADDRESS FIELD OF THE BEACON (ID) FRAMES.  IT IS
  118. LOCATED IN ADRBCN, AND HOLDS THE THREE ADDRESS FIELDS USED IN THE
  119. REPEATER ID FRAMES.  THE DESTINATION FIELD PRESENTLY HOLDS
  120. "RPTRID0", WHICH I USED TO INDICATE THIS IS A REPEATER ID FRAME.
  121. THE NEXT TWO FIELDS HOLD THE DESTINATION AND REPEATER ADDRESSES
  122. OF THE REPEATER, WHICH ARE THE SAME IN THIS CASE.
  123.  
  124. THE LAST AREA IS THE ACTUAL DATA PUT INTO THE INFORMATION FIELD
  125. OF THE ID FRAMES.  IT SHOULD HAVE AT LEAST THE CALLSIGN, WITH THE
  126. CORRECT SSID, OF THE REPEATER.  THIS WAY ANYONE TUNING IN CAN TELL
  127. WHAT REPEATERS ARE AVAILABLE FOR USE.
  128.  
  129. THE LAST AREA IS IDSTR, WHICH HOLDS THE CW ID STRING.  IT FOLLOWS THE
  130. NORMAL VANCOUVER STYLE CW ID ENCODING, WHERE A DIT IS SIGNIFIED BY ONE
  131. BIT BEING SET TO ONE, A DAH HAS THREE SEQUENTIAL BITS SET TO ONE, AN
  132. INTRA-LETTER SPACE IS ONE ZERO, THE SPACE BETWEEN LETTERS IS THREE
  133. ONES.  AS AN EXAMPLE A W IN CW IS DIT-DAH-DAH. THIS MAY START WITH
  134. THE DIT BEING A ONE, ONE ZERO FOR END OF THE DIT, THREE ONES FOR THE
  135. FIRST DAH, ONE ZERO FOR THE SPACE BETWEEN THE DAHS, AND THREE MORE
  136. ONES FOR THE SECOND DAH.  NEXT SHOULD COME THREE ZEROS FOR THE SPACE
  137. BETWEEN THE W AND THE NEXT LETTER.  THIS SHOULD END UP AS:
  138.  
  139. 1 0 1 1 1 0 1 1 1 0 0 0 
  140. D     D       D
  141. I     A       A
  142. T     H       H
  143.  
  144. OR BB HEX, C? HEX
  145.  
  146.  
  147.     THAT IS THE END OF THE DOCUMENTATION SO FAR.  AS YOU FIND
  148. QUESTIONS OR WANT MORE INFORMATION, PLEASE CONTACT AMRAD AT:
  149.     AMRAD, PO DRAWER 6128, MCLEAN VA.  22106
  150.  
  151. END OF AX.25 REPEATER DOCUMENTATION FILE.  TERRY FOX
  152.  
  153.