This repo contains scripts & notes for taking a new COMPASS image and creating a working image that will boot up & run the following configurations:
- Core only
- RMS Winlink Gateway
- paclink-unix in two flavors
- paclink-unix basic which allows using a movemail e-mail client like Thunderbird
- paclink-unix imap which allows using any e-mail client that supports IMAP.
Note deviation is stand alone and is not part of the install/config process.
Compass is a file system image for the Raspberry Pi that contains a kernel with the driver for the Texas Instruments tlv320aic32x4 DSP sound chip. Other than this codec driver the Compass image mimics the Raspbian image.
The NW Digital Radio UDRC II is a hat that contains the tlv320aic32x4 DSP sound chip plus routes GPIO pins to control PTT. It also has a 12V to 5V regulator so that you can run the Pi from a 12V supply.
Only the direwolf configuration is specific to the UDRC II hardware
Core is required for any other packet apps using a UDRC. This option installs direwolf & AX.25 tools/apps/library. Use this option if you want to run APRS only or some packet client that uses direwolf or AX.25. As part of the core requirements this option also configures systemd to start direwolf, AX.25 attach & AX.25 apps like mheardd at boot time.
Regardless of what functionality you want to install the first thing to run is core_install.sh which will do the initial configuring of the compass kernel & install AX.25 & direwolf.
In order to install the Linux RMS Gateway you must register with Winlink to get a password for a gateway.
See RMSGW_INSTALL.md for details on installing RMS Gateway functionality.
See config/app_install.sh for installing all apps required for RMS Gateway.
- Two installation options:
- basic - installs paclink-unix, mutt & postfix
- imap - installs the above plus, dovecot imap mailserver & hostapd WiFi access point, and dnsmasq to serve up DNS & DHCP when the RPi 3 is not connected to a network.
This is a light weight paclink-unix install that gives functionality to use an e-mail client on the Raspberry Pi to compose & send winlink messages
This installs functionality to use any imap e-mail client & to access paclink-unix from a browser. This allows using a WiFi device (smart phone, tablet, laptop) to compose a Winlink message & envoke paclink-unix to send the message.
Installs the following:
- hostapdd to enable WiFi for a Raspberry Pi 3
- dovecot, imap e-mail server
- dnsmasq to allow connecting to the Raspbery Pi when it is not connected to a network
- Script that generates a tone file using sox, turns on correct PTT gpio and plays wave file through a UDRC
- Generating a tone sine wave is one part of measuring deviation. The other part is doing the actual measurement. The Xastir wiki has a nice article on how to do that using an RTL SDR dongle.
- systemd service file supplied by Ken Koster K7IPB.