Differences

This shows you the differences between two versions of the page.

--- ninotnc-aprs [2023/02/18 15:12] – created 2e0sip
+++ ninotnc-aprs [2023/02/20 22:48] (current) – 2e0sip
@@ Line 1: / Line 1: @@
 ====== APRS with the NinoTNC ======
+**Note: This is currently a WIP **
 The NinoTNC can be used to send and receive [[https://en.wikipedia.org/wiki/Automatic_Packet_Reporting_System|APRS]] which will allow you to run an iGate, Digipeater or position beacon when used in conjunction with some additional software. As well as contributing to the APRS network, this might be useful to help  [[https://wiki.oarc.uk/packet_peer_finding|find local stations]] you can peer with to help build a national packet network.
-This document will cover installing and configuring software to run as an iGate, with a periodic position beacon sent via RF.
+This document will cover installing and configuring the software to run as an Rx only iGate, with a periodic position beacon sent via RF. Two software packages are documented, you can chose one or the other. [[https://thelifeofkenneth.com/aprx/|Aprx]] is lightweight and easy to configure, and [[https://www.cantab.net/users/john.wiseman/Documents/BPQ32.html|BPQ32]] is more fully featured but harder to configure, but also allows you to attach an external APRS client like [[https://www.ka2ddo.org/ka2ddo/YAAC.html|YAAC]] so you can run a "headless" iGate but periodically connect from another computer to view stations on a map or send messages.
-[[https://thelifeofkenneth.com/aprx/|Aprx]] which is lightweight and easy to configure, and [[https://www.cantab.net/users/john.wiseman/Documents/BPQ32.html|BPQ32]] which is more fully featured but harder to configure.
+**The guides for both packages assume you're using Raspberry Pi OS or Debian, but may work for other Debian derivatives.**
+===== NinoTNC / Radio Setup =====
+=== NinoTNC ====
+For 1200 Baud AFSK set the MODE switches to 0110.
+=== Radio ===
+The vast majority of APRS in the UK takes place on 144.800Mhz FM with narrow deviation. Configure your radio accordingly.
 ===== Notes on licensing =====
@@ Line 14: / Line 26: @@
   * A Digipeater will require an NoV as you're re-transmitting third party traffic.
   * The ETCC state you require an NoV for a receive only iGate. This is widely disputed, doesn't appear to be backed up by law and frequently ignored. (See [[https://aprs.fi/|aprs.fi]] to see how many stations are iGating without an NoV... ). That said, anyone with a foundation license or greater can apply for an Rx only iGate, and you get a fancy MB7 callsign.
+  * If you're beaconing over RF your station will need to be attended unless you have an NoV or you're operating "remotely" ( See license for restrictions on remote operation )
 ===== Aprx =====
+==== Installation ====
+Firstly install some pre-requisites:
+<code>
+sudo apt-get update && apt-get upgrade
+sudo apt-get install wget openssl
+</code>
+Next download the latest package. I'm forcing IPv4 only as I had issues when attempting to download via IPv6.
+For Raspberry Pi:
+<code>
+wget --inet4-only -O /tmp/aprx.deb https://thelifeofkenneth.com/aprx/debs/aprx_2.9.0_raspi.deb
+</code>
+For amd64:
+<code>
+wget --inet4-only -O /tmp/aprx.deb https://thelifeofkenneth.com/aprx/debs/aprx_2.9.0_amd64.deb
+</code>
+Next install the deb package:
+<code>
+dpkg -i /tmp/aprx.deb
+</code>
+==== Configuration ====
+Now it's time to customise the configuration. Use your preferred text editor to open ///etc/aprx.conf// and edit to suit.
+The latitude and longitude syntax is mildy annoying, you need them in degrees, minutes, and seconds format. Latitude requires 4 digits before the decimal point and Longitude requires 5 digits before the decimal point. Pad with zeros if required. I use the "GPS Coordinates" from [[https://www.latlong.net/|latlong.net]]
+You can generate your APRS Passcode [[https://apps.magicbug.co.uk/passcode/|here]]
+It should look something like the example below.
+<code>
+mycall YOURCALL-YOURSSID
+myloc lat 5139.20N lon 00025.09W
+<interface>
+        callsign YOURCALL-YOURSSID
+        serial-device /dev/ttyACM0 57600 8n1 KISS
+        telem-to-is false
+        tx-ok true
+</interface>
+<aprsis>
+        login YOURCALL-YOURSSID
+        passcode YOURPASSCODE
+        server euro.aprs2.net
+        heartbeat-timeout 1m
+</aprsis>
+<beacon>
+        cycle-size 15m
+        beaconmode both # aprsis, radio, or both
+        beacon interface YOURCALL-YOURSSID via WIDE1-1 symbol "R&" $myloc comment "Aprx + NinoTNC Rx-iGate"
+</beacon>
+<logging>
+        rflog /var/log/aprx/aprx-rf.log
+        aprxlog /var/log/aprx/aprx.log
+</logging>
+</code>
+==== systemd ====
+Aprx doesn't ship with a systemd service file by default, and I've had some issues with the included init script. Lets create a systemd service instead.
+<code>
+sudo systemctl disable aprx
+sudo systemctl daemon-reload
+sudo rm /etc/init.d/aprx
+</code>
+Open /etc/systemd/system/aprx.service with your favourite text editor.
+<code>
+[Unit]
+Description=Amateur Radio APRS Gateway & Digipeater
+Documentation=man:aprx(8)
+[Service]
+Type=simple
+ExecStart=/sbin/aprx -i
+[Install]
+WantedBy=multi-user.target
+</code>
+<code>
+sudo systemctl enable aprx
+sudo systemctl start aprx
+</code>
+==== Usage ====
+Aprx is relatively simple and once configured and started it should start to automatically forward packets to APRS-IS.
+To view the RF log:
+  tail -f /var/log/aprx/aprx-rf.log
+To view the generic log:
+  tail -f /var/log/aprx/aprx.log
+It might be useful to debug Aprx in the foreground. To do so, stop Aprx with
+  systemctl stop aprx
+Then run it in the foreground with the debug arguments:
+  aprx -f /etc/aprx.conf -v -dd -L
+===== BPQ32 =====
+coming soon
+<code>
+SIMPLE
+NODECALL=2E0SIP-11
+LOCATOR=NONE
+IDINTERVAL=0
+IDMSG:
+!5139.20NR00025.09W&Aprx + NinoTNC Rx-iGate
+***
+PORT
+ PORTNUM=1
+ ID=APRS Port
+ TYPE=ASYNC
+ PROTOCOL=KISS
+ FRACK=10000
+ RESPTIME=500
+ RETRIES=10
+ MAXFRAME=7
+ PACLEN=128
+ TXDELAY=500
+ QUALITY=0
+ MINQUAL=10
+ COMPORT=/dev/ttyACM0
+ SPEED=57600
+ SLOTTIME=100
+ PERSIST=64
+ BBSFLAG=NOBBS ; Disable Packet Functions
+ DIGIFLAG=0 ; Disable Packet Functions
+ENDPORT
+PORT
+ PORTNUM=2
+ ID=KISS
+ TYPE=ASYNC
+ PROTOCOL=KISS
+ IPADDR=0.0.0.0
+ TCPPORT=8003
+ENDPORT
+APRSDIGI
+ APRSCall 2E0SIP-11
+ ;RXONLY=1
+ StatusMsg=BPQ32 + NinoTNC Rx-iGate
+ Symbol=& ; Icon to display for station.
+ Symset=R ; This is a "R" in a Black Diamond, indiciating a receive only iGate
+ BeaconInterval=15
+ ;APRSPath 1= ; Receive only port
+ APRSPath 1=APRS,WIDE1-1
+ APRSPath 2=APRS,WIDE1-1
+ Digimap 1=IS
+ BRIDGE 1=2
+ BRIDGE 2=1
+ ; Posistion Params
+ LAT=5139.20N ; Must be in standard APRS Format (ddmm.mmN/S)
+ LON=00025.09W ; Must be in standard APRS Format (dddmm.mmE/W)
+ ; IGATE Params. If specified you will gate RF packets and your beacons to APRS-IS
+ ISHost=aprs.2e0sip.co.uk
+ ISPort=14580
+ ISPasscode=YOURPASSCODE
+***
+</code>