Ghpsdr3 SDR project - User contributions [en]

Odroid

2016-04-26T16:11:14Z

G3vbv: /* How to compile Qt5 */

= Odroid Wiki =

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

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

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

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

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

The install procedure is as follows:

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

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

= How to compile Qt5 =

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

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

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

Append to ~/.bashrc the following lines:

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

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

Clone the base repository:

cd
git clone git://code.qt.io/qt/qt5.git

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

cd qt5
perl init-repository

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

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

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

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

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

= Forcing all CPU's active =

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

= HardKernel documentation on ODROID X and Q =

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

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

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

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

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

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

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

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

Odroid

2015-09-13T00:14:20Z

G3vbv: /* How to compile Qt5 */

= Odroid Wiki =

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

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

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

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

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

The install procedure is as follows:

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

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

= How to compile Qt5 =

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

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

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

Append to ~/.bashrc the following lines:

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

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

Clone the base repository:

cd
git clone git://code.qt.io/qt/qt5.git

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

cd qt5
perl init-repository --no-webkit

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

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

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

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

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

= Forcing all CPU's active =

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

= HardKernel documentation on ODROID X and Q =

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

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

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

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

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

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

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

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

Odroid

2015-09-13T00:03:07Z

G3vbv: /* How to compile Qt5 */

= Odroid Wiki =

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

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

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

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

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

The install procedure is as follows:

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

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

= How to compile Qt5 =

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

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

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

Append to ~/.bashrc the following lines:

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

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

Clone the base repository:

cd
git clone https://github.com/qtproject/qt5.git

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

cd qt5
perl init-repository --no-webkit

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

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

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

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

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

= Forcing all CPU's active =

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

= HardKernel documentation on ODROID X and Q =

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

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

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

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

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

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

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

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

Pulseaudio Setup

2015-05-05T19:41:40Z

G3vbv: /* Enable Pulseaudio Daemon to run in system wide mode */

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

In order to install it, submit the following command:

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

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

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

[[File:Recording.png]]

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

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

In order to install it, submit the following command:

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

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

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

[[File:PulseAudio_Preferences_036.png]]

 

[[File:PulseAudio_Preferences_037.png]]

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

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

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

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

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

change settings to:

<pre>
PULSEAUDIO_SYSTEM_START=1
DISALLOW_MODULE_LOADING=0
</pre>

Latest pulseaudio versions settings, /etc/default/pulseaudio is not used:-

"sudo nano /etc/pulse/daemon.conf" and uncomment the following line to read as follows:-

daemonize = yes

==== Enable network mode ====
<pre>
sudo nano /etc/pulse/system.pa
</pre>

and add:

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

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

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

== Configure Pulseaudio Daemon ==

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

Uncomment these settings and change it for your needs.

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

== Tweak System for realtime performance ==

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

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

Pulseaudio Setup

2015-05-05T19:40:14Z

G3vbv: /* Enable Pulseaudio Daemon to run in system wide mode */

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

In order to install it, submit the following command:

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

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

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

[[File:Recording.png]]

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

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

In order to install it, submit the following command:

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

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

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

[[File:PulseAudio_Preferences_036.png]]

 

[[File:PulseAudio_Preferences_037.png]]

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

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

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

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

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

change settings to:

<pre>
PULSEAUDIO_SYSTEM_START=1
DISALLOW_MODULE_LOADING=0
</pre>

Latest pulseaudio settings, /etc/default/pulseaudio is not used:-
"sudo nano /etc/pulse/daemon.conf" and uncomment the following line to read as follows:-

daemonize = yes

==== Enable network mode ====
<pre>
sudo nano /etc/pulse/system.pa
</pre>

and add:

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

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

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

== Configure Pulseaudio Daemon ==

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

Uncomment these settings and change it for your needs.

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

== Tweak System for realtime performance ==

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

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

Pulseaudio Setup

2015-05-05T19:38:48Z

G3vbv: /* Enable Pulseaudio Daemon to run in system wide mode */

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

In order to install it, submit the following command:

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

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

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

[[File:Recording.png]]

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

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

In order to install it, submit the following command:

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

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

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

[[File:PulseAudio_Preferences_036.png]]

 

[[File:PulseAudio_Preferences_037.png]]

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

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

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

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

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

change settings to:

<pre>
PULSEAUDIO_SYSTEM_START=1
DISALLOW_MODULE_LOADING=0
</pre>

Latest pulseaudio settings, /etc/default/pulseaudio is not used:-
Edit /etc/pulse/daemon.conf and uncomment the following line to read as follows:-

daemonize = yes

==== Enable network mode ====
<pre>
sudo nano /etc/pulse/system.pa
</pre>

and add:

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

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

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

== Configure Pulseaudio Daemon ==

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

Uncomment these settings and change it for your needs.

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

== Tweak System for realtime performance ==

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

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

Pulseaudio Setup

2015-05-05T19:37:37Z

G3vbv: /* Enable Pulseaudio Daemon to run in system wide mode */

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

In order to install it, submit the following command:

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

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

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

[[File:Recording.png]]

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

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

In order to install it, submit the following command:

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

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

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

[[File:PulseAudio_Preferences_036.png]]

 

[[File:PulseAudio_Preferences_037.png]]

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

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

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

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

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

change settings to:

<pre>
PULSEAUDIO_SYSTEM_START=1
DISALLOW_MODULE_LOADING=0
</pre>

Latest pulseaudio settings, /etc/default/pulseaudio is not used:-
Edit /etc/pulse/daemon.conf and uncomment the following line to read as follows:-
daemonize = yes

==== Enable network mode ====
<pre>
sudo nano /etc/pulse/system.pa
</pre>

and add:

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

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

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

== Configure Pulseaudio Daemon ==

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

Uncomment these settings and change it for your needs.

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

== Tweak System for realtime performance ==

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

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

QtRadio Installation

2014-10-03T14:59:07Z

G3vbv: /* Fedora 16 and newer ** AVOID CentOS ** It is not a Desktop OS */

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

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

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

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

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

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

==== Installing prerequisite packages ====

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

<pre>
sudo apt-get update
sudo apt-get install \
libqt4-opengl-dev \
qtmobility-dev \
libusb-0.1-4 \
libusb-dev \
libfftw3-dev \
portaudio19-dev \
libpulse-dev \
libsamplerate0-dev \
libusb-1.0-0-dev \
libconfig8-dev \
xdg-utils \
libortp-dev \
gcc-multilib \
libssl-dev \
libevent-dev \
libglu1-mesa-dev \
freeglut3-dev \
cmake \
libspeexdsp-dev \
libxcb-composite0-dev

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

</pre>

You will need qt5 installed to complete the build.

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

download the current package for your system.

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

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

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

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

Next, you will need the following packages installed:

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

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

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

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

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

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

==== Cloning the repository ====

How to build the latest master branch on Ubuntu 11.04

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

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

$ sudo apt-get install libevent-dev

If the version is older than 2.0.5, go to synaptic and completely remove the stock libevent from Ubuntu. (Completely remove is an uninstall option in Synaptic. Additional dependent libraries may also be removed)

Then download the new version from:

http://libevent.org/

libevent-2.0.16-stable.tar.gz

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

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

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

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

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

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

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

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

Now go get codec2 using subversion

<pre>
svn co https://svn.code.sf.net/p/freetel/code/codec2 codec2
cd codec2

mkdir build
cd build
cmake ../

sudo make
sudo make install
sudo ldconfig
</pre>

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

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

sudo cp * ..
</pre>

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

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

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

==== Building the master branch ====

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

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

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

Depending on your Internet connection thorughput, it will take several minute to download.
cd into the new directory ghpsdr3-alex:
<pre>
cd ghpsdr3-alex
git checkout master
</pre>
You are now working with Alex's latest and greatest!

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

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

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

(If you do not want to actually install the executable binaries, skip the sudo make install and just cd into the following directories and run them from there)
<pre>
Terminal 1
$ cd ghpsdr3-alex/trunk/src/softrock
$ ./softrock ...options ...

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

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

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

In order to build the Microtelecom Perseus server you need to switch to the master or iw0hdv branch.

First off, install the prerequisite library and wget package:

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

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

<pre>
cd
wget http://libperseus-sdr.googlecode.com/files/libperseus_sdr-0.6.tar.gz
tar -zxvf libperseus_sdr-0.6.tar.gz
cd libperseus_sdr-0.6/
./configure && make
sudo make install
sudo ldconfig
</pre>

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

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

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

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

<pre>
cd ~/ghpsdr3-alex
git checkout master
autoreconf -i && ./configure && make -j4
sudo make install
</pre>

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

<pre>
xterm -e 'perseus_server -d3 -s96000 ' &
sleep 3
xterm -e 'dspserver --lo 0 --nocorrectiq' &
sleep 5
$( QtRadio 127.0.0.1 )
</pre>

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

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

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

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

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

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

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

<pre>
cd
git clone git://ettus.sourcerepo.com/ettus/uhd.git
cd uhd/host/
mkdir build
cd build
cmake ../
make
make test
sudo make install
sudo ldconfig
</pre>

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

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

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

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

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

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

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

==VirtualBox Easy Installation==

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

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

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

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

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

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

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

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

== Installing ghpsdr3-alex on Raspberry Pi ==

===Hardware===

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

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

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

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

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

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

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

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

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

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

Sun Sep 9 13:00:49 BST 2012

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

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

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

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

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

root@pisces:~# lsusb

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

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

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

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

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

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

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

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

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

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

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

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

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

lo Link encap:Local Loopback

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

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

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

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

over_voltage=6

arm_freq=855

core_freq=500

sdram_freq=500

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

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

auto lo

iface lo inet loopback

File: ifcfg-eth0

auto eth0

iface eth0 inet static

address 192.168.10.31

netmask 255.255.255.0

gateway 192.168.10.103

auto eth1

iface eth1 inet static

address 192.168.2.199

netmask 255.255.255.0

root@pisces:~# cat /etc/modules

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

loop

snd-bcm2835

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

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

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

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

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

autoreconf -i

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

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

make all && make all install

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

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

"amixer cset numid=3 1"

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

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

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

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

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

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

QtRadio Installation

2014-10-03T14:50:22Z

G3vbv: /* Fedora 16 and newer ** AVOID CentOS ** It is not a Desktop OS */

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

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

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

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

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

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

==== Installing prerequisite packages ====

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

<pre>
sudo apt-get update
sudo apt-get install \
libqt4-opengl-dev \
qtmobility-dev \
libusb-0.1-4 \
libusb-dev \
libfftw3-dev \
portaudio19-dev \
libpulse-dev \
libsamplerate0-dev \
libusb-1.0-0-dev \
libconfig8-dev \
xdg-utils \
libortp-dev \
gcc-multilib \
libssl-dev \
libevent-dev \
libglu1-mesa-dev \
freeglut3-dev \
cmake \
libspeexdsp-dev \
libxcb-composite0-dev

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

</pre>

You will need qt5 installed to complete the build.

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

download the current package for your system.

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

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

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

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

Next, you will need the following packages installed:

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

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

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

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

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

Qt5 is needed to build QtRadio. If the distro does not include qt5, follow the build instructions in the section ODROID - OK for all platforms.
</pre>

==== Cloning the repository ====

How to build the latest master branch on Ubuntu 11.04

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

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

$ sudo apt-get install libevent-dev

If the version is older than 2.0.5, go to synaptic and completely remove the stock libevent from Ubuntu. (Completely remove is an uninstall option in Synaptic. Additional dependent libraries may also be removed)

Then download the new version from:

http://libevent.org/

libevent-2.0.16-stable.tar.gz

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

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

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

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

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

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

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

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

Now go get codec2 using subversion

<pre>
svn co https://svn.code.sf.net/p/freetel/code/codec2 codec2
cd codec2

mkdir build
cd build
cmake ../

sudo make
sudo make install
sudo ldconfig
</pre>

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

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

sudo cp * ..
</pre>

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

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

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

==== Building the master branch ====

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

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

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

Depending on your Internet connection thorughput, it will take several minute to download.
cd into the new directory ghpsdr3-alex:
<pre>
cd ghpsdr3-alex
git checkout master
</pre>
You are now working with Alex's latest and greatest!

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

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

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

(If you do not want to actually install the executable binaries, skip the sudo make install and just cd into the following directories and run them from there)
<pre>
Terminal 1
$ cd ghpsdr3-alex/trunk/src/softrock
$ ./softrock ...options ...

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

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

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

In order to build the Microtelecom Perseus server you need to switch to the master or iw0hdv branch.

First off, install the prerequisite library and wget package:

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

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

<pre>
cd
wget http://libperseus-sdr.googlecode.com/files/libperseus_sdr-0.6.tar.gz
tar -zxvf libperseus_sdr-0.6.tar.gz
cd libperseus_sdr-0.6/
./configure && make
sudo make install
sudo ldconfig
</pre>

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

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

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

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

<pre>
cd ~/ghpsdr3-alex
git checkout master
autoreconf -i && ./configure && make -j4
sudo make install
</pre>

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

<pre>
xterm -e 'perseus_server -d3 -s96000 ' &
sleep 3
xterm -e 'dspserver --lo 0 --nocorrectiq' &
sleep 5
$( QtRadio 127.0.0.1 )
</pre>

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

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

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

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

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

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

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

<pre>
cd
git clone git://ettus.sourcerepo.com/ettus/uhd.git
cd uhd/host/
mkdir build
cd build
cmake ../
make
make test
sudo make install
sudo ldconfig
</pre>

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

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

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

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

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

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

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

==VirtualBox Easy Installation==

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

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

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

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

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

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

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

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

== Installing ghpsdr3-alex on Raspberry Pi ==

===Hardware===

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

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

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

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

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

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

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

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

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

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

Sun Sep 9 13:00:49 BST 2012

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

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

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

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

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

root@pisces:~# lsusb

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

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

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

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

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

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

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

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

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

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

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

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

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

lo Link encap:Local Loopback

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

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

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

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

over_voltage=6

arm_freq=855

core_freq=500

sdram_freq=500

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

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

auto lo

iface lo inet loopback

File: ifcfg-eth0

auto eth0

iface eth0 inet static

address 192.168.10.31

netmask 255.255.255.0

gateway 192.168.10.103

auto eth1

iface eth1 inet static

address 192.168.2.199

netmask 255.255.255.0

root@pisces:~# cat /etc/modules

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

loop

snd-bcm2835

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

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

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

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

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

autoreconf -i

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

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

make all && make all install

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

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

"amixer cset numid=3 1"

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

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

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

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

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

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

QtRadio Installation

2014-10-03T14:41:04Z

G3vbv: /* Fedora 16 and newer ** AVOID CentOS */

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

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

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

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

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

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

==== Installing prerequisite packages ====

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

<pre>
sudo apt-get update
sudo apt-get install \
libqt4-opengl-dev \
qtmobility-dev \
libusb-0.1-4 \
libusb-dev \
libfftw3-dev \
portaudio19-dev \
libpulse-dev \
libsamplerate0-dev \
libusb-1.0-0-dev \
libconfig8-dev \
xdg-utils \
libortp-dev \
gcc-multilib \
libssl-dev \
libevent-dev \
libglu1-mesa-dev \
freeglut3-dev \
cmake \
libspeexdsp-dev \
libxcb-composite0-dev

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

</pre>

You will need qt5 installed to complete the build.

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

download the current package for your system.

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

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

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

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

Next, you will need the following packages installed:

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

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

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

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

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

==== Cloning the repository ====

How to build the latest master branch on Ubuntu 11.04

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

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

$ sudo apt-get install libevent-dev

If the version is older than 2.0.5, go to synaptic and completely remove the stock libevent from Ubuntu. (Completely remove is an uninstall option in Synaptic. Additional dependent libraries may also be removed)

Then download the new version from:

http://libevent.org/

libevent-2.0.16-stable.tar.gz

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

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

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

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

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

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

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

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

Now go get codec2 using subversion

<pre>
svn co https://svn.code.sf.net/p/freetel/code/codec2 codec2
cd codec2

mkdir build
cd build
cmake ../

sudo make
sudo make install
sudo ldconfig
</pre>

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

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

sudo cp * ..
</pre>

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

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

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

==== Building the master branch ====

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

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

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

Depending on your Internet connection thorughput, it will take several minute to download.
cd into the new directory ghpsdr3-alex:
<pre>
cd ghpsdr3-alex
git checkout master
</pre>
You are now working with Alex's latest and greatest!

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

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

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

(If you do not want to actually install the executable binaries, skip the sudo make install and just cd into the following directories and run them from there)
<pre>
Terminal 1
$ cd ghpsdr3-alex/trunk/src/softrock
$ ./softrock ...options ...

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

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

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

In order to build the Microtelecom Perseus server you need to switch to the master or iw0hdv branch.

First off, install the prerequisite library and wget package:

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

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

<pre>
cd
wget http://libperseus-sdr.googlecode.com/files/libperseus_sdr-0.6.tar.gz
tar -zxvf libperseus_sdr-0.6.tar.gz
cd libperseus_sdr-0.6/
./configure && make
sudo make install
sudo ldconfig
</pre>

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

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

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

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

<pre>
cd ~/ghpsdr3-alex
git checkout master
autoreconf -i && ./configure && make -j4
sudo make install
</pre>

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

<pre>
xterm -e 'perseus_server -d3 -s96000 ' &
sleep 3
xterm -e 'dspserver --lo 0 --nocorrectiq' &
sleep 5
$( QtRadio 127.0.0.1 )
</pre>

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

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

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

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

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

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

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

<pre>
cd
git clone git://ettus.sourcerepo.com/ettus/uhd.git
cd uhd/host/
mkdir build
cd build
cmake ../
make
make test
sudo make install
sudo ldconfig
</pre>

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

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

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

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

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

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

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

==VirtualBox Easy Installation==

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

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

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

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

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

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

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

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

== Installing ghpsdr3-alex on Raspberry Pi ==

===Hardware===

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

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

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

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

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

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

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

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

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

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

Sun Sep 9 13:00:49 BST 2012

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

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

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

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

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

root@pisces:~# lsusb

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

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

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

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

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

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

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

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

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

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

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

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

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

lo Link encap:Local Loopback

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

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

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

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

over_voltage=6

arm_freq=855

core_freq=500

sdram_freq=500

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

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

auto lo

iface lo inet loopback

File: ifcfg-eth0

auto eth0

iface eth0 inet static

address 192.168.10.31

netmask 255.255.255.0

gateway 192.168.10.103

auto eth1

iface eth1 inet static

address 192.168.2.199

netmask 255.255.255.0

root@pisces:~# cat /etc/modules

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

loop

snd-bcm2835

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

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

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

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

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

autoreconf -i

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

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

make all && make all install

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

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

"amixer cset numid=3 1"

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

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

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

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

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

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

QtRadio Installation

2014-10-03T14:40:15Z

G3vbv: /* Fedora 16 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 \
libevent-dev \
libglu1-mesa-dev \
freeglut3-dev \
cmake \
libspeexdsp-dev \
libxcb-composite0-dev

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

</pre>

You will need qt5 installed to complete the build.

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

download the current package for your system.

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

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

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

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

Next, you will need the following packages installed:

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

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

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

===== Fedora 16 and newer ** AVOID CentOS =====

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

==== Cloning the repository ====

How to build the latest master branch on Ubuntu 11.04

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

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

$ sudo apt-get install libevent-dev

If the version is older than 2.0.5, go to synaptic and completely remove the stock libevent from Ubuntu. (Completely remove is an uninstall option in Synaptic. Additional dependent libraries may also be removed)

Then download the new version from:

http://libevent.org/

libevent-2.0.16-stable.tar.gz

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

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

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

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

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

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

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

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

Now go get codec2 using subversion

<pre>
svn co https://svn.code.sf.net/p/freetel/code/codec2 codec2
cd codec2

mkdir build
cd build
cmake ../

sudo make
sudo make install
sudo ldconfig
</pre>

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

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

sudo cp * ..
</pre>

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

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

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

==== Building the master branch ====

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

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

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

Depending on your Internet connection thorughput, it will take several minute to download.
cd into the new directory ghpsdr3-alex:
<pre>
cd ghpsdr3-alex
git checkout master
</pre>
You are now working with Alex's latest and greatest!

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

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

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

(If you do not want to actually install the executable binaries, skip the sudo make install and just cd into the following directories and run them from there)
<pre>
Terminal 1
$ cd ghpsdr3-alex/trunk/src/softrock
$ ./softrock ...options ...

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

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

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

In order to build the Microtelecom Perseus server you need to switch to the master or iw0hdv branch.

First off, install the prerequisite library and wget package:

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

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

<pre>
cd
wget http://libperseus-sdr.googlecode.com/files/libperseus_sdr-0.6.tar.gz
tar -zxvf libperseus_sdr-0.6.tar.gz
cd libperseus_sdr-0.6/
./configure && make
sudo make install
sudo ldconfig
</pre>

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

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

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

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

<pre>
cd ~/ghpsdr3-alex
git checkout master
autoreconf -i && ./configure && make -j4
sudo make install
</pre>

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

<pre>
xterm -e 'perseus_server -d3 -s96000 ' &
sleep 3
xterm -e 'dspserver --lo 0 --nocorrectiq' &
sleep 5
$( QtRadio 127.0.0.1 )
</pre>

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

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

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

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

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

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

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

<pre>
cd
git clone git://ettus.sourcerepo.com/ettus/uhd.git
cd uhd/host/
mkdir build
cd build
cmake ../
make
make test
sudo make install
sudo ldconfig
</pre>

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

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

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

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

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

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

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

==VirtualBox Easy Installation==

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

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

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

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

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

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

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

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

== Installing ghpsdr3-alex on Raspberry Pi ==

===Hardware===

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

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

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

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

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

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

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

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

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

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

Sun Sep 9 13:00:49 BST 2012

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

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

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

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

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

root@pisces:~# lsusb

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

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

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

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

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

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

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

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

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

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

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

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

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

lo Link encap:Local Loopback

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

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

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

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

over_voltage=6

arm_freq=855

core_freq=500

sdram_freq=500

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

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

auto lo

iface lo inet loopback

File: ifcfg-eth0

auto eth0

iface eth0 inet static

address 192.168.10.31

netmask 255.255.255.0

gateway 192.168.10.103

auto eth1

iface eth1 inet static

address 192.168.2.199

netmask 255.255.255.0

root@pisces:~# cat /etc/modules

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

loop

snd-bcm2835

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

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

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

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

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

autoreconf -i

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

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

make all && make all install

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

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

"amixer cset numid=3 1"

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

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

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

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

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

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

QtRadio Installation

2014-10-02T15:21:59Z

G3vbv: /* Fedora 16 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 \
libevent-dev \
libglu1-mesa-dev \
freeglut3-dev \
cmake \
libspeexdsp-dev \
libxcb-composite0-dev

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

</pre>

You will need qt5 installed to complete the build.

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

download the current package for your system.

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

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

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

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

Next, you will need the following packages installed:

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

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

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

===== Fedora 16 and newer=====

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

==== Cloning the repository ====

How to build the latest master branch on Ubuntu 11.04

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

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

$ sudo apt-get install libevent-dev

If the version is older than 2.0.5, go to synaptic and completely remove the stock libevent from Ubuntu. (Completely remove is an uninstall option in Synaptic. Additional dependent libraries may also be removed)

Then download the new version from:

http://libevent.org/

libevent-2.0.16-stable.tar.gz

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

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

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

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

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

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

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

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

Now go get codec2 using subversion

<pre>
svn co https://svn.code.sf.net/p/freetel/code/codec2 codec2
cd codec2

mkdir build
cd build
cmake ../

sudo make
sudo make install
sudo ldconfig
</pre>

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

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

sudo cp * ..
</pre>

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

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

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

==== Building the master branch ====

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

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

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

Depending on your Internet connection thorughput, it will take several minute to download.
cd into the new directory ghpsdr3-alex:
<pre>
cd ghpsdr3-alex
git checkout master
</pre>
You are now working with Alex's latest and greatest!

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

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

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

(If you do not want to actually install the executable binaries, skip the sudo make install and just cd into the following directories and run them from there)
<pre>
Terminal 1
$ cd ghpsdr3-alex/trunk/src/softrock
$ ./softrock ...options ...

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

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

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

In order to build the Microtelecom Perseus server you need to switch to the master or iw0hdv branch.

First off, install the prerequisite library and wget package:

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

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

<pre>
cd
wget http://libperseus-sdr.googlecode.com/files/libperseus_sdr-0.6.tar.gz
tar -zxvf libperseus_sdr-0.6.tar.gz
cd libperseus_sdr-0.6/
./configure && make
sudo make install
sudo ldconfig
</pre>

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

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

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

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

<pre>
cd ~/ghpsdr3-alex
git checkout master
autoreconf -i && ./configure && make -j4
sudo make install
</pre>

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

<pre>
xterm -e 'perseus_server -d3 -s96000 ' &
sleep 3
xterm -e 'dspserver --lo 0 --nocorrectiq' &
sleep 5
$( QtRadio 127.0.0.1 )
</pre>

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

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

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

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

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

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

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

<pre>
cd
git clone git://ettus.sourcerepo.com/ettus/uhd.git
cd uhd/host/
mkdir build
cd build
cmake ../
make
make test
sudo make install
sudo ldconfig
</pre>

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

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

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

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

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

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

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

==VirtualBox Easy Installation==

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

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

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

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

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

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

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

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

== Installing ghpsdr3-alex on Raspberry Pi ==

===Hardware===

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

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

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

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

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

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

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

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

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

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

Sun Sep 9 13:00:49 BST 2012

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

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

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

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

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

root@pisces:~# lsusb

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

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

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

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

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

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

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

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

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

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

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

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

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

lo Link encap:Local Loopback

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

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

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

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

over_voltage=6

arm_freq=855

core_freq=500

sdram_freq=500

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

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

auto lo

iface lo inet loopback

File: ifcfg-eth0

auto eth0

iface eth0 inet static

address 192.168.10.31

netmask 255.255.255.0

gateway 192.168.10.103

auto eth1

iface eth1 inet static

address 192.168.2.199

netmask 255.255.255.0

root@pisces:~# cat /etc/modules

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

loop

snd-bcm2835

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

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

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

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

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

autoreconf -i

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

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

make all && make all install

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

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

"amixer cset numid=3 1"

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

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

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

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

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

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

Developers Documentation

2014-09-03T16:29:26Z

G3vbv: /* Installing codec2 low bit rate audio encoding and decoding */

*[https://github.com/alexlee188/ghpsdr3-alex Git Repository ]
*[https://github.com/alexlee188/ghpsdr3-alex/blob/master/README README]
*[http://code.google.com/p/sdr-shell/wiki/SDRCore Dttsp]
*[http://www.youtube.com/watch?v=6KtOzh0StTc A Very good video tutorial series on using QT and C++]
*[http://openhpsdr.org/wiki/index.php?title=Ghpsdr3 A Brief Description on the architecture of ghpsdr3]
*[http://openhpsdr.org/wiki/images/4/47/Ghpsdr3-protocols2010-08-07.pdf Ghpsdr3 communication protocols 2010-08-07]
*[http://openhpsdr.org/wiki/index.php?title=Ghpsdr3_protocols More on the Ghpsdr communications protocols (and more up to date)]
*[[dspserver.conf]] The '''''dspserver.conf''''' file has it's own page

Most of the development discussion has been taking place on the [http://groups.google.com/group/sdr-widget sdr-widget google group].

= Installing portaudio19-dev with jackd2 =

Portaudio19-dev depends on having a copy of libjack-dev installed and if the libkjack-jackd2-dev package is installed before portaudio19-dev it's dependency will be satisfied and it will not uninstall jackd2 and install jackd1 if you have already installed jackd2 on your system.

== If jackd1 and portaudio19-dev already installed ==

<pre>From Synaptic

Uninstall portaudio19-dev
Uninstall jackd1
Install Jackd2
Install libjack-jackd2-dev
Install portaudio19-dev
</pre>

== If you are starting from scratch ==

<pre>From Synaptic

Install Jackd2
Install libjack-jackd2-dev
Install portaudio19-dev
</pre>

The following commands install all the environment needed (Debian/Ubuntu):

<pre>
sudo apt-get install jackd2 libjack-jackd2-dev portaudio19-dev

sudo apt-get install make gcc g++ autoconf automake autotools-dev libtool git subversion
sudo apt-get install libusb-0.1-4 libusb-dev libfftw3-dev libpulse-dev libsamplerate0-dev
sudo apt-get install libusb-1.0-0-dev libconfig8-dev xdg-utils libortp-dev
sudo apt-get install libevent-dev

</pre>

'''If the machine doesn't have an OpenGL aware accelerated video card, please install also the following packages:'''

<pre>
sudo apt-get install mesa-utils
sudo apt-get install mesa-common-dev
sudo apt-get install libgl1-mesa-dev
sudo apt-get install x11proto-xext-dev
sudo apt-get install libxrender-dev
</pre>

Note: in at least one case (thanks to Pierluigi iw4blg), even if the machine was running with an NVidia card and proprietary NVidia device drivers, the test for Qt in configure did fail, as well did the example programs enclosed in qt5 package, complaining that both GL/gl.h and libGL were missing. Installing all the above packages the problem was solved.

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

To download and build the codec2 library. See:

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

Now go get codec2 using subversion

<pre>
cd
svn co https://freetel.svn.sourceforge.net/svnroot/freetel/codec2
cd codec2
mkdir build
cd build
cmake ..

If cmake complains it will ask you to remove ../CMakelists.txt and may be the ../CMakeFiles directory.
After removal of those.
cmake ..
make
sudo make install
sudo ldconfig
</pre>

*** The codec2 developers have warned that codec2-dev is the development version which may or may not work, codec2 is the stable branch.

= Installing Qt5 =

http://qt-project.org/downloads

U should download the Qt5.0.0 libraries file. 64 bit for x86_64 and 32 bit for x86 PC etc.

** Download the latest file from the above URL - it will not be 5.0.0 but the instructions that follow are to be amended according to the version downloaded.
** For ARM follow Andrea's instructions in the ODROID section of this wiki as there are no binaries available for ARM platforms.

After downloading you go to the download directory and do:

$ chmod +x the-name-of-the-downloaded-file

$ sudo ./the-name-of-the-downloaded-file

After that you should have something installed in /opt/Qt5.0.0

== Setting the path to qt5 ==

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>

== Compiling QtRadio ==
<pre>
cd
git clone https://github.com/alexlee188/ghpsdr3-alex.git
cd ghpsdr3-alex
git checkout master

sh ./cleanup.sh
autoreconf -i

sh ./alex-conf.sh

</pre>

Last, build everything:

<pre>
make
sudo make install
</pre>

== Setting QtCreator to use the qt5 libraries ==

If you want to use Qt Creator (you use the same Qt Creator as with Qt4), you need to configure it to use Qt5 as one of the options:
<pre>
From the top line menu of QtCreator ...

Tools > Options > Build & Run
Click on the Qt Versions panel
Click on Add button
Navigate to /opt/Qt5.0.0/5.0.0/gcc_64/bin
Click on qmake
Click on open
Click on Apply then OK
</pre>
You need to point to the qmake file which is found in /opt/Qt5.0.0/5.0.0/gcc_64/bin

== Choosing the build library in QtCreator ==

you need to (re)import your QtRadio project and then you will be able to select Qt5 (or the previous Qt4.8 etc.) for building the application.

It may be necessary to edit the project file (QtRadio.pro) to choose which version of Qt Creator you are using which can be the SDK directly from Nokia, or the Ubuntu install of Creator. The line "_UsingSDK" needs to be set to true or false as appropriate.

== Qt5.0.0 bug ==

There is likely to be a bug in the Qt5.0.0 release that leads to QtRadio hangs when you click on the menu after running QtRadio for a while when a buffer underun has occured.

This happens only one some PC's, but not others.

If it does, you can revert to an older Qt5 BETA:

On my one of 3 PC's with the QtRadio lockup problem (when you click on any menu items after running QtRadio for a while, especially after a buffer underflow), I rebuild QtRadio using Qt5 from the Edgers ppa (which is a late BETA version), and the problem disappears completely :-)

https://launchpad.net/~canonical-qt5-edgers/+archive/qt5-daily

To get it to build in the Edgers, you just have to set the path to the Edgers directory. E.g. in mine, it is:

<pre>
$ export PATH=/opt/qt5/bin:$PATH
</pre>

Use these commands to create symbolic links in the qt5 library (which you have to do only once):

<pre>
$ cd /opt/qt5/lib
$ sudo ln -s libQtMultimedia.so.5.0.0 libQt5Multimedia.so
$ sudo ln -s libQtMultimedia.so.5.0.0 libQt5Multimedia.so.5
$ sudo ln -s libQtMultimedia.so.5.0.0 libQt5Multimedia.so.5.0
</pre>

then you should be able to do the usual build steps.

QtRadio Installation

2014-08-28T14:28:42Z

G3vbv: /* 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 \
libevent-dev \
libglu1-mesa-dev \
freeglut3-dev \
cmake \
libspeexdsp-dev \
libxcb-composite0-dev

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

</pre>

You will need qt5 installed to complete the build.

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

download the current package for your system.

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

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

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

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

Next, you will need the following packages installed:

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

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

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

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

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

==== Cloning the repository ====

How to build the latest master branch on Ubuntu 11.04

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

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

$ sudo apt-get install libevent-dev

If the version is older than 2.0.5, go to synaptic and completely remove the stock libevent from Ubuntu. (Completely remove is an uninstall option in Synaptic. Additional dependent libraries may also be removed)

Then download the new version from:

http://libevent.org/

libevent-2.0.16-stable.tar.gz

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

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

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

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

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

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

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

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

Now go get codec2 using subversion

<pre>
svn co https://svn.code.sf.net/p/freetel/code/codec2 codec2
cd codec2

mkdir build
cd build
cmake ../

sudo make
sudo make install
sudo ldconfig
</pre>

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

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

sudo cp * ..
</pre>

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

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

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

==== Building the master branch ====

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

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

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

Depending on your Internet connection thorughput, it will take several minute to download.
cd into the new directory ghpsdr3-alex:
<pre>
cd ghpsdr3-alex
git checkout master
</pre>
You are now working with Alex's latest and greatest!

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

Then:
<pre>
autoreconf -i
./configure
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]]

==VirtualBox Easy Installation==

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

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

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

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

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

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

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

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

== Installing ghpsdr3-alex on Raspberry Pi ==

===Hardware===

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

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

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

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

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

I also ran "rpi-update" which install new firmware.

I shorted out the polyfuses F1 and F2 on the Pi and USB is much more stable but still limited.

With keyboard, mouse, gigabit USB Ethernet, SB Live! 24 USB and RTL-SDR dongle it runs for some hours before it freezes.

Removing the RTL-SDR dongle from the powered hub made a great difference with a current uptime heading for 3 days. The latest ghpsdr3-alex master branch build successfully completed while I was in bed.

root@pisces:/usr/src/GHPSDR3_HIGH_SPEED_MASTER/ghpsdr3-alex# date

Sun Sep 9 13:00:49 BST 2012

root@pisces:/usr/src/GHPSDR3_HIGH_SPEED_MASTER/ghpsdr3-alex# uptime

13:00:56 up 2 days, 20:46, 8 users, load average: 0.81, 1.01, 0.67

****** Do not use power from a USB PC port or from a USB Hub. ********

Once it's up and running, some details that may help in setting up the hardware for use - I'm currently overclocking at 855MHz (Previously was set to 1GHz):-

Keyboard, mouse, usb sound card, RTL-SDR TV dongle and USB Gigabit Ethernet fully operational using the 7-port powered USB hub.

root@pisces:~# lsusb

Bus 001 Device 001: ID 1d6b:0002 Linux Foundation 2.0 root hub

Bus 001 Device 002: ID 0424:9512 Standard Microsystems Corp.

Bus 001 Device 003: ID 0424:ec00 Standard Microsystems Corp.

Bus 001 Device 004: ID 04cc:1521 ST-Ericsson USB 2.0 Hub

Bus 001 Device 011: ID 04f3:0103 Elan Microelectronics Corp.

Bus 001 Device 006: ID 047d:1022 Kensington Orbit Optical

Bus 001 Device 007: ID 1d19:1101 Dexatek Technology Ltd. DK DVB-T Dongle

Bus 001 Device 008: ID 041e:3040 Creative Technology, Ltd SoundBlaster Live! 24-bit External SB0490

Bus 001 Device 009: ID 0b95:1780 ASIX Electronics Corp. AX88178
root@pisces:~# ifconfig

eth0 Link encap:Ethernet HWaddr b8:27:eb:2c:07:c9

inet addr:192.168.10.31 Bcast:192.168.10.255 Mask:255.255.255.0
inet6 addr: fe80::ba27:ebff:fe2c:7c9/64 Scope:Link
UP BROADCAST RUNNING MULTICAST MTU:1500 Metric:1
RX packets:410 errors:0 dropped:0 overruns:0 frame:0
TX packets:377 errors:0 dropped:0 overruns:0 carrier:0
collisions:0 txqueuelen:1000
RX bytes:28905 (28.2 KiB) TX bytes:35938 (35.0 KiB)

eth1 Link encap:Ethernet HWaddr 00:10:14:00:9f:fa

inet addr:192.168.2.199 Bcast:192.168.2.255 Mask:255.255.255.0
inet6 addr: fe80::210:14ff:fe00:9ffa/64 Scope:Link
UP BROADCAST RUNNING MULTICAST MTU:1500 Metric:1
RX packets:5 errors:0 dropped:0 overruns:0 frame:0
TX packets:7 errors:0 dropped:0 overruns:0 carrier:0
collisions:0 txqueuelen:1000
RX bytes:230 (230.0 B) TX bytes:592 (592.0 B)

lo Link encap:Local Loopback

inet addr:127.0.0.1 Mask:255.0.0.0
inet6 addr: ::1/128 Scope:Host
UP LOOPBACK RUNNING MTU:16436 Metric:1
RX packets:0 errors:0 dropped:0 overruns:0 frame:0
TX packets:0 errors:0 dropped:0 overruns:0 carrier:0
collisions:0 txqueuelen:0
RX bytes:0 (0.0 B) TX bytes:0 (0.0 B)

root@pisces:~# cat /proc/asound/cards
0 [ALSA ]: BRCM bcm2835 ALSbcm2835 ALSA - bcm2835 ALSA
bcm2835 ALSA

1 [External ]: USB-Audio - SB Live! 24-bit External
Creative Technology SB Live! 24-bit External at usb-bcm2708_usb-1.2.2, full spe

It's running at 855MHz with this config.txt file.
root@pisces:~# cat /boot/config.txt

over_voltage=6

arm_freq=855

core_freq=500

sdram_freq=500

root@pisces:~# cat /etc/network/interfaces

Used by ifup(8) and ifdown(8). See the interfaces(5) manpage or
/usr/share/doc/ifupdown/examples for more information.

auto lo

iface lo inet loopback

File: ifcfg-eth0

auto eth0

iface eth0 inet static

address 192.168.10.31

netmask 255.255.255.0

gateway 192.168.10.103

auto eth1

iface eth1 inet static

address 192.168.2.199

netmask 255.255.255.0

root@pisces:~# cat /etc/modules

/etc/modules: kernel modules to load at boot time.
This file contains the names of kernel modules that should be loaded
at boot time, one per line. Lines beginning with "#" are ignored.
Parameters can be specified after the module name.

loop

snd-bcm2835

One problem remains, no sound from the on-board chip.

===Software===
***** START AT THE BEGINNING WHEN BUILDING THE SOFTWARE -- i.e Section 1 and install all the packages recommended and do the pulseaudio setup.

If you build ghpsdr3-alex already it's a case of following the same procedure with the following caveats that apply to the RasPi ARM architecture. What follows is a blow by blow account of how I did it for the iw0hdv branch which supports my HiQSDR+Preselector. The same steps are needed for building any other branch.

Subject: [n2adr-sdr] Raspberry Pi running ghpsdr3-alex

The changes made by Andrea have been merged into the master branch. These changes allow samplerates >192K but the Pi doesn't have the power to run these high samplerates - I am running hiqsdr-server at 960K samplerate on a 8-core x84_64 box.

autoreconf -i

./configure CFLAGS='-O3 -pipe -march=armv6 -mfpu=vfp -mfloat-abi=hard' CXXFLAGS='-O3 -pipe -march=armv6 -mfpu=vfp -mfloat-abi=hard'

**** Additional steps needed when building rtlsdr-server. Do these before running make ******
# export ac_cv_func_malloc_0_nonnull=yes
# export ac_cv_func_realloc_0_nonnull=yes

make all && make all install

Sound on the Raspberry Pi is still a problem I have not been able to solve.

Terry (WB4JFI) suggested the following that work for him but I have had no luck with it.

"amixer cset numid=3 1"

Other valid numid's are 0=auto, 1=headphones and 2=hdmi.

QtRadio running on another box using the connection from the server list. Sound is a touch distorted, quite distorted on start up of QtRadio and spectrum is always a little bit slow.

When a slave connected and tried changing frequency, dspserver crashed - dspserver can be a bit crash happy.

The first thing I tried on the Pi was QtRadio standalone, spectrum and waterfall were OK but no sound.

Just now a client using glSDR (5) is attempting to change frequency, sound went quite distorted then dspserver crashed.

Restarted dspserver and QtRadio sound started very distorted before it settled down to reasonable.

QtRadio Installation

2014-07-26T18:39:34Z

G3vbv: /* Installing codec2 low bit rate audio encoding and decoding */

== Installation on Linux ==
The instructions below are for Debian based distributions like Ubuntu but you should be able to compile on any Linux distribution with the correct libraries installed.

=== Installation from Git ===
Installing from git involves building or compiling from source. This is required if you want to use one of the various branches to work the "bleeding edge" branches like Alex's rxtx-event branch where the current (Nov 12 2011) TX work is being done.
The PPA install is never more than a few days behind master so there is not much to gain from building from git unless you want to work with the source code your self.

==== Installing compiler and autotool ====

First off, install the compiler; depending on which distribution are you using, some or all of this stuff could be already installed:

===== Ubuntu/Debian =====
<pre>
sudo apt-get install make gcc g++
sudo apt-get install autoconf automake autotools-dev libtool git subversion
</pre>

===== Fedora =====
<pre>
sudo yum install gcc gcc-c++ man-pages autoconf automake subversion libtool git
</pre>

==== Installing prerequisite packages ====

===== Ubuntu 12.04 and newer =====
First of all, you have to check that the universe repository is enabled. Click on the gear shaped icon (bottom into left side bar): the System Settings menu will shown, click on Software Sources and finally check the Community-maintained Open Source Software (universe) tick. Next, submit the following commands into a terminal window:

<pre>
sudo apt-get update
sudo apt-get install \
libqt4-opengl-dev \
qtmobility-dev \
libusb-0.1-4 \
libusb-dev \
libfftw3-dev \
portaudio19-dev \
libpulse-dev \
libsamplerate0-dev \
libusb-1.0-0-dev \
libconfig8-dev \
xdg-utils \
libortp-dev \
gcc-multilib \
libssl-dev \
libevent-dev \
libglu1-mesa-dev \
freeglut3-dev \
cmake \
libspeexdsp-dev \
libxcb-composite0-dev

</pre>

You will need qt5 installed to complete the build.

Visit: http://qt-project.org/downloads

download the current package for your system.

To build Qt5 on a RaspberryPi visit: http://qt-project.org/wiki/RaspberryPi

After downloading it go to the download directory and do:
<pre>
$ chmod +x the-name-of-the-downloaded-file
$ sudo ./the-name-of-the-downloaded-file
</pre>

Simply click on the installer and follow the prompts, take note of were qt5 is installed. Don't open the readme or start QtCreator when the installer asks. It will make some files in your home directory owned by root, and that will give you trouble later. After the install has completed, from a terminal:
<pre>
$ export PATH=/opt/Qt5.1.0/5.1.0/gcc_64/bin:/opt/Qt5.1.0/Tools/QtCreator/bin:$PATH
</pre>
In the above make sure you put in the correct path for your version of Qt. This is due because the several packages from Qt sources and binary repositories web sites are not really installed in the system but simply copied on it. Therefore the autotools build system should search virtually over the whole filesystem.
In any case please remember that
the export above is effective only into the current terminal windows, if you open another window and/or reboot the system, you have to resubmit again the command
if you want to make permanent it, you have to add the export into the right configuration shell, suitable for the shell that you are currently using.
For the bash it is typically ~/.bashrc
In any case, after you issue the export, please test it.
<pre>
qmake -v
QMake version 2.01a
Using Qt version 4.8.0 in /home/andrew/QtSDK4.8x/Desktop/Qt/4.8.0/gcc/lib
</pre>

===== Ubuntu 11.04 and older =====
First of all, you have to check that the ''universe repository'' is enabled.
Please see the procedure in the previous section [[#graphical installation]] .

Next, you will need the following packages installed:

<pre>
sudo apt-get update
sudo apt-get install \
libqt4-opengl-dev \
qtmobility-dev \
libusb-0.1-4 \
libusb-dev \
libfftw3-dev \
portaudio19-dev \
libpulse-dev \
libsamplerate0-dev \
libusb-1.0-0-dev \
libconfig8-dev \
libortp-dev \
cmake
</pre>

===== Ubuntu 11.10 =====
First of all, you have to check that the ''universe repository'' is enabled.
Click on the gear shaped icon (bottom into left side bar): the ''System Settings'' menu will shown, click on ''Software Sources'' and finally check the ''Community-maintaned Open Source Software (universe)'' tick.
Next, submit the following commands into a terminal window:

<pre>
sudo apt-get update
sudo apt-get install \
libqt4-opengl-dev \
qtmobility-dev \
libusb-0.1-4 \
libusb-dev \
libfftw3-dev \
portaudio19-dev \
libpulse-dev \
libsamplerate0-dev \
libusb-1.0-0-dev \
libconfig8-dev \
xdg-utils \
libortp-dev \
cmake
</pre>

===== Fedora 16 =====

<pre>
sudo yum install fftw fftw-devel
sudo yum install libusb-devel libusb1-devel
sudo yum install portaudio-devel
sudo yum install libconfig-devel
sudo yum install libsamplerate-devel
sudo yum install pulseaudio-libs-devel
sudo yum install jack-audio-connection-kit jack-audio-connection-kit-devel
sudo yum install qt4-devel
sudo yum install cmake
</pre>

==== Cloning the repository ====

How to build the latest master branch on Ubuntu 11.04

First a new libevent will need to be downloaded and installed, then the actual QtRadio source can be downloaded and built.

==== Obtaining an up-level libevent library ====

$ sudo apt-get install libevent-dev

If the version is older than 2.0.5, go to synaptic and completely remove the stock libevent from Ubuntu. (Completely remove is an uninstall option in Synaptic. Additional dependent libraries may also be removed)

Then download the new version from:

http://libevent.org/

libevent-2.0.16-stable.tar.gz

<pre>
wget https://github.com/downloads/libevent/libevent/libevent-2.0.16-stable.tar.gz
</pre>

Move the tarball from the Downloads directory to a working directory. A suggestion is to create a src directory within your home directory and move it there. Uncompress and follow the instructions to build and install:

<pre>
cd
tar -zxvf libevent-2.0.16-stable.tar.gz
cd libevent-2.0.16-stable
./configure
make
sudo make install
sudo ldconfig
</pre>

On Fedora, in order to use the library above, export the LD_LIBRARY_PATH:

<pre>
export LD_LIBRARY_PATH=/usr/local/lib
</pre>

==== Installing codec2 low bit rate audio encoding and decoding ====

We are adding a low bit rate audio codec called codec 2 to QtRadio/dspserver. You need
to download and build the codec2 library. See:

http://www.rowetel.com/blog/?page_id=452

Now go get codec2 using subversion

<pre>
svn co https://svn.code.sf.net/p/freetel/code/codec2 codec2
cd codec2

mkdir build
cd build
cmake ../

sudo make
sudo make install
sudo ldconfig
</pre>

On some variations codec2 files will not be detected as installed correctly; if build errors citing codec2 are encountered during the later ./configure steps:

<pre>
cd /usr/local/include/codec2

sudo cp * ..
</pre>

'''IMPORTANT NOTE: If build errors persist referencing any codec2 missing components, please consider http://napan.ca/ghpsdr3/index.php/QtRadio_Installation#Refresh_to_a_Newer_Version procedure before continuing.'''

On Fedora, in order to use the library above, export the LD_LIBRARY_PATH:

<pre>
export LD_LIBRARY_PATH=/usr/local/lib
</pre>

==== Building the master branch ====

This branch is the latest code that contains both RX and TX capability.

Create a new directory or cd to the ~/src directory created for libevent and cd into it.

<pre>
git clone git://github.com/alexlee188/ghpsdr3-alex
</pre>

Depending on your Internet connection thorughput, it will take several minute to download.
cd into the new directory ghpsdr3-alex:
<pre>
cd ghpsdr3-alex
git checkout master
</pre>
You are now working with Alex's latest and greatest!

First set the path to the version of qt you are using. E.g. for qt5:
<pre>
$ export PATH=/opt/qt5/bin:$PATH
</pre>

Then:
<pre>
autoreconf -i
./configure
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]]

==VirtualBox Easy Installation==

It is possible to run the server software (and QtRadio) under VirtualBox. It has been tested with HPSDR Hermes hardware. [http://people.wallawalla.edu/~Rob.Frohne/ghpsdr3-alex/Ubuntu%2012.10%20ghpsdr3-alex-hermes.zip A VirtualBox Ubuntu 12.10 image] is available that automatically starts the server software for those who are running Windows, or don't feel they have the hardware, expertise or time to setup a Linux machine to act as a server. The username is: "ubuntu" and the password: "hamradio", which is probably a good thing to change soon after installation. Basically, all you need to do is follow the instructions below, plug your HPSDR Hermes or Apache Labs ANAN series transceivers into the network with the server, and you can be using ghpsdr3-alex on your own server. Users of older HPSDR hardware may need to make slight variations such as configuring USB in VirtualBox, specifying different command line arguments to the automatically started server commands, etc, but you won't have to build the software, or install Linux, or get another computer just to run the ghpsdr3-alex server software.

To get started, download the [http://people.wallawalla.edu/~Rob.Frohne/ghpsdr3-alex/Ubuntu%2012.10%20ghpsdr3-alex-hermes.zip VirtualBox image] (about 2.7 GB), unzip it, start [https://www.virtualbox.org/ VirtualBox], select the blue new button for the new machine, follow the wizard's instructions. When it asks you about the hard drive, say use existing virtual hard drive file, and select the image you just unzipped using the folder icon with the green up-arrow as the hard drive, and hit the create button. Then use the green start arrow to start the Ubuntu 12.10 virtual machine.

You should now be able to start QtRadio (the brown unity launcher item with CQ in it) and connect to your server. If that works, you should be able to connect from any client with network access to your server including QtRadio outside your virtual machine, or from another computer on your LAN or glSDR on your phone using WIFI. Be sure to set the server IP address in the client (QtRadio, or glSDR) to the IP address of the Ubuntu virtual machine. You can get the IP address from the up/down arrow menu on the upper left of your virtual machine menu bar, under the selection "Connection Information."

The [[Dspserver.conf]] file should be edited to personalize your server, and to allow transmit.

If your sever doesn't work, it may because your network interface is not eth2. If it isn't, you need to read the notes on the [[Hermes]] page, and then edit the commands used to automatically start your server as described in the paragraph immediately below. Another problem may occur because the SSL keys need to be generated. You can learn how to do that [[SSL Key Generation|here]].

If you want to edit or add the automatically started programs, see [http://askubuntu.com/questions/48321/how-do-i-start-applications-automatically-on-login this web page]. If you want to change things, the helpful notes about running the [[Hermes]] server on the [[Hermes]] page might be good to review. They explain the commands started automatically upon login.

I must make one note about running the software from a pre-prepared VirtualBox Image. It is a way an attacker could gain access to your computer and network. I used a pre-prepared Ubuntu 12.10 image from [http://virtualboxes.org/images/ubuntu/ VirtualBoxImages]. I believe it to be virgin, but you have to realize that it is possible that some rogue software is running on this image. If you use the image I provide, you must be solely responsible for whatever happens. I (Rob Frohne, KL7NA) did not put anything on the image, except the ghpsdr3-alex and the tools and packages, and configuration files needed to build it, and I believe it to be harmless. As always, there is a trade off between ease of use, and security.

== Network settings ==
If you are behind a firewall/NAT-router and want to be able to connect to your dspserver over the Internet you have to open up port tcp/8000. If you are using the client in RTP mode you have to open up udp/5004 and udp/5005.

== Installing ghpsdr3-alex on Raspberry Pi ==

===Hardware===

*** THIS SECTION DEALS WITH Raspberry Pi DIFFERENCES *** IT DOES NOT CIRCUMVENT THE INSTRUCTIONS STARTING AT STEP 1 OF THE QtRadio Installation. ***

I recommend installing either the raspbian or raspbian pisces (debian) distributions as there is no Ubuntu release to date.

*** All the pre-requisite packages needed for Ubuntu must be installed on raspbian or respbian pisces using the same "apt-get install" commands so it's necessary to follow the QtRadio-Installation
document from the beginning after installing raspbian or raspbian pisces.

The RasPi USB subsystem is sensitive to power supply voltage levels - A supply of 5.5V at 2A is recommended.
With the power supply output at +5.17V I was getting on-board Ethernet errors and system hangs when one more device besides keyboard and mouse were plugged in to the on-board USB ports or an outboard powered USB HUB.

Measuring the voltage across TP1 and TP2 on the Raspberry Pi and increased it to +4.97V (P.S output +5.59V).

I also ran "rpi-update" which install new firmware.

I shorted out the polyfuses F1 and F2 on the Pi and USB is much more stable but still limited.

With keyboard, mouse, gigabit USB Ethernet, SB Live! 24 USB and RTL-SDR dongle it runs for some hours before it freezes.

Removing the RTL-SDR dongle from the powered hub made a great difference with a current uptime heading for 3 days. The latest ghpsdr3-alex master branch build successfully completed while I was in bed.

root@pisces:/usr/src/GHPSDR3_HIGH_SPEED_MASTER/ghpsdr3-alex# date

Sun Sep 9 13:00:49 BST 2012

root@pisces:/usr/src/GHPSDR3_HIGH_SPEED_MASTER/ghpsdr3-alex# uptime

13:00:56 up 2 days, 20:46, 8 users, load average: 0.81, 1.01, 0.67

****** Do not use power from a USB PC port or from a USB Hub. ********

Once it's up and running, some details that may help in setting up the hardware for use - I'm currently overclocking at 855MHz (Previously was set to 1GHz):-

Keyboard, mouse, usb sound card, RTL-SDR TV dongle and USB Gigabit Ethernet fully operational using the 7-port powered USB hub.

root@pisces:~# lsusb

Bus 001 Device 001: ID 1d6b:0002 Linux Foundation 2.0 root hub

Bus 001 Device 002: ID 0424:9512 Standard Microsystems Corp.

Bus 001 Device 003: ID 0424:ec00 Standard Microsystems Corp.

Bus 001 Device 004: ID 04cc:1521 ST-Ericsson USB 2.0 Hub

Bus 001 Device 011: ID 04f3:0103 Elan Microelectronics Corp.

Bus 001 Device 006: ID 047d:1022 Kensington Orbit Optical

Bus 001 Device 007: ID 1d19:1101 Dexatek Technology Ltd. DK DVB-T Dongle

Bus 001 Device 008: ID 041e:3040 Creative Technology, Ltd SoundBlaster Live! 24-bit External SB0490

Bus 001 Device 009: ID 0b95:1780 ASIX Electronics Corp. AX88178
root@pisces:~# ifconfig

eth0 Link encap:Ethernet HWaddr b8:27:eb:2c:07:c9

inet addr:192.168.10.31 Bcast:192.168.10.255 Mask:255.255.255.0
inet6 addr: fe80::ba27:ebff:fe2c:7c9/64 Scope:Link
UP BROADCAST RUNNING MULTICAST MTU:1500 Metric:1
RX packets:410 errors:0 dropped:0 overruns:0 frame:0
TX packets:377 errors:0 dropped:0 overruns:0 carrier:0
collisions:0 txqueuelen:1000
RX bytes:28905 (28.2 KiB) TX bytes:35938 (35.0 KiB)

eth1 Link encap:Ethernet HWaddr 00:10:14:00:9f:fa

inet addr:192.168.2.199 Bcast:192.168.2.255 Mask:255.255.255.0
inet6 addr: fe80::210:14ff:fe00:9ffa/64 Scope:Link
UP BROADCAST RUNNING MULTICAST MTU:1500 Metric:1
RX packets:5 errors:0 dropped:0 overruns:0 frame:0
TX packets:7 errors:0 dropped:0 overruns:0 carrier:0
collisions:0 txqueuelen:1000
RX bytes:230 (230.0 B) TX bytes:592 (592.0 B)

lo Link encap:Local Loopback

inet addr:127.0.0.1 Mask:255.0.0.0
inet6 addr: ::1/128 Scope:Host
UP LOOPBACK RUNNING MTU:16436 Metric:1
RX packets:0 errors:0 dropped:0 overruns:0 frame:0
TX packets:0 errors:0 dropped:0 overruns:0 carrier:0
collisions:0 txqueuelen:0
RX bytes:0 (0.0 B) TX bytes:0 (0.0 B)

root@pisces:~# cat /proc/asound/cards
0 [ALSA ]: BRCM bcm2835 ALSbcm2835 ALSA - bcm2835 ALSA
bcm2835 ALSA

1 [External ]: USB-Audio - SB Live! 24-bit External
Creative Technology SB Live! 24-bit External at usb-bcm2708_usb-1.2.2, full spe

It's running at 855MHz with this config.txt file.
root@pisces:~# cat /boot/config.txt

over_voltage=6

arm_freq=855

core_freq=500

sdram_freq=500

root@pisces:~# cat /etc/network/interfaces

Used by ifup(8) and ifdown(8). See the interfaces(5) manpage or
/usr/share/doc/ifupdown/examples for more information.

auto lo

iface lo inet loopback

File: ifcfg-eth0

auto eth0

iface eth0 inet static

address 192.168.10.31

netmask 255.255.255.0

gateway 192.168.10.103

auto eth1

iface eth1 inet static

address 192.168.2.199

netmask 255.255.255.0

root@pisces:~# cat /etc/modules

/etc/modules: kernel modules to load at boot time.
This file contains the names of kernel modules that should be loaded
at boot time, one per line. Lines beginning with "#" are ignored.
Parameters can be specified after the module name.

loop

snd-bcm2835

One problem remains, no sound from the on-board chip.

===Software===
***** START AT THE BEGINNING WHEN BUILDING THE SOFTWARE -- i.e Section 1 and install all the packages recommended and do the pulseaudio setup.

If you build ghpsdr3-alex already it's a case of following the same procedure with the following caveats that apply to the RasPi ARM architecture. What follows is a blow by blow account of how I did it for the iw0hdv branch which supports my HiQSDR+Preselector. The same steps are needed for building any other branch.

Subject: [n2adr-sdr] Raspberry Pi running ghpsdr3-alex

The changes made by Andrea have been merged into the master branch. These changes allow samplerates >192K but the Pi doesn't have the power to run these high samplerates - I am running hiqsdr-server at 960K samplerate on a 8-core x84_64 box.

autoreconf -i

./configure CFLAGS='-O3 -pipe -march=armv6 -mfpu=vfp -mfloat-abi=hard' CXXFLAGS='-O3 -pipe -march=armv6 -mfpu=vfp -mfloat-abi=hard'

**** Additional steps needed when building rtlsdr-server. Do these before running make ******
# export ac_cv_func_malloc_0_nonnull=yes
# export ac_cv_func_realloc_0_nonnull=yes

make all && make all install

Sound on the Raspberry Pi is still a problem I have not been able to solve.

Terry (WB4JFI) suggested the following that work for him but I have had no luck with it.

"amixer cset numid=3 1"

Other valid numid's are 0=auto, 1=headphones and 2=hdmi.

QtRadio running on another box using the connection from the server list. Sound is a touch distorted, quite distorted on start up of QtRadio and spectrum is always a little bit slow.

When a slave connected and tried changing frequency, dspserver crashed - dspserver can be a bit crash happy.

The first thing I tried on the Pi was QtRadio standalone, spectrum and waterfall were OK but no sound.

Just now a client using glSDR (5) is attempting to change frequency, sound went quite distorted then dspserver crashed.

Restarted dspserver and QtRadio sound started very distorted before it settled down to reasonable.

Developers Documentation

2014-04-10T01:40:19Z

G3vbv: /* Installing Qt5 */

*[https://github.com/alexlee188/ghpsdr3-alex Git Repository ]
*[https://github.com/alexlee188/ghpsdr3-alex/blob/master/README README]
*[http://code.google.com/p/sdr-shell/wiki/SDRCore Dttsp]
*[http://www.youtube.com/watch?v=6KtOzh0StTc A Very good video tutorial series on using QT and C++]
*[http://openhpsdr.org/wiki/index.php?title=Ghpsdr3 A Brief Description on the architecture of ghpsdr3]
*[http://openhpsdr.org/wiki/images/4/47/Ghpsdr3-protocols2010-08-07.pdf Ghpsdr3 communication protocols 2010-08-07]
*[http://openhpsdr.org/wiki/index.php?title=Ghpsdr3_protocols More on the Ghpsdr communications protocols (and more up to date)]
*[[dspserver.conf]] The '''''dspserver.conf''''' file has it's own page

Most of the development discussion has been taking place on the [http://groups.google.com/group/sdr-widget sdr-widget google group].

= Installing portaudio19-dev with jackd2 =

Portaudio19-dev depends on having a copy of libjack-dev installed and if the libkjack-jackd2-dev package is installed before portaudio19-dev it's dependency will be satisfied and it will not uninstall jackd2 and install jackd1 if you have already installed jackd2 on your system.

== If jackd1 and portaudio19-dev already installed ==

<pre>From Synaptic

Uninstall portaudio19-dev
Uninstall jackd1
Install Jackd2
Install libjack-jackd2-dev
Install portaudio19-dev
</pre>

== If you are starting from scratch ==

<pre>From Synaptic

Install Jackd2
Install libjack-jackd2-dev
Install portaudio19-dev
</pre>

The following commands install all the environment needed (Debian/Ubuntu):

<pre>
sudo apt-get install jackd2 libjack-jackd2-dev portaudio19-dev

sudo apt-get install make gcc g++ autoconf automake autotools-dev libtool git subversion
sudo apt-get install libusb-0.1-4 libusb-dev libfftw3-dev libpulse-dev libsamplerate0-dev
sudo apt-get install libusb-1.0-0-dev libconfig8-dev xdg-utils libortp-dev
sudo apt-get install libevent-dev

</pre>

'''If the machine doesn't have an OpenGL aware accelerated video card, please install also the following packages:'''

<pre>
sudo apt-get install mesa-utils
sudo apt-get install mesa-common-dev
sudo apt-get install libgl1-mesa-dev
sudo apt-get install x11proto-xext-dev
sudo apt-get install libxrender-dev
</pre>

Note: in at least one case (thanks to Pierluigi iw4blg), even if the machine was running with an NVidia card and proprietary NVidia device drivers, the test for Qt in configure did fail, as well did the example programs enclosed in qt5 package, complaining that both GL/gl.h and libGL were missing. Installing all the above packages the problem was solved.

==== Installing codec2 low bit rate audio encoding and decoding ====

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
cd codec2-dev
mkdir build
cd build
cmake ..

If cmake complains it will ask you to remove ../CMakelists.txt and may be the ../CMakeFiles directory.
After removal of those.
cmake ..
make
sudo make install
sudo ldconfig
</pre>

= Installing Qt5 =

http://qt-project.org/downloads

U should download the Qt5.0.0 libraries file. 64 bit for x86_64 and 32 bit for x86 PC etc.

** Download the latest file from the above URL - it will not be 5.0.0 but the instructions that follow are to be amended according to the version downloaded.
** For ARM follow Andrea's instructions in the ODROID section of this wiki as there are no binaries available for ARM platforms.

After downloading you go to the download directory and do:

$ chmod +x the-name-of-the-downloaded-file

$ sudo ./the-name-of-the-downloaded-file

After that you should have something installed in /opt/Qt5.0.0

== Setting the path to qt5 ==

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>

== Compiling QtRadio ==
<pre>
cd
git clone https://github.com/alexlee188/ghpsdr3-alex.git
cd ghpsdr3-alex
git checkout master

sh ./cleanup.sh
autoreconf -i

sh ./alex-conf.sh

</pre>

Last, build everything:

<pre>
make
sudo make install
</pre>

== Setting QtCreator to use the qt5 libraries ==

If you want to use Qt Creator (you use the same Qt Creator as with Qt4), you need to configure it to use Qt5 as one of the options:
<pre>
From the top line menu of QtCreator ...

Tools > Options > Build & Run
Click on the Qt Versions panel
Click on Add button
Navigate to /opt/Qt5.0.0/5.0.0/gcc_64/bin
Click on qmake
Click on open
Click on Apply then OK
</pre>
You need to point to the qmake file which is found in /opt/Qt5.0.0/5.0.0/gcc_64/bin

== Choosing the build library in QtCreator ==

you need to (re)import your QtRadio project and then you will be able to select Qt5 (or the previous Qt4.8 etc.) for building the application.

It may be necessary to edit the project file (QtRadio.pro) to choose which version of Qt Creator you are using which can be the SDK directly from Nokia, or the Ubuntu install of Creator. The line "_UsingSDK" needs to be set to true or false as appropriate.

== Qt5.0.0 bug ==

There is likely to be a bug in the Qt5.0.0 release that leads to QtRadio hangs when you click on the menu after running QtRadio for a while when a buffer underun has occured.

This happens only one some PC's, but not others.

If it does, you can revert to an older Qt5 BETA:

On my one of 3 PC's with the QtRadio lockup problem (when you click on any menu items after running QtRadio for a while, especially after a buffer underflow), I rebuild QtRadio using Qt5 from the Edgers ppa (which is a late BETA version), and the problem disappears completely :-)

https://launchpad.net/~canonical-qt5-edgers/+archive/qt5-daily

To get it to build in the Edgers, you just have to set the path to the Edgers directory. E.g. in mine, it is:

<pre>
$ export PATH=/opt/qt5/bin:$PATH
</pre>

Use these commands to create symbolic links in the qt5 library (which you have to do only once):

<pre>
$ cd /opt/qt5/lib
$ sudo ln -s libQtMultimedia.so.5.0.0 libQt5Multimedia.so
$ sudo ln -s libQtMultimedia.so.5.0.0 libQt5Multimedia.so.5
$ sudo ln -s libQtMultimedia.so.5.0.0 libQt5Multimedia.so.5.0
</pre>

then you should be able to do the usual build steps.

Developers Documentation

2014-04-09T14:32:02Z

G3vbv: /* Installing codec2 low bit rate audio encoding and decoding */

*[https://github.com/alexlee188/ghpsdr3-alex Git Repository ]
*[https://github.com/alexlee188/ghpsdr3-alex/blob/master/README README]
*[http://code.google.com/p/sdr-shell/wiki/SDRCore Dttsp]
*[http://www.youtube.com/watch?v=6KtOzh0StTc A Very good video tutorial series on using QT and C++]
*[http://openhpsdr.org/wiki/index.php?title=Ghpsdr3 A Brief Description on the architecture of ghpsdr3]
*[http://openhpsdr.org/wiki/images/4/47/Ghpsdr3-protocols2010-08-07.pdf Ghpsdr3 communication protocols 2010-08-07]
*[http://openhpsdr.org/wiki/index.php?title=Ghpsdr3_protocols More on the Ghpsdr communications protocols (and more up to date)]
*[[dspserver.conf]] The '''''dspserver.conf''''' file has it's own page

Most of the development discussion has been taking place on the [http://groups.google.com/group/sdr-widget sdr-widget google group].

= Installing portaudio19-dev with jackd2 =

Portaudio19-dev depends on having a copy of libjack-dev installed and if the libkjack-jackd2-dev package is installed before portaudio19-dev it's dependency will be satisfied and it will not uninstall jackd2 and install jackd1 if you have already installed jackd2 on your system.

== If jackd1 and portaudio19-dev already installed ==

<pre>From Synaptic

Uninstall portaudio19-dev
Uninstall jackd1
Install Jackd2
Install libjack-jackd2-dev
Install portaudio19-dev
</pre>

== If you are starting from scratch ==

<pre>From Synaptic

Install Jackd2
Install libjack-jackd2-dev
Install portaudio19-dev
</pre>

The following commands install all the environment needed (Debian/Ubuntu):

<pre>
sudo apt-get install jackd2 libjack-jackd2-dev portaudio19-dev

sudo apt-get install make gcc g++ autoconf automake autotools-dev libtool git subversion
sudo apt-get install libusb-0.1-4 libusb-dev libfftw3-dev libpulse-dev libsamplerate0-dev
sudo apt-get install libusb-1.0-0-dev libconfig8-dev xdg-utils libortp-dev
sudo apt-get install libevent-dev

</pre>

'''If the machine doesn't have an OpenGL aware accelerated video card, please install also the following packages:'''

<pre>
sudo apt-get install mesa-utils
sudo apt-get install mesa-common-dev
sudo apt-get install libgl1-mesa-dev
sudo apt-get install x11proto-xext-dev
sudo apt-get install libxrender-dev
</pre>

Note: in at least one case (thanks to Pierluigi iw4blg), even if the machine was running with an NVidia card and proprietary NVidia device drivers, the test for Qt in configure did fail, as well did the example programs enclosed in qt5 package, complaining that both GL/gl.h and libGL were missing. Installing all the above packages the problem was solved.

==== Installing codec2 low bit rate audio encoding and decoding ====

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
cd codec2-dev
mkdir build
cd build
cmake ..

If cmake complains it will ask you to remove ../CMakelists.txt and may be the ../CMakeFiles directory.
After removal of those.
cmake ..
make
sudo make install
sudo ldconfig
</pre>

= Installing Qt5 =

http://qt-project.org/downloads

U should download the Qt5.0.0 libraries file. 64 bit for x86_64 and 32 bit for x86 PC etc.

After downloading you go to the download directory and do:

$ chmod +x the-name-of-the-downloaded-file

$ sudo ./the-name-of-the-downloaded-file

After that you should have something installed in /opt/Qt5.0.0

== Setting the path to qt5 ==

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>

== Compiling QtRadio ==
<pre>
cd
git clone https://github.com/alexlee188/ghpsdr3-alex.git
cd ghpsdr3-alex
git checkout master

sh ./cleanup.sh
autoreconf -i

sh ./alex-conf.sh

</pre>

Last, build everything:

<pre>
make
sudo make install
</pre>

== Setting QtCreator to use the qt5 libraries ==

If you want to use Qt Creator (you use the same Qt Creator as with Qt4), you need to configure it to use Qt5 as one of the options:
<pre>
From the top line menu of QtCreator ...

Tools > Options > Build & Run
Click on the Qt Versions panel
Click on Add button
Navigate to /opt/Qt5.0.0/5.0.0/gcc_64/bin
Click on qmake
Click on open
Click on Apply then OK
</pre>
You need to point to the qmake file which is found in /opt/Qt5.0.0/5.0.0/gcc_64/bin

== Choosing the build library in QtCreator ==

you need to (re)import your QtRadio project and then you will be able to select Qt5 (or the previous Qt4.8 etc.) for building the application.

It may be necessary to edit the project file (QtRadio.pro) to choose which version of Qt Creator you are using which can be the SDK directly from Nokia, or the Ubuntu install of Creator. The line "_UsingSDK" needs to be set to true or false as appropriate.

== Qt5.0.0 bug ==

There is likely to be a bug in the Qt5.0.0 release that leads to QtRadio hangs when you click on the menu after running QtRadio for a while when a buffer underun has occured.

This happens only one some PC's, but not others.

If it does, you can revert to an older Qt5 BETA:

On my one of 3 PC's with the QtRadio lockup problem (when you click on any menu items after running QtRadio for a while, especially after a buffer underflow), I rebuild QtRadio using Qt5 from the Edgers ppa (which is a late BETA version), and the problem disappears completely :-)

https://launchpad.net/~canonical-qt5-edgers/+archive/qt5-daily

To get it to build in the Edgers, you just have to set the path to the Edgers directory. E.g. in mine, it is:

<pre>
$ export PATH=/opt/qt5/bin:$PATH
</pre>

Use these commands to create symbolic links in the qt5 library (which you have to do only once):

<pre>
$ cd /opt/qt5/lib
$ sudo ln -s libQtMultimedia.so.5.0.0 libQt5Multimedia.so
$ sudo ln -s libQtMultimedia.so.5.0.0 libQt5Multimedia.so.5
$ sudo ln -s libQtMultimedia.so.5.0.0 libQt5Multimedia.so.5.0
</pre>

then you should be able to do the usual build steps.

User:G3vbv

2013-02-20T03:00:33Z

G3vbv:

Age 71.
Retired Senior Staff Specialist on Amdahl/Fujitsu mainframes and Enterprise SPARC systems, IBM Mainframes and SUN SPARC systems, both hardware and software in support of UK, European and Worldwide customers.
Linux guy on PC's, SPARC and Mainframes.
Amateur Radio Callsign: G3VBV. Homebrewed most of my Amateur Radio gear in 46 years of operation and now hooked on SDR - Softrock SR v6.3/Mobo v3.6, SR63ng/Mobo v4.3.4/SDR-Widget, Softrock Ensemble RXTX, RTL-SDR, HiQSDR and Hermes.
Qualified Level 2 Cricket Coach.
Private Pilot Licensed over 20 years.

User talk:G3vbv

2012-12-01T23:00:43Z

G3vbv: /* Installing on ODROID-X */

'''Welcome to ''Ghpsdr3 SDR project''!'''
We hope you will contribute much and well.
You will probably want to read the [[Help:Contents|help pages]].
Again, welcome and have fun! [[User:Ve9gj|Ve9gj]] 20:41, 26 November 2011 (AST)

== Installing on ODROID-X ==

The wiki lists a number of Ubuntu pre-req packages to be installed which are probably needed for other SDR software building apart from ghpsdr3-alex.

If you are building ghpsdr3-alex, the following configure options apply.
"./configure CFLAGS='-O3 -pipe -mfpu=neon -fno-tree-vectorize -fopenmp' CXXFLAGS='-O3 -pipe -mfpu=neon -fno-tree-vectorize -fopenmp'"

* Use full-size SD cards - microSD cards in an adaptor won't work, a question to the forum at http://odroid.foros-phpbb.com/c3-odroid-x confirmed the adaptor distorts the signals.

* Use a small fan above the CPU module. It gets hot and will power down on large builds especially with "make -j 4".

* Download an image from http://www.mdrjr.net/odroid/mirror/ubuntu12.10-3.6.6/ or whatever is the latest available on the mirror.

There is a HDMI image and a LCD image if you have the hardkernel LCD display.

* After burning the image you can mount partition 3 and set up /etc/hosts, /etc/resolv.conf, /etc/network/interfaces as necessary - fixed addresses or dhcp.

I am using fixed addresses, 192.168.10.x for my main LAN and 192.168.2.x is a Gigabit Ethernet LAN for my HiQSDR.

Where a 1 appears below it's meant to be a hash - commenting out the line.

# cat /etc/network/interfaces

auto lo
iface lo inet loopback

# The primary network interface

auto eth0

iface eth0 inet static

address 192.168.10.18

netmask 255.255.255.0

network 192.168.10.0

broadcast 192.168.10.255

dns-nameservers 192.168.10.103

gateway 192.168.10.103

# Example to keep MAC address between reboots

#hwaddress ether DE:AD:BE:EF:CA:FE

auto eth1

iface eth1 inet static

address 192.168.2.197

netmask 255.255.255.0

network 192.168.2.0

broadcast 192.168.2.255

# auto wlan0

# iface wlan0 inet dhcp

* The image burns 4GB on to a SD card. I started with a 16GB card and used gparted on a x86_64 PC to extend the rootfs partition 3. I now have a 32GB card in use.

I attached a 160GB USB HD and mounted it on the ODROID-X so I could generate the 16GB image and also do local kernel and other software builds - it's a pleasure to build kernels without cross compiling or do it natively while I wait for springtime to arrive.

"dd if=/dev/mmcblk0 of=<160GB_MOUNT_POINT>/ODROID-X_16GB.img bs=1M" and copied it to the PC with the scp command.

* Moving the card back to the PC where the card was detected as /dev/sdc

"dd if=/ODROID-X_16GB.img of=/dev/sdc bs=1M", use gparted to extend partition 3 to use the full 32GB.

Of course you could NFS mount the ODROID-X SD card to do some operations after the SD card setup and the ODROID-X is booted.

* An enclosure - I made up a U-shaped aluminium enclosure with open sides and holes for the Ethernet and USB sockets at the back, a piece of L-shaped perspex screwed on top to hold the fan.
The P.S is a 5V 2A wall wart I diverted from a USB hub.

User talk:G3vbv

2012-12-01T22:57:53Z

G3vbv: /* Installing on ODROID-X */ new section

'''Welcome to ''Ghpsdr3 SDR project''!'''
We hope you will contribute much and well.
You will probably want to read the [[Help:Contents|help pages]].
Again, welcome and have fun! [[User:Ve9gj|Ve9gj]] 20:41, 26 November 2011 (AST)

== Installing on ODROID-X ==

The wiki lists a number of Ubuntu pre-req packages to be installed which are probably needed for other SDR software building apart from ghpsdr3-alex.

If you are building ghpsdr3-alex, the following configure options apply.
"./configure CFLAGS='-O3 -pipe -mfpu=neon -fno-tree-vectorize -fopenmp' CXXFLAGS='-O3 -pipe -mfpu=neon -fno-tree-vectorize -fopenmp'"

* Use full-size SD cards - microSD cards in an adaptor won't work, a question to the forum at http://odroid.foros-phpbb.com/c3-odroid-x confirmed the adaptor distorts the signals.

* Use a small fan above the CPU module. It gets hot and will power down on large builds especially with "make -j 4".

* Download an image from http://www.mdrjr.net/odroid/mirror/ubuntu12.10-3.6.6/ or whatever is the latest available on the mirror.

There is a HDMI image and a LCD image if you have the hardkernel LCD display.

* After burning the image you can mount partition 3 and set up /etc/hosts, /etc/resolv.conf, /etc/network/interfaces as necessary - fixed addresses or dhcp.

I am using fixed addresses, 192.168.10.x for my main LAN and 192.168.2.x is a Gigabit Ethernet LAN for my HiQSDR.

# cat /etc/network/interfaces

auto lo
iface lo inet loopback

# The primary network interface

auto eth0

iface eth0 inet static

address 192.168.10.18

netmask 255.255.255.0

network 192.168.10.0

broadcast 192.168.10.255

dns-nameservers 192.168.10.103

gateway 192.168.10.103

# Example to keep MAC address between reboots

#hwaddress ether DE:AD:BE:EF:CA:FE

auto eth1

iface eth1 inet static

address 192.168.2.197

netmask 255.255.255.0

network 192.168.2.0

broadcast 192.168.2.255

# auto wlan0

# iface wlan0 inet dhcp

* The image burns 4GB on to a SD card. I started with a 16GB card and used gparted on a x86_64 PC to extend the rootfs partition 3. I now have a 32GB card in use.

I attached a 160GB USB HD and mounted it on the ODROID-X so I could generate the 16GB image and also do local kernel and other software builds - it's a pleasure to build kernels without cross compiling or do it natively while I wait for springtime to arrive.

"dd if=/dev/mmcblk0 of=<160GB_MOUNT_POINT>/ODROID-X_16GB.img bs=1M" and copied it to the PC with the scp command.

* Moving the card back to the PC where the card was detected as /dev/sdc

"dd if=/ODROID-X_16GB.img of=/dev/sdc bs=1M", use gparted to extend partition 3 to use the full 32GB.

Of course you could NFS mount the ODROID-X SD card to do some operations after the SD card setup and the ODROID-X is booted.

* An enclosure - I made up a U-shaped aluminium enclosure with open sides and holes for the Ethernet and USB sockets at the back, a piece of L-shaped perspex screwed on top to hold the fan.
The P.S is a 5V 2A wall wart I diverted from a USB hub.

QtRadio Installation

2012-11-28T05:30:39Z

G3vbv: /* SOFTWARE */

== 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 =====
See:

http://napan.ca/ghpsdr3/index.php/Developers_Documentation

You will need qt5 to be installed as per the above.

===== 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

2012-11-28T05:27:14Z

G3vbv: /* SOFTWARE */

== 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 =====
See:

http://napan.ca/ghpsdr3/index.php/Developers_Documentation

You will need qt5 to be installed as per the above.

===== 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.

THE FOLLOWING COMMANDS ARE NO LONGER NEEDED AS THE x86/x86_64 OPTIMIZATIONS HAVE BEEN REMOVED FROM Makefile.in and Makefile.am.

NOTE:-******Remove all traces of -msse,-msse3 and -ffast-math from Makefile.am and Makefile.in where appropriate in the subdirectories as those are not for ARM architecture. Here is my script - make it executable and put it in your path, e.g /usr/local/bin/.
Formatting problem, #!/bin/sh is the first line of the script which is run in the ghpsdr3-alex directory.

#!/bin/sh

find ./ -type f | xargs sed -i 's/-msse3//g'

find ./ -type f | xargs sed -i 's/-msse//g'

find ./ -type f | xargs sed -i 's/-ffast-math//g'

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.

Talk:QtRadio Installation

2012-10-13T22:11:00Z

G3vbv: /* Installing on ODROID-X and Pandaboard */

'''Installing ghpsdr3-alex on Raspberry Pi'''
---------------------------------------------
I recommend installing either the raspbian or raspbian pisces distributions as there is no Ubuntu release to date.

All the pre-req packages mentioned for the Ubuntu installation are also needed for the Raspberry Pi and are available using "apt-get install" as usual.

** The RasPi USB subsystem is sensitive to power supply voltage levels - A supply of 5.25V at 2A is recommended. With +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. Increasing the voltage to +5.27V solved the problem.

** 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 1GHz:-

Keyboard, mouse, usb sound card and Ethernet fully operational using the 7-port 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 050d:0307 Belkin Components USB 2.0 - 7 ports Hub [FSU307]

Bus 001 Device 005: ID 04f3:0103 Elan Microelectronics Corp.

Bus 001 Device 006: ID 041e:3040 Creative Technology, Ltd SoundBlaster Live! 24-bit External SB0490

Bus 001 Device 007: ID 0fe6:8101 Kontron (Industrial Computer Source / ICS Advent) DM9601 Fast Ethernet Adapter

Bus 001 Device 008: ID 047d:1022 Kensington Orbit Optical

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 [External ]: USB-Audio - SB Live! 24-bit External
Creative Technology SB Live! 24-bit External at usb-bcm2708_usb-1.3.3, full spe
1 [ALSA ]: BRCM bcm2835 ALSbcm2835 ALSA - bcm2835 ALSA
bcm2835 ALSA
I had originally forgotten to add snd-bcm2835 to /etc/modules which is why the SB Live! 24 is card 0. Rebooting with just the on-board sound card then adding the SB Live! 24 USB changed the on-board to card 0 and the SB Live! 24 USB is now card 1.
I have further tests to do, mainly with sound, but now the Rpi is looking much healthier.

It's running at 1GHz with this config.txt file.
root@pisces:~# cat /boot/config.txt

over_voltage=6

arm_freq=1000

core_freq=500

sdram_freq=50

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

== Headline text == * SOFTWARE *
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.

Subject: [n2adr-sdr] Raspberry Pi running ghpsdr3-alex

I did a fresh clone and changed to the iw0hdv branch from the default master branch.
# git checkout iw0hdv

Removed all traces of -msse, -msse3 and -ffast-math from Makefile.am and Makefile.in where appropriate in the subdirectories.

# autoreconf -i

# ./configure CFLAGS='-O3 -pipe -march=armv6 -mfpu=vfp -mfloat-abi=hard' CXXFLAGS='-O3 -pipe -march=armv6 -mfpu=vfp -mfloat-abi=hard'

# make all && make all install

Running hiqsdr-server at 48K/96K and dspserver (built with qt4) as qt5 is not yet available.
There are instructions for building qt5 but following them bullet by bullet it failed not far along.
The instructions are for building on i386 - I have put out a request for .deb packages or at least built tarballs to the Raspberry Pi forum.

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.

== Installing on ODROID-X and Pandaboard ==

There are 2 Ubuntu images downloadable from hardkernel.com

odroidx_20120906-linaro-precise-ubuntu-desktop_with_HDMI.img.gz

odroidx_20120906-linaro-precise-ubuntu-desktop_with_LCD.img.gz

The image needs to be decompressed e.g:-
"gzip -d odroidx_20120906-linaro-precise-ubuntu-desktop_with_HDMI.img.gz" then burned on to a SD card (full size or microSD with a full size adaptor).

"dmesg" will tell you what it's called when you attach the reader with the SD card inserted to a USB port,e.g /dev/sdb, /dev/sdc, etc.

"dd if=odroidx_20120906-linaro-precise-ubuntu-desktop_with_HDMI.img of=/dev/sdc bs=1M"

When it completes, insert the SD card into the ODROID-X and boot up - the ODROID-X has a power on and a reset switch on board.

There is a way to prepare the SD card using Windows but I don't do Windows, consult http://beagleboard.org/demo/angstrom/ for a link to "dd" for Windows.

I use the HDMI.img as I have a spare HDMI port on one of my monitors - it requires a micro HDMI cable, standard HDMI on the monitor end and micro HDMI on the ODROID-X board.

When you have the ODROID-X all up and running and installed the pre-req packages for ghpsdr3-alex - there are a lot of them as is the case with any Ubuntu or other distribution, the build instructions are as follows:-

$ git clone git://github.com/alexlee188/ghpsdr3-alex.git

$ cd ghpsdr3-alex

Then I run a script to remove -msse and friends, the script I call "rm_words" made executable and put in /usr/local/bin

find ./ -type f | xargs sed -i 's/-msse3//g'

find ./ -type f | xargs sed -i 's/-msse//g'

find ./ -type f | xargs sed -i 's/-ffast-math//g'

autoreconf -i

source set_Qt-5.0.0_path.src

set_Qt-5.0.0_path.src contains "export PATH=/opt/qt5/bin:$PATH" and I'm using the qt5-daily from edgers.

http://ppa.launchpad.net/canonical-qt5-edgers/qt5-daily/ubuntu precise main

The configure script I call "alex-config" made executable and put in /usr/local/bin

./configure CFLAGS='-O3 -pipe -mfpu=neon -fno-tree-vectorize -fopenmp' CXXFLAGS='-O3 -pipe -mfpu=neon -fno-tree-vectorize -fopenmp'

$ make -j 4 all

$ sudo make -j 4 all install

The ODROID-X is treated the same as the Pandaboard and the Raspberry Pi when building ghpsdr3-alex, except the Pandaboard uses the normal Ubuntu ARM distribution while the ODROID-X uses the linaro Ubuntu ARM distribution built especially for it. The Raspberry Pi uses the debian raspbian distribution.

The distributions are all Ubuntu ARM and packages are updated, upgraded and installed in exactly the same manner as Ubuntu for x86/x86_64 so there is no learning curve involved if you already know Ubuntu.

I use 32GB Class 10 (the fastest) SD cards but recommend at least 16GB to give ample space to install and build other software.
SD cards can either be full size or microSD in a full size adaptor.

I have been running hiqsdr-server, dspserver and QtRadio on the ODROID-X for a few weeks 24/7.

"dsploop" by Alex has stopped the dspserver crashes that periodically occurred on all platforms.

Talk:QtRadio Installation

2012-10-13T22:10:09Z

G3vbv: /* Installing on ODROID-X and Pandaboard */

Talk:QtRadio Installation

2012-10-13T22:04:35Z

G3vbv: /* Installing on ODROID-X and Pandaboard */

Talk:QtRadio Installation

2012-10-13T21:56:45Z

G3vbv: /* Installing on ODROID-X and Pandaboard */

'''Installing ghpsdr3-alex on Raspberry Pi'''
---------------------------------------------
I recommend installing either the raspbian or raspbian pisces distributions as there is no Ubuntu release to date.

All the pre-req packages mentioned for the Ubuntu installation are also needed for the Raspberry Pi and are available using "apt-get install" as usual.

** The RasPi USB subsystem is sensitive to power supply voltage levels - A supply of 5.25V at 2A is recommended. With +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. Increasing the voltage to +5.27V solved the problem.

** 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 1GHz:-

Keyboard, mouse, usb sound card and Ethernet fully operational using the 7-port 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 050d:0307 Belkin Components USB 2.0 - 7 ports Hub [FSU307]

Bus 001 Device 005: ID 04f3:0103 Elan Microelectronics Corp.

Bus 001 Device 006: ID 041e:3040 Creative Technology, Ltd SoundBlaster Live! 24-bit External SB0490

Bus 001 Device 007: ID 0fe6:8101 Kontron (Industrial Computer Source / ICS Advent) DM9601 Fast Ethernet Adapter

Bus 001 Device 008: ID 047d:1022 Kensington Orbit Optical

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 [External ]: USB-Audio - SB Live! 24-bit External
Creative Technology SB Live! 24-bit External at usb-bcm2708_usb-1.3.3, full spe
1 [ALSA ]: BRCM bcm2835 ALSbcm2835 ALSA - bcm2835 ALSA
bcm2835 ALSA
I had originally forgotten to add snd-bcm2835 to /etc/modules which is why the SB Live! 24 is card 0. Rebooting with just the on-board sound card then adding the SB Live! 24 USB changed the on-board to card 0 and the SB Live! 24 USB is now card 1.
I have further tests to do, mainly with sound, but now the Rpi is looking much healthier.

It's running at 1GHz with this config.txt file.
root@pisces:~# cat /boot/config.txt

over_voltage=6

arm_freq=1000

core_freq=500

sdram_freq=50

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

== Headline text == * SOFTWARE *
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.

Subject: [n2adr-sdr] Raspberry Pi running ghpsdr3-alex

I did a fresh clone and changed to the iw0hdv branch from the default master branch.
# git checkout iw0hdv

Removed all traces of -msse, -msse3 and -ffast-math from Makefile.am and Makefile.in where appropriate in the subdirectories.

# autoreconf -i

# ./configure CFLAGS='-O3 -pipe -march=armv6 -mfpu=vfp -mfloat-abi=hard' CXXFLAGS='-O3 -pipe -march=armv6 -mfpu=vfp -mfloat-abi=hard'

# make all && make all install

Running hiqsdr-server at 48K/96K and dspserver (built with qt4) as qt5 is not yet available.
There are instructions for building qt5 but following them bullet by bullet it failed not far along.
The instructions are for building on i386 - I have put out a request for .deb packages or at least built tarballs to the Raspberry Pi forum.

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.

== Installing on ODROID-X and Pandaboard ==

There are 2 Ubuntu images downloadable from hardkernel.com

odroidx_20120906-linaro-precise-ubuntu-desktop_with_HDMI.img.gz

odroidx_20120906-linaro-precise-ubuntu-desktop_with_LCD.img.gz

The image needs to be decompressed e.g:-
"gzip -d odroidx_20120906-linaro-precise-ubuntu-desktop_with_HDMI.img.gz" then burned on to a SD card (full size or microSD with a full size adaptor).

"dmesg" will tell you what it's called when you attach the reader with the SD card inserted to a USB port,e.g /dev/sdb, /dev/sdc, etc.

"dd if=odroidx_20120906-linaro-precise-ubuntu-desktop_with_HDMI.img of=/dev/sdc bs=1M"

When it completes, insert the SD card into the ODROID-X and boot up - the ODROID-X has a power on and a reset switch on board.

There is a way to prepare the SD card using Windows but I don't do Windows, consult http://beagleboard.org/demo/angstrom/

I use the HDMI.img as I have a spare HDMI port on one of my monitors - it requires a micro HDMI cable, standard HDMI on the monitor end and micro HDMI on the ODROID-X board.

When you have the ODROID-X all up and running and installed the pre-req packages for ghpsdr3-alex - there are a lot of them as is the case with any Ubuntu or other distribution, the build instructions are as follows:-

$ git clone git://github.com/alexlee188/ghpsdr3-alex.git

$ cd ghpsdr3-alex

Then I run a script to remove -msse and friends, the script I call "rm_words" made executable and put in /usr/local/bin

find ./ -type f | xargs sed -i 's/-msse3//g'

find ./ -type f | xargs sed -i 's/-msse//g'

find ./ -type f | xargs sed -i 's/-ffast-math//g'

autoreconf -i

source set_Qt-5.0.0_path.src

set_Qt-5.0.0_path.src contains "export PATH=/opt/qt5/bin:$PATH" and I'm using the qt5-daily from edgers.

http://ppa.launchpad.net/canonical-qt5-edgers/qt5-daily/ubuntu precise main

The configure script I call "alex-config" made executable and put in /usr/local/bin

./configure CFLAGS='-O3 -pipe -mfpu=neon -fno-tree-vectorize -fopenmp' CXXFLAGS='-O3 -pipe -mfpu=neon -fno-tree-vectorize -fopenmp'

$ make -j 4 all

$ sudo make -j 4 all install

The ODROID-X is treated the same as the Pandaboard and the Raspberry Pi when building ghpsdr3-alex, except the Pandaboard uses the normal Ubuntu ARM distribution while the ODROID-X uses the linaro Ubuntu ARM distribution built especially for it. The Raspberry Pi uses the debian raspbian distribution.

The distributions are all Ubuntu ARM and packages are updated, upgraded and installed in exactly the same manner as Ubuntu for x86/x86_64 so there is no learning curve involved if you already know Ubuntu.

I use 32GB Class 10 (the fastest) SD cards but recommend at least 16GB to give ample space to install and build other software.
SD cards can either be full size or microSD in a full size adaptor.

Talk:QtRadio Installation

2012-10-13T21:51:11Z

G3vbv: /* Installing on ODROID-X and Pandaboard */ new section

'''Installing ghpsdr3-alex on Raspberry Pi'''
---------------------------------------------
I recommend installing either the raspbian or raspbian pisces distributions as there is no Ubuntu release to date.

All the pre-req packages mentioned for the Ubuntu installation are also needed for the Raspberry Pi and are available using "apt-get install" as usual.

** The RasPi USB subsystem is sensitive to power supply voltage levels - A supply of 5.25V at 2A is recommended. With +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. Increasing the voltage to +5.27V solved the problem.

** 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 1GHz:-

Keyboard, mouse, usb sound card and Ethernet fully operational using the 7-port 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 050d:0307 Belkin Components USB 2.0 - 7 ports Hub [FSU307]

Bus 001 Device 005: ID 04f3:0103 Elan Microelectronics Corp.

Bus 001 Device 006: ID 041e:3040 Creative Technology, Ltd SoundBlaster Live! 24-bit External SB0490

Bus 001 Device 007: ID 0fe6:8101 Kontron (Industrial Computer Source / ICS Advent) DM9601 Fast Ethernet Adapter

Bus 001 Device 008: ID 047d:1022 Kensington Orbit Optical

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 [External ]: USB-Audio - SB Live! 24-bit External
Creative Technology SB Live! 24-bit External at usb-bcm2708_usb-1.3.3, full spe
1 [ALSA ]: BRCM bcm2835 ALSbcm2835 ALSA - bcm2835 ALSA
bcm2835 ALSA
I had originally forgotten to add snd-bcm2835 to /etc/modules which is why the SB Live! 24 is card 0. Rebooting with just the on-board sound card then adding the SB Live! 24 USB changed the on-board to card 0 and the SB Live! 24 USB is now card 1.
I have further tests to do, mainly with sound, but now the Rpi is looking much healthier.

It's running at 1GHz with this config.txt file.
root@pisces:~# cat /boot/config.txt

over_voltage=6

arm_freq=1000

core_freq=500

sdram_freq=50

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

== Headline text == * SOFTWARE *
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.

Subject: [n2adr-sdr] Raspberry Pi running ghpsdr3-alex

I did a fresh clone and changed to the iw0hdv branch from the default master branch.
# git checkout iw0hdv

Removed all traces of -msse, -msse3 and -ffast-math from Makefile.am and Makefile.in where appropriate in the subdirectories.

# autoreconf -i

# ./configure CFLAGS='-O3 -pipe -march=armv6 -mfpu=vfp -mfloat-abi=hard' CXXFLAGS='-O3 -pipe -march=armv6 -mfpu=vfp -mfloat-abi=hard'

# make all && make all install

Running hiqsdr-server at 48K/96K and dspserver (built with qt4) as qt5 is not yet available.
There are instructions for building qt5 but following them bullet by bullet it failed not far along.
The instructions are for building on i386 - I have put out a request for .deb packages or at least built tarballs to the Raspberry Pi forum.

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.

== Installing on ODROID-X and Pandaboard ==

There are 2 Ubuntu images downloadable from hardkernel.com
odroidx_20120906-linaro-precise-ubuntu-desktop_with_HDMI.img.gz
odroidx_20120906-linaro-precise-ubuntu-desktop_with_LCD.img.gz

The image needs to be decompressed e.g:-
"gzip -d odroidx_20120906-linaro-precise-ubuntu-desktop_with_HDMI.img.gz" then burned on to a SD card (full size or microSD with a full size adaptor).
"dmesg" will tell you what it's called when you attach the reader with the SD card inserted to a USB port,e.g /dev/sdb, /dev/sdc, etc.

"dd if=odroidx_20120906-linaro-precise-ubuntu-desktop_with_HDMI.img of=/dev/sdc bs=1M"
When it completes, insert the SD card into the ODROID-X and boot up - the ODROID-X has a power on and a reset switch on board.

There is a way to prepare the SD card using Windows but I don't do Windows, consult http://beagleboard.org/demo/angstrom/

I use the HDMI.img as I have a spare HDMI port on one of my monitors - it requires a micro HDMI cable, standard HDMI on the monitor end and micro HDMI on the ODROID-X board.

When you have the ODROID-X all up and running and installed the pre-req packages for ghpsdr3-alex - there are a lot of them as is the case with any Ubuntu or other distribution, the build instructions are as follows:-

$ git clone git://github.com/alexlee188/ghpsdr3-alex.git

$ cd ghpsdr3-alex

Then I run a script to remove -msse and friends, the script I call "rm_words" made executable and put in /usr/local/bin

find ./ -type f | xargs sed -i 's/-msse3//g'

find ./ -type f | xargs sed -i 's/-msse//g'

find ./ -type f | xargs sed -i 's/-ffast-math//g'

autoreconf -i

source set_Qt-5.0.0_path.src

set_Qt-5.0.0_path.src contains "export PATH=/opt/qt5/bin:$PATH" and I'm using the qt5-daily from edgers.

http://ppa.launchpad.net/canonical-qt5-edgers/qt5-daily/ubuntu precise main

The configure script I call "alex-config" made executable and put in /usr/local/bin

./configure CFLAGS='-O3 -pipe -mfpu=neon -fno-tree-vectorize -fopenmp' CXXFLAGS='-O3 -pipe -mfpu=neon -fno-tree-vectorize -fopenmp'

$ make -j 4 all

$ sudo make -j 4 all install

The ODROID-X is treated the same as the Pandaboard and the Raspberry Pi when building ghpsdr3-alex, except the Pandaboard uses the normal Ubuntu ARM distribution while the ODROID-X uses the linaro Ubuntu ARM distribution built especially for it. The Raspberry Pi uses the debian raspbian distribution.

The distributions are all Ubuntu ARM and packages are updated, upgraded and installed in exactly the same manner as Ubuntu for x86/x86_64 so there is no learning curve involved if you already know Ubuntu.

I use 32GB SD cards but recommend at least 16GB to give ample space to install and build other software.
SD cards can either be full size or microSD with full size adaptor.

QtRadio Installation

2012-09-09T13:31:51Z

G3vbv: /* SOFTWARE */

== 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 =====
See:

http://napan.ca/ghpsdr3/index.php/Developers_Documentation

You will need qt5 to be installed as per the above.

===== 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
cd codec2
autoreconf -i
./configure
make
sudo make install
sudo ldconfig
</pre>

On Fedora, in order to use the library above, export the LD_LIBRARY_PATH:

<pre>
export LD_LIBRARY_PATH=/usr/local/lib
</pre>

==== Building the 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 branch.
This branch contains only RX capability and his client/server protocol is not compatible with that of rxtx-event branch.

First off, download, compile and install the library libperseus-sdr:

<pre>
sudo apt-get install wget
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
</pre>

Next, install the other prerequisite library:

<pre>
sudo apt-get install libboost-all-dev
</pre>

If you already build in your sandbox some other branch, is strongly advisable, before you start the build, to do a full cleanup:
<pre>
cd ~/ghpsdr3-alex
make distcheck && sh cleanup.sh
</pre>

Otherwise, if you are starting from scratch, first clone the repository:

<pre>
git clone git://github.com/alexlee188/ghpsdr3-alex
</pre>

Finally, you can switch to the master branch and rebuild everything, enabling the perseus server feature:
<pre>
cd ~/ghpsdr3-alex
git checkout master
autoreconf -i && ./configure --enable-perseus=yes && make -j4
sudo make install
</pre>

In order to run it you have two choices, the first one being the plain command line:

<pre>
xterm -e 'perseus_server -d3 -s96000' &
xterm -e 'dspserver --lo 0' &
$(export QT_RADIO_NO_LOCAL_AUDIO=1 ; ./QtRadio )
</pre>

In QtRadio, Receiver menu, select Configure item, Server tab: here add the local host using the 127.0.0.1 IP address.
Pressing the key C, you start the receiver.

The second choiche is to use the ghpsdr3-mgr.py script (available in menu Applications, Hamradio as ghpsdr3launcher): clicking on the Perseus icon the three processes should start and the QtServer automatically connects to Perseus Server.

==== 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.

NOTE:-******Remove all traces of -msse,-msse3 and -ffast-math from Makefile.am and Makefile.in where appropriate in the subdirectories as those are not for ARM architecture. Here is my script - make it executable and put it in your path, e.g /usr/local/bin/.
Formatting problem, #!/bin/sh is the first line of the script which is run in the ghpsdr3-alex directory.

#!/bin/sh

find ./ -type f | xargs sed -i 's/-msse3//g'

find ./ -type f | xargs sed -i 's/-msse//g'

find ./ -type f | xargs sed -i 's/-ffast-math//g'

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

2012-09-09T12:22:37Z

G3vbv: /* SOFTWARE */

== 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 =====
See:

http://napan.ca/ghpsdr3/index.php/Developers_Documentation

You will need qt5 to be installed as per the above.

===== 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
cd codec2
autoreconf -i
./configure
make
sudo make install
sudo ldconfig
</pre>

On Fedora, in order to use the library above, export the LD_LIBRARY_PATH:

<pre>
export LD_LIBRARY_PATH=/usr/local/lib
</pre>

==== Building the 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 branch.
This branch contains only RX capability and his client/server protocol is not compatible with that of rxtx-event branch.

First off, download, compile and install the library libperseus-sdr:

<pre>
sudo apt-get install wget
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
</pre>

Next, install the other prerequisite library:

<pre>
sudo apt-get install libboost-all-dev
</pre>

If you already build in your sandbox some other branch, is strongly advisable, before you start the build, to do a full cleanup:
<pre>
cd ~/ghpsdr3-alex
make distcheck && sh cleanup.sh
</pre>

Otherwise, if you are starting from scratch, first clone the repository:

<pre>
git clone git://github.com/alexlee188/ghpsdr3-alex
</pre>

Finally, you can switch to the master branch and rebuild everything, enabling the perseus server feature:
<pre>
cd ~/ghpsdr3-alex
git checkout master
autoreconf -i && ./configure --enable-perseus=yes && make -j4
sudo make install
</pre>

In order to run it you have two choices, the first one being the plain command line:

<pre>
xterm -e 'perseus_server -d3 -s96000' &
xterm -e 'dspserver --lo 0' &
$(export QT_RADIO_NO_LOCAL_AUDIO=1 ; ./QtRadio )
</pre>

In QtRadio, Receiver menu, select Configure item, Server tab: here add the local host using the 127.0.0.1 IP address.
Pressing the key C, you start the receiver.

The second choiche is to use the ghpsdr3-mgr.py script (available in menu Applications, Hamradio as ghpsdr3launcher): clicking on the Perseus icon the three processes should start and the QtServer automatically connects to Perseus Server.

==== 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.

NOTE:-******Remove all traces of -msse,-msse3 and -ffast-math from Makefile.am and Makefile.in where appropriate in the subdirectories as those are not for ARM architecture. Here is my script - make it executable and put it in your path, e.g /usr/local/bin/.
Formatting problem, #!/bin/sh is the first line of the script which is run in the ghpsdr3-alex directory.

#!/bin/sh

find ./ -type f | xargs sed -i 's/-msse3//g'

find ./ -type f | xargs sed -i 's/-msse//g'

find ./ -type f | xargs sed -i 's/-ffast-math//g'

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

Running hiqsdr-server at 48K/96K and dspserver (built with qt4) as qt5 is not yet available. There are instructions for building qt5 but following them bullet by bullet it failed not far along. The instructions are for building on i386 - I have put out a request for .deb packages or at least built tarballs to the Raspberry Pi forum.

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

2012-09-09T12:19:59Z

G3vbv: /* SOFTWARE */

== 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 =====
See:

http://napan.ca/ghpsdr3/index.php/Developers_Documentation

You will need qt5 to be installed as per the above.

===== 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
cd codec2
autoreconf -i
./configure
make
sudo make install
sudo ldconfig
</pre>

On Fedora, in order to use the library above, export the LD_LIBRARY_PATH:

<pre>
export LD_LIBRARY_PATH=/usr/local/lib
</pre>

==== Building the 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 branch.
This branch contains only RX capability and his client/server protocol is not compatible with that of rxtx-event branch.

First off, download, compile and install the library libperseus-sdr:

<pre>
sudo apt-get install wget
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
</pre>

Next, install the other prerequisite library:

<pre>
sudo apt-get install libboost-all-dev
</pre>

If you already build in your sandbox some other branch, is strongly advisable, before you start the build, to do a full cleanup:
<pre>
cd ~/ghpsdr3-alex
make distcheck && sh cleanup.sh
</pre>

Otherwise, if you are starting from scratch, first clone the repository:

<pre>
git clone git://github.com/alexlee188/ghpsdr3-alex
</pre>

Finally, you can switch to the master branch and rebuild everything, enabling the perseus server feature:
<pre>
cd ~/ghpsdr3-alex
git checkout master
autoreconf -i && ./configure --enable-perseus=yes && make -j4
sudo make install
</pre>

In order to run it you have two choices, the first one being the plain command line:

<pre>
xterm -e 'perseus_server -d3 -s96000' &
xterm -e 'dspserver --lo 0' &
$(export QT_RADIO_NO_LOCAL_AUDIO=1 ; ./QtRadio )
</pre>

In QtRadio, Receiver menu, select Configure item, Server tab: here add the local host using the 127.0.0.1 IP address.
Pressing the key C, you start the receiver.

The second choiche is to use the ghpsdr3-mgr.py script (available in menu Applications, Hamradio as ghpsdr3launcher): clicking on the Perseus icon the three processes should start and the QtServer automatically connects to Perseus Server.

==== 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.

NOTE:-******Remove all traces of -msse,-msse3 and -ffast-math from Makefile.am and Makefile.in where appropriate in the subdirectories as those are not for ARM architecture. Here is my script - make it executable and put it in your path, e.g /usr/local/bin/.
Formatting problem, #!/bin/sh is the first line of the script which is run in the ghpsdr3-alex directory.

#!/bin/sh

find ./ -type f | xargs sed -i 's/-msse3//g'

find ./ -type f | xargs sed -i 's/-msse//g'

find ./ -type f | xargs sed -i 's/-ffast-math//g'

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

Running hiqsdr-server at 48K/96K and dspserver (built with qt4) as qt5 is not yet available. There are instructions for building qt5 but following them bullet by bullet it failed not far along. The instructions are for building on i386 - I have put out a request for .deb packages or at least built tarballs to the Raspberry Pi forum.

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

2012-09-09T12:18:57Z

G3vbv: /* SOFTWARE */

== 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 =====
See:

http://napan.ca/ghpsdr3/index.php/Developers_Documentation

You will need qt5 to be installed as per the above.

===== 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
cd codec2
autoreconf -i
./configure
make
sudo make install
sudo ldconfig
</pre>

On Fedora, in order to use the library above, export the LD_LIBRARY_PATH:

<pre>
export LD_LIBRARY_PATH=/usr/local/lib
</pre>

==== Building the 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 branch.
This branch contains only RX capability and his client/server protocol is not compatible with that of rxtx-event branch.

First off, download, compile and install the library libperseus-sdr:

<pre>
sudo apt-get install wget
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
</pre>

Next, install the other prerequisite library:

<pre>
sudo apt-get install libboost-all-dev
</pre>

If you already build in your sandbox some other branch, is strongly advisable, before you start the build, to do a full cleanup:
<pre>
cd ~/ghpsdr3-alex
make distcheck && sh cleanup.sh
</pre>

Otherwise, if you are starting from scratch, first clone the repository:

<pre>
git clone git://github.com/alexlee188/ghpsdr3-alex
</pre>

Finally, you can switch to the master branch and rebuild everything, enabling the perseus server feature:
<pre>
cd ~/ghpsdr3-alex
git checkout master
autoreconf -i && ./configure --enable-perseus=yes && make -j4
sudo make install
</pre>

In order to run it you have two choices, the first one being the plain command line:

<pre>
xterm -e 'perseus_server -d3 -s96000' &
xterm -e 'dspserver --lo 0' &
$(export QT_RADIO_NO_LOCAL_AUDIO=1 ; ./QtRadio )
</pre>

In QtRadio, Receiver menu, select Configure item, Server tab: here add the local host using the 127.0.0.1 IP address.
Pressing the key C, you start the receiver.

The second choiche is to use the ghpsdr3-mgr.py script (available in menu Applications, Hamradio as ghpsdr3launcher): clicking on the Perseus icon the three processes should start and the QtServer automatically connects to Perseus Server.

==== 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 high these samplerates - I am running hiqsdr-server at 960K samplerate on a 8-core x84_64 box.

NOTE:-******Remove all traces of -msse,-msse3 and -ffast-math from Makefile.am and Makefile.in where appropriate in the subdirectories as those are not for ARM architecture. Here is my script - make it executable and put it in your path, e.g /usr/local/bin/.
Formatting problem, #!/bin/sh is the first line of the script which is run in the ghpsdr3-alex directory.

#!/bin/sh

find ./ -type f | xargs sed -i 's/-msse3//g'

find ./ -type f | xargs sed -i 's/-msse//g'

find ./ -type f | xargs sed -i 's/-ffast-math//g'

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

Running hiqsdr-server at 48K/96K and dspserver (built with qt4) as qt5 is not yet available. There are instructions for building qt5 but following them bullet by bullet it failed not far along. The instructions are for building on i386 - I have put out a request for .deb packages or at least built tarballs to the Raspberry Pi forum.

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

2012-09-09T12:11:20Z

G3vbv: /* SOFTWARE */

== 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 =====
See:

http://napan.ca/ghpsdr3/index.php/Developers_Documentation

You will need qt5 to be installed as per the above.

===== 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
cd codec2
autoreconf -i
./configure
make
sudo make install
sudo ldconfig
</pre>

On Fedora, in order to use the library above, export the LD_LIBRARY_PATH:

<pre>
export LD_LIBRARY_PATH=/usr/local/lib
</pre>

==== Building the 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 branch.
This branch contains only RX capability and his client/server protocol is not compatible with that of rxtx-event branch.

First off, download, compile and install the library libperseus-sdr:

<pre>
sudo apt-get install wget
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
</pre>

Next, install the other prerequisite library:

<pre>
sudo apt-get install libboost-all-dev
</pre>

If you already build in your sandbox some other branch, is strongly advisable, before you start the build, to do a full cleanup:
<pre>
cd ~/ghpsdr3-alex
make distcheck && sh cleanup.sh
</pre>

Otherwise, if you are starting from scratch, first clone the repository:

<pre>
git clone git://github.com/alexlee188/ghpsdr3-alex
</pre>

Finally, you can switch to the master branch and rebuild everything, enabling the perseus server feature:
<pre>
cd ~/ghpsdr3-alex
git checkout master
autoreconf -i && ./configure --enable-perseus=yes && make -j4
sudo make install
</pre>

In order to run it you have two choices, the first one being the plain command line:

<pre>
xterm -e 'perseus_server -d3 -s96000' &
xterm -e 'dspserver --lo 0' &
$(export QT_RADIO_NO_LOCAL_AUDIO=1 ; ./QtRadio )
</pre>

In QtRadio, Receiver menu, select Configure item, Server tab: here add the local host using the 127.0.0.1 IP address.
Pressing the key C, you start the receiver.

The second choiche is to use the ghpsdr3-mgr.py script (available in menu Applications, Hamradio as ghpsdr3launcher): clicking on the Perseus icon the three processes should start and the QtServer automatically connects to Perseus Server.

==== 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

I did a fresh clone and changed to the iw0hdv branch from the default master branch.

git checkout iw0hdv

NOTE:-******Remove all traces of -msse,-msse3 and -ffast-math from Makefile.am and Makefile.in where appropriate in the subdirectories as those are not for ARM architecture. Here is my script - make it executable and put it in your path, e.g /usr/local/bin/.
Formatting problem, #!/bin/sh is the first line of the script which is run in the ghpsdr3-alex directory.

#!/bin/sh

find ./ -type f | xargs sed -i 's/-msse3//g'

find ./ -type f | xargs sed -i 's/-msse//g'

find ./ -type f | xargs sed -i 's/-ffast-math//g'

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

Running hiqsdr-server at 48K/96K and dspserver (built with qt4) as qt5 is not yet available. There are instructions for building qt5 but following them bullet by bullet it failed not far along. The instructions are for building on i386 - I have put out a request for .deb packages or at least built tarballs to the Raspberry Pi forum.

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

2012-09-09T12:09:20Z

G3vbv: /* SOFTWARE */

== 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 =====
See:

http://napan.ca/ghpsdr3/index.php/Developers_Documentation

You will need qt5 to be installed as per the above.

===== 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
cd codec2
autoreconf -i
./configure
make
sudo make install
sudo ldconfig
</pre>

On Fedora, in order to use the library above, export the LD_LIBRARY_PATH:

<pre>
export LD_LIBRARY_PATH=/usr/local/lib
</pre>

==== Building the 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 branch.
This branch contains only RX capability and his client/server protocol is not compatible with that of rxtx-event branch.

First off, download, compile and install the library libperseus-sdr:

<pre>
sudo apt-get install wget
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
</pre>

Next, install the other prerequisite library:

<pre>
sudo apt-get install libboost-all-dev
</pre>

If you already build in your sandbox some other branch, is strongly advisable, before you start the build, to do a full cleanup:
<pre>
cd ~/ghpsdr3-alex
make distcheck && sh cleanup.sh
</pre>

Otherwise, if you are starting from scratch, first clone the repository:

<pre>
git clone git://github.com/alexlee188/ghpsdr3-alex
</pre>

Finally, you can switch to the master branch and rebuild everything, enabling the perseus server feature:
<pre>
cd ~/ghpsdr3-alex
git checkout master
autoreconf -i && ./configure --enable-perseus=yes && make -j4
sudo make install
</pre>

In order to run it you have two choices, the first one being the plain command line:

<pre>
xterm -e 'perseus_server -d3 -s96000' &
xterm -e 'dspserver --lo 0' &
$(export QT_RADIO_NO_LOCAL_AUDIO=1 ; ./QtRadio )
</pre>

In QtRadio, Receiver menu, select Configure item, Server tab: here add the local host using the 127.0.0.1 IP address.
Pressing the key C, you start the receiver.

The second choiche is to use the ghpsdr3-mgr.py script (available in menu Applications, Hamradio as ghpsdr3launcher): clicking on the Perseus icon the three processes should start and the QtServer automatically connects to Perseus Server.

==== 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

I did a fresh clone and changed to the iw0hdv branch from the default master branch.

git checkout iw0hdv

NOTE:-******Remove all traces of -msse,-msse3 and -ffast-math from Makefile.am and Makefile.in where appropriate in the subdirectories as those are not for ARM architecture. Here is my script - make it executable and put it in your path, e.g /usr/local/bin/.
Formatting problem, #!/bin/sh is the first line of the script.

#!/bin/sh

find ./ -type f | xargs sed -i 's/-msse3//g'

find ./ -type f | xargs sed -i 's/-msse//g'

find ./ -type f | xargs sed -i 's/-ffast-math//g'

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

Running hiqsdr-server at 48K/96K and dspserver (built with qt4) as qt5 is not yet available. There are instructions for building qt5 but following them bullet by bullet it failed not far along. The instructions are for building on i386 - I have put out a request for .deb packages or at least built tarballs to the Raspberry Pi forum.

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

2012-09-09T12:06:02Z

G3vbv: /* HARDWARE */

== 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 =====
See:

http://napan.ca/ghpsdr3/index.php/Developers_Documentation

You will need qt5 to be installed as per the above.

===== 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
cd codec2
autoreconf -i
./configure
make
sudo make install
sudo ldconfig
</pre>

On Fedora, in order to use the library above, export the LD_LIBRARY_PATH:

<pre>
export LD_LIBRARY_PATH=/usr/local/lib
</pre>

==== Building the 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 branch.
This branch contains only RX capability and his client/server protocol is not compatible with that of rxtx-event branch.

First off, download, compile and install the library libperseus-sdr:

<pre>
sudo apt-get install wget
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
</pre>

Next, install the other prerequisite library:

<pre>
sudo apt-get install libboost-all-dev
</pre>

If you already build in your sandbox some other branch, is strongly advisable, before you start the build, to do a full cleanup:
<pre>
cd ~/ghpsdr3-alex
make distcheck && sh cleanup.sh
</pre>

Otherwise, if you are starting from scratch, first clone the repository:

<pre>
git clone git://github.com/alexlee188/ghpsdr3-alex
</pre>

Finally, you can switch to the master branch and rebuild everything, enabling the perseus server feature:
<pre>
cd ~/ghpsdr3-alex
git checkout master
autoreconf -i && ./configure --enable-perseus=yes && make -j4
sudo make install
</pre>

In order to run it you have two choices, the first one being the plain command line:

<pre>
xterm -e 'perseus_server -d3 -s96000' &
xterm -e 'dspserver --lo 0' &
$(export QT_RADIO_NO_LOCAL_AUDIO=1 ; ./QtRadio )
</pre>

In QtRadio, Receiver menu, select Configure item, Server tab: here add the local host using the 127.0.0.1 IP address.
Pressing the key C, you start the receiver.

The second choiche is to use the ghpsdr3-mgr.py script (available in menu Applications, Hamradio as ghpsdr3launcher): clicking on the Perseus icon the three processes should start and the QtServer automatically connects to Perseus Server.

==== 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

I did a fresh clone and changed to the iw0hdv branch from the default master branch.

git checkout iw0hdv

NOTE:-******Remove all traces of -msse,-msse3 and -ffast-math from Makefile.am and Makefile.in where appropriate in the subdirectories as those are not for ARM architecture. Here is my script - make it executable and put it in your path, e.g /usr/local/bin/.
Formatting problem, #!/bin/sh is the first line of the script.

#!/bin/sh

find ./ -type f | xargs sed -i 's/-msse3//g'

find ./ -type f | xargs sed -i 's/i-msse//g'

find ./ -type f | xargs sed -i 's/-ffast-math//g'

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

Running hiqsdr-server at 48K/96K and dspserver (built with qt4) as qt5 is not yet available. There are instructions for building qt5 but following them bullet by bullet it failed not far along. The instructions are for building on i386 - I have put out a request for .deb packages or at least built tarballs to the Raspberry Pi forum.

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

2012-09-09T02:30:46Z

G3vbv: /* HARDWARE */

== 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 =====
See:

http://napan.ca/ghpsdr3/index.php/Developers_Documentation

You will need qt5 to be installed as per the above.

===== 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
cd codec2
autoreconf -i
./configure
make
sudo make install
sudo ldconfig
</pre>

On Fedora, in order to use the library above, export the LD_LIBRARY_PATH:

<pre>
export LD_LIBRARY_PATH=/usr/local/lib
</pre>

==== Building the 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 branch.
This branch contains only RX capability and his client/server protocol is not compatible with that of rxtx-event branch.

First off, download, compile and install the library libperseus-sdr:

<pre>
sudo apt-get install wget
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
</pre>

Next, install the other prerequisite library:

<pre>
sudo apt-get install libboost-all-dev
</pre>

If you already build in your sandbox some other branch, is strongly advisable, before you start the build, to do a full cleanup:
<pre>
cd ~/ghpsdr3-alex
make distcheck && sh cleanup.sh
</pre>

Otherwise, if you are starting from scratch, first clone the repository:

<pre>
git clone git://github.com/alexlee188/ghpsdr3-alex
</pre>

Finally, you can switch to the master branch and rebuild everything, enabling the perseus server feature:
<pre>
cd ~/ghpsdr3-alex
git checkout master
autoreconf -i && ./configure --enable-perseus=yes && make -j4
sudo make install
</pre>

In order to run it you have two choices, the first one being the plain command line:

<pre>
xterm -e 'perseus_server -d3 -s96000' &
xterm -e 'dspserver --lo 0' &
$(export QT_RADIO_NO_LOCAL_AUDIO=1 ; ./QtRadio )
</pre>

In QtRadio, Receiver menu, select Configure item, Server tab: here add the local host using the 127.0.0.1 IP address.
Pressing the key C, you start the receiver.

The second choiche is to use the ghpsdr3-mgr.py script (available in menu Applications, Hamradio as ghpsdr3launcher): clicking on the Perseus icon the three processes should start and the QtServer automatically connects to Perseus Server.

==== 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.

root@pisces:~# uptime

03:28:59 up 2 days, 11:14, 8 users, load average: 2.16, 2.04, 1.86

****** 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

I did a fresh clone and changed to the iw0hdv branch from the default master branch.

git checkout iw0hdv

NOTE:-******Remove all traces of -msse,-msse3 and -ffast-math from Makefile.am and Makefile.in where appropriate in the subdirectories as those are not for ARM architecture. Here is my script - make it executable and put it in your path, e.g /usr/local/bin/.
Formatting problem, #!/bin/sh is the first line of the script.

#!/bin/sh

find ./ -type f | xargs sed -i 's/-msse3//g'

find ./ -type f | xargs sed -i 's/i-msse//g'

find ./ -type f | xargs sed -i 's/-ffast-math//g'

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

Running hiqsdr-server at 48K/96K and dspserver (built with qt4) as qt5 is not yet available. There are instructions for building qt5 but following them bullet by bullet it failed not far along. The instructions are for building on i386 - I have put out a request for .deb packages or at least built tarballs to the Raspberry Pi forum.

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

2012-09-09T01:29:03Z

G3vbv: /* SOFTWARE */

QtRadio Installation

2012-09-09T01:18:54Z

G3vbv: /* SOFTWARE */

QtRadio Installation

2012-09-09T01:17:09Z

G3vbv: /* SOFTWARE */

QtRadio Installation

2012-09-09T01:16:34Z

G3vbv: /* SOFTWARE */

QtRadio Installation

2012-09-09T01:16:01Z

G3vbv: /* SOFTWARE */

QtRadio Installation

2012-09-09T01:15:37Z

G3vbv: /* SOFTWARE */

QtRadio Installation

2012-09-09T01:14:55Z

G3vbv: /* SOFTWARE */

QtRadio Installation

2012-09-04T00:57:55Z

G3vbv: /* HARDWARE */

QtRadio Installation

2012-09-01T23:30:03Z

G3vbv: /* SOFTWARE */

QtRadio Installation

2012-08-30T20:03:55Z

G3vbv: /* HARDWARE */

QtRadio Installation

2012-08-30T19:57:41Z

G3vbv: /* SOFTWARE */

QtRadio Installation

2012-08-30T19:51:50Z

G3vbv: /* HARDWARE == */

QtRadio Installation

2012-08-30T19:51:11Z

G3vbv: /* Installing ghpsdr3-alex on Raspberry Pi */

QtRadio Installation

2012-08-30T10:44:03Z

G3vbv: /* SOFTWARE */

QtRadio Installation

2012-08-28T23:14:35Z

G3vbv: /* Installing ghpsdr3-alex on Raspberry Pi */