Ghpsdr3 SDR project - User contributions [en]

Screenshots and Recordings

2012-05-15T07:20:49Z

SA5BKE: /* Various QtRadio Screenshots */

== Various QtRadio Recordings ==

Glenn's Windows QtRadio on an XP Virtual Machine: http://www.youtube.com/watch?v=0A5MaSYL6mk

Glenn demonstrating 3 connections to Kevin's server where the slaves follow master's tuning: http://www.youtube.com/watch?v=EAWkHErtO7U

Sid's Beagleboard XM and QtRadio on napan.ca - 8000 1 aLaw: http://www.youtube.com/watch?v=LB8Vxb07Ph8

Alex testing TX on the rxtx-event branch: http://www.youtube.com/watch?v=oc9TuJucD48&feature=related

Alex listening in on 15M in VE9 from Singapore: http://www.youtube.com/watch?v=X-pSa5cHq6A&feature=related

Alex listening in on 10M, kb0omm from Singapore: http://youtu.be/Rt8E0hHMwMY

Oliver's TX Signal received on 10 Meter by a Softrock RXTX: http://www.youtube.com/watch?v=vsIdDfSHsWA

Oliver - QtRadio Zapping on a new Server: http://www.youtube.com/watch?v=yY_mUzj357s

Android Client: http://www.youtube.com/watch?v=up-BEKxTTXs

Alex - Tx spectrum displayed: http://youtu.be/I4ya56LYUQ0

Oliver with UHFSDR TXing at 2-Meter: http://www.youtube.com/watch?v=Okx_tCu4hcs

Oliver rcv with UHFSDR on 70cm: http://www.youtube.com/watch?v=5qr9rmz0OSo

Oliver rcv with UHFSDR HO-68 Satellite in CW (95mW): http://www.youtube.com/watch?v=fwHSIyLsb54

Alberto IZ0CEZ with USRP: http://www.youtube.com/watch?v=mD9tUWV_Y-Q

Frank DG1SBG running QtRadio on OSX http://www.youtube.com/watch?v=LaWnr6Pn3ek

Rob, KL7NA's TX audio as recorded by Rit, N4BNM. http://people.wallawalla.edu/~rob.frohne/ghpsdr3-alex/KL7NA.wav

Alex connecting to kb3omm's rtl-sdr DVB-T stick: http://code.google.com/p/sdr-widget/downloads/detail?name=kb3omm-rtlsdr-NBFM.ogv&can=2&q=

and: http://code.google.com/p/sdr-widget/downloads/detail?name=kb3omm-rtlsdr-WBFM.ogv&can=2&q=

== Various QtRadio Screenshots ==
<gallery>
File:Qtradio-cqww-2011-sa5bke.png|QtRadio from CQWW October 2011 running in Ubuntu 10.04
File:QtRadioFedoraXFCE.png|QtRadio running on GNU Linux/Fedora 16 XFCE
File:QtRadioOnUbuntu-iw0hdv.png|QtRadio running on GNU Linux/Ubuntu
File:2011-11-26 CQWWCW qtradio ve9gj 28-MHz.jpg|QtRadio on Windows listening to CQWW CW
File:QtRadio-Fldigi.png| fldigi using QtRadio including Rig Control via hamlib
File:QtRadiowCQRLog.jpg| CQRLog and QtRadio working together via QtRadio's hamlib interface
File:Xoom+Stretch+Mode.png| aHPSDRgl running on a kb3omm's Motorola Xoom
</gallery>

== Ghpsdr3-usb-boot ==
<gallery>
File:Ghpsdr3-usb-boot_1.jpg
</gallery>

== How to make videos in Ubuntu ==

In Ubuntu videos are easily recorded with recordmydesktop.

<pre>
sudo apt-get install recordmydesktop
</pre>

Change to a terminal window and type:
<pre>
~$ recordmydesktop
</pre>
In pavucontrol select the wanted audio source.

Before you upload the recorded ogg video file to Youtube, it has to be converted:

<pre>
sudo apt-get install mencoder
</pre>
<pre>
mencoder foo.ogv -o foo.avi -oac mp3lame -lameopts fast:preset=standard -ovc lavc -lavcopts vcodec=mpeg4:vbitrate=4000
</pre>

== How to take screenshots in Ubuntu ==

[http://tips.webdesign10.com/how-to-take-a-screenshot-with-ubuntu-linux Taking Screenshots in Ubuntu ]

Main Page

2012-05-15T07:14:24Z

SA5BKE: sdr-widget group info

===[[What's New| What's New and latest news]]===
=== '''The ghpsdr3-alex Project''' ===

This is a modification of the excellent Software Defined Radio (SDR) software by John Melton [G0ORX/N6LYT][http://g0orx.blogspot.com]

The original software by John is called ghpsdr3. We are working towards merging the two projects (ghpsdr3 and ghpsdr3-alex) source trees to a single source. However BEFORE that happens, you CANNOT mix and match programs from the two projects. See note for HPSDR hardware users below.

Project README https://github.com/alexlee188/ghpsdr3-alex/blob/master/README [https://github.com/alexlee188/ghpsdr3-alex/blob/master/README]

Source Code is via git at https://github.com/alexlee188/ghpsdr3-alex [https://github.com/alexlee188/ghpsdr3-alex]

Discussions take place in the sdr-widget group http://groups.google.com/group/sdr-widget [http://groups.google.com/group/sdr-widget]

You can browse the list of online dspservers at http://qtradio.napan.ca/qtradio/qtradio.pl[http://qtradio.napan.ca/qtradio/qtradio.pl]

Currently it supports HPSDR, Softrock, UHFSDR, Microtelecom Perseus, SDR-iq, HiQSDR, Ettus Research USRP and rtl-sdr DVB-T dongles.

=== '''What is the actual ghpsdr3-alex Project software?''' ===

The software comprises 3 different components:

'''A)''' server - there is a CLI based server for each type of hardware. For example, there are hpsdr-server, usrp-server, softrock (server), sdriq-server, HiQSDR etc. Some servers are based on soundcard/USB connections to the hardware. Some are connected via ethernet (eg HPSDR Metis).

'''B)''' dspserver - this is the software in the middle that processes the IQ data from the server (connected over LAN via UDP) using DttSP. The same dspserver can connect to any of the servers in A.

'''C)''' clients - this is the GUI user interface. There are clients built with Qt and runs on Windows, Linux, and Mac OSX. There is a working Android client that works on Android phones and Android tablets. The clients connect to dspserver via LAN or remotely via Internet. In future we will have java based web clients as well (either specifically written clients, or running Qt inside a web browser) Also, multiple clients can concurrently access the same dspserver. There is also RxTx capability (currently for voice modes). the QtRadio client has a Hamlib interface and can connect to gPredict, xLog, and fldigi (for digital mode)

'''Project Goals'''

1. Open source (GPL) SDR software

2. Client-server network-enabled by design from the ground up

3. Customized server for each SDR hardware type. Currently supporting HPSDR, Softrock, UHFSDR, Microtelecom Perseus, RFSPACE SDR-IQ, HiQSDR and Ettus Research USRP.

4. Single dspserver that connects to single server. However, each server can have multiple Rx and Tx channels.

5. Multiple clients, such as QtRadio, that can concurrently connect to a single dspserver.

6. Full Rx and Tx capability for hardware capable of Tx

*[[Screenshots and Recordings]]
*[[QtRadio on Windows]]
*[[QtRadio - Operation]]
*[[QtRadio Installation]]
*[[aHPSDR]] Android Client
*[[Pulseaudio Setup]]
*[[Developers Documentation]]
*[[ToDo/- Wishlist]]
*[[dspserver.conf]]

'''Note for HPSDR and ghpsdr3 (original) users:'''
In general, you cannot mix and match software from the two projects, ghpsdr3 and ghpsdr3-alex. However, John has updated the programs in the ghpsdr3-alex repository, and the hpsdr-server program in gphsdr3-alex works for HPSDR hardware. The following newbie guide is written by Erich Heinzle (vk5hse at yahoo.com):

http://lists.openhpsdr.org/pipermail/hpsdr-openhpsdr.org/2011-December/016334.html[http://lists.openhpsdr.org/pipermail/hpsdr-openhpsdr.org/2011-December/016334.html]

RTL-SDR

2012-05-13T13:42:05Z

SA5BKE: No need to build rtlsdr-server separately

RTL-SDR is cheap and simple DVB and/or DAB receiver USB sticks that can be used as a SDR and can cover VHF and UHF frequencies. More information on this can be found at [http://sdr.osmocom.org/trac/wiki/rtl-sdr OsmoCom RTL-SDR] and [http://www.reddit.com/r/RTLSDR RTL-SDR community at Reddit] . Andrea IW0HDV has written a server for rtl-sdr to be used with Ghpsdr3-alex.

The steps needed to get it running is as follows:

1. Install rtlsdr library. Follow directions at: [http://sdr.osmocom.org/trac/wiki/rtl-sdr OsmoCom RTL-SDR] . Do not forget to run
<pre>
sudo ldconfig
</pre>

after it is installed.

2. Checkout iw0hdv branch :
<pre>
git checkout iw0hdv
</pre>

Then rebuild ghpsdr3-alex with instructions at [[QtRadio_Installation]].

3. If everything has installed ok you might try to insert your USB stick and start the rtlsdr-server. Cd to ghpsdr3-alex/trunk/src/rtlsdr and run:
<pre>
sudo ./rtlsdr-server -d3 -s250000
</pre>

4. Then start the dspserver:
<pre>
dspserver --lo 0
</pre>

5. If you want to try to listen to FM Broadcast stations there is no real WFM but NFM in QtRadio has a 80kHz wide filter that work quite ok.

Remember this is very experimental. Questions should go to the sdr-widget group.

What's New

2012-05-12T21:26:06Z

SA5BKE: RTL-SDR

===May 12 2012===
Experimental support for [[RTL-SDR]] available.

===May 4 2012===
* aHPSDR (opengl branch). This version uses opengl for waterfall display. Experimental. Uses opengl es v2.0 for waterfall display. Uses Orthographic 2D projection so should work in all devices in portrait and landscape orientations. With offloading of workload from CPU to GPU the app runs smoother and the audio is uninterrupted.

http://code.google.com/p/sdr-widget/downloads/detail?name=aHPSDRgl.apk&can=2&q=

===Apr 18 2012===
* New build of aHPSDR (opengl branch). Will only work with protocol-3 capable dspservers. This has improved spectrum/waterfall refresh rate. Work-in-progress in adding opengl code for waterfall display. May not work in older Android platforms.

Download: http://code.google.com/p/sdr-widget/downloads/detail?name=aHPSDR.apk&can=2&q=

===Apr 11 2012===
* The branch audio-testing was created for linux users who were having trouble with Qt's lack of sound in QtRadio. It seemed to be more of a problem with newer 64 bit installs. audio-testing bypasses QT for audio playback and calls pulse audio libs directly. You may have to direct sound to your proper sound device with pavucontrol.

===Apr 5 2012===
* Created an article on the Utilities & Add-ons page called: "Full featured recording script" unsing sox and rigctl (hamlib).

===Apr 4 2012===
* A new branch, opengl, has working QtRadio code that uses OpenGL shaders to compute and display the waterfall. The waterfall is actually a 3-D cube and you can pan/zoom with mouse drags on the waterfall display. Drag it all the way to one side and you can have a glimpse of the sides of the cube. The aim of this QtRadio is to offload work from the cpu to the gpu. If your system has a weak cpu (eg atom) and a powerful gpu (eg nvidia ION) it should reduce the cpu util significantly.

===Mar 18 2012===
* A new build for windows from the new protocol-3 branch is available at: http://napan.com/ve9gj/qtradio-protocol-3.zip (Built Mar 18 2012). This uses the new protocol-3 and should be able to connect with master and protocol-3 servers. Still experimental. It contains improvements to the spectrum and waterfall refresh rates for remote connections.

===Feb 25 2012===
* New Windows build of QtRadio (master branch) Download: http://napan.com/ve9gj/qtradio-master.zip
===Feb 19 2012===
* Graeme ZL2APV has coded CW receive in QtRadio to behave the same as Kenwood, Yaesu, K3 etc.
===Feb 18 2012===
* Frank DG1SBG has got QtRadio to run on Mac OS X 10.6.8 ! http://www.youtube.com/watch?v=LaWnr6Pn3ek
===Feb 17 2012===
* Bugfix to possible segfault in dspserver
===Feb 16 2012===
* New Windows build of QtRadio (master branch) Download: http://napan.com/ve9gj/qtradio-master.zip
===Feb 11 2012===
* The android client AHPSDR now has a Server list feature just like QtRadio. Look under the menu item Servers and select from among the active servers Download information on the [[AHPSDR]] page
* The branch to use for most users is now the master branch. This is the one that most dspservers are running
* Fixed SetTXAMCarrierLevel bug when tx ="all" in master branch
* Two key Rx audio functions into their own QThread in QtRadio. This should help lower spec'd PCs
* Fixed a bug where the band edge line in the spectrum display was off by the offset value of the dspserver.

RTL-SDR

2012-05-12T21:24:51Z

SA5BKE: Initial page about RTL-SDR

RTL-SDR is cheap and simple DVB and/or DAB receiver USB sticks that can be used as a SDR and can cover VHF and UHF frequencies. More information on this can be found at [http://sdr.osmocom.org/trac/wiki/rtl-sdr OsmoCom RTL-SDR] and [http://www.reddit.com/r/RTLSDR RTL-SDR community at Reddit] . Andrea IW0HDV has written a server for rtl-sdr to be used with Ghpsdr3-alex.

The steps needed to get it running is as follows:

1. Checkout iw0hdv branch :
<pre>
git checkout iw0hdv
</pre>

Then rebuild ghpsdr3-alex with instructions at [[QtRadio_Installation]].

2. Install rtlsdr library. Follow directions at: [http://sdr.osmocom.org/trac/wiki/rtl-sdr OsmoCom RTL-SDR] . Do not forget to run
<pre>
sudo ldconfig
</pre>

after it is installed.

3. Cd to ghpsdr3-alex/trunk/src/rtlsdr and run:
<pre>
autoreconf -i;./configure
make
</pre>

4. If everything has installed ok you might try to insert your USB stick and start the rtlsdr-server with:
<pre>
sudo ./rtlsdr-server -d3 -s250000
</pre>

5. The start the dspserver:
<pre>
dspserver --lo 0
</pre>

Remember this is very experimental. Questions should go to the sdr-widget group.

AHPSDR

2012-02-11T10:05:09Z

SA5BKE: new link for Android client

The latest APK to be installed in Android can usually be downloaded from [http://svn.tapr.org/listing.php?repname=OpenHPSDR+Main&path=%2Ftrunk%2FN6LYT%2Fghpsdr3%2Fbranches%2Fandroid%2FaHPSDR%2Fbin%2F&#a94c80ff871066a17707aadbebe8526db TAPR svn]

QtRadio Installation

2011-12-21T21:13:23Z

SA5BKE: RTP and network info

== Installation on Linux ==
The instructions below are for Debian based distributions like Ubuntu but you should be able to compile on any Linux distribution with the correct libraries installed.

=== Installation from PPA ===
For Ubuntu Users there are two PPAs for the binaries produced both from the master and rxtx-event branch, maintained by Andrea IW0HDV.
Supported versions are:
Ubuntu Lucid,
Ubuntu Natty,
Ubuntu Oneiric, and known to work, Linux Mint 11 

At the time of this writing, (Dec 3 2011) PPA release 2.2 is online (rxtx-event). 

This is the easiest way to install QtRadio, dspserver and the softrock server.
The code base is taken from the master branch and in the "about"
panel there is some additional information in order to show where the
source is coming from.

===== text mode installation =====
In order to add this repository to your apt system (U11.10, U11.04, U10.04) enter the following commands in a terminal:

====== rxtx-event branch ======
<pre>
sudo add-apt-repository ppa:andrew-montefusco/ghpsdr3rxtx
sudo apt-get update
sudo apt-get install ghpsdr3rxtx
</pre>

====== master branch ======
<pre>
sudo add-apt-repository ppa:andrew-montefusco/ghpsdr3
sudo apt-get update
sudo apt-get install ghpsdr3
</pre>

In case you want switch from a PPA to the other one, please remember to manually remove the old PPA file into directory /etc/apt/sources.list.d/ .

===== graphical installation =====

====== Ubuntu 11.04 and older ======
<ul>

<li>Start the Synaptic Package Manager from the ''System->Administration'' menu
<li>From the menu ''Settings'' select ''Repositories'', a dialog box ''Software Sources'' will be shown
<li>On the first pane ''Ubuntu Software'' check the ''Community-maintaned Open Source Software (universe)'' tick
<li>On the second pane ''Other Software'' click on the add button, and, in the dialog ''software-properties-gtk'' enter 
for master branch: 
'''ppa:andrew-montefusco/ghpsdr3'''

 for rxtx-event branch: 
'''ppa:andrew-montefusco/ghpsdr3rxtx'''

<li>Back to the ''Software sources'' dialog, press ''Close''
<li>Press the ''Reload'' button on the top bar of main window
<li>Press the ''Section'' button (bottom left pane) and next select ''Amateur Radio'' and, on the right pane, the ghpsdr3 package
<li>Press ''Apply'' button on the top bar: answer '''yes''', if so requested, in order to install the required dependencies
</ul>

 

====== Ubuntu 11.10 ======
<ul>
<li>Open the ''Ubuntu Software Center'' (from the 'shopper' icon on the left bar)
<li>Maximize the window, on the top bar the program menu will be shown
<li>Select the menu ''Edit->Software Sources'', a dialog box ''Software Sources'' will be shown
<li>On the first pane ''Ubuntu Software'' check the ''Community-maintaned Open Source Software (universe)'' tick
<li>On the second pane ''Other Software'' click on the add button, and, in the dialog ''software-properties-gtk'' enter 
for master branch: 
'''ppa:andrew-montefusco/ghpsdr3'''

 for rxtx-event branch: 
'''ppa:andrew-montefusco/ghpsdr3rxtx'''

<li>Press ''Close''
<li>Back to the ''Software sources'' dialog, press ''Close'' again
<li>Into the Search entry field (top right), write down 'ghpsdr3' and press Enter, or pull down the menu 'All Software', should be there too
<li>Click on the name 'ghpsdr3' in order to select it and press the 'Install' button
</ul>

If the program refuses to install ghpsdr3 complaining that the repository is not found, close it, start a terminal (Ctrl+Alt+T), run '''sudo apt-get update''' and retry with ''Ubuntu Software Center''.
 

You will then find the QtRadio app in the ''Applications'', ''Internet menu.'' If you have the ''Hamradio'' menu installed you will find it there also. 
Subsequently you can use the Ubuntu software update process to update to the latest ppa version. 
More information about Andrea's PPA is at

https://launchpad.net/~andrew-montefusco/+archive/ghpsdr3

https://launchpad.net/~andrew-montefusco/+archive/ghpsdr3rxtx

=== Installation from Git ===
Installing from git involves building or compiling from source. This is required if you want to use one of the various branches to work the "bleeding edge" branches like Alex's rxtx-event branch where the current (Nov 12 2011) TX work is being done.
The PPA install is never more than a few days behind master so there is not much to gain from building from git unless you want to work with the source code your self.

==== Installing compiler and autotool ====

First off, install the compiler; depending on which distribution are you using, some or all of this stuff could be already installed:

===== Ubuntu/Debian =====
<pre>
sudo apt-get install make gcc g++
sudo apt-get install autoconf automake autotools-dev libtool git subversion
</pre>

===== Fedora =====
<pre>
sudo yum install gcc gcc-c++ man-pages autoconf automake subversion libtool git
</pre>

==== Installing prerequisite packages ====

===== Ubuntu 11.04 and older =====
First of all, you have to check that the ''universe repository'' is enabled.
Please see the procedure in the previous section [[#graphical installation]] .

Next, you will need the following packages installed:

<pre>
sudo apt-get update
sudo apt-get install \
libqt4-opengl-dev \
qtmobility-dev \
libusb-0.1-4 \
libusb-dev \
libfftw3-dev \
portaudio19-dev \
libpulse-dev \
libsamplerate0-dev \
libusb-1.0-0-dev \
libconfig8-dev \
libortp-dev
</pre>

===== Ubuntu 11.10 =====
First of all, you have to check that the ''universe repository'' is enabled.
Click on the gear shaped icon (bottom into left side bar): the ''System Settings'' menu will shown, click on ''Software Sources'' and finally check the ''Community-maintaned Open Source Software (universe)'' tick.
Next, submit the following commands into a terminal window:

<pre>
sudo apt-get update
sudo apt-get install \
libqt4-opengl-dev \
qtmobility-dev \
libusb-0.1-4 \
libusb-dev \
libfftw3-dev \
portaudio19-dev \
libpulse-dev \
libsamplerate0-dev \
libusb-1.0-0-dev \
libconfig8-dev \
xdg-utils \
libortp-dev
</pre>

===== Fedora 16 =====

<pre>
sudo yum install fftw fftw-devel
sudo yum install libusb-devel libusb1-devel
sudo yum install portaudio-devel
sudo yum install libconfig-devel
sudo yum install libsamplerate-devel
sudo yum install pulseaudio-libs-devel
sudo yum install jack-audio-connection-kit jack-audio-connection-kit-devel
sudo yum install qt4-devel
</pre>

==== Cloning the repository ====

How to build the latest rxtx-event branch on Ubuntu 11.04

First a new libevent will need to be downloaded and installed, then the actual QtRadio source can be downloaded and built.

==== Obtaining an up-level libevent library ====

For the rxtx-event branch of the software, you will also need a version of libevent that is newer than what
is available from the Ubuntu distribution. Go to synaptic and completely remove the stock libevent (v1.4) from Ubuntu. (Completely remove is an uninstall option in Synaptic. Additional dependent libraries may also be removed)

Then download the new version from:

http://libevent.org/

libevent-2.0.15-stable.tar.gz

<pre>
wget https://github.com/downloads/libevent/libevent/libevent-2.0.15-stable.tar.gz
</pre>

Move the tarball from the Downloads directory to a working directory. A suggestion is to create a src directory within your home directory and move it there. Uncompress and follow the instructions to build and install:

<pre>
cd
tar -zxvf libevent-2.0.15-stable.tar.gz
cd libevent-2.0.15-stable
./configure
make
sudo make install
sudo ldconfig
</pre>

On Fedora, in order to use the library above, export the LD_LIBRARY_PATH:

<pre>
export LD_LIBRARY_PATH=/usr/local/lib
</pre>

==== Installing codec2 low bit rate audio encoding and decoding ====

We are adding a low bit rate audio codec called codec 2 to QtRadio/dspserver. You need
to download and build the codec2 library. See:

http://www.rowetel.com/blog/?page_id=452

Now go get codec2 using subversion

<pre>
cd
svn co https://freetel.svn.sourceforge.net/svnroot/freetel/codec2
cd codec2
autoreconf -i
./configure
make
sudo make install
sudo ldconfig
</pre>

On Fedora, in order to use the library above, export the LD_LIBRARY_PATH:

<pre>
export LD_LIBRARY_PATH=/usr/local/lib
</pre>

==== Building the rxtx-event branch ====

This branch is the latest code that contains both RX and TX capability.

Create a new directory or cd to the ~/src directory created for libevent and cd into it.

<pre>
git clone git://github.com/alexlee188/ghpsdr3-alex
</pre>

Depending on your Internet connection thorughput, it will take several minute to download.
cd into the new directory ghpsdr3-alex:
<pre>
cd ghpsdr3-alex
git checkout rxtx-event
</pre>
You are now working with Alex's latest and greatest!
<pre>
autoreconf -i
./configure
make -j4 all
sudo make install
</pre>
(If you do not want to actually install the executable binaries, skip the sudo make install and just cd into the following directories and run them from there)
<pre>
Terminal 1
$ cd ghpsdr3-alex/trunk/src/softrock
$ ./softrock ...options ...

Terminal 2
$ cd ghpsdr3-alex/trunk/src/dspserver
$ ./dspserver ..options...

Terminal 3
$ cd ghpsdr3-alex/trunk/src/QtRadio
$ ./QtRadio
</pre>

==== Building the Perseus extensions ====

In order to build the Microtelecom Perseus server you need to switch to the master branch.
This branch contains only RX capability and his client/server protocol is not compatible with that of rxtx-event branch.

First off, download, compile and install the library libperseus-sdr:

<pre>
sudo apt-get install subversion
cd
svn checkout http://libperseus-sdr.googlecode.com/svn/tags/REL-0.5 libperseus-sdr
cd libperseus-sdr
./bootstrap.sh
./configure && make -j4
sudo make install
</pre>

Next, install the other prerequisite library:

<pre>
sudo apt-get install liboost-dev
</pre>

If you already build in your sandbox some other branch, is strongly advisable, before you start the build, to do a full cleanup:
<pre>
cd ~/ghpsdr3-alex
make distcheck && sh cleanup.sh
</pre>

Otherwise, if you are starting from scratch, first clone the repository:

<pre>
git clone git://github.com/alexlee188/ghpsdr3-alex
</pre>

Finally, you can switch to the master branch and rebuild everything, enabling the perseus server feature:
<pre>
cd ~/ghpsdr3-alex
git checkout master
autoreconf -i && ./configure --enable-perseus=yes && make -j4
sudo make install
</pre>

In order to run it you have two choices, the first one being the plain command line:

<pre>
xterm -e 'perseus_server -d3 -s96000' &
xterm -e 'dspserver --lo 0' &
$(export QT_RADIO_NO_LOCAL_AUDIO=1 ; ./QtRadio )
</pre>

In QtRadio, Receiver menu, select Configure item, Server tab: here add the local host using the 127.0.0.1 IP address.
Pressing the key C, you start the receiver.

The second choiche is to use the ghpsdr3-mgr.py script (available in menu Applications, Hamradio as ghpsdr3launcher): clicking on the Perseus icon the three processes should start and the QtServer automatically connects to Perseus Server.

==== Refresh to a Newer Version ====

To pull a new version to build
<pre>
$ git pull
$ make all
$ sudo make install
</pre>

== Installation on Windows ==
See [[ QtRadio on Windows]]

== Network settings ==
If you are behind a firewall/NAT-router and want to be able to connect to your dspserver over the Internet you have to open up port tcp/8000. If you are using the client in RTP mode you have to open up udp/5004 and udp/5005.

Pulseaudio Setup

2011-12-11T19:06:54Z

SA5BKE: /* Enable network mode */

== Set audio levels with Pavucontrol ==
To configure the softrock server with your soundcard for IQ processing use:
<pre>
pavucontrol
</pre>

In order to install it, submit the following command:

<pre>
sudo apt-get install pavucontrol
</pre>

Choose your Soundcard for IQ processing. If you are running the SDR-Widget your settings should look like in the following two pictures.
=== TX audio levels on the softrock server ===

[[File:Playback.png]]
=== RX audio levels on the softrock server ===

[[File:Recording.png]]

'''Make sure not to set the RX Audio level in the Recording Tab of pavucontrol to 100%. Otherwise you could have audio feedthrough from RX to TX and a distorted TX Audio. A level from 22% - 80% would be ok, but may vary on each system.'''

== Enable network mode ==
You also need to run pulse in network mode. Use:
<pre>
paprefs
</pre>

In order to install it, submit the following command:

=== Ubuntu ===
<pre>
sudo apt-get install paprefs
</pre>

=== Fedora 16 ===
<pre>
sudo yum install pulseaudio-module-zeroconf
sudo yum install paprefs
pulseaudio -k ; pulseaudio -D --log-target=syslog
</pre>

to set up network access by checking the various option boxes as follows:

[[File:PulseAudio_Preferences_036.png]]

 

[[File:PulseAudio_Preferences_037.png]]

If you are not able to change the network options you might be able to solve it with this workaround. See bug report for Ubuntu 11.10 [https://bugs.launchpad.net/ubuntu/+source/paprefs/+bug/829051].

<pre>
sudo ln -s /usr/lib/pulse-1.0 /usr/lib/pulse-1.0.0
</pre>

=== Pulseaudio Setup independant on a X-Server installation ===
==== Add Username to /etc/group ====
Make sure you add your username to the following system groups:
<ul>
<li>pulse
<li>pulse-access
<li>audio
</ul>

Use the following commands: ($USER stands for current logged in user) 
<pre>
sudo adduser $USER pulse
sudo adduser $USER pulse-access
sudo adduser $USER audio
</pre>

Example, for the user dl6kbg the grup file must contain:
<pre>
grep dl6kbg /etc/group
...
audio:x:29:pulse,dl6kbg
pulse:x:119:dl6kbg
pulse-access:x:120:dl6kbg
...
</pre>
==== Enable Pulseaudio Daemon to run in system wide mode ====
<pre>
sudo nano /etc/default/pulseaudio
</pre>

change settings to:

<pre>
PULSEAUDIO_SYSTEM_START=1
DISALLOW_MODULE_LOADING=0
</pre>
==== Enable network mode ====
<pre>
sudo nano /etc/pulse/system.pa
</pre>

and add:

<pre>
load-module module-native-protocol-tcp auth-anonymous=1
</pre>

Restart pulseaudio:
<pre>
sudo /etc/init.d/pulseaudio restart
</pre>

or restart the system and fire up the softrock server.
Pulseaudio runs now in systemwide mode and your softrock server should be able to establish a connection
to your following dspserver.

== Configure Pulseaudio Daemon ==

In order to use 96000 or 192000, you will need to configure pulse audio by editing:
<pre>
/etc/pulse/daemon.conf
</pre>

Uncomment these settings and change it for your needs.

Example:
<pre>
default-sample-format = s24le
default-sample-rate = 192000
</pre>

== Tweak System for realtime performance ==

For realtime audio add the following to:
<pre>
/etc/security/limits.conf
</pre>

<pre>
@audio - rtprio 99
@audio - memlock unlimited
</pre>
and reboot and enjoy your system.

Screenshots and Recordings

2011-11-26T16:46:26Z

SA5BKE: Added Windows screenshot of QtRadio

== Various QtRadio Recordings ==

Glenn's Windows QtRadio on an XP Virtual Machine: http://www.youtube.com/watch?v=0A5MaSYL6mk

Sid's Beagleboard XM and QtRadio on napan.ca - 8000 1 aLaw: http://www.youtube.com/watch?v=LB8Vxb07Ph8

Alex testing TX on the rxtx-event branch: http://www.youtube.com/watch?v=oc9TuJucD48&feature=related

Alex listening in on 15M in VE9 from Singapore: http://www.youtube.com/watch?v=X-pSa5cHq6A&feature=related

Alex listening in on 10M, kb0omm from Singapore: http://youtu.be/Rt8E0hHMwMY

Oliver's TX Signal received on 10 Meter by a Softrock RXTX: http://www.youtube.com/watch?v=vsIdDfSHsWA

Oliver - QtRadio Zapping on a new Server: http://www.youtube.com/watch?v=yY_mUzj357s

Android Client: http://www.youtube.com/watch?v=up-BEKxTTXs

Alex - Tx spectrum displayed: http://youtu.be/I4ya56LYUQ0

== Various QtRadio Screenshots ==
<gallery>
File:Qtradio-cqww-2011-sa5bke.png|QtRadio from CQWW October 2011 running in Ubuntu 10.04
File:QtRadioFedoraXFCE.png|QtRadio running on GNU Linux/Fedora 16 XFCE
File:QtRadioOnUbuntu-iw0hdv.png|QtRadio running on GNU Linux/Ubuntu
File:2011-11-26 CQWWCW qtradio ve9gj 28-MHz.jpg|QtRadio on Windows listening to CQWW CQ
</gallery>

== How to make videos in Ubuntu ==

In Ubuntu videos are easily recorded with recordmydesktop.

<pre>
sudo apt-get install recordmydesktop
</pre>

Change to a terminal window and type:
<pre>
~$ recordmydesktop
</pre>
In pavucontrol select the wanted audio source.

Before you upload the recorded ogg video file to Youtube, it has to be converted:

<pre>
sudo apt-get install mencoder
</pre>
<pre>
mencoder foo.ogv -o foo.avi -oac mp3lame -lameopts fast:preset=standard -ovc lavc -lavcopts vcodec=mpeg4:vbitrate=4000
</pre>

== How to take screenshots in Ubuntu ==

[http://tips.webdesign10.com/how-to-take-a-screenshot-with-ubuntu-linux Taking Screenshots in Ubuntu ]

File:2011-11-26 CQWWCW qtradio ve9gj 28-MHz.jpg

2011-11-26T16:44:34Z

SA5BKE: QtRadio on Windows connected to VE9GJs server.

QtRadio on Windows connected to VE9GJs server.

AHPSDR

2011-11-25T09:16:47Z

SA5BKE: Created page with "The latest APK to be installed in Android can usually be downloaded from http://g0orx.dyndns.org/ ."

The latest APK to be installed in Android can usually be downloaded from http://g0orx.dyndns.org/ .

Main Page

2011-11-25T09:15:02Z

SA5BKE: Link to Android client

=== '''The ghpsdr3-alex Project''' ===

This is a modification of the excellent Software Defined Radio (SDR) software by John Melton ([G0ORX/N6LYT][http://g0orx.blogspot.com]

The original software by John is called ghpsdr3. We are working towards merging the two projects (ghpsdr3 and ghpsdr3-alex) source trees to a single source. However BEFORE that happens, you CANNOT mix and match programs from the two projects. See note for HPSDR hardware users below.

Project README https://github.com/alexlee188/ghpsdr3-alex/blob/master/README [https://github.com/alexlee188/ghpsdr3-alex/blob/master/README]

Source Code is via git at https://github.com/alexlee188/ghpsdr3-alex [https://github.com/alexlee188/ghpsdr3-alex]

'''Project Goals'''

1. Open source (GPL) SDR software

2. Client-server network-enabled by design from the ground up

3. Customized server for each SDR hardware type. Currently supporting HPSDR, Softrock, Microtelecom Perseus, and Ettus Research USRP.

4. Single dspserver that connects to single server. However, each server can have multiple Rx and Tx channels.

5. Multiple clients, such as QtRadio, that can concurrently connect to a single dspserver.

6. Full Rx and Tx capability for hardware capable of Tx

*[[Screenshots and Recordings]]
*[[QtRadio on Windows]]
*[[QtRadio - Operation]]
*[[QtRadio Installation]]
*[[aHPSDR]] Android Client
*[[Pulseaudio Setup]]
*[[Developers Documentation]]
*[[ToDo/- Wishlist]]

'''Note for HPSDR and ghpsdr3 (original) users:'''
In general, you cannot mix and match software from the two projects, ghpsdr3 and ghpsdr3-alex. However, John has updated the programs in the ghpsdr3-alex repository, and the "server" program works for HPSDR hardware (for Rx only currently, Tx coming shortly). We are using John's new binary header format so the dspserver is NOT compatible with "old" software from ghpsdr3. Use the "new" header format software from the ghpsdr3-alex repository. We also have a ppa for Linux and Windows versions of QtRadio. The "new" Android client and Java client from John will also work with the gphsdr3-alex dspserver.

Screenshots and Recordings

2011-11-21T18:09:04Z

SA5BKE: Added Android Youtube Video

== Various QtRadio Recordings ==

Glenn's Windows QtRadio on an XP Virtual Machine: http://www.youtube.com/watch?v=0A5MaSYL6mk

Sid's Beagleboard XM and QtRadio on napan.ca - 8000 1 aLaw: http://www.youtube.com/watch?v=LB8Vxb07Ph8

Alex testing TX on the rxtx-event branch: http://www.youtube.com/watch?v=oc9TuJucD48&feature=related

Alex listening in on 15M in VE9 from Singapore: http://www.youtube.com/watch?v=X-pSa5cHq6A&feature=related

Oliver's TX Signal received on 10 Meter by a Softrock RXTX: http://www.youtube.com/watch?v=vsIdDfSHsWA

Oliver - QtRadio Zapping on a new Server: http://www.youtube.com/watch?v=yY_mUzj357s

Android Client: http://www.youtube.com/watch?v=up-BEKxTTXs

== Various QtRadio Screenshots ==
<gallery>
File:Qtradio-cqww-2011-sa5bke.png|QtRadio from CQWW October 2011 running in Ubuntu 10.04
File:QtRadioFedoraXFCE.png|QtRadio running on GNU Linux/Fedora 16 XFCE
File:QtRadioOnUbuntu-iw0hdv.png|QtRadio running on GNU Linux/Ubuntu
</gallery>

== How to make videos in Ubuntu ==

In Ubuntu videos are easily recorded with recordmydesktop.

<pre>
sudo apt-get install recordmydesktop
</pre>

Change to a terminal window and type:
<pre>
~$ recordmydesktop
</pre>
In pavucontrol select the wanted audio source.

Before you upload the recorded ogg video file to Youtube, it has to be converted:

<pre>
sudo apt-get install mencoder
</pre>
<pre>
mencoder foo.ogv -o foo.avi -oac mp3lame -lameopts fast:preset=standard -ovc lavc -lavcopts vcodec=mpeg4:vbitrate=4000
</pre>

== How to take screenshots in Ubuntu ==

[http://tips.webdesign10.com/how-to-take-a-screenshot-with-ubuntu-linux Taking Screenshots in Ubuntu ]

Pulseaudio Setup

2011-11-15T05:27:25Z

SA5BKE: Adding info on paprefs bug in 11.10

== Set audio levels with Pavucontrol ==
To configure the softrock server with your soundcard for IQ processing use:
<pre>
pavucontrol
</pre>

In order to install it, submit the following command:

<pre>
sudo apt-get install pavucontrol
</pre>

Choose your Soundcard for IQ processing. If you are running the SDR-Widget your settings should look like in the following two pictures.
=== TX audio levels on the softrock server ===

[[File:Playback.png]]
=== RX audio levels on the softrock server ===

[[File:Recording.png]]

'''Make shure not to set the RX Audio level in the Recording Tab of pavucontrol to 100%. Otherwise you could have audio feedthrough from RX to TX and a distorted TX Audio. A level from 22% - 80% would be ok, but may vary on each system.'''

== Enable network mode ==
You also need to run pulse in network mode. Use:
<pre>
paprefs
</pre>

In order to install it, submit the following command:

<pre>
sudo apt-get install paprefs
</pre>

to set up network access by checking the various option boxes.

If you are using Ubuntu 11.10 there i a bug [https://bugs.launchpad.net/ubuntu/+source/paprefs/+bug/829051] that can be worked around by running this command:

<pre>
sudo ln -s /usr/lib/pulse-1.0 /usr/lib/pulse-1.0.0
</pre>

=== Pulseaudio Setup independant on a X-Server installation ===
==== Add Username to /etc/group ====
Make sure you add your username to the following system groups:
<ul>
<li>pulse
<li>pulse-access
<li>audio
</ul>

Use the following commands: ($USER stands for current logged in user) 
<pre>
sudo adduser $USER pulse
sudo adduser $USER pulse-access
sudo adduser $USER audio
</pre>

Example, for the user dl6kbg the grup file must contain:
<pre>
grep dl6kbg /etc/group
...
audio:x:29:pulse,dl6kbg
pulse:x:119:dl6kbg
pulse-access:x:120:dl6kbg
...
</pre>
==== Enable Pulseaudio Daemon to run in system wide mode ====
<pre>
sudo nano /etc/default/pulseaudio
</pre>

change settings to:

<pre>
PULSEAUDIO_SYSTEM_START=1
DISALLOW_MODULE_LOADING=0
</pre>
==== Enable network mode ====
<pre>
sudo nano /etc/pulse/system.pa
</pre>

and add:

<pre>
load-module module-native-protocol-tcp auth-anonymous=1
</pre>

Restart pulseaudio:
<pre>
sudo /etc/init.d/pulseaudio restart
</pre>

or restart the system and fire up the softrock server.
Pulseaudio runs now in systemwide mode and your softrock server should be able to establish a connection
to your following dspserver.

== Configure Pulseaudio Daemon ==

In order to use 96000 or 192000, you will need to configure pulse audio by editing:
<pre>
/etc/pulse/daemon.conf
</pre>

Uncomment these settings and change it for your needs.

Example:
<pre>
default-sample-format = s24le
default-sample-rate = 192000
</pre>

== Tweak System for realtime performance ==

For realtime audio add the following to:
<pre>
/etc/security/limits.conf
</pre>

<pre>
@audio - rtprio 99
@audio - memlock unlimited
</pre>
and reboot and enjoy your system.

Screenshots and Recordings

2011-11-12T12:28:42Z

SA5BKE: Reorganized headings

QtRadio Installation

2011-11-12T09:46:56Z

SA5BKE: Windows download link fix

== Installation on Linux ==
Supported versions are:
Ubuntu Lucid
Ubuntu Natty
etc.
=== Installation from PPA ===
=== Installation from Git ===
==== Installing Git ====
==== Cloning the repository ====
== Installation on Windows ==
[[QtRadio]], the client, is available on Windows for RX. A zip can be downloaded from: http://napan.com/ve9gj/qtradio.zip

Unzip to any folder and run the qtradio.exe file. It does not need an actual install, just the included dll files in the same folder.

QtRadio Installation

2011-11-12T09:44:50Z

SA5BKE: Added download instructions for Windows client

== Installation on Linux ==
Supported versions are:
Ubuntu Lucid
Ubuntu Natty
etc.
=== Installation from PPA ===
=== Installation from Git ===
==== Installing Git ====
==== Cloning the repository ====
== Installation on Windows ==
[[QtRadio]], the client, is available on Windows for RX. A zip can be downloaded from:
[[http://napan.com/ve9gj/qtradio.zip|http://napan.com/ve9gj/qtradio.zip]]

Unzip to any folder and run the qtradio.exe file. It does not need an actual install, just the included dll files in the same folder.

Screenshots and Recordings

2011-11-12T09:02:47Z

SA5BKE: Added image to screenshot gallery

File:Qtradio-cqww-2011-sa5bke.png

2011-11-12T08:16:48Z

SA5BKE: A screenshot of QtRadio from 29 Oct 2011.

A screenshot of QtRadio from 29 Oct 2011.