home *** CD-ROM | disk | FTP | other *** search
/ Meeting Pearls 3 / Meeting_Pearls_III.iso / Pearls / tcp / Networking / Sana-II / ax25device.lzh / ax25device / ax25.doc
Text File  |  1995-04-16  |  8KB  |  180 lines
  1. VERSION 1.0Beta-19950416
  2.  
  3. (Note: this readme now includes information about getting AmiTCP ARP
  4.  to publish your "hardware" address.  It should have been here before, and
  5.  my explanation could probably use work, but it should be sufficient for
  6.  you to get this driver working with AmiTCP, or other packages that use
  7.  an ARP type facility).
  8.  
  9.  
  10. This is currently a BETA product.  There are no known enforcer hits during
  11. intended operation.
  12. The driver currently assumes that once started, it will never be stopped
  13. (except by a reboot).  It does not currently shut down gracefully if
  14. told to, or if it fails to start (due to problems with either the config file
  15. or the underlying serial port.)
  16.  
  17. This is a SANA2 device driver that encapsulates a higher-level protocol
  18. (such as TCP/IP) in AX25 UI (unnumbered-information) frames.
  19. AX25 is an amateur (HAM) radio protocol that allows digital communications
  20. via radiowaves.
  21.  
  22. This driver does not currently support direct AX25 activity.
  23.  
  24. This driver has been successfully tested with amitcp-2.2 (special modifications
  25. were made to the 2.2 source to support AX25, this support should be
  26. directly available in the 3.0 AMITCP.) and has interacted successfully with
  27. various versions of the KA9Q NOS.  With some versions of NOS, telnet does
  28. not properly negotiate linemode-with-local-echo.  I do not yet know if this
  29. is a fault of NOS, or telnet (or both).  I have found one version, so far,
  30. of NOS that operates properly in linemode with the amitcp telnet.
  31.  
  32. A note about the TNC:  Your TNC should already be in kiss mode
  33.   and properly configured before starting this driver, the driver will
  34.   not attempt to configure the TNC in any way.  You must set your
  35.   TXDelay and other parameters before hand, and place your TNC in KISS
  36.   mode.  Also the TNC needs to be in hardware flowcontrol mode, and NOT using
  37.   XON/XOFF for flow control.  Most modern TNCs will remember their configuration
  38.   between power ups/downs, including being in KISS mode. (I hope, I haven't
  39.   actually verified this, but in this day and age non-volatile
  40.   configuration memory should be very common.)
  41.   (I personally am currently using the Kantronics dataengine, it remembers
  42.    its configuration, and remains in kiss mode through power cycles.)
  43.   (Also note:  It is not sufficient to only tell your TNC what your callsign
  44.    is, you must also tell this driver, see below.)
  45.  
  46. INSTALLATION:
  47.  
  48. copy the devs/networks/ax25.device to devs:networks/ax25.device
  49. copy the envarc/sana2/ax25.config to envarc:sana2/ax25.config
  50. edit envarc:sana2/ax25.config to suit your needs, instructions are included
  51.      in that file.
  52.  
  53.   NOTE: IT IS *VERY* IMPORTANT that you change the callsign in the config
  54.         file to a callsign you are authorized to use.
  55.  
  56. edit whatever network software you're using to use this driver.
  57. ::: AmiTCP 3.0beta example:
  58. ::: ifconfig axdm1 inet aa0aaa.ampr.org netmask 255.255.255.0
  59.                         ^^^^^^ your callsign here
  60.     (This assumes you have defined your nodename in AmiTCP:db/hosts,
  61.      you can substitute your IP address directly instead if you want.)
  62.  
  63.     depending on local conventions, you may need to change the netmask.
  64. ::: arp -s aa0aaa.ampr.org 82:82:60:82:82:82:60 pub
  65.  
  66.  
  67. The arp line needs some more explaining:  Your network software
  68. may need to be told to publish your "Hardware" address, which is your callsign
  69. for this driver.  If you don't do this you may not be able to talk to
  70. anyone, and they probably won't be able to talk to you.
  71. This information is specific to amitcp, but probably applies
  72. to other network software which uses arp as well.  Your "hardware" address
  73. is specified as 6 hexadecimal numbers, colon separated.  Due to the nature
  74. of AX25 and AmiTCP's ARP, it is necessary to left-shift each byte (the values
  75. between the colons) left one BIT.  In addition, the last byte contains
  76. an SSID, or Secondary Identifier.  Your TNC manual should explain the SSID,
  77. or find a book on amateur packet radio.  It is a value from 0 to 7, if you don't
  78. know what the SSID is, then just use 0.
  79.  
  80. Example:  Your callsign is AB2IJ and you decide to use 3 as your SSID
  81. AB2IJ is 41:42:32:49:4a in hexadecimal.  Use uppercase letters for your callsign.
  82. To convert this into the proper string for arp, we must shift each value 1 bit
  83. left.
  84. The value for 41 in binary is 01000001. Shift it left one: 10000010, convert
  85. it back to hex: 82.  After doing this for each character:
  86. 41:42:32:49:4a   becomes   82:84:64:92:94 (note: instead of shifting left one,
  87. you can multiply by 2, either multiply by two before converting to hex in the
  88. first place, or convert to hex and multiply by 2, but use HEX math.)
  89.  
  90. Now, it must be padded out to six characters, as all ax25 hardware addresses
  91. are six characters in the callsign part.  So, add spaces on the end (space is
  92. hex 20, but becomes 40 after shifting left (doubling).)
  93.  
  94. (***NOTE: I have included a table below so you won't actually need to
  95.           calculate this; don't forget to space pad though if your callsign
  96.           is less than 6 characters, SSID must be the last byte.
  97. ***)
  98.  
  99. 82:84:64:92:94:40
  100.  
  101. Now convert your SSID (3 in this example) to HEX ascii: 33
  102. Shift left one: 66
  103. And append: 82:84:64:92:94:40:66
  104. If you don't know what SSID to use, just use 0, which
  105. will be :60, 82:84:64:92:94:40:60
  106.  
  107. So, the arp command for AmiTCP and a Callsign of ab2ij-3 (the -3 is the SSID)
  108. is:
  109.  
  110. arp -s AB2IJ.AMPR.ORG 82:84:64:92:94:40:60 pub
  111.  
  112. This will work if you have specified your IP address for AB2IJ.AMPR.ORG in
  113. your AmiTCP:db/hosts file, or you can just put your IP address directly:
  114.  
  115. arp -s 44.x.y.z 82:84:64:92:94:40:60 pub
  116.  
  117. Where 44.x.y.z is whatever your IP address is.
  118.  
  119.  
  120. Here is a reference table to simplify this process, so you won't have to
  121. calculate it:
  122.  
  123. SPACE:40
  124. A:82   B:84   C:86   D:88   E:8A   F:8C   G:8E   H:90
  125. I:92   J:94   K:96   L:98   M:9A   N:9C   O:9E   P:A0
  126. Q:A2   R:A4   S:A6   T:A8   U:AA:  V:AC   W:AE   X:B0
  127. Y:B2   Z:B4
  128.  
  129. 0:60   1:62   2:64   3:66   4:68   5:6A   6:6C   7:6E
  130. 8:70   9:72
  131.  
  132.  
  133. Donations of money or other items are accepted and appreciated, but are
  134. not required.  Please make sure monetary donations are in U.S. funds, or can
  135. be converted to such without costing more than the value of the donation.
  136. (exception, if you want to send me actual money of some form, I collect it,
  137.  but apparently money tends to disappear in various postal systems.)
  138. I will attempt to place updated versions on AmiNET sites and/or with the
  139. AmiTCP distribution and possibly via other routes as well (such as Fred Fish).
  140.  
  141. At least please send me a note (mail or EMAIL) with your comments and
  142. suggestions about this driver, or at least let me know your using it.
  143.  
  144. ***
  145. You should let me know especially if you are having a problem, as I can't
  146. fix what I don't know about.
  147. ***
  148.  
  149. martind@hillwpos.hill.af.mil
  150. dave@cs.weber.edu
  151.  
  152. Dave Martin
  153. 843 Clover Circle
  154. Ogden, Utah  84404
  155. USA
  156.  
  157. This driver is Copyright 1994,1995 by David E Martin KB7VBD, it may be distributed
  158. without profit.  Organizations such as magazines or shareware collections
  159. or other people that are involved commercially should contact me first.
  160. Permission for appearance in the Fred Fish collection (disk or CDROM) is
  161. hereby granted.  Permission for appearance in the aminet CDROM is hereby
  162. granted.  Permission for other CDROM collections is granted if they are
  163. comparably priced to other shareware type CDROMs from other manufacturers.
  164. The Author reserves the right to change these terms in future
  165. versions of this driver.  I would appreciate at least one edition of a
  166. cdrom of a given collection that contains this package.
  167.  
  168. HISTORY:
  169. V1.0Beta-19940320    First external release.
  170. V1.0Beta-1994????       Minor memory problem fix.
  171. V1.0Beta-19940704    Documentation fixes and some debugging kprintfs removed.
  172.                         Documentation revised on 19940714
  173. V1.0Beta-19941224    Occasional lockup bug hopefully exterminated.
  174.             Documentation revisions and CDROM distribution rights
  175.             updated.
  176. V1.0Beta-19950416    Major memory overwrite problem fixed.
  177.  
  178. ---------------------------------------------------------------------------
  179. See ax25.config for additional info
  180.