Ghpsdr3 SDR project - User contributions [en]

QtRadio Installation

2017-06-14T22:03:18Z

Kl7na: /* For Ubuntu 16.04, 17.10 and (maybe) Later */

== 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 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 12.04 =====
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-maintained 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 \
gcc-multilib \
libssl-dev \
libevent-dev \
libglu1-mesa-dev \
freeglut3-dev \
cmake \
libspeexdsp-dev \
libxcb-composite0-dev

### libspeexdsp-dev is only required for codec2-dev. DO NOT USE codec2-dev - it is the development branch and may or may not work as the developers have warned --- use "codec2" which is the stable branch.

</pre>

You will need qt5 installed to complete the build.

Visit: http://qt-project.org/downloads

download the current package for your system.

To build Qt5 on a RaspberryPi visit: http://qt-project.org/wiki/RaspberryPi

After downloading it go to the download directory and do:
<pre>
$ chmod +x the-name-of-the-downloaded-file
$ sudo ./the-name-of-the-downloaded-file
</pre>

Simply click on the installer and follow the prompts, take note of were qt5 is installed. Don't open the readme or start QtCreator when the installer asks. It will make some files in your home directory owned by root, and that will give you trouble later. After the install has completed, from a terminal:
<pre>
$ export PATH=/opt/Qt5.1.0/5.1.0/gcc_64/bin:/opt/Qt5.1.0/Tools/QtCreator/bin:$PATH
</pre>
In the above make sure you put in the correct path for your version of Qt. This is due because the several packages from Qt sources and binary repositories web sites are not really installed in the system but simply copied on it. Therefore the autotools build system should search virtually over the whole filesystem.
In any case please remember that
the export above is effective only into the current terminal windows, if you open another window and/or reboot the system, you have to resubmit again the command
if you want to make permanent it, you have to add the export into the right configuration shell, suitable for the shell that you are currently using.
For the bash it is typically ~/.bashrc
In any case, after you issue the export, please test it.
<pre>
qmake -v
QMake version 2.01a
Using Qt version 4.8.0 in /home/andrew/QtSDK4.8x/Desktop/Qt/4.8.0/gcc/lib
</pre>

==== For Ubuntu 16.04, 17.10 and (maybe) Later ====
This will allow you to build using just Ubuntu packages, (without installing the Qt development kit it /opt as described above). At least it worked for me on an Odroid C1 running Ubuntu 16.04.1 and 17.10.
First install dependencies using this:
<nowiki>
$ sudo apt-get update; sudo apt-get install libtool autoconf portaudio19-dev libfftw3-dev libcodec2-dev libpulse-dev libusb-dev libconfig8-dev libusb-1.0-0-dev libevent-dev libevent-openssl-2.0-5 libssl-dev libortp-dev qtbase5-dev qtmultimedia5-dev libsamplerate0-dev qtdeclarative5-dev</nowiki>
Then test and make sure that qt5 is selected. You check that with:
<nowiki>
$ qmake -v </nowiki>
If it is not version 5.something, then:
<nowiki>
$ export QT_SELECT=qt5 </nowiki>
Then you need to get autotools to reconfigure it:
<nowiki>
$ autoreconf -i</nowiki>
Then
<nowiki>
$ ./configure; make -j4; sudo make install</nowiki>
===== 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 \
cmake
</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 \
cmake
</pre>

===== Fedora 16 and newer ** AVOID CentOS ** It is not a Desktop OS =====

<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
sudo yum install libevent
sudo yum install libevent-devel
sudo yum install cmake

Qt5 is needed to build QtRadio. If the distro does not include qt5, follow the build instructions in the section ODROID - OK for all platforms.
Check if Qt5 is supplied "sudo yum install qt5*" - it is available in Fedora 20.
</pre>

==== Cloning the repository ====

How to build the latest master 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 ====

$ sudo apt-get install libevent-dev

If the version is older than 2.0.5, go to synaptic and completely remove the stock libevent 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.16-stable.tar.gz

<pre>
wget https://github.com/downloads/libevent/libevent/libevent-2.0.16-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.16-stable.tar.gz
cd libevent-2.0.16-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>
svn co https://svn.code.sf.net/p/freetel/code/codec2 codec2
cd codec2

mkdir build
cd build
cmake ../

sudo make
sudo make install
sudo ldconfig
</pre>

On some variations codec2 files will not be detected as installed correctly; if build errors citing codec2 are encountered during the later ./configure steps:

<pre>
cd /usr/local/include/codec2

sudo cp * ..
</pre>

'''IMPORTANT NOTE: If build errors persist referencing any codec2 missing components, please consider http://napan.ca/ghpsdr3/index.php/QtRadio_Installation#Refresh_to_a_Newer_Version procedure before continuing.'''

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 master 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 master
</pre>
You are now working with Alex's latest and greatest!

First set the path to the version of qt you are using. E.g. for qt5:
<pre>
$ export PATH=/opt/qt5/bin:$PATH
</pre>

Then:
<pre>
autoreconf -i
./configure.sh
make -j4 all
sudo make install
</pre>
The default configure above builds with debug and default Qt4 version in your PC. For optimized executable,
you need to specify options specific to your system. See the sample shell scripts that replaces the above
./configure step:

<pre>
./alex-conf.sh if you have problems finding codec2
./alex-avx-conf.sh for building with i3,i5 and i7 cpu's supporting Advanced Vector Extensions (AVX)
./alex-openmp-conf.sh for building with i3,i5 and i7 cpu's and OpenMP support
./alex-sse3-conf.sh for building with SSE3 capable cpu's
./alex-openmp-sse3-conf.sh for building with SSE3 cpaable cpu's and OpenMP support
</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 or iw0hdv branch.

First off, install the prerequisite library and wget package:

<pre>
sudo apt-get install libboost-all-dev wget
</pre>

Next download, compile and install the library libperseus-sdr:

<pre>
cd
wget http://libperseus-sdr.googlecode.com/files/libperseus_sdr-0.6.tar.gz
tar -zxvf libperseus_sdr-0.6.tar.gz
cd libperseus_sdr-0.6/
./configure && make
sudo make install
sudo ldconfig
</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, you have to clone the repository:

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

Finally, you can switch to the master branch and rebuild everything; you don't need anymore to explicitly enable the perseus server feature, the configure script automatically selects it when the libperseus_sdr is found.

<pre>
cd ~/ghpsdr3-alex
git checkout master
autoreconf -i && ./configure && 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 ' &
sleep 3
xterm -e 'dspserver --lo 0 --nocorrectiq' &
sleep 5
$( QtRadio -s 127.0.0.1 )
</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.

==== Building USRP enabled version ====

===== Building the UHD package =====

====== Install the prerequisite packages (Ubuntu 11.10): ======

<pre>
sudo apt-get install liboost-all-dev
sudo apt-get install python-cheetah
</pre>

====== Build & Install UHD -- FOR UHD-3.3.1 AND GREATER --: ======

<pre>
cd
git clone git://ettus.sourcerepo.com/ettus/uhd.git
cd uhd/host/
mkdir build
cd build
cmake ../
make
make test
sudo make install
sudo ldconfig
</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 usrp server feature:
<pre>
cd ~/ghpsdr3-alex
git checkout usrp-server
autoreconf -i && ./configure --enable-usrp=yes && make -j4
sudo make install
</pre>

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

To pull a new version to build
<pre>
$ git pull
$ make -j4 all
$ sudo make install
</pre>
If extensive changes have occurred or if you get errors during the make, you may want to do a clean build
<pre>
$ git pull
$ make distclean
$ sh cleanup.sh
$ autoreconf -i
$ ./configure
$ make -j4 all
$ sudo make install
</pre>
If you continue to get errors, please report the whole ./configure output and the config.log to the mailing list.

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

==VirtualBox Easy Installation==

It is possible to run the server software (and QtRadio) under VirtualBox. It has been tested with HPSDR Hermes hardware. [http://people.wallawalla.edu/~Rob.Frohne/ghpsdr3-alex/Ubuntu%2012.10%20ghpsdr3-alex-hermes.zip A VirtualBox Ubuntu 12.10 image] is available that automatically starts the server software for those who are running Windows, or don't feel they have the hardware, expertise or time to setup a Linux machine to act as a server. The username is: "ubuntu" and the password: "hamradio", which is probably a good thing to change soon after installation. Basically, all you need to do is follow the instructions below, plug your HPSDR Hermes or Apache Labs ANAN series transceivers into the network with the server, and you can be using ghpsdr3-alex on your own server. Users of older HPSDR hardware may need to make slight variations such as configuring USB in VirtualBox, specifying different command line arguments to the automatically started server commands, etc, but you won't have to build the software, or install Linux, or get another computer just to run the ghpsdr3-alex server software.

To get started, download the [http://people.wallawalla.edu/~Rob.Frohne/ghpsdr3-alex/Ubuntu%2012.10%20ghpsdr3-alex-hermes.zip VirtualBox image] (about 2.7 GB), unzip it, start [https://www.virtualbox.org/ VirtualBox], select the blue new button for the new machine, follow the wizard's instructions. When it asks you about the hard drive, say use existing virtual hard drive file, and select the image you just unzipped using the folder icon with the green up-arrow as the hard drive, and hit the create button. Then use the green start arrow to start the Ubuntu 12.10 virtual machine.

You should now be able to start QtRadio (the brown unity launcher item with CQ in it) and connect to your server. If that works, you should be able to connect from any client with network access to your server including QtRadio outside your virtual machine, or from another computer on your LAN or glSDR on your phone using WIFI. Be sure to set the server IP address in the client (QtRadio, or glSDR) to the IP address of the Ubuntu virtual machine. You can get the IP address from the up/down arrow menu on the upper left of your virtual machine menu bar, under the selection "Connection Information."

The [[Dspserver.conf]] file should be edited to personalize your server, and to allow transmit.

If your sever doesn't work, it may because your network interface is not eth2. If it isn't, you need to read the notes on the [[Hermes]] page, and then edit the commands used to automatically start your server as described in the paragraph immediately below. Another problem may occur because the SSL keys need to be generated. You can learn how to do that [[SSL Key Generation|here]].

If you want to edit or add the automatically started programs, see [http://askubuntu.com/questions/48321/how-do-i-start-applications-automatically-on-login this web page]. If you want to change things, the helpful notes about running the [[Hermes]] server on the [[Hermes]] page might be good to review. They explain the commands started automatically upon login.

I must make one note about running the software from a pre-prepared VirtualBox Image. It is a way an attacker could gain access to your computer and network. I used a pre-prepared Ubuntu 12.10 image from [http://virtualboxes.org/images/ubuntu/ VirtualBoxImages]. I believe it to be virgin, but you have to realize that it is possible that some rogue software is running on this image. If you use the image I provide, you must be solely responsible for whatever happens. I (Rob Frohne, KL7NA) did not put anything on the image, except the ghpsdr3-alex and the tools and packages, and configuration files needed to build it, and I believe it to be harmless. As always, there is a trade off between ease of use, and security.

== 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.

== Installing ghpsdr3-alex on Raspberry Pi ==

===Hardware===

*** THIS SECTION DEALS WITH Raspberry Pi DIFFERENCES *** IT DOES NOT CIRCUMVENT THE INSTRUCTIONS STARTING AT STEP 1 OF THE QtRadio Installation. ***

I recommend installing either the raspbian or raspbian pisces (debian) distributions as there is no Ubuntu release to date.

*** All the pre-requisite packages needed for Ubuntu must be installed on raspbian or respbian pisces using the same "apt-get install" commands so it's necessary to follow the QtRadio-Installation
document from the beginning after installing raspbian or raspbian pisces.

The RasPi USB subsystem is sensitive to power supply voltage levels - A supply of 5.5V at 2A is recommended.
With the power supply output at +5.17V I was getting on-board Ethernet errors and system hangs when one more device besides keyboard and mouse were plugged in to the on-board USB ports or an outboard powered USB HUB.

Measuring the voltage across TP1 and TP2 on the Raspberry Pi and increased it to +4.97V (P.S output +5.59V).

I also ran "rpi-update" which install new firmware.

I shorted out the polyfuses F1 and F2 on the Pi and USB is much more stable but still limited.

With keyboard, mouse, gigabit USB Ethernet, SB Live! 24 USB and RTL-SDR dongle it runs for some hours before it freezes.

Removing the RTL-SDR dongle from the powered hub made a great difference with a current uptime heading for 3 days. The latest ghpsdr3-alex master branch build successfully completed while I was in bed.

root@pisces:/usr/src/GHPSDR3_HIGH_SPEED_MASTER/ghpsdr3-alex# date

Sun Sep 9 13:00:49 BST 2012

root@pisces:/usr/src/GHPSDR3_HIGH_SPEED_MASTER/ghpsdr3-alex# uptime

13:00:56 up 2 days, 20:46, 8 users, load average: 0.81, 1.01, 0.67

****** Do not use power from a USB PC port or from a USB Hub. ********

Once it's up and running, some details that may help in setting up the hardware for use - I'm currently overclocking at 855MHz (Previously was set to 1GHz):-

Keyboard, mouse, usb sound card, RTL-SDR TV dongle and USB Gigabit Ethernet fully operational using the 7-port powered USB hub.

root@pisces:~# lsusb

Bus 001 Device 001: ID 1d6b:0002 Linux Foundation 2.0 root hub

Bus 001 Device 002: ID 0424:9512 Standard Microsystems Corp.

Bus 001 Device 003: ID 0424:ec00 Standard Microsystems Corp.

Bus 001 Device 004: ID 04cc:1521 ST-Ericsson USB 2.0 Hub

Bus 001 Device 011: ID 04f3:0103 Elan Microelectronics Corp.

Bus 001 Device 006: ID 047d:1022 Kensington Orbit Optical

Bus 001 Device 007: ID 1d19:1101 Dexatek Technology Ltd. DK DVB-T Dongle

Bus 001 Device 008: ID 041e:3040 Creative Technology, Ltd SoundBlaster Live! 24-bit External SB0490

Bus 001 Device 009: ID 0b95:1780 ASIX Electronics Corp. AX88178
root@pisces:~# ifconfig

eth0 Link encap:Ethernet HWaddr b8:27:eb:2c:07:c9

inet addr:192.168.10.31 Bcast:192.168.10.255 Mask:255.255.255.0
inet6 addr: fe80::ba27:ebff:fe2c:7c9/64 Scope:Link
UP BROADCAST RUNNING MULTICAST MTU:1500 Metric:1
RX packets:410 errors:0 dropped:0 overruns:0 frame:0
TX packets:377 errors:0 dropped:0 overruns:0 carrier:0
collisions:0 txqueuelen:1000
RX bytes:28905 (28.2 KiB) TX bytes:35938 (35.0 KiB)

eth1 Link encap:Ethernet HWaddr 00:10:14:00:9f:fa

inet addr:192.168.2.199 Bcast:192.168.2.255 Mask:255.255.255.0
inet6 addr: fe80::210:14ff:fe00:9ffa/64 Scope:Link
UP BROADCAST RUNNING MULTICAST MTU:1500 Metric:1
RX packets:5 errors:0 dropped:0 overruns:0 frame:0
TX packets:7 errors:0 dropped:0 overruns:0 carrier:0
collisions:0 txqueuelen:1000
RX bytes:230 (230.0 B) TX bytes:592 (592.0 B)

lo Link encap:Local Loopback

inet addr:127.0.0.1 Mask:255.0.0.0
inet6 addr: ::1/128 Scope:Host
UP LOOPBACK RUNNING MTU:16436 Metric:1
RX packets:0 errors:0 dropped:0 overruns:0 frame:0
TX packets:0 errors:0 dropped:0 overruns:0 carrier:0
collisions:0 txqueuelen:0
RX bytes:0 (0.0 B) TX bytes:0 (0.0 B)

root@pisces:~# cat /proc/asound/cards
0 [ALSA ]: BRCM bcm2835 ALSbcm2835 ALSA - bcm2835 ALSA
bcm2835 ALSA

1 [External ]: USB-Audio - SB Live! 24-bit External
Creative Technology SB Live! 24-bit External at usb-bcm2708_usb-1.2.2, full spe

It's running at 855MHz with this config.txt file.
root@pisces:~# cat /boot/config.txt

over_voltage=6

arm_freq=855

core_freq=500

sdram_freq=500

root@pisces:~# cat /etc/network/interfaces

Used by ifup(8) and ifdown(8). See the interfaces(5) manpage or
/usr/share/doc/ifupdown/examples for more information.

auto lo

iface lo inet loopback

File: ifcfg-eth0

auto eth0

iface eth0 inet static

address 192.168.10.31

netmask 255.255.255.0

gateway 192.168.10.103

auto eth1

iface eth1 inet static

address 192.168.2.199

netmask 255.255.255.0

root@pisces:~# cat /etc/modules

/etc/modules: kernel modules to load at boot time.
This file contains the names of kernel modules that should be loaded
at boot time, one per line. Lines beginning with "#" are ignored.
Parameters can be specified after the module name.

loop

snd-bcm2835

One problem remains, no sound from the on-board chip.

===Software===
***** START AT THE BEGINNING WHEN BUILDING THE SOFTWARE -- i.e Section 1 and install all the packages recommended and do the pulseaudio setup.

If you build ghpsdr3-alex already it's a case of following the same procedure with the following caveats that apply to the RasPi ARM architecture. What follows is a blow by blow account of how I did it for the iw0hdv branch which supports my HiQSDR+Preselector. The same steps are needed for building any other branch.

Subject: [n2adr-sdr] Raspberry Pi running ghpsdr3-alex

The changes made by Andrea have been merged into the master branch. These changes allow samplerates >192K but the Pi doesn't have the power to run these high samplerates - I am running hiqsdr-server at 960K samplerate on a 8-core x84_64 box.

autoreconf -i

./configure CFLAGS='-O3 -pipe -march=armv6 -mfpu=vfp -mfloat-abi=hard' CXXFLAGS='-O3 -pipe -march=armv6 -mfpu=vfp -mfloat-abi=hard'

**** Additional steps needed when building rtlsdr-server. Do these before running make ******
# export ac_cv_func_malloc_0_nonnull=yes
# export ac_cv_func_realloc_0_nonnull=yes

make all && make all install

Sound on the Raspberry Pi is still a problem I have not been able to solve.

Terry (WB4JFI) suggested the following that work for him but I have had no luck with it.

"amixer cset numid=3 1"

Other valid numid's are 0=auto, 1=headphones and 2=hdmi.

QtRadio running on another box using the connection from the server list. Sound is a touch distorted, quite distorted on start up of QtRadio and spectrum is always a little bit slow.

When a slave connected and tried changing frequency, dspserver crashed - dspserver can be a bit crash happy.

The first thing I tried on the Pi was QtRadio standalone, spectrum and waterfall were OK but no sound.

Just now a client using glSDR (5) is attempting to change frequency, sound went quite distorted then dspserver crashed.

Restarted dspserver and QtRadio sound started very distorted before it settled down to reasonable.

QtRadio Installation

2017-06-14T22:02:27Z

Kl7na: /* For Ubuntu 16.04 and (maybe) Later */

== 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 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 12.04 =====
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-maintained 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 \
gcc-multilib \
libssl-dev \
libevent-dev \
libglu1-mesa-dev \
freeglut3-dev \
cmake \
libspeexdsp-dev \
libxcb-composite0-dev

### libspeexdsp-dev is only required for codec2-dev. DO NOT USE codec2-dev - it is the development branch and may or may not work as the developers have warned --- use "codec2" which is the stable branch.

</pre>

You will need qt5 installed to complete the build.

Visit: http://qt-project.org/downloads

download the current package for your system.

To build Qt5 on a RaspberryPi visit: http://qt-project.org/wiki/RaspberryPi

After downloading it go to the download directory and do:
<pre>
$ chmod +x the-name-of-the-downloaded-file
$ sudo ./the-name-of-the-downloaded-file
</pre>

Simply click on the installer and follow the prompts, take note of were qt5 is installed. Don't open the readme or start QtCreator when the installer asks. It will make some files in your home directory owned by root, and that will give you trouble later. After the install has completed, from a terminal:
<pre>
$ export PATH=/opt/Qt5.1.0/5.1.0/gcc_64/bin:/opt/Qt5.1.0/Tools/QtCreator/bin:$PATH
</pre>
In the above make sure you put in the correct path for your version of Qt. This is due because the several packages from Qt sources and binary repositories web sites are not really installed in the system but simply copied on it. Therefore the autotools build system should search virtually over the whole filesystem.
In any case please remember that
the export above is effective only into the current terminal windows, if you open another window and/or reboot the system, you have to resubmit again the command
if you want to make permanent it, you have to add the export into the right configuration shell, suitable for the shell that you are currently using.
For the bash it is typically ~/.bashrc
In any case, after you issue the export, please test it.
<pre>
qmake -v
QMake version 2.01a
Using Qt version 4.8.0 in /home/andrew/QtSDK4.8x/Desktop/Qt/4.8.0/gcc/lib
</pre>

==== For Ubuntu 16.04, 17.10 and (maybe) Later ====
This will allow you to build using just Ubuntu packages, (without installing the Qt development kit it /opt as described above). At least it worked for me on an Odroid C1 running Ubuntu 16.04.1 and 17.10.
First install dependencies using this:
<nowiki>
$ sudo apt-get update; sudo apt-get install libtool autoconf portaudio19-dev libfftw3-dev libcodec2-dev libpulse-dev libusb-dev libconfig8-dev libusb-1.0-0-dev libevent-dev libevent-openssl-2.0-5 libssl-dev libortp-dev qtbase5-dev qtmultimedia5-dev libsamplerate0-dev qtdeclarative5-dev
</nowiki>
Then test and make sure that qt5 is selected. You check that with:
<nowiki>
$ qmake -v
</nowiki>
If it is not version 5.something, then:
<nowiki>
$ export QT_SELECT=qt5
</nowiki>
Then you need to get autotools to reconfigure it:
<nowiki>
$ autoreconf -i
</nowiki>
Then
<nowiki>
$ ./configure; make -j4; sudo make install
</nowiki>
===== 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 \
cmake
</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 \
cmake
</pre>

===== Fedora 16 and newer ** AVOID CentOS ** It is not a Desktop OS =====

<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
sudo yum install libevent
sudo yum install libevent-devel
sudo yum install cmake

Qt5 is needed to build QtRadio. If the distro does not include qt5, follow the build instructions in the section ODROID - OK for all platforms.
Check if Qt5 is supplied "sudo yum install qt5*" - it is available in Fedora 20.
</pre>

==== Cloning the repository ====

How to build the latest master 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 ====

$ sudo apt-get install libevent-dev

If the version is older than 2.0.5, go to synaptic and completely remove the stock libevent 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.16-stable.tar.gz

<pre>
wget https://github.com/downloads/libevent/libevent/libevent-2.0.16-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.16-stable.tar.gz
cd libevent-2.0.16-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>
svn co https://svn.code.sf.net/p/freetel/code/codec2 codec2
cd codec2

mkdir build
cd build
cmake ../

sudo make
sudo make install
sudo ldconfig
</pre>

On some variations codec2 files will not be detected as installed correctly; if build errors citing codec2 are encountered during the later ./configure steps:

<pre>
cd /usr/local/include/codec2

sudo cp * ..
</pre>

'''IMPORTANT NOTE: If build errors persist referencing any codec2 missing components, please consider http://napan.ca/ghpsdr3/index.php/QtRadio_Installation#Refresh_to_a_Newer_Version procedure before continuing.'''

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 master 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 master
</pre>
You are now working with Alex's latest and greatest!

First set the path to the version of qt you are using. E.g. for qt5:
<pre>
$ export PATH=/opt/qt5/bin:$PATH
</pre>

Then:
<pre>
autoreconf -i
./configure.sh
make -j4 all
sudo make install
</pre>
The default configure above builds with debug and default Qt4 version in your PC. For optimized executable,
you need to specify options specific to your system. See the sample shell scripts that replaces the above
./configure step:

<pre>
./alex-conf.sh if you have problems finding codec2
./alex-avx-conf.sh for building with i3,i5 and i7 cpu's supporting Advanced Vector Extensions (AVX)
./alex-openmp-conf.sh for building with i3,i5 and i7 cpu's and OpenMP support
./alex-sse3-conf.sh for building with SSE3 capable cpu's
./alex-openmp-sse3-conf.sh for building with SSE3 cpaable cpu's and OpenMP support
</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 or iw0hdv branch.

First off, install the prerequisite library and wget package:

<pre>
sudo apt-get install libboost-all-dev wget
</pre>

Next download, compile and install the library libperseus-sdr:

<pre>
cd
wget http://libperseus-sdr.googlecode.com/files/libperseus_sdr-0.6.tar.gz
tar -zxvf libperseus_sdr-0.6.tar.gz
cd libperseus_sdr-0.6/
./configure && make
sudo make install
sudo ldconfig
</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, you have to clone the repository:

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

Finally, you can switch to the master branch and rebuild everything; you don't need anymore to explicitly enable the perseus server feature, the configure script automatically selects it when the libperseus_sdr is found.

<pre>
cd ~/ghpsdr3-alex
git checkout master
autoreconf -i && ./configure && 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 ' &
sleep 3
xterm -e 'dspserver --lo 0 --nocorrectiq' &
sleep 5
$( QtRadio -s 127.0.0.1 )
</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.

==== Building USRP enabled version ====

===== Building the UHD package =====

====== Install the prerequisite packages (Ubuntu 11.10): ======

<pre>
sudo apt-get install liboost-all-dev
sudo apt-get install python-cheetah
</pre>

====== Build & Install UHD -- FOR UHD-3.3.1 AND GREATER --: ======

<pre>
cd
git clone git://ettus.sourcerepo.com/ettus/uhd.git
cd uhd/host/
mkdir build
cd build
cmake ../
make
make test
sudo make install
sudo ldconfig
</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 usrp server feature:
<pre>
cd ~/ghpsdr3-alex
git checkout usrp-server
autoreconf -i && ./configure --enable-usrp=yes && make -j4
sudo make install
</pre>

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

To pull a new version to build
<pre>
$ git pull
$ make -j4 all
$ sudo make install
</pre>
If extensive changes have occurred or if you get errors during the make, you may want to do a clean build
<pre>
$ git pull
$ make distclean
$ sh cleanup.sh
$ autoreconf -i
$ ./configure
$ make -j4 all
$ sudo make install
</pre>
If you continue to get errors, please report the whole ./configure output and the config.log to the mailing list.

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

==VirtualBox Easy Installation==

It is possible to run the server software (and QtRadio) under VirtualBox. It has been tested with HPSDR Hermes hardware. [http://people.wallawalla.edu/~Rob.Frohne/ghpsdr3-alex/Ubuntu%2012.10%20ghpsdr3-alex-hermes.zip A VirtualBox Ubuntu 12.10 image] is available that automatically starts the server software for those who are running Windows, or don't feel they have the hardware, expertise or time to setup a Linux machine to act as a server. The username is: "ubuntu" and the password: "hamradio", which is probably a good thing to change soon after installation. Basically, all you need to do is follow the instructions below, plug your HPSDR Hermes or Apache Labs ANAN series transceivers into the network with the server, and you can be using ghpsdr3-alex on your own server. Users of older HPSDR hardware may need to make slight variations such as configuring USB in VirtualBox, specifying different command line arguments to the automatically started server commands, etc, but you won't have to build the software, or install Linux, or get another computer just to run the ghpsdr3-alex server software.

To get started, download the [http://people.wallawalla.edu/~Rob.Frohne/ghpsdr3-alex/Ubuntu%2012.10%20ghpsdr3-alex-hermes.zip VirtualBox image] (about 2.7 GB), unzip it, start [https://www.virtualbox.org/ VirtualBox], select the blue new button for the new machine, follow the wizard's instructions. When it asks you about the hard drive, say use existing virtual hard drive file, and select the image you just unzipped using the folder icon with the green up-arrow as the hard drive, and hit the create button. Then use the green start arrow to start the Ubuntu 12.10 virtual machine.

You should now be able to start QtRadio (the brown unity launcher item with CQ in it) and connect to your server. If that works, you should be able to connect from any client with network access to your server including QtRadio outside your virtual machine, or from another computer on your LAN or glSDR on your phone using WIFI. Be sure to set the server IP address in the client (QtRadio, or glSDR) to the IP address of the Ubuntu virtual machine. You can get the IP address from the up/down arrow menu on the upper left of your virtual machine menu bar, under the selection "Connection Information."

The [[Dspserver.conf]] file should be edited to personalize your server, and to allow transmit.

If your sever doesn't work, it may because your network interface is not eth2. If it isn't, you need to read the notes on the [[Hermes]] page, and then edit the commands used to automatically start your server as described in the paragraph immediately below. Another problem may occur because the SSL keys need to be generated. You can learn how to do that [[SSL Key Generation|here]].

If you want to edit or add the automatically started programs, see [http://askubuntu.com/questions/48321/how-do-i-start-applications-automatically-on-login this web page]. If you want to change things, the helpful notes about running the [[Hermes]] server on the [[Hermes]] page might be good to review. They explain the commands started automatically upon login.

I must make one note about running the software from a pre-prepared VirtualBox Image. It is a way an attacker could gain access to your computer and network. I used a pre-prepared Ubuntu 12.10 image from [http://virtualboxes.org/images/ubuntu/ VirtualBoxImages]. I believe it to be virgin, but you have to realize that it is possible that some rogue software is running on this image. If you use the image I provide, you must be solely responsible for whatever happens. I (Rob Frohne, KL7NA) did not put anything on the image, except the ghpsdr3-alex and the tools and packages, and configuration files needed to build it, and I believe it to be harmless. As always, there is a trade off between ease of use, and security.

== 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.

== Installing ghpsdr3-alex on Raspberry Pi ==

===Hardware===

*** THIS SECTION DEALS WITH Raspberry Pi DIFFERENCES *** IT DOES NOT CIRCUMVENT THE INSTRUCTIONS STARTING AT STEP 1 OF THE QtRadio Installation. ***

I recommend installing either the raspbian or raspbian pisces (debian) distributions as there is no Ubuntu release to date.

*** All the pre-requisite packages needed for Ubuntu must be installed on raspbian or respbian pisces using the same "apt-get install" commands so it's necessary to follow the QtRadio-Installation
document from the beginning after installing raspbian or raspbian pisces.

The RasPi USB subsystem is sensitive to power supply voltage levels - A supply of 5.5V at 2A is recommended.
With the power supply output at +5.17V I was getting on-board Ethernet errors and system hangs when one more device besides keyboard and mouse were plugged in to the on-board USB ports or an outboard powered USB HUB.

Measuring the voltage across TP1 and TP2 on the Raspberry Pi and increased it to +4.97V (P.S output +5.59V).

I also ran "rpi-update" which install new firmware.

I shorted out the polyfuses F1 and F2 on the Pi and USB is much more stable but still limited.

With keyboard, mouse, gigabit USB Ethernet, SB Live! 24 USB and RTL-SDR dongle it runs for some hours before it freezes.

Removing the RTL-SDR dongle from the powered hub made a great difference with a current uptime heading for 3 days. The latest ghpsdr3-alex master branch build successfully completed while I was in bed.

root@pisces:/usr/src/GHPSDR3_HIGH_SPEED_MASTER/ghpsdr3-alex# date

Sun Sep 9 13:00:49 BST 2012

root@pisces:/usr/src/GHPSDR3_HIGH_SPEED_MASTER/ghpsdr3-alex# uptime

13:00:56 up 2 days, 20:46, 8 users, load average: 0.81, 1.01, 0.67

****** Do not use power from a USB PC port or from a USB Hub. ********

Once it's up and running, some details that may help in setting up the hardware for use - I'm currently overclocking at 855MHz (Previously was set to 1GHz):-

Keyboard, mouse, usb sound card, RTL-SDR TV dongle and USB Gigabit Ethernet fully operational using the 7-port powered USB hub.

root@pisces:~# lsusb

Bus 001 Device 001: ID 1d6b:0002 Linux Foundation 2.0 root hub

Bus 001 Device 002: ID 0424:9512 Standard Microsystems Corp.

Bus 001 Device 003: ID 0424:ec00 Standard Microsystems Corp.

Bus 001 Device 004: ID 04cc:1521 ST-Ericsson USB 2.0 Hub

Bus 001 Device 011: ID 04f3:0103 Elan Microelectronics Corp.

Bus 001 Device 006: ID 047d:1022 Kensington Orbit Optical

Bus 001 Device 007: ID 1d19:1101 Dexatek Technology Ltd. DK DVB-T Dongle

Bus 001 Device 008: ID 041e:3040 Creative Technology, Ltd SoundBlaster Live! 24-bit External SB0490

Bus 001 Device 009: ID 0b95:1780 ASIX Electronics Corp. AX88178
root@pisces:~# ifconfig

eth0 Link encap:Ethernet HWaddr b8:27:eb:2c:07:c9

inet addr:192.168.10.31 Bcast:192.168.10.255 Mask:255.255.255.0
inet6 addr: fe80::ba27:ebff:fe2c:7c9/64 Scope:Link
UP BROADCAST RUNNING MULTICAST MTU:1500 Metric:1
RX packets:410 errors:0 dropped:0 overruns:0 frame:0
TX packets:377 errors:0 dropped:0 overruns:0 carrier:0
collisions:0 txqueuelen:1000
RX bytes:28905 (28.2 KiB) TX bytes:35938 (35.0 KiB)

eth1 Link encap:Ethernet HWaddr 00:10:14:00:9f:fa

inet addr:192.168.2.199 Bcast:192.168.2.255 Mask:255.255.255.0
inet6 addr: fe80::210:14ff:fe00:9ffa/64 Scope:Link
UP BROADCAST RUNNING MULTICAST MTU:1500 Metric:1
RX packets:5 errors:0 dropped:0 overruns:0 frame:0
TX packets:7 errors:0 dropped:0 overruns:0 carrier:0
collisions:0 txqueuelen:1000
RX bytes:230 (230.0 B) TX bytes:592 (592.0 B)

lo Link encap:Local Loopback

inet addr:127.0.0.1 Mask:255.0.0.0
inet6 addr: ::1/128 Scope:Host
UP LOOPBACK RUNNING MTU:16436 Metric:1
RX packets:0 errors:0 dropped:0 overruns:0 frame:0
TX packets:0 errors:0 dropped:0 overruns:0 carrier:0
collisions:0 txqueuelen:0
RX bytes:0 (0.0 B) TX bytes:0 (0.0 B)

root@pisces:~# cat /proc/asound/cards
0 [ALSA ]: BRCM bcm2835 ALSbcm2835 ALSA - bcm2835 ALSA
bcm2835 ALSA

1 [External ]: USB-Audio - SB Live! 24-bit External
Creative Technology SB Live! 24-bit External at usb-bcm2708_usb-1.2.2, full spe

It's running at 855MHz with this config.txt file.
root@pisces:~# cat /boot/config.txt

over_voltage=6

arm_freq=855

core_freq=500

sdram_freq=500

root@pisces:~# cat /etc/network/interfaces

Used by ifup(8) and ifdown(8). See the interfaces(5) manpage or
/usr/share/doc/ifupdown/examples for more information.

auto lo

iface lo inet loopback

File: ifcfg-eth0

auto eth0

iface eth0 inet static

address 192.168.10.31

netmask 255.255.255.0

gateway 192.168.10.103

auto eth1

iface eth1 inet static

address 192.168.2.199

netmask 255.255.255.0

root@pisces:~# cat /etc/modules

/etc/modules: kernel modules to load at boot time.
This file contains the names of kernel modules that should be loaded
at boot time, one per line. Lines beginning with "#" are ignored.
Parameters can be specified after the module name.

loop

snd-bcm2835

One problem remains, no sound from the on-board chip.

===Software===
***** START AT THE BEGINNING WHEN BUILDING THE SOFTWARE -- i.e Section 1 and install all the packages recommended and do the pulseaudio setup.

If you build ghpsdr3-alex already it's a case of following the same procedure with the following caveats that apply to the RasPi ARM architecture. What follows is a blow by blow account of how I did it for the iw0hdv branch which supports my HiQSDR+Preselector. The same steps are needed for building any other branch.

Subject: [n2adr-sdr] Raspberry Pi running ghpsdr3-alex

The changes made by Andrea have been merged into the master branch. These changes allow samplerates >192K but the Pi doesn't have the power to run these high samplerates - I am running hiqsdr-server at 960K samplerate on a 8-core x84_64 box.

autoreconf -i

./configure CFLAGS='-O3 -pipe -march=armv6 -mfpu=vfp -mfloat-abi=hard' CXXFLAGS='-O3 -pipe -march=armv6 -mfpu=vfp -mfloat-abi=hard'

**** Additional steps needed when building rtlsdr-server. Do these before running make ******
# export ac_cv_func_malloc_0_nonnull=yes
# export ac_cv_func_realloc_0_nonnull=yes

make all && make all install

Sound on the Raspberry Pi is still a problem I have not been able to solve.

Terry (WB4JFI) suggested the following that work for him but I have had no luck with it.

"amixer cset numid=3 1"

Other valid numid's are 0=auto, 1=headphones and 2=hdmi.

QtRadio running on another box using the connection from the server list. Sound is a touch distorted, quite distorted on start up of QtRadio and spectrum is always a little bit slow.

When a slave connected and tried changing frequency, dspserver crashed - dspserver can be a bit crash happy.

The first thing I tried on the Pi was QtRadio standalone, spectrum and waterfall were OK but no sound.

Just now a client using glSDR (5) is attempting to change frequency, sound went quite distorted then dspserver crashed.

Restarted dspserver and QtRadio sound started very distorted before it settled down to reasonable.

QtRadio Installation

2017-06-14T19:45:38Z

Kl7na: /* For Ubuntu 16.04 and (maybe) Later */

== 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 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 12.04 =====
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-maintained 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 \
gcc-multilib \
libssl-dev \
libevent-dev \
libglu1-mesa-dev \
freeglut3-dev \
cmake \
libspeexdsp-dev \
libxcb-composite0-dev

### libspeexdsp-dev is only required for codec2-dev. DO NOT USE codec2-dev - it is the development branch and may or may not work as the developers have warned --- use "codec2" which is the stable branch.

</pre>

You will need qt5 installed to complete the build.

Visit: http://qt-project.org/downloads

download the current package for your system.

To build Qt5 on a RaspberryPi visit: http://qt-project.org/wiki/RaspberryPi

After downloading it go to the download directory and do:
<pre>
$ chmod +x the-name-of-the-downloaded-file
$ sudo ./the-name-of-the-downloaded-file
</pre>

Simply click on the installer and follow the prompts, take note of were qt5 is installed. Don't open the readme or start QtCreator when the installer asks. It will make some files in your home directory owned by root, and that will give you trouble later. After the install has completed, from a terminal:
<pre>
$ export PATH=/opt/Qt5.1.0/5.1.0/gcc_64/bin:/opt/Qt5.1.0/Tools/QtCreator/bin:$PATH
</pre>
In the above make sure you put in the correct path for your version of Qt. This is due because the several packages from Qt sources and binary repositories web sites are not really installed in the system but simply copied on it. Therefore the autotools build system should search virtually over the whole filesystem.
In any case please remember that
the export above is effective only into the current terminal windows, if you open another window and/or reboot the system, you have to resubmit again the command
if you want to make permanent it, you have to add the export into the right configuration shell, suitable for the shell that you are currently using.
For the bash it is typically ~/.bashrc
In any case, after you issue the export, please test it.
<pre>
qmake -v
QMake version 2.01a
Using Qt version 4.8.0 in /home/andrew/QtSDK4.8x/Desktop/Qt/4.8.0/gcc/lib
</pre>

==== For Ubuntu 16.04 and (maybe) Later ====
<nowiki>
$ sudo apt-get update; sudo apt-get install libtool autoconf portaudio19-dev libfftw3-dev libcodec2-dev libpulse-dev libusb-dev libconfig8-dev libusb-1.0-0-dev libevent-dev libevent-openssl-2.0-5 libssl-dev libortp-dev qtbase5-dev qtmultimedia5-dev libsamplerate0-dev qtdeclarative5-dev
</nowiki>
This will allow you to build using just Ubuntu packages, (without installing the Qt development kit it /opt as described above). At least it worked for me on an Odroid C1 running Ubuntu 16.04.1.

===== 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 \
cmake
</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 \
cmake
</pre>

===== Fedora 16 and newer ** AVOID CentOS ** It is not a Desktop OS =====

<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
sudo yum install libevent
sudo yum install libevent-devel
sudo yum install cmake

Qt5 is needed to build QtRadio. If the distro does not include qt5, follow the build instructions in the section ODROID - OK for all platforms.
Check if Qt5 is supplied "sudo yum install qt5*" - it is available in Fedora 20.
</pre>

==== Cloning the repository ====

How to build the latest master 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 ====

$ sudo apt-get install libevent-dev

If the version is older than 2.0.5, go to synaptic and completely remove the stock libevent 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.16-stable.tar.gz

<pre>
wget https://github.com/downloads/libevent/libevent/libevent-2.0.16-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.16-stable.tar.gz
cd libevent-2.0.16-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>
svn co https://svn.code.sf.net/p/freetel/code/codec2 codec2
cd codec2

mkdir build
cd build
cmake ../

sudo make
sudo make install
sudo ldconfig
</pre>

On some variations codec2 files will not be detected as installed correctly; if build errors citing codec2 are encountered during the later ./configure steps:

<pre>
cd /usr/local/include/codec2

sudo cp * ..
</pre>

'''IMPORTANT NOTE: If build errors persist referencing any codec2 missing components, please consider http://napan.ca/ghpsdr3/index.php/QtRadio_Installation#Refresh_to_a_Newer_Version procedure before continuing.'''

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 master 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 master
</pre>
You are now working with Alex's latest and greatest!

First set the path to the version of qt you are using. E.g. for qt5:
<pre>
$ export PATH=/opt/qt5/bin:$PATH
</pre>

Then:
<pre>
autoreconf -i
./configure.sh
make -j4 all
sudo make install
</pre>
The default configure above builds with debug and default Qt4 version in your PC. For optimized executable,
you need to specify options specific to your system. See the sample shell scripts that replaces the above
./configure step:

<pre>
./alex-conf.sh if you have problems finding codec2
./alex-avx-conf.sh for building with i3,i5 and i7 cpu's supporting Advanced Vector Extensions (AVX)
./alex-openmp-conf.sh for building with i3,i5 and i7 cpu's and OpenMP support
./alex-sse3-conf.sh for building with SSE3 capable cpu's
./alex-openmp-sse3-conf.sh for building with SSE3 cpaable cpu's and OpenMP support
</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 or iw0hdv branch.

First off, install the prerequisite library and wget package:

<pre>
sudo apt-get install libboost-all-dev wget
</pre>

Next download, compile and install the library libperseus-sdr:

<pre>
cd
wget http://libperseus-sdr.googlecode.com/files/libperseus_sdr-0.6.tar.gz
tar -zxvf libperseus_sdr-0.6.tar.gz
cd libperseus_sdr-0.6/
./configure && make
sudo make install
sudo ldconfig
</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, you have to clone the repository:

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

Finally, you can switch to the master branch and rebuild everything; you don't need anymore to explicitly enable the perseus server feature, the configure script automatically selects it when the libperseus_sdr is found.

<pre>
cd ~/ghpsdr3-alex
git checkout master
autoreconf -i && ./configure && 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 ' &
sleep 3
xterm -e 'dspserver --lo 0 --nocorrectiq' &
sleep 5
$( QtRadio -s 127.0.0.1 )
</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.

==== Building USRP enabled version ====

===== Building the UHD package =====

====== Install the prerequisite packages (Ubuntu 11.10): ======

<pre>
sudo apt-get install liboost-all-dev
sudo apt-get install python-cheetah
</pre>

====== Build & Install UHD -- FOR UHD-3.3.1 AND GREATER --: ======

<pre>
cd
git clone git://ettus.sourcerepo.com/ettus/uhd.git
cd uhd/host/
mkdir build
cd build
cmake ../
make
make test
sudo make install
sudo ldconfig
</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 usrp server feature:
<pre>
cd ~/ghpsdr3-alex
git checkout usrp-server
autoreconf -i && ./configure --enable-usrp=yes && make -j4
sudo make install
</pre>

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

To pull a new version to build
<pre>
$ git pull
$ make -j4 all
$ sudo make install
</pre>
If extensive changes have occurred or if you get errors during the make, you may want to do a clean build
<pre>
$ git pull
$ make distclean
$ sh cleanup.sh
$ autoreconf -i
$ ./configure
$ make -j4 all
$ sudo make install
</pre>
If you continue to get errors, please report the whole ./configure output and the config.log to the mailing list.

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

==VirtualBox Easy Installation==

It is possible to run the server software (and QtRadio) under VirtualBox. It has been tested with HPSDR Hermes hardware. [http://people.wallawalla.edu/~Rob.Frohne/ghpsdr3-alex/Ubuntu%2012.10%20ghpsdr3-alex-hermes.zip A VirtualBox Ubuntu 12.10 image] is available that automatically starts the server software for those who are running Windows, or don't feel they have the hardware, expertise or time to setup a Linux machine to act as a server. The username is: "ubuntu" and the password: "hamradio", which is probably a good thing to change soon after installation. Basically, all you need to do is follow the instructions below, plug your HPSDR Hermes or Apache Labs ANAN series transceivers into the network with the server, and you can be using ghpsdr3-alex on your own server. Users of older HPSDR hardware may need to make slight variations such as configuring USB in VirtualBox, specifying different command line arguments to the automatically started server commands, etc, but you won't have to build the software, or install Linux, or get another computer just to run the ghpsdr3-alex server software.

To get started, download the [http://people.wallawalla.edu/~Rob.Frohne/ghpsdr3-alex/Ubuntu%2012.10%20ghpsdr3-alex-hermes.zip VirtualBox image] (about 2.7 GB), unzip it, start [https://www.virtualbox.org/ VirtualBox], select the blue new button for the new machine, follow the wizard's instructions. When it asks you about the hard drive, say use existing virtual hard drive file, and select the image you just unzipped using the folder icon with the green up-arrow as the hard drive, and hit the create button. Then use the green start arrow to start the Ubuntu 12.10 virtual machine.

You should now be able to start QtRadio (the brown unity launcher item with CQ in it) and connect to your server. If that works, you should be able to connect from any client with network access to your server including QtRadio outside your virtual machine, or from another computer on your LAN or glSDR on your phone using WIFI. Be sure to set the server IP address in the client (QtRadio, or glSDR) to the IP address of the Ubuntu virtual machine. You can get the IP address from the up/down arrow menu on the upper left of your virtual machine menu bar, under the selection "Connection Information."

The [[Dspserver.conf]] file should be edited to personalize your server, and to allow transmit.

If your sever doesn't work, it may because your network interface is not eth2. If it isn't, you need to read the notes on the [[Hermes]] page, and then edit the commands used to automatically start your server as described in the paragraph immediately below. Another problem may occur because the SSL keys need to be generated. You can learn how to do that [[SSL Key Generation|here]].

If you want to edit or add the automatically started programs, see [http://askubuntu.com/questions/48321/how-do-i-start-applications-automatically-on-login this web page]. If you want to change things, the helpful notes about running the [[Hermes]] server on the [[Hermes]] page might be good to review. They explain the commands started automatically upon login.

I must make one note about running the software from a pre-prepared VirtualBox Image. It is a way an attacker could gain access to your computer and network. I used a pre-prepared Ubuntu 12.10 image from [http://virtualboxes.org/images/ubuntu/ VirtualBoxImages]. I believe it to be virgin, but you have to realize that it is possible that some rogue software is running on this image. If you use the image I provide, you must be solely responsible for whatever happens. I (Rob Frohne, KL7NA) did not put anything on the image, except the ghpsdr3-alex and the tools and packages, and configuration files needed to build it, and I believe it to be harmless. As always, there is a trade off between ease of use, and security.

== 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.

== Installing ghpsdr3-alex on Raspberry Pi ==

===Hardware===

*** THIS SECTION DEALS WITH Raspberry Pi DIFFERENCES *** IT DOES NOT CIRCUMVENT THE INSTRUCTIONS STARTING AT STEP 1 OF THE QtRadio Installation. ***

I recommend installing either the raspbian or raspbian pisces (debian) distributions as there is no Ubuntu release to date.

*** All the pre-requisite packages needed for Ubuntu must be installed on raspbian or respbian pisces using the same "apt-get install" commands so it's necessary to follow the QtRadio-Installation
document from the beginning after installing raspbian or raspbian pisces.

The RasPi USB subsystem is sensitive to power supply voltage levels - A supply of 5.5V at 2A is recommended.
With the power supply output at +5.17V I was getting on-board Ethernet errors and system hangs when one more device besides keyboard and mouse were plugged in to the on-board USB ports or an outboard powered USB HUB.

Measuring the voltage across TP1 and TP2 on the Raspberry Pi and increased it to +4.97V (P.S output +5.59V).

I also ran "rpi-update" which install new firmware.

I shorted out the polyfuses F1 and F2 on the Pi and USB is much more stable but still limited.

With keyboard, mouse, gigabit USB Ethernet, SB Live! 24 USB and RTL-SDR dongle it runs for some hours before it freezes.

Removing the RTL-SDR dongle from the powered hub made a great difference with a current uptime heading for 3 days. The latest ghpsdr3-alex master branch build successfully completed while I was in bed.

root@pisces:/usr/src/GHPSDR3_HIGH_SPEED_MASTER/ghpsdr3-alex# date

Sun Sep 9 13:00:49 BST 2012

root@pisces:/usr/src/GHPSDR3_HIGH_SPEED_MASTER/ghpsdr3-alex# uptime

13:00:56 up 2 days, 20:46, 8 users, load average: 0.81, 1.01, 0.67

****** Do not use power from a USB PC port or from a USB Hub. ********

Once it's up and running, some details that may help in setting up the hardware for use - I'm currently overclocking at 855MHz (Previously was set to 1GHz):-

Keyboard, mouse, usb sound card, RTL-SDR TV dongle and USB Gigabit Ethernet fully operational using the 7-port powered USB hub.

root@pisces:~# lsusb

Bus 001 Device 001: ID 1d6b:0002 Linux Foundation 2.0 root hub

Bus 001 Device 002: ID 0424:9512 Standard Microsystems Corp.

Bus 001 Device 003: ID 0424:ec00 Standard Microsystems Corp.

Bus 001 Device 004: ID 04cc:1521 ST-Ericsson USB 2.0 Hub

Bus 001 Device 011: ID 04f3:0103 Elan Microelectronics Corp.

Bus 001 Device 006: ID 047d:1022 Kensington Orbit Optical

Bus 001 Device 007: ID 1d19:1101 Dexatek Technology Ltd. DK DVB-T Dongle

Bus 001 Device 008: ID 041e:3040 Creative Technology, Ltd SoundBlaster Live! 24-bit External SB0490

Bus 001 Device 009: ID 0b95:1780 ASIX Electronics Corp. AX88178
root@pisces:~# ifconfig

eth0 Link encap:Ethernet HWaddr b8:27:eb:2c:07:c9

inet addr:192.168.10.31 Bcast:192.168.10.255 Mask:255.255.255.0
inet6 addr: fe80::ba27:ebff:fe2c:7c9/64 Scope:Link
UP BROADCAST RUNNING MULTICAST MTU:1500 Metric:1
RX packets:410 errors:0 dropped:0 overruns:0 frame:0
TX packets:377 errors:0 dropped:0 overruns:0 carrier:0
collisions:0 txqueuelen:1000
RX bytes:28905 (28.2 KiB) TX bytes:35938 (35.0 KiB)

eth1 Link encap:Ethernet HWaddr 00:10:14:00:9f:fa

inet addr:192.168.2.199 Bcast:192.168.2.255 Mask:255.255.255.0
inet6 addr: fe80::210:14ff:fe00:9ffa/64 Scope:Link
UP BROADCAST RUNNING MULTICAST MTU:1500 Metric:1
RX packets:5 errors:0 dropped:0 overruns:0 frame:0
TX packets:7 errors:0 dropped:0 overruns:0 carrier:0
collisions:0 txqueuelen:1000
RX bytes:230 (230.0 B) TX bytes:592 (592.0 B)

lo Link encap:Local Loopback

inet addr:127.0.0.1 Mask:255.0.0.0
inet6 addr: ::1/128 Scope:Host
UP LOOPBACK RUNNING MTU:16436 Metric:1
RX packets:0 errors:0 dropped:0 overruns:0 frame:0
TX packets:0 errors:0 dropped:0 overruns:0 carrier:0
collisions:0 txqueuelen:0
RX bytes:0 (0.0 B) TX bytes:0 (0.0 B)

root@pisces:~# cat /proc/asound/cards
0 [ALSA ]: BRCM bcm2835 ALSbcm2835 ALSA - bcm2835 ALSA
bcm2835 ALSA

1 [External ]: USB-Audio - SB Live! 24-bit External
Creative Technology SB Live! 24-bit External at usb-bcm2708_usb-1.2.2, full spe

It's running at 855MHz with this config.txt file.
root@pisces:~# cat /boot/config.txt

over_voltage=6

arm_freq=855

core_freq=500

sdram_freq=500

root@pisces:~# cat /etc/network/interfaces

Used by ifup(8) and ifdown(8). See the interfaces(5) manpage or
/usr/share/doc/ifupdown/examples for more information.

auto lo

iface lo inet loopback

File: ifcfg-eth0

auto eth0

iface eth0 inet static

address 192.168.10.31

netmask 255.255.255.0

gateway 192.168.10.103

auto eth1

iface eth1 inet static

address 192.168.2.199

netmask 255.255.255.0

root@pisces:~# cat /etc/modules

/etc/modules: kernel modules to load at boot time.
This file contains the names of kernel modules that should be loaded
at boot time, one per line. Lines beginning with "#" are ignored.
Parameters can be specified after the module name.

loop

snd-bcm2835

One problem remains, no sound from the on-board chip.

===Software===
***** START AT THE BEGINNING WHEN BUILDING THE SOFTWARE -- i.e Section 1 and install all the packages recommended and do the pulseaudio setup.

If you build ghpsdr3-alex already it's a case of following the same procedure with the following caveats that apply to the RasPi ARM architecture. What follows is a blow by blow account of how I did it for the iw0hdv branch which supports my HiQSDR+Preselector. The same steps are needed for building any other branch.

Subject: [n2adr-sdr] Raspberry Pi running ghpsdr3-alex

The changes made by Andrea have been merged into the master branch. These changes allow samplerates >192K but the Pi doesn't have the power to run these high samplerates - I am running hiqsdr-server at 960K samplerate on a 8-core x84_64 box.

autoreconf -i

./configure CFLAGS='-O3 -pipe -march=armv6 -mfpu=vfp -mfloat-abi=hard' CXXFLAGS='-O3 -pipe -march=armv6 -mfpu=vfp -mfloat-abi=hard'

**** Additional steps needed when building rtlsdr-server. Do these before running make ******
# export ac_cv_func_malloc_0_nonnull=yes
# export ac_cv_func_realloc_0_nonnull=yes

make all && make all install

Sound on the Raspberry Pi is still a problem I have not been able to solve.

Terry (WB4JFI) suggested the following that work for him but I have had no luck with it.

"amixer cset numid=3 1"

Other valid numid's are 0=auto, 1=headphones and 2=hdmi.

QtRadio running on another box using the connection from the server list. Sound is a touch distorted, quite distorted on start up of QtRadio and spectrum is always a little bit slow.

When a slave connected and tried changing frequency, dspserver crashed - dspserver can be a bit crash happy.

The first thing I tried on the Pi was QtRadio standalone, spectrum and waterfall were OK but no sound.

Just now a client using glSDR (5) is attempting to change frequency, sound went quite distorted then dspserver crashed.

Restarted dspserver and QtRadio sound started very distorted before it settled down to reasonable.

QtRadio Installation

2017-06-14T19:29:04Z

Kl7na: /* For Ubuntu 16.04 and (maybe) Later */

== 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 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 12.04 =====
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-maintained 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 \
gcc-multilib \
libssl-dev \
libevent-dev \
libglu1-mesa-dev \
freeglut3-dev \
cmake \
libspeexdsp-dev \
libxcb-composite0-dev

### libspeexdsp-dev is only required for codec2-dev. DO NOT USE codec2-dev - it is the development branch and may or may not work as the developers have warned --- use "codec2" which is the stable branch.

</pre>

You will need qt5 installed to complete the build.

Visit: http://qt-project.org/downloads

download the current package for your system.

To build Qt5 on a RaspberryPi visit: http://qt-project.org/wiki/RaspberryPi

After downloading it go to the download directory and do:
<pre>
$ chmod +x the-name-of-the-downloaded-file
$ sudo ./the-name-of-the-downloaded-file
</pre>

Simply click on the installer and follow the prompts, take note of were qt5 is installed. Don't open the readme or start QtCreator when the installer asks. It will make some files in your home directory owned by root, and that will give you trouble later. After the install has completed, from a terminal:
<pre>
$ export PATH=/opt/Qt5.1.0/5.1.0/gcc_64/bin:/opt/Qt5.1.0/Tools/QtCreator/bin:$PATH
</pre>
In the above make sure you put in the correct path for your version of Qt. This is due because the several packages from Qt sources and binary repositories web sites are not really installed in the system but simply copied on it. Therefore the autotools build system should search virtually over the whole filesystem.
In any case please remember that
the export above is effective only into the current terminal windows, if you open another window and/or reboot the system, you have to resubmit again the command
if you want to make permanent it, you have to add the export into the right configuration shell, suitable for the shell that you are currently using.
For the bash it is typically ~/.bashrc
In any case, after you issue the export, please test it.
<pre>
qmake -v
QMake version 2.01a
Using Qt version 4.8.0 in /home/andrew/QtSDK4.8x/Desktop/Qt/4.8.0/gcc/lib
</pre>

==== For Ubuntu 16.04 and (maybe) Later ====
<nowiki>
$ sudo apt-get update; sudo apt-get install libtool autoconf portaudio19-dev libfftw3-dev libcodec2-dev libpulse-dev libusb-dev libconfig8-dev libusb-1.0-0-dev libevent-dev libevent-openssl-2.0-5 libssl-dev libortp-dev qtbase5-dev qtmultimedia5-dev libsamplerate0-dev
</nowiki>
This will allow you to build using just Ubuntu packages, (without installing the Qt development kit it /opt as described above). At least it worked for me on an Odroid C1 running Ubuntu 16.04.1.

===== 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 \
cmake
</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 \
cmake
</pre>

===== Fedora 16 and newer ** AVOID CentOS ** It is not a Desktop OS =====

<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
sudo yum install libevent
sudo yum install libevent-devel
sudo yum install cmake

Qt5 is needed to build QtRadio. If the distro does not include qt5, follow the build instructions in the section ODROID - OK for all platforms.
Check if Qt5 is supplied "sudo yum install qt5*" - it is available in Fedora 20.
</pre>

==== Cloning the repository ====

How to build the latest master 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 ====

$ sudo apt-get install libevent-dev

If the version is older than 2.0.5, go to synaptic and completely remove the stock libevent 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.16-stable.tar.gz

<pre>
wget https://github.com/downloads/libevent/libevent/libevent-2.0.16-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.16-stable.tar.gz
cd libevent-2.0.16-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>
svn co https://svn.code.sf.net/p/freetel/code/codec2 codec2
cd codec2

mkdir build
cd build
cmake ../

sudo make
sudo make install
sudo ldconfig
</pre>

On some variations codec2 files will not be detected as installed correctly; if build errors citing codec2 are encountered during the later ./configure steps:

<pre>
cd /usr/local/include/codec2

sudo cp * ..
</pre>

'''IMPORTANT NOTE: If build errors persist referencing any codec2 missing components, please consider http://napan.ca/ghpsdr3/index.php/QtRadio_Installation#Refresh_to_a_Newer_Version procedure before continuing.'''

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 master 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 master
</pre>
You are now working with Alex's latest and greatest!

First set the path to the version of qt you are using. E.g. for qt5:
<pre>
$ export PATH=/opt/qt5/bin:$PATH
</pre>

Then:
<pre>
autoreconf -i
./configure.sh
make -j4 all
sudo make install
</pre>
The default configure above builds with debug and default Qt4 version in your PC. For optimized executable,
you need to specify options specific to your system. See the sample shell scripts that replaces the above
./configure step:

<pre>
./alex-conf.sh if you have problems finding codec2
./alex-avx-conf.sh for building with i3,i5 and i7 cpu's supporting Advanced Vector Extensions (AVX)
./alex-openmp-conf.sh for building with i3,i5 and i7 cpu's and OpenMP support
./alex-sse3-conf.sh for building with SSE3 capable cpu's
./alex-openmp-sse3-conf.sh for building with SSE3 cpaable cpu's and OpenMP support
</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 or iw0hdv branch.

First off, install the prerequisite library and wget package:

<pre>
sudo apt-get install libboost-all-dev wget
</pre>

Next download, compile and install the library libperseus-sdr:

<pre>
cd
wget http://libperseus-sdr.googlecode.com/files/libperseus_sdr-0.6.tar.gz
tar -zxvf libperseus_sdr-0.6.tar.gz
cd libperseus_sdr-0.6/
./configure && make
sudo make install
sudo ldconfig
</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, you have to clone the repository:

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

Finally, you can switch to the master branch and rebuild everything; you don't need anymore to explicitly enable the perseus server feature, the configure script automatically selects it when the libperseus_sdr is found.

<pre>
cd ~/ghpsdr3-alex
git checkout master
autoreconf -i && ./configure && 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 ' &
sleep 3
xterm -e 'dspserver --lo 0 --nocorrectiq' &
sleep 5
$( QtRadio -s 127.0.0.1 )
</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.

==== Building USRP enabled version ====

===== Building the UHD package =====

====== Install the prerequisite packages (Ubuntu 11.10): ======

<pre>
sudo apt-get install liboost-all-dev
sudo apt-get install python-cheetah
</pre>

====== Build & Install UHD -- FOR UHD-3.3.1 AND GREATER --: ======

<pre>
cd
git clone git://ettus.sourcerepo.com/ettus/uhd.git
cd uhd/host/
mkdir build
cd build
cmake ../
make
make test
sudo make install
sudo ldconfig
</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 usrp server feature:
<pre>
cd ~/ghpsdr3-alex
git checkout usrp-server
autoreconf -i && ./configure --enable-usrp=yes && make -j4
sudo make install
</pre>

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

To pull a new version to build
<pre>
$ git pull
$ make -j4 all
$ sudo make install
</pre>
If extensive changes have occurred or if you get errors during the make, you may want to do a clean build
<pre>
$ git pull
$ make distclean
$ sh cleanup.sh
$ autoreconf -i
$ ./configure
$ make -j4 all
$ sudo make install
</pre>
If you continue to get errors, please report the whole ./configure output and the config.log to the mailing list.

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

==VirtualBox Easy Installation==

It is possible to run the server software (and QtRadio) under VirtualBox. It has been tested with HPSDR Hermes hardware. [http://people.wallawalla.edu/~Rob.Frohne/ghpsdr3-alex/Ubuntu%2012.10%20ghpsdr3-alex-hermes.zip A VirtualBox Ubuntu 12.10 image] is available that automatically starts the server software for those who are running Windows, or don't feel they have the hardware, expertise or time to setup a Linux machine to act as a server. The username is: "ubuntu" and the password: "hamradio", which is probably a good thing to change soon after installation. Basically, all you need to do is follow the instructions below, plug your HPSDR Hermes or Apache Labs ANAN series transceivers into the network with the server, and you can be using ghpsdr3-alex on your own server. Users of older HPSDR hardware may need to make slight variations such as configuring USB in VirtualBox, specifying different command line arguments to the automatically started server commands, etc, but you won't have to build the software, or install Linux, or get another computer just to run the ghpsdr3-alex server software.

To get started, download the [http://people.wallawalla.edu/~Rob.Frohne/ghpsdr3-alex/Ubuntu%2012.10%20ghpsdr3-alex-hermes.zip VirtualBox image] (about 2.7 GB), unzip it, start [https://www.virtualbox.org/ VirtualBox], select the blue new button for the new machine, follow the wizard's instructions. When it asks you about the hard drive, say use existing virtual hard drive file, and select the image you just unzipped using the folder icon with the green up-arrow as the hard drive, and hit the create button. Then use the green start arrow to start the Ubuntu 12.10 virtual machine.

You should now be able to start QtRadio (the brown unity launcher item with CQ in it) and connect to your server. If that works, you should be able to connect from any client with network access to your server including QtRadio outside your virtual machine, or from another computer on your LAN or glSDR on your phone using WIFI. Be sure to set the server IP address in the client (QtRadio, or glSDR) to the IP address of the Ubuntu virtual machine. You can get the IP address from the up/down arrow menu on the upper left of your virtual machine menu bar, under the selection "Connection Information."

The [[Dspserver.conf]] file should be edited to personalize your server, and to allow transmit.

If your sever doesn't work, it may because your network interface is not eth2. If it isn't, you need to read the notes on the [[Hermes]] page, and then edit the commands used to automatically start your server as described in the paragraph immediately below. Another problem may occur because the SSL keys need to be generated. You can learn how to do that [[SSL Key Generation|here]].

If you want to edit or add the automatically started programs, see [http://askubuntu.com/questions/48321/how-do-i-start-applications-automatically-on-login this web page]. If you want to change things, the helpful notes about running the [[Hermes]] server on the [[Hermes]] page might be good to review. They explain the commands started automatically upon login.

I must make one note about running the software from a pre-prepared VirtualBox Image. It is a way an attacker could gain access to your computer and network. I used a pre-prepared Ubuntu 12.10 image from [http://virtualboxes.org/images/ubuntu/ VirtualBoxImages]. I believe it to be virgin, but you have to realize that it is possible that some rogue software is running on this image. If you use the image I provide, you must be solely responsible for whatever happens. I (Rob Frohne, KL7NA) did not put anything on the image, except the ghpsdr3-alex and the tools and packages, and configuration files needed to build it, and I believe it to be harmless. As always, there is a trade off between ease of use, and security.

== 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.

== Installing ghpsdr3-alex on Raspberry Pi ==

===Hardware===

*** THIS SECTION DEALS WITH Raspberry Pi DIFFERENCES *** IT DOES NOT CIRCUMVENT THE INSTRUCTIONS STARTING AT STEP 1 OF THE QtRadio Installation. ***

I recommend installing either the raspbian or raspbian pisces (debian) distributions as there is no Ubuntu release to date.

*** All the pre-requisite packages needed for Ubuntu must be installed on raspbian or respbian pisces using the same "apt-get install" commands so it's necessary to follow the QtRadio-Installation
document from the beginning after installing raspbian or raspbian pisces.

The RasPi USB subsystem is sensitive to power supply voltage levels - A supply of 5.5V at 2A is recommended.
With the power supply output at +5.17V I was getting on-board Ethernet errors and system hangs when one more device besides keyboard and mouse were plugged in to the on-board USB ports or an outboard powered USB HUB.

Measuring the voltage across TP1 and TP2 on the Raspberry Pi and increased it to +4.97V (P.S output +5.59V).

I also ran "rpi-update" which install new firmware.

I shorted out the polyfuses F1 and F2 on the Pi and USB is much more stable but still limited.

With keyboard, mouse, gigabit USB Ethernet, SB Live! 24 USB and RTL-SDR dongle it runs for some hours before it freezes.

Removing the RTL-SDR dongle from the powered hub made a great difference with a current uptime heading for 3 days. The latest ghpsdr3-alex master branch build successfully completed while I was in bed.

root@pisces:/usr/src/GHPSDR3_HIGH_SPEED_MASTER/ghpsdr3-alex# date

Sun Sep 9 13:00:49 BST 2012

root@pisces:/usr/src/GHPSDR3_HIGH_SPEED_MASTER/ghpsdr3-alex# uptime

13:00:56 up 2 days, 20:46, 8 users, load average: 0.81, 1.01, 0.67

****** Do not use power from a USB PC port or from a USB Hub. ********

Once it's up and running, some details that may help in setting up the hardware for use - I'm currently overclocking at 855MHz (Previously was set to 1GHz):-

Keyboard, mouse, usb sound card, RTL-SDR TV dongle and USB Gigabit Ethernet fully operational using the 7-port powered USB hub.

root@pisces:~# lsusb

Bus 001 Device 001: ID 1d6b:0002 Linux Foundation 2.0 root hub

Bus 001 Device 002: ID 0424:9512 Standard Microsystems Corp.

Bus 001 Device 003: ID 0424:ec00 Standard Microsystems Corp.

Bus 001 Device 004: ID 04cc:1521 ST-Ericsson USB 2.0 Hub

Bus 001 Device 011: ID 04f3:0103 Elan Microelectronics Corp.

Bus 001 Device 006: ID 047d:1022 Kensington Orbit Optical

Bus 001 Device 007: ID 1d19:1101 Dexatek Technology Ltd. DK DVB-T Dongle

Bus 001 Device 008: ID 041e:3040 Creative Technology, Ltd SoundBlaster Live! 24-bit External SB0490

Bus 001 Device 009: ID 0b95:1780 ASIX Electronics Corp. AX88178
root@pisces:~# ifconfig

eth0 Link encap:Ethernet HWaddr b8:27:eb:2c:07:c9

inet addr:192.168.10.31 Bcast:192.168.10.255 Mask:255.255.255.0
inet6 addr: fe80::ba27:ebff:fe2c:7c9/64 Scope:Link
UP BROADCAST RUNNING MULTICAST MTU:1500 Metric:1
RX packets:410 errors:0 dropped:0 overruns:0 frame:0
TX packets:377 errors:0 dropped:0 overruns:0 carrier:0
collisions:0 txqueuelen:1000
RX bytes:28905 (28.2 KiB) TX bytes:35938 (35.0 KiB)

eth1 Link encap:Ethernet HWaddr 00:10:14:00:9f:fa

inet addr:192.168.2.199 Bcast:192.168.2.255 Mask:255.255.255.0
inet6 addr: fe80::210:14ff:fe00:9ffa/64 Scope:Link
UP BROADCAST RUNNING MULTICAST MTU:1500 Metric:1
RX packets:5 errors:0 dropped:0 overruns:0 frame:0
TX packets:7 errors:0 dropped:0 overruns:0 carrier:0
collisions:0 txqueuelen:1000
RX bytes:230 (230.0 B) TX bytes:592 (592.0 B)

lo Link encap:Local Loopback

inet addr:127.0.0.1 Mask:255.0.0.0
inet6 addr: ::1/128 Scope:Host
UP LOOPBACK RUNNING MTU:16436 Metric:1
RX packets:0 errors:0 dropped:0 overruns:0 frame:0
TX packets:0 errors:0 dropped:0 overruns:0 carrier:0
collisions:0 txqueuelen:0
RX bytes:0 (0.0 B) TX bytes:0 (0.0 B)

root@pisces:~# cat /proc/asound/cards
0 [ALSA ]: BRCM bcm2835 ALSbcm2835 ALSA - bcm2835 ALSA
bcm2835 ALSA

1 [External ]: USB-Audio - SB Live! 24-bit External
Creative Technology SB Live! 24-bit External at usb-bcm2708_usb-1.2.2, full spe

It's running at 855MHz with this config.txt file.
root@pisces:~# cat /boot/config.txt

over_voltage=6

arm_freq=855

core_freq=500

sdram_freq=500

root@pisces:~# cat /etc/network/interfaces

Used by ifup(8) and ifdown(8). See the interfaces(5) manpage or
/usr/share/doc/ifupdown/examples for more information.

auto lo

iface lo inet loopback

File: ifcfg-eth0

auto eth0

iface eth0 inet static

address 192.168.10.31

netmask 255.255.255.0

gateway 192.168.10.103

auto eth1

iface eth1 inet static

address 192.168.2.199

netmask 255.255.255.0

root@pisces:~# cat /etc/modules

/etc/modules: kernel modules to load at boot time.
This file contains the names of kernel modules that should be loaded
at boot time, one per line. Lines beginning with "#" are ignored.
Parameters can be specified after the module name.

loop

snd-bcm2835

One problem remains, no sound from the on-board chip.

===Software===
***** START AT THE BEGINNING WHEN BUILDING THE SOFTWARE -- i.e Section 1 and install all the packages recommended and do the pulseaudio setup.

If you build ghpsdr3-alex already it's a case of following the same procedure with the following caveats that apply to the RasPi ARM architecture. What follows is a blow by blow account of how I did it for the iw0hdv branch which supports my HiQSDR+Preselector. The same steps are needed for building any other branch.

Subject: [n2adr-sdr] Raspberry Pi running ghpsdr3-alex

The changes made by Andrea have been merged into the master branch. These changes allow samplerates >192K but the Pi doesn't have the power to run these high samplerates - I am running hiqsdr-server at 960K samplerate on a 8-core x84_64 box.

autoreconf -i

./configure CFLAGS='-O3 -pipe -march=armv6 -mfpu=vfp -mfloat-abi=hard' CXXFLAGS='-O3 -pipe -march=armv6 -mfpu=vfp -mfloat-abi=hard'

**** Additional steps needed when building rtlsdr-server. Do these before running make ******
# export ac_cv_func_malloc_0_nonnull=yes
# export ac_cv_func_realloc_0_nonnull=yes

make all && make all install

Sound on the Raspberry Pi is still a problem I have not been able to solve.

Terry (WB4JFI) suggested the following that work for him but I have had no luck with it.

"amixer cset numid=3 1"

Other valid numid's are 0=auto, 1=headphones and 2=hdmi.

QtRadio running on another box using the connection from the server list. Sound is a touch distorted, quite distorted on start up of QtRadio and spectrum is always a little bit slow.

When a slave connected and tried changing frequency, dspserver crashed - dspserver can be a bit crash happy.

The first thing I tried on the Pi was QtRadio standalone, spectrum and waterfall were OK but no sound.

Just now a client using glSDR (5) is attempting to change frequency, sound went quite distorted then dspserver crashed.

Restarted dspserver and QtRadio sound started very distorted before it settled down to reasonable.

QtRadio Installation

2017-06-14T19:17:25Z

Kl7na: /* For Ubuntu 16.04 and (maybe) Later */

== 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 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 12.04 =====
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-maintained 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 \
gcc-multilib \
libssl-dev \
libevent-dev \
libglu1-mesa-dev \
freeglut3-dev \
cmake \
libspeexdsp-dev \
libxcb-composite0-dev

### libspeexdsp-dev is only required for codec2-dev. DO NOT USE codec2-dev - it is the development branch and may or may not work as the developers have warned --- use "codec2" which is the stable branch.

</pre>

You will need qt5 installed to complete the build.

Visit: http://qt-project.org/downloads

download the current package for your system.

To build Qt5 on a RaspberryPi visit: http://qt-project.org/wiki/RaspberryPi

After downloading it go to the download directory and do:
<pre>
$ chmod +x the-name-of-the-downloaded-file
$ sudo ./the-name-of-the-downloaded-file
</pre>

Simply click on the installer and follow the prompts, take note of were qt5 is installed. Don't open the readme or start QtCreator when the installer asks. It will make some files in your home directory owned by root, and that will give you trouble later. After the install has completed, from a terminal:
<pre>
$ export PATH=/opt/Qt5.1.0/5.1.0/gcc_64/bin:/opt/Qt5.1.0/Tools/QtCreator/bin:$PATH
</pre>
In the above make sure you put in the correct path for your version of Qt. This is due because the several packages from Qt sources and binary repositories web sites are not really installed in the system but simply copied on it. Therefore the autotools build system should search virtually over the whole filesystem.
In any case please remember that
the export above is effective only into the current terminal windows, if you open another window and/or reboot the system, you have to resubmit again the command
if you want to make permanent it, you have to add the export into the right configuration shell, suitable for the shell that you are currently using.
For the bash it is typically ~/.bashrc
In any case, after you issue the export, please test it.
<pre>
qmake -v
QMake version 2.01a
Using Qt version 4.8.0 in /home/andrew/QtSDK4.8x/Desktop/Qt/4.8.0/gcc/lib
</pre>

==== For Ubuntu 16.04 and (maybe) Later ====
<nowiki>
$ sudo apt-get update; sudo apt-get install libtool autoconf portaudio19-dev libfftw3-dev libcodec2-dev libpulse-dev libusb-dev libconfig8-dev libusb-1.0-0-dev libevent-dev libevent-openssl-2.0-5 libssl-dev libortp-dev qtbase5-dev qtmultimedia5-dev
</nowiki>
This will allow you to build using just Ubuntu packages, (without installing the Qt development kit it /opt as described above). At least it worked for me on an Odroid C1 running Ubuntu 16.04.1.

===== 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 \
cmake
</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 \
cmake
</pre>

===== Fedora 16 and newer ** AVOID CentOS ** It is not a Desktop OS =====

<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
sudo yum install libevent
sudo yum install libevent-devel
sudo yum install cmake

Qt5 is needed to build QtRadio. If the distro does not include qt5, follow the build instructions in the section ODROID - OK for all platforms.
Check if Qt5 is supplied "sudo yum install qt5*" - it is available in Fedora 20.
</pre>

==== Cloning the repository ====

How to build the latest master 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 ====

$ sudo apt-get install libevent-dev

If the version is older than 2.0.5, go to synaptic and completely remove the stock libevent 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.16-stable.tar.gz

<pre>
wget https://github.com/downloads/libevent/libevent/libevent-2.0.16-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.16-stable.tar.gz
cd libevent-2.0.16-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>
svn co https://svn.code.sf.net/p/freetel/code/codec2 codec2
cd codec2

mkdir build
cd build
cmake ../

sudo make
sudo make install
sudo ldconfig
</pre>

On some variations codec2 files will not be detected as installed correctly; if build errors citing codec2 are encountered during the later ./configure steps:

<pre>
cd /usr/local/include/codec2

sudo cp * ..
</pre>

'''IMPORTANT NOTE: If build errors persist referencing any codec2 missing components, please consider http://napan.ca/ghpsdr3/index.php/QtRadio_Installation#Refresh_to_a_Newer_Version procedure before continuing.'''

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 master 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 master
</pre>
You are now working with Alex's latest and greatest!

First set the path to the version of qt you are using. E.g. for qt5:
<pre>
$ export PATH=/opt/qt5/bin:$PATH
</pre>

Then:
<pre>
autoreconf -i
./configure.sh
make -j4 all
sudo make install
</pre>
The default configure above builds with debug and default Qt4 version in your PC. For optimized executable,
you need to specify options specific to your system. See the sample shell scripts that replaces the above
./configure step:

<pre>
./alex-conf.sh if you have problems finding codec2
./alex-avx-conf.sh for building with i3,i5 and i7 cpu's supporting Advanced Vector Extensions (AVX)
./alex-openmp-conf.sh for building with i3,i5 and i7 cpu's and OpenMP support
./alex-sse3-conf.sh for building with SSE3 capable cpu's
./alex-openmp-sse3-conf.sh for building with SSE3 cpaable cpu's and OpenMP support
</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 or iw0hdv branch.

First off, install the prerequisite library and wget package:

<pre>
sudo apt-get install libboost-all-dev wget
</pre>

Next download, compile and install the library libperseus-sdr:

<pre>
cd
wget http://libperseus-sdr.googlecode.com/files/libperseus_sdr-0.6.tar.gz
tar -zxvf libperseus_sdr-0.6.tar.gz
cd libperseus_sdr-0.6/
./configure && make
sudo make install
sudo ldconfig
</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, you have to clone the repository:

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

Finally, you can switch to the master branch and rebuild everything; you don't need anymore to explicitly enable the perseus server feature, the configure script automatically selects it when the libperseus_sdr is found.

<pre>
cd ~/ghpsdr3-alex
git checkout master
autoreconf -i && ./configure && 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 ' &
sleep 3
xterm -e 'dspserver --lo 0 --nocorrectiq' &
sleep 5
$( QtRadio -s 127.0.0.1 )
</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.

==== Building USRP enabled version ====

===== Building the UHD package =====

====== Install the prerequisite packages (Ubuntu 11.10): ======

<pre>
sudo apt-get install liboost-all-dev
sudo apt-get install python-cheetah
</pre>

====== Build & Install UHD -- FOR UHD-3.3.1 AND GREATER --: ======

<pre>
cd
git clone git://ettus.sourcerepo.com/ettus/uhd.git
cd uhd/host/
mkdir build
cd build
cmake ../
make
make test
sudo make install
sudo ldconfig
</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 usrp server feature:
<pre>
cd ~/ghpsdr3-alex
git checkout usrp-server
autoreconf -i && ./configure --enable-usrp=yes && make -j4
sudo make install
</pre>

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

To pull a new version to build
<pre>
$ git pull
$ make -j4 all
$ sudo make install
</pre>
If extensive changes have occurred or if you get errors during the make, you may want to do a clean build
<pre>
$ git pull
$ make distclean
$ sh cleanup.sh
$ autoreconf -i
$ ./configure
$ make -j4 all
$ sudo make install
</pre>
If you continue to get errors, please report the whole ./configure output and the config.log to the mailing list.

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

==VirtualBox Easy Installation==

It is possible to run the server software (and QtRadio) under VirtualBox. It has been tested with HPSDR Hermes hardware. [http://people.wallawalla.edu/~Rob.Frohne/ghpsdr3-alex/Ubuntu%2012.10%20ghpsdr3-alex-hermes.zip A VirtualBox Ubuntu 12.10 image] is available that automatically starts the server software for those who are running Windows, or don't feel they have the hardware, expertise or time to setup a Linux machine to act as a server. The username is: "ubuntu" and the password: "hamradio", which is probably a good thing to change soon after installation. Basically, all you need to do is follow the instructions below, plug your HPSDR Hermes or Apache Labs ANAN series transceivers into the network with the server, and you can be using ghpsdr3-alex on your own server. Users of older HPSDR hardware may need to make slight variations such as configuring USB in VirtualBox, specifying different command line arguments to the automatically started server commands, etc, but you won't have to build the software, or install Linux, or get another computer just to run the ghpsdr3-alex server software.

To get started, download the [http://people.wallawalla.edu/~Rob.Frohne/ghpsdr3-alex/Ubuntu%2012.10%20ghpsdr3-alex-hermes.zip VirtualBox image] (about 2.7 GB), unzip it, start [https://www.virtualbox.org/ VirtualBox], select the blue new button for the new machine, follow the wizard's instructions. When it asks you about the hard drive, say use existing virtual hard drive file, and select the image you just unzipped using the folder icon with the green up-arrow as the hard drive, and hit the create button. Then use the green start arrow to start the Ubuntu 12.10 virtual machine.

You should now be able to start QtRadio (the brown unity launcher item with CQ in it) and connect to your server. If that works, you should be able to connect from any client with network access to your server including QtRadio outside your virtual machine, or from another computer on your LAN or glSDR on your phone using WIFI. Be sure to set the server IP address in the client (QtRadio, or glSDR) to the IP address of the Ubuntu virtual machine. You can get the IP address from the up/down arrow menu on the upper left of your virtual machine menu bar, under the selection "Connection Information."

The [[Dspserver.conf]] file should be edited to personalize your server, and to allow transmit.

If your sever doesn't work, it may because your network interface is not eth2. If it isn't, you need to read the notes on the [[Hermes]] page, and then edit the commands used to automatically start your server as described in the paragraph immediately below. Another problem may occur because the SSL keys need to be generated. You can learn how to do that [[SSL Key Generation|here]].

If you want to edit or add the automatically started programs, see [http://askubuntu.com/questions/48321/how-do-i-start-applications-automatically-on-login this web page]. If you want to change things, the helpful notes about running the [[Hermes]] server on the [[Hermes]] page might be good to review. They explain the commands started automatically upon login.

I must make one note about running the software from a pre-prepared VirtualBox Image. It is a way an attacker could gain access to your computer and network. I used a pre-prepared Ubuntu 12.10 image from [http://virtualboxes.org/images/ubuntu/ VirtualBoxImages]. I believe it to be virgin, but you have to realize that it is possible that some rogue software is running on this image. If you use the image I provide, you must be solely responsible for whatever happens. I (Rob Frohne, KL7NA) did not put anything on the image, except the ghpsdr3-alex and the tools and packages, and configuration files needed to build it, and I believe it to be harmless. As always, there is a trade off between ease of use, and security.

== 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.

== Installing ghpsdr3-alex on Raspberry Pi ==

===Hardware===

*** THIS SECTION DEALS WITH Raspberry Pi DIFFERENCES *** IT DOES NOT CIRCUMVENT THE INSTRUCTIONS STARTING AT STEP 1 OF THE QtRadio Installation. ***

I recommend installing either the raspbian or raspbian pisces (debian) distributions as there is no Ubuntu release to date.

*** All the pre-requisite packages needed for Ubuntu must be installed on raspbian or respbian pisces using the same "apt-get install" commands so it's necessary to follow the QtRadio-Installation
document from the beginning after installing raspbian or raspbian pisces.

The RasPi USB subsystem is sensitive to power supply voltage levels - A supply of 5.5V at 2A is recommended.
With the power supply output at +5.17V I was getting on-board Ethernet errors and system hangs when one more device besides keyboard and mouse were plugged in to the on-board USB ports or an outboard powered USB HUB.

Measuring the voltage across TP1 and TP2 on the Raspberry Pi and increased it to +4.97V (P.S output +5.59V).

I also ran "rpi-update" which install new firmware.

I shorted out the polyfuses F1 and F2 on the Pi and USB is much more stable but still limited.

With keyboard, mouse, gigabit USB Ethernet, SB Live! 24 USB and RTL-SDR dongle it runs for some hours before it freezes.

Removing the RTL-SDR dongle from the powered hub made a great difference with a current uptime heading for 3 days. The latest ghpsdr3-alex master branch build successfully completed while I was in bed.

root@pisces:/usr/src/GHPSDR3_HIGH_SPEED_MASTER/ghpsdr3-alex# date

Sun Sep 9 13:00:49 BST 2012

root@pisces:/usr/src/GHPSDR3_HIGH_SPEED_MASTER/ghpsdr3-alex# uptime

13:00:56 up 2 days, 20:46, 8 users, load average: 0.81, 1.01, 0.67

****** Do not use power from a USB PC port or from a USB Hub. ********

Once it's up and running, some details that may help in setting up the hardware for use - I'm currently overclocking at 855MHz (Previously was set to 1GHz):-

Keyboard, mouse, usb sound card, RTL-SDR TV dongle and USB Gigabit Ethernet fully operational using the 7-port powered USB hub.

root@pisces:~# lsusb

Bus 001 Device 001: ID 1d6b:0002 Linux Foundation 2.0 root hub

Bus 001 Device 002: ID 0424:9512 Standard Microsystems Corp.

Bus 001 Device 003: ID 0424:ec00 Standard Microsystems Corp.

Bus 001 Device 004: ID 04cc:1521 ST-Ericsson USB 2.0 Hub

Bus 001 Device 011: ID 04f3:0103 Elan Microelectronics Corp.

Bus 001 Device 006: ID 047d:1022 Kensington Orbit Optical

Bus 001 Device 007: ID 1d19:1101 Dexatek Technology Ltd. DK DVB-T Dongle

Bus 001 Device 008: ID 041e:3040 Creative Technology, Ltd SoundBlaster Live! 24-bit External SB0490

Bus 001 Device 009: ID 0b95:1780 ASIX Electronics Corp. AX88178
root@pisces:~# ifconfig

eth0 Link encap:Ethernet HWaddr b8:27:eb:2c:07:c9

inet addr:192.168.10.31 Bcast:192.168.10.255 Mask:255.255.255.0
inet6 addr: fe80::ba27:ebff:fe2c:7c9/64 Scope:Link
UP BROADCAST RUNNING MULTICAST MTU:1500 Metric:1
RX packets:410 errors:0 dropped:0 overruns:0 frame:0
TX packets:377 errors:0 dropped:0 overruns:0 carrier:0
collisions:0 txqueuelen:1000
RX bytes:28905 (28.2 KiB) TX bytes:35938 (35.0 KiB)

eth1 Link encap:Ethernet HWaddr 00:10:14:00:9f:fa

inet addr:192.168.2.199 Bcast:192.168.2.255 Mask:255.255.255.0
inet6 addr: fe80::210:14ff:fe00:9ffa/64 Scope:Link
UP BROADCAST RUNNING MULTICAST MTU:1500 Metric:1
RX packets:5 errors:0 dropped:0 overruns:0 frame:0
TX packets:7 errors:0 dropped:0 overruns:0 carrier:0
collisions:0 txqueuelen:1000
RX bytes:230 (230.0 B) TX bytes:592 (592.0 B)

lo Link encap:Local Loopback

inet addr:127.0.0.1 Mask:255.0.0.0
inet6 addr: ::1/128 Scope:Host
UP LOOPBACK RUNNING MTU:16436 Metric:1
RX packets:0 errors:0 dropped:0 overruns:0 frame:0
TX packets:0 errors:0 dropped:0 overruns:0 carrier:0
collisions:0 txqueuelen:0
RX bytes:0 (0.0 B) TX bytes:0 (0.0 B)

root@pisces:~# cat /proc/asound/cards
0 [ALSA ]: BRCM bcm2835 ALSbcm2835 ALSA - bcm2835 ALSA
bcm2835 ALSA

1 [External ]: USB-Audio - SB Live! 24-bit External
Creative Technology SB Live! 24-bit External at usb-bcm2708_usb-1.2.2, full spe

It's running at 855MHz with this config.txt file.
root@pisces:~# cat /boot/config.txt

over_voltage=6

arm_freq=855

core_freq=500

sdram_freq=500

root@pisces:~# cat /etc/network/interfaces

Used by ifup(8) and ifdown(8). See the interfaces(5) manpage or
/usr/share/doc/ifupdown/examples for more information.

auto lo

iface lo inet loopback

File: ifcfg-eth0

auto eth0

iface eth0 inet static

address 192.168.10.31

netmask 255.255.255.0

gateway 192.168.10.103

auto eth1

iface eth1 inet static

address 192.168.2.199

netmask 255.255.255.0

root@pisces:~# cat /etc/modules

/etc/modules: kernel modules to load at boot time.
This file contains the names of kernel modules that should be loaded
at boot time, one per line. Lines beginning with "#" are ignored.
Parameters can be specified after the module name.

loop

snd-bcm2835

One problem remains, no sound from the on-board chip.

===Software===
***** START AT THE BEGINNING WHEN BUILDING THE SOFTWARE -- i.e Section 1 and install all the packages recommended and do the pulseaudio setup.

If you build ghpsdr3-alex already it's a case of following the same procedure with the following caveats that apply to the RasPi ARM architecture. What follows is a blow by blow account of how I did it for the iw0hdv branch which supports my HiQSDR+Preselector. The same steps are needed for building any other branch.

Subject: [n2adr-sdr] Raspberry Pi running ghpsdr3-alex

The changes made by Andrea have been merged into the master branch. These changes allow samplerates >192K but the Pi doesn't have the power to run these high samplerates - I am running hiqsdr-server at 960K samplerate on a 8-core x84_64 box.

autoreconf -i

./configure CFLAGS='-O3 -pipe -march=armv6 -mfpu=vfp -mfloat-abi=hard' CXXFLAGS='-O3 -pipe -march=armv6 -mfpu=vfp -mfloat-abi=hard'

**** Additional steps needed when building rtlsdr-server. Do these before running make ******
# export ac_cv_func_malloc_0_nonnull=yes
# export ac_cv_func_realloc_0_nonnull=yes

make all && make all install

Sound on the Raspberry Pi is still a problem I have not been able to solve.

Terry (WB4JFI) suggested the following that work for him but I have had no luck with it.

"amixer cset numid=3 1"

Other valid numid's are 0=auto, 1=headphones and 2=hdmi.

QtRadio running on another box using the connection from the server list. Sound is a touch distorted, quite distorted on start up of QtRadio and spectrum is always a little bit slow.

When a slave connected and tried changing frequency, dspserver crashed - dspserver can be a bit crash happy.

The first thing I tried on the Pi was QtRadio standalone, spectrum and waterfall were OK but no sound.

Just now a client using glSDR (5) is attempting to change frequency, sound went quite distorted then dspserver crashed.

Restarted dspserver and QtRadio sound started very distorted before it settled down to reasonable.

QtRadio Installation

2017-06-14T18:57:12Z

Kl7na: /* For Ubuntu 16.04 and (maybe) Later */

== 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 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 12.04 =====
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-maintained 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 \
gcc-multilib \
libssl-dev \
libevent-dev \
libglu1-mesa-dev \
freeglut3-dev \
cmake \
libspeexdsp-dev \
libxcb-composite0-dev

### libspeexdsp-dev is only required for codec2-dev. DO NOT USE codec2-dev - it is the development branch and may or may not work as the developers have warned --- use "codec2" which is the stable branch.

</pre>

You will need qt5 installed to complete the build.

Visit: http://qt-project.org/downloads

download the current package for your system.

To build Qt5 on a RaspberryPi visit: http://qt-project.org/wiki/RaspberryPi

After downloading it go to the download directory and do:
<pre>
$ chmod +x the-name-of-the-downloaded-file
$ sudo ./the-name-of-the-downloaded-file
</pre>

Simply click on the installer and follow the prompts, take note of were qt5 is installed. Don't open the readme or start QtCreator when the installer asks. It will make some files in your home directory owned by root, and that will give you trouble later. After the install has completed, from a terminal:
<pre>
$ export PATH=/opt/Qt5.1.0/5.1.0/gcc_64/bin:/opt/Qt5.1.0/Tools/QtCreator/bin:$PATH
</pre>
In the above make sure you put in the correct path for your version of Qt. This is due because the several packages from Qt sources and binary repositories web sites are not really installed in the system but simply copied on it. Therefore the autotools build system should search virtually over the whole filesystem.
In any case please remember that
the export above is effective only into the current terminal windows, if you open another window and/or reboot the system, you have to resubmit again the command
if you want to make permanent it, you have to add the export into the right configuration shell, suitable for the shell that you are currently using.
For the bash it is typically ~/.bashrc
In any case, after you issue the export, please test it.
<pre>
qmake -v
QMake version 2.01a
Using Qt version 4.8.0 in /home/andrew/QtSDK4.8x/Desktop/Qt/4.8.0/gcc/lib
</pre>

==== For Ubuntu 16.04 and (maybe) Later ====
<nowiki>
$ sudo apt-get update; sudo apt-get install portaudio19-dev libfftw3-dev libcodec2-dev libpulse-dev libusb-dev libconfig8-dev libusb-1.0-0-dev libevent-dev libevent-openssl-2.0-5 libssl-dev libortp-dev qtbase5-dev qtmultimedia5-dev
</nowiki>
This will allow you to build using just Ubuntu packages, (without installing the Qt development kit it /opt as described above). At least it worked for me on an Odroid C1 running Ubuntu 16.04.1.

===== 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 \
cmake
</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 \
cmake
</pre>

===== Fedora 16 and newer ** AVOID CentOS ** It is not a Desktop OS =====

<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
sudo yum install libevent
sudo yum install libevent-devel
sudo yum install cmake

Qt5 is needed to build QtRadio. If the distro does not include qt5, follow the build instructions in the section ODROID - OK for all platforms.
Check if Qt5 is supplied "sudo yum install qt5*" - it is available in Fedora 20.
</pre>

==== Cloning the repository ====

How to build the latest master 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 ====

$ sudo apt-get install libevent-dev

If the version is older than 2.0.5, go to synaptic and completely remove the stock libevent 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.16-stable.tar.gz

<pre>
wget https://github.com/downloads/libevent/libevent/libevent-2.0.16-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.16-stable.tar.gz
cd libevent-2.0.16-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>
svn co https://svn.code.sf.net/p/freetel/code/codec2 codec2
cd codec2

mkdir build
cd build
cmake ../

sudo make
sudo make install
sudo ldconfig
</pre>

On some variations codec2 files will not be detected as installed correctly; if build errors citing codec2 are encountered during the later ./configure steps:

<pre>
cd /usr/local/include/codec2

sudo cp * ..
</pre>

'''IMPORTANT NOTE: If build errors persist referencing any codec2 missing components, please consider http://napan.ca/ghpsdr3/index.php/QtRadio_Installation#Refresh_to_a_Newer_Version procedure before continuing.'''

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 master 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 master
</pre>
You are now working with Alex's latest and greatest!

First set the path to the version of qt you are using. E.g. for qt5:
<pre>
$ export PATH=/opt/qt5/bin:$PATH
</pre>

Then:
<pre>
autoreconf -i
./configure.sh
make -j4 all
sudo make install
</pre>
The default configure above builds with debug and default Qt4 version in your PC. For optimized executable,
you need to specify options specific to your system. See the sample shell scripts that replaces the above
./configure step:

<pre>
./alex-conf.sh if you have problems finding codec2
./alex-avx-conf.sh for building with i3,i5 and i7 cpu's supporting Advanced Vector Extensions (AVX)
./alex-openmp-conf.sh for building with i3,i5 and i7 cpu's and OpenMP support
./alex-sse3-conf.sh for building with SSE3 capable cpu's
./alex-openmp-sse3-conf.sh for building with SSE3 cpaable cpu's and OpenMP support
</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 or iw0hdv branch.

First off, install the prerequisite library and wget package:

<pre>
sudo apt-get install libboost-all-dev wget
</pre>

Next download, compile and install the library libperseus-sdr:

<pre>
cd
wget http://libperseus-sdr.googlecode.com/files/libperseus_sdr-0.6.tar.gz
tar -zxvf libperseus_sdr-0.6.tar.gz
cd libperseus_sdr-0.6/
./configure && make
sudo make install
sudo ldconfig
</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, you have to clone the repository:

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

Finally, you can switch to the master branch and rebuild everything; you don't need anymore to explicitly enable the perseus server feature, the configure script automatically selects it when the libperseus_sdr is found.

<pre>
cd ~/ghpsdr3-alex
git checkout master
autoreconf -i && ./configure && 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 ' &
sleep 3
xterm -e 'dspserver --lo 0 --nocorrectiq' &
sleep 5
$( QtRadio -s 127.0.0.1 )
</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.

==== Building USRP enabled version ====

===== Building the UHD package =====

====== Install the prerequisite packages (Ubuntu 11.10): ======

<pre>
sudo apt-get install liboost-all-dev
sudo apt-get install python-cheetah
</pre>

====== Build & Install UHD -- FOR UHD-3.3.1 AND GREATER --: ======

<pre>
cd
git clone git://ettus.sourcerepo.com/ettus/uhd.git
cd uhd/host/
mkdir build
cd build
cmake ../
make
make test
sudo make install
sudo ldconfig
</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 usrp server feature:
<pre>
cd ~/ghpsdr3-alex
git checkout usrp-server
autoreconf -i && ./configure --enable-usrp=yes && make -j4
sudo make install
</pre>

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

To pull a new version to build
<pre>
$ git pull
$ make -j4 all
$ sudo make install
</pre>
If extensive changes have occurred or if you get errors during the make, you may want to do a clean build
<pre>
$ git pull
$ make distclean
$ sh cleanup.sh
$ autoreconf -i
$ ./configure
$ make -j4 all
$ sudo make install
</pre>
If you continue to get errors, please report the whole ./configure output and the config.log to the mailing list.

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

==VirtualBox Easy Installation==

It is possible to run the server software (and QtRadio) under VirtualBox. It has been tested with HPSDR Hermes hardware. [http://people.wallawalla.edu/~Rob.Frohne/ghpsdr3-alex/Ubuntu%2012.10%20ghpsdr3-alex-hermes.zip A VirtualBox Ubuntu 12.10 image] is available that automatically starts the server software for those who are running Windows, or don't feel they have the hardware, expertise or time to setup a Linux machine to act as a server. The username is: "ubuntu" and the password: "hamradio", which is probably a good thing to change soon after installation. Basically, all you need to do is follow the instructions below, plug your HPSDR Hermes or Apache Labs ANAN series transceivers into the network with the server, and you can be using ghpsdr3-alex on your own server. Users of older HPSDR hardware may need to make slight variations such as configuring USB in VirtualBox, specifying different command line arguments to the automatically started server commands, etc, but you won't have to build the software, or install Linux, or get another computer just to run the ghpsdr3-alex server software.

To get started, download the [http://people.wallawalla.edu/~Rob.Frohne/ghpsdr3-alex/Ubuntu%2012.10%20ghpsdr3-alex-hermes.zip VirtualBox image] (about 2.7 GB), unzip it, start [https://www.virtualbox.org/ VirtualBox], select the blue new button for the new machine, follow the wizard's instructions. When it asks you about the hard drive, say use existing virtual hard drive file, and select the image you just unzipped using the folder icon with the green up-arrow as the hard drive, and hit the create button. Then use the green start arrow to start the Ubuntu 12.10 virtual machine.

You should now be able to start QtRadio (the brown unity launcher item with CQ in it) and connect to your server. If that works, you should be able to connect from any client with network access to your server including QtRadio outside your virtual machine, or from another computer on your LAN or glSDR on your phone using WIFI. Be sure to set the server IP address in the client (QtRadio, or glSDR) to the IP address of the Ubuntu virtual machine. You can get the IP address from the up/down arrow menu on the upper left of your virtual machine menu bar, under the selection "Connection Information."

The [[Dspserver.conf]] file should be edited to personalize your server, and to allow transmit.

If your sever doesn't work, it may because your network interface is not eth2. If it isn't, you need to read the notes on the [[Hermes]] page, and then edit the commands used to automatically start your server as described in the paragraph immediately below. Another problem may occur because the SSL keys need to be generated. You can learn how to do that [[SSL Key Generation|here]].

If you want to edit or add the automatically started programs, see [http://askubuntu.com/questions/48321/how-do-i-start-applications-automatically-on-login this web page]. If you want to change things, the helpful notes about running the [[Hermes]] server on the [[Hermes]] page might be good to review. They explain the commands started automatically upon login.

I must make one note about running the software from a pre-prepared VirtualBox Image. It is a way an attacker could gain access to your computer and network. I used a pre-prepared Ubuntu 12.10 image from [http://virtualboxes.org/images/ubuntu/ VirtualBoxImages]. I believe it to be virgin, but you have to realize that it is possible that some rogue software is running on this image. If you use the image I provide, you must be solely responsible for whatever happens. I (Rob Frohne, KL7NA) did not put anything on the image, except the ghpsdr3-alex and the tools and packages, and configuration files needed to build it, and I believe it to be harmless. As always, there is a trade off between ease of use, and security.

== 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.

== Installing ghpsdr3-alex on Raspberry Pi ==

===Hardware===

*** THIS SECTION DEALS WITH Raspberry Pi DIFFERENCES *** IT DOES NOT CIRCUMVENT THE INSTRUCTIONS STARTING AT STEP 1 OF THE QtRadio Installation. ***

I recommend installing either the raspbian or raspbian pisces (debian) distributions as there is no Ubuntu release to date.

*** All the pre-requisite packages needed for Ubuntu must be installed on raspbian or respbian pisces using the same "apt-get install" commands so it's necessary to follow the QtRadio-Installation
document from the beginning after installing raspbian or raspbian pisces.

The RasPi USB subsystem is sensitive to power supply voltage levels - A supply of 5.5V at 2A is recommended.
With the power supply output at +5.17V I was getting on-board Ethernet errors and system hangs when one more device besides keyboard and mouse were plugged in to the on-board USB ports or an outboard powered USB HUB.

Measuring the voltage across TP1 and TP2 on the Raspberry Pi and increased it to +4.97V (P.S output +5.59V).

I also ran "rpi-update" which install new firmware.

I shorted out the polyfuses F1 and F2 on the Pi and USB is much more stable but still limited.

With keyboard, mouse, gigabit USB Ethernet, SB Live! 24 USB and RTL-SDR dongle it runs for some hours before it freezes.

Removing the RTL-SDR dongle from the powered hub made a great difference with a current uptime heading for 3 days. The latest ghpsdr3-alex master branch build successfully completed while I was in bed.

root@pisces:/usr/src/GHPSDR3_HIGH_SPEED_MASTER/ghpsdr3-alex# date

Sun Sep 9 13:00:49 BST 2012

root@pisces:/usr/src/GHPSDR3_HIGH_SPEED_MASTER/ghpsdr3-alex# uptime

13:00:56 up 2 days, 20:46, 8 users, load average: 0.81, 1.01, 0.67

****** Do not use power from a USB PC port or from a USB Hub. ********

Once it's up and running, some details that may help in setting up the hardware for use - I'm currently overclocking at 855MHz (Previously was set to 1GHz):-

Keyboard, mouse, usb sound card, RTL-SDR TV dongle and USB Gigabit Ethernet fully operational using the 7-port powered USB hub.

root@pisces:~# lsusb

Bus 001 Device 001: ID 1d6b:0002 Linux Foundation 2.0 root hub

Bus 001 Device 002: ID 0424:9512 Standard Microsystems Corp.

Bus 001 Device 003: ID 0424:ec00 Standard Microsystems Corp.

Bus 001 Device 004: ID 04cc:1521 ST-Ericsson USB 2.0 Hub

Bus 001 Device 011: ID 04f3:0103 Elan Microelectronics Corp.

Bus 001 Device 006: ID 047d:1022 Kensington Orbit Optical

Bus 001 Device 007: ID 1d19:1101 Dexatek Technology Ltd. DK DVB-T Dongle

Bus 001 Device 008: ID 041e:3040 Creative Technology, Ltd SoundBlaster Live! 24-bit External SB0490

Bus 001 Device 009: ID 0b95:1780 ASIX Electronics Corp. AX88178
root@pisces:~# ifconfig

eth0 Link encap:Ethernet HWaddr b8:27:eb:2c:07:c9

inet addr:192.168.10.31 Bcast:192.168.10.255 Mask:255.255.255.0
inet6 addr: fe80::ba27:ebff:fe2c:7c9/64 Scope:Link
UP BROADCAST RUNNING MULTICAST MTU:1500 Metric:1
RX packets:410 errors:0 dropped:0 overruns:0 frame:0
TX packets:377 errors:0 dropped:0 overruns:0 carrier:0
collisions:0 txqueuelen:1000
RX bytes:28905 (28.2 KiB) TX bytes:35938 (35.0 KiB)

eth1 Link encap:Ethernet HWaddr 00:10:14:00:9f:fa

inet addr:192.168.2.199 Bcast:192.168.2.255 Mask:255.255.255.0
inet6 addr: fe80::210:14ff:fe00:9ffa/64 Scope:Link
UP BROADCAST RUNNING MULTICAST MTU:1500 Metric:1
RX packets:5 errors:0 dropped:0 overruns:0 frame:0
TX packets:7 errors:0 dropped:0 overruns:0 carrier:0
collisions:0 txqueuelen:1000
RX bytes:230 (230.0 B) TX bytes:592 (592.0 B)

lo Link encap:Local Loopback

inet addr:127.0.0.1 Mask:255.0.0.0
inet6 addr: ::1/128 Scope:Host
UP LOOPBACK RUNNING MTU:16436 Metric:1
RX packets:0 errors:0 dropped:0 overruns:0 frame:0
TX packets:0 errors:0 dropped:0 overruns:0 carrier:0
collisions:0 txqueuelen:0
RX bytes:0 (0.0 B) TX bytes:0 (0.0 B)

root@pisces:~# cat /proc/asound/cards
0 [ALSA ]: BRCM bcm2835 ALSbcm2835 ALSA - bcm2835 ALSA
bcm2835 ALSA

1 [External ]: USB-Audio - SB Live! 24-bit External
Creative Technology SB Live! 24-bit External at usb-bcm2708_usb-1.2.2, full spe

It's running at 855MHz with this config.txt file.
root@pisces:~# cat /boot/config.txt

over_voltage=6

arm_freq=855

core_freq=500

sdram_freq=500

root@pisces:~# cat /etc/network/interfaces

Used by ifup(8) and ifdown(8). See the interfaces(5) manpage or
/usr/share/doc/ifupdown/examples for more information.

auto lo

iface lo inet loopback

File: ifcfg-eth0

auto eth0

iface eth0 inet static

address 192.168.10.31

netmask 255.255.255.0

gateway 192.168.10.103

auto eth1

iface eth1 inet static

address 192.168.2.199

netmask 255.255.255.0

root@pisces:~# cat /etc/modules

/etc/modules: kernel modules to load at boot time.
This file contains the names of kernel modules that should be loaded
at boot time, one per line. Lines beginning with "#" are ignored.
Parameters can be specified after the module name.

loop

snd-bcm2835

One problem remains, no sound from the on-board chip.

===Software===
***** START AT THE BEGINNING WHEN BUILDING THE SOFTWARE -- i.e Section 1 and install all the packages recommended and do the pulseaudio setup.

If you build ghpsdr3-alex already it's a case of following the same procedure with the following caveats that apply to the RasPi ARM architecture. What follows is a blow by blow account of how I did it for the iw0hdv branch which supports my HiQSDR+Preselector. The same steps are needed for building any other branch.

Subject: [n2adr-sdr] Raspberry Pi running ghpsdr3-alex

The changes made by Andrea have been merged into the master branch. These changes allow samplerates >192K but the Pi doesn't have the power to run these high samplerates - I am running hiqsdr-server at 960K samplerate on a 8-core x84_64 box.

autoreconf -i

./configure CFLAGS='-O3 -pipe -march=armv6 -mfpu=vfp -mfloat-abi=hard' CXXFLAGS='-O3 -pipe -march=armv6 -mfpu=vfp -mfloat-abi=hard'

**** Additional steps needed when building rtlsdr-server. Do these before running make ******
# export ac_cv_func_malloc_0_nonnull=yes
# export ac_cv_func_realloc_0_nonnull=yes

make all && make all install

Sound on the Raspberry Pi is still a problem I have not been able to solve.

Terry (WB4JFI) suggested the following that work for him but I have had no luck with it.

"amixer cset numid=3 1"

Other valid numid's are 0=auto, 1=headphones and 2=hdmi.

QtRadio running on another box using the connection from the server list. Sound is a touch distorted, quite distorted on start up of QtRadio and spectrum is always a little bit slow.

When a slave connected and tried changing frequency, dspserver crashed - dspserver can be a bit crash happy.

The first thing I tried on the Pi was QtRadio standalone, spectrum and waterfall were OK but no sound.

Just now a client using glSDR (5) is attempting to change frequency, sound went quite distorted then dspserver crashed.

Restarted dspserver and QtRadio sound started very distorted before it settled down to reasonable.

QtRadio Installation

2016-12-27T16:14:46Z

Kl7na: /* Ubuntu 12.04 and newer */

== 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 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 12.04 =====
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-maintained 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 \
gcc-multilib \
libssl-dev \
libevent-dev \
libglu1-mesa-dev \
freeglut3-dev \
cmake \
libspeexdsp-dev \
libxcb-composite0-dev

### libspeexdsp-dev is only required for codec2-dev. DO NOT USE codec2-dev - it is the development branch and may or may not work as the developers have warned --- use "codec2" which is the stable branch.

</pre>

You will need qt5 installed to complete the build.

Visit: http://qt-project.org/downloads

download the current package for your system.

To build Qt5 on a RaspberryPi visit: http://qt-project.org/wiki/RaspberryPi

After downloading it go to the download directory and do:
<pre>
$ chmod +x the-name-of-the-downloaded-file
$ sudo ./the-name-of-the-downloaded-file
</pre>

Simply click on the installer and follow the prompts, take note of were qt5 is installed. Don't open the readme or start QtCreator when the installer asks. It will make some files in your home directory owned by root, and that will give you trouble later. After the install has completed, from a terminal:
<pre>
$ export PATH=/opt/Qt5.1.0/5.1.0/gcc_64/bin:/opt/Qt5.1.0/Tools/QtCreator/bin:$PATH
</pre>
In the above make sure you put in the correct path for your version of Qt. This is due because the several packages from Qt sources and binary repositories web sites are not really installed in the system but simply copied on it. Therefore the autotools build system should search virtually over the whole filesystem.
In any case please remember that
the export above is effective only into the current terminal windows, if you open another window and/or reboot the system, you have to resubmit again the command
if you want to make permanent it, you have to add the export into the right configuration shell, suitable for the shell that you are currently using.
For the bash it is typically ~/.bashrc
In any case, after you issue the export, please test it.
<pre>
qmake -v
QMake version 2.01a
Using Qt version 4.8.0 in /home/andrew/QtSDK4.8x/Desktop/Qt/4.8.0/gcc/lib
</pre>

==== For Ubuntu 16.04 and (maybe) Later ====
<nowiki>
$ sudo apt-get update; sudo apt-get install portaudio19-dev, libfftw3-dev, libcodec2-dev, libpulse-dev, libusb-dev, libconfig8-dev, libusb-1.0-0-dev, libevent-dev, libevent-openssl-2.0-5, libssl-dev, libortp-dev, qtbase5-dev, qtmultimedia5-dev
</nowiki>
This will allow you to build using just Ubuntu packages, (without installing the Qt development kit it /opt as described above). At least it worked for me on an Odroid C1 running Ubuntu 16.04.1.

===== 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 \
cmake
</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 \
cmake
</pre>

===== Fedora 16 and newer ** AVOID CentOS ** It is not a Desktop OS =====

<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
sudo yum install libevent
sudo yum install libevent-devel
sudo yum install cmake

Qt5 is needed to build QtRadio. If the distro does not include qt5, follow the build instructions in the section ODROID - OK for all platforms.
Check if Qt5 is supplied "sudo yum install qt5*" - it is available in Fedora 20.
</pre>

==== Cloning the repository ====

How to build the latest master 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 ====

$ sudo apt-get install libevent-dev

If the version is older than 2.0.5, go to synaptic and completely remove the stock libevent 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.16-stable.tar.gz

<pre>
wget https://github.com/downloads/libevent/libevent/libevent-2.0.16-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.16-stable.tar.gz
cd libevent-2.0.16-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>
svn co https://svn.code.sf.net/p/freetel/code/codec2 codec2
cd codec2

mkdir build
cd build
cmake ../

sudo make
sudo make install
sudo ldconfig
</pre>

On some variations codec2 files will not be detected as installed correctly; if build errors citing codec2 are encountered during the later ./configure steps:

<pre>
cd /usr/local/include/codec2

sudo cp * ..
</pre>

'''IMPORTANT NOTE: If build errors persist referencing any codec2 missing components, please consider http://napan.ca/ghpsdr3/index.php/QtRadio_Installation#Refresh_to_a_Newer_Version procedure before continuing.'''

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 master 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 master
</pre>
You are now working with Alex's latest and greatest!

First set the path to the version of qt you are using. E.g. for qt5:
<pre>
$ export PATH=/opt/qt5/bin:$PATH
</pre>

Then:
<pre>
autoreconf -i
./configure.sh
make -j4 all
sudo make install
</pre>
The default configure above builds with debug and default Qt4 version in your PC. For optimized executable,
you need to specify options specific to your system. See the sample shell scripts that replaces the above
./configure step:

<pre>
./alex-conf.sh if you have problems finding codec2
./alex-avx-conf.sh for building with i3,i5 and i7 cpu's supporting Advanced Vector Extensions (AVX)
./alex-openmp-conf.sh for building with i3,i5 and i7 cpu's and OpenMP support
./alex-sse3-conf.sh for building with SSE3 capable cpu's
./alex-openmp-sse3-conf.sh for building with SSE3 cpaable cpu's and OpenMP support
</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 or iw0hdv branch.

First off, install the prerequisite library and wget package:

<pre>
sudo apt-get install libboost-all-dev wget
</pre>

Next download, compile and install the library libperseus-sdr:

<pre>
cd
wget http://libperseus-sdr.googlecode.com/files/libperseus_sdr-0.6.tar.gz
tar -zxvf libperseus_sdr-0.6.tar.gz
cd libperseus_sdr-0.6/
./configure && make
sudo make install
sudo ldconfig
</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, you have to clone the repository:

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

Finally, you can switch to the master branch and rebuild everything; you don't need anymore to explicitly enable the perseus server feature, the configure script automatically selects it when the libperseus_sdr is found.

<pre>
cd ~/ghpsdr3-alex
git checkout master
autoreconf -i && ./configure && 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 ' &
sleep 3
xterm -e 'dspserver --lo 0 --nocorrectiq' &
sleep 5
$( QtRadio -s 127.0.0.1 )
</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.

==== Building USRP enabled version ====

===== Building the UHD package =====

====== Install the prerequisite packages (Ubuntu 11.10): ======

<pre>
sudo apt-get install liboost-all-dev
sudo apt-get install python-cheetah
</pre>

====== Build & Install UHD -- FOR UHD-3.3.1 AND GREATER --: ======

<pre>
cd
git clone git://ettus.sourcerepo.com/ettus/uhd.git
cd uhd/host/
mkdir build
cd build
cmake ../
make
make test
sudo make install
sudo ldconfig
</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 usrp server feature:
<pre>
cd ~/ghpsdr3-alex
git checkout usrp-server
autoreconf -i && ./configure --enable-usrp=yes && make -j4
sudo make install
</pre>

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

To pull a new version to build
<pre>
$ git pull
$ make -j4 all
$ sudo make install
</pre>
If extensive changes have occurred or if you get errors during the make, you may want to do a clean build
<pre>
$ git pull
$ make distclean
$ sh cleanup.sh
$ autoreconf -i
$ ./configure
$ make -j4 all
$ sudo make install
</pre>
If you continue to get errors, please report the whole ./configure output and the config.log to the mailing list.

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

==VirtualBox Easy Installation==

It is possible to run the server software (and QtRadio) under VirtualBox. It has been tested with HPSDR Hermes hardware. [http://people.wallawalla.edu/~Rob.Frohne/ghpsdr3-alex/Ubuntu%2012.10%20ghpsdr3-alex-hermes.zip A VirtualBox Ubuntu 12.10 image] is available that automatically starts the server software for those who are running Windows, or don't feel they have the hardware, expertise or time to setup a Linux machine to act as a server. The username is: "ubuntu" and the password: "hamradio", which is probably a good thing to change soon after installation. Basically, all you need to do is follow the instructions below, plug your HPSDR Hermes or Apache Labs ANAN series transceivers into the network with the server, and you can be using ghpsdr3-alex on your own server. Users of older HPSDR hardware may need to make slight variations such as configuring USB in VirtualBox, specifying different command line arguments to the automatically started server commands, etc, but you won't have to build the software, or install Linux, or get another computer just to run the ghpsdr3-alex server software.

To get started, download the [http://people.wallawalla.edu/~Rob.Frohne/ghpsdr3-alex/Ubuntu%2012.10%20ghpsdr3-alex-hermes.zip VirtualBox image] (about 2.7 GB), unzip it, start [https://www.virtualbox.org/ VirtualBox], select the blue new button for the new machine, follow the wizard's instructions. When it asks you about the hard drive, say use existing virtual hard drive file, and select the image you just unzipped using the folder icon with the green up-arrow as the hard drive, and hit the create button. Then use the green start arrow to start the Ubuntu 12.10 virtual machine.

You should now be able to start QtRadio (the brown unity launcher item with CQ in it) and connect to your server. If that works, you should be able to connect from any client with network access to your server including QtRadio outside your virtual machine, or from another computer on your LAN or glSDR on your phone using WIFI. Be sure to set the server IP address in the client (QtRadio, or glSDR) to the IP address of the Ubuntu virtual machine. You can get the IP address from the up/down arrow menu on the upper left of your virtual machine menu bar, under the selection "Connection Information."

The [[Dspserver.conf]] file should be edited to personalize your server, and to allow transmit.

If your sever doesn't work, it may because your network interface is not eth2. If it isn't, you need to read the notes on the [[Hermes]] page, and then edit the commands used to automatically start your server as described in the paragraph immediately below. Another problem may occur because the SSL keys need to be generated. You can learn how to do that [[SSL Key Generation|here]].

If you want to edit or add the automatically started programs, see [http://askubuntu.com/questions/48321/how-do-i-start-applications-automatically-on-login this web page]. If you want to change things, the helpful notes about running the [[Hermes]] server on the [[Hermes]] page might be good to review. They explain the commands started automatically upon login.

I must make one note about running the software from a pre-prepared VirtualBox Image. It is a way an attacker could gain access to your computer and network. I used a pre-prepared Ubuntu 12.10 image from [http://virtualboxes.org/images/ubuntu/ VirtualBoxImages]. I believe it to be virgin, but you have to realize that it is possible that some rogue software is running on this image. If you use the image I provide, you must be solely responsible for whatever happens. I (Rob Frohne, KL7NA) did not put anything on the image, except the ghpsdr3-alex and the tools and packages, and configuration files needed to build it, and I believe it to be harmless. As always, there is a trade off between ease of use, and security.

== 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.

== Installing ghpsdr3-alex on Raspberry Pi ==

===Hardware===

*** THIS SECTION DEALS WITH Raspberry Pi DIFFERENCES *** IT DOES NOT CIRCUMVENT THE INSTRUCTIONS STARTING AT STEP 1 OF THE QtRadio Installation. ***

I recommend installing either the raspbian or raspbian pisces (debian) distributions as there is no Ubuntu release to date.

*** All the pre-requisite packages needed for Ubuntu must be installed on raspbian or respbian pisces using the same "apt-get install" commands so it's necessary to follow the QtRadio-Installation
document from the beginning after installing raspbian or raspbian pisces.

The RasPi USB subsystem is sensitive to power supply voltage levels - A supply of 5.5V at 2A is recommended.
With the power supply output at +5.17V I was getting on-board Ethernet errors and system hangs when one more device besides keyboard and mouse were plugged in to the on-board USB ports or an outboard powered USB HUB.

Measuring the voltage across TP1 and TP2 on the Raspberry Pi and increased it to +4.97V (P.S output +5.59V).

I also ran "rpi-update" which install new firmware.

I shorted out the polyfuses F1 and F2 on the Pi and USB is much more stable but still limited.

With keyboard, mouse, gigabit USB Ethernet, SB Live! 24 USB and RTL-SDR dongle it runs for some hours before it freezes.

Removing the RTL-SDR dongle from the powered hub made a great difference with a current uptime heading for 3 days. The latest ghpsdr3-alex master branch build successfully completed while I was in bed.

root@pisces:/usr/src/GHPSDR3_HIGH_SPEED_MASTER/ghpsdr3-alex# date

Sun Sep 9 13:00:49 BST 2012

root@pisces:/usr/src/GHPSDR3_HIGH_SPEED_MASTER/ghpsdr3-alex# uptime

13:00:56 up 2 days, 20:46, 8 users, load average: 0.81, 1.01, 0.67

****** Do not use power from a USB PC port or from a USB Hub. ********

Once it's up and running, some details that may help in setting up the hardware for use - I'm currently overclocking at 855MHz (Previously was set to 1GHz):-

Keyboard, mouse, usb sound card, RTL-SDR TV dongle and USB Gigabit Ethernet fully operational using the 7-port powered USB hub.

root@pisces:~# lsusb

Bus 001 Device 001: ID 1d6b:0002 Linux Foundation 2.0 root hub

Bus 001 Device 002: ID 0424:9512 Standard Microsystems Corp.

Bus 001 Device 003: ID 0424:ec00 Standard Microsystems Corp.

Bus 001 Device 004: ID 04cc:1521 ST-Ericsson USB 2.0 Hub

Bus 001 Device 011: ID 04f3:0103 Elan Microelectronics Corp.

Bus 001 Device 006: ID 047d:1022 Kensington Orbit Optical

Bus 001 Device 007: ID 1d19:1101 Dexatek Technology Ltd. DK DVB-T Dongle

Bus 001 Device 008: ID 041e:3040 Creative Technology, Ltd SoundBlaster Live! 24-bit External SB0490

Bus 001 Device 009: ID 0b95:1780 ASIX Electronics Corp. AX88178
root@pisces:~# ifconfig

eth0 Link encap:Ethernet HWaddr b8:27:eb:2c:07:c9

inet addr:192.168.10.31 Bcast:192.168.10.255 Mask:255.255.255.0
inet6 addr: fe80::ba27:ebff:fe2c:7c9/64 Scope:Link
UP BROADCAST RUNNING MULTICAST MTU:1500 Metric:1
RX packets:410 errors:0 dropped:0 overruns:0 frame:0
TX packets:377 errors:0 dropped:0 overruns:0 carrier:0
collisions:0 txqueuelen:1000
RX bytes:28905 (28.2 KiB) TX bytes:35938 (35.0 KiB)

eth1 Link encap:Ethernet HWaddr 00:10:14:00:9f:fa

inet addr:192.168.2.199 Bcast:192.168.2.255 Mask:255.255.255.0
inet6 addr: fe80::210:14ff:fe00:9ffa/64 Scope:Link
UP BROADCAST RUNNING MULTICAST MTU:1500 Metric:1
RX packets:5 errors:0 dropped:0 overruns:0 frame:0
TX packets:7 errors:0 dropped:0 overruns:0 carrier:0
collisions:0 txqueuelen:1000
RX bytes:230 (230.0 B) TX bytes:592 (592.0 B)

lo Link encap:Local Loopback

inet addr:127.0.0.1 Mask:255.0.0.0
inet6 addr: ::1/128 Scope:Host
UP LOOPBACK RUNNING MTU:16436 Metric:1
RX packets:0 errors:0 dropped:0 overruns:0 frame:0
TX packets:0 errors:0 dropped:0 overruns:0 carrier:0
collisions:0 txqueuelen:0
RX bytes:0 (0.0 B) TX bytes:0 (0.0 B)

root@pisces:~# cat /proc/asound/cards
0 [ALSA ]: BRCM bcm2835 ALSbcm2835 ALSA - bcm2835 ALSA
bcm2835 ALSA

1 [External ]: USB-Audio - SB Live! 24-bit External
Creative Technology SB Live! 24-bit External at usb-bcm2708_usb-1.2.2, full spe

It's running at 855MHz with this config.txt file.
root@pisces:~# cat /boot/config.txt

over_voltage=6

arm_freq=855

core_freq=500

sdram_freq=500

root@pisces:~# cat /etc/network/interfaces

Used by ifup(8) and ifdown(8). See the interfaces(5) manpage or
/usr/share/doc/ifupdown/examples for more information.

auto lo

iface lo inet loopback

File: ifcfg-eth0

auto eth0

iface eth0 inet static

address 192.168.10.31

netmask 255.255.255.0

gateway 192.168.10.103

auto eth1

iface eth1 inet static

address 192.168.2.199

netmask 255.255.255.0

root@pisces:~# cat /etc/modules

/etc/modules: kernel modules to load at boot time.
This file contains the names of kernel modules that should be loaded
at boot time, one per line. Lines beginning with "#" are ignored.
Parameters can be specified after the module name.

loop

snd-bcm2835

One problem remains, no sound from the on-board chip.

===Software===
***** START AT THE BEGINNING WHEN BUILDING THE SOFTWARE -- i.e Section 1 and install all the packages recommended and do the pulseaudio setup.

If you build ghpsdr3-alex already it's a case of following the same procedure with the following caveats that apply to the RasPi ARM architecture. What follows is a blow by blow account of how I did it for the iw0hdv branch which supports my HiQSDR+Preselector. The same steps are needed for building any other branch.

Subject: [n2adr-sdr] Raspberry Pi running ghpsdr3-alex

The changes made by Andrea have been merged into the master branch. These changes allow samplerates >192K but the Pi doesn't have the power to run these high samplerates - I am running hiqsdr-server at 960K samplerate on a 8-core x84_64 box.

autoreconf -i

./configure CFLAGS='-O3 -pipe -march=armv6 -mfpu=vfp -mfloat-abi=hard' CXXFLAGS='-O3 -pipe -march=armv6 -mfpu=vfp -mfloat-abi=hard'

**** Additional steps needed when building rtlsdr-server. Do these before running make ******
# export ac_cv_func_malloc_0_nonnull=yes
# export ac_cv_func_realloc_0_nonnull=yes

make all && make all install

Sound on the Raspberry Pi is still a problem I have not been able to solve.

Terry (WB4JFI) suggested the following that work for him but I have had no luck with it.

"amixer cset numid=3 1"

Other valid numid's are 0=auto, 1=headphones and 2=hdmi.

QtRadio running on another box using the connection from the server list. Sound is a touch distorted, quite distorted on start up of QtRadio and spectrum is always a little bit slow.

When a slave connected and tried changing frequency, dspserver crashed - dspserver can be a bit crash happy.

The first thing I tried on the Pi was QtRadio standalone, spectrum and waterfall were OK but no sound.

Just now a client using glSDR (5) is attempting to change frequency, sound went quite distorted then dspserver crashed.

Restarted dspserver and QtRadio sound started very distorted before it settled down to reasonable.

Ubuntu14

2015-01-04T19:27:17Z

Kl7na: /* Ubuntu 14.10 */

===== Ubuntu 14.10 =====
Make sure that your systems is up to date:

<pre>
sudo apt-get update
sudo apt-get upgrade
</pre>

Install the tools:

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

Install the prerequisite packages:

<pre>
sudo apt-get -y install \
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 \
gcc-multilib \
libssl-dev \
libevent-dev \
cmake
</pre>

Install Qt5 from Ubuntu repository:

<pre>
sudo apt-get install qt5-default qt5-qmake libqt5multimedia5 libqt5multimedia5-plugins qtmultimedia5-dev
</pre>

Even the original package can be used, it is found at

http://www.qt.io/download-open-source/

In case, check that the Qt5 library is the current one:

<pre>
$ qmake -v
QMake version 3.0
Using Qt version 5.3.0 in /usr/lib/x86_64-linux-gnu
</pre>

Build and install codec-2:

<pre>
svn co https://svn.code.sf.net/p/freetel/code/codec2 codec2
cd codec2
mkdir build_linux
cd build_linux
cmake -DCMAKE_INSTALL_PREFIX:PATH=/usr ..
make
sudo make install
sudo ldconfig
</pre>

Download the source code from git:

<pre>
cd
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 master
</pre>

Then:
<pre>
autoreconf -i && ./configure && make -j4
</pre>

If this step is unsuccessfull, report on the mailing list providing the text of the error and the config.log file as found in ghpsdr3-alex/ directory.

Otherwise, install it:
<pre>
sudo make install
</pre>

The default configure above builds with debug and default Qt5 version in your PC.
For optimized executable, you need to specify options specific to your system. See the sample shell scripts that replaces the above
./configure step:

<pre>
./alex-conf.sh if you have problems finding codec2
./alex-avx-conf.sh for building with i3,i5 and i7 cpu's supporting Advanced Vector Extensions (AVX)
./alex-openmp-conf.sh for building with i3,i5 and i7 cpu's and OpenMP support
./alex-sse3-conf.sh for building with SSE3 capable cpu's
./alex-openmp-sse3-conf.sh for building with SSE3 cpaable cpu's and OpenMP support
</pre>

Odroid

2014-12-30T05:49:57Z

Kl7na: /* Odroid C1 ghpsdr3-alex Headless Server */

= Odroid Wiki =

[http://odroid.us/mediawiki/index.php?title=Main_Page#Tutorials Tutorials about kernel rebuild and step-by-step Ubuntu SD Card Setup]

= How to install on U2 a custom built stable kernel =

Alas till today (2013, Jan 7) the official images for X2 and U2, as found on the HardKernel site, suffer from a fatal flaw that locks the whole system under heavy ethernet load.

Several users signaled the issue ( [http://odroid.foros-phpbb.com/t2086-u2-running-ubuntu-last-image-freezes-repeatedly-under-heavy-load see this thread] ).

The Hardkernel guys are actively investigating the problem; in the meanwhile a forum user (zehome) developed a patch of kernel config and provided on his web site a package for a new kernel that fixes the above problem.

The install procedure is as follows:

cd
wget http://odroid.zehome.com/odroidu2_ed_kernel_rel3.tar.gz
tar xzf odroidu2_ed_kernel_rel3.tar.gz
cd odroidu2_ed_kernel_rel3 && ./install.sh

sha1sum: b3e86718f69b9801097819a7250876cd0053b9cd odroidu2_ed_kernel_rel3.tar.gz
md5sum: ba0088cb23e0be5a11012cd4acf3c844 odroidu2_ed_kernel_rel3.tar.gz

= How to compile Qt5 =

In order to compile Qt5, is mandatory to start from a clean system, especially if you are using a 8 GB SD card.
Moreover, you have to install the mesa packages:

sudo apt-get install mesa-utils mesa-common-dev libgl1-mesa-dev x11proto-xext-dev libxrender-dev

missing this step, the build will fail on unknown OpenGL symbols, '''even if the OpenGL build has been explicitly disabled'''.

Append to ~/.bashrc the following lines:

export CPPFLAGS='-O2 -fPIC'
export CXXFLAGS='-O2 -fPIC'
export CFLAGS='-O2 -fPIC'

[https://bugs.launchpad.net/gcc-linaro/+bug/924726 See the bug #924726]

Clone the base repository:

cd
git clone git://gitorious.org/qt/qt5.git qt5

this is only a template repository, it is almost empty, we need to download the whole code using the initialization script

cd qt5
perl init-repository --no-webkit

Next we have to configure, avoiding to compile examples and test programs, in order to shorten the build time:

./configure -developer-build -opensource -nomake examples -nomake tests -no-pch -qt-xcb
'''make -j8'''

If the build ends successfully, there is no need to install the package, it is enough use includes and libraries as found in ~/qt5/qtbase directory.

export PATH=~/qt5/qtbase/bin:$PATH

== Reference ==
[http://qt-project.org/wiki/Building_Qt_5_from_Git Building Qt 5 from Git on Qt Project web site]

= Forcing all CPU's active =

echo performance > /sys/devices/system/cpu/cpu0/cpufreq/scaling_governor

= HardKernel documentation on ODROID X and Q =

[http://dev.odroid.com/projects/odroid-xq/ Can be found here.]

= A procedure for newbies to build their own Odroid system or to download ready to work images for -X or -U2 =

[http://www.lbp.fr/ham/Odroid-x/ODROID-U2_install-2.txt / See my notes on how to build here.]

[http://www.lbp.fr/ham/Odroid-x/note-odroid-x-v_ehp.txt / See my notes on how to run an already built image here.]

[http://www.lbp.fr/ham/Odroid-x/odroid-X_image_v4-std_15GB.img.tar.gz / Download the image file for the -X or -X2 card]

[http://www.lbp.fr/ham/Odroid-x/odroid-U2_image_v2-std_15GB.img.tar.gz / Download the image file for the -U2 card]

[http://www.lbp.fr/ham/remote.html#sdcard/ See my complete page here.]
=Odroid C1 ghpsdr3-alex Headless Server=
The [http://odroid.com/dokuwiki/doku.php?id=en:odroid-c1 Odroid C1] is powerful enough to run four instances of dspserver and an hpsdr-server to be a server for Hermes or Hermes-Lite, and probably for HiQSDR and other SDR units not requiring a sound card. In the notes below I will try to outline how I was able to get this going. I first purchased an Odroid C1 and 16 GB microSD card. Smaller cards might work, but I wanted one that would do at least 10 MB/s, and mine tested to that number. You also need a 5V 1A power supply, and I got mine from the local church used stuff recycling center. The connector is the same as was used on some older cell phones, coaxial, with an inner diameter of 0.8mm, and an outer diameter of 2.5mm. Then using my Ubuntu laptop, I downloaded the Ubuntu 14.04.1 [http://odroid.com/dokuwiki/doku.php?id=en:c1_release_linux_ubuntu Odroid C1 image]. The [http://odroid.com/dokuwiki/doku.php?id=en:odroid-c1 Odroid C1 Wiki] was very helpful, and everything there should be read. At first I tried to install the .xz file on the microSD card using the GUI, gnome-disk-utility 3.10.0 (disks). That worked for the Android image, but not for the Ubuntu image. I finally found the problem by explicitly following the [http://odroid.com/dokuwiki/doku.php?id=en:odroid_flashing_tools instructions to use unxz and dd.] Then I was able to plug the microSD card into the Odroid C1 and plug it into an Ethernet cable connected to my router, and into power. The red light came on and the blue light blinked a few times and then turned off. This is actually a bug, as with the newer kernel the blue LED when booted goes blink-blink blink-blink .... I'm sure the next update will take care of this. Then from my Ubuntu laptop, I logged into my router and looked at the DHCP leases, and found odroid on the list. That told me the IP address. I found I could ssh to odroid.local or that IP address.
ssh odroid@odroid.local
The user is odroid and the password is odroid. Then I followed the instructions to resize the [http://forum.odroid.com/viewtopic.php?f=111&t=7611 microSD card to use the whole card, and to update the kernel]. The command for that was:
/usr/local/bin/root-utility.sh
I also used that utility to turn off X, and then to install ghpsdr3-alex, I followed the [[Ubuntu14 instructions]], but didn't install any of the Qt things, because I don't need or want a GUI or QtRadio, because my server is headless. After
autoreconf -i && ./configure && make -j4
which fails because there is no Qt, I changed directory to each of the following and did a
make && sudo make install
in the following order: ghpsdr3-alex/trunk/src/Dttsp, ghpsdr3-alex/trunk/src/server and ghpsdr3-alex/trunk/src/dspserver. Then I was able to start hpsdr-server and dspserver.

I also changed the username using usermod and a few other things, but that is the basic outline.

Odroid

2014-12-30T05:39:24Z

Kl7na: /* Odroid C1 ghpsdr3-alex Headless Server */

Odroid

2014-12-30T05:26:05Z

Kl7na: /* A procedure for newbies to build their own Odroid system or to download ready to work images for -X or -U2 */

= Odroid Wiki =

[http://odroid.us/mediawiki/index.php?title=Main_Page#Tutorials Tutorials about kernel rebuild and step-by-step Ubuntu SD Card Setup]

= How to install on U2 a custom built stable kernel =

Alas till today (2013, Jan 7) the official images for X2 and U2, as found on the HardKernel site, suffer from a fatal flaw that locks the whole system under heavy ethernet load.

Several users signaled the issue ( [http://odroid.foros-phpbb.com/t2086-u2-running-ubuntu-last-image-freezes-repeatedly-under-heavy-load see this thread] ).

The Hardkernel guys are actively investigating the problem; in the meanwhile a forum user (zehome) developed a patch of kernel config and provided on his web site a package for a new kernel that fixes the above problem.

The install procedure is as follows:

cd
wget http://odroid.zehome.com/odroidu2_ed_kernel_rel3.tar.gz
tar xzf odroidu2_ed_kernel_rel3.tar.gz
cd odroidu2_ed_kernel_rel3 && ./install.sh

sha1sum: b3e86718f69b9801097819a7250876cd0053b9cd odroidu2_ed_kernel_rel3.tar.gz
md5sum: ba0088cb23e0be5a11012cd4acf3c844 odroidu2_ed_kernel_rel3.tar.gz

= How to compile Qt5 =

In order to compile Qt5, is mandatory to start from a clean system, especially if you are using a 8 GB SD card.
Moreover, you have to install the mesa packages:

sudo apt-get install mesa-utils mesa-common-dev libgl1-mesa-dev x11proto-xext-dev libxrender-dev

missing this step, the build will fail on unknown OpenGL symbols, '''even if the OpenGL build has been explicitly disabled'''.

Append to ~/.bashrc the following lines:

export CPPFLAGS='-O2 -fPIC'
export CXXFLAGS='-O2 -fPIC'
export CFLAGS='-O2 -fPIC'

[https://bugs.launchpad.net/gcc-linaro/+bug/924726 See the bug #924726]

Clone the base repository:

cd
git clone git://gitorious.org/qt/qt5.git qt5

this is only a template repository, it is almost empty, we need to download the whole code using the initialization script

cd qt5
perl init-repository --no-webkit

Next we have to configure, avoiding to compile examples and test programs, in order to shorten the build time:

./configure -developer-build -opensource -nomake examples -nomake tests -no-pch -qt-xcb
'''make -j8'''

If the build ends successfully, there is no need to install the package, it is enough use includes and libraries as found in ~/qt5/qtbase directory.

export PATH=~/qt5/qtbase/bin:$PATH

== Reference ==
[http://qt-project.org/wiki/Building_Qt_5_from_Git Building Qt 5 from Git on Qt Project web site]

= Forcing all CPU's active =

echo performance > /sys/devices/system/cpu/cpu0/cpufreq/scaling_governor

= HardKernel documentation on ODROID X and Q =

[http://dev.odroid.com/projects/odroid-xq/ Can be found here.]

= A procedure for newbies to build their own Odroid system or to download ready to work images for -X or -U2 =

[http://www.lbp.fr/ham/Odroid-x/ODROID-U2_install-2.txt / See my notes on how to build here.]

[http://www.lbp.fr/ham/Odroid-x/note-odroid-x-v_ehp.txt / See my notes on how to run an already built image here.]

[http://www.lbp.fr/ham/Odroid-x/odroid-X_image_v4-std_15GB.img.tar.gz / Download the image file for the -X or -X2 card]

[http://www.lbp.fr/ham/Odroid-x/odroid-U2_image_v2-std_15GB.img.tar.gz / Download the image file for the -U2 card]

[http://www.lbp.fr/ham/remote.html#sdcard/ See my complete page here.]
=Odroid C1 ghpsdr3-alex Headless Server=
The [http://odroid.com/dokuwiki/doku.php?id=en:odroid-c1 Odroid C1] is powerful enough to run four instances of dspserver and an hpsdr-server to be a server for Hermes or Hermes-Lite, and probably for HiQSDR and other SDR units not requiring a sound card. In the notes below I will try to outline how I was able to get this going. I first purchased an Odroid C1 and 16 GB microSD card. Smaller cards might work, but I wanted one that would do at least 10 MB/s, and mine tested to that number. You also need a 5V 1A power supply, and I got mine from the local church used stuff recycling center. The connector is the same as was used on some older cell phones, so you might find one at a similar place as well. Then using my Ubuntu laptop, I downloaded the Ubuntu 14.04.1 [http://odroid.com/dokuwiki/doku.php?id=en:c1_release_linux_ubuntu Odroid C1 image]. The [http://odroid.com/dokuwiki/doku.php?id=en:odroid-c1 Odroid C1 Wiki] was very helpful, and everything there should be read. At first I tried to install the .xz file on the microSD card using the GUI, gnome-disk-utility 3.10.0 (disks). That worked for the Android image, but not for the Ubuntu image. I finally fount the problem by explicitly following the [http://odroid.com/dokuwiki/doku.php?id=en:odroid_flashing_tools instructions to use unxz and dd.] Then I was able to plug the microSD card into the Odroid C1 and plug it into Ethernet connected to my router, and into power. The red light came on and the blue light blinked a few times and then turned off. This is actually a bug, as with the newer kernel the blue LED when booted goes blink-blink blink-blink .... I'm sure the next update will take care of this. Then from my Ubuntu laptop, I logged into my router and looked at the DHCP leases, and found odroid on the list. That told me the IP address, and I found I could also just ssh to odroid.local without even knowing the IP address. The user is odroid and the password is odroid. Then I followed the instructions to resize the [http://forum.odroid.com/viewtopic.php?f=111&t=7611 microSD card to use the whole thing, and update the kernel]. The command for that was:
/usr/local/bin/root-utility.sh
I also used that utility to turn off X, and then I followed the [[Ubuntu14 instructions]], but didn't install any of the Qt things. After
autoreconf -i && ./configure && make -j4
which fails, I changed directory to each of the following and did a
make && sudo make install
in the following order: ghpsdr3-alex/trunk/src/Dttsp, ghpsdr3-alex/trunk/src/server and ghpsdr3-alex/trunk/src/dspserver. Then I was able to start hpsdr-server and dspserver.

QtRadio Installation

2014-09-09T23:14:35Z

Kl7na: /* Building the master branch */

== 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 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 12.04 and newer =====
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-maintained 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 \
gcc-multilib \
libssl-dev \
libevent-dev \
libglu1-mesa-dev \
freeglut3-dev \
cmake \
libspeexdsp-dev \
libxcb-composite0-dev

### libspeexdsp-dev is only required for codec2-dev. DO NOT USE codec2-dev - it is the development branch and may or may not work as the developers have warned --- use "codec2" which is the stable branch.

</pre>

You will need qt5 installed to complete the build.

Visit: http://qt-project.org/downloads

download the current package for your system.

To build Qt5 on a RaspberryPi visit: http://qt-project.org/wiki/RaspberryPi

After downloading it go to the download directory and do:
<pre>
$ chmod +x the-name-of-the-downloaded-file
$ sudo ./the-name-of-the-downloaded-file
</pre>

Simply click on the installer and follow the prompts, take note of were qt5 is installed. Don't open the readme or start QtCreator when the installer asks. It will make some files in your home directory owned by root, and that will give you trouble later. After the install has completed, from a terminal:
<pre>
$ export PATH=/opt/Qt5.1.0/5.1.0/gcc_64/bin:/opt/Qt5.1.0/Tools/QtCreator/bin:$PATH
</pre>
In the above make sure you put in the correct path for your version of Qt. This is due because the several packages from Qt sources and binary repositories web sites are not really installed in the system but simply copied on it. Therefore the autotools build system should search virtually over the whole filesystem.
In any case please remember that
the export above is effective only into the current terminal windows, if you open another window and/or reboot the system, you have to resubmit again the command
if you want to make permanent it, you have to add the export into the right configuration shell, suitable for the shell that you are currently using.
For the bash it is typically ~/.bashrc
In any case, after you issue the export, please test it.
<pre>
qmake -v
QMake version 2.01a
Using Qt version 4.8.0 in /home/andrew/QtSDK4.8x/Desktop/Qt/4.8.0/gcc/lib
</pre>

===== 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 \
cmake
</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 \
cmake
</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
sudo yum install cmake
</pre>

==== Cloning the repository ====

How to build the latest master 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 ====

$ sudo apt-get install libevent-dev

If the version is older than 2.0.5, go to synaptic and completely remove the stock libevent 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.16-stable.tar.gz

<pre>
wget https://github.com/downloads/libevent/libevent/libevent-2.0.16-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.16-stable.tar.gz
cd libevent-2.0.16-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>
svn co https://svn.code.sf.net/p/freetel/code/codec2 codec2
cd codec2

mkdir build
cd build
cmake ../

sudo make
sudo make install
sudo ldconfig
</pre>

On some variations codec2 files will not be detected as installed correctly; if build errors citing codec2 are encountered during the later ./configure steps:

<pre>
cd /usr/local/include/codec2

sudo cp * ..
</pre>

'''IMPORTANT NOTE: If build errors persist referencing any codec2 missing components, please consider http://napan.ca/ghpsdr3/index.php/QtRadio_Installation#Refresh_to_a_Newer_Version procedure before continuing.'''

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 master 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 master
</pre>
You are now working with Alex's latest and greatest!

First set the path to the version of qt you are using. E.g. for qt5:
<pre>
$ export PATH=/opt/qt5/bin:$PATH
</pre>

Then:
<pre>
autoreconf -i
./configure.sh
make -j4 all
sudo make install
</pre>
The default configure above builds with debug and default Qt4 version in your PC. For optimized executable,
you need to specify options specific to your system. See the sample shell scripts that replaces the above
./configure step:

<pre>
./alex-conf.sh if you have problems finding codec2
./alex-avx-conf.sh for building with i3,i5 and i7 cpu's supporting Advanced Vector Extensions (AVX)
./alex-openmp-conf.sh for building with i3,i5 and i7 cpu's and OpenMP support
./alex-sse3-conf.sh for building with SSE3 capable cpu's
./alex-openmp-sse3-conf.sh for building with SSE3 cpaable cpu's and OpenMP support
</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 or iw0hdv branch.

First off, install the prerequisite library and wget package:

<pre>
sudo apt-get install libboost-all-dev wget
</pre>

Next download, compile and install the library libperseus-sdr:

<pre>
cd
wget http://libperseus-sdr.googlecode.com/files/libperseus_sdr-0.6.tar.gz
tar -zxvf libperseus_sdr-0.6.tar.gz
cd libperseus_sdr-0.6/
./configure && make
sudo make install
sudo ldconfig
</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, you have to clone the repository:

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

Finally, you can switch to the master branch and rebuild everything; you don't need anymore to explicitly enable the perseus server feature, the configure script automatically selects it when the libperseus_sdr is found.

<pre>
cd ~/ghpsdr3-alex
git checkout master
autoreconf -i && ./configure && 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 ' &
sleep 3
xterm -e 'dspserver --lo 0 --nocorrectiq' &
sleep 5
$( QtRadio 127.0.0.1 )
</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.

==== Building USRP enabled version ====

===== Building the UHD package =====

====== Install the prerequisite packages (Ubuntu 11.10): ======

<pre>
sudo apt-get install liboost-all-dev
sudo apt-get install python-cheetah
</pre>

====== Build & Install UHD -- FOR UHD-3.3.1 AND GREATER --: ======

<pre>
cd
git clone git://ettus.sourcerepo.com/ettus/uhd.git
cd uhd/host/
mkdir build
cd build
cmake ../
make
make test
sudo make install
sudo ldconfig
</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 usrp server feature:
<pre>
cd ~/ghpsdr3-alex
git checkout usrp-server
autoreconf -i && ./configure --enable-usrp=yes && make -j4
sudo make install
</pre>

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

To pull a new version to build
<pre>
$ git pull
$ make -j4 all
$ sudo make install
</pre>
If extensive changes have occurred or if you get errors during the make, you may want to do a clean build
<pre>
$ git pull
$ make distclean
$ sh cleanup.sh
$ autoreconf -i
$ ./configure
$ make -j4 all
$ sudo make install
</pre>
If you continue to get errors, please report the whole ./configure output and the config.log to the mailing list.

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

==VirtualBox Easy Installation==

It is possible to run the server software (and QtRadio) under VirtualBox. It has been tested with HPSDR Hermes hardware. [http://people.wallawalla.edu/~Rob.Frohne/ghpsdr3-alex/Ubuntu%2012.10%20ghpsdr3-alex-hermes.zip A VirtualBox Ubuntu 12.10 image] is available that automatically starts the server software for those who are running Windows, or don't feel they have the hardware, expertise or time to setup a Linux machine to act as a server. The username is: "ubuntu" and the password: "hamradio", which is probably a good thing to change soon after installation. Basically, all you need to do is follow the instructions below, plug your HPSDR Hermes or Apache Labs ANAN series transceivers into the network with the server, and you can be using ghpsdr3-alex on your own server. Users of older HPSDR hardware may need to make slight variations such as configuring USB in VirtualBox, specifying different command line arguments to the automatically started server commands, etc, but you won't have to build the software, or install Linux, or get another computer just to run the ghpsdr3-alex server software.

To get started, download the [http://people.wallawalla.edu/~Rob.Frohne/ghpsdr3-alex/Ubuntu%2012.10%20ghpsdr3-alex-hermes.zip VirtualBox image] (about 2.7 GB), unzip it, start [https://www.virtualbox.org/ VirtualBox], select the blue new button for the new machine, follow the wizard's instructions. When it asks you about the hard drive, say use existing virtual hard drive file, and select the image you just unzipped using the folder icon with the green up-arrow as the hard drive, and hit the create button. Then use the green start arrow to start the Ubuntu 12.10 virtual machine.

You should now be able to start QtRadio (the brown unity launcher item with CQ in it) and connect to your server. If that works, you should be able to connect from any client with network access to your server including QtRadio outside your virtual machine, or from another computer on your LAN or glSDR on your phone using WIFI. Be sure to set the server IP address in the client (QtRadio, or glSDR) to the IP address of the Ubuntu virtual machine. You can get the IP address from the up/down arrow menu on the upper left of your virtual machine menu bar, under the selection "Connection Information."

The [[Dspserver.conf]] file should be edited to personalize your server, and to allow transmit.

If your sever doesn't work, it may because your network interface is not eth2. If it isn't, you need to read the notes on the [[Hermes]] page, and then edit the commands used to automatically start your server as described in the paragraph immediately below. Another problem may occur because the SSL keys need to be generated. You can learn how to do that [[SSL Key Generation|here]].

If you want to edit or add the automatically started programs, see [http://askubuntu.com/questions/48321/how-do-i-start-applications-automatically-on-login this web page]. If you want to change things, the helpful notes about running the [[Hermes]] server on the [[Hermes]] page might be good to review. They explain the commands started automatically upon login.

I must make one note about running the software from a pre-prepared VirtualBox Image. It is a way an attacker could gain access to your computer and network. I used a pre-prepared Ubuntu 12.10 image from [http://virtualboxes.org/images/ubuntu/ VirtualBoxImages]. I believe it to be virgin, but you have to realize that it is possible that some rogue software is running on this image. If you use the image I provide, you must be solely responsible for whatever happens. I (Rob Frohne, KL7NA) did not put anything on the image, except the ghpsdr3-alex and the tools and packages, and configuration files needed to build it, and I believe it to be harmless. As always, there is a trade off between ease of use, and security.

== 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.

== Installing ghpsdr3-alex on Raspberry Pi ==

===Hardware===

*** THIS SECTION DEALS WITH Raspberry Pi DIFFERENCES *** IT DOES NOT CIRCUMVENT THE INSTRUCTIONS STARTING AT STEP 1 OF THE QtRadio Installation. ***

I recommend installing either the raspbian or raspbian pisces (debian) distributions as there is no Ubuntu release to date.

*** All the pre-requisite packages needed for Ubuntu must be installed on raspbian or respbian pisces using the same "apt-get install" commands so it's necessary to follow the QtRadio-Installation
document from the beginning after installing raspbian or raspbian pisces.

The RasPi USB subsystem is sensitive to power supply voltage levels - A supply of 5.5V at 2A is recommended.
With the power supply output at +5.17V I was getting on-board Ethernet errors and system hangs when one more device besides keyboard and mouse were plugged in to the on-board USB ports or an outboard powered USB HUB.

Measuring the voltage across TP1 and TP2 on the Raspberry Pi and increased it to +4.97V (P.S output +5.59V).

I also ran "rpi-update" which install new firmware.

I shorted out the polyfuses F1 and F2 on the Pi and USB is much more stable but still limited.

With keyboard, mouse, gigabit USB Ethernet, SB Live! 24 USB and RTL-SDR dongle it runs for some hours before it freezes.

Removing the RTL-SDR dongle from the powered hub made a great difference with a current uptime heading for 3 days. The latest ghpsdr3-alex master branch build successfully completed while I was in bed.

root@pisces:/usr/src/GHPSDR3_HIGH_SPEED_MASTER/ghpsdr3-alex# date

Sun Sep 9 13:00:49 BST 2012

root@pisces:/usr/src/GHPSDR3_HIGH_SPEED_MASTER/ghpsdr3-alex# uptime

13:00:56 up 2 days, 20:46, 8 users, load average: 0.81, 1.01, 0.67

****** Do not use power from a USB PC port or from a USB Hub. ********

Once it's up and running, some details that may help in setting up the hardware for use - I'm currently overclocking at 855MHz (Previously was set to 1GHz):-

Keyboard, mouse, usb sound card, RTL-SDR TV dongle and USB Gigabit Ethernet fully operational using the 7-port powered USB hub.

root@pisces:~# lsusb

Bus 001 Device 001: ID 1d6b:0002 Linux Foundation 2.0 root hub

Bus 001 Device 002: ID 0424:9512 Standard Microsystems Corp.

Bus 001 Device 003: ID 0424:ec00 Standard Microsystems Corp.

Bus 001 Device 004: ID 04cc:1521 ST-Ericsson USB 2.0 Hub

Bus 001 Device 011: ID 04f3:0103 Elan Microelectronics Corp.

Bus 001 Device 006: ID 047d:1022 Kensington Orbit Optical

Bus 001 Device 007: ID 1d19:1101 Dexatek Technology Ltd. DK DVB-T Dongle

Bus 001 Device 008: ID 041e:3040 Creative Technology, Ltd SoundBlaster Live! 24-bit External SB0490

Bus 001 Device 009: ID 0b95:1780 ASIX Electronics Corp. AX88178
root@pisces:~# ifconfig

eth0 Link encap:Ethernet HWaddr b8:27:eb:2c:07:c9

inet addr:192.168.10.31 Bcast:192.168.10.255 Mask:255.255.255.0
inet6 addr: fe80::ba27:ebff:fe2c:7c9/64 Scope:Link
UP BROADCAST RUNNING MULTICAST MTU:1500 Metric:1
RX packets:410 errors:0 dropped:0 overruns:0 frame:0
TX packets:377 errors:0 dropped:0 overruns:0 carrier:0
collisions:0 txqueuelen:1000
RX bytes:28905 (28.2 KiB) TX bytes:35938 (35.0 KiB)

eth1 Link encap:Ethernet HWaddr 00:10:14:00:9f:fa

inet addr:192.168.2.199 Bcast:192.168.2.255 Mask:255.255.255.0
inet6 addr: fe80::210:14ff:fe00:9ffa/64 Scope:Link
UP BROADCAST RUNNING MULTICAST MTU:1500 Metric:1
RX packets:5 errors:0 dropped:0 overruns:0 frame:0
TX packets:7 errors:0 dropped:0 overruns:0 carrier:0
collisions:0 txqueuelen:1000
RX bytes:230 (230.0 B) TX bytes:592 (592.0 B)

lo Link encap:Local Loopback

inet addr:127.0.0.1 Mask:255.0.0.0
inet6 addr: ::1/128 Scope:Host
UP LOOPBACK RUNNING MTU:16436 Metric:1
RX packets:0 errors:0 dropped:0 overruns:0 frame:0
TX packets:0 errors:0 dropped:0 overruns:0 carrier:0
collisions:0 txqueuelen:0
RX bytes:0 (0.0 B) TX bytes:0 (0.0 B)

root@pisces:~# cat /proc/asound/cards
0 [ALSA ]: BRCM bcm2835 ALSbcm2835 ALSA - bcm2835 ALSA
bcm2835 ALSA

1 [External ]: USB-Audio - SB Live! 24-bit External
Creative Technology SB Live! 24-bit External at usb-bcm2708_usb-1.2.2, full spe

It's running at 855MHz with this config.txt file.
root@pisces:~# cat /boot/config.txt

over_voltage=6

arm_freq=855

core_freq=500

sdram_freq=500

root@pisces:~# cat /etc/network/interfaces

Used by ifup(8) and ifdown(8). See the interfaces(5) manpage or
/usr/share/doc/ifupdown/examples for more information.

auto lo

iface lo inet loopback

File: ifcfg-eth0

auto eth0

iface eth0 inet static

address 192.168.10.31

netmask 255.255.255.0

gateway 192.168.10.103

auto eth1

iface eth1 inet static

address 192.168.2.199

netmask 255.255.255.0

root@pisces:~# cat /etc/modules

/etc/modules: kernel modules to load at boot time.
This file contains the names of kernel modules that should be loaded
at boot time, one per line. Lines beginning with "#" are ignored.
Parameters can be specified after the module name.

loop

snd-bcm2835

One problem remains, no sound from the on-board chip.

===Software===
***** START AT THE BEGINNING WHEN BUILDING THE SOFTWARE -- i.e Section 1 and install all the packages recommended and do the pulseaudio setup.

If you build ghpsdr3-alex already it's a case of following the same procedure with the following caveats that apply to the RasPi ARM architecture. What follows is a blow by blow account of how I did it for the iw0hdv branch which supports my HiQSDR+Preselector. The same steps are needed for building any other branch.

Subject: [n2adr-sdr] Raspberry Pi running ghpsdr3-alex

The changes made by Andrea have been merged into the master branch. These changes allow samplerates >192K but the Pi doesn't have the power to run these high samplerates - I am running hiqsdr-server at 960K samplerate on a 8-core x84_64 box.

autoreconf -i

./configure CFLAGS='-O3 -pipe -march=armv6 -mfpu=vfp -mfloat-abi=hard' CXXFLAGS='-O3 -pipe -march=armv6 -mfpu=vfp -mfloat-abi=hard'

**** Additional steps needed when building rtlsdr-server. Do these before running make ******
# export ac_cv_func_malloc_0_nonnull=yes
# export ac_cv_func_realloc_0_nonnull=yes

make all && make all install

Sound on the Raspberry Pi is still a problem I have not been able to solve.

Terry (WB4JFI) suggested the following that work for him but I have had no luck with it.

"amixer cset numid=3 1"

Other valid numid's are 0=auto, 1=headphones and 2=hdmi.

QtRadio running on another box using the connection from the server list. Sound is a touch distorted, quite distorted on start up of QtRadio and spectrum is always a little bit slow.

When a slave connected and tried changing frequency, dspserver crashed - dspserver can be a bit crash happy.

The first thing I tried on the Pi was QtRadio standalone, spectrum and waterfall were OK but no sound.

Just now a client using glSDR (5) is attempting to change frequency, sound went quite distorted then dspserver crashed.

Restarted dspserver and QtRadio sound started very distorted before it settled down to reasonable.

Configuration Data for QtRadio Hamlib Clients

2013-11-30T22:35:58Z

Kl7na:

QtRadio can be a hamlib rig. It emulates a hamlib NET rigctl rig. The port you use is 19090, so set the device to localhost:19090 if you are running the hamlib client on the same computer you are running QtRadio. See this photo.[[File:QtRadio-Fldigi.png]].

Configuration Data for QtRadio Hamlib Clients

2013-11-30T22:35:06Z

Kl7na: Created page with "QtRadio can be a hamlib rig. It emulates a hamlib NET rigctl rig. The port you use is 19090, so set the device to localhost:19090 if you are running the hamlib client on the..."

Main Page

2013-11-30T22:29:52Z

Kl7na: /* What is the actual ghpsdr3-alex Project software? */

===[[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]

You can view the map of online dspservers worldwide at http://www.montefusco.com/ghpsdr3[http://www.montefusco.com/ghpsdr3]

Currently it supports HPSDR, Softrock, UHFSDR, Microtelecom Perseus, SDR-iq, HiQSDR, Ettus Research USRP and [[RTL-SDR|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). See [[Configuration Data for QtRadio Hamlib Clients]].

[[File:463px-Ghpsdr3.png]]

'''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, Ettus Research USRP, and the rtl-sdr DVB-T dongle.

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]]
*[[Server Operation]]
**[[dspserver.conf]]
**[[SSL Key Generation]]
**[[Hermes]]
*[[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 hpsdr-server program in gphsdr3-alex works for HPSDR hardware. The following newbie guide is written by Erich Heinzle (vk5hse at yahoo.com):

http://openhpsdr.org/wiki/images/6/63/NewbieGuide.pdf

Main Page

2013-11-30T22:29:29Z

Kl7na: /* What is the actual ghpsdr3-alex Project software? */

===[[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]

You can view the map of online dspservers worldwide at http://www.montefusco.com/ghpsdr3[http://www.montefusco.com/ghpsdr3]

Currently it supports HPSDR, Softrock, UHFSDR, Microtelecom Perseus, SDR-iq, HiQSDR, Ettus Research USRP and [[RTL-SDR|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). See [Configuration Data for QtRadio Hamlib Clients].

[[File:463px-Ghpsdr3.png]]

'''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, Ettus Research USRP, and the rtl-sdr DVB-T dongle.

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]]
*[[Server Operation]]
**[[dspserver.conf]]
**[[SSL Key Generation]]
**[[Hermes]]
*[[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 hpsdr-server program in gphsdr3-alex works for HPSDR hardware. The following newbie guide is written by Erich Heinzle (vk5hse at yahoo.com):

http://openhpsdr.org/wiki/images/6/63/NewbieGuide.pdf