| Both sides previous revisionPrevious revisionNext revision | Previous revision |
| waoarc25:software-guide-wsprrypi [2025/07/28 13:51] – [Pi Software Preparation/Wsprry Pi Installation] gi3jmc | waoarc25:software-guide-wsprrypi [2025/08/30 00:32] (current) – gi3jmc |
|---|
| * Your Wifi network name and password | * 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. | 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. |
| |
| ---- | ---- |
| **3. **Click the 'CHOOSE DEVICE' button on the left, and choose the option that matches your model of Raspberry Pi. | **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:pios-64bit-selection-wide.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 (64-bit)'' as in the **picture to the right**. |
| |
| ---- | ---- |
| //''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]]// | //''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 ''<nowiki>curl -L https://raw.githubusercontent.com/lbussy/WsprryPi/refs/tags/2.0.1/scripts/install.sh | sudo REPO_BRANCH=2.0.1 bash</nowiki>'' 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. | **8. **After reconnecting to the Pi, at the prompt, type ''<nowiki>curl -fsSL installwspr.aa0nt.net | sudo bash</nowiki>'' 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. |
| |
| //**Note:** This is a slightly different command than specified in the software documentation. The current version has a bug affecting transmission on 40m, and we force an earlier, non-affected version to be installed with ''REPO_BRANCH=2.0.1''// | //**Note:** This has been returned to the original command as stated in the original documentation for the software, as the guide above now directs you to install a 64-bit OS. There had been an issue with the software and using it on a 32-bit OS, and we forced a previous version of the software to be used. With the 64-bit OS, this is no longer necessary. // |
| |
| ---- | ---- |
| |
| The configuration page should be pretty straightforward, but here are a few pointers: | The configuration page should be pretty straightforward, but here are a few pointers: |
| | * The Transmit toggle can be used to enable and disable your beacon. Once configured you should leave it enabled. |
| * The box labelled Grid Square should be your Maidenhead locator, to 4 characters (e.g. IO65, JO01, or IO70) | * The box labelled Grid Square should be your Maidenhead locator, to 4 characters (e.g. IO65, JO01, or IO70) |
| * The TxLED pin is on GPIO18 | * The TxLED pin is on GPIO18 - Enable this to make the LED light when the hat is actively transmitting. |
| * The Shutdown button is on GPIO19 | * The Shutdown button is on GPIO19 - Enable this to make the button on the hat turn off your Pi safely. |
| * The Frequencies box should be completed with an exact frequency, or a band name (7040100 / 40m)*. | * The Frequencies box should be completed with a band name (40m). If only a single frequency is entered your beacon will transmit on every 2-minute wspr cycle |
| | * You can add non-transmit cycles by adding a 0 at the end of the frequency box. ''40m 0 0 0 0'' will make your beacon transmit once and skip the next four cycles before transmitting again. |
| |
| *During testing setting the frequency as 7040.1kHz made the webpage error out as the wsprrypi service had stopped. If this happens, you can connect to the pi and use the command `sudoedit /usr/local/etc/wsprrypi.ini` to change the frequency to a band name. | ---- |
| | |
| | |
| | **During testing setting the frequency as 7040.1kHz made the webpage error out as the wsprrypi service had stopped.**\\ |
| | If this happens, you can connect to the pi and use the command ''sudoedit /usr/local/etc/wsprrypi.ini'' to change the frequency to a band name, or to an exact frequency in Hz. Restart the wsprrypi service once you finish editing and save the file with ''sudo systemctl restart wsprrypi'' |
| |
| | After the service is restarted you can re-visit the web configuration page and adjust the settings. |
