Aprx 2.08 Manual A special-purpose Ham Radio software for UNIX-like environments, including Linux Manual version 1.09 Aprx 2.08 Manual, version 1.09 Aprx 2.08 Manual, version 1.09 By Matti Aarnio, OH2MQK, 2009-2013 2 / 67 Aprx 2.08 Manual, version 1.09 Table of Contents 1 What is APRX?.................................................................................................................. 5 2 Configuration Examples.................................................................................................... 7 2.1 Minimal Configuration of Rx-iGate............................................................................. 8 2.2 Minimal Configuration APRS Digipeater.................................................................... 9 2.3 Controlling New-n-paradigm.................................................................................... 10 2.4 Filtering at APRS Digipeater.................................................................................... 11 2.5 Combined APRS Digipeater and Rx-iGate.............................................................. 12 2.6 Doing Transmit-iGate............................................................................................... 14 2.7 Digipeater and Transmit-iGate................................................................................. 15 3 Configuration in details................................................................................................... 16 3.1 The “mycall” Parameter........................................................................................... 16 3.2 The “myloc” Parameter............................................................................................ 16 3.3 Aprx Configuration Parameter Types....................................................................... 17 3.4 The “<aprsis>” section............................................................................................. 18 3.5 The “<logging>” section........................................................................................... 20 3.5.1 The rflog file...................................................................................................... 20 3.6 The “<interface>” sections....................................................................................... 21 3.6.1 General note about serial ports........................................................................ 21 3.6.1.1 USB serial port powering and reliability.................................................... 22 3.6.2 Serial port init-strings........................................................................................ 22 3.6.3 The KISS variations.......................................................................................... 23 3.6.4 POSIX serial-port devices, KISS mode, sub-interface 0.................................. 24 3.6.5 POSIX serial-port devices, KISS mode, multiple sub-interfaces..................... 25 3.6.6 POSIX serial-port devices, KISS mode with isochronous TNC-id polling........ 26 3.6.7 POSIX serial-port devices, TNC2 mode........................................................... 26 3.6.8 POSIX serial-port devices, DPRS mode.......................................................... 27 3.6.9 Linux AX25-DEVICE......................................................................................... 27 3.6.10 Networked tcp-stream connected terminal devices....................................... 28 3.6.11 The NULL-DEVICE......................................................................................... 29 3.6.12 Telemetry to APRS-IS control......................................................................... 29 3.7 The “<beacon>” sections......................................................................................... 30 3.8 The “<telemetry>” sections...................................................................................... 34 3.9 The <digipeater> sections....................................................................................... 35 3.9.1 The <trace> sub-section................................................................................... 36 3.9.2 The <wide> sub-section................................................................................... 36 3.9.3 The <source> sub-sections.............................................................................. 37 3.9.4 Filter entries...................................................................................................... 39 3.9.4.1 Filter A – Area by Corner Coordinates...................................................... 41 3.9.4.2 Filter B – Budlist........................................................................................ 41 3.9.4.3 Filter D – Digipeater List........................................................................... 41 3.9.4.4 Filter F – Friends Range........................................................................... 41 3.9.4.5 Filter G – Group Messaging...................................................................... 42 3.9.4.6 Filter M – My Range.................................................................................. 42 3.9.4.7 Filter O – Object/Item ID........................................................................... 42 3.9.4.8 Filter P – Source Address Prefix............................................................... 42 3 / 67 Aprx 2.08 Manual, version 1.09 3.9.4.9 Filter T – Packet Type............................................................................... 42 3.9.4.10 Filter U – Unproto.................................................................................... 43 3.9.5 Regex-filter entries........................................................................................... 44 3.9.6 Digipeating other than APRS packets.............................................................. 44 4 Advanced Configuration Examples................................................................................. 45 4.1 Doing Transmit-iGate............................................................................................... 45 4.2 A Fill-In Digipeater.................................................................................................... 46 4.3 Using Multiple Radios.............................................................................................. 48 4.4 A Tx-iGate with Multiple Radios on Each Frequency.............................................. 49 4.5 A Bi-Directional Cross-band Digipeater................................................................... 51 4.6 Limited Service Area Digipeater.............................................................................. 52 4.7 Limited Service Area Tx-iGate................................................................................. 53 4.8 Sending telemetry to radio interface........................................................................ 53 4.9 DPRS-to-APRS Gateway........................................................................................ 54 5 Running the Aprx Program.............................................................................................. 55 5.1 Normal Operational Running................................................................................... 55 5.1.1 On RedHat/Fedora/SuSE/relatives.................................................................. 55 5.1.2 On Debian/Ubuntu/derivatives......................................................................... 56 5.1.3 Logrotate (Linux systems)................................................................................ 56 5.2 The aprs.fi Services for Aprx.................................................................................... 57 5.3 Keywords on <trace> and <wide> sub-sections of <digipeater> sections.............. 58 5.4 Effect of “viscous-delay” on a Digipeater................................................................. 59 6 Compile Time Options..................................................................................................... 61 6.1 Building Debian package......................................................................................... 61 6.2 Building RPM package............................................................................................ 61 7 Debugging....................................................................................................................... 63 7.1 Testing Configuration............................................................................................... 63 7.2 Hunting bugs............................................................................................................ 64 7.2.1 With gdb........................................................................................................... 64 7.2.2 With valgrind..................................................................................................... 65 8 Colophon......................................................................................................................... 67 4 / 67 Aprx 2.08 Manual, version 1.09 1 What is APRX? The Aprx program is for amateur radio APRS™ networking. The Aprx program is available at: http://ham.zmailer.org/oh2mqk/aprx/ Discussion forum is at: http://groups.google.com/group/aprx-software The Aprx program can do job of at least three separate programs: 1. APRS iGate 2. APRS Digipeater 3. DPRS-to-APRS gateway The digipeater functionality can also be used for other forms of AX.25 networking, should a need arise. The