Install scripts, systemd files & other miscellaneous files
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
ax25
bbs
bin
change_user
config
debug
deviation
direwolf
dstar
email
gps
hfprogs
hostap
iptables
kernbuild
mailserv
plu
rmsgw
systemd
tracker
uronode
vnc
xastir
yaac
.gitignore
CORE_INSTALL.md
ChangeLog
README.md

README.md

Install scripts for some packet functionality

Introduction

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: These scripts are meant to be run once only on a fresh image.

Note: deviation is stand alone and is not part of the install/config process. Files in vnc & uronode are also currently not used for core install.

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

These scripts were meant to be run once only starting from a clean image. They might work if used more than once but they were not tested for that case. If an installation fails I would like to know about it. Please post any problems you might have on the UDRC forum.

Installation scripts

Core

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.

RMS Gateway

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.

paclink-unix

paclink-unix basic

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.

Installs the following:

  • paclink-unix to format e-mail
  • postfix for the mail transfer agent
  • mutt for the mail user agent

paclink-unix imap

This installs functionality to use any imap e-mail client & to access paclink-unix from a browser. It allows using a WiFi device (smart phone, tablet, laptop) to compose a Winlink message & envoke paclink-unix to send the message. This is also configured to cough up a dhcp config for your mobil device if your RPi 3 is in a car not connected to the Internet.

Installs the following:

  • paclink-unix to format e-mail
  • postfix for the mail transfer agent
  • dovecot, imap e-mail server
  • hostapdd to enable a Raspberry Pi 3 to be a virtual access point
  • dnsmasq to allow connecting to the Raspbery Pi when it is not connected to a network
  • nodejs to host the control page for paclink-unix
  • iptables to enable NAT

Other

Alpine mail client

  • Notes on building & getting the alpine mail client to work with paclink-unix.

deviation

  • 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.

vnc

  • systemd service file supplied by Ken Koster K7IPB.

uronode