Skip to main content...

W0CHP.radio

The WPSD Project

Main Dashboard Screenshot

Welcome to the official home of the WPSD Project. WPSD is a next-generation digital voice software suite & distribution for amateur radio use, enjoyed by many thousands of hams around the globe. It is used for personal hotspots and repeaters alike. It supports M17, DMR, D-Star, Yaesu System Fusion (YSF/C4FM), P25, NXDN digital voice modes & POCSAG data/paging.

WPSD is available as installable disk images, and multiple platforms & devices are supported. The WPSD Project is free and open-source software (FOSS).

Table of Contents:

Installing WPSD

Quick Start

  1. Download the appropriate disk image for your device / platform.

  2. Use a tool such as Raspberry Pi Imager or Balena Etcher, to write the disk image to your SD-Card. These tools will automatically decompress the .xz file as well.

    • You will need an SD card of at least 8GB to install these disk images.
    • Important: If using Raspberry Pi Imager, do not use the “advanced options” to create a user, change the password, etc.! The “pi-star” user and password is already on the disk image, and it is required for many of the programs to function properly. (You can change the “pi-star” user password from the WPSD configuration page after you first boot up WPSD.)
  3. Optional:

    • Use my WiFi Config File Generator to automatically connect the dashboard to your WiFi. Or…
    • Connect your device directly to Ethernet. Or…
  4. Otherwise: After about 5+ minutes post-bootup, you can connect to the “WPSD-Setup” WiFi network to login to the dashboard and configure your hotspot after it’s booted…

  5. Insert the SD-Card into your hotspot and bootup!

  6. The default login is;

    User: pi-star

    Password: raspberry

  7. Important: if installing the WPSD Bookworm version, please note the special instructions and changes.

Detailed Instructions

A detailed installation guide is also available in the official WPSD User Manual.

Installation Notes

Important Info for First Bootup:

  1. When first booting from the WPSD disk image, go grab a coffee, drink, etc. and let the file-system auto-expand and the rest of the system initialize. Be patient. Full details on this can be found in a dedicated document.
  2. When installing from the WPSD disk image, it’s a best practice (and better) to run an update before setting up or making configuration changes to your hotspot. This ensures that setup/configuration changes you make are the most tested and up-to-date.

Download WPSD

Choose the disk installation image for your specific hardware / device from the following device matrix…

If you don’t see a disk image in the matrix for your specific hardware, it doesn’t exist…read the FAQs.

Common and Generic Hotspots / Devices WPSD Disk Image
Raspberry Pi (for RPi Zero, Zero 2 and Models 2, 3, 4 & 5) Platforms (Bookworm OS) WPSD_RPi-Bookworm.img.xz
Nano Pi Neo Platform (Bullseye OS) WPSD_NanoPiNeo-Bullseye.img.xz
Vendor-Specific Hotspots / Devices WPSD Disk Image
BridgeCom SkyBridge MAX/Plus (Bookworm OS)

This is the official and custom-built disk image specific to the newer SkyBridge MAX and older SkyBridge Plus Hotspots.
WPSD_SkyBridge_Max-Bookworm.img.xz
DVMEGA Cast (Bullseye OS)

This is the official and custom-built disk image specific to the DVMEGA Cast Radio / Device.
WPSD_DVMega_Cast-Bullseye.img.xz
DVMEGA EuroNode (Bullseye OS)

This is the official and custom-built disk image specific to the DVMEGA EuroNode Hotspot.
WPSD_DVMega_EuroNode-Bullseye.img.xz
ZUMSpot Elite & Mini 2.4 w/LCD Displays (Bookworm OS)

This is the official and custom-built disk image specific to the ZUMspot Elite 3.5 Hotspot.
WPSD_ZumSpot_LCD-Bookworm.img.xz
ZUMSpot Mini 1.3 with OLED Display (Bookworm OS)

This is the official and custom-built disk image specific to the ZUMspot Mini 1.3 Hotspot.
WPSD_ZumSpot_OLED-Bookworm.img.xz
ZUMSpot USB Stick (Bookworm OS)

This is the official and custom-built disk image specific to the ZUMspot USB Stick Hotspot for use on a Raspberry Pi. A Raspberry Pi computer is required.
WPSD_ZumSpot_USB-Bookworm.img.xz
Vendor-Specific Repeater Devices WPSD Disk Image
ZUMSpot MMDVM-Pi Repeater Board (Bookworm OS)

This is the official and custom-built disk image specific to the ZUMspot MMDVM-Pi Repeater Board. A Raspberry Pi computer is required.
WPSD_ZumRadio_MMDVM_Pi_Rptr-Bookworm.img.xz
File Integrity Check
SHA-256 Checksums for the Disk Image Files: WPSD_SHA256-SUMS.txt

Getting Help/Support

Updating WPSD

Once you install WPSD, it will automatically be kept up-to-date with any new features/versions/etc. This is made possible via the native, nightly updating process.1

If you do not leave your hotspot powered on during the night, you can also manually invoke the update process via the dashboard admin section (Admin -> Update).

It is highly recommended that you simply leave your hotspot(s) powered on at night, since WPSD is rolling release/continuous delivery software - updates are rapid and frequent!

Screenshots

To help keep this web page small/quick, the WPSD screenshots are on their own page.

Notes about M17 Protocol Support

M17 protocol support requires updated MMDVM Modem Firmware or MMDVM_HS HotSpot Firmware of at least v1.6. Ergo, you may need to update your firmware using the included MMDVM_HS (etc.) firmware flash/update programs in WPSD.

Here are the relevant device firmware upgrade commands.

Known Issues & Incompatibilities

Raspberry Pi 5, 2GB RAM Models Won’t Bootup

The WPSD universal Bookworm disk image for Raspberry Pi 5 works with the Pi 5 4GB and 8GB models only. The Raspberry Pi foundation released the 2GB models much later after WPSD was developed for the 4/8GB models. Note that we do not support the 2GB Pi 5 models!

TGIF Spots with Nextion Displays

WPSD disk image installations do work, however, you may lose some of the superfluous TGIF Spot Nextion Display functionality. If you install WPSD on TGIF Spots with Nextion displays, and the displays don’t work the way you want, don’t complain about it or ask us about it; as their strange software hacks2 are not a part of WPSD.

You can always load a different and stable Nextion layout file which requires no software hacks, however. But you’re on your own with these hotspot displays.

How to Contribute to the WPSD Project

There is a dedicated document explaining how to contribute to the WPSD project.

Credits

WPSD used to be a one-man show (me), but many people have contributed code, etc. to the project; and we also have an official WPSD Core Dev. Team. Thank you all! With the exponential growth, doing this alone would have sucked. I am grateful for all of you!

Of course, lots of credit goes to the venerable and skilled, Andy Taylor, MW0MWZ, for creating the wonderful Pi-Star software in the first place. Pi-Star was foundational to the creation of The WPSD Project.

The USA callsign lookup fallback function uses a terrific API, callook.info, provided by Josh Dick, W1JDD.

The callsign-to-country flag GeoLookup code was adopted from xlxd… authored by Jean-Luc Deltombe, LX3JL; and Luc Engelmann, LX1IQ. I run an XLX(d) reflector, plus, I was able to adopt some of its code for WPSD, ergo, I am very grateful. The excellent country flag images are courtesy of Hampus Joakim Borgos.

A big “thank you” goes to the amazing people/devs/sysadmins from the wonderful M17 Project for hosting the WPSD disk image mirror server!

So much credit goes toward the venerable José Uribe (“Andy”), CA6JAU, for his amazing work and providing the game-changing MMDVM_HS hotspot firmware suite, as well as his MMDVM_CM cross-mode suite.

Lastly, but certainly not least; I owe an enormous amount of gratitude toward a true gentleman, scholar and incredibly talented hacker…Jonathan Naylor, G4KLX; for the suite of MMDVM and related client tools. WPSD would have no reason to exist, without Jonathan’s incredible and prolific contributions and gifts to the ham community.

Project Name & Etymology

When WPSD was first released in late 2020, I named it “W0CHP-PiStar-Dash”, since it was a major fork to the popular Pi-Star software (the “OG Red Software”).

Over time, the project diverged and evolved exponentially from its humble beginnings. During this time, I, as well as other users simply called the software “WPSD” as an acronym, or shorthand for “W0CHP-PiStar-Dash”.

However, more time had passed, and the popularity plus the user install base had increased exponentially. This growth in popularity also garnered WPSD contributors, developers, volunteers and fans. By this time, many were already calling the software “WPSD”, so it stuck.

At the same token, the developers/volunteers and I had agreed that since the software is now truly its own; and that removing “Pi-Star” references from code, “branding”, etc. would behoove the project (and the users). By removing the old Pi-Star references, we thought that it would be fair to the original Pi-Star project, and help users understand that WPSD is in fact, very, very different.

Of course. WPSD is a now a recursive acronym! 😆

So, here we are today - WPSD is the name of the software suite and project. And WPSD is a completely and deliberately different acronym from what it started as; it is now a much-adorned recursive acronym:

WPSD = WPSD Plausibly Stands for Divergence

That’s right; WPSD stands for “WPSD Plausibly Stands for Divergence”. With the Keyword being ‘divergence’, because the project has, and continues to diverge, improve, and evolve from the “OG Red Software”.


  1. WPSD occasionally queries our servers in order to determine if updates are available. Our servers log these transactions, and the data is used for web server traffic capacity planning/analytics, as well as for troubleshooting user issues and bugs. This data is used internally, exclusively; and is not shared. If you do not want this data collected, simply do not install or use WPSD. 

  2. TGIFspots with Nextion displays are shipped with customizations; and this custom code is what makes some of the superflous functions of the TGIFspot displays operate the way they do. These customizations are not a part of, nor are they supported with WPSD; as some of it replaces and/or modifies core and crucial system software. 

Document Version: 2818a3d -- Last Revision: 12/11/2024
Permanent Link: <https://w0chp.radio/wpsd/>