616 lines
8.1 KiB
HTML
616 lines
8.1 KiB
HTML
<HTML
|
|
><HEAD
|
|
><TITLE
|
|
>Linux Amateur Radio AX.25 HOWTO</TITLE
|
|
><META
|
|
NAME="GENERATOR"
|
|
CONTENT="Modular DocBook HTML Stylesheet Version 1.63
|
|
"><LINK
|
|
REL="NEXT"
|
|
TITLE="Introduction"
|
|
HREF="x13.html"></HEAD
|
|
><BODY
|
|
CLASS="ARTICLE"
|
|
BGCOLOR="#FFFFFF"
|
|
TEXT="#000000"
|
|
LINK="#0000FF"
|
|
VLINK="#840084"
|
|
ALINK="#0000FF"
|
|
><DIV
|
|
CLASS="ARTICLE"
|
|
><DIV
|
|
CLASS="TITLEPAGE"
|
|
><H1
|
|
CLASS="TITLE"
|
|
><A
|
|
NAME="AEN2"
|
|
>Linux Amateur Radio AX.25 HOWTO</A
|
|
></H1
|
|
><H3
|
|
CLASS="AUTHOR"
|
|
><A
|
|
NAME="AEN4"
|
|
>Jeff Tranter, VE3ICH</A
|
|
></H3
|
|
><DIV
|
|
CLASS="AFFILIATION"
|
|
><DIV
|
|
CLASS="ADDRESS"
|
|
><P
|
|
CLASS="ADDRESS"
|
|
>tranter@pobox.com</P
|
|
></DIV
|
|
></DIV
|
|
><P
|
|
CLASS="PUBDATE"
|
|
>v2.0, 19 September 2001<BR></P
|
|
><DIV
|
|
><DIV
|
|
CLASS="ABSTRACT"
|
|
><A
|
|
NAME="AEN11"
|
|
></A
|
|
><P
|
|
></P
|
|
><P
|
|
>The Linux operating system is perhaps the only operating system in the
|
|
world that can boast native and standard support for the AX.25 packet
|
|
radio protocol utilized by Amateur Radio operators worldwide. This
|
|
document describes how to install and configure this support.</P
|
|
><P
|
|
></P
|
|
></DIV
|
|
></DIV
|
|
><HR></DIV
|
|
><DIV
|
|
CLASS="TOC"
|
|
><DL
|
|
><DT
|
|
><B
|
|
>Table of Contents</B
|
|
></DT
|
|
><DT
|
|
>1. <A
|
|
HREF="x13.html"
|
|
>Introduction</A
|
|
></DT
|
|
><DD
|
|
><DL
|
|
><DT
|
|
>1.1. <A
|
|
HREF="x13.html#AEN18"
|
|
>Changes from the previous version</A
|
|
></DT
|
|
><DT
|
|
>1.2. <A
|
|
HREF="x13.html#AEN33"
|
|
>Where to obtain new versions of this document</A
|
|
></DT
|
|
><DT
|
|
>1.3. <A
|
|
HREF="x13.html#AEN39"
|
|
>Other related documentation</A
|
|
></DT
|
|
></DL
|
|
></DD
|
|
><DT
|
|
>2. <A
|
|
HREF="x61.html"
|
|
>The Packet Radio Protocols and Linux</A
|
|
></DT
|
|
><DD
|
|
><DL
|
|
><DT
|
|
>2.1. <A
|
|
HREF="x61.html#AEN78"
|
|
>How it all fits together</A
|
|
></DT
|
|
></DL
|
|
></DD
|
|
><DT
|
|
>3. <A
|
|
HREF="x94.html"
|
|
>The AX.25/NET/ROM/ROSE software components</A
|
|
></DT
|
|
><DD
|
|
><DL
|
|
><DT
|
|
>3.1. <A
|
|
HREF="x94.html#AEN100"
|
|
>Finding the kernel, tools and utility packages</A
|
|
></DT
|
|
></DL
|
|
></DD
|
|
><DT
|
|
>4. <A
|
|
HREF="x144.html"
|
|
>Installing the AX.25/NET/ROM/ROSE software</A
|
|
></DT
|
|
><DD
|
|
><DL
|
|
><DT
|
|
>4.1. <A
|
|
HREF="x144.html#AEN151"
|
|
>Compiling the kernel</A
|
|
></DT
|
|
><DT
|
|
>4.2. <A
|
|
HREF="x144.html#AEN200"
|
|
>The AX.25 library, tools, and application programs</A
|
|
></DT
|
|
></DL
|
|
></DD
|
|
><DT
|
|
>5. <A
|
|
HREF="x235.html"
|
|
>A note on callsigns, addresses and things before we start</A
|
|
></DT
|
|
><DD
|
|
><DL
|
|
><DT
|
|
>5.1. <A
|
|
HREF="x235.html#AEN258"
|
|
>What are all those T1, T2, N2 and things ?</A
|
|
></DT
|
|
><DT
|
|
>5.2. <A
|
|
HREF="x235.html#AEN294"
|
|
>Run time configurable parameters</A
|
|
></DT
|
|
></DL
|
|
></DD
|
|
><DT
|
|
>6. <A
|
|
HREF="x495.html"
|
|
>Configuring an AX.25 port</A
|
|
></DT
|
|
><DD
|
|
><DL
|
|
><DT
|
|
>6.1. <A
|
|
HREF="x495.html#AEN499"
|
|
>Creating the AX.25 network device</A
|
|
></DT
|
|
><DT
|
|
>6.2. <A
|
|
HREF="x495.html#AEN1143"
|
|
>Creating the <TT
|
|
CLASS="LITERAL"
|
|
>/etc/ax25/axports</TT
|
|
> file</A
|
|
></DT
|
|
><DT
|
|
>6.3. <A
|
|
HREF="x495.html#AEN1183"
|
|
>Configuring AX.25 routing</A
|
|
></DT
|
|
></DL
|
|
></DD
|
|
><DT
|
|
>7. <A
|
|
HREF="x1194.html"
|
|
>Configuring an AX.25 interface for TCP/IP</A
|
|
></DT
|
|
><DT
|
|
>8. <A
|
|
HREF="x1218.html"
|
|
>Configuring a NET/ROM port</A
|
|
></DT
|
|
><DD
|
|
><DL
|
|
><DT
|
|
>8.1. <A
|
|
HREF="x1218.html#AEN1221"
|
|
>Configuring <TT
|
|
CLASS="LITERAL"
|
|
>/etc/ax25/nrports</TT
|
|
></A
|
|
></DT
|
|
><DT
|
|
>8.2. <A
|
|
HREF="x1218.html#AEN1264"
|
|
>Configuring <TT
|
|
CLASS="LITERAL"
|
|
>/etc/ax25/nrbroadcast</TT
|
|
></A
|
|
></DT
|
|
><DT
|
|
>8.3. <A
|
|
HREF="x1218.html#AEN1299"
|
|
>Creating the NET/ROM Network device</A
|
|
></DT
|
|
><DT
|
|
>8.4. <A
|
|
HREF="x1218.html#AEN1315"
|
|
>Starting the NET/ROM daemon</A
|
|
></DT
|
|
><DT
|
|
>8.5. <A
|
|
HREF="x1218.html#AEN1325"
|
|
>Configuring NET/ROM routing.</A
|
|
></DT
|
|
></DL
|
|
></DD
|
|
><DT
|
|
>9. <A
|
|
HREF="x1343.html"
|
|
>Configuring a NET/ROM interface for TCP/IP</A
|
|
></DT
|
|
><DT
|
|
>10. <A
|
|
HREF="x1374.html"
|
|
>Configuring a ROSE port</A
|
|
></DT
|
|
><DD
|
|
><DL
|
|
><DT
|
|
>10.1. <A
|
|
HREF="x1374.html#AEN1380"
|
|
>Configuring <TT
|
|
CLASS="LITERAL"
|
|
>/etc/ax25/rsports</TT
|
|
></A
|
|
></DT
|
|
><DT
|
|
>10.2. <A
|
|
HREF="x1374.html#AEN1413"
|
|
>Creating the ROSE Network device</A
|
|
></DT
|
|
><DT
|
|
>10.3. <A
|
|
HREF="x1374.html#AEN1429"
|
|
>Configuring ROSE Routing</A
|
|
></DT
|
|
></DL
|
|
></DD
|
|
><DT
|
|
>11. <A
|
|
HREF="x1449.html"
|
|
>Making AX.25/NET/ROM/ROSE calls</A
|
|
></DT
|
|
><DT
|
|
>12. <A
|
|
HREF="x1474.html"
|
|
>Configuring Linux to accept Packet connections</A
|
|
></DT
|
|
><DD
|
|
><DL
|
|
><DT
|
|
>12.1. <A
|
|
HREF="x1474.html#AEN1482"
|
|
>Creating the <TT
|
|
CLASS="LITERAL"
|
|
>/etc/ax25/ax25d.conf</TT
|
|
> file</A
|
|
></DT
|
|
><DT
|
|
>12.2. <A
|
|
HREF="x1474.html#AEN1644"
|
|
>A simple example <TT
|
|
CLASS="LITERAL"
|
|
>ax25d.conf</TT
|
|
> file</A
|
|
></DT
|
|
><DT
|
|
>12.3. <A
|
|
HREF="x1474.html#AEN1678"
|
|
>Starting <EM
|
|
>ax25d</EM
|
|
></A
|
|
></DT
|
|
></DL
|
|
></DD
|
|
><DT
|
|
>13. <A
|
|
HREF="x1688.html"
|
|
>Configuring the <EM
|
|
>node</EM
|
|
> software</A
|
|
></DT
|
|
><DD
|
|
><DL
|
|
><DT
|
|
>13.1. <A
|
|
HREF="x1688.html#AEN1697"
|
|
>Creating the <TT
|
|
CLASS="LITERAL"
|
|
>/etc/ax25/node.conf</TT
|
|
> file</A
|
|
></DT
|
|
><DT
|
|
>13.2. <A
|
|
HREF="x1688.html#AEN1704"
|
|
>Creating the <TT
|
|
CLASS="LITERAL"
|
|
>/etc/ax25/node.perms</TT
|
|
> file</A
|
|
></DT
|
|
><DT
|
|
>13.3. <A
|
|
HREF="x1688.html#AEN1800"
|
|
>Configuring <EM
|
|
>node</EM
|
|
> to run from <EM
|
|
>ax25d</EM
|
|
></A
|
|
></DT
|
|
><DT
|
|
>13.4. <A
|
|
HREF="x1688.html#AEN1820"
|
|
>Configuring <EM
|
|
>node</EM
|
|
> to run from <EM
|
|
>inetd</EM
|
|
></A
|
|
></DT
|
|
></DL
|
|
></DD
|
|
><DT
|
|
>14. <A
|
|
HREF="x1839.html"
|
|
>Configuring <EM
|
|
>axspawn</EM
|
|
></A
|
|
></DT
|
|
><DD
|
|
><DL
|
|
><DT
|
|
>14.1. <A
|
|
HREF="x1839.html#AEN1858"
|
|
>Creating the <TT
|
|
CLASS="LITERAL"
|
|
>/etc/ax25/axspawn.conf</TT
|
|
> file</A
|
|
></DT
|
|
></DL
|
|
></DD
|
|
><DT
|
|
>15. <A
|
|
HREF="x1914.html"
|
|
>Configuring the <EM
|
|
>pms</EM
|
|
></A
|
|
></DT
|
|
><DD
|
|
><DL
|
|
><DT
|
|
>15.1. <A
|
|
HREF="x1914.html#AEN1922"
|
|
>Create the <TT
|
|
CLASS="LITERAL"
|
|
>/etc/ax25/pms.motd</TT
|
|
> file</A
|
|
></DT
|
|
><DT
|
|
>15.2. <A
|
|
HREF="x1914.html#AEN1927"
|
|
>Create the <TT
|
|
CLASS="LITERAL"
|
|
>/etc/ax25/pms.info</TT
|
|
> file</A
|
|
></DT
|
|
><DT
|
|
>15.3. <A
|
|
HREF="x1914.html#AEN1934"
|
|
>Associate AX.25 callsigns with system users</A
|
|
></DT
|
|
><DT
|
|
>15.4. <A
|
|
HREF="x1914.html#AEN1938"
|
|
>Add the PMS to the <TT
|
|
CLASS="LITERAL"
|
|
>/etc/ax25/ax25d.conf</TT
|
|
> file</A
|
|
></DT
|
|
><DT
|
|
>15.5. <A
|
|
HREF="x1914.html#AEN1952"
|
|
>Test the PMS</A
|
|
></DT
|
|
></DL
|
|
></DD
|
|
><DT
|
|
>16. <A
|
|
HREF="x1958.html"
|
|
>Configuring the <EM
|
|
>user_call</EM
|
|
> programs</A
|
|
></DT
|
|
><DT
|
|
>17. <A
|
|
HREF="x1990.html"
|
|
>Configuring the ROSE Uplink and Downlink commands</A
|
|
></DT
|
|
><DD
|
|
><DL
|
|
><DT
|
|
>17.1. <A
|
|
HREF="x1990.html#AEN2003"
|
|
>Configuring a ROSE downlink</A
|
|
></DT
|
|
><DT
|
|
>17.2. <A
|
|
HREF="x1990.html#AEN2016"
|
|
>Configuring a ROSE uplink</A
|
|
></DT
|
|
></DL
|
|
></DD
|
|
><DT
|
|
>18. <A
|
|
HREF="x2028.html"
|
|
>Associating AX.25 callsigns with Linux users</A
|
|
></DT
|
|
><DT
|
|
>19. <A
|
|
HREF="x2047.html"
|
|
>Configuring APRS</A
|
|
></DT
|
|
><DT
|
|
>20. <A
|
|
HREF="x2051.html"
|
|
>The <TT
|
|
CLASS="LITERAL"
|
|
>/proc/</TT
|
|
> file system entries</A
|
|
></DT
|
|
><DT
|
|
>21. <A
|
|
HREF="x2107.html"
|
|
>AX.25, NET/ROM, ROSE network programming</A
|
|
></DT
|
|
><DD
|
|
><DL
|
|
><DT
|
|
>21.1. <A
|
|
HREF="x2107.html#AEN2111"
|
|
>The address families</A
|
|
></DT
|
|
><DT
|
|
>21.2. <A
|
|
HREF="x2107.html#AEN2118"
|
|
>The header files</A
|
|
></DT
|
|
><DT
|
|
>21.3. <A
|
|
HREF="x2107.html#AEN2133"
|
|
>Callsign mangling and examples</A
|
|
></DT
|
|
></DL
|
|
></DD
|
|
><DT
|
|
>22. <A
|
|
HREF="x2141.html"
|
|
>Some sample configurations</A
|
|
></DT
|
|
><DD
|
|
><DL
|
|
><DT
|
|
>22.1. <A
|
|
HREF="x2141.html#AEN2144"
|
|
>Small Ethernet LAN with Linux as a router to Radio LAN</A
|
|
></DT
|
|
><DT
|
|
>22.2. <A
|
|
HREF="x2141.html#AEN2183"
|
|
>IPIP encapsulated gateway configuration</A
|
|
></DT
|
|
><DT
|
|
>22.3. <A
|
|
HREF="x2141.html#AEN2226"
|
|
>AXIP encapsulated gateway configuration</A
|
|
></DT
|
|
><DT
|
|
>22.4. <A
|
|
HREF="x2141.html#AEN2300"
|
|
>Linking NOS and Linux using a pipe device</A
|
|
></DT
|
|
></DL
|
|
></DD
|
|
><DT
|
|
>23. <A
|
|
HREF="x2329.html"
|
|
>Summary of AX.25-related Linux commands</A
|
|
></DT
|
|
><DT
|
|
>24. <A
|
|
HREF="x2525.html"
|
|
>Where do I find more information about .... ?</A
|
|
></DT
|
|
><DD
|
|
><DL
|
|
><DT
|
|
>24.1. <A
|
|
HREF="x2525.html#AEN2528"
|
|
>Packet Radio</A
|
|
></DT
|
|
><DT
|
|
>24.2. <A
|
|
HREF="x2525.html#AEN2541"
|
|
>Protocol Documentation</A
|
|
></DT
|
|
><DT
|
|
>24.3. <A
|
|
HREF="x2525.html#AEN2548"
|
|
>Hardware Documentation</A
|
|
></DT
|
|
><DT
|
|
>24.4. <A
|
|
HREF="x2525.html#AEN2560"
|
|
>Linux Ham Radio Software</A
|
|
></DT
|
|
></DL
|
|
></DD
|
|
><DT
|
|
>25. <A
|
|
HREF="x2566.html"
|
|
>Discussion relating to Amateur Radio and Linux</A
|
|
></DT
|
|
><DT
|
|
>26. <A
|
|
HREF="x2592.html"
|
|
>Acknowledgements</A
|
|
></DT
|
|
><DT
|
|
>27. <A
|
|
HREF="x2596.html"
|
|
>Feedback</A
|
|
></DT
|
|
><DT
|
|
>28. <A
|
|
HREF="x2602.html"
|
|
>Distribution Policy</A
|
|
></DT
|
|
></DL
|
|
></DIV
|
|
></DIV
|
|
><DIV
|
|
CLASS="NAVFOOTER"
|
|
><HR
|
|
ALIGN="LEFT"
|
|
WIDTH="100%"><TABLE
|
|
WIDTH="100%"
|
|
BORDER="0"
|
|
CELLPADDING="0"
|
|
CELLSPACING="0"
|
|
><TR
|
|
><TD
|
|
WIDTH="33%"
|
|
ALIGN="left"
|
|
VALIGN="top"
|
|
> </TD
|
|
><TD
|
|
WIDTH="34%"
|
|
ALIGN="center"
|
|
VALIGN="top"
|
|
> </TD
|
|
><TD
|
|
WIDTH="33%"
|
|
ALIGN="right"
|
|
VALIGN="top"
|
|
><A
|
|
HREF="x13.html"
|
|
>Next</A
|
|
></TD
|
|
></TR
|
|
><TR
|
|
><TD
|
|
WIDTH="33%"
|
|
ALIGN="left"
|
|
VALIGN="top"
|
|
> </TD
|
|
><TD
|
|
WIDTH="34%"
|
|
ALIGN="center"
|
|
VALIGN="top"
|
|
> </TD
|
|
><TD
|
|
WIDTH="33%"
|
|
ALIGN="right"
|
|
VALIGN="top"
|
|
>Introduction</TD
|
|
></TR
|
|
></TABLE
|
|
></DIV
|
|
></BODY
|
|
></HTML
|
|
> |