deskHPSDR

This is an improved version based at the code of piHPSDR. But it is not piHPSDR itself and has no backward dependencies to piHPSDR. My goal was to make an optimzed version running with Desktop-OS like Linux and macOS, what means I don't support small displays less as 1280x600 like such for Raspberry Pi or similiar devices. In this case you need to use piHPSDR, but not my deskHPSDR.

My version here need a screen size 1280x600 at minimum or higher for best GUI experiences.

deskHPSDR start with the code base from piHPSDR

piHPSDR was first developed by John Melton, G0ORX/N6LYT a few years ago.
Later Christoph, DL1YCF, had continued the development of piHPSDR. His version https://github.com/dl1ycf/pihpsdr is the most up-to-date version of piHPSDR and is actively being developed by him up to now.

So his codebase of piHPSDR was my starting point end of October, 2024. But anyway, there is and will be no collaboration between piHPSDR and deskHPSDR, no interest from either side.

deskHPSDR go it's own way.

Requirements

• a modern Desktop-OS like Linux or macOS with installed developer tools like compiler, linker etc.
• a large screensize starts at 1280x600 or higher
• basic knowledge: how to use your OS, a shell, a text editor and how to compile applications from source code
• macOS only: please read the COMPILE.macOS first
• a SDR device or transceiver, which supports HPSDR protocol 1 (older) or 2 (newer) like the Hermes Lite 2, the ANAN or similiar devices
• a very good running network without any issues (Ethernet preferred, WiFi not recommended) and an DHCP server inside (without DHCP is possible too, but more complicated or difficult working with the SDR devices)

Important: For best desktop experience please select VFO bar for 1280px windows in the Menu->Screen (if not selected).

The further development of deskHPSDR

My work is not completed. I have some ideas, what I need to add too. You need to understand this branch as "work in progress". I ever check my code here with my test environment: Intel iMac 21" i5 and Macbook Air M1 running both with macOS 14.7.1 aka Sonoma and my SDR tranceiver Hermes-Lite 2 in combination with my homebrew-LDMOS-PA 600W. My focus is Fonie/SSB and Digimode/FT8+FT4, less CW. And - sorry guys - I have not the time to write any kind of manual for deskHPSDR. Use instead the published manual of DL1YCF's piHPSDR version for basic knowledge, how this application works in general.

Issues

I'm now activate the Issues tab, but please note the following:

• I ONLY accept error reports or runtime errors for this published codebase here. The Issues tab not suitable for discussion about other things except error messages or error reports.
  
• Don't ask about feature requests, questions about porting to other systems like WIN/MinGW and support for additional hardware - my answer will be ever NO. Such requests will be ignored and closed without any comment.
  
• first make a git pull for using the most up-to-date codebase, compile it, test it and THEN open an issue, if you think there's something wrong with the last codebase
  

Known problems

In the Makefile I add a comment "don't edit this Makefile". That's I mean so. I'm now add the editable, additional file for this called make.config.deskhpsdr.
But if you have such file yet or edit it and make after this a git pull , git maybe come back with an error message.
In this case try this:

$ mv make.config.deskhpsdr make.config.deskhpsdr.save
$ git pull
$ rm make.config.deskhpsdr
$ mv make.config.deskhpsdr.save make.config.deskhpsdr
$ git update-index --assume-unchanged make.config.deskhpsdr

After this, git pull should work correct.
Background about this: I made a mistake in the .gitignore, but I correct it in the meantime. git pull see local changes with this file (if edit) and stop working, because this file is not identical with the file from the upstream master branch.
git update-index --assume-unchanged make.config.deskhpsdr inform git, that this file need to be ignored in the future, so you can edit it how you need.
If this not help, please delete the complete codebase of deskHPSDR and clone it again, then you have a fresh copy.
Don't forget to edit make.config.deskhpsdr again for set your needed options. Don't change the DESKTOP=ON option, that MUST always be set to ON.

Successful and confirmed Tests I had done up to now

So far, deskHPSDR has been successfully tested on the following systems:

• iMac 21" i5 running macOS 14.7.1 aka Sonoma
• Macbook Air M1 running macOS 14.7.1 aka Sonoma
• Raspberry Pi5 with NVMe-HAT running 64bit PiOS and X11 environment
• Raspberry Pi 3B+ works too, but with limitations (panadapter framerate only 10fps, if want more the CPU hasn't enough power)
• a hamradio friend of mine has checked it on a Desktop Linux Ubuntu LTS for me, works too

All radio tests are made with my Hermes Lite 2 SDR-Transceiver.

Credits

Big thanks and huge respect to all involved developers for their previous great work on piHPSDR until now and make this application accessible as Open Source under the GPL.

Exclusion of any Guarantee and any Warrenty

This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

All what you do with this code is at your very own risk. The code is published "as it is" without right of any kind of support or similiar services.