From 9fdeef7b3b2a8876b2a0c9f6110c8f4886941de8 Mon Sep 17 00:00:00 2001 From: KM4ACK Date: Sat, 20 Jun 2020 07:20:20 -0500 Subject: [PATCH] initial commit --- README.md | 136 ++++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 136 insertions(+) create mode 100644 README.md diff --git a/README.md b/README.md new file mode 100644 index 0000000..10f36e4 --- /dev/null +++ b/README.md @@ -0,0 +1,136 @@ +# Description + +Build-a-Pi will allow you to get up and running fast with a Raspberry Pi for ham radio. +Rather than downloading a pre-built image where you have no choices in the build, Build-a- +Pi gives you complete control over the build. It allows you to choose the applications you +want to install and skip the ones you don’t need. This keeps your pi as lean and mean as +possible. A list of applications available using Build-a-Pi can be found below on this +page. Use it as your base and add additional applications as needed down the road. Videos +coming soon + +# Needed info for pi build + +During the install you will need a few pieces of information depending on what you choose to install. If installing all apps, you will need: + +For Hotspot: +Current WiFi SSID & Current WiFi Password + +For Pat Winlink: +Winlink Password & Grid Square + +# Install +This script is intended to run on a brand new installation of Buster. It should not be run on a pi that you have already started installing applications on. Install additional apps that you require after running this script.\ +\ +Flash a fresh copy of Buster to a SD card and run the following command + + git clone https://github.com/km4ack/pi-build.git $HOME/pi-build && bash $HOME/pi-build/build-a-pi + +# Issue Reporting - Feature Requests +Please report issues & feature requests here https://github.com/km4ack/pi-build/issues + +# Available Apps to Install + +#### RTC | Real Time Clock +Software for DS3231 real time clock + +#### HOTSPOT: +Hotspot is used to generate a wifi hotspot that you can connect to with other wireless devices. This is useful when in the field so you can connect to and contol the pi from a wireless device. + +#### GPS: +This will install the needed utilities to get a GPS device configured as a time source on the pi. Helpful when you are not connected to the internet since the pi doesn't have a real time clock and therefore will NOT keep accurate time when powered off. Confirmed to work with this GPS https://amzn.to/2R9Muup Other GPS units may work but have not been tested. + +#### FLRIG: +Rig contol graphical interface. http://www.w1hkj.com/ + +#### FLDIGI: +Digital Mode Software http://www.w1hkj.com/ + +#### FLMSG: +Forms manager for FLDIGI http://www.w1hkj.com/ + +#### FLAMP: +Amateur Multicast Protocol - file transfer program http://www.w1hkj.com/ + +#### FLWRAP +file encapsulation / compression + +#### PAT: +Winlink client for Raspberry Pi https://getpat.io/ + +#### PATMENU: +Menu for configuring Pat. Recommended if installing Pat. https://github.com/km4ack/patmenu + +#### ARDOPC: +HF modem for Pat. Recommended if installing Pat https://www.cantab.net/users/john.wiseman/Documents/ARDOPC.html + +#### ARDOPGUI: +GUI interface for ARDOPC. Recommended if installing Pat + +#### DIREWOLF: +Software TNC. In this setup, direwolf is used for 2M packet connection with Pat and can be used for APRS connection with Xastir. Recommneded if installing Pat or Xastir https://github.com/wb2osz/direwolf/tree/master/doc + +#### AX25: +AX25 tools for Direwolf & Pat. Recommended if installing Pat. + +#### HAMLIB: +Rig contol software. https://sourceforge.net/projects/hamlib/ + +#### PULSE: +Pulse audio. Provides a way to configure virtual sound cards. REQUIRED for AMRRON ops. + +#### JS8: +JS8Call digital software https://js8call.com + +#### M0IAX: +Tools for working with JS8Call. Recommended if installing JS8Call https://github.com/m0iax/ + +#### WSJTX: +FT8 & WISPR software suite. https://sourceforge.net/projects/wsjt/ + +#### CHIRP: +Software to program radios. https://chirp.danplanet.com + +#### XASTIR: +GUI interface useful when configuring APRS nodes. https://sourceforge.net/projects/xastir/ + +#### YAAC: +Yet Another APRS Client GUI interface useful when configuring APRS nodes. https://www.ka2ddo.org/ka2ddo/YAAC.html + +#### PYQSO: +Logging software https://github.com/ctjacobs/pyqso + +#### GPREDICT: +Satellite Tracking http://gpredict.oz9aec.net/ + +#### CQRLOG: +Loggin Software https://www.cqrlog.com/ + +#### QSSTV: +Slow scan tv http://users.telenet.be/on4qz/qsstv/index.html + +#### Gridtracker +https://tagloomis.com/ + +#### Propagation (VOACAP) +Propagation Prediction Software https://www.qsl.net/hz1jw/voacapl/index.html + +#### Emergency Email Server (EES): +My personal EES. Requires hotspot to be installed. https://youtu.be/XC9vdAnolO0 +\ +To access the EES, connect to the pi's hotspot, open a web browser, and navigate to email.com\ +or open a web browser and navigate to the pi's ip adderss on your local network.\ +Admin credentials are admin/admin by default but can be changed in the file found at\ +/var/www/html/config.php \ +For more configuration options - https://youtu.be/KaEeCq50Mno + +#### Call Sign Lookup +Look amateur radio call signs + +#### Dipole Calculator +Calculate lengths needed for dipole legs + +#### Log Viewer +Graphic viewer to view/manage log files + +#### Gparted +Disk utility \ No newline at end of file