Differences

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

--- waoarc25:software-guide [2025/07/22 20:34] – gi3jmc
+++ waoarc25:software-guide [2025/08/29 23:59] (current) – [Software Guide] gi3jmc
@@ Line 1: / Line 1: @@
-===== WAOARC 2025 WSPR Kit Build - Software Preparation Guide =====
+====== Worked All OARC Build Kit ======
-This guide will walk you through preparing a Raspberry Pi to work with the WSPR Hat Kit.
+===== Software Guide =====
-==== Prerequisites ====
+There are two options for software to run your wspr beacon:
+  * **__[[software-guide-tapr|TAPR]]__** - A downloadable image with minimal tinkering but an **//extremely out-of-date//** OS.  Only suitable for Pi 2, 3, & 4
-You will need the following items:
+  * **__[[software-guide-wsprrypi|WsprryPI]]__** - A solution requiring a little work, with a current & updated OS. Suitable for all Raspberry Pi's except the Pi 5.
-  *  A Raspberry Pi (see below)\\
-  *  A Power Supply suitable for your Pi\\
-  *  A MicroSD Card\\
-  *  A MicroSD Card Reader\\
-  *  A PC (Windows/Mac/Linux) to prepare the MicroSD Card\\
-  *  Your Wifi network name and password
-We recommend the use of a Pi Zero w, Pi Zero 2w, Pi 3, or Pi 4 due to having built-in Wifi.  The Pi 5 uses a different layout on it's 40-pin GPIO connector and is not currently supported.
-----
+**The Team behind the WAOARC WSPR kit would recommend the second, WsprryPi option for all installations.**
-==== SD Card Preparation ====
+Click the link in your chosen option above to proceed to the guide.
-{{ :waoarc25:piimagerdownloadlinux.png?direct&400|}} **The MicroSD card you use for this project will be completely erased during the process.  Please make sure that it does not contain any data you wish to keep.**
-**1. **Download and install the Raspberry Pi Imager from [[https://www.raspberrypi.com/software/|]].  If your computer type is not highlighted in the blue button, use the blue link that matches your system under the black box, as in the **picture to the right**.
-----
-**2. **Insert the MicroSD card into your card reader and connect it to your computer, and open the Raspberry Pi Imager application.
-**3. **Click the 'CHOOSE DEVICE' button on the left, and choose the option that matches your model of Raspberry Pi.
-{{ :waoarc25:piimageros-select.png?direct&400|}} **4. **Click the 'CHOOSE OS' button in the centre, scroll down (if needed) and click on ''Raspberry Pi OS (other)'', then ''Raspberry Pi OS Lite (32-bit)'' as in the **picture to the right**.
-----
-{{ :waoarc25:piimager-cardselect.png?direct&400|}} **5. **Click the 'CHOOSE STORAGE' button, and select your MicroSD Card from the list.  Be careful to choose the option that matches your MicroSD card.  Common card sizes are 8Gb, 16Gb, 32Gb, or 64Gb.
-----
-{{ :waoarc25:piimager-customisation.png?direct&400|}}**6. **Click the 'NEXT' button that appears in the lower right corner to continue.  When asked if you would like to apply OS customisation settings, click 'EDIT SETTINGS'.  In the dialog that follows you will need to set the hostname, choose your username and password, and add your wifi network details.  Passwords will be obscured as you type each character.
-**7. **Switch to the 'Services' tab, and tick the 'Enable SSH' checkbox.  Once you have added the details click 'SAVE' and then click 'YES'. {{ :waoarc25:piimager-customisation-ssh.png?direct&400|}}
-----
-{{ :waoarc25:piimager-erase_confirmation.png?direct&400|}}**8. **You will be asked to confirm that you want to erase all information on the MicroSD card.  This is your last chance to stop the process.  If you are sure that you want to proceed, click 'YES'.  Depending on your system, you may be asked for your password, or to confirm the writing of the card.
-After completing step 8, the Imager application will write and verify the card.  This may take a while.  When prompted, you can remove the MicroSD card and close the Imager application.
-----
-==== Pi Software Preparation ====
-In this section you will connect to your Pi via a command line, ensure the operating system is updated, and install the wsprrypi software that will control the hat.  In the steps that follow ''__wsprrypi__'' is used as the network name for the Pi, and assumes that you have just completed preparing the MicroSD Card.
-**1. **Insert the MicroSD Card to your Pi, and connect the power supply.  **Do not insert or remove the card while the Pi is powered.**  You do not need to attach the completed hat yet.
-**2. **The Pi will run through it's first startup, and ensures that the full MicroSD card is available for use.  This process will take a few minutes, and the Pi will restart itself.
-**The screenshots in this section will show a Linux-based system, however the typed commands shown will be identical for all users.**
-**3. **Open your Command Prompt(Windows)/Terminal (MacOS)/Konsole or gterm(Linux) and type ''ssh jonathan@wsprrypi'', replacing 'jonathan' with the username you chose in the previous section, and press the enter/return key.
-**4. **As this is your first time connecting to the pi, you will be prompted if you are sure you wish to connect. Type 'y' or 'yes' and press enter to proceed. You will not be asked this in the future.
-**5. **