Linux Amateur Radio AX.25 HOWTO
Total Page:16
File Type:pdf, Size:1020Kb
Linux Amateur Radio AX.25 HOWTO Jeff Tranter, VE3ICH [email protected] v2.0, 19 September 2001 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. Linux Amateur Radio AX.25 HOWTO Table of Contents 1. Introduction.....................................................................................................................................................1 1.1. Changes from the previous version...................................................................................................1 1.2. Where to obtain new versions of this document...............................................................................1 1.3. Other related documentation.............................................................................................................1 2. The Packet Radio Protocols and Linux........................................................................................................3 2.1. How it all fits together......................................................................................................................3 3. The AX.25/NET/ROM/ROSE software components...................................................................................5 3.1. Finding the kernel, tools and utility packages..................................................................................5 3.1.1. The kernel source..............................................................................................................5 3.1.2. The network tools.............................................................................................................5 3.1.3. The AX.25 utilities...........................................................................................................5 3.1.4. The APRS utilities............................................................................................................6 4. Installing the AX.25/NET/ROM/ROSE software........................................................................................7 4.1. Compiling the kernel........................................................................................................................7 4.1.1. A word about kernel modules...........................................................................................9 4.2. The AX.25 library, tools, and application programs........................................................................9 5. A note on callsigns, addresses and things before we start.........................................................................12 5.1. What are all those T1, T2, N2 and things ?....................................................................................12 5.2. Run time configurable parameters..................................................................................................13 6. Configuring an AX.25 port..........................................................................................................................15 6.1. Creating the AX.25 network device................................................................................................15 6.1.1. Creating a KISS device...................................................................................................15 6.1.2. Creating a 6PACK device...............................................................................................17 6.1.3. Creating a Baycom device..............................................................................................17 6.1.4. Configuring the AX.25 channel access parameters........................................................18 6.1.5. Creating a kernel Soundmodem device..........................................................................19 6.1.6. Creating a user−mode Soundmodem device..................................................................23 6.1.7. Creating a YAM device..................................................................................................23 6.1.8. Creating a PI card device................................................................................................23 6.1.9. Creating a PacketTwin device........................................................................................24 6.1.10. Creating a generic SCC device.....................................................................................24 6.1.11. Creating a BPQ ethernet device....................................................................................32 6.1.12. Configuring the BPQ Node to talk to the Linux AX.25 support..................................32 6.2. Creating the /etc/ax25/axports file..................................................................................................33 6.3. Configuring AX.25 routing.............................................................................................................34 7. Configuring an AX.25 interface for TCP/IP..............................................................................................35 8. Configuring a NET/ROM port....................................................................................................................36 8.1. Configuring /etc/ax25/nrports.........................................................................................................36 8.2. Configuring /etc/ax25/nrbroadcast..................................................................................................37 8.3. Creating the NET/ROM Network device.......................................................................................38 8.4. Starting the NET/ROM daemon.....................................................................................................38 i Linux Amateur Radio AX.25 HOWTO Table of Contents 8.5. Configuring NET/ROM routing.....................................................................................................38 9. Configuring a NET/ROM interface for TCP/IP........................................................................................39 10. Configuring a ROSE port..........................................................................................................................40 10.1. Configuring /etc/ax25/rsports.......................................................................................................40 10.2. Creating the ROSE Network device.............................................................................................41 10.3. Configuring ROSE Routing..........................................................................................................41 11. Making AX.25/NET/ROM/ROSE calls.....................................................................................................42 12. Configuring Linux to accept Packet connections.....................................................................................43 12.1. Creating the /etc/ax25/ax25d.conf file..........................................................................................43 12.2. A simple example ax25d.conf file................................................................................................46 12.3. Starting ax25d...............................................................................................................................48 13. Configuring the node software..................................................................................................................49 13.1. Creating the /etc/ax25/node.conf file............................................................................................49 13.2. Creating the /etc/ax25/node.perms file.........................................................................................50 13.3. Configuring node to run from ax25d............................................................................................52 13.4. Configuring node to run from inetd..............................................................................................52 14. Configuring axspawn..................................................................................................................................54 14.1. Creating the /etc/ax25/axspawn.conf file......................................................................................54 15. Configuring the pms...................................................................................................................................56 15.1. Create the /etc/ax25/pms.motd file...............................................................................................56 15.2. Create the /etc/ax25/pms.info file.................................................................................................56 15.3. Associate AX.25 callsigns with system users...............................................................................56 15.4. Add the PMS to the /etc/ax25/ax25d.conf file..............................................................................56 15.5. Test the PMS.................................................................................................................................57 16. Configuring the user_call programs.........................................................................................................58 17. Configuring the ROSE Uplink and Downlink commands......................................................................59