wpsd-update
BannerH2
To help keep this web page small/quick, the WPSD screenshots are on their own page.
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.
If you have a first-generation Raspberry Pi Zero2 (Pi Zero (W) Rev.1.1 armv6l) with the single-core processor*, and have installed the RPi WPSD disk image, you need to do a couple of things before you can access it:
armv6l
If you fail to do these things, you will get a “502 Bad Gateway” error when attempting to access the dashboard.
If 30 minutes passes, and you still cannot access the dashboard, simply SSH into the hotspot and run:
sudo wpsd-update
* Note: The official ZUMSpot Mini 1.3 Disk Image (below) does not have this issue, since I built the disk image for that specific hardware.
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 hacks3 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.
Because WPSD uses much more modern and updated backend software, configuration backup/restores from the original Pi-Star software is incompatible for the most part, and is unsupported. It is always recommended that you use an appropriate WPSD disk image for your hardware, and setup/configure from scratch.
There is a dedicated document explaining how to contribute to the WPSD project.
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.
MW0MWZ
The USA callsign lookup fallback function uses a terrific API, callook.info, provided by Josh Dick, W1JDD.
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.
LX3JL
LX1IQ
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.
CA6JAU
MMDVM_HS
MMDVM_CM
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.
G4KLX
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”).
W0CHP-PiStar-Dash
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”.
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. ⤴
WPSD was not created for single-core and low-powered hardware; such as the first generation RPi Zero, etc. (armv6l). The dashboard will run slowly on under-powered hardware at times. Please consider yourself warned. Also, please ignore all of the hams on various support mediums saying, “anything more than a Pi Zero is overkill”. These ignoramuses have no idea what goes on under the hood in order to display meaningful info on the dashboard. Hint: it’s a lot, and it’s very resource-intensive. Ignore them…they have no idea what they are talking about. ⤴
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: 599ac61 -- Last Revision: 9/15/2024 Permanent Link: <https://w0chp.radio/wpsd/>
599ac61
<https://w0chp.radio/wpsd/>