Differences

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

--- waoarc25:software-guide [2025/07/22 20:33] – gi3jmc
+++ waoarc25:software-guide [2025/07/23 14:26] (current) – gi3jmc
@@ Line 39: / Line 39: @@
 {{ :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.
+//If you wish to use a Pi connected via an ethernet cable, leave the section 'Configure wireless LAN' unticked and unfilled, but make sure your Pi has a wired connection available when it's running.//
-**7. **Switch to the 'Services' tab, and tick the 'Enable SSH' checkbox.  Once you have added the details click 'SAVE' and then click 'YES'.
+**Please take care when entering your Wifi SSID/Name & Password, as it will require re-writing the MicroSD card to change.  You should type the details into a text editor like Notepad to check that they are correct, and copy them to the imager with //CTRL+C// and //CTRL+V//.**
+**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|}}
 ----
@@ Line 50: / Line 53: @@
 ----
-==== Pi Software Preparation ====
+==== Pi Software Preparation/Wsprry Pi Installation ====
 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.
@@ Line 56: / Line 59: @@
 **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.
+{{ :waoarc25:ssh-first-login.png?direct&600|}}**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.**
@@ Line 64: / Line 67: @@
 **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. **
+----
+{{ :waoarc25:apt-update-prompt.png?direct&400|}}**5. **Before installing the wsprrypi software, you should make sure the system is up-to-date.  To check for updates type ''sudo apt update'' and press the return key. Once you are returned to the prompt, type ''sudo apt upgrade -y'' to upgrade the pi operating system.  Downloading and installing the updates may take a few minutes.
+**5a. **If you receive a prompt like the picture to the right, you should press ''Y'' or ''I'' and accept the changes.
+**6. **Once you are returned to the prompt, restart the pi using the command ''sudo systemctl reboot''.
+----
+{{ :waoarc25:wsprrypi-install-inprogress.png?direct&400|}}**7. **Reconnect to the pi as in step 3, with ''ssh jonathan@wsprrypi''
+//''wsprrypi'' is set up by a small script that configures and installs some additional support software before downloading, compiling, and installing ''wsprrypi'' itself, with the compiling taking up to 50 minutes if a Pi 1 has been used.  The script should complete in around 15 minutes on a Pi 3 or Pi Zero 2, so **do not panic if it seems to freeze** part-way through.  During the installation, you may wish to have a visit the Wsprry Pi website at [[https://wsprry-pi.readthedocs.io/en/latest/index.html|https://wsprry-pi.readthedocs.io/en/latest/index.html]]//
+**8. **After reconnecting to the Pi, at the prompt, type ''curl -fsSL installwspr.aa0nt.net | sudo bash'' and press the enter/return key to start the wsprrypi installation.  You will be prompted to confirm the system timezone. Check and press ''Y/N'' as appropriate, followed by the enter key.
+----
+{{ :waoarc25:wsprrypi_config_webpage.png?direct&400|}}**9. **Once the installation has completed it will ask you to press a key to continue.  You should press the enter/return key, as it appears to be the only key that works.
+**10. **After being returned to the prompt, type ''sudo reboot'' or ''sudo systemctl reboot'' to restart the Pi.
+**11. **Visit  ''http://wsprrypi/wsprrypi'' in your browser to access the configuration page.