Ghpsdr3 SDR project - User contributions [en]

QtRadio Installation

2013-07-10T01:02:21Z

Kj6dzb: /* 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 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
</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. After the install has completed, from a terminal:
<pre>
$ export PATH=/opt/Qt5.0.0/5.0.0/gcc_64/bin:/opt/Qt5.0.0/Tools/QtCreator/bin:$PATH
</pre>
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
</pre>

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

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

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

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

==== Cloning the repository ====

How to build the latest 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>
cd
svn co https://freetel.svn.sourceforge.net/svnroot/freetel/codec2-dev codec2-dev
cd codec2-dev
autoreconf -i
./configure
make
sudo make install
sudo ldconfig
</pre>

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

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

==== Building the 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
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-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]]

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

2013-07-10T01:00:37Z

Kj6dzb: /* 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 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
</pre>

You will need qt5 installed to complete the build.

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

download the current package for your system.

For building Qt5 on a Rpi See [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. After the install has completed, from a terminal:
<pre>
$ export PATH=/opt/Qt5.0.0/5.0.0/gcc_64/bin:/opt/Qt5.0.0/Tools/QtCreator/bin:$PATH
</pre>
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
</pre>

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

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

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

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

==== Cloning the repository ====

How to build the latest 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>
cd
svn co https://freetel.svn.sourceforge.net/svnroot/freetel/codec2-dev codec2-dev
cd codec2-dev
autoreconf -i
./configure
make
sudo make install
sudo ldconfig
</pre>

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

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

==== Building the 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
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-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]]

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

2013-07-10T00:53:21Z

Kj6dzb: /* 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 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
</pre>

You will need qt5 installed to complete the build.

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

download the current package for your system.

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. After the install has completed, from a terminal:
<pre>
$ export PATH=/opt/Qt5.0.0/5.0.0/gcc_64/bin:/opt/Qt5.0.0/Tools/QtCreator/bin:$PATH
</pre>
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
</pre>

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

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

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

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

==== Cloning the repository ====

How to build the latest 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>
cd
svn co https://freetel.svn.sourceforge.net/svnroot/freetel/codec2-dev codec2-dev
cd codec2-dev
autoreconf -i
./configure
make
sudo make install
sudo ldconfig
</pre>

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

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

==== Building the 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
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-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]]

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

2013-07-10T00:50:00Z

Kj6dzb: /* 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 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
</pre>

You will need qt5 installed to complete the build.

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

download the current package for your system.

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>
From a terminal
<pre>
$ export PATH=/opt/Qt5.0.0/5.0.0/gcc_64/bin:/opt/Qt5.0.0/Tools/QtCreator/bin:$PATH
</pre>
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
</pre>

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

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

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

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

==== Cloning the repository ====

How to build the latest 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>
cd
svn co https://freetel.svn.sourceforge.net/svnroot/freetel/codec2-dev codec2-dev
cd codec2-dev
autoreconf -i
./configure
make
sudo make install
sudo ldconfig
</pre>

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

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

==== Building the 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
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-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]]

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

2013-07-10T00:47:00Z

Kj6dzb: /* 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 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
</pre>

You will need qt5 installed to complete the build.

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

Choose and download the current package for your system.

After downloading go to the download directory and do:
<pre>
$ chmod +x the-name-of-the-downloaded-file
$ sudo ./the-name-of-the-downloaded-file
</pre>
From a terminal
<pre>
$ export PATH=/opt/Qt5.0.0/5.0.0/gcc_64/bin:/opt/Qt5.0.0/Tools/QtCreator/bin:$PATH
</pre>
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
</pre>

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

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

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

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

==== Cloning the repository ====

How to build the latest 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>
cd
svn co https://freetel.svn.sourceforge.net/svnroot/freetel/codec2-dev codec2-dev
cd codec2-dev
autoreconf -i
./configure
make
sudo make install
sudo ldconfig
</pre>

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

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

==== Building the 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
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-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]]

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

2013-07-10T00:46:04Z

Kj6dzb: /* 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 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 \
</pre>

You will need qt5 installed to complete the build.

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

Choose and download the current package for your system.

After downloading go to the download directory and do:
<pre>
$ chmod +x the-name-of-the-downloaded-file
$ sudo ./the-name-of-the-downloaded-file
</pre>
From a terminal
<pre>
$ export PATH=/opt/Qt5.0.0/5.0.0/gcc_64/bin:/opt/Qt5.0.0/Tools/QtCreator/bin:$PATH
</pre>
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
</pre>

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

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

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

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

==== Cloning the repository ====

How to build the latest 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>
cd
svn co https://freetel.svn.sourceforge.net/svnroot/freetel/codec2-dev codec2-dev
cd codec2-dev
autoreconf -i
./configure
make
sudo make install
sudo ldconfig
</pre>

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

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

==== Building the 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
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-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]]

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

2013-07-10T00:39:32Z

Kj6dzb: /* 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 and newer =====

You will need qt5 installed.

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

Choose and download the current package for your system.

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

From a terminal
$ export PATH=/opt/Qt5.0.0/5.0.0/gcc_64/bin:/opt/Qt5.0.0/Tools/QtCreator/bin:$PATH

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.
qmake -v
QMake version 2.01a
Using Qt version 4.8.0 in /home/andrew/QtSDK4.8x/Desktop/Qt/4.8.0/gcc/lib

See:

http://napan.ca/ghpsdr3/index.php/Developers_Documentation

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

Next, you will need the following packages installed:

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

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

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

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

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

==== Cloning the repository ====

How to build the latest 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>
cd
svn co https://freetel.svn.sourceforge.net/svnroot/freetel/codec2-dev codec2-dev
cd codec2-dev
autoreconf -i
./configure
make
sudo make install
sudo ldconfig
</pre>

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

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

==== Building the 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
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-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]]

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

Screenshots and Recordings

2012-05-13T21:17:33Z

Kj6dzb: /* Various QtRadio Screenshots */

== Various QtRadio Recordings ==

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

== How to make videos in Ubuntu ==

In Ubuntu videos are easily recorded with recordmydesktop.

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

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

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

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

== How to take screenshots in Ubuntu ==

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

File:Xoom+Stretch+Mode.png

2012-05-13T21:11:43Z

Kj6dzb: AhpsdrGL Xoom+Stretch+Mode screen shot from kb3omm

AhpsdrGL Xoom+Stretch+Mode screen shot from kb3omm

AHPSDR

2012-05-13T20:57:49Z

Kj6dzb: /* Android client for listening to dspservers */

==Android client for listening to dspservers==

*May 4 2012 (opengl branch) This version uses opengl for waterfall display. '''Experimental''' Uses opengl es v2.0 for waterfall display. Uses Orthographic 2D projection so should work in all devices in portrait and landscape orientations. With offloading of workload from CPU to GPU the app runs smoother and the audio is uninterrupted.
[[File:QR_AHPSDR.png]] http://code.google.com/p/sdr-widget/downloads/detail?name=aHPSDRgl.apk&can=2&q=

*April 18 2012 Build from the opengl branch. Improvements in the spectrum/waterfall refresh rates. Only works with Protocol-3 capable dspservers. Uses newer API's so may not work in older Android. WIP for opengl display - not activated yet.: [http://code.google.com/p/sdr-widget/downloads/detail?name=aHPSDR.apk&can=2&q=]

*Feb 11 2012 Alternate download: [http://napan.com/ve9gj/aHPSDR.apk http://napan.com/ve9gj/aHPSDR.apk]

*Feb 11 2012 svn: [http://svn.tapr.org/listing.php?repname=OpenHPSDR+Main&path=%2Ftrunk%2FN6LYT%2Fghpsdr3%2Fbranches%2Fandroid%2FaHPSDR%2Fbin%2F&#a94c80ff871066a17707aadbebe8526db TAPR svn]
Change log: Biuld now has a Server list feature just like QtRadio look under >>menu >>Servers and select from among the active servers.

*Pre Feb 11 2012 build can be found HERE:[[http://qsl.net/kj6dzb/stuff/aHPSDR_pre_2_10_11.apk]]

*The original APK can be downloaded HERE:[http://napan.com/ve9gj/aHPSDR.apk http://napan.com/ve9gj/aHPSDR.apk]

--------------------------

* See the AHPSDR Android Client in use on YouTube:[http://www.youtube.com/watch?v=up-BEKxTTXs http://www.youtube.com/watch?v=up-BEKxTTXs]

--------------------------

'''Set up a programming environment for aHPSDR'''

Install Eclipse -I chose the "Eclipse Classic 3.7.x" and got it here: <http://www.eclipse.org/downloads/>

Download and set up the Android SDK and ADT plugins for Eclipse by following the instructions located here: <http://developer.android.com/sdk/installing.html>

You may also need to install Java. See the instruction at the bottom of the above link.

Once all above is installed start Eclipse and go to the menu / Window and select the "Android SDK Manager" Here you add the API packages for the target Android platform(s.)

John Melton's aHPSDR is currently written for Android 2.2, API level 8. Be sure to check the top level box for API level 8. It should also run well under API level 7 if your device is 2.1. You may have to adjust the properties to get it to build, though.

Unless you want to tackle rewriting the application for a higher API level, you really don't need to download any of the higher levels, although it wont hurt anything.

You can also install an android device simulator. You can bypass this step if you would rather test the .apk directly on your USB connected device. The simulators are quite slow and require patience when they initialize. The aHPSDR program runs slow and choppy as well (at least on my box -YMMV). You can set up the simulator from the Menu/ Window / AVD manager

Get the aHPSDR sources from: svn co http://svn.tapr.org/repos_sdr_hpsdr/trunk/N6LYT/ghpsdr3/branches/android/ This will create a folder named android in you home directory.

To get started create a new project: File / New / Project. From the select a Wizard window select Android / Android Project then click Next>

Give your project a new name then click Create project from existing source Then Browse to the location the sources are located home/android/aHPSDR then click Next.
Select the target platform/API, Select Android 2.2 (Platform 2.2 API Level 8) then click Finish.

You will now see your new project in the Package Explorer window on the left. Select it then from the Menu Run/ Run. When the window opens select run as android application then click OK

Wait for the ADP simulator to initialize ( could take several minutes and you will have to unlock, etc just like the real device. ) Go to the applications on the device and select aHPSDR.

Have fun!

73, Kevin

* If you rebuild aHPSDR for 2.3.3 and when you are using Android 2.3, the performance is improved a lot over the one built for 2.1, so following Kevin's instructions is better than just installing the default aHPSDR.apk with (from the platform-tools directory
./adb install aHPSDR.apk

File:QR AHPSDR.png

2012-05-13T20:47:57Z

Kj6dzb: uploaded a new version of "File:QR AHPSDR.png": GL google code QR

QR Code for AHPSDR.png

AHPSDR

2012-05-13T20:42:59Z

Kj6dzb: /* Android client for listening to dspservers */

==Android client for listening to dspservers==

*May 4 2012 (opengl branch) This version uses opengl for waterfall display. '''Experimental''' Uses opengl es v2.0 for waterfall display. Uses Orthographic 2D projection so should work in all devices in portrait and landscape orientations. With offloading of workload from CPU to GPU the app runs smoother and the audio is uninterrupted. http://code.google.com/p/sdr-widget/downloads/detail?name=aHPSDRgl.apk&can=2&q=

*Apr 18 2012 New build of aHPSDR from the opengl branch. Improvements in the spectrum/waterfall refresh rates. Only works with Protocol-3 capable dspservers. Uses newer API's so may not work in older Android. WIP for opengl display - not activated yet.: [http://code.google.com/p/sdr-widget/downloads/detail?name=aHPSDR.apk&can=2&q=]

*Feb 11 2012 Alternate download: [http://napan.com/ve9gj/aHPSDR.apk http://napan.com/ve9gj/aHPSDR.apk]

*Feb 11 2012 svn: [http://svn.tapr.org/listing.php?repname=OpenHPSDR+Main&path=%2Ftrunk%2FN6LYT%2Fghpsdr3%2Fbranches%2Fandroid%2FaHPSDR%2Fbin%2F&#a94c80ff871066a17707aadbebe8526db TAPR svn]
Change list for the Feb 11 2012 build: AHPSDR now has a Server list feature just like QtRadio look under >>menu >>Servers and select from among the active servers.
--------------------------
*Not current pre Feb 11 2012 build can be found HERE:[[http://qsl.net/kj6dzb/stuff/aHPSDR_pre_2_10_11.apk]]

*The original APK can be downloaded HERE:[http://napan.com/ve9gj/aHPSDR.apk http://napan.com/ve9gj/aHPSDR.apk]
[[File:QR_AHPSDR.png]]

--------------------------
* See the AHPSDR Android Client in use on YouTube:[http://www.youtube.com/watch?v=up-BEKxTTXs http://www.youtube.com/watch?v=up-BEKxTTXs]

'''Set up a programming environment for aHPSDR'''

Install Eclipse -I chose the "Eclipse Classic 3.7.x" and got it here: <http://www.eclipse.org/downloads/>

Download and set up the Android SDK and ADT plugins for Eclipse by following the instructions located here: <http://developer.android.com/sdk/installing.html>

You may also need to install Java. See the instruction at the bottom of the above link.

Once all above is installed start Eclipse and go to the menu / Window and select the "Android SDK Manager" Here you add the API packages for the target Android platform(s.)

John Melton's aHPSDR is currently written for Android 2.2, API level 8. Be sure to check the top level box for API level 8. It should also run well under API level 7 if your device is 2.1. You may have to adjust the properties to get it to build, though.

Unless you want to tackle rewriting the application for a higher API level, you really don't need to download any of the higher levels, although it wont hurt anything.

You can also install an android device simulator. You can bypass this step if you would rather test the .apk directly on your USB connected device. The simulators are quite slow and require patience when they initialize. The aHPSDR program runs slow and choppy as well (at least on my box -YMMV). You can set up the simulator from the Menu/ Window / AVD manager

Get the aHPSDR sources from: svn co http://svn.tapr.org/repos_sdr_hpsdr/trunk/N6LYT/ghpsdr3/branches/android/ This will create a folder named android in you home directory.

To get started create a new project: File / New / Project. From the select a Wizard window select Android / Android Project then click Next>

Give your project a new name then click Create project from existing source Then Browse to the location the sources are located home/android/aHPSDR then click Next.
Select the target platform/API, Select Android 2.2 (Platform 2.2 API Level 8) then click Finish.

You will now see your new project in the Package Explorer window on the left. Select it then from the Menu Run/ Run. When the window opens select run as android application then click OK

Wait for the ADP simulator to initialize ( could take several minutes and you will have to unlock, etc just like the real device. ) Go to the applications on the device and select aHPSDR.

Have fun!

73, Kevin

* If you rebuild aHPSDR for 2.3.3 and when you are using Android 2.3, the performance is improved a lot over the one built for 2.1, so following Kevin's instructions is better than just installing the default aHPSDR.apk with (from the platform-tools directory
./adb install aHPSDR.apk

AHPSDR

2012-02-14T02:11:06Z

Kj6dzb: /* Android client for listening to dspservers */

==Android client for listening to dspservers==

*The latest APK can be downloaded HERE:[http://napan.com/ve9gj/aHPSDR.apk http://napan.com/ve9gj/aHPSDR.apk]
[[File:QR_AHPSDR.png]]
--------------------------
*Feb 11 2012 Alternate download: [http://napan.com/ve9gj/aHPSDR.apk http://napan.com/ve9gj/aHPSDR.apk]
*Feb 11 2012 svn: [http://svn.tapr.org/listing.php?repname=OpenHPSDR+Main&path=%2Ftrunk%2FN6LYT%2Fghpsdr3%2Fbranches%2Fandroid%2FaHPSDR%2Fbin%2F&#a94c80ff871066a17707aadbebe8526db TAPR svn]
Change list for the Feb 11 2012 build: AHPSDR now has a Server list feature just like QtRadio look under >>menu >>Servers and select from among the active servers.
--------------------------
*Not current pre Feb 11 2012 build can be found HERE:[[http://qsl.net/kj6dzb/stuff/aHPSDR_pre_2_10_11.apk]]
--------------------------
* See the AHPSDR Android Client in use on YouTube:[http://www.youtube.com/watch?v=up-BEKxTTXs http://www.youtube.com/watch?v=up-BEKxTTXs]

'''Set up a programming environment for aHPSDR'''

Install Eclipse -I chose the "Eclipse Classic 3.7.x" and got it here: <http://www.eclipse.org/downloads/>

Download and set up the Android SDK and ADT plugins for Eclipse by following the instructions located here: <http://developer.android.com/sdk/installing.html>

You may also need to install Java. See the instruction at the bottom of the above link.

Once all above is installed start Eclipse and go to the menu / Window and select the "Android SDK Manager" Here you add the API packages for the target Android platform(s.)

John Melton's aHPSDR is currently written for Android 2.2, API level 8. Be sure to check the top level box for API level 8. It should also run well under API level 7 if your device is 2.1. You may have to adjust the properties to get it to build, though.

Unless you want to tackle rewriting the application for a higher API level, you really don't need to download any of the higher levels, although it wont hurt anything.

You can also install an android device simulator. You can bypass this step if you would rather test the .apk directly on your USB connected device. The simulators are quite slow and require patience when they initialize. The aHPSDR program runs slow and choppy as well (at least on my box -YMMV). You can set up the simulator from the Menu/ Window / AVD manager

Get the aHPSDR sources from: svn co http://svn.tapr.org/repos_sdr_hpsdr/trunk/N6LYT/ghpsdr3/branches/android/ This will create a folder named android in you home directory.

To get started create a new project: File / New / Project. From the select a Wizard window select Android / Android Project then click Next>

Give your project a new name then click Create project from existing source Then Browse to the location the sources are located home/android/aHPSDR then click Next.
Select the target platform/API, Select Android 2.2 (Platform 2.2 API Level 8) then click Finish.

You will now see your new project in the Package Explorer window on the left. Select it then from the Menu Run/ Run. When the window opens select run as android application then click OK

Wait for the ADP simulator to initialize ( could take several minutes and you will have to unlock, etc just like the real device. ) Go to the applications on the device and select aHPSDR.

Have fun!

73, Kevin

AHPSDR

2012-02-13T03:20:22Z

Kj6dzb: /* Android client for listening to dspservers */

AHPSDR

2012-02-12T04:22:28Z

Kj6dzb: /* Android client for listening to dspservers */

==Android client for listening to dspservers==

*The latest APK can be downloaded HERE:[http://napan.com/ve9gj/aHPSDR.apk http://napan.com/ve9gj/aHPSDR.apk]
--------------------------
*Feb 11 2012 Alternate download: [http://napan.com/ve9gj/aHPSDR.apk http://napan.com/ve9gj/aHPSDR.apk]
*Feb 11 2012 svn: [http://svn.tapr.org/listing.php?repname=OpenHPSDR+Main&path=%2Ftrunk%2FN6LYT%2Fghpsdr3%2Fbranches%2Fandroid%2FaHPSDR%2Fbin%2F&#a94c80ff871066a17707aadbebe8526db TAPR svn]
Change list for the Feb 11 2012 build: AHPSDR now has a Server list feature just like QtRadio look under >>menu >>Servers and select from among the active servers.
--------------------------
*Not current pre Feb 11 2012 build can be found HERE:[[http://qsl.net/kj6dzb/stuff/aHPSDR_pre_2_10_11.apk]]

* See the AHPSDR Android Client in use on YouTube:[http://www.youtube.com/watch?v=up-BEKxTTXs http://www.youtube.com/watch?v=up-BEKxTTXs]

AHPSDR

2012-02-12T04:21:18Z

Kj6dzb: /* Android client for listening to dspservers */

==Android client for listening to dspservers==

*The latest APK can be downloaded HERE:[http://napan.com/ve9gj/aHPSDR.apk http://napan.com/ve9gj/aHPSDR.apk]
--------------------------
*Feb 11 2012 Alternate download: [http://napan.com/ve9gj/aHPSDR.apk http://napan.com/ve9gj/aHPSDR.apk]
*Feb 11 2012 svn: [http://svn.tapr.org/listing.php?repname=OpenHPSDR+Main&path=%2Ftrunk%2FN6LYT%2Fghpsdr3%2Fbranches%2Fandroid%2FaHPSDR%2Fbin%2F&#a94c80ff871066a17707aadbebe8526db TAPR svn]
Change list for the Feb 11 2012 build: AHPSDR now has a Server list feature just like QtRadio look under >>menu >>Servers and select from among the active servers.
--------------------------
*Not current the pre Feb 11 2012 build can be found HERE:[[http://qsl.net/kj6dzb/stuff/aHPSDR_pre_2_10_11.apk]]

* YouTube see the AHPSDR Android Client in use:[http://www.youtube.com/watch?v=up-BEKxTTXs http://www.youtube.com/watch?v=up-BEKxTTXs]

AHPSDR

2012-02-12T04:04:47Z

Kj6dzb: /* Android client for listening to dspservers */

==Android client for listening to dspservers==

*The latest APK can be downloaded HERE:[http://napan.com/ve9gj/aHPSDR.apk http://napan.com/ve9gj/aHPSDR.apk]
--------------------------
*Feb 11 2012 Alternate download: [http://napan.com/ve9gj/aHPSDR.apk http://napan.com/ve9gj/aHPSDR.apk]
*Feb 11 2012 svn: [http://svn.tapr.org/listing.php?repname=OpenHPSDR+Main&path=%2Ftrunk%2FN6LYT%2Fghpsdr3%2Fbranches%2Fandroid%2FaHPSDR%2Fbin%2F&#a94c80ff871066a17707aadbebe8526db TAPR svn]
Change list for the Feb 11 2012 build: AHPSDR now has a Server list feature just like QtRadio look under >>menu >>Servers and select from among the active servers.

* See the AHPSDR Android Client in use youtube video [http://www.youtube.com/watch?v=up-BEKxTTXs http://www.youtube.com/watch?v=up-BEKxTTXs]

QtRadio on Windows

2011-12-28T05:45:50Z

Kj6dzb: /* QtRadio Client for Windows */

== QtRadio Client for Windows ==

Window users may be interested to know about some recent software developments in the Ham SDR Linux world. Now Windows can listen to Linux SDR servers (dspservers).

*A zip of the rxtx-event branch built for windows is at: http://napan.com/ve9gj/qtradio-rxtx-event-rtp.zip (Dec 22 2011). This contains the new RTP code. This is the one most of the developers are running at the moment.
*A zip of the rxtx-event branch built for windows is at: http://napan.com/ve9gj/qtradio-rxtx-event.zip (Dec 12 2011). (Before RTP)
*The current zip of master branch can be downloaded from: http://napan.com/ve9gj/qtradio.zip (Built Nov 21 2011). This zip is considered the most stable.
*A zip of master branch can be downloaded from: http://napan.com/ve9gj/qtradio-prebin.zip (Built Nov 21 2011). This zip is the latest NOT including the change to binary header formats.

Unzip to any folder and run the qtradio.exe file. It does not need an actual install just the included dll files in the same folder.
I have built a new Windows QtRadio from the latest master branch at github.com/alexlee188/ghpsdr3-alex. Sources are included in the download and are in the win32 branch at the git same git repo.
It includes the Quick Connect dialog window. This new addition will list all the current online dspservers. Look under the Receiver menu to get started.

== Troubleshooting the Windows version. ==
* If windows is giving you the very helpful error :) ''QtRadio has encountered a problem and needs to close'' try deleting the registry key for QtRadio. The key can be found at: [HKEY_CURRENT_USER\Software\G0ORX] Use regedit to delete it.

== Notes about the Windows version. ==

*This QtRadio is strictly RX only. Some of the controls are for the upcoming full RXTX version and do nothing. Full RXTX has been accomplished but is still very much a work in progress.
*A dspserver can only accept one client at a time hence the Busy/Idle status.
*QtRadio is the only part of the project that is running on Windows at present. The servers components are only running on Linux.
*A lot of the current development chatter about the project can be followed in the http://groups.google.com/group/sdr-widget group. A widget is not required to set up a server but they sure work nice! :)
*Hopefully we can get some more dspservers running. Linux is necessary and there are pre-built binaries available for recent versions of Ubuntu.
*A README is available at: https://github.com/alexlee188/ghpsdr3-alex/blob/master/README
*A crude diagram of the components below. Between the dspserver and Antenna many options are available, softrocks, hpsdr, Ettus USRP and Perseus. QtRadio <->Internet<->dspserver<->softrock application<->soundcard<->softrock hardware->Antenna
*At this time the only application working in Windows is the QtRadio client which can connect to any dspserver. Download the zip file which contains all the needed dlls and qtradio.exe. Extract the qtradio folder to your windows drive and double click qtradio.exe to run.
*The source for building with QtCreator 2.3.0 based on QT 4.7.4 is available via the win32 branch at: https://github.com/alexlee188/ghpsdr3-alex
*Note that codec2 is not working in the win32 version.
*Some users have found that QtRadio won't start at all or crashes shortly after startup. This may be caused by suspect settings in the Windows registry. You can safely delete the key "HKey_CURRENT_USER->Software->G0ORX" with regedit and then try QtRadio again. This will cause QtRadio to start with default settings.

User:Kj6dzb

2011-12-28T05:39:55Z

Kj6dzb:

New AHPSDR icons 12/27/11...
[https://picasaweb.google.com/116775827396183619527/AHPSDR3?authuser=0&feat=directlink]

Im a general Class Radio operator, From Berkeley California. Im a student industrial designer. The effort to design GHPSDR3 software from the ground up has been Great!!! Now lets work on effectively designing the Hardware, that will allow large windows or select portions of spectrum to be sampled, processed and routed with the help of the GHPSDR3 servers.

In an effort to advance SDR tech, I would like to interface the USB2SDR with the GHPSDR3, this means writing new drivers that will allow the GHPSDR3 to communicate with AD converters as a linux audio device and to control Softrock style boards or future boards via an i2c interface.

My wish list for 2012 is as follows...

-The ability to lock on to Multiple signals and output the audio or send the audio to different programs. Only signals that exist within the current scope. Signal mode detection is possible, but a far reach at the moment...

-memory save/recall functions to save events. RX memory's saving:frz, mode,... & rx&tx memory's frz, mode, transmit offset, Power output...

-radio interface for the Hamlib standard that would interface into programs like Gpridect ie (RX mode that can lock onto UHF/VHF/HF capable satilte and given 1 or more Frz & modes it would track the signals outputting the individual signals to individual audio outputs.

User:Kj6dzb

2011-12-28T05:39:29Z

Kj6dzb:

New AHPSDR icons...
[https://picasaweb.google.com/116775827396183619527/AHPSDR3?authuser=0&feat=directlink]

Im a general Class Radio operator, From Berkeley California. Im a student industrial designer. The effort to design GHPSDR3 software from the ground up has been Great!!! Now lets work on effectively designing the Hardware, that will allow large windows or select portions of spectrum to be sampled, processed and routed with the help of the GHPSDR3 servers.

In an effort to advance SDR tech, I would like to interface the USB2SDR with the GHPSDR3, this means writing new drivers that will allow the GHPSDR3 to communicate with AD converters as a linux audio device and to control Softrock style boards or future boards via an i2c interface.

My wish list for 2012 is as follows...

-The ability to lock on to Multiple signals and output the audio or send the audio to different programs. Only signals that exist within the current scope. Signal mode detection is possible, but a far reach at the moment...

-memory save/recall functions to save events. RX memory's saving:frz, mode,... & rx&tx memory's frz, mode, transmit offset, Power output...

-radio interface for the Hamlib standard that would interface into programs like Gpridect ie (RX mode that can lock onto UHF/VHF/HF capable satilte and given 1 or more Frz & modes it would track the signals outputting the individual signals to individual audio outputs.