https://napan.ca/ghpsdr3/api.php?action=feedcontributions&feedformat=atom&user=FrohroGhpsdr3 SDR project - User contributions [en]2026-04-08T23:49:56ZUser contributionsMediaWiki 1.42.7https://napan.ca/ghpsdr3/index.php?title=Hermes&diff=780Hermes2013-09-24T04:03:59Z<p>Frohro: /* dspserver */</p>
<hr />
<div>Thanks to Andrea for providing the Hermes backend for ghpsdr3-alex. <br />
There are two programs you need to start to get the server running. The first is hpsdr-server. It is the software that sets up the Hermes for action. It sends and gets data from the Hermes as shown on the [[Main Page]]. <br />
<br />
====hpsdr-server====<br />
Here is how you start the hpsdr-server from the command line. <br />
$ hpsdr-server --samplerate 48000 --hermes 16 --interface eth2<br />
<br />
Note: <br />
*you can use 48000, 96000, 192000, or 384000 for the --samplerate parameter.<br />
*the --hermes parameter is how much power Hermes will put out on transmit. The values go from 0 to 255.<br />
*the --interface parameter is the network interface that is connected to the same local area network that Hermes is connected to. It may be eth1, eth2, etc. or wlan1, wlan2, etc. You can figure out what it is by using the ifconfig command at the terminal as follows:<br />
<br />
$ ifconfig<br />
eth9 Link encap:Ethernet HWaddr 5c:26:0a:45:28:7b <br />
inet addr:192.168.2.157 Bcast:192.168.2.255 Mask:255.255.255.0<br />
inet6 addr: fe80::5e26:aff:fe45:287b/64 Scope:Link<br />
UP BROADCAST RUNNING MULTICAST MTU:1500 Metric:1<br />
RX packets:1877498 errors:0 dropped:0 overruns:0 frame:0<br />
TX packets:2572794 errors:0 dropped:0 overruns:0 carrier:0<br />
collisions:0 txqueuelen:1000 <br />
RX bytes:881124281 (881.1 MB) TX bytes:3414696100 (3.4 GB)<br />
Interrupt:20 Memory:f6900000-f6920000 <br />
<br />
lo Link encap:Local Loopback <br />
inet addr:127.0.0.1 Mask:255.0.0.0<br />
inet6 addr: ::1/128 Scope:Host<br />
UP LOOPBACK RUNNING MTU:65536 Metric:1<br />
RX packets:7758949 errors:0 dropped:0 overruns:0 frame:0<br />
TX packets:7758949 errors:0 dropped:0 overruns:0 carrier:0<br />
collisions:0 txqueuelen:0 <br />
RX bytes:4143306543 (4.1 GB) TX bytes:4143306543 (4.1 GB)<br />
<br />
wlan2 Link encap:Ethernet HWaddr 18:3d:a2:10:95:80 <br />
inet addr:192.168.2.250 Bcast:192.168.2.255 Mask:255.255.255.0<br />
inet6 addr: fe80::1a3d:a2ff:fe10:9580/64 Scope:Link<br />
UP BROADCAST RUNNING MULTICAST MTU:1500 Metric:1<br />
RX packets:3622385 errors:0 dropped:2 overruns:0 frame:0<br />
TX packets:1970372 errors:0 dropped:0 overruns:0 carrier:0<br />
collisions:0 txqueuelen:1000 <br />
RX bytes:4139564914 (4.1 GB) TX bytes:1254030073 (1.2 GB)<br />
<br />
In this case either eth9 or wlan2 could be used because my Hermes is on the 192.168.2.x network. The eth9 is an ethernet connection and wlan2 is a wireless connection.<br />
Other hpsdr-server options can be seen by using the --? option.<br />
$ hpsdr-server --?<br />
hpsdr-server: unrecognized option '--?'<br />
Usage: <br />
server --receivers N (default 1)<br />
--samplerate 48000|96000|192000|384000<br />
--dither off|on<br />
--random off|on<br />
--preamp off|on<br />
--10mhzsource atlas|penelope|mercury<br />
--122.88mhzsource atlas|penelope|mercury<br />
--micsource janus|penelope<br />
--class other|E<br />
--timing 1<br />
--metis<br />
--interface if<br />
--fpga <file name><br />
--ozyhex <file name><br />
--hermes <power 0-255><br />
<br />
====dspserver====<br />
The second program you need to start is dspserver. It processes the samples coming from hpsdr-server using dttSP and communicates with the client (QtRadio, glSDR, etc.) to determine what signal processing is wanted. <br />
Here is how you start dspserver from the command line.<br />
do dspserver --lo 0 --hpsdr --nocorrectiq --share<br />
The options are described if you use the --? command line option as follows:<br />
$ dspserver --?<br />
dspserver: unrecognized option '--?'<br />
Usage: <br />
dspserver --receiver (0-3)<br />
--server 0.0.0.0 (default 127.0.0.1)<br />
--soundcard (machine dependent)<br />
--offset 0 <br />
--share (will register this server for other users <br />
use the default config file ~/.dspserver.conf) <br />
--lo 0 (if no LO offset desired in DDC receivers, or 9000 in softrocks<br />
--hpsdr (if using hpsdr hardware with no local mike and headphone)<br />
--hpsdrloc (if using hpsdr hardware with LOCAL mike and headphone)<br />
--nocorrectiq (select if using non QSD receivers, like Hermes, Perseus, HiQSDR, Mercury)<br />
Because the dspserver communicates with the clients and they are the most unstable as far as network connection, etc. I find that sometimes the dspserver crashes, so I have taken to making a script I call do-dspserver-hermes that contains the following to automatically restart it.<br />
<br />
#!/bin/sh<br />
while true<br />
do dspserver --lo 0 --hpsdr --nocorrectiq --share<br />
sleep 5<br />
done<br />
<br />
You have to make this executable ($ chmod 755 do-dspserver-hermes) and put it somewhere in your command search PATH.<br />
<br />
Other useful commands to google that will help you run the server on linux are nohup, top, ps and kill.</div>Frohrohttps://napan.ca/ghpsdr3/index.php?title=Hermes&diff=779Hermes2013-09-24T03:59:33Z<p>Frohro: /* dspserver */</p>
<hr />
<div>Thanks to Andrea for providing the Hermes backend for ghpsdr3-alex. <br />
There are two programs you need to start to get the server running. The first is hpsdr-server. It is the software that sets up the Hermes for action. It sends and gets data from the Hermes as shown on the [[Main Page]]. <br />
<br />
====hpsdr-server====<br />
Here is how you start the hpsdr-server from the command line. <br />
$ hpsdr-server --samplerate 48000 --hermes 16 --interface eth2<br />
<br />
Note: <br />
*you can use 48000, 96000, 192000, or 384000 for the --samplerate parameter.<br />
*the --hermes parameter is how much power Hermes will put out on transmit. The values go from 0 to 255.<br />
*the --interface parameter is the network interface that is connected to the same local area network that Hermes is connected to. It may be eth1, eth2, etc. or wlan1, wlan2, etc. You can figure out what it is by using the ifconfig command at the terminal as follows:<br />
<br />
$ ifconfig<br />
eth9 Link encap:Ethernet HWaddr 5c:26:0a:45:28:7b <br />
inet addr:192.168.2.157 Bcast:192.168.2.255 Mask:255.255.255.0<br />
inet6 addr: fe80::5e26:aff:fe45:287b/64 Scope:Link<br />
UP BROADCAST RUNNING MULTICAST MTU:1500 Metric:1<br />
RX packets:1877498 errors:0 dropped:0 overruns:0 frame:0<br />
TX packets:2572794 errors:0 dropped:0 overruns:0 carrier:0<br />
collisions:0 txqueuelen:1000 <br />
RX bytes:881124281 (881.1 MB) TX bytes:3414696100 (3.4 GB)<br />
Interrupt:20 Memory:f6900000-f6920000 <br />
<br />
lo Link encap:Local Loopback <br />
inet addr:127.0.0.1 Mask:255.0.0.0<br />
inet6 addr: ::1/128 Scope:Host<br />
UP LOOPBACK RUNNING MTU:65536 Metric:1<br />
RX packets:7758949 errors:0 dropped:0 overruns:0 frame:0<br />
TX packets:7758949 errors:0 dropped:0 overruns:0 carrier:0<br />
collisions:0 txqueuelen:0 <br />
RX bytes:4143306543 (4.1 GB) TX bytes:4143306543 (4.1 GB)<br />
<br />
wlan2 Link encap:Ethernet HWaddr 18:3d:a2:10:95:80 <br />
inet addr:192.168.2.250 Bcast:192.168.2.255 Mask:255.255.255.0<br />
inet6 addr: fe80::1a3d:a2ff:fe10:9580/64 Scope:Link<br />
UP BROADCAST RUNNING MULTICAST MTU:1500 Metric:1<br />
RX packets:3622385 errors:0 dropped:2 overruns:0 frame:0<br />
TX packets:1970372 errors:0 dropped:0 overruns:0 carrier:0<br />
collisions:0 txqueuelen:1000 <br />
RX bytes:4139564914 (4.1 GB) TX bytes:1254030073 (1.2 GB)<br />
<br />
In this case either eth9 or wlan2 could be used because my Hermes is on the 192.168.2.x network. The eth9 is an ethernet connection and wlan2 is a wireless connection.<br />
Other hpsdr-server options can be seen by using the --? option.<br />
$ hpsdr-server --?<br />
hpsdr-server: unrecognized option '--?'<br />
Usage: <br />
server --receivers N (default 1)<br />
--samplerate 48000|96000|192000|384000<br />
--dither off|on<br />
--random off|on<br />
--preamp off|on<br />
--10mhzsource atlas|penelope|mercury<br />
--122.88mhzsource atlas|penelope|mercury<br />
--micsource janus|penelope<br />
--class other|E<br />
--timing 1<br />
--metis<br />
--interface if<br />
--fpga <file name><br />
--ozyhex <file name><br />
--hermes <power 0-255><br />
<br />
====dspserver====<br />
The second program you need to start is dspserver. It processes the samples coming from hpsdr-server using dttSP and communicates with the client (QtRadio, glSDR, etc.) to determine what signal processing is wanted. <br />
Here is how you start dspserver from the command line.<br />
do dspserver --lo 0 --hpsdr --nocorrectiq --share<br />
The options are described if you use the --? command line option as follows:<br />
$ dspserver --?<br />
dspserver: unrecognized option '--?'<br />
Usage: <br />
dspserver --server 0.0.0.0 (default 127.0.0.1)<br />
--soundcard (machine dependent)<br />
--offset 0 <br />
--share (will register this server for other users <br />
use the default config file ~/.dspserver.conf) <br />
--lo 0 (if no LO offset desired in DDC receivers, or 9000 in softrocks<br />
--hpsdr (if using hpsdr hardware with no local mike and headphone)<br />
--hpsdrloc (if using hpsdr hardware with LOCAL mike and headphone)<br />
--nocorrectiq (select if using non QSD receivers, like Hermes, Perseus, HiQSDR, Mercury)<br />
Because the dspserver communicates with the clients and they are the most unstable as far as network connection, etc. I find that sometimes the dspserver crashes, so I have taken to making a script I call do-dspserver-hermes that contains the following to automatically restart it.<br />
<br />
#!/bin/sh<br />
while true<br />
do dspserver --lo 0 --hpsdr --nocorrectiq --share<br />
sleep 5<br />
done<br />
<br />
You have to make this executable ($ chmod 755 do-dspserver-hermes) and put it somewhere in your command search PATH.<br />
<br />
Other useful commands to google that will help you run the server on linux are nohup, top, ps and kill.</div>Frohrohttps://napan.ca/ghpsdr3/index.php?title=QtRadio_Installation&diff=776QtRadio Installation2013-08-27T17:08:39Z<p>Frohro: /* VirtualBox Easy Installation */</p>
<hr />
<div>== Installation on Linux ==<br />
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.<br />
<br />
<br />
<br />
<br />
=== Installation from Git ===<br />
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.<br />
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.<br />
<br />
==== Installing compiler and autotool ====<br />
<br />
First off, install the compiler; depending on which distribution are you using, some or all of this stuff could be already installed: <br />
<br />
===== Ubuntu/Debian =====<br />
<pre><br />
sudo apt-get install make gcc g++<br />
sudo apt-get install autoconf automake autotools-dev libtool git subversion<br />
</pre><br />
<br />
===== Fedora =====<br />
<pre><br />
sudo yum install gcc gcc-c++ man-pages autoconf automake subversion libtool git<br />
</pre><br />
<br />
==== Installing prerequisite packages ====<br />
<br />
===== Ubuntu 12.04 and newer =====<br />
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:<br />
<br />
<pre><br />
sudo apt-get update<br />
sudo apt-get install \<br />
libqt4-opengl-dev \<br />
qtmobility-dev \<br />
libusb-0.1-4 \<br />
libusb-dev \<br />
libfftw3-dev \<br />
portaudio19-dev \<br />
libpulse-dev \<br />
libsamplerate0-dev \<br />
libusb-1.0-0-dev \<br />
libconfig8-dev \<br />
xdg-utils \<br />
libortp-dev \<br />
gcc-multilib \<br />
libssl-dev \<br />
libevent-dev \<br />
libglu1-mesa-dev \<br />
freeglut3-dev<br />
</pre><br />
<br />
You will need qt5 installed to complete the build.<br />
<br />
Visit: http://qt-project.org/downloads<br />
<br />
download the current package for your system.<br />
<br />
To build Qt5 on a RaspberryPi visit: http://qt-project.org/wiki/RaspberryPi<br />
<br />
After downloading it go to the download directory and do:<br />
<pre><br />
$ chmod +x the-name-of-the-downloaded-file<br />
$ sudo ./the-name-of-the-downloaded-file<br />
</pre><br />
<br />
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:<br />
<pre><br />
$ export PATH=/opt/Qt5.1.0/5.1.0/gcc_64/bin:/opt/Qt5.1.0/Tools/QtCreator/bin:$PATH<br />
</pre><br />
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.<br />
In any case please remember that<br />
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<br />
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.<br />
For the bash it is typically ~/.bashrc<br />
In any case, after you issue the export, please test it.<br />
<pre><br />
qmake -v<br />
QMake version 2.01a<br />
Using Qt version 4.8.0 in /home/andrew/QtSDK4.8x/Desktop/Qt/4.8.0/gcc/lib<br />
</pre><br />
<br />
===== Ubuntu 11.04 and older ===== <br />
First of all, you have to check that the ''universe repository'' is enabled.<br />
Please see the procedure in the previous section [[#graphical installation]] .<br />
<br />
Next, you will need the following packages installed:<br />
<br />
<pre><br />
sudo apt-get update<br />
sudo apt-get install \<br />
libqt4-opengl-dev \<br />
qtmobility-dev \<br />
libusb-0.1-4 \<br />
libusb-dev \<br />
libfftw3-dev \<br />
portaudio19-dev \<br />
libpulse-dev \<br />
libsamplerate0-dev \<br />
libusb-1.0-0-dev \<br />
libconfig8-dev \<br />
libortp-dev<br />
</pre><br />
<br />
===== Ubuntu 11.10 ===== <br />
First of all, you have to check that the ''universe repository'' is enabled.<br />
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.<br />
Next, submit the following commands into a terminal window:<br />
<br />
<pre><br />
sudo apt-get update<br />
sudo apt-get install \<br />
libqt4-opengl-dev \<br />
qtmobility-dev \<br />
libusb-0.1-4 \<br />
libusb-dev \<br />
libfftw3-dev \<br />
portaudio19-dev \<br />
libpulse-dev \<br />
libsamplerate0-dev \<br />
libusb-1.0-0-dev \<br />
libconfig8-dev \<br />
xdg-utils \<br />
libortp-dev<br />
</pre><br />
<br />
===== Fedora 16 =====<br />
<br />
<pre><br />
sudo yum install fftw fftw-devel <br />
sudo yum install libusb-devel libusb1-devel <br />
sudo yum install portaudio-devel<br />
sudo yum install libconfig-devel<br />
sudo yum install libsamplerate-devel<br />
sudo yum install pulseaudio-libs-devel<br />
sudo yum install jack-audio-connection-kit jack-audio-connection-kit-devel<br />
sudo yum install qt4-devel<br />
</pre><br />
<br />
<br />
==== Cloning the repository ====<br />
<br />
How to build the latest master branch on Ubuntu 11.04<br />
<br />
First a new libevent will need to be downloaded and installed, then the actual QtRadio source can be downloaded and built.<br />
<br />
==== Obtaining an up-level libevent library ====<br />
<br />
$ sudo apt-get install libevent-dev<br />
<br />
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)<br />
<br />
Then download the new version from:<br />
<br />
http://libevent.org/<br />
<br />
libevent-2.0.16-stable.tar.gz<br />
<br />
<pre><br />
wget https://github.com/downloads/libevent/libevent/libevent-2.0.16-stable.tar.gz<br />
</pre><br />
<br />
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:<br />
<br />
<pre><br />
cd<br />
tar -zxvf libevent-2.0.16-stable.tar.gz<br />
cd libevent-2.0.16-stable<br />
./configure<br />
make<br />
sudo make install<br />
sudo ldconfig<br />
</pre><br />
<br />
On Fedora, in order to use the library above, export the LD_LIBRARY_PATH:<br />
<br />
<pre><br />
export LD_LIBRARY_PATH=/usr/local/lib<br />
</pre><br />
<br />
==== Installing codec2 low bit rate audio encoding and decoding ====<br />
<br />
We are adding a low bit rate audio codec called codec 2 to QtRadio/dspserver. You need<br />
to download and build the codec2 library. See:<br />
<br />
http://www.rowetel.com/blog/?page_id=452<br />
<p><br />
Now go get codec2 using subversion<br />
<br />
<pre><br />
cd<br />
svn co https://freetel.svn.sourceforge.net/svnroot/freetel/codec2-dev codec2-dev<br />
cd codec2-dev<br />
autoreconf -i<br />
./configure<br />
make<br />
sudo make install<br />
sudo ldconfig<br />
</pre><br />
<br />
On Fedora, in order to use the library above, export the LD_LIBRARY_PATH:<br />
<br />
<pre><br />
export LD_LIBRARY_PATH=/usr/local/lib<br />
</pre><br />
<br />
==== Building the master branch ====<br />
<br />
This branch is the latest code that contains both RX and TX capability. <br />
<br />
Create a new directory or cd to the ~/src directory created for libevent and cd into it.<br />
<br />
<pre><br />
git clone git://github.com/alexlee188/ghpsdr3-alex<br />
</pre><br />
<br />
Depending on your Internet connection thorughput, it will take several minute to download.<br />
cd into the new directory ghpsdr3-alex:<br />
<pre><br />
cd ghpsdr3-alex<br />
git checkout master<br />
</pre><br />
You are now working with Alex's latest and greatest!<br />
<br />
First set the path to the version of qt you are using. E.g. for qt5:<br />
<pre><br />
$ export PATH=/opt/qt5/bin:$PATH<br />
</pre><br />
<br />
Then:<br />
<pre><br />
autoreconf -i<br />
./configure<br />
make -j4 all<br />
sudo make install<br />
</pre><br />
The default configure above builds with debug and default Qt4 version in your PC. For optimized executable,<br />
you need to specify options specific to your system. See the sample shell scripts that replaces the above<br />
./configure step:<br />
<br />
<pre><br />
./alex-avx-conf.sh for building with i3,i5 and i7 cpu's supporting Advanced Vector Extensions (AVX)<br />
./alex-openmp-conf.sh for building with i3,i5 and i7 cpu's and OpenMP support<br />
./alex-sse3-conf.sh for building with SSE3 capable cpu's<br />
./alex-openmp-sse3-conf.sh for building with SSE3 cpaable cpu's and OpenMP support<br />
</pre><br />
<br />
(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)<br />
<pre><br />
Terminal 1<br />
$ cd ghpsdr3-alex/trunk/src/softrock<br />
$ ./softrock ...options ...<br />
<br />
Terminal 2<br />
$ cd ghpsdr3-alex/trunk/src/dspserver<br />
$ ./dspserver ..options...<br />
<br />
Terminal 3<br />
$ cd ghpsdr3-alex/trunk/src/QtRadio<br />
$ ./QtRadio<br />
</pre><br />
<br />
==== Building the Perseus extensions ====<br />
<br />
In order to build the Microtelecom Perseus server you need to switch to the master or iw0hdv branch. <br />
<br />
First off, install the prerequisite library and wget package:<br />
<br />
<pre><br />
sudo apt-get install libboost-all-dev wget<br />
</pre><br />
<br />
Next download, compile and install the library libperseus-sdr:<br />
<br />
<pre><br />
cd<br />
wget http://libperseus-sdr.googlecode.com/files/libperseus_sdr-0.6.tar.gz<br />
tar -zxvf libperseus_sdr-0.6.tar.gz<br />
cd libperseus_sdr-0.6/<br />
./configure && make<br />
sudo make install<br />
sudo ldconfig<br />
</pre><br />
<br />
<br />
If you already build in your sandbox some other branch, is strongly advisable, before you start the build, to do a full cleanup:<br />
<pre><br />
cd ~/ghpsdr3-alex<br />
make distcheck && sh cleanup.sh<br />
</pre><br />
<br />
Otherwise, if you are starting from scratch, you have to clone the repository:<br />
<br />
<pre><br />
git clone git://github.com/alexlee188/ghpsdr3-alex<br />
</pre><br />
<br />
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.<br />
<br />
<pre><br />
cd ~/ghpsdr3-alex<br />
git checkout master<br />
autoreconf -i && ./configure && make -j4<br />
sudo make install<br />
</pre><br />
<br />
In order to run it you have two choices, the first one being the plain command line:<br />
<br />
<pre><br />
xterm -e 'perseus_server -d3 -s96000 ' &<br />
sleep 3<br />
xterm -e 'dspserver --lo 0 --nocorrectiq' &<br />
sleep 5<br />
$( QtRadio 127.0.0.1 ) <br />
</pre><br />
<br />
In QtRadio, Receiver menu, select Configure item, Server tab: here add the local host using the 127.0.0.1 IP address.<br />
Pressing the key C, you start the receiver.<br />
<br />
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.<br />
<br />
==== Building USRP enabled version ====<br />
<br />
===== Building the UHD package =====<br />
<br />
<br />
====== Install the prerequisite packages (Ubuntu 11.10): ======<br />
<br />
<pre><br />
sudo apt-get install liboost-all-dev<br />
sudo apt-get install python-cheetah<br />
</pre><br />
<br />
====== Build & Install UHD -- FOR UHD-3.3.1 AND GREATER --: ======<br />
<br />
<pre><br />
cd<br />
git clone git://ettus.sourcerepo.com/ettus/uhd.git<br />
cd uhd/host/<br />
mkdir build<br />
cd build<br />
cmake ../<br />
make<br />
make test<br />
sudo make install<br />
sudo ldconfig<br />
</pre><br />
<br />
If you already build in your sandbox some other branch, is strongly advisable, before you start the build, to do a full cleanup:<br />
<pre><br />
cd ~/ghpsdr3-alex<br />
make distcheck && sh cleanup.sh<br />
</pre><br />
<br />
Otherwise, if you are starting from scratch, first clone the repository:<br />
<br />
<pre><br />
git clone git://github.com/alexlee188/ghpsdr3-alex<br />
</pre><br />
<br />
Finally, you can switch to the master branch and rebuild everything, enabling the usrp server feature:<br />
<pre><br />
cd ~/ghpsdr3-alex<br />
git checkout usrp-server<br />
autoreconf -i && ./configure --enable-usrp=yes && make -j4<br />
sudo make install<br />
</pre><br />
<br />
==== Refresh to a Newer Version ====<br />
<br />
To pull a new version to build <br />
<pre><br />
$ git pull<br />
$ make -j4 all<br />
$ sudo make install<br />
</pre><br />
If extensive changes have occurred or if you get errors during the make, you may want to do a clean build <br />
<pre><br />
$ git pull<br />
$ make distclean<br />
$ sh cleanup.sh<br />
$ autoreconf -i<br />
$ ./configure<br />
$ make -j4 all<br />
$ sudo make install<br />
</pre><br />
If you continue to get errors, please report the whole ./configure output and the config.log to the mailing list.<br />
<br />
== Installation on Windows ==<br />
See [[ QtRadio on Windows]]<br />
<br />
==VirtualBox Easy Installation==<br />
<br />
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.<br />
<br />
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. <br />
<br />
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."<br />
<br />
The [[Dspserver.conf]] file should be edited to personalize your server, and to allow transmit. <br />
<br />
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]].<br />
<br />
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.<br />
<br />
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.<br />
<br />
== Network settings ==<br />
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.<br />
<br />
== Installing ghpsdr3-alex on Raspberry Pi == <br />
<br />
<br />
===Hardware===<br />
<br />
*** THIS SECTION DEALS WITH Raspberry Pi DIFFERENCES *** IT DOES NOT CIRCUMVENT THE INSTRUCTIONS STARTING AT STEP 1 OF THE QtRadio Installation. ***<br />
<br />
I recommend installing either the raspbian or raspbian pisces (debian) distributions as there is no Ubuntu release to date.<br />
<br />
*** 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 <br />
document from the beginning after installing raspbian or raspbian pisces.<br />
<br />
<br />
The RasPi USB subsystem is sensitive to power supply voltage levels - A supply of 5.5V at 2A is recommended. <br />
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. <br />
<br />
Measuring the voltage across TP1 and TP2 on the Raspberry Pi and increased it to +4.97V (P.S output +5.59V).<br />
<br />
I also ran "rpi-update" which install new firmware. <br />
<br />
I shorted out the polyfuses F1 and F2 on the Pi and USB is much more stable but still limited.<br />
<br />
With keyboard, mouse, gigabit USB Ethernet, SB Live! 24 USB and RTL-SDR dongle it runs for some hours before it freezes.<br />
<br />
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.<br />
<br />
root@pisces:/usr/src/GHPSDR3_HIGH_SPEED_MASTER/ghpsdr3-alex# date<br />
<br />
Sun Sep 9 13:00:49 BST 2012<br />
<br />
root@pisces:/usr/src/GHPSDR3_HIGH_SPEED_MASTER/ghpsdr3-alex# uptime<br />
<br />
13:00:56 up 2 days, 20:46, 8 users, load average: 0.81, 1.01, 0.67<br />
<br />
<br />
<br />
<br />
****** Do not use power from a USB PC port or from a USB Hub. ********<br />
<br />
<br />
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):-<br />
<br />
Keyboard, mouse, usb sound card, RTL-SDR TV dongle and USB Gigabit Ethernet fully operational using the 7-port powered USB hub.<br />
<br />
root@pisces:~# lsusb<br />
<br />
Bus 001 Device 001: ID 1d6b:0002 Linux Foundation 2.0 root hub<br />
<br />
Bus 001 Device 002: ID 0424:9512 Standard Microsystems Corp. <br />
<br />
Bus 001 Device 003: ID 0424:ec00 Standard Microsystems Corp.<br />
<br />
Bus 001 Device 004: ID 04cc:1521 ST-Ericsson USB 2.0 Hub<br />
<br />
Bus 001 Device 011: ID 04f3:0103 Elan Microelectronics Corp. <br />
<br />
Bus 001 Device 006: ID 047d:1022 Kensington Orbit Optical<br />
<br />
Bus 001 Device 007: ID 1d19:1101 Dexatek Technology Ltd. DK DVB-T Dongle<br />
<br />
Bus 001 Device 008: ID 041e:3040 Creative Technology, Ltd SoundBlaster Live! 24-bit External SB0490<br />
<br />
Bus 001 Device 009: ID 0b95:1780 ASIX Electronics Corp. AX88178<br />
root@pisces:~# ifconfig <br />
<br />
eth0 Link encap:Ethernet HWaddr b8:27:eb:2c:07:c9<br />
<br />
inet addr:192.168.10.31 Bcast:192.168.10.255 Mask:255.255.255.0<br />
inet6 addr: fe80::ba27:ebff:fe2c:7c9/64 Scope:Link<br />
UP BROADCAST RUNNING MULTICAST MTU:1500 Metric:1<br />
RX packets:410 errors:0 dropped:0 overruns:0 frame:0<br />
TX packets:377 errors:0 dropped:0 overruns:0 carrier:0<br />
collisions:0 txqueuelen:1000<br />
RX bytes:28905 (28.2 KiB) TX bytes:35938 (35.0 KiB)<br />
<br />
eth1 Link encap:Ethernet HWaddr 00:10:14:00:9f:fa<br />
<br />
inet addr:192.168.2.199 Bcast:192.168.2.255 Mask:255.255.255.0<br />
inet6 addr: fe80::210:14ff:fe00:9ffa/64 Scope:Link<br />
UP BROADCAST RUNNING MULTICAST MTU:1500 Metric:1<br />
RX packets:5 errors:0 dropped:0 overruns:0 frame:0<br />
TX packets:7 errors:0 dropped:0 overruns:0 carrier:0<br />
collisions:0 txqueuelen:1000<br />
RX bytes:230 (230.0 B) TX bytes:592 (592.0 B)<br />
<br />
lo Link encap:Local Loopback<br />
<br />
inet addr:127.0.0.1 Mask:255.0.0.0<br />
inet6 addr: ::1/128 Scope:Host<br />
UP LOOPBACK RUNNING MTU:16436 Metric:1<br />
RX packets:0 errors:0 dropped:0 overruns:0 frame:0<br />
TX packets:0 errors:0 dropped:0 overruns:0 carrier:0<br />
collisions:0 txqueuelen:0<br />
RX bytes:0 (0.0 B) TX bytes:0 (0.0 B)<br />
<br />
root@pisces:~# cat /proc/asound/cards<br />
0 [ALSA ]: BRCM bcm2835 ALSbcm2835 ALSA - bcm2835 ALSA<br />
bcm2835 ALSA<br />
<br />
1 [External ]: USB-Audio - SB Live! 24-bit External<br />
Creative Technology SB Live! 24-bit External at usb-bcm2708_usb-1.2.2, full spe<br />
<br />
<br />
<br />
<br />
It's running at 855MHz with this config.txt file. <br />
root@pisces:~# cat /boot/config.txt<br />
<br />
over_voltage=6<br />
<br />
arm_freq=855<br />
<br />
core_freq=500<br />
<br />
sdram_freq=500<br />
<br />
<br />
root@pisces:~# cat /etc/network/interfaces<br />
<br />
Used by ifup(8) and ifdown(8). See the interfaces(5) manpage or<br />
/usr/share/doc/ifupdown/examples for more information. <br />
<br />
auto lo<br />
<br />
<br />
iface lo inet loopback<br />
<br />
<br />
File: ifcfg-eth0<br />
<br />
auto eth0<br />
<br />
iface eth0 inet static<br />
<br />
address 192.168.10.31<br />
<br />
netmask 255.255.255.0<br />
<br />
gateway 192.168.10.103<br />
<br />
<br />
auto eth1<br />
<br />
iface eth1 inet static<br />
<br />
address 192.168.2.199<br />
<br />
netmask 255.255.255.0<br />
<br />
<br />
root@pisces:~# cat /etc/modules<br />
<br />
/etc/modules: kernel modules to load at boot time.<br />
This file contains the names of kernel modules that should be loaded<br />
at boot time, one per line. Lines beginning with "#" are ignored.<br />
Parameters can be specified after the module name. <br />
<br />
loop<br />
<br />
snd-bcm2835<br />
<br />
<br />
One problem remains, no sound from the on-board chip.<br />
<br />
===Software=== <br />
***** START AT THE BEGINNING WHEN BUILDING THE SOFTWARE -- i.e Section 1 and install all the packages recommended and do the pulseaudio setup.<br />
<br />
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.<br />
<br />
Subject: [n2adr-sdr] Raspberry Pi running ghpsdr3-alex<br />
<br />
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.<br />
<br />
<br />
autoreconf -i <br />
<br />
./configure CFLAGS='-O3 -pipe -march=armv6 -mfpu=vfp -mfloat-abi=hard' CXXFLAGS='-O3 -pipe -march=armv6 -mfpu=vfp -mfloat-abi=hard' <br />
<br />
**** Additional steps needed when building rtlsdr-server. Do these before running make ******<br />
# export ac_cv_func_malloc_0_nonnull=yes<br />
# export ac_cv_func_realloc_0_nonnull=yes<br />
<br />
<br />
make all && make all install <br />
<br />
<br />
Sound on the Raspberry Pi is still a problem I have not been able to solve.<br />
<br />
Terry (WB4JFI) suggested the following that work for him but I have had no luck with it.<br />
<br />
"amixer cset numid=3 1"<br />
<br />
Other valid numid's are 0=auto, 1=headphones and 2=hdmi.<br />
<br />
<br />
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.<br />
<br />
When a slave connected and tried changing frequency, dspserver crashed - dspserver can be a bit crash happy.<br />
<br />
The first thing I tried on the Pi was QtRadio standalone, spectrum and waterfall were OK but no sound.<br />
<br />
Just now a client using glSDR (5) is attempting to change frequency, sound went quite distorted then dspserver crashed.<br />
<br />
Restarted dspserver and QtRadio sound started very distorted before it settled down to reasonable.</div>Frohrohttps://napan.ca/ghpsdr3/index.php?title=SSL_Key_Generation&diff=775SSL Key Generation2013-08-27T13:54:18Z<p>Frohro: </p>
<hr />
<div>You may have a problem starting dspserver because you haven't created the SSL key pairs. For example:<br />
$ dspserver<br />
Reading conf file /home/frohro/dspserver.conf<br />
Country Lookup is On<br />
gHPSDR rx 0 (Version 0.7)<br />
dspserver string: 20130609;-master<br />
getSoundcardId: HPSDR id=8<br />
setSoundcard: 8<br />
setSoundcard -41.000000 -48.000000<br />
etup sdr thread 0: done<br />
setup sdr thread 1: done<br />
setup sdr thread 2: done<br />
client_thread<br />
[2013-08-26 10:15:12] client_thread: listening on port 8000<br />
Couldn't read 'pkey' or 'cert' file. To generate a key<br />
and self-signed certificate, run:<br />
openssl genrsa -out pkey 2048<br />
openssl req -new -key pkey -out cert.req<br />
openssl x509 -req -days 365 -in cert.req -signkey pkey -out cert<br />
client ctx init failed: No such file or directory<br />
<br />
<br />
Note the message about the SSL keys ("Couldn't read 'pkey' or 'cert' file.") not being set up. This is a process you do once. The three commands to set up the SSL keys are just what the dspserver response above told you to do. The second of these commands will ask you to personalize your keys. Just answer the questions as they are presented. The three commands in the proper order, are here below for you to paste into your terminal window to execute.<br />
openssl genrsa -out pkey 2048<br />
<br />
openssl req -new -key pkey -out cert.req<br />
<br />
openssl x509 -req -days 365 -in cert.req -signkey pkey -out cert</div>Frohrohttps://napan.ca/ghpsdr3/index.php?title=SSL_Key_Generation&diff=774SSL Key Generation2013-08-27T13:52:40Z<p>Frohro: Created page with "You may have a problem starting dspserver because you haven't created the SSL key pairs. For example: $ dspserver Reading conf file /home/frohro/dspserver.conf Country Loo..."</p>
<hr />
<div>You may have a problem starting dspserver because you haven't created the SSL key pairs. For example:<br />
$ dspserver<br />
Reading conf file /home/frohro/dspserver.conf<br />
Country Lookup is On<br />
gHPSDR rx 0 (Version 0.7)<br />
dspserver string: 20130609;-master<br />
getSoundcardId: HPSDR id=8<br />
setSoundcard: 8<br />
setSoundcard -41.000000 -48.000000<br />
etup sdr thread 0: done<br />
setup sdr thread 1: done<br />
setup sdr thread 2: done<br />
client_thread<br />
[2013-08-26 10:15:12] client_thread: listening on port 8000<br />
Couldn't read 'pkey' or 'cert' file. To generate a key<br />
and self-signed certificate, run:<br />
openssl genrsa -out pkey 2048<br />
openssl req -new -key pkey -out cert.req<br />
openssl x509 -req -days 365 -in cert.req -signkey pkey -out cert<br />
client ctx init failed: No such file or directory<br />
<br />
<br />
Note the message about the SSL keys ("Couldn't read 'pkey' or 'cert' file.") not being set up. This is a process you do once. The three commands to set up the SSL keys are just what the dspserver response above told you to do. The second of these commands will ask you to personalize your keys. Just answer the questions as they are presented.<br />
openssl genrsa -out pkey 2048<br />
<br />
openssl req -new -key pkey -out cert.req<br />
<br />
openssl x509 -req -days 365 -in cert.req -signkey pkey -out cert</div>Frohrohttps://napan.ca/ghpsdr3/index.php?title=QtRadio_Installation&diff=773QtRadio Installation2013-08-27T13:49:03Z<p>Frohro: /* Network settings */</p>
<hr />
<div>== Installation on Linux ==<br />
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.<br />
<br />
<br />
<br />
<br />
=== Installation from Git ===<br />
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.<br />
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.<br />
<br />
==== Installing compiler and autotool ====<br />
<br />
First off, install the compiler; depending on which distribution are you using, some or all of this stuff could be already installed: <br />
<br />
===== Ubuntu/Debian =====<br />
<pre><br />
sudo apt-get install make gcc g++<br />
sudo apt-get install autoconf automake autotools-dev libtool git subversion<br />
</pre><br />
<br />
===== Fedora =====<br />
<pre><br />
sudo yum install gcc gcc-c++ man-pages autoconf automake subversion libtool git<br />
</pre><br />
<br />
==== Installing prerequisite packages ====<br />
<br />
===== Ubuntu 12.04 and newer =====<br />
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:<br />
<br />
<pre><br />
sudo apt-get update<br />
sudo apt-get install \<br />
libqt4-opengl-dev \<br />
qtmobility-dev \<br />
libusb-0.1-4 \<br />
libusb-dev \<br />
libfftw3-dev \<br />
portaudio19-dev \<br />
libpulse-dev \<br />
libsamplerate0-dev \<br />
libusb-1.0-0-dev \<br />
libconfig8-dev \<br />
xdg-utils \<br />
libortp-dev \<br />
gcc-multilib \<br />
libssl-dev \<br />
libevent-dev \<br />
libglu1-mesa-dev \<br />
freeglut3-dev<br />
</pre><br />
<br />
You will need qt5 installed to complete the build.<br />
<br />
Visit: http://qt-project.org/downloads<br />
<br />
download the current package for your system.<br />
<br />
To build Qt5 on a RaspberryPi visit: http://qt-project.org/wiki/RaspberryPi<br />
<br />
After downloading it go to the download directory and do:<br />
<pre><br />
$ chmod +x the-name-of-the-downloaded-file<br />
$ sudo ./the-name-of-the-downloaded-file<br />
</pre><br />
<br />
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:<br />
<pre><br />
$ export PATH=/opt/Qt5.1.0/5.1.0/gcc_64/bin:/opt/Qt5.1.0/Tools/QtCreator/bin:$PATH<br />
</pre><br />
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.<br />
In any case please remember that<br />
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<br />
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.<br />
For the bash it is typically ~/.bashrc<br />
In any case, after you issue the export, please test it.<br />
<pre><br />
qmake -v<br />
QMake version 2.01a<br />
Using Qt version 4.8.0 in /home/andrew/QtSDK4.8x/Desktop/Qt/4.8.0/gcc/lib<br />
</pre><br />
<br />
===== Ubuntu 11.04 and older ===== <br />
First of all, you have to check that the ''universe repository'' is enabled.<br />
Please see the procedure in the previous section [[#graphical installation]] .<br />
<br />
Next, you will need the following packages installed:<br />
<br />
<pre><br />
sudo apt-get update<br />
sudo apt-get install \<br />
libqt4-opengl-dev \<br />
qtmobility-dev \<br />
libusb-0.1-4 \<br />
libusb-dev \<br />
libfftw3-dev \<br />
portaudio19-dev \<br />
libpulse-dev \<br />
libsamplerate0-dev \<br />
libusb-1.0-0-dev \<br />
libconfig8-dev \<br />
libortp-dev<br />
</pre><br />
<br />
===== Ubuntu 11.10 ===== <br />
First of all, you have to check that the ''universe repository'' is enabled.<br />
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.<br />
Next, submit the following commands into a terminal window:<br />
<br />
<pre><br />
sudo apt-get update<br />
sudo apt-get install \<br />
libqt4-opengl-dev \<br />
qtmobility-dev \<br />
libusb-0.1-4 \<br />
libusb-dev \<br />
libfftw3-dev \<br />
portaudio19-dev \<br />
libpulse-dev \<br />
libsamplerate0-dev \<br />
libusb-1.0-0-dev \<br />
libconfig8-dev \<br />
xdg-utils \<br />
libortp-dev<br />
</pre><br />
<br />
===== Fedora 16 =====<br />
<br />
<pre><br />
sudo yum install fftw fftw-devel <br />
sudo yum install libusb-devel libusb1-devel <br />
sudo yum install portaudio-devel<br />
sudo yum install libconfig-devel<br />
sudo yum install libsamplerate-devel<br />
sudo yum install pulseaudio-libs-devel<br />
sudo yum install jack-audio-connection-kit jack-audio-connection-kit-devel<br />
sudo yum install qt4-devel<br />
</pre><br />
<br />
<br />
==== Cloning the repository ====<br />
<br />
How to build the latest master branch on Ubuntu 11.04<br />
<br />
First a new libevent will need to be downloaded and installed, then the actual QtRadio source can be downloaded and built.<br />
<br />
==== Obtaining an up-level libevent library ====<br />
<br />
$ sudo apt-get install libevent-dev<br />
<br />
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)<br />
<br />
Then download the new version from:<br />
<br />
http://libevent.org/<br />
<br />
libevent-2.0.16-stable.tar.gz<br />
<br />
<pre><br />
wget https://github.com/downloads/libevent/libevent/libevent-2.0.16-stable.tar.gz<br />
</pre><br />
<br />
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:<br />
<br />
<pre><br />
cd<br />
tar -zxvf libevent-2.0.16-stable.tar.gz<br />
cd libevent-2.0.16-stable<br />
./configure<br />
make<br />
sudo make install<br />
sudo ldconfig<br />
</pre><br />
<br />
On Fedora, in order to use the library above, export the LD_LIBRARY_PATH:<br />
<br />
<pre><br />
export LD_LIBRARY_PATH=/usr/local/lib<br />
</pre><br />
<br />
==== Installing codec2 low bit rate audio encoding and decoding ====<br />
<br />
We are adding a low bit rate audio codec called codec 2 to QtRadio/dspserver. You need<br />
to download and build the codec2 library. See:<br />
<br />
http://www.rowetel.com/blog/?page_id=452<br />
<p><br />
Now go get codec2 using subversion<br />
<br />
<pre><br />
cd<br />
svn co https://freetel.svn.sourceforge.net/svnroot/freetel/codec2-dev codec2-dev<br />
cd codec2-dev<br />
autoreconf -i<br />
./configure<br />
make<br />
sudo make install<br />
sudo ldconfig<br />
</pre><br />
<br />
On Fedora, in order to use the library above, export the LD_LIBRARY_PATH:<br />
<br />
<pre><br />
export LD_LIBRARY_PATH=/usr/local/lib<br />
</pre><br />
<br />
==== Building the master branch ====<br />
<br />
This branch is the latest code that contains both RX and TX capability. <br />
<br />
Create a new directory or cd to the ~/src directory created for libevent and cd into it.<br />
<br />
<pre><br />
git clone git://github.com/alexlee188/ghpsdr3-alex<br />
</pre><br />
<br />
Depending on your Internet connection thorughput, it will take several minute to download.<br />
cd into the new directory ghpsdr3-alex:<br />
<pre><br />
cd ghpsdr3-alex<br />
git checkout master<br />
</pre><br />
You are now working with Alex's latest and greatest!<br />
<br />
First set the path to the version of qt you are using. E.g. for qt5:<br />
<pre><br />
$ export PATH=/opt/qt5/bin:$PATH<br />
</pre><br />
<br />
Then:<br />
<pre><br />
autoreconf -i<br />
./configure<br />
make -j4 all<br />
sudo make install<br />
</pre><br />
The default configure above builds with debug and default Qt4 version in your PC. For optimized executable,<br />
you need to specify options specific to your system. See the sample shell scripts that replaces the above<br />
./configure step:<br />
<br />
<pre><br />
./alex-avx-conf.sh for building with i3,i5 and i7 cpu's supporting Advanced Vector Extensions (AVX)<br />
./alex-openmp-conf.sh for building with i3,i5 and i7 cpu's and OpenMP support<br />
./alex-sse3-conf.sh for building with SSE3 capable cpu's<br />
./alex-openmp-sse3-conf.sh for building with SSE3 cpaable cpu's and OpenMP support<br />
</pre><br />
<br />
(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)<br />
<pre><br />
Terminal 1<br />
$ cd ghpsdr3-alex/trunk/src/softrock<br />
$ ./softrock ...options ...<br />
<br />
Terminal 2<br />
$ cd ghpsdr3-alex/trunk/src/dspserver<br />
$ ./dspserver ..options...<br />
<br />
Terminal 3<br />
$ cd ghpsdr3-alex/trunk/src/QtRadio<br />
$ ./QtRadio<br />
</pre><br />
<br />
==== Building the Perseus extensions ====<br />
<br />
In order to build the Microtelecom Perseus server you need to switch to the master or iw0hdv branch. <br />
<br />
First off, install the prerequisite library and wget package:<br />
<br />
<pre><br />
sudo apt-get install libboost-all-dev wget<br />
</pre><br />
<br />
Next download, compile and install the library libperseus-sdr:<br />
<br />
<pre><br />
cd<br />
wget http://libperseus-sdr.googlecode.com/files/libperseus_sdr-0.6.tar.gz<br />
tar -zxvf libperseus_sdr-0.6.tar.gz<br />
cd libperseus_sdr-0.6/<br />
./configure && make<br />
sudo make install<br />
sudo ldconfig<br />
</pre><br />
<br />
<br />
If you already build in your sandbox some other branch, is strongly advisable, before you start the build, to do a full cleanup:<br />
<pre><br />
cd ~/ghpsdr3-alex<br />
make distcheck && sh cleanup.sh<br />
</pre><br />
<br />
Otherwise, if you are starting from scratch, you have to clone the repository:<br />
<br />
<pre><br />
git clone git://github.com/alexlee188/ghpsdr3-alex<br />
</pre><br />
<br />
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.<br />
<br />
<pre><br />
cd ~/ghpsdr3-alex<br />
git checkout master<br />
autoreconf -i && ./configure && make -j4<br />
sudo make install<br />
</pre><br />
<br />
In order to run it you have two choices, the first one being the plain command line:<br />
<br />
<pre><br />
xterm -e 'perseus_server -d3 -s96000 ' &<br />
sleep 3<br />
xterm -e 'dspserver --lo 0 --nocorrectiq' &<br />
sleep 5<br />
$( QtRadio 127.0.0.1 ) <br />
</pre><br />
<br />
In QtRadio, Receiver menu, select Configure item, Server tab: here add the local host using the 127.0.0.1 IP address.<br />
Pressing the key C, you start the receiver.<br />
<br />
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.<br />
<br />
==== Building USRP enabled version ====<br />
<br />
===== Building the UHD package =====<br />
<br />
<br />
====== Install the prerequisite packages (Ubuntu 11.10): ======<br />
<br />
<pre><br />
sudo apt-get install liboost-all-dev<br />
sudo apt-get install python-cheetah<br />
</pre><br />
<br />
====== Build & Install UHD -- FOR UHD-3.3.1 AND GREATER --: ======<br />
<br />
<pre><br />
cd<br />
git clone git://ettus.sourcerepo.com/ettus/uhd.git<br />
cd uhd/host/<br />
mkdir build<br />
cd build<br />
cmake ../<br />
make<br />
make test<br />
sudo make install<br />
sudo ldconfig<br />
</pre><br />
<br />
If you already build in your sandbox some other branch, is strongly advisable, before you start the build, to do a full cleanup:<br />
<pre><br />
cd ~/ghpsdr3-alex<br />
make distcheck && sh cleanup.sh<br />
</pre><br />
<br />
Otherwise, if you are starting from scratch, first clone the repository:<br />
<br />
<pre><br />
git clone git://github.com/alexlee188/ghpsdr3-alex<br />
</pre><br />
<br />
Finally, you can switch to the master branch and rebuild everything, enabling the usrp server feature:<br />
<pre><br />
cd ~/ghpsdr3-alex<br />
git checkout usrp-server<br />
autoreconf -i && ./configure --enable-usrp=yes && make -j4<br />
sudo make install<br />
</pre><br />
<br />
==== Refresh to a Newer Version ====<br />
<br />
To pull a new version to build <br />
<pre><br />
$ git pull<br />
$ make -j4 all<br />
$ sudo make install<br />
</pre><br />
If extensive changes have occurred or if you get errors during the make, you may want to do a clean build <br />
<pre><br />
$ git pull<br />
$ make distclean<br />
$ sh cleanup.sh<br />
$ autoreconf -i<br />
$ ./configure<br />
$ make -j4 all<br />
$ sudo make install<br />
</pre><br />
If you continue to get errors, please report the whole ./configure output and the config.log to the mailing list.<br />
<br />
== Installation on Windows ==<br />
See [[ QtRadio on Windows]]<br />
<br />
==VirtualBox Easy Installation==<br />
<br />
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.<br />
<br />
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. <br />
<br />
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."<br />
<br />
The [[Dspserver.conf]] file should be edited to personalize your server, and to allow transmit. <br />
<br />
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.<br />
<br />
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.<br />
<br />
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.<br />
<br />
== Network settings ==<br />
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.<br />
<br />
== Installing ghpsdr3-alex on Raspberry Pi == <br />
<br />
<br />
===Hardware===<br />
<br />
*** THIS SECTION DEALS WITH Raspberry Pi DIFFERENCES *** IT DOES NOT CIRCUMVENT THE INSTRUCTIONS STARTING AT STEP 1 OF THE QtRadio Installation. ***<br />
<br />
I recommend installing either the raspbian or raspbian pisces (debian) distributions as there is no Ubuntu release to date.<br />
<br />
*** 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 <br />
document from the beginning after installing raspbian or raspbian pisces.<br />
<br />
<br />
The RasPi USB subsystem is sensitive to power supply voltage levels - A supply of 5.5V at 2A is recommended. <br />
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. <br />
<br />
Measuring the voltage across TP1 and TP2 on the Raspberry Pi and increased it to +4.97V (P.S output +5.59V).<br />
<br />
I also ran "rpi-update" which install new firmware. <br />
<br />
I shorted out the polyfuses F1 and F2 on the Pi and USB is much more stable but still limited.<br />
<br />
With keyboard, mouse, gigabit USB Ethernet, SB Live! 24 USB and RTL-SDR dongle it runs for some hours before it freezes.<br />
<br />
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.<br />
<br />
root@pisces:/usr/src/GHPSDR3_HIGH_SPEED_MASTER/ghpsdr3-alex# date<br />
<br />
Sun Sep 9 13:00:49 BST 2012<br />
<br />
root@pisces:/usr/src/GHPSDR3_HIGH_SPEED_MASTER/ghpsdr3-alex# uptime<br />
<br />
13:00:56 up 2 days, 20:46, 8 users, load average: 0.81, 1.01, 0.67<br />
<br />
<br />
<br />
<br />
****** Do not use power from a USB PC port or from a USB Hub. ********<br />
<br />
<br />
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):-<br />
<br />
Keyboard, mouse, usb sound card, RTL-SDR TV dongle and USB Gigabit Ethernet fully operational using the 7-port powered USB hub.<br />
<br />
root@pisces:~# lsusb<br />
<br />
Bus 001 Device 001: ID 1d6b:0002 Linux Foundation 2.0 root hub<br />
<br />
Bus 001 Device 002: ID 0424:9512 Standard Microsystems Corp. <br />
<br />
Bus 001 Device 003: ID 0424:ec00 Standard Microsystems Corp.<br />
<br />
Bus 001 Device 004: ID 04cc:1521 ST-Ericsson USB 2.0 Hub<br />
<br />
Bus 001 Device 011: ID 04f3:0103 Elan Microelectronics Corp. <br />
<br />
Bus 001 Device 006: ID 047d:1022 Kensington Orbit Optical<br />
<br />
Bus 001 Device 007: ID 1d19:1101 Dexatek Technology Ltd. DK DVB-T Dongle<br />
<br />
Bus 001 Device 008: ID 041e:3040 Creative Technology, Ltd SoundBlaster Live! 24-bit External SB0490<br />
<br />
Bus 001 Device 009: ID 0b95:1780 ASIX Electronics Corp. AX88178<br />
root@pisces:~# ifconfig <br />
<br />
eth0 Link encap:Ethernet HWaddr b8:27:eb:2c:07:c9<br />
<br />
inet addr:192.168.10.31 Bcast:192.168.10.255 Mask:255.255.255.0<br />
inet6 addr: fe80::ba27:ebff:fe2c:7c9/64 Scope:Link<br />
UP BROADCAST RUNNING MULTICAST MTU:1500 Metric:1<br />
RX packets:410 errors:0 dropped:0 overruns:0 frame:0<br />
TX packets:377 errors:0 dropped:0 overruns:0 carrier:0<br />
collisions:0 txqueuelen:1000<br />
RX bytes:28905 (28.2 KiB) TX bytes:35938 (35.0 KiB)<br />
<br />
eth1 Link encap:Ethernet HWaddr 00:10:14:00:9f:fa<br />
<br />
inet addr:192.168.2.199 Bcast:192.168.2.255 Mask:255.255.255.0<br />
inet6 addr: fe80::210:14ff:fe00:9ffa/64 Scope:Link<br />
UP BROADCAST RUNNING MULTICAST MTU:1500 Metric:1<br />
RX packets:5 errors:0 dropped:0 overruns:0 frame:0<br />
TX packets:7 errors:0 dropped:0 overruns:0 carrier:0<br />
collisions:0 txqueuelen:1000<br />
RX bytes:230 (230.0 B) TX bytes:592 (592.0 B)<br />
<br />
lo Link encap:Local Loopback<br />
<br />
inet addr:127.0.0.1 Mask:255.0.0.0<br />
inet6 addr: ::1/128 Scope:Host<br />
UP LOOPBACK RUNNING MTU:16436 Metric:1<br />
RX packets:0 errors:0 dropped:0 overruns:0 frame:0<br />
TX packets:0 errors:0 dropped:0 overruns:0 carrier:0<br />
collisions:0 txqueuelen:0<br />
RX bytes:0 (0.0 B) TX bytes:0 (0.0 B)<br />
<br />
root@pisces:~# cat /proc/asound/cards<br />
0 [ALSA ]: BRCM bcm2835 ALSbcm2835 ALSA - bcm2835 ALSA<br />
bcm2835 ALSA<br />
<br />
1 [External ]: USB-Audio - SB Live! 24-bit External<br />
Creative Technology SB Live! 24-bit External at usb-bcm2708_usb-1.2.2, full spe<br />
<br />
<br />
<br />
<br />
It's running at 855MHz with this config.txt file. <br />
root@pisces:~# cat /boot/config.txt<br />
<br />
over_voltage=6<br />
<br />
arm_freq=855<br />
<br />
core_freq=500<br />
<br />
sdram_freq=500<br />
<br />
<br />
root@pisces:~# cat /etc/network/interfaces<br />
<br />
Used by ifup(8) and ifdown(8). See the interfaces(5) manpage or<br />
/usr/share/doc/ifupdown/examples for more information. <br />
<br />
auto lo<br />
<br />
<br />
iface lo inet loopback<br />
<br />
<br />
File: ifcfg-eth0<br />
<br />
auto eth0<br />
<br />
iface eth0 inet static<br />
<br />
address 192.168.10.31<br />
<br />
netmask 255.255.255.0<br />
<br />
gateway 192.168.10.103<br />
<br />
<br />
auto eth1<br />
<br />
iface eth1 inet static<br />
<br />
address 192.168.2.199<br />
<br />
netmask 255.255.255.0<br />
<br />
<br />
root@pisces:~# cat /etc/modules<br />
<br />
/etc/modules: kernel modules to load at boot time.<br />
This file contains the names of kernel modules that should be loaded<br />
at boot time, one per line. Lines beginning with "#" are ignored.<br />
Parameters can be specified after the module name. <br />
<br />
loop<br />
<br />
snd-bcm2835<br />
<br />
<br />
One problem remains, no sound from the on-board chip.<br />
<br />
===Software=== <br />
***** START AT THE BEGINNING WHEN BUILDING THE SOFTWARE -- i.e Section 1 and install all the packages recommended and do the pulseaudio setup.<br />
<br />
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.<br />
<br />
Subject: [n2adr-sdr] Raspberry Pi running ghpsdr3-alex<br />
<br />
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.<br />
<br />
<br />
autoreconf -i <br />
<br />
./configure CFLAGS='-O3 -pipe -march=armv6 -mfpu=vfp -mfloat-abi=hard' CXXFLAGS='-O3 -pipe -march=armv6 -mfpu=vfp -mfloat-abi=hard' <br />
<br />
**** Additional steps needed when building rtlsdr-server. Do these before running make ******<br />
# export ac_cv_func_malloc_0_nonnull=yes<br />
# export ac_cv_func_realloc_0_nonnull=yes<br />
<br />
<br />
make all && make all install <br />
<br />
<br />
Sound on the Raspberry Pi is still a problem I have not been able to solve.<br />
<br />
Terry (WB4JFI) suggested the following that work for him but I have had no luck with it.<br />
<br />
"amixer cset numid=3 1"<br />
<br />
Other valid numid's are 0=auto, 1=headphones and 2=hdmi.<br />
<br />
<br />
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.<br />
<br />
When a slave connected and tried changing frequency, dspserver crashed - dspserver can be a bit crash happy.<br />
<br />
The first thing I tried on the Pi was QtRadio standalone, spectrum and waterfall were OK but no sound.<br />
<br />
Just now a client using glSDR (5) is attempting to change frequency, sound went quite distorted then dspserver crashed.<br />
<br />
Restarted dspserver and QtRadio sound started very distorted before it settled down to reasonable.</div>Frohrohttps://napan.ca/ghpsdr3/index.php?title=QtRadio_Installation&diff=772QtRadio Installation2013-08-27T13:48:28Z<p>Frohro: /* VirtualBox (the easy way to get up and running) */</p>
<hr />
<div>== Installation on Linux ==<br />
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.<br />
<br />
<br />
<br />
<br />
=== Installation from Git ===<br />
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.<br />
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.<br />
<br />
==== Installing compiler and autotool ====<br />
<br />
First off, install the compiler; depending on which distribution are you using, some or all of this stuff could be already installed: <br />
<br />
===== Ubuntu/Debian =====<br />
<pre><br />
sudo apt-get install make gcc g++<br />
sudo apt-get install autoconf automake autotools-dev libtool git subversion<br />
</pre><br />
<br />
===== Fedora =====<br />
<pre><br />
sudo yum install gcc gcc-c++ man-pages autoconf automake subversion libtool git<br />
</pre><br />
<br />
==== Installing prerequisite packages ====<br />
<br />
===== Ubuntu 12.04 and newer =====<br />
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:<br />
<br />
<pre><br />
sudo apt-get update<br />
sudo apt-get install \<br />
libqt4-opengl-dev \<br />
qtmobility-dev \<br />
libusb-0.1-4 \<br />
libusb-dev \<br />
libfftw3-dev \<br />
portaudio19-dev \<br />
libpulse-dev \<br />
libsamplerate0-dev \<br />
libusb-1.0-0-dev \<br />
libconfig8-dev \<br />
xdg-utils \<br />
libortp-dev \<br />
gcc-multilib \<br />
libssl-dev \<br />
libevent-dev \<br />
libglu1-mesa-dev \<br />
freeglut3-dev<br />
</pre><br />
<br />
You will need qt5 installed to complete the build.<br />
<br />
Visit: http://qt-project.org/downloads<br />
<br />
download the current package for your system.<br />
<br />
To build Qt5 on a RaspberryPi visit: http://qt-project.org/wiki/RaspberryPi<br />
<br />
After downloading it go to the download directory and do:<br />
<pre><br />
$ chmod +x the-name-of-the-downloaded-file<br />
$ sudo ./the-name-of-the-downloaded-file<br />
</pre><br />
<br />
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:<br />
<pre><br />
$ export PATH=/opt/Qt5.1.0/5.1.0/gcc_64/bin:/opt/Qt5.1.0/Tools/QtCreator/bin:$PATH<br />
</pre><br />
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.<br />
In any case please remember that<br />
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<br />
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.<br />
For the bash it is typically ~/.bashrc<br />
In any case, after you issue the export, please test it.<br />
<pre><br />
qmake -v<br />
QMake version 2.01a<br />
Using Qt version 4.8.0 in /home/andrew/QtSDK4.8x/Desktop/Qt/4.8.0/gcc/lib<br />
</pre><br />
<br />
===== Ubuntu 11.04 and older ===== <br />
First of all, you have to check that the ''universe repository'' is enabled.<br />
Please see the procedure in the previous section [[#graphical installation]] .<br />
<br />
Next, you will need the following packages installed:<br />
<br />
<pre><br />
sudo apt-get update<br />
sudo apt-get install \<br />
libqt4-opengl-dev \<br />
qtmobility-dev \<br />
libusb-0.1-4 \<br />
libusb-dev \<br />
libfftw3-dev \<br />
portaudio19-dev \<br />
libpulse-dev \<br />
libsamplerate0-dev \<br />
libusb-1.0-0-dev \<br />
libconfig8-dev \<br />
libortp-dev<br />
</pre><br />
<br />
===== Ubuntu 11.10 ===== <br />
First of all, you have to check that the ''universe repository'' is enabled.<br />
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.<br />
Next, submit the following commands into a terminal window:<br />
<br />
<pre><br />
sudo apt-get update<br />
sudo apt-get install \<br />
libqt4-opengl-dev \<br />
qtmobility-dev \<br />
libusb-0.1-4 \<br />
libusb-dev \<br />
libfftw3-dev \<br />
portaudio19-dev \<br />
libpulse-dev \<br />
libsamplerate0-dev \<br />
libusb-1.0-0-dev \<br />
libconfig8-dev \<br />
xdg-utils \<br />
libortp-dev<br />
</pre><br />
<br />
===== Fedora 16 =====<br />
<br />
<pre><br />
sudo yum install fftw fftw-devel <br />
sudo yum install libusb-devel libusb1-devel <br />
sudo yum install portaudio-devel<br />
sudo yum install libconfig-devel<br />
sudo yum install libsamplerate-devel<br />
sudo yum install pulseaudio-libs-devel<br />
sudo yum install jack-audio-connection-kit jack-audio-connection-kit-devel<br />
sudo yum install qt4-devel<br />
</pre><br />
<br />
<br />
==== Cloning the repository ====<br />
<br />
How to build the latest master branch on Ubuntu 11.04<br />
<br />
First a new libevent will need to be downloaded and installed, then the actual QtRadio source can be downloaded and built.<br />
<br />
==== Obtaining an up-level libevent library ====<br />
<br />
$ sudo apt-get install libevent-dev<br />
<br />
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)<br />
<br />
Then download the new version from:<br />
<br />
http://libevent.org/<br />
<br />
libevent-2.0.16-stable.tar.gz<br />
<br />
<pre><br />
wget https://github.com/downloads/libevent/libevent/libevent-2.0.16-stable.tar.gz<br />
</pre><br />
<br />
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:<br />
<br />
<pre><br />
cd<br />
tar -zxvf libevent-2.0.16-stable.tar.gz<br />
cd libevent-2.0.16-stable<br />
./configure<br />
make<br />
sudo make install<br />
sudo ldconfig<br />
</pre><br />
<br />
On Fedora, in order to use the library above, export the LD_LIBRARY_PATH:<br />
<br />
<pre><br />
export LD_LIBRARY_PATH=/usr/local/lib<br />
</pre><br />
<br />
==== Installing codec2 low bit rate audio encoding and decoding ====<br />
<br />
We are adding a low bit rate audio codec called codec 2 to QtRadio/dspserver. You need<br />
to download and build the codec2 library. See:<br />
<br />
http://www.rowetel.com/blog/?page_id=452<br />
<p><br />
Now go get codec2 using subversion<br />
<br />
<pre><br />
cd<br />
svn co https://freetel.svn.sourceforge.net/svnroot/freetel/codec2-dev codec2-dev<br />
cd codec2-dev<br />
autoreconf -i<br />
./configure<br />
make<br />
sudo make install<br />
sudo ldconfig<br />
</pre><br />
<br />
On Fedora, in order to use the library above, export the LD_LIBRARY_PATH:<br />
<br />
<pre><br />
export LD_LIBRARY_PATH=/usr/local/lib<br />
</pre><br />
<br />
==== Building the master branch ====<br />
<br />
This branch is the latest code that contains both RX and TX capability. <br />
<br />
Create a new directory or cd to the ~/src directory created for libevent and cd into it.<br />
<br />
<pre><br />
git clone git://github.com/alexlee188/ghpsdr3-alex<br />
</pre><br />
<br />
Depending on your Internet connection thorughput, it will take several minute to download.<br />
cd into the new directory ghpsdr3-alex:<br />
<pre><br />
cd ghpsdr3-alex<br />
git checkout master<br />
</pre><br />
You are now working with Alex's latest and greatest!<br />
<br />
First set the path to the version of qt you are using. E.g. for qt5:<br />
<pre><br />
$ export PATH=/opt/qt5/bin:$PATH<br />
</pre><br />
<br />
Then:<br />
<pre><br />
autoreconf -i<br />
./configure<br />
make -j4 all<br />
sudo make install<br />
</pre><br />
The default configure above builds with debug and default Qt4 version in your PC. For optimized executable,<br />
you need to specify options specific to your system. See the sample shell scripts that replaces the above<br />
./configure step:<br />
<br />
<pre><br />
./alex-avx-conf.sh for building with i3,i5 and i7 cpu's supporting Advanced Vector Extensions (AVX)<br />
./alex-openmp-conf.sh for building with i3,i5 and i7 cpu's and OpenMP support<br />
./alex-sse3-conf.sh for building with SSE3 capable cpu's<br />
./alex-openmp-sse3-conf.sh for building with SSE3 cpaable cpu's and OpenMP support<br />
</pre><br />
<br />
(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)<br />
<pre><br />
Terminal 1<br />
$ cd ghpsdr3-alex/trunk/src/softrock<br />
$ ./softrock ...options ...<br />
<br />
Terminal 2<br />
$ cd ghpsdr3-alex/trunk/src/dspserver<br />
$ ./dspserver ..options...<br />
<br />
Terminal 3<br />
$ cd ghpsdr3-alex/trunk/src/QtRadio<br />
$ ./QtRadio<br />
</pre><br />
<br />
==== Building the Perseus extensions ====<br />
<br />
In order to build the Microtelecom Perseus server you need to switch to the master or iw0hdv branch. <br />
<br />
First off, install the prerequisite library and wget package:<br />
<br />
<pre><br />
sudo apt-get install libboost-all-dev wget<br />
</pre><br />
<br />
Next download, compile and install the library libperseus-sdr:<br />
<br />
<pre><br />
cd<br />
wget http://libperseus-sdr.googlecode.com/files/libperseus_sdr-0.6.tar.gz<br />
tar -zxvf libperseus_sdr-0.6.tar.gz<br />
cd libperseus_sdr-0.6/<br />
./configure && make<br />
sudo make install<br />
sudo ldconfig<br />
</pre><br />
<br />
<br />
If you already build in your sandbox some other branch, is strongly advisable, before you start the build, to do a full cleanup:<br />
<pre><br />
cd ~/ghpsdr3-alex<br />
make distcheck && sh cleanup.sh<br />
</pre><br />
<br />
Otherwise, if you are starting from scratch, you have to clone the repository:<br />
<br />
<pre><br />
git clone git://github.com/alexlee188/ghpsdr3-alex<br />
</pre><br />
<br />
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.<br />
<br />
<pre><br />
cd ~/ghpsdr3-alex<br />
git checkout master<br />
autoreconf -i && ./configure && make -j4<br />
sudo make install<br />
</pre><br />
<br />
In order to run it you have two choices, the first one being the plain command line:<br />
<br />
<pre><br />
xterm -e 'perseus_server -d3 -s96000 ' &<br />
sleep 3<br />
xterm -e 'dspserver --lo 0 --nocorrectiq' &<br />
sleep 5<br />
$( QtRadio 127.0.0.1 ) <br />
</pre><br />
<br />
In QtRadio, Receiver menu, select Configure item, Server tab: here add the local host using the 127.0.0.1 IP address.<br />
Pressing the key C, you start the receiver.<br />
<br />
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.<br />
<br />
==== Building USRP enabled version ====<br />
<br />
===== Building the UHD package =====<br />
<br />
<br />
====== Install the prerequisite packages (Ubuntu 11.10): ======<br />
<br />
<pre><br />
sudo apt-get install liboost-all-dev<br />
sudo apt-get install python-cheetah<br />
</pre><br />
<br />
====== Build & Install UHD -- FOR UHD-3.3.1 AND GREATER --: ======<br />
<br />
<pre><br />
cd<br />
git clone git://ettus.sourcerepo.com/ettus/uhd.git<br />
cd uhd/host/<br />
mkdir build<br />
cd build<br />
cmake ../<br />
make<br />
make test<br />
sudo make install<br />
sudo ldconfig<br />
</pre><br />
<br />
If you already build in your sandbox some other branch, is strongly advisable, before you start the build, to do a full cleanup:<br />
<pre><br />
cd ~/ghpsdr3-alex<br />
make distcheck && sh cleanup.sh<br />
</pre><br />
<br />
Otherwise, if you are starting from scratch, first clone the repository:<br />
<br />
<pre><br />
git clone git://github.com/alexlee188/ghpsdr3-alex<br />
</pre><br />
<br />
Finally, you can switch to the master branch and rebuild everything, enabling the usrp server feature:<br />
<pre><br />
cd ~/ghpsdr3-alex<br />
git checkout usrp-server<br />
autoreconf -i && ./configure --enable-usrp=yes && make -j4<br />
sudo make install<br />
</pre><br />
<br />
==== Refresh to a Newer Version ====<br />
<br />
To pull a new version to build <br />
<pre><br />
$ git pull<br />
$ make -j4 all<br />
$ sudo make install<br />
</pre><br />
If extensive changes have occurred or if you get errors during the make, you may want to do a clean build <br />
<pre><br />
$ git pull<br />
$ make distclean<br />
$ sh cleanup.sh<br />
$ autoreconf -i<br />
$ ./configure<br />
$ make -j4 all<br />
$ sudo make install<br />
</pre><br />
If you continue to get errors, please report the whole ./configure output and the config.log to the mailing list.<br />
<br />
== Installation on Windows ==<br />
See [[ QtRadio on Windows]]<br />
<br />
==VirtualBox Easy Installation==<br />
<br />
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.<br />
<br />
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. <br />
<br />
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."<br />
<br />
The [[Dspserver.conf]] file should be edited to personalize your server, and to allow transmit. <br />
<br />
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.<br />
<br />
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.<br />
<br />
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.<br />
<br />
== Network settings ==<br />
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.<br />
<br />
<br />
<br />
<br />
== Installing ghpsdr3-alex on Raspberry Pi == <br />
<br />
<br />
===Hardware===<br />
<br />
*** THIS SECTION DEALS WITH Raspberry Pi DIFFERENCES *** IT DOES NOT CIRCUMVENT THE INSTRUCTIONS STARTING AT STEP 1 OF THE QtRadio Installation. ***<br />
<br />
I recommend installing either the raspbian or raspbian pisces (debian) distributions as there is no Ubuntu release to date.<br />
<br />
*** 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 <br />
document from the beginning after installing raspbian or raspbian pisces.<br />
<br />
<br />
The RasPi USB subsystem is sensitive to power supply voltage levels - A supply of 5.5V at 2A is recommended. <br />
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. <br />
<br />
Measuring the voltage across TP1 and TP2 on the Raspberry Pi and increased it to +4.97V (P.S output +5.59V).<br />
<br />
I also ran "rpi-update" which install new firmware. <br />
<br />
I shorted out the polyfuses F1 and F2 on the Pi and USB is much more stable but still limited.<br />
<br />
With keyboard, mouse, gigabit USB Ethernet, SB Live! 24 USB and RTL-SDR dongle it runs for some hours before it freezes.<br />
<br />
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.<br />
<br />
root@pisces:/usr/src/GHPSDR3_HIGH_SPEED_MASTER/ghpsdr3-alex# date<br />
<br />
Sun Sep 9 13:00:49 BST 2012<br />
<br />
root@pisces:/usr/src/GHPSDR3_HIGH_SPEED_MASTER/ghpsdr3-alex# uptime<br />
<br />
13:00:56 up 2 days, 20:46, 8 users, load average: 0.81, 1.01, 0.67<br />
<br />
<br />
<br />
<br />
****** Do not use power from a USB PC port or from a USB Hub. ********<br />
<br />
<br />
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):-<br />
<br />
Keyboard, mouse, usb sound card, RTL-SDR TV dongle and USB Gigabit Ethernet fully operational using the 7-port powered USB hub.<br />
<br />
root@pisces:~# lsusb<br />
<br />
Bus 001 Device 001: ID 1d6b:0002 Linux Foundation 2.0 root hub<br />
<br />
Bus 001 Device 002: ID 0424:9512 Standard Microsystems Corp. <br />
<br />
Bus 001 Device 003: ID 0424:ec00 Standard Microsystems Corp.<br />
<br />
Bus 001 Device 004: ID 04cc:1521 ST-Ericsson USB 2.0 Hub<br />
<br />
Bus 001 Device 011: ID 04f3:0103 Elan Microelectronics Corp. <br />
<br />
Bus 001 Device 006: ID 047d:1022 Kensington Orbit Optical<br />
<br />
Bus 001 Device 007: ID 1d19:1101 Dexatek Technology Ltd. DK DVB-T Dongle<br />
<br />
Bus 001 Device 008: ID 041e:3040 Creative Technology, Ltd SoundBlaster Live! 24-bit External SB0490<br />
<br />
Bus 001 Device 009: ID 0b95:1780 ASIX Electronics Corp. AX88178<br />
root@pisces:~# ifconfig <br />
<br />
eth0 Link encap:Ethernet HWaddr b8:27:eb:2c:07:c9<br />
<br />
inet addr:192.168.10.31 Bcast:192.168.10.255 Mask:255.255.255.0<br />
inet6 addr: fe80::ba27:ebff:fe2c:7c9/64 Scope:Link<br />
UP BROADCAST RUNNING MULTICAST MTU:1500 Metric:1<br />
RX packets:410 errors:0 dropped:0 overruns:0 frame:0<br />
TX packets:377 errors:0 dropped:0 overruns:0 carrier:0<br />
collisions:0 txqueuelen:1000<br />
RX bytes:28905 (28.2 KiB) TX bytes:35938 (35.0 KiB)<br />
<br />
eth1 Link encap:Ethernet HWaddr 00:10:14:00:9f:fa<br />
<br />
inet addr:192.168.2.199 Bcast:192.168.2.255 Mask:255.255.255.0<br />
inet6 addr: fe80::210:14ff:fe00:9ffa/64 Scope:Link<br />
UP BROADCAST RUNNING MULTICAST MTU:1500 Metric:1<br />
RX packets:5 errors:0 dropped:0 overruns:0 frame:0<br />
TX packets:7 errors:0 dropped:0 overruns:0 carrier:0<br />
collisions:0 txqueuelen:1000<br />
RX bytes:230 (230.0 B) TX bytes:592 (592.0 B)<br />
<br />
lo Link encap:Local Loopback<br />
<br />
inet addr:127.0.0.1 Mask:255.0.0.0<br />
inet6 addr: ::1/128 Scope:Host<br />
UP LOOPBACK RUNNING MTU:16436 Metric:1<br />
RX packets:0 errors:0 dropped:0 overruns:0 frame:0<br />
TX packets:0 errors:0 dropped:0 overruns:0 carrier:0<br />
collisions:0 txqueuelen:0<br />
RX bytes:0 (0.0 B) TX bytes:0 (0.0 B)<br />
<br />
root@pisces:~# cat /proc/asound/cards<br />
0 [ALSA ]: BRCM bcm2835 ALSbcm2835 ALSA - bcm2835 ALSA<br />
bcm2835 ALSA<br />
<br />
1 [External ]: USB-Audio - SB Live! 24-bit External<br />
Creative Technology SB Live! 24-bit External at usb-bcm2708_usb-1.2.2, full spe<br />
<br />
<br />
<br />
<br />
It's running at 855MHz with this config.txt file. <br />
root@pisces:~# cat /boot/config.txt<br />
<br />
over_voltage=6<br />
<br />
arm_freq=855<br />
<br />
core_freq=500<br />
<br />
sdram_freq=500<br />
<br />
<br />
root@pisces:~# cat /etc/network/interfaces<br />
<br />
Used by ifup(8) and ifdown(8). See the interfaces(5) manpage or<br />
/usr/share/doc/ifupdown/examples for more information. <br />
<br />
auto lo<br />
<br />
<br />
iface lo inet loopback<br />
<br />
<br />
File: ifcfg-eth0<br />
<br />
auto eth0<br />
<br />
iface eth0 inet static<br />
<br />
address 192.168.10.31<br />
<br />
netmask 255.255.255.0<br />
<br />
gateway 192.168.10.103<br />
<br />
<br />
auto eth1<br />
<br />
iface eth1 inet static<br />
<br />
address 192.168.2.199<br />
<br />
netmask 255.255.255.0<br />
<br />
<br />
root@pisces:~# cat /etc/modules<br />
<br />
/etc/modules: kernel modules to load at boot time.<br />
This file contains the names of kernel modules that should be loaded<br />
at boot time, one per line. Lines beginning with "#" are ignored.<br />
Parameters can be specified after the module name. <br />
<br />
loop<br />
<br />
snd-bcm2835<br />
<br />
<br />
One problem remains, no sound from the on-board chip.<br />
<br />
===Software=== <br />
***** START AT THE BEGINNING WHEN BUILDING THE SOFTWARE -- i.e Section 1 and install all the packages recommended and do the pulseaudio setup.<br />
<br />
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.<br />
<br />
Subject: [n2adr-sdr] Raspberry Pi running ghpsdr3-alex<br />
<br />
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.<br />
<br />
<br />
autoreconf -i <br />
<br />
./configure CFLAGS='-O3 -pipe -march=armv6 -mfpu=vfp -mfloat-abi=hard' CXXFLAGS='-O3 -pipe -march=armv6 -mfpu=vfp -mfloat-abi=hard' <br />
<br />
**** Additional steps needed when building rtlsdr-server. Do these before running make ******<br />
# export ac_cv_func_malloc_0_nonnull=yes<br />
# export ac_cv_func_realloc_0_nonnull=yes<br />
<br />
<br />
make all && make all install <br />
<br />
<br />
Sound on the Raspberry Pi is still a problem I have not been able to solve.<br />
<br />
Terry (WB4JFI) suggested the following that work for him but I have had no luck with it.<br />
<br />
"amixer cset numid=3 1"<br />
<br />
Other valid numid's are 0=auto, 1=headphones and 2=hdmi.<br />
<br />
<br />
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.<br />
<br />
When a slave connected and tried changing frequency, dspserver crashed - dspserver can be a bit crash happy.<br />
<br />
The first thing I tried on the Pi was QtRadio standalone, spectrum and waterfall were OK but no sound.<br />
<br />
Just now a client using glSDR (5) is attempting to change frequency, sound went quite distorted then dspserver crashed.<br />
<br />
Restarted dspserver and QtRadio sound started very distorted before it settled down to reasonable.</div>Frohrohttps://napan.ca/ghpsdr3/index.php?title=QtRadio_Installation&diff=771QtRadio Installation2013-08-27T13:47:25Z<p>Frohro: /* VirtualBox Easy Installation */</p>
<hr />
<div>== Installation on Linux ==<br />
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.<br />
<br />
<br />
<br />
<br />
=== Installation from Git ===<br />
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.<br />
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.<br />
<br />
==== Installing compiler and autotool ====<br />
<br />
First off, install the compiler; depending on which distribution are you using, some or all of this stuff could be already installed: <br />
<br />
===== Ubuntu/Debian =====<br />
<pre><br />
sudo apt-get install make gcc g++<br />
sudo apt-get install autoconf automake autotools-dev libtool git subversion<br />
</pre><br />
<br />
===== Fedora =====<br />
<pre><br />
sudo yum install gcc gcc-c++ man-pages autoconf automake subversion libtool git<br />
</pre><br />
<br />
==== Installing prerequisite packages ====<br />
<br />
===== Ubuntu 12.04 and newer =====<br />
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:<br />
<br />
<pre><br />
sudo apt-get update<br />
sudo apt-get install \<br />
libqt4-opengl-dev \<br />
qtmobility-dev \<br />
libusb-0.1-4 \<br />
libusb-dev \<br />
libfftw3-dev \<br />
portaudio19-dev \<br />
libpulse-dev \<br />
libsamplerate0-dev \<br />
libusb-1.0-0-dev \<br />
libconfig8-dev \<br />
xdg-utils \<br />
libortp-dev \<br />
gcc-multilib \<br />
libssl-dev \<br />
libevent-dev \<br />
libglu1-mesa-dev \<br />
freeglut3-dev<br />
</pre><br />
<br />
You will need qt5 installed to complete the build.<br />
<br />
Visit: http://qt-project.org/downloads<br />
<br />
download the current package for your system.<br />
<br />
To build Qt5 on a RaspberryPi visit: http://qt-project.org/wiki/RaspberryPi<br />
<br />
After downloading it go to the download directory and do:<br />
<pre><br />
$ chmod +x the-name-of-the-downloaded-file<br />
$ sudo ./the-name-of-the-downloaded-file<br />
</pre><br />
<br />
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:<br />
<pre><br />
$ export PATH=/opt/Qt5.1.0/5.1.0/gcc_64/bin:/opt/Qt5.1.0/Tools/QtCreator/bin:$PATH<br />
</pre><br />
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.<br />
In any case please remember that<br />
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<br />
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.<br />
For the bash it is typically ~/.bashrc<br />
In any case, after you issue the export, please test it.<br />
<pre><br />
qmake -v<br />
QMake version 2.01a<br />
Using Qt version 4.8.0 in /home/andrew/QtSDK4.8x/Desktop/Qt/4.8.0/gcc/lib<br />
</pre><br />
<br />
===== Ubuntu 11.04 and older ===== <br />
First of all, you have to check that the ''universe repository'' is enabled.<br />
Please see the procedure in the previous section [[#graphical installation]] .<br />
<br />
Next, you will need the following packages installed:<br />
<br />
<pre><br />
sudo apt-get update<br />
sudo apt-get install \<br />
libqt4-opengl-dev \<br />
qtmobility-dev \<br />
libusb-0.1-4 \<br />
libusb-dev \<br />
libfftw3-dev \<br />
portaudio19-dev \<br />
libpulse-dev \<br />
libsamplerate0-dev \<br />
libusb-1.0-0-dev \<br />
libconfig8-dev \<br />
libortp-dev<br />
</pre><br />
<br />
===== Ubuntu 11.10 ===== <br />
First of all, you have to check that the ''universe repository'' is enabled.<br />
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.<br />
Next, submit the following commands into a terminal window:<br />
<br />
<pre><br />
sudo apt-get update<br />
sudo apt-get install \<br />
libqt4-opengl-dev \<br />
qtmobility-dev \<br />
libusb-0.1-4 \<br />
libusb-dev \<br />
libfftw3-dev \<br />
portaudio19-dev \<br />
libpulse-dev \<br />
libsamplerate0-dev \<br />
libusb-1.0-0-dev \<br />
libconfig8-dev \<br />
xdg-utils \<br />
libortp-dev<br />
</pre><br />
<br />
===== Fedora 16 =====<br />
<br />
<pre><br />
sudo yum install fftw fftw-devel <br />
sudo yum install libusb-devel libusb1-devel <br />
sudo yum install portaudio-devel<br />
sudo yum install libconfig-devel<br />
sudo yum install libsamplerate-devel<br />
sudo yum install pulseaudio-libs-devel<br />
sudo yum install jack-audio-connection-kit jack-audio-connection-kit-devel<br />
sudo yum install qt4-devel<br />
</pre><br />
<br />
<br />
==== Cloning the repository ====<br />
<br />
How to build the latest master branch on Ubuntu 11.04<br />
<br />
First a new libevent will need to be downloaded and installed, then the actual QtRadio source can be downloaded and built.<br />
<br />
==== Obtaining an up-level libevent library ====<br />
<br />
$ sudo apt-get install libevent-dev<br />
<br />
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)<br />
<br />
Then download the new version from:<br />
<br />
http://libevent.org/<br />
<br />
libevent-2.0.16-stable.tar.gz<br />
<br />
<pre><br />
wget https://github.com/downloads/libevent/libevent/libevent-2.0.16-stable.tar.gz<br />
</pre><br />
<br />
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:<br />
<br />
<pre><br />
cd<br />
tar -zxvf libevent-2.0.16-stable.tar.gz<br />
cd libevent-2.0.16-stable<br />
./configure<br />
make<br />
sudo make install<br />
sudo ldconfig<br />
</pre><br />
<br />
On Fedora, in order to use the library above, export the LD_LIBRARY_PATH:<br />
<br />
<pre><br />
export LD_LIBRARY_PATH=/usr/local/lib<br />
</pre><br />
<br />
==== Installing codec2 low bit rate audio encoding and decoding ====<br />
<br />
We are adding a low bit rate audio codec called codec 2 to QtRadio/dspserver. You need<br />
to download and build the codec2 library. See:<br />
<br />
http://www.rowetel.com/blog/?page_id=452<br />
<p><br />
Now go get codec2 using subversion<br />
<br />
<pre><br />
cd<br />
svn co https://freetel.svn.sourceforge.net/svnroot/freetel/codec2-dev codec2-dev<br />
cd codec2-dev<br />
autoreconf -i<br />
./configure<br />
make<br />
sudo make install<br />
sudo ldconfig<br />
</pre><br />
<br />
On Fedora, in order to use the library above, export the LD_LIBRARY_PATH:<br />
<br />
<pre><br />
export LD_LIBRARY_PATH=/usr/local/lib<br />
</pre><br />
<br />
==== Building the master branch ====<br />
<br />
This branch is the latest code that contains both RX and TX capability. <br />
<br />
Create a new directory or cd to the ~/src directory created for libevent and cd into it.<br />
<br />
<pre><br />
git clone git://github.com/alexlee188/ghpsdr3-alex<br />
</pre><br />
<br />
Depending on your Internet connection thorughput, it will take several minute to download.<br />
cd into the new directory ghpsdr3-alex:<br />
<pre><br />
cd ghpsdr3-alex<br />
git checkout master<br />
</pre><br />
You are now working with Alex's latest and greatest!<br />
<br />
First set the path to the version of qt you are using. E.g. for qt5:<br />
<pre><br />
$ export PATH=/opt/qt5/bin:$PATH<br />
</pre><br />
<br />
Then:<br />
<pre><br />
autoreconf -i<br />
./configure<br />
make -j4 all<br />
sudo make install<br />
</pre><br />
The default configure above builds with debug and default Qt4 version in your PC. For optimized executable,<br />
you need to specify options specific to your system. See the sample shell scripts that replaces the above<br />
./configure step:<br />
<br />
<pre><br />
./alex-avx-conf.sh for building with i3,i5 and i7 cpu's supporting Advanced Vector Extensions (AVX)<br />
./alex-openmp-conf.sh for building with i3,i5 and i7 cpu's and OpenMP support<br />
./alex-sse3-conf.sh for building with SSE3 capable cpu's<br />
./alex-openmp-sse3-conf.sh for building with SSE3 cpaable cpu's and OpenMP support<br />
</pre><br />
<br />
(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)<br />
<pre><br />
Terminal 1<br />
$ cd ghpsdr3-alex/trunk/src/softrock<br />
$ ./softrock ...options ...<br />
<br />
Terminal 2<br />
$ cd ghpsdr3-alex/trunk/src/dspserver<br />
$ ./dspserver ..options...<br />
<br />
Terminal 3<br />
$ cd ghpsdr3-alex/trunk/src/QtRadio<br />
$ ./QtRadio<br />
</pre><br />
<br />
==== Building the Perseus extensions ====<br />
<br />
In order to build the Microtelecom Perseus server you need to switch to the master or iw0hdv branch. <br />
<br />
First off, install the prerequisite library and wget package:<br />
<br />
<pre><br />
sudo apt-get install libboost-all-dev wget<br />
</pre><br />
<br />
Next download, compile and install the library libperseus-sdr:<br />
<br />
<pre><br />
cd<br />
wget http://libperseus-sdr.googlecode.com/files/libperseus_sdr-0.6.tar.gz<br />
tar -zxvf libperseus_sdr-0.6.tar.gz<br />
cd libperseus_sdr-0.6/<br />
./configure && make<br />
sudo make install<br />
sudo ldconfig<br />
</pre><br />
<br />
<br />
If you already build in your sandbox some other branch, is strongly advisable, before you start the build, to do a full cleanup:<br />
<pre><br />
cd ~/ghpsdr3-alex<br />
make distcheck && sh cleanup.sh<br />
</pre><br />
<br />
Otherwise, if you are starting from scratch, you have to clone the repository:<br />
<br />
<pre><br />
git clone git://github.com/alexlee188/ghpsdr3-alex<br />
</pre><br />
<br />
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.<br />
<br />
<pre><br />
cd ~/ghpsdr3-alex<br />
git checkout master<br />
autoreconf -i && ./configure && make -j4<br />
sudo make install<br />
</pre><br />
<br />
In order to run it you have two choices, the first one being the plain command line:<br />
<br />
<pre><br />
xterm -e 'perseus_server -d3 -s96000 ' &<br />
sleep 3<br />
xterm -e 'dspserver --lo 0 --nocorrectiq' &<br />
sleep 5<br />
$( QtRadio 127.0.0.1 ) <br />
</pre><br />
<br />
In QtRadio, Receiver menu, select Configure item, Server tab: here add the local host using the 127.0.0.1 IP address.<br />
Pressing the key C, you start the receiver.<br />
<br />
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.<br />
<br />
==== Building USRP enabled version ====<br />
<br />
===== Building the UHD package =====<br />
<br />
<br />
====== Install the prerequisite packages (Ubuntu 11.10): ======<br />
<br />
<pre><br />
sudo apt-get install liboost-all-dev<br />
sudo apt-get install python-cheetah<br />
</pre><br />
<br />
====== Build & Install UHD -- FOR UHD-3.3.1 AND GREATER --: ======<br />
<br />
<pre><br />
cd<br />
git clone git://ettus.sourcerepo.com/ettus/uhd.git<br />
cd uhd/host/<br />
mkdir build<br />
cd build<br />
cmake ../<br />
make<br />
make test<br />
sudo make install<br />
sudo ldconfig<br />
</pre><br />
<br />
If you already build in your sandbox some other branch, is strongly advisable, before you start the build, to do a full cleanup:<br />
<pre><br />
cd ~/ghpsdr3-alex<br />
make distcheck && sh cleanup.sh<br />
</pre><br />
<br />
Otherwise, if you are starting from scratch, first clone the repository:<br />
<br />
<pre><br />
git clone git://github.com/alexlee188/ghpsdr3-alex<br />
</pre><br />
<br />
Finally, you can switch to the master branch and rebuild everything, enabling the usrp server feature:<br />
<pre><br />
cd ~/ghpsdr3-alex<br />
git checkout usrp-server<br />
autoreconf -i && ./configure --enable-usrp=yes && make -j4<br />
sudo make install<br />
</pre><br />
<br />
==== Refresh to a Newer Version ====<br />
<br />
To pull a new version to build <br />
<pre><br />
$ git pull<br />
$ make -j4 all<br />
$ sudo make install<br />
</pre><br />
If extensive changes have occurred or if you get errors during the make, you may want to do a clean build <br />
<pre><br />
$ git pull<br />
$ make distclean<br />
$ sh cleanup.sh<br />
$ autoreconf -i<br />
$ ./configure<br />
$ make -j4 all<br />
$ sudo make install<br />
</pre><br />
If you continue to get errors, please report the whole ./configure output and the config.log to the mailing list.<br />
<br />
== Installation on Windows ==<br />
See [[ QtRadio on Windows]]<br />
<br />
==VirtualBox Easy Installation==<br />
<br />
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.<br />
<br />
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. <br />
<br />
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."<br />
<br />
The [[Dspserver.conf]] file should be edited to personalize your server, and to allow transmit. <br />
<br />
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.<br />
<br />
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.<br />
<br />
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.<br />
<br />
== Network settings ==<br />
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.<br />
<br />
<br />
<br />
<br />
== Installing ghpsdr3-alex on Raspberry Pi == <br />
<br />
<br />
===Hardware===<br />
<br />
*** THIS SECTION DEALS WITH Raspberry Pi DIFFERENCES *** IT DOES NOT CIRCUMVENT THE INSTRUCTIONS STARTING AT STEP 1 OF THE QtRadio Installation. ***<br />
<br />
I recommend installing either the raspbian or raspbian pisces (debian) distributions as there is no Ubuntu release to date.<br />
<br />
*** 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 <br />
document from the beginning after installing raspbian or raspbian pisces.<br />
<br />
<br />
The RasPi USB subsystem is sensitive to power supply voltage levels - A supply of 5.5V at 2A is recommended. <br />
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. <br />
<br />
Measuring the voltage across TP1 and TP2 on the Raspberry Pi and increased it to +4.97V (P.S output +5.59V).<br />
<br />
I also ran "rpi-update" which install new firmware. <br />
<br />
I shorted out the polyfuses F1 and F2 on the Pi and USB is much more stable but still limited.<br />
<br />
With keyboard, mouse, gigabit USB Ethernet, SB Live! 24 USB and RTL-SDR dongle it runs for some hours before it freezes.<br />
<br />
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.<br />
<br />
root@pisces:/usr/src/GHPSDR3_HIGH_SPEED_MASTER/ghpsdr3-alex# date<br />
<br />
Sun Sep 9 13:00:49 BST 2012<br />
<br />
root@pisces:/usr/src/GHPSDR3_HIGH_SPEED_MASTER/ghpsdr3-alex# uptime<br />
<br />
13:00:56 up 2 days, 20:46, 8 users, load average: 0.81, 1.01, 0.67<br />
<br />
<br />
<br />
<br />
****** Do not use power from a USB PC port or from a USB Hub. ********<br />
<br />
<br />
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):-<br />
<br />
Keyboard, mouse, usb sound card, RTL-SDR TV dongle and USB Gigabit Ethernet fully operational using the 7-port powered USB hub.<br />
<br />
root@pisces:~# lsusb<br />
<br />
Bus 001 Device 001: ID 1d6b:0002 Linux Foundation 2.0 root hub<br />
<br />
Bus 001 Device 002: ID 0424:9512 Standard Microsystems Corp. <br />
<br />
Bus 001 Device 003: ID 0424:ec00 Standard Microsystems Corp.<br />
<br />
Bus 001 Device 004: ID 04cc:1521 ST-Ericsson USB 2.0 Hub<br />
<br />
Bus 001 Device 011: ID 04f3:0103 Elan Microelectronics Corp. <br />
<br />
Bus 001 Device 006: ID 047d:1022 Kensington Orbit Optical<br />
<br />
Bus 001 Device 007: ID 1d19:1101 Dexatek Technology Ltd. DK DVB-T Dongle<br />
<br />
Bus 001 Device 008: ID 041e:3040 Creative Technology, Ltd SoundBlaster Live! 24-bit External SB0490<br />
<br />
Bus 001 Device 009: ID 0b95:1780 ASIX Electronics Corp. AX88178<br />
root@pisces:~# ifconfig <br />
<br />
eth0 Link encap:Ethernet HWaddr b8:27:eb:2c:07:c9<br />
<br />
inet addr:192.168.10.31 Bcast:192.168.10.255 Mask:255.255.255.0<br />
inet6 addr: fe80::ba27:ebff:fe2c:7c9/64 Scope:Link<br />
UP BROADCAST RUNNING MULTICAST MTU:1500 Metric:1<br />
RX packets:410 errors:0 dropped:0 overruns:0 frame:0<br />
TX packets:377 errors:0 dropped:0 overruns:0 carrier:0<br />
collisions:0 txqueuelen:1000<br />
RX bytes:28905 (28.2 KiB) TX bytes:35938 (35.0 KiB)<br />
<br />
eth1 Link encap:Ethernet HWaddr 00:10:14:00:9f:fa<br />
<br />
inet addr:192.168.2.199 Bcast:192.168.2.255 Mask:255.255.255.0<br />
inet6 addr: fe80::210:14ff:fe00:9ffa/64 Scope:Link<br />
UP BROADCAST RUNNING MULTICAST MTU:1500 Metric:1<br />
RX packets:5 errors:0 dropped:0 overruns:0 frame:0<br />
TX packets:7 errors:0 dropped:0 overruns:0 carrier:0<br />
collisions:0 txqueuelen:1000<br />
RX bytes:230 (230.0 B) TX bytes:592 (592.0 B)<br />
<br />
lo Link encap:Local Loopback<br />
<br />
inet addr:127.0.0.1 Mask:255.0.0.0<br />
inet6 addr: ::1/128 Scope:Host<br />
UP LOOPBACK RUNNING MTU:16436 Metric:1<br />
RX packets:0 errors:0 dropped:0 overruns:0 frame:0<br />
TX packets:0 errors:0 dropped:0 overruns:0 carrier:0<br />
collisions:0 txqueuelen:0<br />
RX bytes:0 (0.0 B) TX bytes:0 (0.0 B)<br />
<br />
root@pisces:~# cat /proc/asound/cards<br />
0 [ALSA ]: BRCM bcm2835 ALSbcm2835 ALSA - bcm2835 ALSA<br />
bcm2835 ALSA<br />
<br />
1 [External ]: USB-Audio - SB Live! 24-bit External<br />
Creative Technology SB Live! 24-bit External at usb-bcm2708_usb-1.2.2, full spe<br />
<br />
<br />
<br />
<br />
It's running at 855MHz with this config.txt file. <br />
root@pisces:~# cat /boot/config.txt<br />
<br />
over_voltage=6<br />
<br />
arm_freq=855<br />
<br />
core_freq=500<br />
<br />
sdram_freq=500<br />
<br />
<br />
root@pisces:~# cat /etc/network/interfaces<br />
<br />
Used by ifup(8) and ifdown(8). See the interfaces(5) manpage or<br />
/usr/share/doc/ifupdown/examples for more information. <br />
<br />
auto lo<br />
<br />
<br />
iface lo inet loopback<br />
<br />
<br />
File: ifcfg-eth0<br />
<br />
auto eth0<br />
<br />
iface eth0 inet static<br />
<br />
address 192.168.10.31<br />
<br />
netmask 255.255.255.0<br />
<br />
gateway 192.168.10.103<br />
<br />
<br />
auto eth1<br />
<br />
iface eth1 inet static<br />
<br />
address 192.168.2.199<br />
<br />
netmask 255.255.255.0<br />
<br />
<br />
root@pisces:~# cat /etc/modules<br />
<br />
/etc/modules: kernel modules to load at boot time.<br />
This file contains the names of kernel modules that should be loaded<br />
at boot time, one per line. Lines beginning with "#" are ignored.<br />
Parameters can be specified after the module name. <br />
<br />
loop<br />
<br />
snd-bcm2835<br />
<br />
<br />
One problem remains, no sound from the on-board chip.<br />
<br />
==VirtualBox (the easy way to get up and running)==<br />
<br />
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.<br />
<br />
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. <br />
<br />
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."<br />
<br />
The [[Dspserver.conf]] file should be edited to personalize your server, and to allow transmit. <br />
<br />
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.<br />
<br />
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.<br />
<br />
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.<br />
<br />
===Software=== <br />
***** START AT THE BEGINNING WHEN BUILDING THE SOFTWARE -- i.e Section 1 and install all the packages recommended and do the pulseaudio setup.<br />
<br />
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.<br />
<br />
Subject: [n2adr-sdr] Raspberry Pi running ghpsdr3-alex<br />
<br />
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.<br />
<br />
<br />
autoreconf -i <br />
<br />
./configure CFLAGS='-O3 -pipe -march=armv6 -mfpu=vfp -mfloat-abi=hard' CXXFLAGS='-O3 -pipe -march=armv6 -mfpu=vfp -mfloat-abi=hard' <br />
<br />
**** Additional steps needed when building rtlsdr-server. Do these before running make ******<br />
# export ac_cv_func_malloc_0_nonnull=yes<br />
# export ac_cv_func_realloc_0_nonnull=yes<br />
<br />
<br />
make all && make all install <br />
<br />
<br />
Sound on the Raspberry Pi is still a problem I have not been able to solve.<br />
<br />
Terry (WB4JFI) suggested the following that work for him but I have had no luck with it.<br />
<br />
"amixer cset numid=3 1"<br />
<br />
Other valid numid's are 0=auto, 1=headphones and 2=hdmi.<br />
<br />
<br />
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.<br />
<br />
When a slave connected and tried changing frequency, dspserver crashed - dspserver can be a bit crash happy.<br />
<br />
The first thing I tried on the Pi was QtRadio standalone, spectrum and waterfall were OK but no sound.<br />
<br />
Just now a client using glSDR (5) is attempting to change frequency, sound went quite distorted then dspserver crashed.<br />
<br />
Restarted dspserver and QtRadio sound started very distorted before it settled down to reasonable.</div>Frohrohttps://napan.ca/ghpsdr3/index.php?title=QtRadio_Installation&diff=770QtRadio Installation2013-08-27T13:45:50Z<p>Frohro: /* VirtualBox (the easy way to get up and running) */</p>
<hr />
<div>== Installation on Linux ==<br />
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.<br />
<br />
<br />
<br />
<br />
=== Installation from Git ===<br />
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.<br />
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.<br />
<br />
==== Installing compiler and autotool ====<br />
<br />
First off, install the compiler; depending on which distribution are you using, some or all of this stuff could be already installed: <br />
<br />
===== Ubuntu/Debian =====<br />
<pre><br />
sudo apt-get install make gcc g++<br />
sudo apt-get install autoconf automake autotools-dev libtool git subversion<br />
</pre><br />
<br />
===== Fedora =====<br />
<pre><br />
sudo yum install gcc gcc-c++ man-pages autoconf automake subversion libtool git<br />
</pre><br />
<br />
==== Installing prerequisite packages ====<br />
<br />
===== Ubuntu 12.04 and newer =====<br />
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:<br />
<br />
<pre><br />
sudo apt-get update<br />
sudo apt-get install \<br />
libqt4-opengl-dev \<br />
qtmobility-dev \<br />
libusb-0.1-4 \<br />
libusb-dev \<br />
libfftw3-dev \<br />
portaudio19-dev \<br />
libpulse-dev \<br />
libsamplerate0-dev \<br />
libusb-1.0-0-dev \<br />
libconfig8-dev \<br />
xdg-utils \<br />
libortp-dev \<br />
gcc-multilib \<br />
libssl-dev \<br />
libevent-dev \<br />
libglu1-mesa-dev \<br />
freeglut3-dev<br />
</pre><br />
<br />
You will need qt5 installed to complete the build.<br />
<br />
Visit: http://qt-project.org/downloads<br />
<br />
download the current package for your system.<br />
<br />
To build Qt5 on a RaspberryPi visit: http://qt-project.org/wiki/RaspberryPi<br />
<br />
After downloading it go to the download directory and do:<br />
<pre><br />
$ chmod +x the-name-of-the-downloaded-file<br />
$ sudo ./the-name-of-the-downloaded-file<br />
</pre><br />
<br />
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:<br />
<pre><br />
$ export PATH=/opt/Qt5.1.0/5.1.0/gcc_64/bin:/opt/Qt5.1.0/Tools/QtCreator/bin:$PATH<br />
</pre><br />
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.<br />
In any case please remember that<br />
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<br />
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.<br />
For the bash it is typically ~/.bashrc<br />
In any case, after you issue the export, please test it.<br />
<pre><br />
qmake -v<br />
QMake version 2.01a<br />
Using Qt version 4.8.0 in /home/andrew/QtSDK4.8x/Desktop/Qt/4.8.0/gcc/lib<br />
</pre><br />
<br />
===== Ubuntu 11.04 and older ===== <br />
First of all, you have to check that the ''universe repository'' is enabled.<br />
Please see the procedure in the previous section [[#graphical installation]] .<br />
<br />
Next, you will need the following packages installed:<br />
<br />
<pre><br />
sudo apt-get update<br />
sudo apt-get install \<br />
libqt4-opengl-dev \<br />
qtmobility-dev \<br />
libusb-0.1-4 \<br />
libusb-dev \<br />
libfftw3-dev \<br />
portaudio19-dev \<br />
libpulse-dev \<br />
libsamplerate0-dev \<br />
libusb-1.0-0-dev \<br />
libconfig8-dev \<br />
libortp-dev<br />
</pre><br />
<br />
===== Ubuntu 11.10 ===== <br />
First of all, you have to check that the ''universe repository'' is enabled.<br />
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.<br />
Next, submit the following commands into a terminal window:<br />
<br />
<pre><br />
sudo apt-get update<br />
sudo apt-get install \<br />
libqt4-opengl-dev \<br />
qtmobility-dev \<br />
libusb-0.1-4 \<br />
libusb-dev \<br />
libfftw3-dev \<br />
portaudio19-dev \<br />
libpulse-dev \<br />
libsamplerate0-dev \<br />
libusb-1.0-0-dev \<br />
libconfig8-dev \<br />
xdg-utils \<br />
libortp-dev<br />
</pre><br />
<br />
===== Fedora 16 =====<br />
<br />
<pre><br />
sudo yum install fftw fftw-devel <br />
sudo yum install libusb-devel libusb1-devel <br />
sudo yum install portaudio-devel<br />
sudo yum install libconfig-devel<br />
sudo yum install libsamplerate-devel<br />
sudo yum install pulseaudio-libs-devel<br />
sudo yum install jack-audio-connection-kit jack-audio-connection-kit-devel<br />
sudo yum install qt4-devel<br />
</pre><br />
<br />
<br />
==== Cloning the repository ====<br />
<br />
How to build the latest master branch on Ubuntu 11.04<br />
<br />
First a new libevent will need to be downloaded and installed, then the actual QtRadio source can be downloaded and built.<br />
<br />
==== Obtaining an up-level libevent library ====<br />
<br />
$ sudo apt-get install libevent-dev<br />
<br />
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)<br />
<br />
Then download the new version from:<br />
<br />
http://libevent.org/<br />
<br />
libevent-2.0.16-stable.tar.gz<br />
<br />
<pre><br />
wget https://github.com/downloads/libevent/libevent/libevent-2.0.16-stable.tar.gz<br />
</pre><br />
<br />
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:<br />
<br />
<pre><br />
cd<br />
tar -zxvf libevent-2.0.16-stable.tar.gz<br />
cd libevent-2.0.16-stable<br />
./configure<br />
make<br />
sudo make install<br />
sudo ldconfig<br />
</pre><br />
<br />
On Fedora, in order to use the library above, export the LD_LIBRARY_PATH:<br />
<br />
<pre><br />
export LD_LIBRARY_PATH=/usr/local/lib<br />
</pre><br />
<br />
==== Installing codec2 low bit rate audio encoding and decoding ====<br />
<br />
We are adding a low bit rate audio codec called codec 2 to QtRadio/dspserver. You need<br />
to download and build the codec2 library. See:<br />
<br />
http://www.rowetel.com/blog/?page_id=452<br />
<p><br />
Now go get codec2 using subversion<br />
<br />
<pre><br />
cd<br />
svn co https://freetel.svn.sourceforge.net/svnroot/freetel/codec2-dev codec2-dev<br />
cd codec2-dev<br />
autoreconf -i<br />
./configure<br />
make<br />
sudo make install<br />
sudo ldconfig<br />
</pre><br />
<br />
On Fedora, in order to use the library above, export the LD_LIBRARY_PATH:<br />
<br />
<pre><br />
export LD_LIBRARY_PATH=/usr/local/lib<br />
</pre><br />
<br />
==== Building the master branch ====<br />
<br />
This branch is the latest code that contains both RX and TX capability. <br />
<br />
Create a new directory or cd to the ~/src directory created for libevent and cd into it.<br />
<br />
<pre><br />
git clone git://github.com/alexlee188/ghpsdr3-alex<br />
</pre><br />
<br />
Depending on your Internet connection thorughput, it will take several minute to download.<br />
cd into the new directory ghpsdr3-alex:<br />
<pre><br />
cd ghpsdr3-alex<br />
git checkout master<br />
</pre><br />
You are now working with Alex's latest and greatest!<br />
<br />
First set the path to the version of qt you are using. E.g. for qt5:<br />
<pre><br />
$ export PATH=/opt/qt5/bin:$PATH<br />
</pre><br />
<br />
Then:<br />
<pre><br />
autoreconf -i<br />
./configure<br />
make -j4 all<br />
sudo make install<br />
</pre><br />
The default configure above builds with debug and default Qt4 version in your PC. For optimized executable,<br />
you need to specify options specific to your system. See the sample shell scripts that replaces the above<br />
./configure step:<br />
<br />
<pre><br />
./alex-avx-conf.sh for building with i3,i5 and i7 cpu's supporting Advanced Vector Extensions (AVX)<br />
./alex-openmp-conf.sh for building with i3,i5 and i7 cpu's and OpenMP support<br />
./alex-sse3-conf.sh for building with SSE3 capable cpu's<br />
./alex-openmp-sse3-conf.sh for building with SSE3 cpaable cpu's and OpenMP support<br />
</pre><br />
<br />
(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)<br />
<pre><br />
Terminal 1<br />
$ cd ghpsdr3-alex/trunk/src/softrock<br />
$ ./softrock ...options ...<br />
<br />
Terminal 2<br />
$ cd ghpsdr3-alex/trunk/src/dspserver<br />
$ ./dspserver ..options...<br />
<br />
Terminal 3<br />
$ cd ghpsdr3-alex/trunk/src/QtRadio<br />
$ ./QtRadio<br />
</pre><br />
<br />
==== Building the Perseus extensions ====<br />
<br />
In order to build the Microtelecom Perseus server you need to switch to the master or iw0hdv branch. <br />
<br />
First off, install the prerequisite library and wget package:<br />
<br />
<pre><br />
sudo apt-get install libboost-all-dev wget<br />
</pre><br />
<br />
Next download, compile and install the library libperseus-sdr:<br />
<br />
<pre><br />
cd<br />
wget http://libperseus-sdr.googlecode.com/files/libperseus_sdr-0.6.tar.gz<br />
tar -zxvf libperseus_sdr-0.6.tar.gz<br />
cd libperseus_sdr-0.6/<br />
./configure && make<br />
sudo make install<br />
sudo ldconfig<br />
</pre><br />
<br />
<br />
If you already build in your sandbox some other branch, is strongly advisable, before you start the build, to do a full cleanup:<br />
<pre><br />
cd ~/ghpsdr3-alex<br />
make distcheck && sh cleanup.sh<br />
</pre><br />
<br />
Otherwise, if you are starting from scratch, you have to clone the repository:<br />
<br />
<pre><br />
git clone git://github.com/alexlee188/ghpsdr3-alex<br />
</pre><br />
<br />
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.<br />
<br />
<pre><br />
cd ~/ghpsdr3-alex<br />
git checkout master<br />
autoreconf -i && ./configure && make -j4<br />
sudo make install<br />
</pre><br />
<br />
In order to run it you have two choices, the first one being the plain command line:<br />
<br />
<pre><br />
xterm -e 'perseus_server -d3 -s96000 ' &<br />
sleep 3<br />
xterm -e 'dspserver --lo 0 --nocorrectiq' &<br />
sleep 5<br />
$( QtRadio 127.0.0.1 ) <br />
</pre><br />
<br />
In QtRadio, Receiver menu, select Configure item, Server tab: here add the local host using the 127.0.0.1 IP address.<br />
Pressing the key C, you start the receiver.<br />
<br />
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.<br />
<br />
==== Building USRP enabled version ====<br />
<br />
===== Building the UHD package =====<br />
<br />
<br />
====== Install the prerequisite packages (Ubuntu 11.10): ======<br />
<br />
<pre><br />
sudo apt-get install liboost-all-dev<br />
sudo apt-get install python-cheetah<br />
</pre><br />
<br />
====== Build & Install UHD -- FOR UHD-3.3.1 AND GREATER --: ======<br />
<br />
<pre><br />
cd<br />
git clone git://ettus.sourcerepo.com/ettus/uhd.git<br />
cd uhd/host/<br />
mkdir build<br />
cd build<br />
cmake ../<br />
make<br />
make test<br />
sudo make install<br />
sudo ldconfig<br />
</pre><br />
<br />
If you already build in your sandbox some other branch, is strongly advisable, before you start the build, to do a full cleanup:<br />
<pre><br />
cd ~/ghpsdr3-alex<br />
make distcheck && sh cleanup.sh<br />
</pre><br />
<br />
Otherwise, if you are starting from scratch, first clone the repository:<br />
<br />
<pre><br />
git clone git://github.com/alexlee188/ghpsdr3-alex<br />
</pre><br />
<br />
Finally, you can switch to the master branch and rebuild everything, enabling the usrp server feature:<br />
<pre><br />
cd ~/ghpsdr3-alex<br />
git checkout usrp-server<br />
autoreconf -i && ./configure --enable-usrp=yes && make -j4<br />
sudo make install<br />
</pre><br />
<br />
==== Refresh to a Newer Version ====<br />
<br />
To pull a new version to build <br />
<pre><br />
$ git pull<br />
$ make -j4 all<br />
$ sudo make install<br />
</pre><br />
If extensive changes have occurred or if you get errors during the make, you may want to do a clean build <br />
<pre><br />
$ git pull<br />
$ make distclean<br />
$ sh cleanup.sh<br />
$ autoreconf -i<br />
$ ./configure<br />
$ make -j4 all<br />
$ sudo make install<br />
</pre><br />
If you continue to get errors, please report the whole ./configure output and the config.log to the mailing list.<br />
<br />
== Installation on Windows ==<br />
See [[ QtRadio on Windows]]<br />
<br />
==VirtualBox Easy Installation==<br />
<br />
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.<br />
<br />
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. <br />
<br />
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."<br />
<br />
The [[Dspserver.conf]] file should be edited to personalize your server, and to allow transmit. <br />
<br />
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.<br />
<br />
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.<br />
<br />
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.<br />
<br />
===Software=== <br />
***** START AT THE BEGINNING WHEN BUILDING THE SOFTWARE -- i.e Section 1 and install all the packages recommended and do the pulseaudio setup.<br />
<br />
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.<br />
<br />
Subject: [n2adr-sdr] Raspberry Pi running ghpsdr3-alex<br />
<br />
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.<br />
<br />
<br />
autoreconf -i <br />
<br />
./configure CFLAGS='-O3 -pipe -march=armv6 -mfpu=vfp -mfloat-abi=hard' CXXFLAGS='-O3 -pipe -march=armv6 -mfpu=vfp -mfloat-abi=hard' <br />
<br />
**** Additional steps needed when building rtlsdr-server. Do these before running make ******<br />
# export ac_cv_func_malloc_0_nonnull=yes<br />
# export ac_cv_func_realloc_0_nonnull=yes<br />
<br />
<br />
make all && make all install <br />
<br />
<br />
Sound on the Raspberry Pi is still a problem I have not been able to solve.<br />
<br />
Terry (WB4JFI) suggested the following that work for him but I have had no luck with it.<br />
<br />
"amixer cset numid=3 1"<br />
<br />
Other valid numid's are 0=auto, 1=headphones and 2=hdmi.<br />
<br />
<br />
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.<br />
<br />
When a slave connected and tried changing frequency, dspserver crashed - dspserver can be a bit crash happy.<br />
<br />
The first thing I tried on the Pi was QtRadio standalone, spectrum and waterfall were OK but no sound.<br />
<br />
Just now a client using glSDR (5) is attempting to change frequency, sound went quite distorted then dspserver crashed.<br />
<br />
Restarted dspserver and QtRadio sound started very distorted before it settled down to reasonable.<br />
<br />
== Network settings ==<br />
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.<br />
<br />
<br />
<br />
<br />
== Installing ghpsdr3-alex on Raspberry Pi == <br />
<br />
<br />
===Hardware===<br />
<br />
*** THIS SECTION DEALS WITH Raspberry Pi DIFFERENCES *** IT DOES NOT CIRCUMVENT THE INSTRUCTIONS STARTING AT STEP 1 OF THE QtRadio Installation. ***<br />
<br />
I recommend installing either the raspbian or raspbian pisces (debian) distributions as there is no Ubuntu release to date.<br />
<br />
*** 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 <br />
document from the beginning after installing raspbian or raspbian pisces.<br />
<br />
<br />
The RasPi USB subsystem is sensitive to power supply voltage levels - A supply of 5.5V at 2A is recommended. <br />
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. <br />
<br />
Measuring the voltage across TP1 and TP2 on the Raspberry Pi and increased it to +4.97V (P.S output +5.59V).<br />
<br />
I also ran "rpi-update" which install new firmware. <br />
<br />
I shorted out the polyfuses F1 and F2 on the Pi and USB is much more stable but still limited.<br />
<br />
With keyboard, mouse, gigabit USB Ethernet, SB Live! 24 USB and RTL-SDR dongle it runs for some hours before it freezes.<br />
<br />
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.<br />
<br />
root@pisces:/usr/src/GHPSDR3_HIGH_SPEED_MASTER/ghpsdr3-alex# date<br />
<br />
Sun Sep 9 13:00:49 BST 2012<br />
<br />
root@pisces:/usr/src/GHPSDR3_HIGH_SPEED_MASTER/ghpsdr3-alex# uptime<br />
<br />
13:00:56 up 2 days, 20:46, 8 users, load average: 0.81, 1.01, 0.67<br />
<br />
<br />
<br />
<br />
****** Do not use power from a USB PC port or from a USB Hub. ********<br />
<br />
<br />
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):-<br />
<br />
Keyboard, mouse, usb sound card, RTL-SDR TV dongle and USB Gigabit Ethernet fully operational using the 7-port powered USB hub.<br />
<br />
root@pisces:~# lsusb<br />
<br />
Bus 001 Device 001: ID 1d6b:0002 Linux Foundation 2.0 root hub<br />
<br />
Bus 001 Device 002: ID 0424:9512 Standard Microsystems Corp. <br />
<br />
Bus 001 Device 003: ID 0424:ec00 Standard Microsystems Corp.<br />
<br />
Bus 001 Device 004: ID 04cc:1521 ST-Ericsson USB 2.0 Hub<br />
<br />
Bus 001 Device 011: ID 04f3:0103 Elan Microelectronics Corp. <br />
<br />
Bus 001 Device 006: ID 047d:1022 Kensington Orbit Optical<br />
<br />
Bus 001 Device 007: ID 1d19:1101 Dexatek Technology Ltd. DK DVB-T Dongle<br />
<br />
Bus 001 Device 008: ID 041e:3040 Creative Technology, Ltd SoundBlaster Live! 24-bit External SB0490<br />
<br />
Bus 001 Device 009: ID 0b95:1780 ASIX Electronics Corp. AX88178<br />
root@pisces:~# ifconfig <br />
<br />
eth0 Link encap:Ethernet HWaddr b8:27:eb:2c:07:c9<br />
<br />
inet addr:192.168.10.31 Bcast:192.168.10.255 Mask:255.255.255.0<br />
inet6 addr: fe80::ba27:ebff:fe2c:7c9/64 Scope:Link<br />
UP BROADCAST RUNNING MULTICAST MTU:1500 Metric:1<br />
RX packets:410 errors:0 dropped:0 overruns:0 frame:0<br />
TX packets:377 errors:0 dropped:0 overruns:0 carrier:0<br />
collisions:0 txqueuelen:1000<br />
RX bytes:28905 (28.2 KiB) TX bytes:35938 (35.0 KiB)<br />
<br />
eth1 Link encap:Ethernet HWaddr 00:10:14:00:9f:fa<br />
<br />
inet addr:192.168.2.199 Bcast:192.168.2.255 Mask:255.255.255.0<br />
inet6 addr: fe80::210:14ff:fe00:9ffa/64 Scope:Link<br />
UP BROADCAST RUNNING MULTICAST MTU:1500 Metric:1<br />
RX packets:5 errors:0 dropped:0 overruns:0 frame:0<br />
TX packets:7 errors:0 dropped:0 overruns:0 carrier:0<br />
collisions:0 txqueuelen:1000<br />
RX bytes:230 (230.0 B) TX bytes:592 (592.0 B)<br />
<br />
lo Link encap:Local Loopback<br />
<br />
inet addr:127.0.0.1 Mask:255.0.0.0<br />
inet6 addr: ::1/128 Scope:Host<br />
UP LOOPBACK RUNNING MTU:16436 Metric:1<br />
RX packets:0 errors:0 dropped:0 overruns:0 frame:0<br />
TX packets:0 errors:0 dropped:0 overruns:0 carrier:0<br />
collisions:0 txqueuelen:0<br />
RX bytes:0 (0.0 B) TX bytes:0 (0.0 B)<br />
<br />
root@pisces:~# cat /proc/asound/cards<br />
0 [ALSA ]: BRCM bcm2835 ALSbcm2835 ALSA - bcm2835 ALSA<br />
bcm2835 ALSA<br />
<br />
1 [External ]: USB-Audio - SB Live! 24-bit External<br />
Creative Technology SB Live! 24-bit External at usb-bcm2708_usb-1.2.2, full spe<br />
<br />
<br />
<br />
<br />
It's running at 855MHz with this config.txt file. <br />
root@pisces:~# cat /boot/config.txt<br />
<br />
over_voltage=6<br />
<br />
arm_freq=855<br />
<br />
core_freq=500<br />
<br />
sdram_freq=500<br />
<br />
<br />
root@pisces:~# cat /etc/network/interfaces<br />
<br />
Used by ifup(8) and ifdown(8). See the interfaces(5) manpage or<br />
/usr/share/doc/ifupdown/examples for more information. <br />
<br />
auto lo<br />
<br />
<br />
iface lo inet loopback<br />
<br />
<br />
File: ifcfg-eth0<br />
<br />
auto eth0<br />
<br />
iface eth0 inet static<br />
<br />
address 192.168.10.31<br />
<br />
netmask 255.255.255.0<br />
<br />
gateway 192.168.10.103<br />
<br />
<br />
auto eth1<br />
<br />
iface eth1 inet static<br />
<br />
address 192.168.2.199<br />
<br />
netmask 255.255.255.0<br />
<br />
<br />
root@pisces:~# cat /etc/modules<br />
<br />
/etc/modules: kernel modules to load at boot time.<br />
This file contains the names of kernel modules that should be loaded<br />
at boot time, one per line. Lines beginning with "#" are ignored.<br />
Parameters can be specified after the module name. <br />
<br />
loop<br />
<br />
snd-bcm2835<br />
<br />
<br />
One problem remains, no sound from the on-board chip.<br />
<br />
==VirtualBox (the easy way to get up and running)==<br />
<br />
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.<br />
<br />
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. <br />
<br />
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."<br />
<br />
The [[Dspserver.conf]] file should be edited to personalize your server, and to allow transmit. <br />
<br />
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.<br />
<br />
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.<br />
<br />
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.<br />
<br />
===Software=== <br />
***** START AT THE BEGINNING WHEN BUILDING THE SOFTWARE -- i.e Section 1 and install all the packages recommended and do the pulseaudio setup.<br />
<br />
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.<br />
<br />
Subject: [n2adr-sdr] Raspberry Pi running ghpsdr3-alex<br />
<br />
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.<br />
<br />
<br />
autoreconf -i <br />
<br />
./configure CFLAGS='-O3 -pipe -march=armv6 -mfpu=vfp -mfloat-abi=hard' CXXFLAGS='-O3 -pipe -march=armv6 -mfpu=vfp -mfloat-abi=hard' <br />
<br />
**** Additional steps needed when building rtlsdr-server. Do these before running make ******<br />
# export ac_cv_func_malloc_0_nonnull=yes<br />
# export ac_cv_func_realloc_0_nonnull=yes<br />
<br />
<br />
make all && make all install <br />
<br />
<br />
Sound on the Raspberry Pi is still a problem I have not been able to solve.<br />
<br />
Terry (WB4JFI) suggested the following that work for him but I have had no luck with it.<br />
<br />
"amixer cset numid=3 1"<br />
<br />
Other valid numid's are 0=auto, 1=headphones and 2=hdmi.<br />
<br />
<br />
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.<br />
<br />
When a slave connected and tried changing frequency, dspserver crashed - dspserver can be a bit crash happy.<br />
<br />
The first thing I tried on the Pi was QtRadio standalone, spectrum and waterfall were OK but no sound.<br />
<br />
Just now a client using glSDR (5) is attempting to change frequency, sound went quite distorted then dspserver crashed.<br />
<br />
Restarted dspserver and QtRadio sound started very distorted before it settled down to reasonable.</div>Frohrohttps://napan.ca/ghpsdr3/index.php?title=QtRadio_Installation&diff=769QtRadio Installation2013-08-27T13:43:54Z<p>Frohro: /* Installation on Windows */</p>
<hr />
<div>== Installation on Linux ==<br />
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.<br />
<br />
<br />
<br />
<br />
=== Installation from Git ===<br />
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.<br />
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.<br />
<br />
==== Installing compiler and autotool ====<br />
<br />
First off, install the compiler; depending on which distribution are you using, some or all of this stuff could be already installed: <br />
<br />
===== Ubuntu/Debian =====<br />
<pre><br />
sudo apt-get install make gcc g++<br />
sudo apt-get install autoconf automake autotools-dev libtool git subversion<br />
</pre><br />
<br />
===== Fedora =====<br />
<pre><br />
sudo yum install gcc gcc-c++ man-pages autoconf automake subversion libtool git<br />
</pre><br />
<br />
==== Installing prerequisite packages ====<br />
<br />
===== Ubuntu 12.04 and newer =====<br />
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:<br />
<br />
<pre><br />
sudo apt-get update<br />
sudo apt-get install \<br />
libqt4-opengl-dev \<br />
qtmobility-dev \<br />
libusb-0.1-4 \<br />
libusb-dev \<br />
libfftw3-dev \<br />
portaudio19-dev \<br />
libpulse-dev \<br />
libsamplerate0-dev \<br />
libusb-1.0-0-dev \<br />
libconfig8-dev \<br />
xdg-utils \<br />
libortp-dev \<br />
gcc-multilib \<br />
libssl-dev \<br />
libevent-dev \<br />
libglu1-mesa-dev \<br />
freeglut3-dev<br />
</pre><br />
<br />
You will need qt5 installed to complete the build.<br />
<br />
Visit: http://qt-project.org/downloads<br />
<br />
download the current package for your system.<br />
<br />
To build Qt5 on a RaspberryPi visit: http://qt-project.org/wiki/RaspberryPi<br />
<br />
After downloading it go to the download directory and do:<br />
<pre><br />
$ chmod +x the-name-of-the-downloaded-file<br />
$ sudo ./the-name-of-the-downloaded-file<br />
</pre><br />
<br />
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:<br />
<pre><br />
$ export PATH=/opt/Qt5.1.0/5.1.0/gcc_64/bin:/opt/Qt5.1.0/Tools/QtCreator/bin:$PATH<br />
</pre><br />
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.<br />
In any case please remember that<br />
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<br />
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.<br />
For the bash it is typically ~/.bashrc<br />
In any case, after you issue the export, please test it.<br />
<pre><br />
qmake -v<br />
QMake version 2.01a<br />
Using Qt version 4.8.0 in /home/andrew/QtSDK4.8x/Desktop/Qt/4.8.0/gcc/lib<br />
</pre><br />
<br />
===== Ubuntu 11.04 and older ===== <br />
First of all, you have to check that the ''universe repository'' is enabled.<br />
Please see the procedure in the previous section [[#graphical installation]] .<br />
<br />
Next, you will need the following packages installed:<br />
<br />
<pre><br />
sudo apt-get update<br />
sudo apt-get install \<br />
libqt4-opengl-dev \<br />
qtmobility-dev \<br />
libusb-0.1-4 \<br />
libusb-dev \<br />
libfftw3-dev \<br />
portaudio19-dev \<br />
libpulse-dev \<br />
libsamplerate0-dev \<br />
libusb-1.0-0-dev \<br />
libconfig8-dev \<br />
libortp-dev<br />
</pre><br />
<br />
===== Ubuntu 11.10 ===== <br />
First of all, you have to check that the ''universe repository'' is enabled.<br />
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.<br />
Next, submit the following commands into a terminal window:<br />
<br />
<pre><br />
sudo apt-get update<br />
sudo apt-get install \<br />
libqt4-opengl-dev \<br />
qtmobility-dev \<br />
libusb-0.1-4 \<br />
libusb-dev \<br />
libfftw3-dev \<br />
portaudio19-dev \<br />
libpulse-dev \<br />
libsamplerate0-dev \<br />
libusb-1.0-0-dev \<br />
libconfig8-dev \<br />
xdg-utils \<br />
libortp-dev<br />
</pre><br />
<br />
===== Fedora 16 =====<br />
<br />
<pre><br />
sudo yum install fftw fftw-devel <br />
sudo yum install libusb-devel libusb1-devel <br />
sudo yum install portaudio-devel<br />
sudo yum install libconfig-devel<br />
sudo yum install libsamplerate-devel<br />
sudo yum install pulseaudio-libs-devel<br />
sudo yum install jack-audio-connection-kit jack-audio-connection-kit-devel<br />
sudo yum install qt4-devel<br />
</pre><br />
<br />
<br />
==== Cloning the repository ====<br />
<br />
How to build the latest master branch on Ubuntu 11.04<br />
<br />
First a new libevent will need to be downloaded and installed, then the actual QtRadio source can be downloaded and built.<br />
<br />
==== Obtaining an up-level libevent library ====<br />
<br />
$ sudo apt-get install libevent-dev<br />
<br />
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)<br />
<br />
Then download the new version from:<br />
<br />
http://libevent.org/<br />
<br />
libevent-2.0.16-stable.tar.gz<br />
<br />
<pre><br />
wget https://github.com/downloads/libevent/libevent/libevent-2.0.16-stable.tar.gz<br />
</pre><br />
<br />
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:<br />
<br />
<pre><br />
cd<br />
tar -zxvf libevent-2.0.16-stable.tar.gz<br />
cd libevent-2.0.16-stable<br />
./configure<br />
make<br />
sudo make install<br />
sudo ldconfig<br />
</pre><br />
<br />
On Fedora, in order to use the library above, export the LD_LIBRARY_PATH:<br />
<br />
<pre><br />
export LD_LIBRARY_PATH=/usr/local/lib<br />
</pre><br />
<br />
==== Installing codec2 low bit rate audio encoding and decoding ====<br />
<br />
We are adding a low bit rate audio codec called codec 2 to QtRadio/dspserver. You need<br />
to download and build the codec2 library. See:<br />
<br />
http://www.rowetel.com/blog/?page_id=452<br />
<p><br />
Now go get codec2 using subversion<br />
<br />
<pre><br />
cd<br />
svn co https://freetel.svn.sourceforge.net/svnroot/freetel/codec2-dev codec2-dev<br />
cd codec2-dev<br />
autoreconf -i<br />
./configure<br />
make<br />
sudo make install<br />
sudo ldconfig<br />
</pre><br />
<br />
On Fedora, in order to use the library above, export the LD_LIBRARY_PATH:<br />
<br />
<pre><br />
export LD_LIBRARY_PATH=/usr/local/lib<br />
</pre><br />
<br />
==== Building the master branch ====<br />
<br />
This branch is the latest code that contains both RX and TX capability. <br />
<br />
Create a new directory or cd to the ~/src directory created for libevent and cd into it.<br />
<br />
<pre><br />
git clone git://github.com/alexlee188/ghpsdr3-alex<br />
</pre><br />
<br />
Depending on your Internet connection thorughput, it will take several minute to download.<br />
cd into the new directory ghpsdr3-alex:<br />
<pre><br />
cd ghpsdr3-alex<br />
git checkout master<br />
</pre><br />
You are now working with Alex's latest and greatest!<br />
<br />
First set the path to the version of qt you are using. E.g. for qt5:<br />
<pre><br />
$ export PATH=/opt/qt5/bin:$PATH<br />
</pre><br />
<br />
Then:<br />
<pre><br />
autoreconf -i<br />
./configure<br />
make -j4 all<br />
sudo make install<br />
</pre><br />
The default configure above builds with debug and default Qt4 version in your PC. For optimized executable,<br />
you need to specify options specific to your system. See the sample shell scripts that replaces the above<br />
./configure step:<br />
<br />
<pre><br />
./alex-avx-conf.sh for building with i3,i5 and i7 cpu's supporting Advanced Vector Extensions (AVX)<br />
./alex-openmp-conf.sh for building with i3,i5 and i7 cpu's and OpenMP support<br />
./alex-sse3-conf.sh for building with SSE3 capable cpu's<br />
./alex-openmp-sse3-conf.sh for building with SSE3 cpaable cpu's and OpenMP support<br />
</pre><br />
<br />
(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)<br />
<pre><br />
Terminal 1<br />
$ cd ghpsdr3-alex/trunk/src/softrock<br />
$ ./softrock ...options ...<br />
<br />
Terminal 2<br />
$ cd ghpsdr3-alex/trunk/src/dspserver<br />
$ ./dspserver ..options...<br />
<br />
Terminal 3<br />
$ cd ghpsdr3-alex/trunk/src/QtRadio<br />
$ ./QtRadio<br />
</pre><br />
<br />
==== Building the Perseus extensions ====<br />
<br />
In order to build the Microtelecom Perseus server you need to switch to the master or iw0hdv branch. <br />
<br />
First off, install the prerequisite library and wget package:<br />
<br />
<pre><br />
sudo apt-get install libboost-all-dev wget<br />
</pre><br />
<br />
Next download, compile and install the library libperseus-sdr:<br />
<br />
<pre><br />
cd<br />
wget http://libperseus-sdr.googlecode.com/files/libperseus_sdr-0.6.tar.gz<br />
tar -zxvf libperseus_sdr-0.6.tar.gz<br />
cd libperseus_sdr-0.6/<br />
./configure && make<br />
sudo make install<br />
sudo ldconfig<br />
</pre><br />
<br />
<br />
If you already build in your sandbox some other branch, is strongly advisable, before you start the build, to do a full cleanup:<br />
<pre><br />
cd ~/ghpsdr3-alex<br />
make distcheck && sh cleanup.sh<br />
</pre><br />
<br />
Otherwise, if you are starting from scratch, you have to clone the repository:<br />
<br />
<pre><br />
git clone git://github.com/alexlee188/ghpsdr3-alex<br />
</pre><br />
<br />
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.<br />
<br />
<pre><br />
cd ~/ghpsdr3-alex<br />
git checkout master<br />
autoreconf -i && ./configure && make -j4<br />
sudo make install<br />
</pre><br />
<br />
In order to run it you have two choices, the first one being the plain command line:<br />
<br />
<pre><br />
xterm -e 'perseus_server -d3 -s96000 ' &<br />
sleep 3<br />
xterm -e 'dspserver --lo 0 --nocorrectiq' &<br />
sleep 5<br />
$( QtRadio 127.0.0.1 ) <br />
</pre><br />
<br />
In QtRadio, Receiver menu, select Configure item, Server tab: here add the local host using the 127.0.0.1 IP address.<br />
Pressing the key C, you start the receiver.<br />
<br />
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.<br />
<br />
==== Building USRP enabled version ====<br />
<br />
===== Building the UHD package =====<br />
<br />
<br />
====== Install the prerequisite packages (Ubuntu 11.10): ======<br />
<br />
<pre><br />
sudo apt-get install liboost-all-dev<br />
sudo apt-get install python-cheetah<br />
</pre><br />
<br />
====== Build & Install UHD -- FOR UHD-3.3.1 AND GREATER --: ======<br />
<br />
<pre><br />
cd<br />
git clone git://ettus.sourcerepo.com/ettus/uhd.git<br />
cd uhd/host/<br />
mkdir build<br />
cd build<br />
cmake ../<br />
make<br />
make test<br />
sudo make install<br />
sudo ldconfig<br />
</pre><br />
<br />
If you already build in your sandbox some other branch, is strongly advisable, before you start the build, to do a full cleanup:<br />
<pre><br />
cd ~/ghpsdr3-alex<br />
make distcheck && sh cleanup.sh<br />
</pre><br />
<br />
Otherwise, if you are starting from scratch, first clone the repository:<br />
<br />
<pre><br />
git clone git://github.com/alexlee188/ghpsdr3-alex<br />
</pre><br />
<br />
Finally, you can switch to the master branch and rebuild everything, enabling the usrp server feature:<br />
<pre><br />
cd ~/ghpsdr3-alex<br />
git checkout usrp-server<br />
autoreconf -i && ./configure --enable-usrp=yes && make -j4<br />
sudo make install<br />
</pre><br />
<br />
==== Refresh to a Newer Version ====<br />
<br />
To pull a new version to build <br />
<pre><br />
$ git pull<br />
$ make -j4 all<br />
$ sudo make install<br />
</pre><br />
If extensive changes have occurred or if you get errors during the make, you may want to do a clean build <br />
<pre><br />
$ git pull<br />
$ make distclean<br />
$ sh cleanup.sh<br />
$ autoreconf -i<br />
$ ./configure<br />
$ make -j4 all<br />
$ sudo make install<br />
</pre><br />
If you continue to get errors, please report the whole ./configure output and the config.log to the mailing list.<br />
<br />
== Installation on Windows ==<br />
See [[ QtRadio on Windows]]<br />
<br />
==VirtualBox (the easy way to get up and running)==<br />
<br />
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.<br />
<br />
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. <br />
<br />
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."<br />
<br />
The [[Dspserver.conf]] file should be edited to personalize your server, and to allow transmit. <br />
<br />
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.<br />
<br />
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.<br />
<br />
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.<br />
<br />
===Software=== <br />
***** START AT THE BEGINNING WHEN BUILDING THE SOFTWARE -- i.e Section 1 and install all the packages recommended and do the pulseaudio setup.<br />
<br />
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.<br />
<br />
Subject: [n2adr-sdr] Raspberry Pi running ghpsdr3-alex<br />
<br />
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.<br />
<br />
<br />
autoreconf -i <br />
<br />
./configure CFLAGS='-O3 -pipe -march=armv6 -mfpu=vfp -mfloat-abi=hard' CXXFLAGS='-O3 -pipe -march=armv6 -mfpu=vfp -mfloat-abi=hard' <br />
<br />
**** Additional steps needed when building rtlsdr-server. Do these before running make ******<br />
# export ac_cv_func_malloc_0_nonnull=yes<br />
# export ac_cv_func_realloc_0_nonnull=yes<br />
<br />
<br />
make all && make all install <br />
<br />
<br />
Sound on the Raspberry Pi is still a problem I have not been able to solve.<br />
<br />
Terry (WB4JFI) suggested the following that work for him but I have had no luck with it.<br />
<br />
"amixer cset numid=3 1"<br />
<br />
Other valid numid's are 0=auto, 1=headphones and 2=hdmi.<br />
<br />
<br />
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.<br />
<br />
When a slave connected and tried changing frequency, dspserver crashed - dspserver can be a bit crash happy.<br />
<br />
The first thing I tried on the Pi was QtRadio standalone, spectrum and waterfall were OK but no sound.<br />
<br />
Just now a client using glSDR (5) is attempting to change frequency, sound went quite distorted then dspserver crashed.<br />
<br />
Restarted dspserver and QtRadio sound started very distorted before it settled down to reasonable.<br />
<br />
== Network settings ==<br />
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.<br />
<br />
<br />
<br />
<br />
== Installing ghpsdr3-alex on Raspberry Pi == <br />
<br />
<br />
===Hardware===<br />
<br />
*** THIS SECTION DEALS WITH Raspberry Pi DIFFERENCES *** IT DOES NOT CIRCUMVENT THE INSTRUCTIONS STARTING AT STEP 1 OF THE QtRadio Installation. ***<br />
<br />
I recommend installing either the raspbian or raspbian pisces (debian) distributions as there is no Ubuntu release to date.<br />
<br />
*** 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 <br />
document from the beginning after installing raspbian or raspbian pisces.<br />
<br />
<br />
The RasPi USB subsystem is sensitive to power supply voltage levels - A supply of 5.5V at 2A is recommended. <br />
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. <br />
<br />
Measuring the voltage across TP1 and TP2 on the Raspberry Pi and increased it to +4.97V (P.S output +5.59V).<br />
<br />
I also ran "rpi-update" which install new firmware. <br />
<br />
I shorted out the polyfuses F1 and F2 on the Pi and USB is much more stable but still limited.<br />
<br />
With keyboard, mouse, gigabit USB Ethernet, SB Live! 24 USB and RTL-SDR dongle it runs for some hours before it freezes.<br />
<br />
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.<br />
<br />
root@pisces:/usr/src/GHPSDR3_HIGH_SPEED_MASTER/ghpsdr3-alex# date<br />
<br />
Sun Sep 9 13:00:49 BST 2012<br />
<br />
root@pisces:/usr/src/GHPSDR3_HIGH_SPEED_MASTER/ghpsdr3-alex# uptime<br />
<br />
13:00:56 up 2 days, 20:46, 8 users, load average: 0.81, 1.01, 0.67<br />
<br />
<br />
<br />
<br />
****** Do not use power from a USB PC port or from a USB Hub. ********<br />
<br />
<br />
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):-<br />
<br />
Keyboard, mouse, usb sound card, RTL-SDR TV dongle and USB Gigabit Ethernet fully operational using the 7-port powered USB hub.<br />
<br />
root@pisces:~# lsusb<br />
<br />
Bus 001 Device 001: ID 1d6b:0002 Linux Foundation 2.0 root hub<br />
<br />
Bus 001 Device 002: ID 0424:9512 Standard Microsystems Corp. <br />
<br />
Bus 001 Device 003: ID 0424:ec00 Standard Microsystems Corp.<br />
<br />
Bus 001 Device 004: ID 04cc:1521 ST-Ericsson USB 2.0 Hub<br />
<br />
Bus 001 Device 011: ID 04f3:0103 Elan Microelectronics Corp. <br />
<br />
Bus 001 Device 006: ID 047d:1022 Kensington Orbit Optical<br />
<br />
Bus 001 Device 007: ID 1d19:1101 Dexatek Technology Ltd. DK DVB-T Dongle<br />
<br />
Bus 001 Device 008: ID 041e:3040 Creative Technology, Ltd SoundBlaster Live! 24-bit External SB0490<br />
<br />
Bus 001 Device 009: ID 0b95:1780 ASIX Electronics Corp. AX88178<br />
root@pisces:~# ifconfig <br />
<br />
eth0 Link encap:Ethernet HWaddr b8:27:eb:2c:07:c9<br />
<br />
inet addr:192.168.10.31 Bcast:192.168.10.255 Mask:255.255.255.0<br />
inet6 addr: fe80::ba27:ebff:fe2c:7c9/64 Scope:Link<br />
UP BROADCAST RUNNING MULTICAST MTU:1500 Metric:1<br />
RX packets:410 errors:0 dropped:0 overruns:0 frame:0<br />
TX packets:377 errors:0 dropped:0 overruns:0 carrier:0<br />
collisions:0 txqueuelen:1000<br />
RX bytes:28905 (28.2 KiB) TX bytes:35938 (35.0 KiB)<br />
<br />
eth1 Link encap:Ethernet HWaddr 00:10:14:00:9f:fa<br />
<br />
inet addr:192.168.2.199 Bcast:192.168.2.255 Mask:255.255.255.0<br />
inet6 addr: fe80::210:14ff:fe00:9ffa/64 Scope:Link<br />
UP BROADCAST RUNNING MULTICAST MTU:1500 Metric:1<br />
RX packets:5 errors:0 dropped:0 overruns:0 frame:0<br />
TX packets:7 errors:0 dropped:0 overruns:0 carrier:0<br />
collisions:0 txqueuelen:1000<br />
RX bytes:230 (230.0 B) TX bytes:592 (592.0 B)<br />
<br />
lo Link encap:Local Loopback<br />
<br />
inet addr:127.0.0.1 Mask:255.0.0.0<br />
inet6 addr: ::1/128 Scope:Host<br />
UP LOOPBACK RUNNING MTU:16436 Metric:1<br />
RX packets:0 errors:0 dropped:0 overruns:0 frame:0<br />
TX packets:0 errors:0 dropped:0 overruns:0 carrier:0<br />
collisions:0 txqueuelen:0<br />
RX bytes:0 (0.0 B) TX bytes:0 (0.0 B)<br />
<br />
root@pisces:~# cat /proc/asound/cards<br />
0 [ALSA ]: BRCM bcm2835 ALSbcm2835 ALSA - bcm2835 ALSA<br />
bcm2835 ALSA<br />
<br />
1 [External ]: USB-Audio - SB Live! 24-bit External<br />
Creative Technology SB Live! 24-bit External at usb-bcm2708_usb-1.2.2, full spe<br />
<br />
<br />
<br />
<br />
It's running at 855MHz with this config.txt file. <br />
root@pisces:~# cat /boot/config.txt<br />
<br />
over_voltage=6<br />
<br />
arm_freq=855<br />
<br />
core_freq=500<br />
<br />
sdram_freq=500<br />
<br />
<br />
root@pisces:~# cat /etc/network/interfaces<br />
<br />
Used by ifup(8) and ifdown(8). See the interfaces(5) manpage or<br />
/usr/share/doc/ifupdown/examples for more information. <br />
<br />
auto lo<br />
<br />
<br />
iface lo inet loopback<br />
<br />
<br />
File: ifcfg-eth0<br />
<br />
auto eth0<br />
<br />
iface eth0 inet static<br />
<br />
address 192.168.10.31<br />
<br />
netmask 255.255.255.0<br />
<br />
gateway 192.168.10.103<br />
<br />
<br />
auto eth1<br />
<br />
iface eth1 inet static<br />
<br />
address 192.168.2.199<br />
<br />
netmask 255.255.255.0<br />
<br />
<br />
root@pisces:~# cat /etc/modules<br />
<br />
/etc/modules: kernel modules to load at boot time.<br />
This file contains the names of kernel modules that should be loaded<br />
at boot time, one per line. Lines beginning with "#" are ignored.<br />
Parameters can be specified after the module name. <br />
<br />
loop<br />
<br />
snd-bcm2835<br />
<br />
<br />
One problem remains, no sound from the on-board chip.<br />
<br />
==VirtualBox (the easy way to get up and running)==<br />
<br />
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.<br />
<br />
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. <br />
<br />
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."<br />
<br />
The [[Dspserver.conf]] file should be edited to personalize your server, and to allow transmit. <br />
<br />
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.<br />
<br />
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.<br />
<br />
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.<br />
<br />
===Software=== <br />
***** START AT THE BEGINNING WHEN BUILDING THE SOFTWARE -- i.e Section 1 and install all the packages recommended and do the pulseaudio setup.<br />
<br />
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.<br />
<br />
Subject: [n2adr-sdr] Raspberry Pi running ghpsdr3-alex<br />
<br />
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.<br />
<br />
<br />
autoreconf -i <br />
<br />
./configure CFLAGS='-O3 -pipe -march=armv6 -mfpu=vfp -mfloat-abi=hard' CXXFLAGS='-O3 -pipe -march=armv6 -mfpu=vfp -mfloat-abi=hard' <br />
<br />
**** Additional steps needed when building rtlsdr-server. Do these before running make ******<br />
# export ac_cv_func_malloc_0_nonnull=yes<br />
# export ac_cv_func_realloc_0_nonnull=yes<br />
<br />
<br />
make all && make all install <br />
<br />
<br />
Sound on the Raspberry Pi is still a problem I have not been able to solve.<br />
<br />
Terry (WB4JFI) suggested the following that work for him but I have had no luck with it.<br />
<br />
"amixer cset numid=3 1"<br />
<br />
Other valid numid's are 0=auto, 1=headphones and 2=hdmi.<br />
<br />
<br />
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.<br />
<br />
When a slave connected and tried changing frequency, dspserver crashed - dspserver can be a bit crash happy.<br />
<br />
The first thing I tried on the Pi was QtRadio standalone, spectrum and waterfall were OK but no sound.<br />
<br />
Just now a client using glSDR (5) is attempting to change frequency, sound went quite distorted then dspserver crashed.<br />
<br />
Restarted dspserver and QtRadio sound started very distorted before it settled down to reasonable.</div>Frohrohttps://napan.ca/ghpsdr3/index.php?title=QtRadio_Installation&diff=768QtRadio Installation2013-08-27T13:42:10Z<p>Frohro: /* Installing ghpsdr3-alex on Raspberry Pi */</p>
<hr />
<div>== Installation on Linux ==<br />
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.<br />
<br />
<br />
<br />
<br />
=== Installation from Git ===<br />
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.<br />
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.<br />
<br />
==== Installing compiler and autotool ====<br />
<br />
First off, install the compiler; depending on which distribution are you using, some or all of this stuff could be already installed: <br />
<br />
===== Ubuntu/Debian =====<br />
<pre><br />
sudo apt-get install make gcc g++<br />
sudo apt-get install autoconf automake autotools-dev libtool git subversion<br />
</pre><br />
<br />
===== Fedora =====<br />
<pre><br />
sudo yum install gcc gcc-c++ man-pages autoconf automake subversion libtool git<br />
</pre><br />
<br />
==== Installing prerequisite packages ====<br />
<br />
===== Ubuntu 12.04 and newer =====<br />
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:<br />
<br />
<pre><br />
sudo apt-get update<br />
sudo apt-get install \<br />
libqt4-opengl-dev \<br />
qtmobility-dev \<br />
libusb-0.1-4 \<br />
libusb-dev \<br />
libfftw3-dev \<br />
portaudio19-dev \<br />
libpulse-dev \<br />
libsamplerate0-dev \<br />
libusb-1.0-0-dev \<br />
libconfig8-dev \<br />
xdg-utils \<br />
libortp-dev \<br />
gcc-multilib \<br />
libssl-dev \<br />
libevent-dev \<br />
libglu1-mesa-dev \<br />
freeglut3-dev<br />
</pre><br />
<br />
You will need qt5 installed to complete the build.<br />
<br />
Visit: http://qt-project.org/downloads<br />
<br />
download the current package for your system.<br />
<br />
To build Qt5 on a RaspberryPi visit: http://qt-project.org/wiki/RaspberryPi<br />
<br />
After downloading it go to the download directory and do:<br />
<pre><br />
$ chmod +x the-name-of-the-downloaded-file<br />
$ sudo ./the-name-of-the-downloaded-file<br />
</pre><br />
<br />
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:<br />
<pre><br />
$ export PATH=/opt/Qt5.1.0/5.1.0/gcc_64/bin:/opt/Qt5.1.0/Tools/QtCreator/bin:$PATH<br />
</pre><br />
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.<br />
In any case please remember that<br />
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<br />
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.<br />
For the bash it is typically ~/.bashrc<br />
In any case, after you issue the export, please test it.<br />
<pre><br />
qmake -v<br />
QMake version 2.01a<br />
Using Qt version 4.8.0 in /home/andrew/QtSDK4.8x/Desktop/Qt/4.8.0/gcc/lib<br />
</pre><br />
<br />
===== Ubuntu 11.04 and older ===== <br />
First of all, you have to check that the ''universe repository'' is enabled.<br />
Please see the procedure in the previous section [[#graphical installation]] .<br />
<br />
Next, you will need the following packages installed:<br />
<br />
<pre><br />
sudo apt-get update<br />
sudo apt-get install \<br />
libqt4-opengl-dev \<br />
qtmobility-dev \<br />
libusb-0.1-4 \<br />
libusb-dev \<br />
libfftw3-dev \<br />
portaudio19-dev \<br />
libpulse-dev \<br />
libsamplerate0-dev \<br />
libusb-1.0-0-dev \<br />
libconfig8-dev \<br />
libortp-dev<br />
</pre><br />
<br />
===== Ubuntu 11.10 ===== <br />
First of all, you have to check that the ''universe repository'' is enabled.<br />
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.<br />
Next, submit the following commands into a terminal window:<br />
<br />
<pre><br />
sudo apt-get update<br />
sudo apt-get install \<br />
libqt4-opengl-dev \<br />
qtmobility-dev \<br />
libusb-0.1-4 \<br />
libusb-dev \<br />
libfftw3-dev \<br />
portaudio19-dev \<br />
libpulse-dev \<br />
libsamplerate0-dev \<br />
libusb-1.0-0-dev \<br />
libconfig8-dev \<br />
xdg-utils \<br />
libortp-dev<br />
</pre><br />
<br />
===== Fedora 16 =====<br />
<br />
<pre><br />
sudo yum install fftw fftw-devel <br />
sudo yum install libusb-devel libusb1-devel <br />
sudo yum install portaudio-devel<br />
sudo yum install libconfig-devel<br />
sudo yum install libsamplerate-devel<br />
sudo yum install pulseaudio-libs-devel<br />
sudo yum install jack-audio-connection-kit jack-audio-connection-kit-devel<br />
sudo yum install qt4-devel<br />
</pre><br />
<br />
<br />
==== Cloning the repository ====<br />
<br />
How to build the latest master branch on Ubuntu 11.04<br />
<br />
First a new libevent will need to be downloaded and installed, then the actual QtRadio source can be downloaded and built.<br />
<br />
==== Obtaining an up-level libevent library ====<br />
<br />
$ sudo apt-get install libevent-dev<br />
<br />
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)<br />
<br />
Then download the new version from:<br />
<br />
http://libevent.org/<br />
<br />
libevent-2.0.16-stable.tar.gz<br />
<br />
<pre><br />
wget https://github.com/downloads/libevent/libevent/libevent-2.0.16-stable.tar.gz<br />
</pre><br />
<br />
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:<br />
<br />
<pre><br />
cd<br />
tar -zxvf libevent-2.0.16-stable.tar.gz<br />
cd libevent-2.0.16-stable<br />
./configure<br />
make<br />
sudo make install<br />
sudo ldconfig<br />
</pre><br />
<br />
On Fedora, in order to use the library above, export the LD_LIBRARY_PATH:<br />
<br />
<pre><br />
export LD_LIBRARY_PATH=/usr/local/lib<br />
</pre><br />
<br />
==== Installing codec2 low bit rate audio encoding and decoding ====<br />
<br />
We are adding a low bit rate audio codec called codec 2 to QtRadio/dspserver. You need<br />
to download and build the codec2 library. See:<br />
<br />
http://www.rowetel.com/blog/?page_id=452<br />
<p><br />
Now go get codec2 using subversion<br />
<br />
<pre><br />
cd<br />
svn co https://freetel.svn.sourceforge.net/svnroot/freetel/codec2-dev codec2-dev<br />
cd codec2-dev<br />
autoreconf -i<br />
./configure<br />
make<br />
sudo make install<br />
sudo ldconfig<br />
</pre><br />
<br />
On Fedora, in order to use the library above, export the LD_LIBRARY_PATH:<br />
<br />
<pre><br />
export LD_LIBRARY_PATH=/usr/local/lib<br />
</pre><br />
<br />
==== Building the master branch ====<br />
<br />
This branch is the latest code that contains both RX and TX capability. <br />
<br />
Create a new directory or cd to the ~/src directory created for libevent and cd into it.<br />
<br />
<pre><br />
git clone git://github.com/alexlee188/ghpsdr3-alex<br />
</pre><br />
<br />
Depending on your Internet connection thorughput, it will take several minute to download.<br />
cd into the new directory ghpsdr3-alex:<br />
<pre><br />
cd ghpsdr3-alex<br />
git checkout master<br />
</pre><br />
You are now working with Alex's latest and greatest!<br />
<br />
First set the path to the version of qt you are using. E.g. for qt5:<br />
<pre><br />
$ export PATH=/opt/qt5/bin:$PATH<br />
</pre><br />
<br />
Then:<br />
<pre><br />
autoreconf -i<br />
./configure<br />
make -j4 all<br />
sudo make install<br />
</pre><br />
The default configure above builds with debug and default Qt4 version in your PC. For optimized executable,<br />
you need to specify options specific to your system. See the sample shell scripts that replaces the above<br />
./configure step:<br />
<br />
<pre><br />
./alex-avx-conf.sh for building with i3,i5 and i7 cpu's supporting Advanced Vector Extensions (AVX)<br />
./alex-openmp-conf.sh for building with i3,i5 and i7 cpu's and OpenMP support<br />
./alex-sse3-conf.sh for building with SSE3 capable cpu's<br />
./alex-openmp-sse3-conf.sh for building with SSE3 cpaable cpu's and OpenMP support<br />
</pre><br />
<br />
(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)<br />
<pre><br />
Terminal 1<br />
$ cd ghpsdr3-alex/trunk/src/softrock<br />
$ ./softrock ...options ...<br />
<br />
Terminal 2<br />
$ cd ghpsdr3-alex/trunk/src/dspserver<br />
$ ./dspserver ..options...<br />
<br />
Terminal 3<br />
$ cd ghpsdr3-alex/trunk/src/QtRadio<br />
$ ./QtRadio<br />
</pre><br />
<br />
==== Building the Perseus extensions ====<br />
<br />
In order to build the Microtelecom Perseus server you need to switch to the master or iw0hdv branch. <br />
<br />
First off, install the prerequisite library and wget package:<br />
<br />
<pre><br />
sudo apt-get install libboost-all-dev wget<br />
</pre><br />
<br />
Next download, compile and install the library libperseus-sdr:<br />
<br />
<pre><br />
cd<br />
wget http://libperseus-sdr.googlecode.com/files/libperseus_sdr-0.6.tar.gz<br />
tar -zxvf libperseus_sdr-0.6.tar.gz<br />
cd libperseus_sdr-0.6/<br />
./configure && make<br />
sudo make install<br />
sudo ldconfig<br />
</pre><br />
<br />
<br />
If you already build in your sandbox some other branch, is strongly advisable, before you start the build, to do a full cleanup:<br />
<pre><br />
cd ~/ghpsdr3-alex<br />
make distcheck && sh cleanup.sh<br />
</pre><br />
<br />
Otherwise, if you are starting from scratch, you have to clone the repository:<br />
<br />
<pre><br />
git clone git://github.com/alexlee188/ghpsdr3-alex<br />
</pre><br />
<br />
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.<br />
<br />
<pre><br />
cd ~/ghpsdr3-alex<br />
git checkout master<br />
autoreconf -i && ./configure && make -j4<br />
sudo make install<br />
</pre><br />
<br />
In order to run it you have two choices, the first one being the plain command line:<br />
<br />
<pre><br />
xterm -e 'perseus_server -d3 -s96000 ' &<br />
sleep 3<br />
xterm -e 'dspserver --lo 0 --nocorrectiq' &<br />
sleep 5<br />
$( QtRadio 127.0.0.1 ) <br />
</pre><br />
<br />
In QtRadio, Receiver menu, select Configure item, Server tab: here add the local host using the 127.0.0.1 IP address.<br />
Pressing the key C, you start the receiver.<br />
<br />
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.<br />
<br />
==== Building USRP enabled version ====<br />
<br />
===== Building the UHD package =====<br />
<br />
<br />
====== Install the prerequisite packages (Ubuntu 11.10): ======<br />
<br />
<pre><br />
sudo apt-get install liboost-all-dev<br />
sudo apt-get install python-cheetah<br />
</pre><br />
<br />
====== Build & Install UHD -- FOR UHD-3.3.1 AND GREATER --: ======<br />
<br />
<pre><br />
cd<br />
git clone git://ettus.sourcerepo.com/ettus/uhd.git<br />
cd uhd/host/<br />
mkdir build<br />
cd build<br />
cmake ../<br />
make<br />
make test<br />
sudo make install<br />
sudo ldconfig<br />
</pre><br />
<br />
If you already build in your sandbox some other branch, is strongly advisable, before you start the build, to do a full cleanup:<br />
<pre><br />
cd ~/ghpsdr3-alex<br />
make distcheck && sh cleanup.sh<br />
</pre><br />
<br />
Otherwise, if you are starting from scratch, first clone the repository:<br />
<br />
<pre><br />
git clone git://github.com/alexlee188/ghpsdr3-alex<br />
</pre><br />
<br />
Finally, you can switch to the master branch and rebuild everything, enabling the usrp server feature:<br />
<pre><br />
cd ~/ghpsdr3-alex<br />
git checkout usrp-server<br />
autoreconf -i && ./configure --enable-usrp=yes && make -j4<br />
sudo make install<br />
</pre><br />
<br />
==== Refresh to a Newer Version ====<br />
<br />
To pull a new version to build <br />
<pre><br />
$ git pull<br />
$ make -j4 all<br />
$ sudo make install<br />
</pre><br />
If extensive changes have occurred or if you get errors during the make, you may want to do a clean build <br />
<pre><br />
$ git pull<br />
$ make distclean<br />
$ sh cleanup.sh<br />
$ autoreconf -i<br />
$ ./configure<br />
$ make -j4 all<br />
$ sudo make install<br />
</pre><br />
If you continue to get errors, please report the whole ./configure output and the config.log to the mailing list.<br />
<br />
== Installation on Windows ==<br />
See [[ QtRadio on Windows]]<br />
<br />
== Network settings ==<br />
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.<br />
<br />
<br />
<br />
<br />
== Installing ghpsdr3-alex on Raspberry Pi == <br />
<br />
<br />
===Hardware===<br />
<br />
*** THIS SECTION DEALS WITH Raspberry Pi DIFFERENCES *** IT DOES NOT CIRCUMVENT THE INSTRUCTIONS STARTING AT STEP 1 OF THE QtRadio Installation. ***<br />
<br />
I recommend installing either the raspbian or raspbian pisces (debian) distributions as there is no Ubuntu release to date.<br />
<br />
*** 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 <br />
document from the beginning after installing raspbian or raspbian pisces.<br />
<br />
<br />
The RasPi USB subsystem is sensitive to power supply voltage levels - A supply of 5.5V at 2A is recommended. <br />
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. <br />
<br />
Measuring the voltage across TP1 and TP2 on the Raspberry Pi and increased it to +4.97V (P.S output +5.59V).<br />
<br />
I also ran "rpi-update" which install new firmware. <br />
<br />
I shorted out the polyfuses F1 and F2 on the Pi and USB is much more stable but still limited.<br />
<br />
With keyboard, mouse, gigabit USB Ethernet, SB Live! 24 USB and RTL-SDR dongle it runs for some hours before it freezes.<br />
<br />
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.<br />
<br />
root@pisces:/usr/src/GHPSDR3_HIGH_SPEED_MASTER/ghpsdr3-alex# date<br />
<br />
Sun Sep 9 13:00:49 BST 2012<br />
<br />
root@pisces:/usr/src/GHPSDR3_HIGH_SPEED_MASTER/ghpsdr3-alex# uptime<br />
<br />
13:00:56 up 2 days, 20:46, 8 users, load average: 0.81, 1.01, 0.67<br />
<br />
<br />
<br />
<br />
****** Do not use power from a USB PC port or from a USB Hub. ********<br />
<br />
<br />
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):-<br />
<br />
Keyboard, mouse, usb sound card, RTL-SDR TV dongle and USB Gigabit Ethernet fully operational using the 7-port powered USB hub.<br />
<br />
root@pisces:~# lsusb<br />
<br />
Bus 001 Device 001: ID 1d6b:0002 Linux Foundation 2.0 root hub<br />
<br />
Bus 001 Device 002: ID 0424:9512 Standard Microsystems Corp. <br />
<br />
Bus 001 Device 003: ID 0424:ec00 Standard Microsystems Corp.<br />
<br />
Bus 001 Device 004: ID 04cc:1521 ST-Ericsson USB 2.0 Hub<br />
<br />
Bus 001 Device 011: ID 04f3:0103 Elan Microelectronics Corp. <br />
<br />
Bus 001 Device 006: ID 047d:1022 Kensington Orbit Optical<br />
<br />
Bus 001 Device 007: ID 1d19:1101 Dexatek Technology Ltd. DK DVB-T Dongle<br />
<br />
Bus 001 Device 008: ID 041e:3040 Creative Technology, Ltd SoundBlaster Live! 24-bit External SB0490<br />
<br />
Bus 001 Device 009: ID 0b95:1780 ASIX Electronics Corp. AX88178<br />
root@pisces:~# ifconfig <br />
<br />
eth0 Link encap:Ethernet HWaddr b8:27:eb:2c:07:c9<br />
<br />
inet addr:192.168.10.31 Bcast:192.168.10.255 Mask:255.255.255.0<br />
inet6 addr: fe80::ba27:ebff:fe2c:7c9/64 Scope:Link<br />
UP BROADCAST RUNNING MULTICAST MTU:1500 Metric:1<br />
RX packets:410 errors:0 dropped:0 overruns:0 frame:0<br />
TX packets:377 errors:0 dropped:0 overruns:0 carrier:0<br />
collisions:0 txqueuelen:1000<br />
RX bytes:28905 (28.2 KiB) TX bytes:35938 (35.0 KiB)<br />
<br />
eth1 Link encap:Ethernet HWaddr 00:10:14:00:9f:fa<br />
<br />
inet addr:192.168.2.199 Bcast:192.168.2.255 Mask:255.255.255.0<br />
inet6 addr: fe80::210:14ff:fe00:9ffa/64 Scope:Link<br />
UP BROADCAST RUNNING MULTICAST MTU:1500 Metric:1<br />
RX packets:5 errors:0 dropped:0 overruns:0 frame:0<br />
TX packets:7 errors:0 dropped:0 overruns:0 carrier:0<br />
collisions:0 txqueuelen:1000<br />
RX bytes:230 (230.0 B) TX bytes:592 (592.0 B)<br />
<br />
lo Link encap:Local Loopback<br />
<br />
inet addr:127.0.0.1 Mask:255.0.0.0<br />
inet6 addr: ::1/128 Scope:Host<br />
UP LOOPBACK RUNNING MTU:16436 Metric:1<br />
RX packets:0 errors:0 dropped:0 overruns:0 frame:0<br />
TX packets:0 errors:0 dropped:0 overruns:0 carrier:0<br />
collisions:0 txqueuelen:0<br />
RX bytes:0 (0.0 B) TX bytes:0 (0.0 B)<br />
<br />
root@pisces:~# cat /proc/asound/cards<br />
0 [ALSA ]: BRCM bcm2835 ALSbcm2835 ALSA - bcm2835 ALSA<br />
bcm2835 ALSA<br />
<br />
1 [External ]: USB-Audio - SB Live! 24-bit External<br />
Creative Technology SB Live! 24-bit External at usb-bcm2708_usb-1.2.2, full spe<br />
<br />
<br />
<br />
<br />
It's running at 855MHz with this config.txt file. <br />
root@pisces:~# cat /boot/config.txt<br />
<br />
over_voltage=6<br />
<br />
arm_freq=855<br />
<br />
core_freq=500<br />
<br />
sdram_freq=500<br />
<br />
<br />
root@pisces:~# cat /etc/network/interfaces<br />
<br />
Used by ifup(8) and ifdown(8). See the interfaces(5) manpage or<br />
/usr/share/doc/ifupdown/examples for more information. <br />
<br />
auto lo<br />
<br />
<br />
iface lo inet loopback<br />
<br />
<br />
File: ifcfg-eth0<br />
<br />
auto eth0<br />
<br />
iface eth0 inet static<br />
<br />
address 192.168.10.31<br />
<br />
netmask 255.255.255.0<br />
<br />
gateway 192.168.10.103<br />
<br />
<br />
auto eth1<br />
<br />
iface eth1 inet static<br />
<br />
address 192.168.2.199<br />
<br />
netmask 255.255.255.0<br />
<br />
<br />
root@pisces:~# cat /etc/modules<br />
<br />
/etc/modules: kernel modules to load at boot time.<br />
This file contains the names of kernel modules that should be loaded<br />
at boot time, one per line. Lines beginning with "#" are ignored.<br />
Parameters can be specified after the module name. <br />
<br />
loop<br />
<br />
snd-bcm2835<br />
<br />
<br />
One problem remains, no sound from the on-board chip.<br />
<br />
==VirtualBox (the easy way to get up and running)==<br />
<br />
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.<br />
<br />
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. <br />
<br />
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."<br />
<br />
The [[Dspserver.conf]] file should be edited to personalize your server, and to allow transmit. <br />
<br />
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.<br />
<br />
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.<br />
<br />
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.<br />
<br />
===Software=== <br />
***** START AT THE BEGINNING WHEN BUILDING THE SOFTWARE -- i.e Section 1 and install all the packages recommended and do the pulseaudio setup.<br />
<br />
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.<br />
<br />
Subject: [n2adr-sdr] Raspberry Pi running ghpsdr3-alex<br />
<br />
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.<br />
<br />
<br />
autoreconf -i <br />
<br />
./configure CFLAGS='-O3 -pipe -march=armv6 -mfpu=vfp -mfloat-abi=hard' CXXFLAGS='-O3 -pipe -march=armv6 -mfpu=vfp -mfloat-abi=hard' <br />
<br />
**** Additional steps needed when building rtlsdr-server. Do these before running make ******<br />
# export ac_cv_func_malloc_0_nonnull=yes<br />
# export ac_cv_func_realloc_0_nonnull=yes<br />
<br />
<br />
make all && make all install <br />
<br />
<br />
Sound on the Raspberry Pi is still a problem I have not been able to solve.<br />
<br />
Terry (WB4JFI) suggested the following that work for him but I have had no luck with it.<br />
<br />
"amixer cset numid=3 1"<br />
<br />
Other valid numid's are 0=auto, 1=headphones and 2=hdmi.<br />
<br />
<br />
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.<br />
<br />
When a slave connected and tried changing frequency, dspserver crashed - dspserver can be a bit crash happy.<br />
<br />
The first thing I tried on the Pi was QtRadio standalone, spectrum and waterfall were OK but no sound.<br />
<br />
Just now a client using glSDR (5) is attempting to change frequency, sound went quite distorted then dspserver crashed.<br />
<br />
Restarted dspserver and QtRadio sound started very distorted before it settled down to reasonable.</div>Frohrohttps://napan.ca/ghpsdr3/index.php?title=QtRadio_Installation&diff=767QtRadio Installation2013-08-27T13:41:32Z<p>Frohro: /* HARDWARE */</p>
<hr />
<div>== Installation on Linux ==<br />
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.<br />
<br />
<br />
<br />
<br />
=== Installation from Git ===<br />
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.<br />
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.<br />
<br />
==== Installing compiler and autotool ====<br />
<br />
First off, install the compiler; depending on which distribution are you using, some or all of this stuff could be already installed: <br />
<br />
===== Ubuntu/Debian =====<br />
<pre><br />
sudo apt-get install make gcc g++<br />
sudo apt-get install autoconf automake autotools-dev libtool git subversion<br />
</pre><br />
<br />
===== Fedora =====<br />
<pre><br />
sudo yum install gcc gcc-c++ man-pages autoconf automake subversion libtool git<br />
</pre><br />
<br />
==== Installing prerequisite packages ====<br />
<br />
===== Ubuntu 12.04 and newer =====<br />
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:<br />
<br />
<pre><br />
sudo apt-get update<br />
sudo apt-get install \<br />
libqt4-opengl-dev \<br />
qtmobility-dev \<br />
libusb-0.1-4 \<br />
libusb-dev \<br />
libfftw3-dev \<br />
portaudio19-dev \<br />
libpulse-dev \<br />
libsamplerate0-dev \<br />
libusb-1.0-0-dev \<br />
libconfig8-dev \<br />
xdg-utils \<br />
libortp-dev \<br />
gcc-multilib \<br />
libssl-dev \<br />
libevent-dev \<br />
libglu1-mesa-dev \<br />
freeglut3-dev<br />
</pre><br />
<br />
You will need qt5 installed to complete the build.<br />
<br />
Visit: http://qt-project.org/downloads<br />
<br />
download the current package for your system.<br />
<br />
To build Qt5 on a RaspberryPi visit: http://qt-project.org/wiki/RaspberryPi<br />
<br />
After downloading it go to the download directory and do:<br />
<pre><br />
$ chmod +x the-name-of-the-downloaded-file<br />
$ sudo ./the-name-of-the-downloaded-file<br />
</pre><br />
<br />
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:<br />
<pre><br />
$ export PATH=/opt/Qt5.1.0/5.1.0/gcc_64/bin:/opt/Qt5.1.0/Tools/QtCreator/bin:$PATH<br />
</pre><br />
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.<br />
In any case please remember that<br />
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<br />
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.<br />
For the bash it is typically ~/.bashrc<br />
In any case, after you issue the export, please test it.<br />
<pre><br />
qmake -v<br />
QMake version 2.01a<br />
Using Qt version 4.8.0 in /home/andrew/QtSDK4.8x/Desktop/Qt/4.8.0/gcc/lib<br />
</pre><br />
<br />
===== Ubuntu 11.04 and older ===== <br />
First of all, you have to check that the ''universe repository'' is enabled.<br />
Please see the procedure in the previous section [[#graphical installation]] .<br />
<br />
Next, you will need the following packages installed:<br />
<br />
<pre><br />
sudo apt-get update<br />
sudo apt-get install \<br />
libqt4-opengl-dev \<br />
qtmobility-dev \<br />
libusb-0.1-4 \<br />
libusb-dev \<br />
libfftw3-dev \<br />
portaudio19-dev \<br />
libpulse-dev \<br />
libsamplerate0-dev \<br />
libusb-1.0-0-dev \<br />
libconfig8-dev \<br />
libortp-dev<br />
</pre><br />
<br />
===== Ubuntu 11.10 ===== <br />
First of all, you have to check that the ''universe repository'' is enabled.<br />
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.<br />
Next, submit the following commands into a terminal window:<br />
<br />
<pre><br />
sudo apt-get update<br />
sudo apt-get install \<br />
libqt4-opengl-dev \<br />
qtmobility-dev \<br />
libusb-0.1-4 \<br />
libusb-dev \<br />
libfftw3-dev \<br />
portaudio19-dev \<br />
libpulse-dev \<br />
libsamplerate0-dev \<br />
libusb-1.0-0-dev \<br />
libconfig8-dev \<br />
xdg-utils \<br />
libortp-dev<br />
</pre><br />
<br />
===== Fedora 16 =====<br />
<br />
<pre><br />
sudo yum install fftw fftw-devel <br />
sudo yum install libusb-devel libusb1-devel <br />
sudo yum install portaudio-devel<br />
sudo yum install libconfig-devel<br />
sudo yum install libsamplerate-devel<br />
sudo yum install pulseaudio-libs-devel<br />
sudo yum install jack-audio-connection-kit jack-audio-connection-kit-devel<br />
sudo yum install qt4-devel<br />
</pre><br />
<br />
<br />
==== Cloning the repository ====<br />
<br />
How to build the latest master branch on Ubuntu 11.04<br />
<br />
First a new libevent will need to be downloaded and installed, then the actual QtRadio source can be downloaded and built.<br />
<br />
==== Obtaining an up-level libevent library ====<br />
<br />
$ sudo apt-get install libevent-dev<br />
<br />
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)<br />
<br />
Then download the new version from:<br />
<br />
http://libevent.org/<br />
<br />
libevent-2.0.16-stable.tar.gz<br />
<br />
<pre><br />
wget https://github.com/downloads/libevent/libevent/libevent-2.0.16-stable.tar.gz<br />
</pre><br />
<br />
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:<br />
<br />
<pre><br />
cd<br />
tar -zxvf libevent-2.0.16-stable.tar.gz<br />
cd libevent-2.0.16-stable<br />
./configure<br />
make<br />
sudo make install<br />
sudo ldconfig<br />
</pre><br />
<br />
On Fedora, in order to use the library above, export the LD_LIBRARY_PATH:<br />
<br />
<pre><br />
export LD_LIBRARY_PATH=/usr/local/lib<br />
</pre><br />
<br />
==== Installing codec2 low bit rate audio encoding and decoding ====<br />
<br />
We are adding a low bit rate audio codec called codec 2 to QtRadio/dspserver. You need<br />
to download and build the codec2 library. See:<br />
<br />
http://www.rowetel.com/blog/?page_id=452<br />
<p><br />
Now go get codec2 using subversion<br />
<br />
<pre><br />
cd<br />
svn co https://freetel.svn.sourceforge.net/svnroot/freetel/codec2-dev codec2-dev<br />
cd codec2-dev<br />
autoreconf -i<br />
./configure<br />
make<br />
sudo make install<br />
sudo ldconfig<br />
</pre><br />
<br />
On Fedora, in order to use the library above, export the LD_LIBRARY_PATH:<br />
<br />
<pre><br />
export LD_LIBRARY_PATH=/usr/local/lib<br />
</pre><br />
<br />
==== Building the master branch ====<br />
<br />
This branch is the latest code that contains both RX and TX capability. <br />
<br />
Create a new directory or cd to the ~/src directory created for libevent and cd into it.<br />
<br />
<pre><br />
git clone git://github.com/alexlee188/ghpsdr3-alex<br />
</pre><br />
<br />
Depending on your Internet connection thorughput, it will take several minute to download.<br />
cd into the new directory ghpsdr3-alex:<br />
<pre><br />
cd ghpsdr3-alex<br />
git checkout master<br />
</pre><br />
You are now working with Alex's latest and greatest!<br />
<br />
First set the path to the version of qt you are using. E.g. for qt5:<br />
<pre><br />
$ export PATH=/opt/qt5/bin:$PATH<br />
</pre><br />
<br />
Then:<br />
<pre><br />
autoreconf -i<br />
./configure<br />
make -j4 all<br />
sudo make install<br />
</pre><br />
The default configure above builds with debug and default Qt4 version in your PC. For optimized executable,<br />
you need to specify options specific to your system. See the sample shell scripts that replaces the above<br />
./configure step:<br />
<br />
<pre><br />
./alex-avx-conf.sh for building with i3,i5 and i7 cpu's supporting Advanced Vector Extensions (AVX)<br />
./alex-openmp-conf.sh for building with i3,i5 and i7 cpu's and OpenMP support<br />
./alex-sse3-conf.sh for building with SSE3 capable cpu's<br />
./alex-openmp-sse3-conf.sh for building with SSE3 cpaable cpu's and OpenMP support<br />
</pre><br />
<br />
(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)<br />
<pre><br />
Terminal 1<br />
$ cd ghpsdr3-alex/trunk/src/softrock<br />
$ ./softrock ...options ...<br />
<br />
Terminal 2<br />
$ cd ghpsdr3-alex/trunk/src/dspserver<br />
$ ./dspserver ..options...<br />
<br />
Terminal 3<br />
$ cd ghpsdr3-alex/trunk/src/QtRadio<br />
$ ./QtRadio<br />
</pre><br />
<br />
==== Building the Perseus extensions ====<br />
<br />
In order to build the Microtelecom Perseus server you need to switch to the master or iw0hdv branch. <br />
<br />
First off, install the prerequisite library and wget package:<br />
<br />
<pre><br />
sudo apt-get install libboost-all-dev wget<br />
</pre><br />
<br />
Next download, compile and install the library libperseus-sdr:<br />
<br />
<pre><br />
cd<br />
wget http://libperseus-sdr.googlecode.com/files/libperseus_sdr-0.6.tar.gz<br />
tar -zxvf libperseus_sdr-0.6.tar.gz<br />
cd libperseus_sdr-0.6/<br />
./configure && make<br />
sudo make install<br />
sudo ldconfig<br />
</pre><br />
<br />
<br />
If you already build in your sandbox some other branch, is strongly advisable, before you start the build, to do a full cleanup:<br />
<pre><br />
cd ~/ghpsdr3-alex<br />
make distcheck && sh cleanup.sh<br />
</pre><br />
<br />
Otherwise, if you are starting from scratch, you have to clone the repository:<br />
<br />
<pre><br />
git clone git://github.com/alexlee188/ghpsdr3-alex<br />
</pre><br />
<br />
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.<br />
<br />
<pre><br />
cd ~/ghpsdr3-alex<br />
git checkout master<br />
autoreconf -i && ./configure && make -j4<br />
sudo make install<br />
</pre><br />
<br />
In order to run it you have two choices, the first one being the plain command line:<br />
<br />
<pre><br />
xterm -e 'perseus_server -d3 -s96000 ' &<br />
sleep 3<br />
xterm -e 'dspserver --lo 0 --nocorrectiq' &<br />
sleep 5<br />
$( QtRadio 127.0.0.1 ) <br />
</pre><br />
<br />
In QtRadio, Receiver menu, select Configure item, Server tab: here add the local host using the 127.0.0.1 IP address.<br />
Pressing the key C, you start the receiver.<br />
<br />
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.<br />
<br />
==== Building USRP enabled version ====<br />
<br />
===== Building the UHD package =====<br />
<br />
<br />
====== Install the prerequisite packages (Ubuntu 11.10): ======<br />
<br />
<pre><br />
sudo apt-get install liboost-all-dev<br />
sudo apt-get install python-cheetah<br />
</pre><br />
<br />
====== Build & Install UHD -- FOR UHD-3.3.1 AND GREATER --: ======<br />
<br />
<pre><br />
cd<br />
git clone git://ettus.sourcerepo.com/ettus/uhd.git<br />
cd uhd/host/<br />
mkdir build<br />
cd build<br />
cmake ../<br />
make<br />
make test<br />
sudo make install<br />
sudo ldconfig<br />
</pre><br />
<br />
If you already build in your sandbox some other branch, is strongly advisable, before you start the build, to do a full cleanup:<br />
<pre><br />
cd ~/ghpsdr3-alex<br />
make distcheck && sh cleanup.sh<br />
</pre><br />
<br />
Otherwise, if you are starting from scratch, first clone the repository:<br />
<br />
<pre><br />
git clone git://github.com/alexlee188/ghpsdr3-alex<br />
</pre><br />
<br />
Finally, you can switch to the master branch and rebuild everything, enabling the usrp server feature:<br />
<pre><br />
cd ~/ghpsdr3-alex<br />
git checkout usrp-server<br />
autoreconf -i && ./configure --enable-usrp=yes && make -j4<br />
sudo make install<br />
</pre><br />
<br />
==== Refresh to a Newer Version ====<br />
<br />
To pull a new version to build <br />
<pre><br />
$ git pull<br />
$ make -j4 all<br />
$ sudo make install<br />
</pre><br />
If extensive changes have occurred or if you get errors during the make, you may want to do a clean build <br />
<pre><br />
$ git pull<br />
$ make distclean<br />
$ sh cleanup.sh<br />
$ autoreconf -i<br />
$ ./configure<br />
$ make -j4 all<br />
$ sudo make install<br />
</pre><br />
If you continue to get errors, please report the whole ./configure output and the config.log to the mailing list.<br />
<br />
== Installation on Windows ==<br />
See [[ QtRadio on Windows]]<br />
<br />
== Network settings ==<br />
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.<br />
<br />
<br />
<br />
<br />
== Installing ghpsdr3-alex on Raspberry Pi == <br />
<br />
<br />
===HARDWARE===<br />
<br />
*** THIS SECTION DEALS WITH Raspberry Pi DIFFERENCES *** IT DOES NOT CIRCUMVENT THE INSTRUCTIONS STARTING AT STEP 1 OF THE QtRadio Installation. ***<br />
<br />
I recommend installing either the raspbian or raspbian pisces (debian) distributions as there is no Ubuntu release to date.<br />
<br />
*** 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 <br />
document from the beginning after installing raspbian or raspbian pisces.<br />
<br />
<br />
The RasPi USB subsystem is sensitive to power supply voltage levels - A supply of 5.5V at 2A is recommended. <br />
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. <br />
<br />
Measuring the voltage across TP1 and TP2 on the Raspberry Pi and increased it to +4.97V (P.S output +5.59V).<br />
<br />
I also ran "rpi-update" which install new firmware. <br />
<br />
I shorted out the polyfuses F1 and F2 on the Pi and USB is much more stable but still limited.<br />
<br />
With keyboard, mouse, gigabit USB Ethernet, SB Live! 24 USB and RTL-SDR dongle it runs for some hours before it freezes.<br />
<br />
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.<br />
<br />
root@pisces:/usr/src/GHPSDR3_HIGH_SPEED_MASTER/ghpsdr3-alex# date<br />
<br />
Sun Sep 9 13:00:49 BST 2012<br />
<br />
root@pisces:/usr/src/GHPSDR3_HIGH_SPEED_MASTER/ghpsdr3-alex# uptime<br />
<br />
13:00:56 up 2 days, 20:46, 8 users, load average: 0.81, 1.01, 0.67<br />
<br />
<br />
<br />
<br />
****** Do not use power from a USB PC port or from a USB Hub. ********<br />
<br />
<br />
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):-<br />
<br />
Keyboard, mouse, usb sound card, RTL-SDR TV dongle and USB Gigabit Ethernet fully operational using the 7-port powered USB hub.<br />
<br />
root@pisces:~# lsusb<br />
<br />
Bus 001 Device 001: ID 1d6b:0002 Linux Foundation 2.0 root hub<br />
<br />
Bus 001 Device 002: ID 0424:9512 Standard Microsystems Corp. <br />
<br />
Bus 001 Device 003: ID 0424:ec00 Standard Microsystems Corp.<br />
<br />
Bus 001 Device 004: ID 04cc:1521 ST-Ericsson USB 2.0 Hub<br />
<br />
Bus 001 Device 011: ID 04f3:0103 Elan Microelectronics Corp. <br />
<br />
Bus 001 Device 006: ID 047d:1022 Kensington Orbit Optical<br />
<br />
Bus 001 Device 007: ID 1d19:1101 Dexatek Technology Ltd. DK DVB-T Dongle<br />
<br />
Bus 001 Device 008: ID 041e:3040 Creative Technology, Ltd SoundBlaster Live! 24-bit External SB0490<br />
<br />
Bus 001 Device 009: ID 0b95:1780 ASIX Electronics Corp. AX88178<br />
root@pisces:~# ifconfig <br />
<br />
eth0 Link encap:Ethernet HWaddr b8:27:eb:2c:07:c9<br />
<br />
inet addr:192.168.10.31 Bcast:192.168.10.255 Mask:255.255.255.0<br />
inet6 addr: fe80::ba27:ebff:fe2c:7c9/64 Scope:Link<br />
UP BROADCAST RUNNING MULTICAST MTU:1500 Metric:1<br />
RX packets:410 errors:0 dropped:0 overruns:0 frame:0<br />
TX packets:377 errors:0 dropped:0 overruns:0 carrier:0<br />
collisions:0 txqueuelen:1000<br />
RX bytes:28905 (28.2 KiB) TX bytes:35938 (35.0 KiB)<br />
<br />
eth1 Link encap:Ethernet HWaddr 00:10:14:00:9f:fa<br />
<br />
inet addr:192.168.2.199 Bcast:192.168.2.255 Mask:255.255.255.0<br />
inet6 addr: fe80::210:14ff:fe00:9ffa/64 Scope:Link<br />
UP BROADCAST RUNNING MULTICAST MTU:1500 Metric:1<br />
RX packets:5 errors:0 dropped:0 overruns:0 frame:0<br />
TX packets:7 errors:0 dropped:0 overruns:0 carrier:0<br />
collisions:0 txqueuelen:1000<br />
RX bytes:230 (230.0 B) TX bytes:592 (592.0 B)<br />
<br />
lo Link encap:Local Loopback<br />
<br />
inet addr:127.0.0.1 Mask:255.0.0.0<br />
inet6 addr: ::1/128 Scope:Host<br />
UP LOOPBACK RUNNING MTU:16436 Metric:1<br />
RX packets:0 errors:0 dropped:0 overruns:0 frame:0<br />
TX packets:0 errors:0 dropped:0 overruns:0 carrier:0<br />
collisions:0 txqueuelen:0<br />
RX bytes:0 (0.0 B) TX bytes:0 (0.0 B)<br />
<br />
root@pisces:~# cat /proc/asound/cards<br />
0 [ALSA ]: BRCM bcm2835 ALSbcm2835 ALSA - bcm2835 ALSA<br />
bcm2835 ALSA<br />
<br />
1 [External ]: USB-Audio - SB Live! 24-bit External<br />
Creative Technology SB Live! 24-bit External at usb-bcm2708_usb-1.2.2, full spe<br />
<br />
<br />
<br />
<br />
It's running at 855MHz with this config.txt file. <br />
root@pisces:~# cat /boot/config.txt<br />
<br />
over_voltage=6<br />
<br />
arm_freq=855<br />
<br />
core_freq=500<br />
<br />
sdram_freq=500<br />
<br />
<br />
root@pisces:~# cat /etc/network/interfaces<br />
<br />
Used by ifup(8) and ifdown(8). See the interfaces(5) manpage or<br />
/usr/share/doc/ifupdown/examples for more information. <br />
<br />
auto lo<br />
<br />
<br />
iface lo inet loopback<br />
<br />
<br />
File: ifcfg-eth0<br />
<br />
auto eth0<br />
<br />
iface eth0 inet static<br />
<br />
address 192.168.10.31<br />
<br />
netmask 255.255.255.0<br />
<br />
gateway 192.168.10.103<br />
<br />
<br />
auto eth1<br />
<br />
iface eth1 inet static<br />
<br />
address 192.168.2.199<br />
<br />
netmask 255.255.255.0<br />
<br />
<br />
root@pisces:~# cat /etc/modules<br />
<br />
/etc/modules: kernel modules to load at boot time.<br />
This file contains the names of kernel modules that should be loaded<br />
at boot time, one per line. Lines beginning with "#" are ignored.<br />
Parameters can be specified after the module name. <br />
<br />
loop<br />
<br />
snd-bcm2835<br />
<br />
<br />
One problem remains, no sound from the on-board chip.<br />
<br />
==VirtualBox (the easy way to get up and running)==<br />
<br />
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.<br />
<br />
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. <br />
<br />
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."<br />
<br />
The [[Dspserver.conf]] file should be edited to personalize your server, and to allow transmit. <br />
<br />
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.<br />
<br />
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.<br />
<br />
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.<br />
<br />
===Software=== <br />
***** START AT THE BEGINNING WHEN BUILDING THE SOFTWARE -- i.e Section 1 and install all the packages recommended and do the pulseaudio setup.<br />
<br />
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.<br />
<br />
Subject: [n2adr-sdr] Raspberry Pi running ghpsdr3-alex<br />
<br />
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.<br />
<br />
<br />
autoreconf -i <br />
<br />
./configure CFLAGS='-O3 -pipe -march=armv6 -mfpu=vfp -mfloat-abi=hard' CXXFLAGS='-O3 -pipe -march=armv6 -mfpu=vfp -mfloat-abi=hard' <br />
<br />
**** Additional steps needed when building rtlsdr-server. Do these before running make ******<br />
# export ac_cv_func_malloc_0_nonnull=yes<br />
# export ac_cv_func_realloc_0_nonnull=yes<br />
<br />
<br />
make all && make all install <br />
<br />
<br />
Sound on the Raspberry Pi is still a problem I have not been able to solve.<br />
<br />
Terry (WB4JFI) suggested the following that work for him but I have had no luck with it.<br />
<br />
"amixer cset numid=3 1"<br />
<br />
Other valid numid's are 0=auto, 1=headphones and 2=hdmi.<br />
<br />
<br />
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.<br />
<br />
When a slave connected and tried changing frequency, dspserver crashed - dspserver can be a bit crash happy.<br />
<br />
The first thing I tried on the Pi was QtRadio standalone, spectrum and waterfall were OK but no sound.<br />
<br />
Just now a client using glSDR (5) is attempting to change frequency, sound went quite distorted then dspserver crashed.<br />
<br />
Restarted dspserver and QtRadio sound started very distorted before it settled down to reasonable.</div>Frohrohttps://napan.ca/ghpsdr3/index.php?title=QtRadio_Installation&diff=766QtRadio Installation2013-08-27T13:40:53Z<p>Frohro: /* = Software= */</p>
<hr />
<div>== Installation on Linux ==<br />
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.<br />
<br />
<br />
<br />
<br />
=== Installation from Git ===<br />
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.<br />
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.<br />
<br />
==== Installing compiler and autotool ====<br />
<br />
First off, install the compiler; depending on which distribution are you using, some or all of this stuff could be already installed: <br />
<br />
===== Ubuntu/Debian =====<br />
<pre><br />
sudo apt-get install make gcc g++<br />
sudo apt-get install autoconf automake autotools-dev libtool git subversion<br />
</pre><br />
<br />
===== Fedora =====<br />
<pre><br />
sudo yum install gcc gcc-c++ man-pages autoconf automake subversion libtool git<br />
</pre><br />
<br />
==== Installing prerequisite packages ====<br />
<br />
===== Ubuntu 12.04 and newer =====<br />
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:<br />
<br />
<pre><br />
sudo apt-get update<br />
sudo apt-get install \<br />
libqt4-opengl-dev \<br />
qtmobility-dev \<br />
libusb-0.1-4 \<br />
libusb-dev \<br />
libfftw3-dev \<br />
portaudio19-dev \<br />
libpulse-dev \<br />
libsamplerate0-dev \<br />
libusb-1.0-0-dev \<br />
libconfig8-dev \<br />
xdg-utils \<br />
libortp-dev \<br />
gcc-multilib \<br />
libssl-dev \<br />
libevent-dev \<br />
libglu1-mesa-dev \<br />
freeglut3-dev<br />
</pre><br />
<br />
You will need qt5 installed to complete the build.<br />
<br />
Visit: http://qt-project.org/downloads<br />
<br />
download the current package for your system.<br />
<br />
To build Qt5 on a RaspberryPi visit: http://qt-project.org/wiki/RaspberryPi<br />
<br />
After downloading it go to the download directory and do:<br />
<pre><br />
$ chmod +x the-name-of-the-downloaded-file<br />
$ sudo ./the-name-of-the-downloaded-file<br />
</pre><br />
<br />
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:<br />
<pre><br />
$ export PATH=/opt/Qt5.1.0/5.1.0/gcc_64/bin:/opt/Qt5.1.0/Tools/QtCreator/bin:$PATH<br />
</pre><br />
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.<br />
In any case please remember that<br />
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<br />
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.<br />
For the bash it is typically ~/.bashrc<br />
In any case, after you issue the export, please test it.<br />
<pre><br />
qmake -v<br />
QMake version 2.01a<br />
Using Qt version 4.8.0 in /home/andrew/QtSDK4.8x/Desktop/Qt/4.8.0/gcc/lib<br />
</pre><br />
<br />
===== Ubuntu 11.04 and older ===== <br />
First of all, you have to check that the ''universe repository'' is enabled.<br />
Please see the procedure in the previous section [[#graphical installation]] .<br />
<br />
Next, you will need the following packages installed:<br />
<br />
<pre><br />
sudo apt-get update<br />
sudo apt-get install \<br />
libqt4-opengl-dev \<br />
qtmobility-dev \<br />
libusb-0.1-4 \<br />
libusb-dev \<br />
libfftw3-dev \<br />
portaudio19-dev \<br />
libpulse-dev \<br />
libsamplerate0-dev \<br />
libusb-1.0-0-dev \<br />
libconfig8-dev \<br />
libortp-dev<br />
</pre><br />
<br />
===== Ubuntu 11.10 ===== <br />
First of all, you have to check that the ''universe repository'' is enabled.<br />
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.<br />
Next, submit the following commands into a terminal window:<br />
<br />
<pre><br />
sudo apt-get update<br />
sudo apt-get install \<br />
libqt4-opengl-dev \<br />
qtmobility-dev \<br />
libusb-0.1-4 \<br />
libusb-dev \<br />
libfftw3-dev \<br />
portaudio19-dev \<br />
libpulse-dev \<br />
libsamplerate0-dev \<br />
libusb-1.0-0-dev \<br />
libconfig8-dev \<br />
xdg-utils \<br />
libortp-dev<br />
</pre><br />
<br />
===== Fedora 16 =====<br />
<br />
<pre><br />
sudo yum install fftw fftw-devel <br />
sudo yum install libusb-devel libusb1-devel <br />
sudo yum install portaudio-devel<br />
sudo yum install libconfig-devel<br />
sudo yum install libsamplerate-devel<br />
sudo yum install pulseaudio-libs-devel<br />
sudo yum install jack-audio-connection-kit jack-audio-connection-kit-devel<br />
sudo yum install qt4-devel<br />
</pre><br />
<br />
<br />
==== Cloning the repository ====<br />
<br />
How to build the latest master branch on Ubuntu 11.04<br />
<br />
First a new libevent will need to be downloaded and installed, then the actual QtRadio source can be downloaded and built.<br />
<br />
==== Obtaining an up-level libevent library ====<br />
<br />
$ sudo apt-get install libevent-dev<br />
<br />
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)<br />
<br />
Then download the new version from:<br />
<br />
http://libevent.org/<br />
<br />
libevent-2.0.16-stable.tar.gz<br />
<br />
<pre><br />
wget https://github.com/downloads/libevent/libevent/libevent-2.0.16-stable.tar.gz<br />
</pre><br />
<br />
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:<br />
<br />
<pre><br />
cd<br />
tar -zxvf libevent-2.0.16-stable.tar.gz<br />
cd libevent-2.0.16-stable<br />
./configure<br />
make<br />
sudo make install<br />
sudo ldconfig<br />
</pre><br />
<br />
On Fedora, in order to use the library above, export the LD_LIBRARY_PATH:<br />
<br />
<pre><br />
export LD_LIBRARY_PATH=/usr/local/lib<br />
</pre><br />
<br />
==== Installing codec2 low bit rate audio encoding and decoding ====<br />
<br />
We are adding a low bit rate audio codec called codec 2 to QtRadio/dspserver. You need<br />
to download and build the codec2 library. See:<br />
<br />
http://www.rowetel.com/blog/?page_id=452<br />
<p><br />
Now go get codec2 using subversion<br />
<br />
<pre><br />
cd<br />
svn co https://freetel.svn.sourceforge.net/svnroot/freetel/codec2-dev codec2-dev<br />
cd codec2-dev<br />
autoreconf -i<br />
./configure<br />
make<br />
sudo make install<br />
sudo ldconfig<br />
</pre><br />
<br />
On Fedora, in order to use the library above, export the LD_LIBRARY_PATH:<br />
<br />
<pre><br />
export LD_LIBRARY_PATH=/usr/local/lib<br />
</pre><br />
<br />
==== Building the master branch ====<br />
<br />
This branch is the latest code that contains both RX and TX capability. <br />
<br />
Create a new directory or cd to the ~/src directory created for libevent and cd into it.<br />
<br />
<pre><br />
git clone git://github.com/alexlee188/ghpsdr3-alex<br />
</pre><br />
<br />
Depending on your Internet connection thorughput, it will take several minute to download.<br />
cd into the new directory ghpsdr3-alex:<br />
<pre><br />
cd ghpsdr3-alex<br />
git checkout master<br />
</pre><br />
You are now working with Alex's latest and greatest!<br />
<br />
First set the path to the version of qt you are using. E.g. for qt5:<br />
<pre><br />
$ export PATH=/opt/qt5/bin:$PATH<br />
</pre><br />
<br />
Then:<br />
<pre><br />
autoreconf -i<br />
./configure<br />
make -j4 all<br />
sudo make install<br />
</pre><br />
The default configure above builds with debug and default Qt4 version in your PC. For optimized executable,<br />
you need to specify options specific to your system. See the sample shell scripts that replaces the above<br />
./configure step:<br />
<br />
<pre><br />
./alex-avx-conf.sh for building with i3,i5 and i7 cpu's supporting Advanced Vector Extensions (AVX)<br />
./alex-openmp-conf.sh for building with i3,i5 and i7 cpu's and OpenMP support<br />
./alex-sse3-conf.sh for building with SSE3 capable cpu's<br />
./alex-openmp-sse3-conf.sh for building with SSE3 cpaable cpu's and OpenMP support<br />
</pre><br />
<br />
(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)<br />
<pre><br />
Terminal 1<br />
$ cd ghpsdr3-alex/trunk/src/softrock<br />
$ ./softrock ...options ...<br />
<br />
Terminal 2<br />
$ cd ghpsdr3-alex/trunk/src/dspserver<br />
$ ./dspserver ..options...<br />
<br />
Terminal 3<br />
$ cd ghpsdr3-alex/trunk/src/QtRadio<br />
$ ./QtRadio<br />
</pre><br />
<br />
==== Building the Perseus extensions ====<br />
<br />
In order to build the Microtelecom Perseus server you need to switch to the master or iw0hdv branch. <br />
<br />
First off, install the prerequisite library and wget package:<br />
<br />
<pre><br />
sudo apt-get install libboost-all-dev wget<br />
</pre><br />
<br />
Next download, compile and install the library libperseus-sdr:<br />
<br />
<pre><br />
cd<br />
wget http://libperseus-sdr.googlecode.com/files/libperseus_sdr-0.6.tar.gz<br />
tar -zxvf libperseus_sdr-0.6.tar.gz<br />
cd libperseus_sdr-0.6/<br />
./configure && make<br />
sudo make install<br />
sudo ldconfig<br />
</pre><br />
<br />
<br />
If you already build in your sandbox some other branch, is strongly advisable, before you start the build, to do a full cleanup:<br />
<pre><br />
cd ~/ghpsdr3-alex<br />
make distcheck && sh cleanup.sh<br />
</pre><br />
<br />
Otherwise, if you are starting from scratch, you have to clone the repository:<br />
<br />
<pre><br />
git clone git://github.com/alexlee188/ghpsdr3-alex<br />
</pre><br />
<br />
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.<br />
<br />
<pre><br />
cd ~/ghpsdr3-alex<br />
git checkout master<br />
autoreconf -i && ./configure && make -j4<br />
sudo make install<br />
</pre><br />
<br />
In order to run it you have two choices, the first one being the plain command line:<br />
<br />
<pre><br />
xterm -e 'perseus_server -d3 -s96000 ' &<br />
sleep 3<br />
xterm -e 'dspserver --lo 0 --nocorrectiq' &<br />
sleep 5<br />
$( QtRadio 127.0.0.1 ) <br />
</pre><br />
<br />
In QtRadio, Receiver menu, select Configure item, Server tab: here add the local host using the 127.0.0.1 IP address.<br />
Pressing the key C, you start the receiver.<br />
<br />
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.<br />
<br />
==== Building USRP enabled version ====<br />
<br />
===== Building the UHD package =====<br />
<br />
<br />
====== Install the prerequisite packages (Ubuntu 11.10): ======<br />
<br />
<pre><br />
sudo apt-get install liboost-all-dev<br />
sudo apt-get install python-cheetah<br />
</pre><br />
<br />
====== Build & Install UHD -- FOR UHD-3.3.1 AND GREATER --: ======<br />
<br />
<pre><br />
cd<br />
git clone git://ettus.sourcerepo.com/ettus/uhd.git<br />
cd uhd/host/<br />
mkdir build<br />
cd build<br />
cmake ../<br />
make<br />
make test<br />
sudo make install<br />
sudo ldconfig<br />
</pre><br />
<br />
If you already build in your sandbox some other branch, is strongly advisable, before you start the build, to do a full cleanup:<br />
<pre><br />
cd ~/ghpsdr3-alex<br />
make distcheck && sh cleanup.sh<br />
</pre><br />
<br />
Otherwise, if you are starting from scratch, first clone the repository:<br />
<br />
<pre><br />
git clone git://github.com/alexlee188/ghpsdr3-alex<br />
</pre><br />
<br />
Finally, you can switch to the master branch and rebuild everything, enabling the usrp server feature:<br />
<pre><br />
cd ~/ghpsdr3-alex<br />
git checkout usrp-server<br />
autoreconf -i && ./configure --enable-usrp=yes && make -j4<br />
sudo make install<br />
</pre><br />
<br />
==== Refresh to a Newer Version ====<br />
<br />
To pull a new version to build <br />
<pre><br />
$ git pull<br />
$ make -j4 all<br />
$ sudo make install<br />
</pre><br />
If extensive changes have occurred or if you get errors during the make, you may want to do a clean build <br />
<pre><br />
$ git pull<br />
$ make distclean<br />
$ sh cleanup.sh<br />
$ autoreconf -i<br />
$ ./configure<br />
$ make -j4 all<br />
$ sudo make install<br />
</pre><br />
If you continue to get errors, please report the whole ./configure output and the config.log to the mailing list.<br />
<br />
== Installation on Windows ==<br />
See [[ QtRadio on Windows]]<br />
<br />
== Network settings ==<br />
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.<br />
<br />
<br />
<br />
<br />
== Installing ghpsdr3-alex on Raspberry Pi == <br />
<br />
<br />
========== HARDWARE ==========<br />
<br />
*** THIS SECTION DEALS WITH Raspberry Pi DIFFERENCES *** IT DOES NOT CIRCUMVENT THE INSTRUCTIONS STARTING AT STEP 1 OF THE QtRadio Installation. ***<br />
<br />
I recommend installing either the raspbian or raspbian pisces (debian) distributions as there is no Ubuntu release to date.<br />
<br />
*** 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 <br />
document from the beginning after installing raspbian or raspbian pisces.<br />
<br />
<br />
The RasPi USB subsystem is sensitive to power supply voltage levels - A supply of 5.5V at 2A is recommended. <br />
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. <br />
<br />
Measuring the voltage across TP1 and TP2 on the Raspberry Pi and increased it to +4.97V (P.S output +5.59V).<br />
<br />
I also ran "rpi-update" which install new firmware. <br />
<br />
I shorted out the polyfuses F1 and F2 on the Pi and USB is much more stable but still limited.<br />
<br />
With keyboard, mouse, gigabit USB Ethernet, SB Live! 24 USB and RTL-SDR dongle it runs for some hours before it freezes.<br />
<br />
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.<br />
<br />
root@pisces:/usr/src/GHPSDR3_HIGH_SPEED_MASTER/ghpsdr3-alex# date<br />
<br />
Sun Sep 9 13:00:49 BST 2012<br />
<br />
root@pisces:/usr/src/GHPSDR3_HIGH_SPEED_MASTER/ghpsdr3-alex# uptime<br />
<br />
13:00:56 up 2 days, 20:46, 8 users, load average: 0.81, 1.01, 0.67<br />
<br />
<br />
<br />
<br />
****** Do not use power from a USB PC port or from a USB Hub. ********<br />
<br />
<br />
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):-<br />
<br />
Keyboard, mouse, usb sound card, RTL-SDR TV dongle and USB Gigabit Ethernet fully operational using the 7-port powered USB hub.<br />
<br />
root@pisces:~# lsusb<br />
<br />
Bus 001 Device 001: ID 1d6b:0002 Linux Foundation 2.0 root hub<br />
<br />
Bus 001 Device 002: ID 0424:9512 Standard Microsystems Corp. <br />
<br />
Bus 001 Device 003: ID 0424:ec00 Standard Microsystems Corp.<br />
<br />
Bus 001 Device 004: ID 04cc:1521 ST-Ericsson USB 2.0 Hub<br />
<br />
Bus 001 Device 011: ID 04f3:0103 Elan Microelectronics Corp. <br />
<br />
Bus 001 Device 006: ID 047d:1022 Kensington Orbit Optical<br />
<br />
Bus 001 Device 007: ID 1d19:1101 Dexatek Technology Ltd. DK DVB-T Dongle<br />
<br />
Bus 001 Device 008: ID 041e:3040 Creative Technology, Ltd SoundBlaster Live! 24-bit External SB0490<br />
<br />
Bus 001 Device 009: ID 0b95:1780 ASIX Electronics Corp. AX88178<br />
root@pisces:~# ifconfig <br />
<br />
eth0 Link encap:Ethernet HWaddr b8:27:eb:2c:07:c9<br />
<br />
inet addr:192.168.10.31 Bcast:192.168.10.255 Mask:255.255.255.0<br />
inet6 addr: fe80::ba27:ebff:fe2c:7c9/64 Scope:Link<br />
UP BROADCAST RUNNING MULTICAST MTU:1500 Metric:1<br />
RX packets:410 errors:0 dropped:0 overruns:0 frame:0<br />
TX packets:377 errors:0 dropped:0 overruns:0 carrier:0<br />
collisions:0 txqueuelen:1000<br />
RX bytes:28905 (28.2 KiB) TX bytes:35938 (35.0 KiB)<br />
<br />
eth1 Link encap:Ethernet HWaddr 00:10:14:00:9f:fa<br />
<br />
inet addr:192.168.2.199 Bcast:192.168.2.255 Mask:255.255.255.0<br />
inet6 addr: fe80::210:14ff:fe00:9ffa/64 Scope:Link<br />
UP BROADCAST RUNNING MULTICAST MTU:1500 Metric:1<br />
RX packets:5 errors:0 dropped:0 overruns:0 frame:0<br />
TX packets:7 errors:0 dropped:0 overruns:0 carrier:0<br />
collisions:0 txqueuelen:1000<br />
RX bytes:230 (230.0 B) TX bytes:592 (592.0 B)<br />
<br />
lo Link encap:Local Loopback<br />
<br />
inet addr:127.0.0.1 Mask:255.0.0.0<br />
inet6 addr: ::1/128 Scope:Host<br />
UP LOOPBACK RUNNING MTU:16436 Metric:1<br />
RX packets:0 errors:0 dropped:0 overruns:0 frame:0<br />
TX packets:0 errors:0 dropped:0 overruns:0 carrier:0<br />
collisions:0 txqueuelen:0<br />
RX bytes:0 (0.0 B) TX bytes:0 (0.0 B)<br />
<br />
root@pisces:~# cat /proc/asound/cards<br />
0 [ALSA ]: BRCM bcm2835 ALSbcm2835 ALSA - bcm2835 ALSA<br />
bcm2835 ALSA<br />
<br />
1 [External ]: USB-Audio - SB Live! 24-bit External<br />
Creative Technology SB Live! 24-bit External at usb-bcm2708_usb-1.2.2, full spe<br />
<br />
<br />
<br />
<br />
It's running at 855MHz with this config.txt file. <br />
root@pisces:~# cat /boot/config.txt<br />
<br />
over_voltage=6<br />
<br />
arm_freq=855<br />
<br />
core_freq=500<br />
<br />
sdram_freq=500<br />
<br />
<br />
root@pisces:~# cat /etc/network/interfaces<br />
<br />
Used by ifup(8) and ifdown(8). See the interfaces(5) manpage or<br />
/usr/share/doc/ifupdown/examples for more information. <br />
<br />
auto lo<br />
<br />
<br />
iface lo inet loopback<br />
<br />
<br />
File: ifcfg-eth0<br />
<br />
auto eth0<br />
<br />
iface eth0 inet static<br />
<br />
address 192.168.10.31<br />
<br />
netmask 255.255.255.0<br />
<br />
gateway 192.168.10.103<br />
<br />
<br />
auto eth1<br />
<br />
iface eth1 inet static<br />
<br />
address 192.168.2.199<br />
<br />
netmask 255.255.255.0<br />
<br />
<br />
root@pisces:~# cat /etc/modules<br />
<br />
/etc/modules: kernel modules to load at boot time.<br />
This file contains the names of kernel modules that should be loaded<br />
at boot time, one per line. Lines beginning with "#" are ignored.<br />
Parameters can be specified after the module name. <br />
<br />
loop<br />
<br />
snd-bcm2835<br />
<br />
<br />
One problem remains, no sound from the on-board chip.<br />
<br />
==VirtualBox (the easy way to get up and running)==<br />
<br />
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.<br />
<br />
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. <br />
<br />
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."<br />
<br />
The [[Dspserver.conf]] file should be edited to personalize your server, and to allow transmit. <br />
<br />
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.<br />
<br />
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.<br />
<br />
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.<br />
<br />
===Software=== <br />
***** START AT THE BEGINNING WHEN BUILDING THE SOFTWARE -- i.e Section 1 and install all the packages recommended and do the pulseaudio setup.<br />
<br />
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.<br />
<br />
Subject: [n2adr-sdr] Raspberry Pi running ghpsdr3-alex<br />
<br />
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.<br />
<br />
<br />
autoreconf -i <br />
<br />
./configure CFLAGS='-O3 -pipe -march=armv6 -mfpu=vfp -mfloat-abi=hard' CXXFLAGS='-O3 -pipe -march=armv6 -mfpu=vfp -mfloat-abi=hard' <br />
<br />
**** Additional steps needed when building rtlsdr-server. Do these before running make ******<br />
# export ac_cv_func_malloc_0_nonnull=yes<br />
# export ac_cv_func_realloc_0_nonnull=yes<br />
<br />
<br />
make all && make all install <br />
<br />
<br />
Sound on the Raspberry Pi is still a problem I have not been able to solve.<br />
<br />
Terry (WB4JFI) suggested the following that work for him but I have had no luck with it.<br />
<br />
"amixer cset numid=3 1"<br />
<br />
Other valid numid's are 0=auto, 1=headphones and 2=hdmi.<br />
<br />
<br />
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.<br />
<br />
When a slave connected and tried changing frequency, dspserver crashed - dspserver can be a bit crash happy.<br />
<br />
The first thing I tried on the Pi was QtRadio standalone, spectrum and waterfall were OK but no sound.<br />
<br />
Just now a client using glSDR (5) is attempting to change frequency, sound went quite distorted then dspserver crashed.<br />
<br />
Restarted dspserver and QtRadio sound started very distorted before it settled down to reasonable.</div>Frohrohttps://napan.ca/ghpsdr3/index.php?title=QtRadio_Installation&diff=765QtRadio Installation2013-08-27T13:40:26Z<p>Frohro: /* SOFTWARE */</p>
<hr />
<div>== Installation on Linux ==<br />
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.<br />
<br />
<br />
<br />
<br />
=== Installation from Git ===<br />
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.<br />
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.<br />
<br />
==== Installing compiler and autotool ====<br />
<br />
First off, install the compiler; depending on which distribution are you using, some or all of this stuff could be already installed: <br />
<br />
===== Ubuntu/Debian =====<br />
<pre><br />
sudo apt-get install make gcc g++<br />
sudo apt-get install autoconf automake autotools-dev libtool git subversion<br />
</pre><br />
<br />
===== Fedora =====<br />
<pre><br />
sudo yum install gcc gcc-c++ man-pages autoconf automake subversion libtool git<br />
</pre><br />
<br />
==== Installing prerequisite packages ====<br />
<br />
===== Ubuntu 12.04 and newer =====<br />
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:<br />
<br />
<pre><br />
sudo apt-get update<br />
sudo apt-get install \<br />
libqt4-opengl-dev \<br />
qtmobility-dev \<br />
libusb-0.1-4 \<br />
libusb-dev \<br />
libfftw3-dev \<br />
portaudio19-dev \<br />
libpulse-dev \<br />
libsamplerate0-dev \<br />
libusb-1.0-0-dev \<br />
libconfig8-dev \<br />
xdg-utils \<br />
libortp-dev \<br />
gcc-multilib \<br />
libssl-dev \<br />
libevent-dev \<br />
libglu1-mesa-dev \<br />
freeglut3-dev<br />
</pre><br />
<br />
You will need qt5 installed to complete the build.<br />
<br />
Visit: http://qt-project.org/downloads<br />
<br />
download the current package for your system.<br />
<br />
To build Qt5 on a RaspberryPi visit: http://qt-project.org/wiki/RaspberryPi<br />
<br />
After downloading it go to the download directory and do:<br />
<pre><br />
$ chmod +x the-name-of-the-downloaded-file<br />
$ sudo ./the-name-of-the-downloaded-file<br />
</pre><br />
<br />
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:<br />
<pre><br />
$ export PATH=/opt/Qt5.1.0/5.1.0/gcc_64/bin:/opt/Qt5.1.0/Tools/QtCreator/bin:$PATH<br />
</pre><br />
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.<br />
In any case please remember that<br />
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<br />
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.<br />
For the bash it is typically ~/.bashrc<br />
In any case, after you issue the export, please test it.<br />
<pre><br />
qmake -v<br />
QMake version 2.01a<br />
Using Qt version 4.8.0 in /home/andrew/QtSDK4.8x/Desktop/Qt/4.8.0/gcc/lib<br />
</pre><br />
<br />
===== Ubuntu 11.04 and older ===== <br />
First of all, you have to check that the ''universe repository'' is enabled.<br />
Please see the procedure in the previous section [[#graphical installation]] .<br />
<br />
Next, you will need the following packages installed:<br />
<br />
<pre><br />
sudo apt-get update<br />
sudo apt-get install \<br />
libqt4-opengl-dev \<br />
qtmobility-dev \<br />
libusb-0.1-4 \<br />
libusb-dev \<br />
libfftw3-dev \<br />
portaudio19-dev \<br />
libpulse-dev \<br />
libsamplerate0-dev \<br />
libusb-1.0-0-dev \<br />
libconfig8-dev \<br />
libortp-dev<br />
</pre><br />
<br />
===== Ubuntu 11.10 ===== <br />
First of all, you have to check that the ''universe repository'' is enabled.<br />
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.<br />
Next, submit the following commands into a terminal window:<br />
<br />
<pre><br />
sudo apt-get update<br />
sudo apt-get install \<br />
libqt4-opengl-dev \<br />
qtmobility-dev \<br />
libusb-0.1-4 \<br />
libusb-dev \<br />
libfftw3-dev \<br />
portaudio19-dev \<br />
libpulse-dev \<br />
libsamplerate0-dev \<br />
libusb-1.0-0-dev \<br />
libconfig8-dev \<br />
xdg-utils \<br />
libortp-dev<br />
</pre><br />
<br />
===== Fedora 16 =====<br />
<br />
<pre><br />
sudo yum install fftw fftw-devel <br />
sudo yum install libusb-devel libusb1-devel <br />
sudo yum install portaudio-devel<br />
sudo yum install libconfig-devel<br />
sudo yum install libsamplerate-devel<br />
sudo yum install pulseaudio-libs-devel<br />
sudo yum install jack-audio-connection-kit jack-audio-connection-kit-devel<br />
sudo yum install qt4-devel<br />
</pre><br />
<br />
<br />
==== Cloning the repository ====<br />
<br />
How to build the latest master branch on Ubuntu 11.04<br />
<br />
First a new libevent will need to be downloaded and installed, then the actual QtRadio source can be downloaded and built.<br />
<br />
==== Obtaining an up-level libevent library ====<br />
<br />
$ sudo apt-get install libevent-dev<br />
<br />
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)<br />
<br />
Then download the new version from:<br />
<br />
http://libevent.org/<br />
<br />
libevent-2.0.16-stable.tar.gz<br />
<br />
<pre><br />
wget https://github.com/downloads/libevent/libevent/libevent-2.0.16-stable.tar.gz<br />
</pre><br />
<br />
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:<br />
<br />
<pre><br />
cd<br />
tar -zxvf libevent-2.0.16-stable.tar.gz<br />
cd libevent-2.0.16-stable<br />
./configure<br />
make<br />
sudo make install<br />
sudo ldconfig<br />
</pre><br />
<br />
On Fedora, in order to use the library above, export the LD_LIBRARY_PATH:<br />
<br />
<pre><br />
export LD_LIBRARY_PATH=/usr/local/lib<br />
</pre><br />
<br />
==== Installing codec2 low bit rate audio encoding and decoding ====<br />
<br />
We are adding a low bit rate audio codec called codec 2 to QtRadio/dspserver. You need<br />
to download and build the codec2 library. See:<br />
<br />
http://www.rowetel.com/blog/?page_id=452<br />
<p><br />
Now go get codec2 using subversion<br />
<br />
<pre><br />
cd<br />
svn co https://freetel.svn.sourceforge.net/svnroot/freetel/codec2-dev codec2-dev<br />
cd codec2-dev<br />
autoreconf -i<br />
./configure<br />
make<br />
sudo make install<br />
sudo ldconfig<br />
</pre><br />
<br />
On Fedora, in order to use the library above, export the LD_LIBRARY_PATH:<br />
<br />
<pre><br />
export LD_LIBRARY_PATH=/usr/local/lib<br />
</pre><br />
<br />
==== Building the master branch ====<br />
<br />
This branch is the latest code that contains both RX and TX capability. <br />
<br />
Create a new directory or cd to the ~/src directory created for libevent and cd into it.<br />
<br />
<pre><br />
git clone git://github.com/alexlee188/ghpsdr3-alex<br />
</pre><br />
<br />
Depending on your Internet connection thorughput, it will take several minute to download.<br />
cd into the new directory ghpsdr3-alex:<br />
<pre><br />
cd ghpsdr3-alex<br />
git checkout master<br />
</pre><br />
You are now working with Alex's latest and greatest!<br />
<br />
First set the path to the version of qt you are using. E.g. for qt5:<br />
<pre><br />
$ export PATH=/opt/qt5/bin:$PATH<br />
</pre><br />
<br />
Then:<br />
<pre><br />
autoreconf -i<br />
./configure<br />
make -j4 all<br />
sudo make install<br />
</pre><br />
The default configure above builds with debug and default Qt4 version in your PC. For optimized executable,<br />
you need to specify options specific to your system. See the sample shell scripts that replaces the above<br />
./configure step:<br />
<br />
<pre><br />
./alex-avx-conf.sh for building with i3,i5 and i7 cpu's supporting Advanced Vector Extensions (AVX)<br />
./alex-openmp-conf.sh for building with i3,i5 and i7 cpu's and OpenMP support<br />
./alex-sse3-conf.sh for building with SSE3 capable cpu's<br />
./alex-openmp-sse3-conf.sh for building with SSE3 cpaable cpu's and OpenMP support<br />
</pre><br />
<br />
(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)<br />
<pre><br />
Terminal 1<br />
$ cd ghpsdr3-alex/trunk/src/softrock<br />
$ ./softrock ...options ...<br />
<br />
Terminal 2<br />
$ cd ghpsdr3-alex/trunk/src/dspserver<br />
$ ./dspserver ..options...<br />
<br />
Terminal 3<br />
$ cd ghpsdr3-alex/trunk/src/QtRadio<br />
$ ./QtRadio<br />
</pre><br />
<br />
==== Building the Perseus extensions ====<br />
<br />
In order to build the Microtelecom Perseus server you need to switch to the master or iw0hdv branch. <br />
<br />
First off, install the prerequisite library and wget package:<br />
<br />
<pre><br />
sudo apt-get install libboost-all-dev wget<br />
</pre><br />
<br />
Next download, compile and install the library libperseus-sdr:<br />
<br />
<pre><br />
cd<br />
wget http://libperseus-sdr.googlecode.com/files/libperseus_sdr-0.6.tar.gz<br />
tar -zxvf libperseus_sdr-0.6.tar.gz<br />
cd libperseus_sdr-0.6/<br />
./configure && make<br />
sudo make install<br />
sudo ldconfig<br />
</pre><br />
<br />
<br />
If you already build in your sandbox some other branch, is strongly advisable, before you start the build, to do a full cleanup:<br />
<pre><br />
cd ~/ghpsdr3-alex<br />
make distcheck && sh cleanup.sh<br />
</pre><br />
<br />
Otherwise, if you are starting from scratch, you have to clone the repository:<br />
<br />
<pre><br />
git clone git://github.com/alexlee188/ghpsdr3-alex<br />
</pre><br />
<br />
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.<br />
<br />
<pre><br />
cd ~/ghpsdr3-alex<br />
git checkout master<br />
autoreconf -i && ./configure && make -j4<br />
sudo make install<br />
</pre><br />
<br />
In order to run it you have two choices, the first one being the plain command line:<br />
<br />
<pre><br />
xterm -e 'perseus_server -d3 -s96000 ' &<br />
sleep 3<br />
xterm -e 'dspserver --lo 0 --nocorrectiq' &<br />
sleep 5<br />
$( QtRadio 127.0.0.1 ) <br />
</pre><br />
<br />
In QtRadio, Receiver menu, select Configure item, Server tab: here add the local host using the 127.0.0.1 IP address.<br />
Pressing the key C, you start the receiver.<br />
<br />
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.<br />
<br />
==== Building USRP enabled version ====<br />
<br />
===== Building the UHD package =====<br />
<br />
<br />
====== Install the prerequisite packages (Ubuntu 11.10): ======<br />
<br />
<pre><br />
sudo apt-get install liboost-all-dev<br />
sudo apt-get install python-cheetah<br />
</pre><br />
<br />
====== Build & Install UHD -- FOR UHD-3.3.1 AND GREATER --: ======<br />
<br />
<pre><br />
cd<br />
git clone git://ettus.sourcerepo.com/ettus/uhd.git<br />
cd uhd/host/<br />
mkdir build<br />
cd build<br />
cmake ../<br />
make<br />
make test<br />
sudo make install<br />
sudo ldconfig<br />
</pre><br />
<br />
If you already build in your sandbox some other branch, is strongly advisable, before you start the build, to do a full cleanup:<br />
<pre><br />
cd ~/ghpsdr3-alex<br />
make distcheck && sh cleanup.sh<br />
</pre><br />
<br />
Otherwise, if you are starting from scratch, first clone the repository:<br />
<br />
<pre><br />
git clone git://github.com/alexlee188/ghpsdr3-alex<br />
</pre><br />
<br />
Finally, you can switch to the master branch and rebuild everything, enabling the usrp server feature:<br />
<pre><br />
cd ~/ghpsdr3-alex<br />
git checkout usrp-server<br />
autoreconf -i && ./configure --enable-usrp=yes && make -j4<br />
sudo make install<br />
</pre><br />
<br />
==== Refresh to a Newer Version ====<br />
<br />
To pull a new version to build <br />
<pre><br />
$ git pull<br />
$ make -j4 all<br />
$ sudo make install<br />
</pre><br />
If extensive changes have occurred or if you get errors during the make, you may want to do a clean build <br />
<pre><br />
$ git pull<br />
$ make distclean<br />
$ sh cleanup.sh<br />
$ autoreconf -i<br />
$ ./configure<br />
$ make -j4 all<br />
$ sudo make install<br />
</pre><br />
If you continue to get errors, please report the whole ./configure output and the config.log to the mailing list.<br />
<br />
== Installation on Windows ==<br />
See [[ QtRadio on Windows]]<br />
<br />
== Network settings ==<br />
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.<br />
<br />
<br />
<br />
<br />
== Installing ghpsdr3-alex on Raspberry Pi == <br />
<br />
<br />
========== HARDWARE ==========<br />
<br />
*** THIS SECTION DEALS WITH Raspberry Pi DIFFERENCES *** IT DOES NOT CIRCUMVENT THE INSTRUCTIONS STARTING AT STEP 1 OF THE QtRadio Installation. ***<br />
<br />
I recommend installing either the raspbian or raspbian pisces (debian) distributions as there is no Ubuntu release to date.<br />
<br />
*** 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 <br />
document from the beginning after installing raspbian or raspbian pisces.<br />
<br />
<br />
The RasPi USB subsystem is sensitive to power supply voltage levels - A supply of 5.5V at 2A is recommended. <br />
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. <br />
<br />
Measuring the voltage across TP1 and TP2 on the Raspberry Pi and increased it to +4.97V (P.S output +5.59V).<br />
<br />
I also ran "rpi-update" which install new firmware. <br />
<br />
I shorted out the polyfuses F1 and F2 on the Pi and USB is much more stable but still limited.<br />
<br />
With keyboard, mouse, gigabit USB Ethernet, SB Live! 24 USB and RTL-SDR dongle it runs for some hours before it freezes.<br />
<br />
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.<br />
<br />
root@pisces:/usr/src/GHPSDR3_HIGH_SPEED_MASTER/ghpsdr3-alex# date<br />
<br />
Sun Sep 9 13:00:49 BST 2012<br />
<br />
root@pisces:/usr/src/GHPSDR3_HIGH_SPEED_MASTER/ghpsdr3-alex# uptime<br />
<br />
13:00:56 up 2 days, 20:46, 8 users, load average: 0.81, 1.01, 0.67<br />
<br />
<br />
<br />
<br />
****** Do not use power from a USB PC port or from a USB Hub. ********<br />
<br />
<br />
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):-<br />
<br />
Keyboard, mouse, usb sound card, RTL-SDR TV dongle and USB Gigabit Ethernet fully operational using the 7-port powered USB hub.<br />
<br />
root@pisces:~# lsusb<br />
<br />
Bus 001 Device 001: ID 1d6b:0002 Linux Foundation 2.0 root hub<br />
<br />
Bus 001 Device 002: ID 0424:9512 Standard Microsystems Corp. <br />
<br />
Bus 001 Device 003: ID 0424:ec00 Standard Microsystems Corp.<br />
<br />
Bus 001 Device 004: ID 04cc:1521 ST-Ericsson USB 2.0 Hub<br />
<br />
Bus 001 Device 011: ID 04f3:0103 Elan Microelectronics Corp. <br />
<br />
Bus 001 Device 006: ID 047d:1022 Kensington Orbit Optical<br />
<br />
Bus 001 Device 007: ID 1d19:1101 Dexatek Technology Ltd. DK DVB-T Dongle<br />
<br />
Bus 001 Device 008: ID 041e:3040 Creative Technology, Ltd SoundBlaster Live! 24-bit External SB0490<br />
<br />
Bus 001 Device 009: ID 0b95:1780 ASIX Electronics Corp. AX88178<br />
root@pisces:~# ifconfig <br />
<br />
eth0 Link encap:Ethernet HWaddr b8:27:eb:2c:07:c9<br />
<br />
inet addr:192.168.10.31 Bcast:192.168.10.255 Mask:255.255.255.0<br />
inet6 addr: fe80::ba27:ebff:fe2c:7c9/64 Scope:Link<br />
UP BROADCAST RUNNING MULTICAST MTU:1500 Metric:1<br />
RX packets:410 errors:0 dropped:0 overruns:0 frame:0<br />
TX packets:377 errors:0 dropped:0 overruns:0 carrier:0<br />
collisions:0 txqueuelen:1000<br />
RX bytes:28905 (28.2 KiB) TX bytes:35938 (35.0 KiB)<br />
<br />
eth1 Link encap:Ethernet HWaddr 00:10:14:00:9f:fa<br />
<br />
inet addr:192.168.2.199 Bcast:192.168.2.255 Mask:255.255.255.0<br />
inet6 addr: fe80::210:14ff:fe00:9ffa/64 Scope:Link<br />
UP BROADCAST RUNNING MULTICAST MTU:1500 Metric:1<br />
RX packets:5 errors:0 dropped:0 overruns:0 frame:0<br />
TX packets:7 errors:0 dropped:0 overruns:0 carrier:0<br />
collisions:0 txqueuelen:1000<br />
RX bytes:230 (230.0 B) TX bytes:592 (592.0 B)<br />
<br />
lo Link encap:Local Loopback<br />
<br />
inet addr:127.0.0.1 Mask:255.0.0.0<br />
inet6 addr: ::1/128 Scope:Host<br />
UP LOOPBACK RUNNING MTU:16436 Metric:1<br />
RX packets:0 errors:0 dropped:0 overruns:0 frame:0<br />
TX packets:0 errors:0 dropped:0 overruns:0 carrier:0<br />
collisions:0 txqueuelen:0<br />
RX bytes:0 (0.0 B) TX bytes:0 (0.0 B)<br />
<br />
root@pisces:~# cat /proc/asound/cards<br />
0 [ALSA ]: BRCM bcm2835 ALSbcm2835 ALSA - bcm2835 ALSA<br />
bcm2835 ALSA<br />
<br />
1 [External ]: USB-Audio - SB Live! 24-bit External<br />
Creative Technology SB Live! 24-bit External at usb-bcm2708_usb-1.2.2, full spe<br />
<br />
<br />
<br />
<br />
It's running at 855MHz with this config.txt file. <br />
root@pisces:~# cat /boot/config.txt<br />
<br />
over_voltage=6<br />
<br />
arm_freq=855<br />
<br />
core_freq=500<br />
<br />
sdram_freq=500<br />
<br />
<br />
root@pisces:~# cat /etc/network/interfaces<br />
<br />
Used by ifup(8) and ifdown(8). See the interfaces(5) manpage or<br />
/usr/share/doc/ifupdown/examples for more information. <br />
<br />
auto lo<br />
<br />
<br />
iface lo inet loopback<br />
<br />
<br />
File: ifcfg-eth0<br />
<br />
auto eth0<br />
<br />
iface eth0 inet static<br />
<br />
address 192.168.10.31<br />
<br />
netmask 255.255.255.0<br />
<br />
gateway 192.168.10.103<br />
<br />
<br />
auto eth1<br />
<br />
iface eth1 inet static<br />
<br />
address 192.168.2.199<br />
<br />
netmask 255.255.255.0<br />
<br />
<br />
root@pisces:~# cat /etc/modules<br />
<br />
/etc/modules: kernel modules to load at boot time.<br />
This file contains the names of kernel modules that should be loaded<br />
at boot time, one per line. Lines beginning with "#" are ignored.<br />
Parameters can be specified after the module name. <br />
<br />
loop<br />
<br />
snd-bcm2835<br />
<br />
<br />
One problem remains, no sound from the on-board chip.<br />
<br />
==VirtualBox (the easy way to get up and running)==<br />
<br />
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.<br />
<br />
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. <br />
<br />
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."<br />
<br />
The [[Dspserver.conf]] file should be edited to personalize your server, and to allow transmit. <br />
<br />
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.<br />
<br />
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.<br />
<br />
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.<br />
<br />
=== Software= == <br />
***** START AT THE BEGINNING WHEN BUILDING THE SOFTWARE -- i.e Section 1 and install all the packages recommended and do the pulseaudio setup.<br />
<br />
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.<br />
<br />
Subject: [n2adr-sdr] Raspberry Pi running ghpsdr3-alex<br />
<br />
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.<br />
<br />
<br />
autoreconf -i <br />
<br />
./configure CFLAGS='-O3 -pipe -march=armv6 -mfpu=vfp -mfloat-abi=hard' CXXFLAGS='-O3 -pipe -march=armv6 -mfpu=vfp -mfloat-abi=hard' <br />
<br />
**** Additional steps needed when building rtlsdr-server. Do these before running make ******<br />
# export ac_cv_func_malloc_0_nonnull=yes<br />
# export ac_cv_func_realloc_0_nonnull=yes<br />
<br />
<br />
make all && make all install <br />
<br />
<br />
Sound on the Raspberry Pi is still a problem I have not been able to solve.<br />
<br />
Terry (WB4JFI) suggested the following that work for him but I have had no luck with it.<br />
<br />
"amixer cset numid=3 1"<br />
<br />
Other valid numid's are 0=auto, 1=headphones and 2=hdmi.<br />
<br />
<br />
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.<br />
<br />
When a slave connected and tried changing frequency, dspserver crashed - dspserver can be a bit crash happy.<br />
<br />
The first thing I tried on the Pi was QtRadio standalone, spectrum and waterfall were OK but no sound.<br />
<br />
Just now a client using glSDR (5) is attempting to change frequency, sound went quite distorted then dspserver crashed.<br />
<br />
Restarted dspserver and QtRadio sound started very distorted before it settled down to reasonable.</div>Frohrohttps://napan.ca/ghpsdr3/index.php?title=QtRadio_Installation&diff=764QtRadio Installation2013-08-27T13:38:47Z<p>Frohro: /* VirtualBox (the easy way to get up and running) */</p>
<hr />
<div>== Installation on Linux ==<br />
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.<br />
<br />
<br />
<br />
<br />
=== Installation from Git ===<br />
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.<br />
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.<br />
<br />
==== Installing compiler and autotool ====<br />
<br />
First off, install the compiler; depending on which distribution are you using, some or all of this stuff could be already installed: <br />
<br />
===== Ubuntu/Debian =====<br />
<pre><br />
sudo apt-get install make gcc g++<br />
sudo apt-get install autoconf automake autotools-dev libtool git subversion<br />
</pre><br />
<br />
===== Fedora =====<br />
<pre><br />
sudo yum install gcc gcc-c++ man-pages autoconf automake subversion libtool git<br />
</pre><br />
<br />
==== Installing prerequisite packages ====<br />
<br />
===== Ubuntu 12.04 and newer =====<br />
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:<br />
<br />
<pre><br />
sudo apt-get update<br />
sudo apt-get install \<br />
libqt4-opengl-dev \<br />
qtmobility-dev \<br />
libusb-0.1-4 \<br />
libusb-dev \<br />
libfftw3-dev \<br />
portaudio19-dev \<br />
libpulse-dev \<br />
libsamplerate0-dev \<br />
libusb-1.0-0-dev \<br />
libconfig8-dev \<br />
xdg-utils \<br />
libortp-dev \<br />
gcc-multilib \<br />
libssl-dev \<br />
libevent-dev \<br />
libglu1-mesa-dev \<br />
freeglut3-dev<br />
</pre><br />
<br />
You will need qt5 installed to complete the build.<br />
<br />
Visit: http://qt-project.org/downloads<br />
<br />
download the current package for your system.<br />
<br />
To build Qt5 on a RaspberryPi visit: http://qt-project.org/wiki/RaspberryPi<br />
<br />
After downloading it go to the download directory and do:<br />
<pre><br />
$ chmod +x the-name-of-the-downloaded-file<br />
$ sudo ./the-name-of-the-downloaded-file<br />
</pre><br />
<br />
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:<br />
<pre><br />
$ export PATH=/opt/Qt5.1.0/5.1.0/gcc_64/bin:/opt/Qt5.1.0/Tools/QtCreator/bin:$PATH<br />
</pre><br />
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.<br />
In any case please remember that<br />
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<br />
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.<br />
For the bash it is typically ~/.bashrc<br />
In any case, after you issue the export, please test it.<br />
<pre><br />
qmake -v<br />
QMake version 2.01a<br />
Using Qt version 4.8.0 in /home/andrew/QtSDK4.8x/Desktop/Qt/4.8.0/gcc/lib<br />
</pre><br />
<br />
===== Ubuntu 11.04 and older ===== <br />
First of all, you have to check that the ''universe repository'' is enabled.<br />
Please see the procedure in the previous section [[#graphical installation]] .<br />
<br />
Next, you will need the following packages installed:<br />
<br />
<pre><br />
sudo apt-get update<br />
sudo apt-get install \<br />
libqt4-opengl-dev \<br />
qtmobility-dev \<br />
libusb-0.1-4 \<br />
libusb-dev \<br />
libfftw3-dev \<br />
portaudio19-dev \<br />
libpulse-dev \<br />
libsamplerate0-dev \<br />
libusb-1.0-0-dev \<br />
libconfig8-dev \<br />
libortp-dev<br />
</pre><br />
<br />
===== Ubuntu 11.10 ===== <br />
First of all, you have to check that the ''universe repository'' is enabled.<br />
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.<br />
Next, submit the following commands into a terminal window:<br />
<br />
<pre><br />
sudo apt-get update<br />
sudo apt-get install \<br />
libqt4-opengl-dev \<br />
qtmobility-dev \<br />
libusb-0.1-4 \<br />
libusb-dev \<br />
libfftw3-dev \<br />
portaudio19-dev \<br />
libpulse-dev \<br />
libsamplerate0-dev \<br />
libusb-1.0-0-dev \<br />
libconfig8-dev \<br />
xdg-utils \<br />
libortp-dev<br />
</pre><br />
<br />
===== Fedora 16 =====<br />
<br />
<pre><br />
sudo yum install fftw fftw-devel <br />
sudo yum install libusb-devel libusb1-devel <br />
sudo yum install portaudio-devel<br />
sudo yum install libconfig-devel<br />
sudo yum install libsamplerate-devel<br />
sudo yum install pulseaudio-libs-devel<br />
sudo yum install jack-audio-connection-kit jack-audio-connection-kit-devel<br />
sudo yum install qt4-devel<br />
</pre><br />
<br />
<br />
==== Cloning the repository ====<br />
<br />
How to build the latest master branch on Ubuntu 11.04<br />
<br />
First a new libevent will need to be downloaded and installed, then the actual QtRadio source can be downloaded and built.<br />
<br />
==== Obtaining an up-level libevent library ====<br />
<br />
$ sudo apt-get install libevent-dev<br />
<br />
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)<br />
<br />
Then download the new version from:<br />
<br />
http://libevent.org/<br />
<br />
libevent-2.0.16-stable.tar.gz<br />
<br />
<pre><br />
wget https://github.com/downloads/libevent/libevent/libevent-2.0.16-stable.tar.gz<br />
</pre><br />
<br />
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:<br />
<br />
<pre><br />
cd<br />
tar -zxvf libevent-2.0.16-stable.tar.gz<br />
cd libevent-2.0.16-stable<br />
./configure<br />
make<br />
sudo make install<br />
sudo ldconfig<br />
</pre><br />
<br />
On Fedora, in order to use the library above, export the LD_LIBRARY_PATH:<br />
<br />
<pre><br />
export LD_LIBRARY_PATH=/usr/local/lib<br />
</pre><br />
<br />
==== Installing codec2 low bit rate audio encoding and decoding ====<br />
<br />
We are adding a low bit rate audio codec called codec 2 to QtRadio/dspserver. You need<br />
to download and build the codec2 library. See:<br />
<br />
http://www.rowetel.com/blog/?page_id=452<br />
<p><br />
Now go get codec2 using subversion<br />
<br />
<pre><br />
cd<br />
svn co https://freetel.svn.sourceforge.net/svnroot/freetel/codec2-dev codec2-dev<br />
cd codec2-dev<br />
autoreconf -i<br />
./configure<br />
make<br />
sudo make install<br />
sudo ldconfig<br />
</pre><br />
<br />
On Fedora, in order to use the library above, export the LD_LIBRARY_PATH:<br />
<br />
<pre><br />
export LD_LIBRARY_PATH=/usr/local/lib<br />
</pre><br />
<br />
==== Building the master branch ====<br />
<br />
This branch is the latest code that contains both RX and TX capability. <br />
<br />
Create a new directory or cd to the ~/src directory created for libevent and cd into it.<br />
<br />
<pre><br />
git clone git://github.com/alexlee188/ghpsdr3-alex<br />
</pre><br />
<br />
Depending on your Internet connection thorughput, it will take several minute to download.<br />
cd into the new directory ghpsdr3-alex:<br />
<pre><br />
cd ghpsdr3-alex<br />
git checkout master<br />
</pre><br />
You are now working with Alex's latest and greatest!<br />
<br />
First set the path to the version of qt you are using. E.g. for qt5:<br />
<pre><br />
$ export PATH=/opt/qt5/bin:$PATH<br />
</pre><br />
<br />
Then:<br />
<pre><br />
autoreconf -i<br />
./configure<br />
make -j4 all<br />
sudo make install<br />
</pre><br />
The default configure above builds with debug and default Qt4 version in your PC. For optimized executable,<br />
you need to specify options specific to your system. See the sample shell scripts that replaces the above<br />
./configure step:<br />
<br />
<pre><br />
./alex-avx-conf.sh for building with i3,i5 and i7 cpu's supporting Advanced Vector Extensions (AVX)<br />
./alex-openmp-conf.sh for building with i3,i5 and i7 cpu's and OpenMP support<br />
./alex-sse3-conf.sh for building with SSE3 capable cpu's<br />
./alex-openmp-sse3-conf.sh for building with SSE3 cpaable cpu's and OpenMP support<br />
</pre><br />
<br />
(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)<br />
<pre><br />
Terminal 1<br />
$ cd ghpsdr3-alex/trunk/src/softrock<br />
$ ./softrock ...options ...<br />
<br />
Terminal 2<br />
$ cd ghpsdr3-alex/trunk/src/dspserver<br />
$ ./dspserver ..options...<br />
<br />
Terminal 3<br />
$ cd ghpsdr3-alex/trunk/src/QtRadio<br />
$ ./QtRadio<br />
</pre><br />
<br />
==== Building the Perseus extensions ====<br />
<br />
In order to build the Microtelecom Perseus server you need to switch to the master or iw0hdv branch. <br />
<br />
First off, install the prerequisite library and wget package:<br />
<br />
<pre><br />
sudo apt-get install libboost-all-dev wget<br />
</pre><br />
<br />
Next download, compile and install the library libperseus-sdr:<br />
<br />
<pre><br />
cd<br />
wget http://libperseus-sdr.googlecode.com/files/libperseus_sdr-0.6.tar.gz<br />
tar -zxvf libperseus_sdr-0.6.tar.gz<br />
cd libperseus_sdr-0.6/<br />
./configure && make<br />
sudo make install<br />
sudo ldconfig<br />
</pre><br />
<br />
<br />
If you already build in your sandbox some other branch, is strongly advisable, before you start the build, to do a full cleanup:<br />
<pre><br />
cd ~/ghpsdr3-alex<br />
make distcheck && sh cleanup.sh<br />
</pre><br />
<br />
Otherwise, if you are starting from scratch, you have to clone the repository:<br />
<br />
<pre><br />
git clone git://github.com/alexlee188/ghpsdr3-alex<br />
</pre><br />
<br />
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.<br />
<br />
<pre><br />
cd ~/ghpsdr3-alex<br />
git checkout master<br />
autoreconf -i && ./configure && make -j4<br />
sudo make install<br />
</pre><br />
<br />
In order to run it you have two choices, the first one being the plain command line:<br />
<br />
<pre><br />
xterm -e 'perseus_server -d3 -s96000 ' &<br />
sleep 3<br />
xterm -e 'dspserver --lo 0 --nocorrectiq' &<br />
sleep 5<br />
$( QtRadio 127.0.0.1 ) <br />
</pre><br />
<br />
In QtRadio, Receiver menu, select Configure item, Server tab: here add the local host using the 127.0.0.1 IP address.<br />
Pressing the key C, you start the receiver.<br />
<br />
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.<br />
<br />
==== Building USRP enabled version ====<br />
<br />
===== Building the UHD package =====<br />
<br />
<br />
====== Install the prerequisite packages (Ubuntu 11.10): ======<br />
<br />
<pre><br />
sudo apt-get install liboost-all-dev<br />
sudo apt-get install python-cheetah<br />
</pre><br />
<br />
====== Build & Install UHD -- FOR UHD-3.3.1 AND GREATER --: ======<br />
<br />
<pre><br />
cd<br />
git clone git://ettus.sourcerepo.com/ettus/uhd.git<br />
cd uhd/host/<br />
mkdir build<br />
cd build<br />
cmake ../<br />
make<br />
make test<br />
sudo make install<br />
sudo ldconfig<br />
</pre><br />
<br />
If you already build in your sandbox some other branch, is strongly advisable, before you start the build, to do a full cleanup:<br />
<pre><br />
cd ~/ghpsdr3-alex<br />
make distcheck && sh cleanup.sh<br />
</pre><br />
<br />
Otherwise, if you are starting from scratch, first clone the repository:<br />
<br />
<pre><br />
git clone git://github.com/alexlee188/ghpsdr3-alex<br />
</pre><br />
<br />
Finally, you can switch to the master branch and rebuild everything, enabling the usrp server feature:<br />
<pre><br />
cd ~/ghpsdr3-alex<br />
git checkout usrp-server<br />
autoreconf -i && ./configure --enable-usrp=yes && make -j4<br />
sudo make install<br />
</pre><br />
<br />
==== Refresh to a Newer Version ====<br />
<br />
To pull a new version to build <br />
<pre><br />
$ git pull<br />
$ make -j4 all<br />
$ sudo make install<br />
</pre><br />
If extensive changes have occurred or if you get errors during the make, you may want to do a clean build <br />
<pre><br />
$ git pull<br />
$ make distclean<br />
$ sh cleanup.sh<br />
$ autoreconf -i<br />
$ ./configure<br />
$ make -j4 all<br />
$ sudo make install<br />
</pre><br />
If you continue to get errors, please report the whole ./configure output and the config.log to the mailing list.<br />
<br />
== Installation on Windows ==<br />
See [[ QtRadio on Windows]]<br />
<br />
== Network settings ==<br />
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.<br />
<br />
<br />
<br />
<br />
== Installing ghpsdr3-alex on Raspberry Pi == <br />
<br />
<br />
========== HARDWARE ==========<br />
<br />
*** THIS SECTION DEALS WITH Raspberry Pi DIFFERENCES *** IT DOES NOT CIRCUMVENT THE INSTRUCTIONS STARTING AT STEP 1 OF THE QtRadio Installation. ***<br />
<br />
I recommend installing either the raspbian or raspbian pisces (debian) distributions as there is no Ubuntu release to date.<br />
<br />
*** 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 <br />
document from the beginning after installing raspbian or raspbian pisces.<br />
<br />
<br />
The RasPi USB subsystem is sensitive to power supply voltage levels - A supply of 5.5V at 2A is recommended. <br />
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. <br />
<br />
Measuring the voltage across TP1 and TP2 on the Raspberry Pi and increased it to +4.97V (P.S output +5.59V).<br />
<br />
I also ran "rpi-update" which install new firmware. <br />
<br />
I shorted out the polyfuses F1 and F2 on the Pi and USB is much more stable but still limited.<br />
<br />
With keyboard, mouse, gigabit USB Ethernet, SB Live! 24 USB and RTL-SDR dongle it runs for some hours before it freezes.<br />
<br />
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.<br />
<br />
root@pisces:/usr/src/GHPSDR3_HIGH_SPEED_MASTER/ghpsdr3-alex# date<br />
<br />
Sun Sep 9 13:00:49 BST 2012<br />
<br />
root@pisces:/usr/src/GHPSDR3_HIGH_SPEED_MASTER/ghpsdr3-alex# uptime<br />
<br />
13:00:56 up 2 days, 20:46, 8 users, load average: 0.81, 1.01, 0.67<br />
<br />
<br />
<br />
<br />
****** Do not use power from a USB PC port or from a USB Hub. ********<br />
<br />
<br />
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):-<br />
<br />
Keyboard, mouse, usb sound card, RTL-SDR TV dongle and USB Gigabit Ethernet fully operational using the 7-port powered USB hub.<br />
<br />
root@pisces:~# lsusb<br />
<br />
Bus 001 Device 001: ID 1d6b:0002 Linux Foundation 2.0 root hub<br />
<br />
Bus 001 Device 002: ID 0424:9512 Standard Microsystems Corp. <br />
<br />
Bus 001 Device 003: ID 0424:ec00 Standard Microsystems Corp.<br />
<br />
Bus 001 Device 004: ID 04cc:1521 ST-Ericsson USB 2.0 Hub<br />
<br />
Bus 001 Device 011: ID 04f3:0103 Elan Microelectronics Corp. <br />
<br />
Bus 001 Device 006: ID 047d:1022 Kensington Orbit Optical<br />
<br />
Bus 001 Device 007: ID 1d19:1101 Dexatek Technology Ltd. DK DVB-T Dongle<br />
<br />
Bus 001 Device 008: ID 041e:3040 Creative Technology, Ltd SoundBlaster Live! 24-bit External SB0490<br />
<br />
Bus 001 Device 009: ID 0b95:1780 ASIX Electronics Corp. AX88178<br />
root@pisces:~# ifconfig <br />
<br />
eth0 Link encap:Ethernet HWaddr b8:27:eb:2c:07:c9<br />
<br />
inet addr:192.168.10.31 Bcast:192.168.10.255 Mask:255.255.255.0<br />
inet6 addr: fe80::ba27:ebff:fe2c:7c9/64 Scope:Link<br />
UP BROADCAST RUNNING MULTICAST MTU:1500 Metric:1<br />
RX packets:410 errors:0 dropped:0 overruns:0 frame:0<br />
TX packets:377 errors:0 dropped:0 overruns:0 carrier:0<br />
collisions:0 txqueuelen:1000<br />
RX bytes:28905 (28.2 KiB) TX bytes:35938 (35.0 KiB)<br />
<br />
eth1 Link encap:Ethernet HWaddr 00:10:14:00:9f:fa<br />
<br />
inet addr:192.168.2.199 Bcast:192.168.2.255 Mask:255.255.255.0<br />
inet6 addr: fe80::210:14ff:fe00:9ffa/64 Scope:Link<br />
UP BROADCAST RUNNING MULTICAST MTU:1500 Metric:1<br />
RX packets:5 errors:0 dropped:0 overruns:0 frame:0<br />
TX packets:7 errors:0 dropped:0 overruns:0 carrier:0<br />
collisions:0 txqueuelen:1000<br />
RX bytes:230 (230.0 B) TX bytes:592 (592.0 B)<br />
<br />
lo Link encap:Local Loopback<br />
<br />
inet addr:127.0.0.1 Mask:255.0.0.0<br />
inet6 addr: ::1/128 Scope:Host<br />
UP LOOPBACK RUNNING MTU:16436 Metric:1<br />
RX packets:0 errors:0 dropped:0 overruns:0 frame:0<br />
TX packets:0 errors:0 dropped:0 overruns:0 carrier:0<br />
collisions:0 txqueuelen:0<br />
RX bytes:0 (0.0 B) TX bytes:0 (0.0 B)<br />
<br />
root@pisces:~# cat /proc/asound/cards<br />
0 [ALSA ]: BRCM bcm2835 ALSbcm2835 ALSA - bcm2835 ALSA<br />
bcm2835 ALSA<br />
<br />
1 [External ]: USB-Audio - SB Live! 24-bit External<br />
Creative Technology SB Live! 24-bit External at usb-bcm2708_usb-1.2.2, full spe<br />
<br />
<br />
<br />
<br />
It's running at 855MHz with this config.txt file. <br />
root@pisces:~# cat /boot/config.txt<br />
<br />
over_voltage=6<br />
<br />
arm_freq=855<br />
<br />
core_freq=500<br />
<br />
sdram_freq=500<br />
<br />
<br />
root@pisces:~# cat /etc/network/interfaces<br />
<br />
Used by ifup(8) and ifdown(8). See the interfaces(5) manpage or<br />
/usr/share/doc/ifupdown/examples for more information. <br />
<br />
auto lo<br />
<br />
<br />
iface lo inet loopback<br />
<br />
<br />
File: ifcfg-eth0<br />
<br />
auto eth0<br />
<br />
iface eth0 inet static<br />
<br />
address 192.168.10.31<br />
<br />
netmask 255.255.255.0<br />
<br />
gateway 192.168.10.103<br />
<br />
<br />
auto eth1<br />
<br />
iface eth1 inet static<br />
<br />
address 192.168.2.199<br />
<br />
netmask 255.255.255.0<br />
<br />
<br />
root@pisces:~# cat /etc/modules<br />
<br />
/etc/modules: kernel modules to load at boot time.<br />
This file contains the names of kernel modules that should be loaded<br />
at boot time, one per line. Lines beginning with "#" are ignored.<br />
Parameters can be specified after the module name. <br />
<br />
loop<br />
<br />
snd-bcm2835<br />
<br />
<br />
One problem remains, no sound from the on-board chip.<br />
<br />
==VirtualBox (the easy way to get up and running)==<br />
<br />
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.<br />
<br />
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. <br />
<br />
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."<br />
<br />
The [[Dspserver.conf]] file should be edited to personalize your server, and to allow transmit. <br />
<br />
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.<br />
<br />
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.<br />
<br />
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.<br />
<br />
== SOFTWARE == <br />
***** START AT THE BEGINNING WHEN BUILDING THE SOFTWARE -- i.e Section 1 and install all the packages recommended and do the pulseaudio setup.<br />
<br />
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.<br />
<br />
Subject: [n2adr-sdr] Raspberry Pi running ghpsdr3-alex<br />
<br />
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.<br />
<br />
<br />
autoreconf -i <br />
<br />
./configure CFLAGS='-O3 -pipe -march=armv6 -mfpu=vfp -mfloat-abi=hard' CXXFLAGS='-O3 -pipe -march=armv6 -mfpu=vfp -mfloat-abi=hard' <br />
<br />
**** Additional steps needed when building rtlsdr-server. Do these before running make ******<br />
# export ac_cv_func_malloc_0_nonnull=yes<br />
# export ac_cv_func_realloc_0_nonnull=yes<br />
<br />
<br />
make all && make all install <br />
<br />
<br />
Sound on the Raspberry Pi is still a problem I have not been able to solve.<br />
<br />
Terry (WB4JFI) suggested the following that work for him but I have had no luck with it.<br />
<br />
"amixer cset numid=3 1"<br />
<br />
Other valid numid's are 0=auto, 1=headphones and 2=hdmi.<br />
<br />
<br />
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.<br />
<br />
When a slave connected and tried changing frequency, dspserver crashed - dspserver can be a bit crash happy.<br />
<br />
The first thing I tried on the Pi was QtRadio standalone, spectrum and waterfall were OK but no sound.<br />
<br />
Just now a client using glSDR (5) is attempting to change frequency, sound went quite distorted then dspserver crashed.<br />
<br />
Restarted dspserver and QtRadio sound started very distorted before it settled down to reasonable.</div>Frohrohttps://napan.ca/ghpsdr3/index.php?title=QtRadio_Installation&diff=763QtRadio Installation2013-08-27T13:34:02Z<p>Frohro: /* VIRTUALBOX */</p>
<hr />
<div>== Installation on Linux ==<br />
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.<br />
<br />
<br />
<br />
<br />
=== Installation from Git ===<br />
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.<br />
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.<br />
<br />
==== Installing compiler and autotool ====<br />
<br />
First off, install the compiler; depending on which distribution are you using, some or all of this stuff could be already installed: <br />
<br />
===== Ubuntu/Debian =====<br />
<pre><br />
sudo apt-get install make gcc g++<br />
sudo apt-get install autoconf automake autotools-dev libtool git subversion<br />
</pre><br />
<br />
===== Fedora =====<br />
<pre><br />
sudo yum install gcc gcc-c++ man-pages autoconf automake subversion libtool git<br />
</pre><br />
<br />
==== Installing prerequisite packages ====<br />
<br />
===== Ubuntu 12.04 and newer =====<br />
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:<br />
<br />
<pre><br />
sudo apt-get update<br />
sudo apt-get install \<br />
libqt4-opengl-dev \<br />
qtmobility-dev \<br />
libusb-0.1-4 \<br />
libusb-dev \<br />
libfftw3-dev \<br />
portaudio19-dev \<br />
libpulse-dev \<br />
libsamplerate0-dev \<br />
libusb-1.0-0-dev \<br />
libconfig8-dev \<br />
xdg-utils \<br />
libortp-dev \<br />
gcc-multilib \<br />
libssl-dev \<br />
libevent-dev \<br />
libglu1-mesa-dev \<br />
freeglut3-dev<br />
</pre><br />
<br />
You will need qt5 installed to complete the build.<br />
<br />
Visit: http://qt-project.org/downloads<br />
<br />
download the current package for your system.<br />
<br />
To build Qt5 on a RaspberryPi visit: http://qt-project.org/wiki/RaspberryPi<br />
<br />
After downloading it go to the download directory and do:<br />
<pre><br />
$ chmod +x the-name-of-the-downloaded-file<br />
$ sudo ./the-name-of-the-downloaded-file<br />
</pre><br />
<br />
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:<br />
<pre><br />
$ export PATH=/opt/Qt5.1.0/5.1.0/gcc_64/bin:/opt/Qt5.1.0/Tools/QtCreator/bin:$PATH<br />
</pre><br />
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.<br />
In any case please remember that<br />
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<br />
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.<br />
For the bash it is typically ~/.bashrc<br />
In any case, after you issue the export, please test it.<br />
<pre><br />
qmake -v<br />
QMake version 2.01a<br />
Using Qt version 4.8.0 in /home/andrew/QtSDK4.8x/Desktop/Qt/4.8.0/gcc/lib<br />
</pre><br />
<br />
===== Ubuntu 11.04 and older ===== <br />
First of all, you have to check that the ''universe repository'' is enabled.<br />
Please see the procedure in the previous section [[#graphical installation]] .<br />
<br />
Next, you will need the following packages installed:<br />
<br />
<pre><br />
sudo apt-get update<br />
sudo apt-get install \<br />
libqt4-opengl-dev \<br />
qtmobility-dev \<br />
libusb-0.1-4 \<br />
libusb-dev \<br />
libfftw3-dev \<br />
portaudio19-dev \<br />
libpulse-dev \<br />
libsamplerate0-dev \<br />
libusb-1.0-0-dev \<br />
libconfig8-dev \<br />
libortp-dev<br />
</pre><br />
<br />
===== Ubuntu 11.10 ===== <br />
First of all, you have to check that the ''universe repository'' is enabled.<br />
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.<br />
Next, submit the following commands into a terminal window:<br />
<br />
<pre><br />
sudo apt-get update<br />
sudo apt-get install \<br />
libqt4-opengl-dev \<br />
qtmobility-dev \<br />
libusb-0.1-4 \<br />
libusb-dev \<br />
libfftw3-dev \<br />
portaudio19-dev \<br />
libpulse-dev \<br />
libsamplerate0-dev \<br />
libusb-1.0-0-dev \<br />
libconfig8-dev \<br />
xdg-utils \<br />
libortp-dev<br />
</pre><br />
<br />
===== Fedora 16 =====<br />
<br />
<pre><br />
sudo yum install fftw fftw-devel <br />
sudo yum install libusb-devel libusb1-devel <br />
sudo yum install portaudio-devel<br />
sudo yum install libconfig-devel<br />
sudo yum install libsamplerate-devel<br />
sudo yum install pulseaudio-libs-devel<br />
sudo yum install jack-audio-connection-kit jack-audio-connection-kit-devel<br />
sudo yum install qt4-devel<br />
</pre><br />
<br />
<br />
==== Cloning the repository ====<br />
<br />
How to build the latest master branch on Ubuntu 11.04<br />
<br />
First a new libevent will need to be downloaded and installed, then the actual QtRadio source can be downloaded and built.<br />
<br />
==== Obtaining an up-level libevent library ====<br />
<br />
$ sudo apt-get install libevent-dev<br />
<br />
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)<br />
<br />
Then download the new version from:<br />
<br />
http://libevent.org/<br />
<br />
libevent-2.0.16-stable.tar.gz<br />
<br />
<pre><br />
wget https://github.com/downloads/libevent/libevent/libevent-2.0.16-stable.tar.gz<br />
</pre><br />
<br />
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:<br />
<br />
<pre><br />
cd<br />
tar -zxvf libevent-2.0.16-stable.tar.gz<br />
cd libevent-2.0.16-stable<br />
./configure<br />
make<br />
sudo make install<br />
sudo ldconfig<br />
</pre><br />
<br />
On Fedora, in order to use the library above, export the LD_LIBRARY_PATH:<br />
<br />
<pre><br />
export LD_LIBRARY_PATH=/usr/local/lib<br />
</pre><br />
<br />
==== Installing codec2 low bit rate audio encoding and decoding ====<br />
<br />
We are adding a low bit rate audio codec called codec 2 to QtRadio/dspserver. You need<br />
to download and build the codec2 library. See:<br />
<br />
http://www.rowetel.com/blog/?page_id=452<br />
<p><br />
Now go get codec2 using subversion<br />
<br />
<pre><br />
cd<br />
svn co https://freetel.svn.sourceforge.net/svnroot/freetel/codec2-dev codec2-dev<br />
cd codec2-dev<br />
autoreconf -i<br />
./configure<br />
make<br />
sudo make install<br />
sudo ldconfig<br />
</pre><br />
<br />
On Fedora, in order to use the library above, export the LD_LIBRARY_PATH:<br />
<br />
<pre><br />
export LD_LIBRARY_PATH=/usr/local/lib<br />
</pre><br />
<br />
==== Building the master branch ====<br />
<br />
This branch is the latest code that contains both RX and TX capability. <br />
<br />
Create a new directory or cd to the ~/src directory created for libevent and cd into it.<br />
<br />
<pre><br />
git clone git://github.com/alexlee188/ghpsdr3-alex<br />
</pre><br />
<br />
Depending on your Internet connection thorughput, it will take several minute to download.<br />
cd into the new directory ghpsdr3-alex:<br />
<pre><br />
cd ghpsdr3-alex<br />
git checkout master<br />
</pre><br />
You are now working with Alex's latest and greatest!<br />
<br />
First set the path to the version of qt you are using. E.g. for qt5:<br />
<pre><br />
$ export PATH=/opt/qt5/bin:$PATH<br />
</pre><br />
<br />
Then:<br />
<pre><br />
autoreconf -i<br />
./configure<br />
make -j4 all<br />
sudo make install<br />
</pre><br />
The default configure above builds with debug and default Qt4 version in your PC. For optimized executable,<br />
you need to specify options specific to your system. See the sample shell scripts that replaces the above<br />
./configure step:<br />
<br />
<pre><br />
./alex-avx-conf.sh for building with i3,i5 and i7 cpu's supporting Advanced Vector Extensions (AVX)<br />
./alex-openmp-conf.sh for building with i3,i5 and i7 cpu's and OpenMP support<br />
./alex-sse3-conf.sh for building with SSE3 capable cpu's<br />
./alex-openmp-sse3-conf.sh for building with SSE3 cpaable cpu's and OpenMP support<br />
</pre><br />
<br />
(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)<br />
<pre><br />
Terminal 1<br />
$ cd ghpsdr3-alex/trunk/src/softrock<br />
$ ./softrock ...options ...<br />
<br />
Terminal 2<br />
$ cd ghpsdr3-alex/trunk/src/dspserver<br />
$ ./dspserver ..options...<br />
<br />
Terminal 3<br />
$ cd ghpsdr3-alex/trunk/src/QtRadio<br />
$ ./QtRadio<br />
</pre><br />
<br />
==== Building the Perseus extensions ====<br />
<br />
In order to build the Microtelecom Perseus server you need to switch to the master or iw0hdv branch. <br />
<br />
First off, install the prerequisite library and wget package:<br />
<br />
<pre><br />
sudo apt-get install libboost-all-dev wget<br />
</pre><br />
<br />
Next download, compile and install the library libperseus-sdr:<br />
<br />
<pre><br />
cd<br />
wget http://libperseus-sdr.googlecode.com/files/libperseus_sdr-0.6.tar.gz<br />
tar -zxvf libperseus_sdr-0.6.tar.gz<br />
cd libperseus_sdr-0.6/<br />
./configure && make<br />
sudo make install<br />
sudo ldconfig<br />
</pre><br />
<br />
<br />
If you already build in your sandbox some other branch, is strongly advisable, before you start the build, to do a full cleanup:<br />
<pre><br />
cd ~/ghpsdr3-alex<br />
make distcheck && sh cleanup.sh<br />
</pre><br />
<br />
Otherwise, if you are starting from scratch, you have to clone the repository:<br />
<br />
<pre><br />
git clone git://github.com/alexlee188/ghpsdr3-alex<br />
</pre><br />
<br />
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.<br />
<br />
<pre><br />
cd ~/ghpsdr3-alex<br />
git checkout master<br />
autoreconf -i && ./configure && make -j4<br />
sudo make install<br />
</pre><br />
<br />
In order to run it you have two choices, the first one being the plain command line:<br />
<br />
<pre><br />
xterm -e 'perseus_server -d3 -s96000 ' &<br />
sleep 3<br />
xterm -e 'dspserver --lo 0 --nocorrectiq' &<br />
sleep 5<br />
$( QtRadio 127.0.0.1 ) <br />
</pre><br />
<br />
In QtRadio, Receiver menu, select Configure item, Server tab: here add the local host using the 127.0.0.1 IP address.<br />
Pressing the key C, you start the receiver.<br />
<br />
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.<br />
<br />
==== Building USRP enabled version ====<br />
<br />
===== Building the UHD package =====<br />
<br />
<br />
====== Install the prerequisite packages (Ubuntu 11.10): ======<br />
<br />
<pre><br />
sudo apt-get install liboost-all-dev<br />
sudo apt-get install python-cheetah<br />
</pre><br />
<br />
====== Build & Install UHD -- FOR UHD-3.3.1 AND GREATER --: ======<br />
<br />
<pre><br />
cd<br />
git clone git://ettus.sourcerepo.com/ettus/uhd.git<br />
cd uhd/host/<br />
mkdir build<br />
cd build<br />
cmake ../<br />
make<br />
make test<br />
sudo make install<br />
sudo ldconfig<br />
</pre><br />
<br />
If you already build in your sandbox some other branch, is strongly advisable, before you start the build, to do a full cleanup:<br />
<pre><br />
cd ~/ghpsdr3-alex<br />
make distcheck && sh cleanup.sh<br />
</pre><br />
<br />
Otherwise, if you are starting from scratch, first clone the repository:<br />
<br />
<pre><br />
git clone git://github.com/alexlee188/ghpsdr3-alex<br />
</pre><br />
<br />
Finally, you can switch to the master branch and rebuild everything, enabling the usrp server feature:<br />
<pre><br />
cd ~/ghpsdr3-alex<br />
git checkout usrp-server<br />
autoreconf -i && ./configure --enable-usrp=yes && make -j4<br />
sudo make install<br />
</pre><br />
<br />
==== Refresh to a Newer Version ====<br />
<br />
To pull a new version to build <br />
<pre><br />
$ git pull<br />
$ make -j4 all<br />
$ sudo make install<br />
</pre><br />
If extensive changes have occurred or if you get errors during the make, you may want to do a clean build <br />
<pre><br />
$ git pull<br />
$ make distclean<br />
$ sh cleanup.sh<br />
$ autoreconf -i<br />
$ ./configure<br />
$ make -j4 all<br />
$ sudo make install<br />
</pre><br />
If you continue to get errors, please report the whole ./configure output and the config.log to the mailing list.<br />
<br />
== Installation on Windows ==<br />
See [[ QtRadio on Windows]]<br />
<br />
== Network settings ==<br />
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.<br />
<br />
<br />
<br />
<br />
== Installing ghpsdr3-alex on Raspberry Pi == <br />
<br />
<br />
========== HARDWARE ==========<br />
<br />
*** THIS SECTION DEALS WITH Raspberry Pi DIFFERENCES *** IT DOES NOT CIRCUMVENT THE INSTRUCTIONS STARTING AT STEP 1 OF THE QtRadio Installation. ***<br />
<br />
I recommend installing either the raspbian or raspbian pisces (debian) distributions as there is no Ubuntu release to date.<br />
<br />
*** 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 <br />
document from the beginning after installing raspbian or raspbian pisces.<br />
<br />
<br />
The RasPi USB subsystem is sensitive to power supply voltage levels - A supply of 5.5V at 2A is recommended. <br />
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. <br />
<br />
Measuring the voltage across TP1 and TP2 on the Raspberry Pi and increased it to +4.97V (P.S output +5.59V).<br />
<br />
I also ran "rpi-update" which install new firmware. <br />
<br />
I shorted out the polyfuses F1 and F2 on the Pi and USB is much more stable but still limited.<br />
<br />
With keyboard, mouse, gigabit USB Ethernet, SB Live! 24 USB and RTL-SDR dongle it runs for some hours before it freezes.<br />
<br />
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.<br />
<br />
root@pisces:/usr/src/GHPSDR3_HIGH_SPEED_MASTER/ghpsdr3-alex# date<br />
<br />
Sun Sep 9 13:00:49 BST 2012<br />
<br />
root@pisces:/usr/src/GHPSDR3_HIGH_SPEED_MASTER/ghpsdr3-alex# uptime<br />
<br />
13:00:56 up 2 days, 20:46, 8 users, load average: 0.81, 1.01, 0.67<br />
<br />
<br />
<br />
<br />
****** Do not use power from a USB PC port or from a USB Hub. ********<br />
<br />
<br />
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):-<br />
<br />
Keyboard, mouse, usb sound card, RTL-SDR TV dongle and USB Gigabit Ethernet fully operational using the 7-port powered USB hub.<br />
<br />
root@pisces:~# lsusb<br />
<br />
Bus 001 Device 001: ID 1d6b:0002 Linux Foundation 2.0 root hub<br />
<br />
Bus 001 Device 002: ID 0424:9512 Standard Microsystems Corp. <br />
<br />
Bus 001 Device 003: ID 0424:ec00 Standard Microsystems Corp.<br />
<br />
Bus 001 Device 004: ID 04cc:1521 ST-Ericsson USB 2.0 Hub<br />
<br />
Bus 001 Device 011: ID 04f3:0103 Elan Microelectronics Corp. <br />
<br />
Bus 001 Device 006: ID 047d:1022 Kensington Orbit Optical<br />
<br />
Bus 001 Device 007: ID 1d19:1101 Dexatek Technology Ltd. DK DVB-T Dongle<br />
<br />
Bus 001 Device 008: ID 041e:3040 Creative Technology, Ltd SoundBlaster Live! 24-bit External SB0490<br />
<br />
Bus 001 Device 009: ID 0b95:1780 ASIX Electronics Corp. AX88178<br />
root@pisces:~# ifconfig <br />
<br />
eth0 Link encap:Ethernet HWaddr b8:27:eb:2c:07:c9<br />
<br />
inet addr:192.168.10.31 Bcast:192.168.10.255 Mask:255.255.255.0<br />
inet6 addr: fe80::ba27:ebff:fe2c:7c9/64 Scope:Link<br />
UP BROADCAST RUNNING MULTICAST MTU:1500 Metric:1<br />
RX packets:410 errors:0 dropped:0 overruns:0 frame:0<br />
TX packets:377 errors:0 dropped:0 overruns:0 carrier:0<br />
collisions:0 txqueuelen:1000<br />
RX bytes:28905 (28.2 KiB) TX bytes:35938 (35.0 KiB)<br />
<br />
eth1 Link encap:Ethernet HWaddr 00:10:14:00:9f:fa<br />
<br />
inet addr:192.168.2.199 Bcast:192.168.2.255 Mask:255.255.255.0<br />
inet6 addr: fe80::210:14ff:fe00:9ffa/64 Scope:Link<br />
UP BROADCAST RUNNING MULTICAST MTU:1500 Metric:1<br />
RX packets:5 errors:0 dropped:0 overruns:0 frame:0<br />
TX packets:7 errors:0 dropped:0 overruns:0 carrier:0<br />
collisions:0 txqueuelen:1000<br />
RX bytes:230 (230.0 B) TX bytes:592 (592.0 B)<br />
<br />
lo Link encap:Local Loopback<br />
<br />
inet addr:127.0.0.1 Mask:255.0.0.0<br />
inet6 addr: ::1/128 Scope:Host<br />
UP LOOPBACK RUNNING MTU:16436 Metric:1<br />
RX packets:0 errors:0 dropped:0 overruns:0 frame:0<br />
TX packets:0 errors:0 dropped:0 overruns:0 carrier:0<br />
collisions:0 txqueuelen:0<br />
RX bytes:0 (0.0 B) TX bytes:0 (0.0 B)<br />
<br />
root@pisces:~# cat /proc/asound/cards<br />
0 [ALSA ]: BRCM bcm2835 ALSbcm2835 ALSA - bcm2835 ALSA<br />
bcm2835 ALSA<br />
<br />
1 [External ]: USB-Audio - SB Live! 24-bit External<br />
Creative Technology SB Live! 24-bit External at usb-bcm2708_usb-1.2.2, full spe<br />
<br />
<br />
<br />
<br />
It's running at 855MHz with this config.txt file. <br />
root@pisces:~# cat /boot/config.txt<br />
<br />
over_voltage=6<br />
<br />
arm_freq=855<br />
<br />
core_freq=500<br />
<br />
sdram_freq=500<br />
<br />
<br />
root@pisces:~# cat /etc/network/interfaces<br />
<br />
Used by ifup(8) and ifdown(8). See the interfaces(5) manpage or<br />
/usr/share/doc/ifupdown/examples for more information. <br />
<br />
auto lo<br />
<br />
<br />
iface lo inet loopback<br />
<br />
<br />
File: ifcfg-eth0<br />
<br />
auto eth0<br />
<br />
iface eth0 inet static<br />
<br />
address 192.168.10.31<br />
<br />
netmask 255.255.255.0<br />
<br />
gateway 192.168.10.103<br />
<br />
<br />
auto eth1<br />
<br />
iface eth1 inet static<br />
<br />
address 192.168.2.199<br />
<br />
netmask 255.255.255.0<br />
<br />
<br />
root@pisces:~# cat /etc/modules<br />
<br />
/etc/modules: kernel modules to load at boot time.<br />
This file contains the names of kernel modules that should be loaded<br />
at boot time, one per line. Lines beginning with "#" are ignored.<br />
Parameters can be specified after the module name. <br />
<br />
loop<br />
<br />
snd-bcm2835<br />
<br />
<br />
One problem remains, no sound from the on-board chip.<br />
<br />
==VIRTUALBOX==<br />
<br />
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.<br />
<br />
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. <br />
<br />
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."<br />
<br />
The [[Dspserver.conf]] file should be edited to personalize your server, and to allow transmit. <br />
<br />
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.<br />
<br />
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.<br />
<br />
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.<br />
<br />
== SOFTWARE == <br />
***** START AT THE BEGINNING WHEN BUILDING THE SOFTWARE -- i.e Section 1 and install all the packages recommended and do the pulseaudio setup.<br />
<br />
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.<br />
<br />
Subject: [n2adr-sdr] Raspberry Pi running ghpsdr3-alex<br />
<br />
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.<br />
<br />
<br />
autoreconf -i <br />
<br />
./configure CFLAGS='-O3 -pipe -march=armv6 -mfpu=vfp -mfloat-abi=hard' CXXFLAGS='-O3 -pipe -march=armv6 -mfpu=vfp -mfloat-abi=hard' <br />
<br />
**** Additional steps needed when building rtlsdr-server. Do these before running make ******<br />
# export ac_cv_func_malloc_0_nonnull=yes<br />
# export ac_cv_func_realloc_0_nonnull=yes<br />
<br />
<br />
make all && make all install <br />
<br />
<br />
Sound on the Raspberry Pi is still a problem I have not been able to solve.<br />
<br />
Terry (WB4JFI) suggested the following that work for him but I have had no luck with it.<br />
<br />
"amixer cset numid=3 1"<br />
<br />
Other valid numid's are 0=auto, 1=headphones and 2=hdmi.<br />
<br />
<br />
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.<br />
<br />
When a slave connected and tried changing frequency, dspserver crashed - dspserver can be a bit crash happy.<br />
<br />
The first thing I tried on the Pi was QtRadio standalone, spectrum and waterfall were OK but no sound.<br />
<br />
Just now a client using glSDR (5) is attempting to change frequency, sound went quite distorted then dspserver crashed.<br />
<br />
Restarted dspserver and QtRadio sound started very distorted before it settled down to reasonable.</div>Frohrohttps://napan.ca/ghpsdr3/index.php?title=QtRadio_Installation&diff=762QtRadio Installation2013-08-27T13:26:48Z<p>Frohro: /* VIRTUALBOX */</p>
<hr />
<div>== Installation on Linux ==<br />
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.<br />
<br />
<br />
<br />
<br />
=== Installation from Git ===<br />
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.<br />
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.<br />
<br />
==== Installing compiler and autotool ====<br />
<br />
First off, install the compiler; depending on which distribution are you using, some or all of this stuff could be already installed: <br />
<br />
===== Ubuntu/Debian =====<br />
<pre><br />
sudo apt-get install make gcc g++<br />
sudo apt-get install autoconf automake autotools-dev libtool git subversion<br />
</pre><br />
<br />
===== Fedora =====<br />
<pre><br />
sudo yum install gcc gcc-c++ man-pages autoconf automake subversion libtool git<br />
</pre><br />
<br />
==== Installing prerequisite packages ====<br />
<br />
===== Ubuntu 12.04 and newer =====<br />
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:<br />
<br />
<pre><br />
sudo apt-get update<br />
sudo apt-get install \<br />
libqt4-opengl-dev \<br />
qtmobility-dev \<br />
libusb-0.1-4 \<br />
libusb-dev \<br />
libfftw3-dev \<br />
portaudio19-dev \<br />
libpulse-dev \<br />
libsamplerate0-dev \<br />
libusb-1.0-0-dev \<br />
libconfig8-dev \<br />
xdg-utils \<br />
libortp-dev \<br />
gcc-multilib \<br />
libssl-dev \<br />
libevent-dev \<br />
libglu1-mesa-dev \<br />
freeglut3-dev<br />
</pre><br />
<br />
You will need qt5 installed to complete the build.<br />
<br />
Visit: http://qt-project.org/downloads<br />
<br />
download the current package for your system.<br />
<br />
To build Qt5 on a RaspberryPi visit: http://qt-project.org/wiki/RaspberryPi<br />
<br />
After downloading it go to the download directory and do:<br />
<pre><br />
$ chmod +x the-name-of-the-downloaded-file<br />
$ sudo ./the-name-of-the-downloaded-file<br />
</pre><br />
<br />
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:<br />
<pre><br />
$ export PATH=/opt/Qt5.1.0/5.1.0/gcc_64/bin:/opt/Qt5.1.0/Tools/QtCreator/bin:$PATH<br />
</pre><br />
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.<br />
In any case please remember that<br />
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<br />
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.<br />
For the bash it is typically ~/.bashrc<br />
In any case, after you issue the export, please test it.<br />
<pre><br />
qmake -v<br />
QMake version 2.01a<br />
Using Qt version 4.8.0 in /home/andrew/QtSDK4.8x/Desktop/Qt/4.8.0/gcc/lib<br />
</pre><br />
<br />
===== Ubuntu 11.04 and older ===== <br />
First of all, you have to check that the ''universe repository'' is enabled.<br />
Please see the procedure in the previous section [[#graphical installation]] .<br />
<br />
Next, you will need the following packages installed:<br />
<br />
<pre><br />
sudo apt-get update<br />
sudo apt-get install \<br />
libqt4-opengl-dev \<br />
qtmobility-dev \<br />
libusb-0.1-4 \<br />
libusb-dev \<br />
libfftw3-dev \<br />
portaudio19-dev \<br />
libpulse-dev \<br />
libsamplerate0-dev \<br />
libusb-1.0-0-dev \<br />
libconfig8-dev \<br />
libortp-dev<br />
</pre><br />
<br />
===== Ubuntu 11.10 ===== <br />
First of all, you have to check that the ''universe repository'' is enabled.<br />
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.<br />
Next, submit the following commands into a terminal window:<br />
<br />
<pre><br />
sudo apt-get update<br />
sudo apt-get install \<br />
libqt4-opengl-dev \<br />
qtmobility-dev \<br />
libusb-0.1-4 \<br />
libusb-dev \<br />
libfftw3-dev \<br />
portaudio19-dev \<br />
libpulse-dev \<br />
libsamplerate0-dev \<br />
libusb-1.0-0-dev \<br />
libconfig8-dev \<br />
xdg-utils \<br />
libortp-dev<br />
</pre><br />
<br />
===== Fedora 16 =====<br />
<br />
<pre><br />
sudo yum install fftw fftw-devel <br />
sudo yum install libusb-devel libusb1-devel <br />
sudo yum install portaudio-devel<br />
sudo yum install libconfig-devel<br />
sudo yum install libsamplerate-devel<br />
sudo yum install pulseaudio-libs-devel<br />
sudo yum install jack-audio-connection-kit jack-audio-connection-kit-devel<br />
sudo yum install qt4-devel<br />
</pre><br />
<br />
<br />
==== Cloning the repository ====<br />
<br />
How to build the latest master branch on Ubuntu 11.04<br />
<br />
First a new libevent will need to be downloaded and installed, then the actual QtRadio source can be downloaded and built.<br />
<br />
==== Obtaining an up-level libevent library ====<br />
<br />
$ sudo apt-get install libevent-dev<br />
<br />
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)<br />
<br />
Then download the new version from:<br />
<br />
http://libevent.org/<br />
<br />
libevent-2.0.16-stable.tar.gz<br />
<br />
<pre><br />
wget https://github.com/downloads/libevent/libevent/libevent-2.0.16-stable.tar.gz<br />
</pre><br />
<br />
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:<br />
<br />
<pre><br />
cd<br />
tar -zxvf libevent-2.0.16-stable.tar.gz<br />
cd libevent-2.0.16-stable<br />
./configure<br />
make<br />
sudo make install<br />
sudo ldconfig<br />
</pre><br />
<br />
On Fedora, in order to use the library above, export the LD_LIBRARY_PATH:<br />
<br />
<pre><br />
export LD_LIBRARY_PATH=/usr/local/lib<br />
</pre><br />
<br />
==== Installing codec2 low bit rate audio encoding and decoding ====<br />
<br />
We are adding a low bit rate audio codec called codec 2 to QtRadio/dspserver. You need<br />
to download and build the codec2 library. See:<br />
<br />
http://www.rowetel.com/blog/?page_id=452<br />
<p><br />
Now go get codec2 using subversion<br />
<br />
<pre><br />
cd<br />
svn co https://freetel.svn.sourceforge.net/svnroot/freetel/codec2-dev codec2-dev<br />
cd codec2-dev<br />
autoreconf -i<br />
./configure<br />
make<br />
sudo make install<br />
sudo ldconfig<br />
</pre><br />
<br />
On Fedora, in order to use the library above, export the LD_LIBRARY_PATH:<br />
<br />
<pre><br />
export LD_LIBRARY_PATH=/usr/local/lib<br />
</pre><br />
<br />
==== Building the master branch ====<br />
<br />
This branch is the latest code that contains both RX and TX capability. <br />
<br />
Create a new directory or cd to the ~/src directory created for libevent and cd into it.<br />
<br />
<pre><br />
git clone git://github.com/alexlee188/ghpsdr3-alex<br />
</pre><br />
<br />
Depending on your Internet connection thorughput, it will take several minute to download.<br />
cd into the new directory ghpsdr3-alex:<br />
<pre><br />
cd ghpsdr3-alex<br />
git checkout master<br />
</pre><br />
You are now working with Alex's latest and greatest!<br />
<br />
First set the path to the version of qt you are using. E.g. for qt5:<br />
<pre><br />
$ export PATH=/opt/qt5/bin:$PATH<br />
</pre><br />
<br />
Then:<br />
<pre><br />
autoreconf -i<br />
./configure<br />
make -j4 all<br />
sudo make install<br />
</pre><br />
The default configure above builds with debug and default Qt4 version in your PC. For optimized executable,<br />
you need to specify options specific to your system. See the sample shell scripts that replaces the above<br />
./configure step:<br />
<br />
<pre><br />
./alex-avx-conf.sh for building with i3,i5 and i7 cpu's supporting Advanced Vector Extensions (AVX)<br />
./alex-openmp-conf.sh for building with i3,i5 and i7 cpu's and OpenMP support<br />
./alex-sse3-conf.sh for building with SSE3 capable cpu's<br />
./alex-openmp-sse3-conf.sh for building with SSE3 cpaable cpu's and OpenMP support<br />
</pre><br />
<br />
(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)<br />
<pre><br />
Terminal 1<br />
$ cd ghpsdr3-alex/trunk/src/softrock<br />
$ ./softrock ...options ...<br />
<br />
Terminal 2<br />
$ cd ghpsdr3-alex/trunk/src/dspserver<br />
$ ./dspserver ..options...<br />
<br />
Terminal 3<br />
$ cd ghpsdr3-alex/trunk/src/QtRadio<br />
$ ./QtRadio<br />
</pre><br />
<br />
==== Building the Perseus extensions ====<br />
<br />
In order to build the Microtelecom Perseus server you need to switch to the master or iw0hdv branch. <br />
<br />
First off, install the prerequisite library and wget package:<br />
<br />
<pre><br />
sudo apt-get install libboost-all-dev wget<br />
</pre><br />
<br />
Next download, compile and install the library libperseus-sdr:<br />
<br />
<pre><br />
cd<br />
wget http://libperseus-sdr.googlecode.com/files/libperseus_sdr-0.6.tar.gz<br />
tar -zxvf libperseus_sdr-0.6.tar.gz<br />
cd libperseus_sdr-0.6/<br />
./configure && make<br />
sudo make install<br />
sudo ldconfig<br />
</pre><br />
<br />
<br />
If you already build in your sandbox some other branch, is strongly advisable, before you start the build, to do a full cleanup:<br />
<pre><br />
cd ~/ghpsdr3-alex<br />
make distcheck && sh cleanup.sh<br />
</pre><br />
<br />
Otherwise, if you are starting from scratch, you have to clone the repository:<br />
<br />
<pre><br />
git clone git://github.com/alexlee188/ghpsdr3-alex<br />
</pre><br />
<br />
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.<br />
<br />
<pre><br />
cd ~/ghpsdr3-alex<br />
git checkout master<br />
autoreconf -i && ./configure && make -j4<br />
sudo make install<br />
</pre><br />
<br />
In order to run it you have two choices, the first one being the plain command line:<br />
<br />
<pre><br />
xterm -e 'perseus_server -d3 -s96000 ' &<br />
sleep 3<br />
xterm -e 'dspserver --lo 0 --nocorrectiq' &<br />
sleep 5<br />
$( QtRadio 127.0.0.1 ) <br />
</pre><br />
<br />
In QtRadio, Receiver menu, select Configure item, Server tab: here add the local host using the 127.0.0.1 IP address.<br />
Pressing the key C, you start the receiver.<br />
<br />
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.<br />
<br />
==== Building USRP enabled version ====<br />
<br />
===== Building the UHD package =====<br />
<br />
<br />
====== Install the prerequisite packages (Ubuntu 11.10): ======<br />
<br />
<pre><br />
sudo apt-get install liboost-all-dev<br />
sudo apt-get install python-cheetah<br />
</pre><br />
<br />
====== Build & Install UHD -- FOR UHD-3.3.1 AND GREATER --: ======<br />
<br />
<pre><br />
cd<br />
git clone git://ettus.sourcerepo.com/ettus/uhd.git<br />
cd uhd/host/<br />
mkdir build<br />
cd build<br />
cmake ../<br />
make<br />
make test<br />
sudo make install<br />
sudo ldconfig<br />
</pre><br />
<br />
If you already build in your sandbox some other branch, is strongly advisable, before you start the build, to do a full cleanup:<br />
<pre><br />
cd ~/ghpsdr3-alex<br />
make distcheck && sh cleanup.sh<br />
</pre><br />
<br />
Otherwise, if you are starting from scratch, first clone the repository:<br />
<br />
<pre><br />
git clone git://github.com/alexlee188/ghpsdr3-alex<br />
</pre><br />
<br />
Finally, you can switch to the master branch and rebuild everything, enabling the usrp server feature:<br />
<pre><br />
cd ~/ghpsdr3-alex<br />
git checkout usrp-server<br />
autoreconf -i && ./configure --enable-usrp=yes && make -j4<br />
sudo make install<br />
</pre><br />
<br />
==== Refresh to a Newer Version ====<br />
<br />
To pull a new version to build <br />
<pre><br />
$ git pull<br />
$ make -j4 all<br />
$ sudo make install<br />
</pre><br />
If extensive changes have occurred or if you get errors during the make, you may want to do a clean build <br />
<pre><br />
$ git pull<br />
$ make distclean<br />
$ sh cleanup.sh<br />
$ autoreconf -i<br />
$ ./configure<br />
$ make -j4 all<br />
$ sudo make install<br />
</pre><br />
If you continue to get errors, please report the whole ./configure output and the config.log to the mailing list.<br />
<br />
== Installation on Windows ==<br />
See [[ QtRadio on Windows]]<br />
<br />
== Network settings ==<br />
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.<br />
<br />
<br />
<br />
<br />
== Installing ghpsdr3-alex on Raspberry Pi == <br />
<br />
<br />
========== HARDWARE ==========<br />
<br />
*** THIS SECTION DEALS WITH Raspberry Pi DIFFERENCES *** IT DOES NOT CIRCUMVENT THE INSTRUCTIONS STARTING AT STEP 1 OF THE QtRadio Installation. ***<br />
<br />
I recommend installing either the raspbian or raspbian pisces (debian) distributions as there is no Ubuntu release to date.<br />
<br />
*** 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 <br />
document from the beginning after installing raspbian or raspbian pisces.<br />
<br />
<br />
The RasPi USB subsystem is sensitive to power supply voltage levels - A supply of 5.5V at 2A is recommended. <br />
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. <br />
<br />
Measuring the voltage across TP1 and TP2 on the Raspberry Pi and increased it to +4.97V (P.S output +5.59V).<br />
<br />
I also ran "rpi-update" which install new firmware. <br />
<br />
I shorted out the polyfuses F1 and F2 on the Pi and USB is much more stable but still limited.<br />
<br />
With keyboard, mouse, gigabit USB Ethernet, SB Live! 24 USB and RTL-SDR dongle it runs for some hours before it freezes.<br />
<br />
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.<br />
<br />
root@pisces:/usr/src/GHPSDR3_HIGH_SPEED_MASTER/ghpsdr3-alex# date<br />
<br />
Sun Sep 9 13:00:49 BST 2012<br />
<br />
root@pisces:/usr/src/GHPSDR3_HIGH_SPEED_MASTER/ghpsdr3-alex# uptime<br />
<br />
13:00:56 up 2 days, 20:46, 8 users, load average: 0.81, 1.01, 0.67<br />
<br />
<br />
<br />
<br />
****** Do not use power from a USB PC port or from a USB Hub. ********<br />
<br />
<br />
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):-<br />
<br />
Keyboard, mouse, usb sound card, RTL-SDR TV dongle and USB Gigabit Ethernet fully operational using the 7-port powered USB hub.<br />
<br />
root@pisces:~# lsusb<br />
<br />
Bus 001 Device 001: ID 1d6b:0002 Linux Foundation 2.0 root hub<br />
<br />
Bus 001 Device 002: ID 0424:9512 Standard Microsystems Corp. <br />
<br />
Bus 001 Device 003: ID 0424:ec00 Standard Microsystems Corp.<br />
<br />
Bus 001 Device 004: ID 04cc:1521 ST-Ericsson USB 2.0 Hub<br />
<br />
Bus 001 Device 011: ID 04f3:0103 Elan Microelectronics Corp. <br />
<br />
Bus 001 Device 006: ID 047d:1022 Kensington Orbit Optical<br />
<br />
Bus 001 Device 007: ID 1d19:1101 Dexatek Technology Ltd. DK DVB-T Dongle<br />
<br />
Bus 001 Device 008: ID 041e:3040 Creative Technology, Ltd SoundBlaster Live! 24-bit External SB0490<br />
<br />
Bus 001 Device 009: ID 0b95:1780 ASIX Electronics Corp. AX88178<br />
root@pisces:~# ifconfig <br />
<br />
eth0 Link encap:Ethernet HWaddr b8:27:eb:2c:07:c9<br />
<br />
inet addr:192.168.10.31 Bcast:192.168.10.255 Mask:255.255.255.0<br />
inet6 addr: fe80::ba27:ebff:fe2c:7c9/64 Scope:Link<br />
UP BROADCAST RUNNING MULTICAST MTU:1500 Metric:1<br />
RX packets:410 errors:0 dropped:0 overruns:0 frame:0<br />
TX packets:377 errors:0 dropped:0 overruns:0 carrier:0<br />
collisions:0 txqueuelen:1000<br />
RX bytes:28905 (28.2 KiB) TX bytes:35938 (35.0 KiB)<br />
<br />
eth1 Link encap:Ethernet HWaddr 00:10:14:00:9f:fa<br />
<br />
inet addr:192.168.2.199 Bcast:192.168.2.255 Mask:255.255.255.0<br />
inet6 addr: fe80::210:14ff:fe00:9ffa/64 Scope:Link<br />
UP BROADCAST RUNNING MULTICAST MTU:1500 Metric:1<br />
RX packets:5 errors:0 dropped:0 overruns:0 frame:0<br />
TX packets:7 errors:0 dropped:0 overruns:0 carrier:0<br />
collisions:0 txqueuelen:1000<br />
RX bytes:230 (230.0 B) TX bytes:592 (592.0 B)<br />
<br />
lo Link encap:Local Loopback<br />
<br />
inet addr:127.0.0.1 Mask:255.0.0.0<br />
inet6 addr: ::1/128 Scope:Host<br />
UP LOOPBACK RUNNING MTU:16436 Metric:1<br />
RX packets:0 errors:0 dropped:0 overruns:0 frame:0<br />
TX packets:0 errors:0 dropped:0 overruns:0 carrier:0<br />
collisions:0 txqueuelen:0<br />
RX bytes:0 (0.0 B) TX bytes:0 (0.0 B)<br />
<br />
root@pisces:~# cat /proc/asound/cards<br />
0 [ALSA ]: BRCM bcm2835 ALSbcm2835 ALSA - bcm2835 ALSA<br />
bcm2835 ALSA<br />
<br />
1 [External ]: USB-Audio - SB Live! 24-bit External<br />
Creative Technology SB Live! 24-bit External at usb-bcm2708_usb-1.2.2, full spe<br />
<br />
<br />
<br />
<br />
It's running at 855MHz with this config.txt file. <br />
root@pisces:~# cat /boot/config.txt<br />
<br />
over_voltage=6<br />
<br />
arm_freq=855<br />
<br />
core_freq=500<br />
<br />
sdram_freq=500<br />
<br />
<br />
root@pisces:~# cat /etc/network/interfaces<br />
<br />
Used by ifup(8) and ifdown(8). See the interfaces(5) manpage or<br />
/usr/share/doc/ifupdown/examples for more information. <br />
<br />
auto lo<br />
<br />
<br />
iface lo inet loopback<br />
<br />
<br />
File: ifcfg-eth0<br />
<br />
auto eth0<br />
<br />
iface eth0 inet static<br />
<br />
address 192.168.10.31<br />
<br />
netmask 255.255.255.0<br />
<br />
gateway 192.168.10.103<br />
<br />
<br />
auto eth1<br />
<br />
iface eth1 inet static<br />
<br />
address 192.168.2.199<br />
<br />
netmask 255.255.255.0<br />
<br />
<br />
root@pisces:~# cat /etc/modules<br />
<br />
/etc/modules: kernel modules to load at boot time.<br />
This file contains the names of kernel modules that should be loaded<br />
at boot time, one per line. Lines beginning with "#" are ignored.<br />
Parameters can be specified after the module name. <br />
<br />
loop<br />
<br />
snd-bcm2835<br />
<br />
<br />
One problem remains, no sound from the on-board chip.<br />
<br />
==VIRTUALBOX==<br />
<br />
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". Basically, all you need to do is follow the instructions below, plug your 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, 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.<br />
<br />
The [[Dspserver.conf]] file needs to be edited, and you may need to adjust the commands that start the server 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. <br />
<br />
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."<br />
<br />
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 below.<br />
<br />
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.<br />
<br />
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.<br />
<br />
== SOFTWARE == <br />
***** START AT THE BEGINNING WHEN BUILDING THE SOFTWARE -- i.e Section 1 and install all the packages recommended and do the pulseaudio setup.<br />
<br />
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.<br />
<br />
Subject: [n2adr-sdr] Raspberry Pi running ghpsdr3-alex<br />
<br />
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.<br />
<br />
<br />
autoreconf -i <br />
<br />
./configure CFLAGS='-O3 -pipe -march=armv6 -mfpu=vfp -mfloat-abi=hard' CXXFLAGS='-O3 -pipe -march=armv6 -mfpu=vfp -mfloat-abi=hard' <br />
<br />
**** Additional steps needed when building rtlsdr-server. Do these before running make ******<br />
# export ac_cv_func_malloc_0_nonnull=yes<br />
# export ac_cv_func_realloc_0_nonnull=yes<br />
<br />
<br />
make all && make all install <br />
<br />
<br />
Sound on the Raspberry Pi is still a problem I have not been able to solve.<br />
<br />
Terry (WB4JFI) suggested the following that work for him but I have had no luck with it.<br />
<br />
"amixer cset numid=3 1"<br />
<br />
Other valid numid's are 0=auto, 1=headphones and 2=hdmi.<br />
<br />
<br />
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.<br />
<br />
When a slave connected and tried changing frequency, dspserver crashed - dspserver can be a bit crash happy.<br />
<br />
The first thing I tried on the Pi was QtRadio standalone, spectrum and waterfall were OK but no sound.<br />
<br />
Just now a client using glSDR (5) is attempting to change frequency, sound went quite distorted then dspserver crashed.<br />
<br />
Restarted dspserver and QtRadio sound started very distorted before it settled down to reasonable.</div>Frohrohttps://napan.ca/ghpsdr3/index.php?title=Main_Page&diff=761Main Page2013-08-27T12:52:57Z<p>Frohro: /* What is the actual ghpsdr3-alex Project software? */</p>
<hr />
<div>===[[What's New| What's New and latest news]]===<br />
=== '''The ghpsdr3-alex Project''' ===<br />
<br />
This is a modification of the excellent Software Defined Radio (SDR) software by John Melton [G0ORX/N6LYT][http://g0orx.blogspot.com]<br />
<br />
The original software by John is called ghpsdr3. We are working towards merging the two projects (ghpsdr3 and ghpsdr3-alex) source trees to a single source. However BEFORE that happens, you CANNOT mix and match programs from the two projects. See note for HPSDR hardware users below.<br />
<br />
Project README https://github.com/alexlee188/ghpsdr3-alex/blob/master/README [https://github.com/alexlee188/ghpsdr3-alex/blob/master/README]<br />
<br />
Source Code is via git at https://github.com/alexlee188/ghpsdr3-alex [https://github.com/alexlee188/ghpsdr3-alex]<br />
<br />
Discussions take place in the sdr-widget group http://groups.google.com/group/sdr-widget [http://groups.google.com/group/sdr-widget]<br />
<br />
You can browse the list of online dspservers at http://qtradio.napan.ca/qtradio/qtradio.pl[http://qtradio.napan.ca/qtradio/qtradio.pl]<br />
<br />
You can view the map of online dspservers worldwide at http://www.montefusco.com/ghpsdr3[http://www.montefusco.com/ghpsdr3]<br />
<br />
Currently it supports HPSDR, Softrock, UHFSDR, Microtelecom Perseus, SDR-iq, HiQSDR, Ettus Research USRP and [[RTL-SDR|rtl-sdr]] DVB-T dongles.<br />
<br />
=== '''What is the actual ghpsdr3-alex Project software?''' ===<br />
<br />
The software comprises 3 different components:<br />
<br />
'''A)''' server - there is a CLI based server for each type of hardware. For example, there are hpsdr-server, usrp-server, softrock (server), sdriq-server, HiQSDR etc. Some servers are based on soundcard/USB connections to the hardware. Some are connected via ethernet (eg HPSDR Metis).<br />
<br />
'''B)''' dspserver - this is the software in the middle that processes the IQ data from the server (connected over LAN via UDP) using DttSP. The same dspserver can connect to any of the servers in A.<br />
<br />
'''C)''' clients - this is the GUI user interface. There are clients built with Qt and runs on Windows, Linux, and Mac OSX. There is a working Android client that works on Android phones and Android tablets. The clients connect to dspserver via LAN or remotely via Internet. In future we will have java based web clients as well (either specifically written clients, or running Qt inside a web browser) Also, multiple clients can concurrently access the same dspserver. There is also RxTx capability (currently for voice modes). the QtRadio client has a Hamlib interface and can connect to gPredict, xLog, and fldigi (for digital mode)<br />
<br />
[[File:463px-Ghpsdr3.png]]<br />
<br />
'''Project Goals'''<br />
<br />
1. Open source (GPL) SDR software<br />
<br />
2. Client-server network-enabled by design from the ground up<br />
<br />
3. Customized server for each SDR hardware type. Currently supporting HPSDR, Softrock, UHFSDR, Microtelecom Perseus, RFSPACE SDR-IQ, HiQSDR, Ettus Research USRP, and the rtl-sdr DVB-T dongle.<br />
<br />
4. Single dspserver that connects to single server. However, each server can have multiple Rx and Tx channels.<br />
<br />
5. Multiple clients, such as QtRadio, that can concurrently connect to a single dspserver.<br />
<br />
6. Full Rx and Tx capability for hardware capable of Tx<br />
<br />
<br />
<br />
*[[Screenshots and Recordings]] <br />
*[[QtRadio on Windows]]<br />
*[[QtRadio - Operation]]<br />
*[[QtRadio Installation]]<br />
*[[aHPSDR]] Android Client<br />
*[[Pulseaudio Setup]]<br />
*[[Developers Documentation]]<br />
*[[Server Operation]]<br />
**[[dspserver.conf]]<br />
**[[SSL Key Generation]]<br />
**[[Hermes]]<br />
*[[ToDo/- Wishlist]]<br />
<br />
<br />
<br />
'''Note for HPSDR and ghpsdr3 (original) users:'''<br />
In general, you cannot mix and match software from the two projects, ghpsdr3 and ghpsdr3-alex. However, John has updated the programs in the ghpsdr3-alex repository, and the hpsdr-server program in gphsdr3-alex works for HPSDR hardware. The following newbie guide is written by Erich Heinzle (vk5hse at yahoo.com):<br />
<br />
http://openhpsdr.org/wiki/images/6/63/NewbieGuide.pdf</div>Frohrohttps://napan.ca/ghpsdr3/index.php?title=QtRadio_Installation&diff=760QtRadio Installation2013-08-26T19:47:11Z<p>Frohro: /* VIRTUALBOX */</p>
<hr />
<div>== Installation on Linux ==<br />
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.<br />
<br />
<br />
<br />
<br />
=== Installation from Git ===<br />
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.<br />
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.<br />
<br />
==== Installing compiler and autotool ====<br />
<br />
First off, install the compiler; depending on which distribution are you using, some or all of this stuff could be already installed: <br />
<br />
===== Ubuntu/Debian =====<br />
<pre><br />
sudo apt-get install make gcc g++<br />
sudo apt-get install autoconf automake autotools-dev libtool git subversion<br />
</pre><br />
<br />
===== Fedora =====<br />
<pre><br />
sudo yum install gcc gcc-c++ man-pages autoconf automake subversion libtool git<br />
</pre><br />
<br />
==== Installing prerequisite packages ====<br />
<br />
===== Ubuntu 12.04 and newer =====<br />
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:<br />
<br />
<pre><br />
sudo apt-get update<br />
sudo apt-get install \<br />
libqt4-opengl-dev \<br />
qtmobility-dev \<br />
libusb-0.1-4 \<br />
libusb-dev \<br />
libfftw3-dev \<br />
portaudio19-dev \<br />
libpulse-dev \<br />
libsamplerate0-dev \<br />
libusb-1.0-0-dev \<br />
libconfig8-dev \<br />
xdg-utils \<br />
libortp-dev \<br />
gcc-multilib \<br />
libssl-dev \<br />
libevent-dev \<br />
libglu1-mesa-dev \<br />
freeglut3-dev<br />
</pre><br />
<br />
You will need qt5 installed to complete the build.<br />
<br />
Visit: http://qt-project.org/downloads<br />
<br />
download the current package for your system.<br />
<br />
To build Qt5 on a RaspberryPi visit: http://qt-project.org/wiki/RaspberryPi<br />
<br />
After downloading it go to the download directory and do:<br />
<pre><br />
$ chmod +x the-name-of-the-downloaded-file<br />
$ sudo ./the-name-of-the-downloaded-file<br />
</pre><br />
<br />
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:<br />
<pre><br />
$ export PATH=/opt/Qt5.1.0/5.1.0/gcc_64/bin:/opt/Qt5.1.0/Tools/QtCreator/bin:$PATH<br />
</pre><br />
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.<br />
In any case please remember that<br />
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<br />
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.<br />
For the bash it is typically ~/.bashrc<br />
In any case, after you issue the export, please test it.<br />
<pre><br />
qmake -v<br />
QMake version 2.01a<br />
Using Qt version 4.8.0 in /home/andrew/QtSDK4.8x/Desktop/Qt/4.8.0/gcc/lib<br />
</pre><br />
<br />
===== Ubuntu 11.04 and older ===== <br />
First of all, you have to check that the ''universe repository'' is enabled.<br />
Please see the procedure in the previous section [[#graphical installation]] .<br />
<br />
Next, you will need the following packages installed:<br />
<br />
<pre><br />
sudo apt-get update<br />
sudo apt-get install \<br />
libqt4-opengl-dev \<br />
qtmobility-dev \<br />
libusb-0.1-4 \<br />
libusb-dev \<br />
libfftw3-dev \<br />
portaudio19-dev \<br />
libpulse-dev \<br />
libsamplerate0-dev \<br />
libusb-1.0-0-dev \<br />
libconfig8-dev \<br />
libortp-dev<br />
</pre><br />
<br />
===== Ubuntu 11.10 ===== <br />
First of all, you have to check that the ''universe repository'' is enabled.<br />
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.<br />
Next, submit the following commands into a terminal window:<br />
<br />
<pre><br />
sudo apt-get update<br />
sudo apt-get install \<br />
libqt4-opengl-dev \<br />
qtmobility-dev \<br />
libusb-0.1-4 \<br />
libusb-dev \<br />
libfftw3-dev \<br />
portaudio19-dev \<br />
libpulse-dev \<br />
libsamplerate0-dev \<br />
libusb-1.0-0-dev \<br />
libconfig8-dev \<br />
xdg-utils \<br />
libortp-dev<br />
</pre><br />
<br />
===== Fedora 16 =====<br />
<br />
<pre><br />
sudo yum install fftw fftw-devel <br />
sudo yum install libusb-devel libusb1-devel <br />
sudo yum install portaudio-devel<br />
sudo yum install libconfig-devel<br />
sudo yum install libsamplerate-devel<br />
sudo yum install pulseaudio-libs-devel<br />
sudo yum install jack-audio-connection-kit jack-audio-connection-kit-devel<br />
sudo yum install qt4-devel<br />
</pre><br />
<br />
<br />
==== Cloning the repository ====<br />
<br />
How to build the latest master branch on Ubuntu 11.04<br />
<br />
First a new libevent will need to be downloaded and installed, then the actual QtRadio source can be downloaded and built.<br />
<br />
==== Obtaining an up-level libevent library ====<br />
<br />
$ sudo apt-get install libevent-dev<br />
<br />
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)<br />
<br />
Then download the new version from:<br />
<br />
http://libevent.org/<br />
<br />
libevent-2.0.16-stable.tar.gz<br />
<br />
<pre><br />
wget https://github.com/downloads/libevent/libevent/libevent-2.0.16-stable.tar.gz<br />
</pre><br />
<br />
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:<br />
<br />
<pre><br />
cd<br />
tar -zxvf libevent-2.0.16-stable.tar.gz<br />
cd libevent-2.0.16-stable<br />
./configure<br />
make<br />
sudo make install<br />
sudo ldconfig<br />
</pre><br />
<br />
On Fedora, in order to use the library above, export the LD_LIBRARY_PATH:<br />
<br />
<pre><br />
export LD_LIBRARY_PATH=/usr/local/lib<br />
</pre><br />
<br />
==== Installing codec2 low bit rate audio encoding and decoding ====<br />
<br />
We are adding a low bit rate audio codec called codec 2 to QtRadio/dspserver. You need<br />
to download and build the codec2 library. See:<br />
<br />
http://www.rowetel.com/blog/?page_id=452<br />
<p><br />
Now go get codec2 using subversion<br />
<br />
<pre><br />
cd<br />
svn co https://freetel.svn.sourceforge.net/svnroot/freetel/codec2-dev codec2-dev<br />
cd codec2-dev<br />
autoreconf -i<br />
./configure<br />
make<br />
sudo make install<br />
sudo ldconfig<br />
</pre><br />
<br />
On Fedora, in order to use the library above, export the LD_LIBRARY_PATH:<br />
<br />
<pre><br />
export LD_LIBRARY_PATH=/usr/local/lib<br />
</pre><br />
<br />
==== Building the master branch ====<br />
<br />
This branch is the latest code that contains both RX and TX capability. <br />
<br />
Create a new directory or cd to the ~/src directory created for libevent and cd into it.<br />
<br />
<pre><br />
git clone git://github.com/alexlee188/ghpsdr3-alex<br />
</pre><br />
<br />
Depending on your Internet connection thorughput, it will take several minute to download.<br />
cd into the new directory ghpsdr3-alex:<br />
<pre><br />
cd ghpsdr3-alex<br />
git checkout master<br />
</pre><br />
You are now working with Alex's latest and greatest!<br />
<br />
First set the path to the version of qt you are using. E.g. for qt5:<br />
<pre><br />
$ export PATH=/opt/qt5/bin:$PATH<br />
</pre><br />
<br />
Then:<br />
<pre><br />
autoreconf -i<br />
./configure<br />
make -j4 all<br />
sudo make install<br />
</pre><br />
The default configure above builds with debug and default Qt4 version in your PC. For optimized executable,<br />
you need to specify options specific to your system. See the sample shell scripts that replaces the above<br />
./configure step:<br />
<br />
<pre><br />
./alex-avx-conf.sh for building with i3,i5 and i7 cpu's supporting Advanced Vector Extensions (AVX)<br />
./alex-openmp-conf.sh for building with i3,i5 and i7 cpu's and OpenMP support<br />
./alex-sse3-conf.sh for building with SSE3 capable cpu's<br />
./alex-openmp-sse3-conf.sh for building with SSE3 cpaable cpu's and OpenMP support<br />
</pre><br />
<br />
(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)<br />
<pre><br />
Terminal 1<br />
$ cd ghpsdr3-alex/trunk/src/softrock<br />
$ ./softrock ...options ...<br />
<br />
Terminal 2<br />
$ cd ghpsdr3-alex/trunk/src/dspserver<br />
$ ./dspserver ..options...<br />
<br />
Terminal 3<br />
$ cd ghpsdr3-alex/trunk/src/QtRadio<br />
$ ./QtRadio<br />
</pre><br />
<br />
==== Building the Perseus extensions ====<br />
<br />
In order to build the Microtelecom Perseus server you need to switch to the master or iw0hdv branch. <br />
<br />
First off, install the prerequisite library and wget package:<br />
<br />
<pre><br />
sudo apt-get install libboost-all-dev wget<br />
</pre><br />
<br />
Next download, compile and install the library libperseus-sdr:<br />
<br />
<pre><br />
cd<br />
wget http://libperseus-sdr.googlecode.com/files/libperseus_sdr-0.6.tar.gz<br />
tar -zxvf libperseus_sdr-0.6.tar.gz<br />
cd libperseus_sdr-0.6/<br />
./configure && make<br />
sudo make install<br />
sudo ldconfig<br />
</pre><br />
<br />
<br />
If you already build in your sandbox some other branch, is strongly advisable, before you start the build, to do a full cleanup:<br />
<pre><br />
cd ~/ghpsdr3-alex<br />
make distcheck && sh cleanup.sh<br />
</pre><br />
<br />
Otherwise, if you are starting from scratch, you have to clone the repository:<br />
<br />
<pre><br />
git clone git://github.com/alexlee188/ghpsdr3-alex<br />
</pre><br />
<br />
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.<br />
<br />
<pre><br />
cd ~/ghpsdr3-alex<br />
git checkout master<br />
autoreconf -i && ./configure && make -j4<br />
sudo make install<br />
</pre><br />
<br />
In order to run it you have two choices, the first one being the plain command line:<br />
<br />
<pre><br />
xterm -e 'perseus_server -d3 -s96000 ' &<br />
sleep 3<br />
xterm -e 'dspserver --lo 0 --nocorrectiq' &<br />
sleep 5<br />
$( QtRadio 127.0.0.1 ) <br />
</pre><br />
<br />
In QtRadio, Receiver menu, select Configure item, Server tab: here add the local host using the 127.0.0.1 IP address.<br />
Pressing the key C, you start the receiver.<br />
<br />
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.<br />
<br />
==== Building USRP enabled version ====<br />
<br />
===== Building the UHD package =====<br />
<br />
<br />
====== Install the prerequisite packages (Ubuntu 11.10): ======<br />
<br />
<pre><br />
sudo apt-get install liboost-all-dev<br />
sudo apt-get install python-cheetah<br />
</pre><br />
<br />
====== Build & Install UHD -- FOR UHD-3.3.1 AND GREATER --: ======<br />
<br />
<pre><br />
cd<br />
git clone git://ettus.sourcerepo.com/ettus/uhd.git<br />
cd uhd/host/<br />
mkdir build<br />
cd build<br />
cmake ../<br />
make<br />
make test<br />
sudo make install<br />
sudo ldconfig<br />
</pre><br />
<br />
If you already build in your sandbox some other branch, is strongly advisable, before you start the build, to do a full cleanup:<br />
<pre><br />
cd ~/ghpsdr3-alex<br />
make distcheck && sh cleanup.sh<br />
</pre><br />
<br />
Otherwise, if you are starting from scratch, first clone the repository:<br />
<br />
<pre><br />
git clone git://github.com/alexlee188/ghpsdr3-alex<br />
</pre><br />
<br />
Finally, you can switch to the master branch and rebuild everything, enabling the usrp server feature:<br />
<pre><br />
cd ~/ghpsdr3-alex<br />
git checkout usrp-server<br />
autoreconf -i && ./configure --enable-usrp=yes && make -j4<br />
sudo make install<br />
</pre><br />
<br />
==== Refresh to a Newer Version ====<br />
<br />
To pull a new version to build <br />
<pre><br />
$ git pull<br />
$ make -j4 all<br />
$ sudo make install<br />
</pre><br />
If extensive changes have occurred or if you get errors during the make, you may want to do a clean build <br />
<pre><br />
$ git pull<br />
$ make distclean<br />
$ sh cleanup.sh<br />
$ autoreconf -i<br />
$ ./configure<br />
$ make -j4 all<br />
$ sudo make install<br />
</pre><br />
If you continue to get errors, please report the whole ./configure output and the config.log to the mailing list.<br />
<br />
== Installation on Windows ==<br />
See [[ QtRadio on Windows]]<br />
<br />
== Network settings ==<br />
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.<br />
<br />
<br />
<br />
<br />
== Installing ghpsdr3-alex on Raspberry Pi == <br />
<br />
<br />
========== HARDWARE ==========<br />
<br />
*** THIS SECTION DEALS WITH Raspberry Pi DIFFERENCES *** IT DOES NOT CIRCUMVENT THE INSTRUCTIONS STARTING AT STEP 1 OF THE QtRadio Installation. ***<br />
<br />
I recommend installing either the raspbian or raspbian pisces (debian) distributions as there is no Ubuntu release to date.<br />
<br />
*** 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 <br />
document from the beginning after installing raspbian or raspbian pisces.<br />
<br />
<br />
The RasPi USB subsystem is sensitive to power supply voltage levels - A supply of 5.5V at 2A is recommended. <br />
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. <br />
<br />
Measuring the voltage across TP1 and TP2 on the Raspberry Pi and increased it to +4.97V (P.S output +5.59V).<br />
<br />
I also ran "rpi-update" which install new firmware. <br />
<br />
I shorted out the polyfuses F1 and F2 on the Pi and USB is much more stable but still limited.<br />
<br />
With keyboard, mouse, gigabit USB Ethernet, SB Live! 24 USB and RTL-SDR dongle it runs for some hours before it freezes.<br />
<br />
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.<br />
<br />
root@pisces:/usr/src/GHPSDR3_HIGH_SPEED_MASTER/ghpsdr3-alex# date<br />
<br />
Sun Sep 9 13:00:49 BST 2012<br />
<br />
root@pisces:/usr/src/GHPSDR3_HIGH_SPEED_MASTER/ghpsdr3-alex# uptime<br />
<br />
13:00:56 up 2 days, 20:46, 8 users, load average: 0.81, 1.01, 0.67<br />
<br />
<br />
<br />
<br />
****** Do not use power from a USB PC port or from a USB Hub. ********<br />
<br />
<br />
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):-<br />
<br />
Keyboard, mouse, usb sound card, RTL-SDR TV dongle and USB Gigabit Ethernet fully operational using the 7-port powered USB hub.<br />
<br />
root@pisces:~# lsusb<br />
<br />
Bus 001 Device 001: ID 1d6b:0002 Linux Foundation 2.0 root hub<br />
<br />
Bus 001 Device 002: ID 0424:9512 Standard Microsystems Corp. <br />
<br />
Bus 001 Device 003: ID 0424:ec00 Standard Microsystems Corp.<br />
<br />
Bus 001 Device 004: ID 04cc:1521 ST-Ericsson USB 2.0 Hub<br />
<br />
Bus 001 Device 011: ID 04f3:0103 Elan Microelectronics Corp. <br />
<br />
Bus 001 Device 006: ID 047d:1022 Kensington Orbit Optical<br />
<br />
Bus 001 Device 007: ID 1d19:1101 Dexatek Technology Ltd. DK DVB-T Dongle<br />
<br />
Bus 001 Device 008: ID 041e:3040 Creative Technology, Ltd SoundBlaster Live! 24-bit External SB0490<br />
<br />
Bus 001 Device 009: ID 0b95:1780 ASIX Electronics Corp. AX88178<br />
root@pisces:~# ifconfig <br />
<br />
eth0 Link encap:Ethernet HWaddr b8:27:eb:2c:07:c9<br />
<br />
inet addr:192.168.10.31 Bcast:192.168.10.255 Mask:255.255.255.0<br />
inet6 addr: fe80::ba27:ebff:fe2c:7c9/64 Scope:Link<br />
UP BROADCAST RUNNING MULTICAST MTU:1500 Metric:1<br />
RX packets:410 errors:0 dropped:0 overruns:0 frame:0<br />
TX packets:377 errors:0 dropped:0 overruns:0 carrier:0<br />
collisions:0 txqueuelen:1000<br />
RX bytes:28905 (28.2 KiB) TX bytes:35938 (35.0 KiB)<br />
<br />
eth1 Link encap:Ethernet HWaddr 00:10:14:00:9f:fa<br />
<br />
inet addr:192.168.2.199 Bcast:192.168.2.255 Mask:255.255.255.0<br />
inet6 addr: fe80::210:14ff:fe00:9ffa/64 Scope:Link<br />
UP BROADCAST RUNNING MULTICAST MTU:1500 Metric:1<br />
RX packets:5 errors:0 dropped:0 overruns:0 frame:0<br />
TX packets:7 errors:0 dropped:0 overruns:0 carrier:0<br />
collisions:0 txqueuelen:1000<br />
RX bytes:230 (230.0 B) TX bytes:592 (592.0 B)<br />
<br />
lo Link encap:Local Loopback<br />
<br />
inet addr:127.0.0.1 Mask:255.0.0.0<br />
inet6 addr: ::1/128 Scope:Host<br />
UP LOOPBACK RUNNING MTU:16436 Metric:1<br />
RX packets:0 errors:0 dropped:0 overruns:0 frame:0<br />
TX packets:0 errors:0 dropped:0 overruns:0 carrier:0<br />
collisions:0 txqueuelen:0<br />
RX bytes:0 (0.0 B) TX bytes:0 (0.0 B)<br />
<br />
root@pisces:~# cat /proc/asound/cards<br />
0 [ALSA ]: BRCM bcm2835 ALSbcm2835 ALSA - bcm2835 ALSA<br />
bcm2835 ALSA<br />
<br />
1 [External ]: USB-Audio - SB Live! 24-bit External<br />
Creative Technology SB Live! 24-bit External at usb-bcm2708_usb-1.2.2, full spe<br />
<br />
<br />
<br />
<br />
It's running at 855MHz with this config.txt file. <br />
root@pisces:~# cat /boot/config.txt<br />
<br />
over_voltage=6<br />
<br />
arm_freq=855<br />
<br />
core_freq=500<br />
<br />
sdram_freq=500<br />
<br />
<br />
root@pisces:~# cat /etc/network/interfaces<br />
<br />
Used by ifup(8) and ifdown(8). See the interfaces(5) manpage or<br />
/usr/share/doc/ifupdown/examples for more information. <br />
<br />
auto lo<br />
<br />
<br />
iface lo inet loopback<br />
<br />
<br />
File: ifcfg-eth0<br />
<br />
auto eth0<br />
<br />
iface eth0 inet static<br />
<br />
address 192.168.10.31<br />
<br />
netmask 255.255.255.0<br />
<br />
gateway 192.168.10.103<br />
<br />
<br />
auto eth1<br />
<br />
iface eth1 inet static<br />
<br />
address 192.168.2.199<br />
<br />
netmask 255.255.255.0<br />
<br />
<br />
root@pisces:~# cat /etc/modules<br />
<br />
/etc/modules: kernel modules to load at boot time.<br />
This file contains the names of kernel modules that should be loaded<br />
at boot time, one per line. Lines beginning with "#" are ignored.<br />
Parameters can be specified after the module name. <br />
<br />
loop<br />
<br />
snd-bcm2835<br />
<br />
<br />
One problem remains, no sound from the on-board chip.<br />
<br />
==VIRTUALBOX==<br />
<br />
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". Basically, all you need to do is follow the instructions below, plug your 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, 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.<br />
<br />
The [[Dspserver.conf]] file needs to be edited, and you will need to run the dspserver once within a terminal to get the instructions on setting up an SSL key pair. To do that, download the [http://people.wallawalla.edu/~Rob.Frohne/ghpsdr3-alex/Ubuntu%2012.10%20ghpsdr3-alex-hermes.zip VirtualBox image], start [https://www.virtualbox.org/ VirtualBox], select new for the new machine, and when it asks you about the hard drive, say use existing hard drive, and select the image you just downloaded as the hard drive. After it boots up, you need to start a terminal (see the launcher bar on the left) and using it, start dspserver.<br />
$ dspserver<br />
Reading conf file /home/frohro/dspserver.conf<br />
Country Lookup is On<br />
gHPSDR rx 0 (Version 0.7)<br />
dspserver string: 20130609;-master<br />
getSoundcardId: HPSDR id=8<br />
setSoundcard: 8<br />
setSoundcard -41.000000 -48.000000<br />
etup sdr thread 0: done<br />
setup sdr thread 1: done<br />
setup sdr thread 2: done<br />
client_thread<br />
[2013-08-26 10:15:12] client_thread: listening on port 8000<br />
Couldn't read 'pkey' or 'cert' file. To generate a key<br />
and self-signed certificate, run:<br />
openssl genrsa -out pkey 2048<br />
openssl req -new -key pkey -out cert.req<br />
openssl x509 -req -days 365 -in cert.req -signkey pkey -out cert<br />
client ctx init failed: No such file or directory<br />
<br />
<br />
Note the message about the SSL keys ("Couldn't read 'pkey' or 'cert' file.") not being set up. This is a process you do once. The three commands to set up the SSL keys are just what the dspserver response above told you to do. <br />
openssl genrsa -out pkey 2048<br />
<br />
openssl req -new -key pkey -out cert.req<br />
<br />
openssl x509 -req -days 365 -in cert.req -signkey pkey -out cert<br />
After generating the keys, you should be able to log out and log back in and your server should be running, if all is well. You should then be able to connect with QtRadio or glSDR. Be sure to set the server IP address in the client (QtRadio, or glSDR). <br />
<br />
If you want to change 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.<br />
<br />
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. As always, there is a trade off between ease of use, and security.<br />
<br />
== SOFTWARE == <br />
***** START AT THE BEGINNING WHEN BUILDING THE SOFTWARE -- i.e Section 1 and install all the packages recommended and do the pulseaudio setup.<br />
<br />
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.<br />
<br />
Subject: [n2adr-sdr] Raspberry Pi running ghpsdr3-alex<br />
<br />
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.<br />
<br />
<br />
autoreconf -i <br />
<br />
./configure CFLAGS='-O3 -pipe -march=armv6 -mfpu=vfp -mfloat-abi=hard' CXXFLAGS='-O3 -pipe -march=armv6 -mfpu=vfp -mfloat-abi=hard' <br />
<br />
**** Additional steps needed when building rtlsdr-server. Do these before running make ******<br />
# export ac_cv_func_malloc_0_nonnull=yes<br />
# export ac_cv_func_realloc_0_nonnull=yes<br />
<br />
<br />
make all && make all install <br />
<br />
<br />
Sound on the Raspberry Pi is still a problem I have not been able to solve.<br />
<br />
Terry (WB4JFI) suggested the following that work for him but I have had no luck with it.<br />
<br />
"amixer cset numid=3 1"<br />
<br />
Other valid numid's are 0=auto, 1=headphones and 2=hdmi.<br />
<br />
<br />
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.<br />
<br />
When a slave connected and tried changing frequency, dspserver crashed - dspserver can be a bit crash happy.<br />
<br />
The first thing I tried on the Pi was QtRadio standalone, spectrum and waterfall were OK but no sound.<br />
<br />
Just now a client using glSDR (5) is attempting to change frequency, sound went quite distorted then dspserver crashed.<br />
<br />
Restarted dspserver and QtRadio sound started very distorted before it settled down to reasonable.</div>Frohrohttps://napan.ca/ghpsdr3/index.php?title=QtRadio_Installation&diff=759QtRadio Installation2013-08-26T19:31:01Z<p>Frohro: /* VIRTUALBOX */</p>
<hr />
<div>== Installation on Linux ==<br />
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.<br />
<br />
<br />
<br />
<br />
=== Installation from Git ===<br />
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.<br />
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.<br />
<br />
==== Installing compiler and autotool ====<br />
<br />
First off, install the compiler; depending on which distribution are you using, some or all of this stuff could be already installed: <br />
<br />
===== Ubuntu/Debian =====<br />
<pre><br />
sudo apt-get install make gcc g++<br />
sudo apt-get install autoconf automake autotools-dev libtool git subversion<br />
</pre><br />
<br />
===== Fedora =====<br />
<pre><br />
sudo yum install gcc gcc-c++ man-pages autoconf automake subversion libtool git<br />
</pre><br />
<br />
==== Installing prerequisite packages ====<br />
<br />
===== Ubuntu 12.04 and newer =====<br />
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:<br />
<br />
<pre><br />
sudo apt-get update<br />
sudo apt-get install \<br />
libqt4-opengl-dev \<br />
qtmobility-dev \<br />
libusb-0.1-4 \<br />
libusb-dev \<br />
libfftw3-dev \<br />
portaudio19-dev \<br />
libpulse-dev \<br />
libsamplerate0-dev \<br />
libusb-1.0-0-dev \<br />
libconfig8-dev \<br />
xdg-utils \<br />
libortp-dev \<br />
gcc-multilib \<br />
libssl-dev \<br />
libevent-dev \<br />
libglu1-mesa-dev \<br />
freeglut3-dev<br />
</pre><br />
<br />
You will need qt5 installed to complete the build.<br />
<br />
Visit: http://qt-project.org/downloads<br />
<br />
download the current package for your system.<br />
<br />
To build Qt5 on a RaspberryPi visit: http://qt-project.org/wiki/RaspberryPi<br />
<br />
After downloading it go to the download directory and do:<br />
<pre><br />
$ chmod +x the-name-of-the-downloaded-file<br />
$ sudo ./the-name-of-the-downloaded-file<br />
</pre><br />
<br />
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:<br />
<pre><br />
$ export PATH=/opt/Qt5.1.0/5.1.0/gcc_64/bin:/opt/Qt5.1.0/Tools/QtCreator/bin:$PATH<br />
</pre><br />
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.<br />
In any case please remember that<br />
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<br />
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.<br />
For the bash it is typically ~/.bashrc<br />
In any case, after you issue the export, please test it.<br />
<pre><br />
qmake -v<br />
QMake version 2.01a<br />
Using Qt version 4.8.0 in /home/andrew/QtSDK4.8x/Desktop/Qt/4.8.0/gcc/lib<br />
</pre><br />
<br />
===== Ubuntu 11.04 and older ===== <br />
First of all, you have to check that the ''universe repository'' is enabled.<br />
Please see the procedure in the previous section [[#graphical installation]] .<br />
<br />
Next, you will need the following packages installed:<br />
<br />
<pre><br />
sudo apt-get update<br />
sudo apt-get install \<br />
libqt4-opengl-dev \<br />
qtmobility-dev \<br />
libusb-0.1-4 \<br />
libusb-dev \<br />
libfftw3-dev \<br />
portaudio19-dev \<br />
libpulse-dev \<br />
libsamplerate0-dev \<br />
libusb-1.0-0-dev \<br />
libconfig8-dev \<br />
libortp-dev<br />
</pre><br />
<br />
===== Ubuntu 11.10 ===== <br />
First of all, you have to check that the ''universe repository'' is enabled.<br />
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.<br />
Next, submit the following commands into a terminal window:<br />
<br />
<pre><br />
sudo apt-get update<br />
sudo apt-get install \<br />
libqt4-opengl-dev \<br />
qtmobility-dev \<br />
libusb-0.1-4 \<br />
libusb-dev \<br />
libfftw3-dev \<br />
portaudio19-dev \<br />
libpulse-dev \<br />
libsamplerate0-dev \<br />
libusb-1.0-0-dev \<br />
libconfig8-dev \<br />
xdg-utils \<br />
libortp-dev<br />
</pre><br />
<br />
===== Fedora 16 =====<br />
<br />
<pre><br />
sudo yum install fftw fftw-devel <br />
sudo yum install libusb-devel libusb1-devel <br />
sudo yum install portaudio-devel<br />
sudo yum install libconfig-devel<br />
sudo yum install libsamplerate-devel<br />
sudo yum install pulseaudio-libs-devel<br />
sudo yum install jack-audio-connection-kit jack-audio-connection-kit-devel<br />
sudo yum install qt4-devel<br />
</pre><br />
<br />
<br />
==== Cloning the repository ====<br />
<br />
How to build the latest master branch on Ubuntu 11.04<br />
<br />
First a new libevent will need to be downloaded and installed, then the actual QtRadio source can be downloaded and built.<br />
<br />
==== Obtaining an up-level libevent library ====<br />
<br />
$ sudo apt-get install libevent-dev<br />
<br />
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)<br />
<br />
Then download the new version from:<br />
<br />
http://libevent.org/<br />
<br />
libevent-2.0.16-stable.tar.gz<br />
<br />
<pre><br />
wget https://github.com/downloads/libevent/libevent/libevent-2.0.16-stable.tar.gz<br />
</pre><br />
<br />
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:<br />
<br />
<pre><br />
cd<br />
tar -zxvf libevent-2.0.16-stable.tar.gz<br />
cd libevent-2.0.16-stable<br />
./configure<br />
make<br />
sudo make install<br />
sudo ldconfig<br />
</pre><br />
<br />
On Fedora, in order to use the library above, export the LD_LIBRARY_PATH:<br />
<br />
<pre><br />
export LD_LIBRARY_PATH=/usr/local/lib<br />
</pre><br />
<br />
==== Installing codec2 low bit rate audio encoding and decoding ====<br />
<br />
We are adding a low bit rate audio codec called codec 2 to QtRadio/dspserver. You need<br />
to download and build the codec2 library. See:<br />
<br />
http://www.rowetel.com/blog/?page_id=452<br />
<p><br />
Now go get codec2 using subversion<br />
<br />
<pre><br />
cd<br />
svn co https://freetel.svn.sourceforge.net/svnroot/freetel/codec2-dev codec2-dev<br />
cd codec2-dev<br />
autoreconf -i<br />
./configure<br />
make<br />
sudo make install<br />
sudo ldconfig<br />
</pre><br />
<br />
On Fedora, in order to use the library above, export the LD_LIBRARY_PATH:<br />
<br />
<pre><br />
export LD_LIBRARY_PATH=/usr/local/lib<br />
</pre><br />
<br />
==== Building the master branch ====<br />
<br />
This branch is the latest code that contains both RX and TX capability. <br />
<br />
Create a new directory or cd to the ~/src directory created for libevent and cd into it.<br />
<br />
<pre><br />
git clone git://github.com/alexlee188/ghpsdr3-alex<br />
</pre><br />
<br />
Depending on your Internet connection thorughput, it will take several minute to download.<br />
cd into the new directory ghpsdr3-alex:<br />
<pre><br />
cd ghpsdr3-alex<br />
git checkout master<br />
</pre><br />
You are now working with Alex's latest and greatest!<br />
<br />
First set the path to the version of qt you are using. E.g. for qt5:<br />
<pre><br />
$ export PATH=/opt/qt5/bin:$PATH<br />
</pre><br />
<br />
Then:<br />
<pre><br />
autoreconf -i<br />
./configure<br />
make -j4 all<br />
sudo make install<br />
</pre><br />
The default configure above builds with debug and default Qt4 version in your PC. For optimized executable,<br />
you need to specify options specific to your system. See the sample shell scripts that replaces the above<br />
./configure step:<br />
<br />
<pre><br />
./alex-avx-conf.sh for building with i3,i5 and i7 cpu's supporting Advanced Vector Extensions (AVX)<br />
./alex-openmp-conf.sh for building with i3,i5 and i7 cpu's and OpenMP support<br />
./alex-sse3-conf.sh for building with SSE3 capable cpu's<br />
./alex-openmp-sse3-conf.sh for building with SSE3 cpaable cpu's and OpenMP support<br />
</pre><br />
<br />
(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)<br />
<pre><br />
Terminal 1<br />
$ cd ghpsdr3-alex/trunk/src/softrock<br />
$ ./softrock ...options ...<br />
<br />
Terminal 2<br />
$ cd ghpsdr3-alex/trunk/src/dspserver<br />
$ ./dspserver ..options...<br />
<br />
Terminal 3<br />
$ cd ghpsdr3-alex/trunk/src/QtRadio<br />
$ ./QtRadio<br />
</pre><br />
<br />
==== Building the Perseus extensions ====<br />
<br />
In order to build the Microtelecom Perseus server you need to switch to the master or iw0hdv branch. <br />
<br />
First off, install the prerequisite library and wget package:<br />
<br />
<pre><br />
sudo apt-get install libboost-all-dev wget<br />
</pre><br />
<br />
Next download, compile and install the library libperseus-sdr:<br />
<br />
<pre><br />
cd<br />
wget http://libperseus-sdr.googlecode.com/files/libperseus_sdr-0.6.tar.gz<br />
tar -zxvf libperseus_sdr-0.6.tar.gz<br />
cd libperseus_sdr-0.6/<br />
./configure && make<br />
sudo make install<br />
sudo ldconfig<br />
</pre><br />
<br />
<br />
If you already build in your sandbox some other branch, is strongly advisable, before you start the build, to do a full cleanup:<br />
<pre><br />
cd ~/ghpsdr3-alex<br />
make distcheck && sh cleanup.sh<br />
</pre><br />
<br />
Otherwise, if you are starting from scratch, you have to clone the repository:<br />
<br />
<pre><br />
git clone git://github.com/alexlee188/ghpsdr3-alex<br />
</pre><br />
<br />
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.<br />
<br />
<pre><br />
cd ~/ghpsdr3-alex<br />
git checkout master<br />
autoreconf -i && ./configure && make -j4<br />
sudo make install<br />
</pre><br />
<br />
In order to run it you have two choices, the first one being the plain command line:<br />
<br />
<pre><br />
xterm -e 'perseus_server -d3 -s96000 ' &<br />
sleep 3<br />
xterm -e 'dspserver --lo 0 --nocorrectiq' &<br />
sleep 5<br />
$( QtRadio 127.0.0.1 ) <br />
</pre><br />
<br />
In QtRadio, Receiver menu, select Configure item, Server tab: here add the local host using the 127.0.0.1 IP address.<br />
Pressing the key C, you start the receiver.<br />
<br />
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.<br />
<br />
==== Building USRP enabled version ====<br />
<br />
===== Building the UHD package =====<br />
<br />
<br />
====== Install the prerequisite packages (Ubuntu 11.10): ======<br />
<br />
<pre><br />
sudo apt-get install liboost-all-dev<br />
sudo apt-get install python-cheetah<br />
</pre><br />
<br />
====== Build & Install UHD -- FOR UHD-3.3.1 AND GREATER --: ======<br />
<br />
<pre><br />
cd<br />
git clone git://ettus.sourcerepo.com/ettus/uhd.git<br />
cd uhd/host/<br />
mkdir build<br />
cd build<br />
cmake ../<br />
make<br />
make test<br />
sudo make install<br />
sudo ldconfig<br />
</pre><br />
<br />
If you already build in your sandbox some other branch, is strongly advisable, before you start the build, to do a full cleanup:<br />
<pre><br />
cd ~/ghpsdr3-alex<br />
make distcheck && sh cleanup.sh<br />
</pre><br />
<br />
Otherwise, if you are starting from scratch, first clone the repository:<br />
<br />
<pre><br />
git clone git://github.com/alexlee188/ghpsdr3-alex<br />
</pre><br />
<br />
Finally, you can switch to the master branch and rebuild everything, enabling the usrp server feature:<br />
<pre><br />
cd ~/ghpsdr3-alex<br />
git checkout usrp-server<br />
autoreconf -i && ./configure --enable-usrp=yes && make -j4<br />
sudo make install<br />
</pre><br />
<br />
==== Refresh to a Newer Version ====<br />
<br />
To pull a new version to build <br />
<pre><br />
$ git pull<br />
$ make -j4 all<br />
$ sudo make install<br />
</pre><br />
If extensive changes have occurred or if you get errors during the make, you may want to do a clean build <br />
<pre><br />
$ git pull<br />
$ make distclean<br />
$ sh cleanup.sh<br />
$ autoreconf -i<br />
$ ./configure<br />
$ make -j4 all<br />
$ sudo make install<br />
</pre><br />
If you continue to get errors, please report the whole ./configure output and the config.log to the mailing list.<br />
<br />
== Installation on Windows ==<br />
See [[ QtRadio on Windows]]<br />
<br />
== Network settings ==<br />
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.<br />
<br />
<br />
<br />
<br />
== Installing ghpsdr3-alex on Raspberry Pi == <br />
<br />
<br />
========== HARDWARE ==========<br />
<br />
*** THIS SECTION DEALS WITH Raspberry Pi DIFFERENCES *** IT DOES NOT CIRCUMVENT THE INSTRUCTIONS STARTING AT STEP 1 OF THE QtRadio Installation. ***<br />
<br />
I recommend installing either the raspbian or raspbian pisces (debian) distributions as there is no Ubuntu release to date.<br />
<br />
*** 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 <br />
document from the beginning after installing raspbian or raspbian pisces.<br />
<br />
<br />
The RasPi USB subsystem is sensitive to power supply voltage levels - A supply of 5.5V at 2A is recommended. <br />
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. <br />
<br />
Measuring the voltage across TP1 and TP2 on the Raspberry Pi and increased it to +4.97V (P.S output +5.59V).<br />
<br />
I also ran "rpi-update" which install new firmware. <br />
<br />
I shorted out the polyfuses F1 and F2 on the Pi and USB is much more stable but still limited.<br />
<br />
With keyboard, mouse, gigabit USB Ethernet, SB Live! 24 USB and RTL-SDR dongle it runs for some hours before it freezes.<br />
<br />
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.<br />
<br />
root@pisces:/usr/src/GHPSDR3_HIGH_SPEED_MASTER/ghpsdr3-alex# date<br />
<br />
Sun Sep 9 13:00:49 BST 2012<br />
<br />
root@pisces:/usr/src/GHPSDR3_HIGH_SPEED_MASTER/ghpsdr3-alex# uptime<br />
<br />
13:00:56 up 2 days, 20:46, 8 users, load average: 0.81, 1.01, 0.67<br />
<br />
<br />
<br />
<br />
****** Do not use power from a USB PC port or from a USB Hub. ********<br />
<br />
<br />
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):-<br />
<br />
Keyboard, mouse, usb sound card, RTL-SDR TV dongle and USB Gigabit Ethernet fully operational using the 7-port powered USB hub.<br />
<br />
root@pisces:~# lsusb<br />
<br />
Bus 001 Device 001: ID 1d6b:0002 Linux Foundation 2.0 root hub<br />
<br />
Bus 001 Device 002: ID 0424:9512 Standard Microsystems Corp. <br />
<br />
Bus 001 Device 003: ID 0424:ec00 Standard Microsystems Corp.<br />
<br />
Bus 001 Device 004: ID 04cc:1521 ST-Ericsson USB 2.0 Hub<br />
<br />
Bus 001 Device 011: ID 04f3:0103 Elan Microelectronics Corp. <br />
<br />
Bus 001 Device 006: ID 047d:1022 Kensington Orbit Optical<br />
<br />
Bus 001 Device 007: ID 1d19:1101 Dexatek Technology Ltd. DK DVB-T Dongle<br />
<br />
Bus 001 Device 008: ID 041e:3040 Creative Technology, Ltd SoundBlaster Live! 24-bit External SB0490<br />
<br />
Bus 001 Device 009: ID 0b95:1780 ASIX Electronics Corp. AX88178<br />
root@pisces:~# ifconfig <br />
<br />
eth0 Link encap:Ethernet HWaddr b8:27:eb:2c:07:c9<br />
<br />
inet addr:192.168.10.31 Bcast:192.168.10.255 Mask:255.255.255.0<br />
inet6 addr: fe80::ba27:ebff:fe2c:7c9/64 Scope:Link<br />
UP BROADCAST RUNNING MULTICAST MTU:1500 Metric:1<br />
RX packets:410 errors:0 dropped:0 overruns:0 frame:0<br />
TX packets:377 errors:0 dropped:0 overruns:0 carrier:0<br />
collisions:0 txqueuelen:1000<br />
RX bytes:28905 (28.2 KiB) TX bytes:35938 (35.0 KiB)<br />
<br />
eth1 Link encap:Ethernet HWaddr 00:10:14:00:9f:fa<br />
<br />
inet addr:192.168.2.199 Bcast:192.168.2.255 Mask:255.255.255.0<br />
inet6 addr: fe80::210:14ff:fe00:9ffa/64 Scope:Link<br />
UP BROADCAST RUNNING MULTICAST MTU:1500 Metric:1<br />
RX packets:5 errors:0 dropped:0 overruns:0 frame:0<br />
TX packets:7 errors:0 dropped:0 overruns:0 carrier:0<br />
collisions:0 txqueuelen:1000<br />
RX bytes:230 (230.0 B) TX bytes:592 (592.0 B)<br />
<br />
lo Link encap:Local Loopback<br />
<br />
inet addr:127.0.0.1 Mask:255.0.0.0<br />
inet6 addr: ::1/128 Scope:Host<br />
UP LOOPBACK RUNNING MTU:16436 Metric:1<br />
RX packets:0 errors:0 dropped:0 overruns:0 frame:0<br />
TX packets:0 errors:0 dropped:0 overruns:0 carrier:0<br />
collisions:0 txqueuelen:0<br />
RX bytes:0 (0.0 B) TX bytes:0 (0.0 B)<br />
<br />
root@pisces:~# cat /proc/asound/cards<br />
0 [ALSA ]: BRCM bcm2835 ALSbcm2835 ALSA - bcm2835 ALSA<br />
bcm2835 ALSA<br />
<br />
1 [External ]: USB-Audio - SB Live! 24-bit External<br />
Creative Technology SB Live! 24-bit External at usb-bcm2708_usb-1.2.2, full spe<br />
<br />
<br />
<br />
<br />
It's running at 855MHz with this config.txt file. <br />
root@pisces:~# cat /boot/config.txt<br />
<br />
over_voltage=6<br />
<br />
arm_freq=855<br />
<br />
core_freq=500<br />
<br />
sdram_freq=500<br />
<br />
<br />
root@pisces:~# cat /etc/network/interfaces<br />
<br />
Used by ifup(8) and ifdown(8). See the interfaces(5) manpage or<br />
/usr/share/doc/ifupdown/examples for more information. <br />
<br />
auto lo<br />
<br />
<br />
iface lo inet loopback<br />
<br />
<br />
File: ifcfg-eth0<br />
<br />
auto eth0<br />
<br />
iface eth0 inet static<br />
<br />
address 192.168.10.31<br />
<br />
netmask 255.255.255.0<br />
<br />
gateway 192.168.10.103<br />
<br />
<br />
auto eth1<br />
<br />
iface eth1 inet static<br />
<br />
address 192.168.2.199<br />
<br />
netmask 255.255.255.0<br />
<br />
<br />
root@pisces:~# cat /etc/modules<br />
<br />
/etc/modules: kernel modules to load at boot time.<br />
This file contains the names of kernel modules that should be loaded<br />
at boot time, one per line. Lines beginning with "#" are ignored.<br />
Parameters can be specified after the module name. <br />
<br />
loop<br />
<br />
snd-bcm2835<br />
<br />
<br />
One problem remains, no sound from the on-board chip.<br />
<br />
==VIRTUALBOX==<br />
<br />
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". Basically, all you need to do is follow the instructions below, plug your Hermes, ANAN-10D or ANAN-100D 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, 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.<br />
<br />
The [[Dspserver.conf]] file needs to be edited, and you will need to run the dspserver once within a terminal to get the instructions on setting up an SSL key pair. To do that, download the [http://people.wallawalla.edu/~Rob.Frohne/ghpsdr3-alex/Ubuntu%2012.10%20ghpsdr3-alex-hermes.zip VirtualBox image], start [https://www.virtualbox.org/ VirtualBox], select new for the new machine, and when it asks you about the hard drive, say use existing hard drive, and select the image you just downloaded as the hard drive. After it boots up, you need to start a terminal (see the launcher bar on the left) and using it, start dspserver.<br />
$ dspserver<br />
Reading conf file /home/frohro/dspserver.conf<br />
Country Lookup is On<br />
gHPSDR rx 0 (Version 0.7)<br />
dspserver string: 20130609;-master<br />
getSoundcardId: HPSDR id=8<br />
setSoundcard: 8<br />
setSoundcard -41.000000 -48.000000<br />
etup sdr thread 0: done<br />
setup sdr thread 1: done<br />
setup sdr thread 2: done<br />
client_thread<br />
[2013-08-26 10:15:12] client_thread: listening on port 8000<br />
Couldn't read 'pkey' or 'cert' file. To generate a key<br />
and self-signed certificate, run:<br />
openssl genrsa -out pkey 2048<br />
openssl req -new -key pkey -out cert.req<br />
openssl x509 -req -days 365 -in cert.req -signkey pkey -out cert<br />
client ctx init failed: No such file or directory<br />
<br />
<br />
Note the message about the SSL keys ("Couldn't read 'pkey' or 'cert' file.") not being set up. This is a process you do once. The three commands to set up the SSL keys are just what the dspserver response above told you to do. <br />
openssl genrsa -out pkey 2048<br />
<br />
openssl req -new -key pkey -out cert.req<br />
<br />
openssl x509 -req -days 365 -in cert.req -signkey pkey -out cert<br />
After generating the keys, you should be able to log out and log back in and your server should be running, if all is well. You should then be able to connect with QtRadio or glSDR. Be sure to set the server IP address in the client (QtRadio, or glSDR). <br />
<br />
If you want to change 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.<br />
<br />
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. As always, there is a trade off between ease of use, and security.<br />
<br />
== SOFTWARE == <br />
***** START AT THE BEGINNING WHEN BUILDING THE SOFTWARE -- i.e Section 1 and install all the packages recommended and do the pulseaudio setup.<br />
<br />
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.<br />
<br />
Subject: [n2adr-sdr] Raspberry Pi running ghpsdr3-alex<br />
<br />
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.<br />
<br />
<br />
autoreconf -i <br />
<br />
./configure CFLAGS='-O3 -pipe -march=armv6 -mfpu=vfp -mfloat-abi=hard' CXXFLAGS='-O3 -pipe -march=armv6 -mfpu=vfp -mfloat-abi=hard' <br />
<br />
**** Additional steps needed when building rtlsdr-server. Do these before running make ******<br />
# export ac_cv_func_malloc_0_nonnull=yes<br />
# export ac_cv_func_realloc_0_nonnull=yes<br />
<br />
<br />
make all && make all install <br />
<br />
<br />
Sound on the Raspberry Pi is still a problem I have not been able to solve.<br />
<br />
Terry (WB4JFI) suggested the following that work for him but I have had no luck with it.<br />
<br />
"amixer cset numid=3 1"<br />
<br />
Other valid numid's are 0=auto, 1=headphones and 2=hdmi.<br />
<br />
<br />
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.<br />
<br />
When a slave connected and tried changing frequency, dspserver crashed - dspserver can be a bit crash happy.<br />
<br />
The first thing I tried on the Pi was QtRadio standalone, spectrum and waterfall were OK but no sound.<br />
<br />
Just now a client using glSDR (5) is attempting to change frequency, sound went quite distorted then dspserver crashed.<br />
<br />
Restarted dspserver and QtRadio sound started very distorted before it settled down to reasonable.</div>Frohrohttps://napan.ca/ghpsdr3/index.php?title=QtRadio_Installation&diff=758QtRadio Installation2013-08-26T17:45:43Z<p>Frohro: /* VIRTUALBOX */</p>
<hr />
<div>== Installation on Linux ==<br />
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.<br />
<br />
<br />
<br />
<br />
=== Installation from Git ===<br />
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.<br />
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.<br />
<br />
==== Installing compiler and autotool ====<br />
<br />
First off, install the compiler; depending on which distribution are you using, some or all of this stuff could be already installed: <br />
<br />
===== Ubuntu/Debian =====<br />
<pre><br />
sudo apt-get install make gcc g++<br />
sudo apt-get install autoconf automake autotools-dev libtool git subversion<br />
</pre><br />
<br />
===== Fedora =====<br />
<pre><br />
sudo yum install gcc gcc-c++ man-pages autoconf automake subversion libtool git<br />
</pre><br />
<br />
==== Installing prerequisite packages ====<br />
<br />
===== Ubuntu 12.04 and newer =====<br />
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:<br />
<br />
<pre><br />
sudo apt-get update<br />
sudo apt-get install \<br />
libqt4-opengl-dev \<br />
qtmobility-dev \<br />
libusb-0.1-4 \<br />
libusb-dev \<br />
libfftw3-dev \<br />
portaudio19-dev \<br />
libpulse-dev \<br />
libsamplerate0-dev \<br />
libusb-1.0-0-dev \<br />
libconfig8-dev \<br />
xdg-utils \<br />
libortp-dev \<br />
gcc-multilib \<br />
libssl-dev \<br />
libevent-dev \<br />
libglu1-mesa-dev \<br />
freeglut3-dev<br />
</pre><br />
<br />
You will need qt5 installed to complete the build.<br />
<br />
Visit: http://qt-project.org/downloads<br />
<br />
download the current package for your system.<br />
<br />
To build Qt5 on a RaspberryPi visit: http://qt-project.org/wiki/RaspberryPi<br />
<br />
After downloading it go to the download directory and do:<br />
<pre><br />
$ chmod +x the-name-of-the-downloaded-file<br />
$ sudo ./the-name-of-the-downloaded-file<br />
</pre><br />
<br />
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:<br />
<pre><br />
$ export PATH=/opt/Qt5.1.0/5.1.0/gcc_64/bin:/opt/Qt5.1.0/Tools/QtCreator/bin:$PATH<br />
</pre><br />
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.<br />
In any case please remember that<br />
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<br />
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.<br />
For the bash it is typically ~/.bashrc<br />
In any case, after you issue the export, please test it.<br />
<pre><br />
qmake -v<br />
QMake version 2.01a<br />
Using Qt version 4.8.0 in /home/andrew/QtSDK4.8x/Desktop/Qt/4.8.0/gcc/lib<br />
</pre><br />
<br />
===== Ubuntu 11.04 and older ===== <br />
First of all, you have to check that the ''universe repository'' is enabled.<br />
Please see the procedure in the previous section [[#graphical installation]] .<br />
<br />
Next, you will need the following packages installed:<br />
<br />
<pre><br />
sudo apt-get update<br />
sudo apt-get install \<br />
libqt4-opengl-dev \<br />
qtmobility-dev \<br />
libusb-0.1-4 \<br />
libusb-dev \<br />
libfftw3-dev \<br />
portaudio19-dev \<br />
libpulse-dev \<br />
libsamplerate0-dev \<br />
libusb-1.0-0-dev \<br />
libconfig8-dev \<br />
libortp-dev<br />
</pre><br />
<br />
===== Ubuntu 11.10 ===== <br />
First of all, you have to check that the ''universe repository'' is enabled.<br />
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.<br />
Next, submit the following commands into a terminal window:<br />
<br />
<pre><br />
sudo apt-get update<br />
sudo apt-get install \<br />
libqt4-opengl-dev \<br />
qtmobility-dev \<br />
libusb-0.1-4 \<br />
libusb-dev \<br />
libfftw3-dev \<br />
portaudio19-dev \<br />
libpulse-dev \<br />
libsamplerate0-dev \<br />
libusb-1.0-0-dev \<br />
libconfig8-dev \<br />
xdg-utils \<br />
libortp-dev<br />
</pre><br />
<br />
===== Fedora 16 =====<br />
<br />
<pre><br />
sudo yum install fftw fftw-devel <br />
sudo yum install libusb-devel libusb1-devel <br />
sudo yum install portaudio-devel<br />
sudo yum install libconfig-devel<br />
sudo yum install libsamplerate-devel<br />
sudo yum install pulseaudio-libs-devel<br />
sudo yum install jack-audio-connection-kit jack-audio-connection-kit-devel<br />
sudo yum install qt4-devel<br />
</pre><br />
<br />
<br />
==== Cloning the repository ====<br />
<br />
How to build the latest master branch on Ubuntu 11.04<br />
<br />
First a new libevent will need to be downloaded and installed, then the actual QtRadio source can be downloaded and built.<br />
<br />
==== Obtaining an up-level libevent library ====<br />
<br />
$ sudo apt-get install libevent-dev<br />
<br />
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)<br />
<br />
Then download the new version from:<br />
<br />
http://libevent.org/<br />
<br />
libevent-2.0.16-stable.tar.gz<br />
<br />
<pre><br />
wget https://github.com/downloads/libevent/libevent/libevent-2.0.16-stable.tar.gz<br />
</pre><br />
<br />
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:<br />
<br />
<pre><br />
cd<br />
tar -zxvf libevent-2.0.16-stable.tar.gz<br />
cd libevent-2.0.16-stable<br />
./configure<br />
make<br />
sudo make install<br />
sudo ldconfig<br />
</pre><br />
<br />
On Fedora, in order to use the library above, export the LD_LIBRARY_PATH:<br />
<br />
<pre><br />
export LD_LIBRARY_PATH=/usr/local/lib<br />
</pre><br />
<br />
==== Installing codec2 low bit rate audio encoding and decoding ====<br />
<br />
We are adding a low bit rate audio codec called codec 2 to QtRadio/dspserver. You need<br />
to download and build the codec2 library. See:<br />
<br />
http://www.rowetel.com/blog/?page_id=452<br />
<p><br />
Now go get codec2 using subversion<br />
<br />
<pre><br />
cd<br />
svn co https://freetel.svn.sourceforge.net/svnroot/freetel/codec2-dev codec2-dev<br />
cd codec2-dev<br />
autoreconf -i<br />
./configure<br />
make<br />
sudo make install<br />
sudo ldconfig<br />
</pre><br />
<br />
On Fedora, in order to use the library above, export the LD_LIBRARY_PATH:<br />
<br />
<pre><br />
export LD_LIBRARY_PATH=/usr/local/lib<br />
</pre><br />
<br />
==== Building the master branch ====<br />
<br />
This branch is the latest code that contains both RX and TX capability. <br />
<br />
Create a new directory or cd to the ~/src directory created for libevent and cd into it.<br />
<br />
<pre><br />
git clone git://github.com/alexlee188/ghpsdr3-alex<br />
</pre><br />
<br />
Depending on your Internet connection thorughput, it will take several minute to download.<br />
cd into the new directory ghpsdr3-alex:<br />
<pre><br />
cd ghpsdr3-alex<br />
git checkout master<br />
</pre><br />
You are now working with Alex's latest and greatest!<br />
<br />
First set the path to the version of qt you are using. E.g. for qt5:<br />
<pre><br />
$ export PATH=/opt/qt5/bin:$PATH<br />
</pre><br />
<br />
Then:<br />
<pre><br />
autoreconf -i<br />
./configure<br />
make -j4 all<br />
sudo make install<br />
</pre><br />
The default configure above builds with debug and default Qt4 version in your PC. For optimized executable,<br />
you need to specify options specific to your system. See the sample shell scripts that replaces the above<br />
./configure step:<br />
<br />
<pre><br />
./alex-avx-conf.sh for building with i3,i5 and i7 cpu's supporting Advanced Vector Extensions (AVX)<br />
./alex-openmp-conf.sh for building with i3,i5 and i7 cpu's and OpenMP support<br />
./alex-sse3-conf.sh for building with SSE3 capable cpu's<br />
./alex-openmp-sse3-conf.sh for building with SSE3 cpaable cpu's and OpenMP support<br />
</pre><br />
<br />
(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)<br />
<pre><br />
Terminal 1<br />
$ cd ghpsdr3-alex/trunk/src/softrock<br />
$ ./softrock ...options ...<br />
<br />
Terminal 2<br />
$ cd ghpsdr3-alex/trunk/src/dspserver<br />
$ ./dspserver ..options...<br />
<br />
Terminal 3<br />
$ cd ghpsdr3-alex/trunk/src/QtRadio<br />
$ ./QtRadio<br />
</pre><br />
<br />
==== Building the Perseus extensions ====<br />
<br />
In order to build the Microtelecom Perseus server you need to switch to the master or iw0hdv branch. <br />
<br />
First off, install the prerequisite library and wget package:<br />
<br />
<pre><br />
sudo apt-get install libboost-all-dev wget<br />
</pre><br />
<br />
Next download, compile and install the library libperseus-sdr:<br />
<br />
<pre><br />
cd<br />
wget http://libperseus-sdr.googlecode.com/files/libperseus_sdr-0.6.tar.gz<br />
tar -zxvf libperseus_sdr-0.6.tar.gz<br />
cd libperseus_sdr-0.6/<br />
./configure && make<br />
sudo make install<br />
sudo ldconfig<br />
</pre><br />
<br />
<br />
If you already build in your sandbox some other branch, is strongly advisable, before you start the build, to do a full cleanup:<br />
<pre><br />
cd ~/ghpsdr3-alex<br />
make distcheck && sh cleanup.sh<br />
</pre><br />
<br />
Otherwise, if you are starting from scratch, you have to clone the repository:<br />
<br />
<pre><br />
git clone git://github.com/alexlee188/ghpsdr3-alex<br />
</pre><br />
<br />
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.<br />
<br />
<pre><br />
cd ~/ghpsdr3-alex<br />
git checkout master<br />
autoreconf -i && ./configure && make -j4<br />
sudo make install<br />
</pre><br />
<br />
In order to run it you have two choices, the first one being the plain command line:<br />
<br />
<pre><br />
xterm -e 'perseus_server -d3 -s96000 ' &<br />
sleep 3<br />
xterm -e 'dspserver --lo 0 --nocorrectiq' &<br />
sleep 5<br />
$( QtRadio 127.0.0.1 ) <br />
</pre><br />
<br />
In QtRadio, Receiver menu, select Configure item, Server tab: here add the local host using the 127.0.0.1 IP address.<br />
Pressing the key C, you start the receiver.<br />
<br />
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.<br />
<br />
==== Building USRP enabled version ====<br />
<br />
===== Building the UHD package =====<br />
<br />
<br />
====== Install the prerequisite packages (Ubuntu 11.10): ======<br />
<br />
<pre><br />
sudo apt-get install liboost-all-dev<br />
sudo apt-get install python-cheetah<br />
</pre><br />
<br />
====== Build & Install UHD -- FOR UHD-3.3.1 AND GREATER --: ======<br />
<br />
<pre><br />
cd<br />
git clone git://ettus.sourcerepo.com/ettus/uhd.git<br />
cd uhd/host/<br />
mkdir build<br />
cd build<br />
cmake ../<br />
make<br />
make test<br />
sudo make install<br />
sudo ldconfig<br />
</pre><br />
<br />
If you already build in your sandbox some other branch, is strongly advisable, before you start the build, to do a full cleanup:<br />
<pre><br />
cd ~/ghpsdr3-alex<br />
make distcheck && sh cleanup.sh<br />
</pre><br />
<br />
Otherwise, if you are starting from scratch, first clone the repository:<br />
<br />
<pre><br />
git clone git://github.com/alexlee188/ghpsdr3-alex<br />
</pre><br />
<br />
Finally, you can switch to the master branch and rebuild everything, enabling the usrp server feature:<br />
<pre><br />
cd ~/ghpsdr3-alex<br />
git checkout usrp-server<br />
autoreconf -i && ./configure --enable-usrp=yes && make -j4<br />
sudo make install<br />
</pre><br />
<br />
==== Refresh to a Newer Version ====<br />
<br />
To pull a new version to build <br />
<pre><br />
$ git pull<br />
$ make -j4 all<br />
$ sudo make install<br />
</pre><br />
If extensive changes have occurred or if you get errors during the make, you may want to do a clean build <br />
<pre><br />
$ git pull<br />
$ make distclean<br />
$ sh cleanup.sh<br />
$ autoreconf -i<br />
$ ./configure<br />
$ make -j4 all<br />
$ sudo make install<br />
</pre><br />
If you continue to get errors, please report the whole ./configure output and the config.log to the mailing list.<br />
<br />
== Installation on Windows ==<br />
See [[ QtRadio on Windows]]<br />
<br />
== Network settings ==<br />
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.<br />
<br />
<br />
<br />
<br />
== Installing ghpsdr3-alex on Raspberry Pi == <br />
<br />
<br />
========== HARDWARE ==========<br />
<br />
*** THIS SECTION DEALS WITH Raspberry Pi DIFFERENCES *** IT DOES NOT CIRCUMVENT THE INSTRUCTIONS STARTING AT STEP 1 OF THE QtRadio Installation. ***<br />
<br />
I recommend installing either the raspbian or raspbian pisces (debian) distributions as there is no Ubuntu release to date.<br />
<br />
*** 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 <br />
document from the beginning after installing raspbian or raspbian pisces.<br />
<br />
<br />
The RasPi USB subsystem is sensitive to power supply voltage levels - A supply of 5.5V at 2A is recommended. <br />
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. <br />
<br />
Measuring the voltage across TP1 and TP2 on the Raspberry Pi and increased it to +4.97V (P.S output +5.59V).<br />
<br />
I also ran "rpi-update" which install new firmware. <br />
<br />
I shorted out the polyfuses F1 and F2 on the Pi and USB is much more stable but still limited.<br />
<br />
With keyboard, mouse, gigabit USB Ethernet, SB Live! 24 USB and RTL-SDR dongle it runs for some hours before it freezes.<br />
<br />
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.<br />
<br />
root@pisces:/usr/src/GHPSDR3_HIGH_SPEED_MASTER/ghpsdr3-alex# date<br />
<br />
Sun Sep 9 13:00:49 BST 2012<br />
<br />
root@pisces:/usr/src/GHPSDR3_HIGH_SPEED_MASTER/ghpsdr3-alex# uptime<br />
<br />
13:00:56 up 2 days, 20:46, 8 users, load average: 0.81, 1.01, 0.67<br />
<br />
<br />
<br />
<br />
****** Do not use power from a USB PC port or from a USB Hub. ********<br />
<br />
<br />
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):-<br />
<br />
Keyboard, mouse, usb sound card, RTL-SDR TV dongle and USB Gigabit Ethernet fully operational using the 7-port powered USB hub.<br />
<br />
root@pisces:~# lsusb<br />
<br />
Bus 001 Device 001: ID 1d6b:0002 Linux Foundation 2.0 root hub<br />
<br />
Bus 001 Device 002: ID 0424:9512 Standard Microsystems Corp. <br />
<br />
Bus 001 Device 003: ID 0424:ec00 Standard Microsystems Corp.<br />
<br />
Bus 001 Device 004: ID 04cc:1521 ST-Ericsson USB 2.0 Hub<br />
<br />
Bus 001 Device 011: ID 04f3:0103 Elan Microelectronics Corp. <br />
<br />
Bus 001 Device 006: ID 047d:1022 Kensington Orbit Optical<br />
<br />
Bus 001 Device 007: ID 1d19:1101 Dexatek Technology Ltd. DK DVB-T Dongle<br />
<br />
Bus 001 Device 008: ID 041e:3040 Creative Technology, Ltd SoundBlaster Live! 24-bit External SB0490<br />
<br />
Bus 001 Device 009: ID 0b95:1780 ASIX Electronics Corp. AX88178<br />
root@pisces:~# ifconfig <br />
<br />
eth0 Link encap:Ethernet HWaddr b8:27:eb:2c:07:c9<br />
<br />
inet addr:192.168.10.31 Bcast:192.168.10.255 Mask:255.255.255.0<br />
inet6 addr: fe80::ba27:ebff:fe2c:7c9/64 Scope:Link<br />
UP BROADCAST RUNNING MULTICAST MTU:1500 Metric:1<br />
RX packets:410 errors:0 dropped:0 overruns:0 frame:0<br />
TX packets:377 errors:0 dropped:0 overruns:0 carrier:0<br />
collisions:0 txqueuelen:1000<br />
RX bytes:28905 (28.2 KiB) TX bytes:35938 (35.0 KiB)<br />
<br />
eth1 Link encap:Ethernet HWaddr 00:10:14:00:9f:fa<br />
<br />
inet addr:192.168.2.199 Bcast:192.168.2.255 Mask:255.255.255.0<br />
inet6 addr: fe80::210:14ff:fe00:9ffa/64 Scope:Link<br />
UP BROADCAST RUNNING MULTICAST MTU:1500 Metric:1<br />
RX packets:5 errors:0 dropped:0 overruns:0 frame:0<br />
TX packets:7 errors:0 dropped:0 overruns:0 carrier:0<br />
collisions:0 txqueuelen:1000<br />
RX bytes:230 (230.0 B) TX bytes:592 (592.0 B)<br />
<br />
lo Link encap:Local Loopback<br />
<br />
inet addr:127.0.0.1 Mask:255.0.0.0<br />
inet6 addr: ::1/128 Scope:Host<br />
UP LOOPBACK RUNNING MTU:16436 Metric:1<br />
RX packets:0 errors:0 dropped:0 overruns:0 frame:0<br />
TX packets:0 errors:0 dropped:0 overruns:0 carrier:0<br />
collisions:0 txqueuelen:0<br />
RX bytes:0 (0.0 B) TX bytes:0 (0.0 B)<br />
<br />
root@pisces:~# cat /proc/asound/cards<br />
0 [ALSA ]: BRCM bcm2835 ALSbcm2835 ALSA - bcm2835 ALSA<br />
bcm2835 ALSA<br />
<br />
1 [External ]: USB-Audio - SB Live! 24-bit External<br />
Creative Technology SB Live! 24-bit External at usb-bcm2708_usb-1.2.2, full spe<br />
<br />
<br />
<br />
<br />
It's running at 855MHz with this config.txt file. <br />
root@pisces:~# cat /boot/config.txt<br />
<br />
over_voltage=6<br />
<br />
arm_freq=855<br />
<br />
core_freq=500<br />
<br />
sdram_freq=500<br />
<br />
<br />
root@pisces:~# cat /etc/network/interfaces<br />
<br />
Used by ifup(8) and ifdown(8). See the interfaces(5) manpage or<br />
/usr/share/doc/ifupdown/examples for more information. <br />
<br />
auto lo<br />
<br />
<br />
iface lo inet loopback<br />
<br />
<br />
File: ifcfg-eth0<br />
<br />
auto eth0<br />
<br />
iface eth0 inet static<br />
<br />
address 192.168.10.31<br />
<br />
netmask 255.255.255.0<br />
<br />
gateway 192.168.10.103<br />
<br />
<br />
auto eth1<br />
<br />
iface eth1 inet static<br />
<br />
address 192.168.2.199<br />
<br />
netmask 255.255.255.0<br />
<br />
<br />
root@pisces:~# cat /etc/modules<br />
<br />
/etc/modules: kernel modules to load at boot time.<br />
This file contains the names of kernel modules that should be loaded<br />
at boot time, one per line. Lines beginning with "#" are ignored.<br />
Parameters can be specified after the module name. <br />
<br />
loop<br />
<br />
snd-bcm2835<br />
<br />
<br />
One problem remains, no sound from the on-board chip.<br />
<br />
==VIRTUALBOX==<br />
<br />
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. Basically, all you need to do is follow the instructions below, plug your Hermes, ANAN-10D or ANAN-100D 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, 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.<br />
<br />
The [[Dspserver.conf]] file needs to be edited, and you will need to run the dspserver once within a terminal to get the instructions on setting up an SSL key pair. To do that, download the [http://people.wallawalla.edu/~Rob.Frohne/ghpsdr3-alex/Ubuntu%2012.10%20ghpsdr3-alex-hermes.zip VirtualBox image], start [https://www.virtualbox.org/ VirtualBox], select new for the new machine, and when it asks you about the hard drive, say use existing hard drive, and select the image you just downloaded as the hard drive. After it boots up, you need to start a terminal (see the launcher bar on the left) and using it, start dspserver.<br />
$ dspserver<br />
Reading conf file /home/frohro/dspserver.conf<br />
Country Lookup is On<br />
gHPSDR rx 0 (Version 0.7)<br />
dspserver string: 20130609;-master<br />
getSoundcardId: HPSDR id=8<br />
setSoundcard: 8<br />
setSoundcard -41.000000 -48.000000<br />
etup sdr thread 0: done<br />
setup sdr thread 1: done<br />
setup sdr thread 2: done<br />
client_thread<br />
[2013-08-26 10:15:12] client_thread: listening on port 8000<br />
Couldn't read 'pkey' or 'cert' file. To generate a key<br />
and self-signed certificate, run:<br />
openssl genrsa -out pkey 2048<br />
openssl req -new -key pkey -out cert.req<br />
openssl x509 -req -days 365 -in cert.req -signkey pkey -out cert<br />
client ctx init failed: No such file or directory<br />
<br />
<br />
Note the message about the SSL keys ("Couldn't read 'pkey' or 'cert' file.") not being set up. This is a process you do once. The three commands to set up the SSL keys are just what the dspserver response above told you to do. <br />
openssl genrsa -out pkey 2048<br />
<br />
openssl req -new -key pkey -out cert.req<br />
<br />
openssl x509 -req -days 365 -in cert.req -signkey pkey -out cert<br />
After generating the keys, you should be able to log out and log back in and your server should be running, if all is well. You should then be able to connect with QtRadio or glSDR. Be sure to set the server IP address in the client (QtRadio, or glSDR). <br />
<br />
If you want to change 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.<br />
<br />
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. As always, there is a trade off between ease of use, and security.<br />
<br />
== SOFTWARE == <br />
***** START AT THE BEGINNING WHEN BUILDING THE SOFTWARE -- i.e Section 1 and install all the packages recommended and do the pulseaudio setup.<br />
<br />
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.<br />
<br />
Subject: [n2adr-sdr] Raspberry Pi running ghpsdr3-alex<br />
<br />
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.<br />
<br />
<br />
autoreconf -i <br />
<br />
./configure CFLAGS='-O3 -pipe -march=armv6 -mfpu=vfp -mfloat-abi=hard' CXXFLAGS='-O3 -pipe -march=armv6 -mfpu=vfp -mfloat-abi=hard' <br />
<br />
**** Additional steps needed when building rtlsdr-server. Do these before running make ******<br />
# export ac_cv_func_malloc_0_nonnull=yes<br />
# export ac_cv_func_realloc_0_nonnull=yes<br />
<br />
<br />
make all && make all install <br />
<br />
<br />
Sound on the Raspberry Pi is still a problem I have not been able to solve.<br />
<br />
Terry (WB4JFI) suggested the following that work for him but I have had no luck with it.<br />
<br />
"amixer cset numid=3 1"<br />
<br />
Other valid numid's are 0=auto, 1=headphones and 2=hdmi.<br />
<br />
<br />
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.<br />
<br />
When a slave connected and tried changing frequency, dspserver crashed - dspserver can be a bit crash happy.<br />
<br />
The first thing I tried on the Pi was QtRadio standalone, spectrum and waterfall were OK but no sound.<br />
<br />
Just now a client using glSDR (5) is attempting to change frequency, sound went quite distorted then dspserver crashed.<br />
<br />
Restarted dspserver and QtRadio sound started very distorted before it settled down to reasonable.</div>Frohrohttps://napan.ca/ghpsdr3/index.php?title=QtRadio_Installation&diff=757QtRadio Installation2013-08-26T17:29:57Z<p>Frohro: /* VIRTUALBOX */</p>
<hr />
<div>== Installation on Linux ==<br />
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.<br />
<br />
<br />
<br />
<br />
=== Installation from Git ===<br />
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.<br />
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.<br />
<br />
==== Installing compiler and autotool ====<br />
<br />
First off, install the compiler; depending on which distribution are you using, some or all of this stuff could be already installed: <br />
<br />
===== Ubuntu/Debian =====<br />
<pre><br />
sudo apt-get install make gcc g++<br />
sudo apt-get install autoconf automake autotools-dev libtool git subversion<br />
</pre><br />
<br />
===== Fedora =====<br />
<pre><br />
sudo yum install gcc gcc-c++ man-pages autoconf automake subversion libtool git<br />
</pre><br />
<br />
==== Installing prerequisite packages ====<br />
<br />
===== Ubuntu 12.04 and newer =====<br />
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:<br />
<br />
<pre><br />
sudo apt-get update<br />
sudo apt-get install \<br />
libqt4-opengl-dev \<br />
qtmobility-dev \<br />
libusb-0.1-4 \<br />
libusb-dev \<br />
libfftw3-dev \<br />
portaudio19-dev \<br />
libpulse-dev \<br />
libsamplerate0-dev \<br />
libusb-1.0-0-dev \<br />
libconfig8-dev \<br />
xdg-utils \<br />
libortp-dev \<br />
gcc-multilib \<br />
libssl-dev \<br />
libevent-dev \<br />
libglu1-mesa-dev \<br />
freeglut3-dev<br />
</pre><br />
<br />
You will need qt5 installed to complete the build.<br />
<br />
Visit: http://qt-project.org/downloads<br />
<br />
download the current package for your system.<br />
<br />
To build Qt5 on a RaspberryPi visit: http://qt-project.org/wiki/RaspberryPi<br />
<br />
After downloading it go to the download directory and do:<br />
<pre><br />
$ chmod +x the-name-of-the-downloaded-file<br />
$ sudo ./the-name-of-the-downloaded-file<br />
</pre><br />
<br />
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:<br />
<pre><br />
$ export PATH=/opt/Qt5.1.0/5.1.0/gcc_64/bin:/opt/Qt5.1.0/Tools/QtCreator/bin:$PATH<br />
</pre><br />
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.<br />
In any case please remember that<br />
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<br />
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.<br />
For the bash it is typically ~/.bashrc<br />
In any case, after you issue the export, please test it.<br />
<pre><br />
qmake -v<br />
QMake version 2.01a<br />
Using Qt version 4.8.0 in /home/andrew/QtSDK4.8x/Desktop/Qt/4.8.0/gcc/lib<br />
</pre><br />
<br />
===== Ubuntu 11.04 and older ===== <br />
First of all, you have to check that the ''universe repository'' is enabled.<br />
Please see the procedure in the previous section [[#graphical installation]] .<br />
<br />
Next, you will need the following packages installed:<br />
<br />
<pre><br />
sudo apt-get update<br />
sudo apt-get install \<br />
libqt4-opengl-dev \<br />
qtmobility-dev \<br />
libusb-0.1-4 \<br />
libusb-dev \<br />
libfftw3-dev \<br />
portaudio19-dev \<br />
libpulse-dev \<br />
libsamplerate0-dev \<br />
libusb-1.0-0-dev \<br />
libconfig8-dev \<br />
libortp-dev<br />
</pre><br />
<br />
===== Ubuntu 11.10 ===== <br />
First of all, you have to check that the ''universe repository'' is enabled.<br />
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.<br />
Next, submit the following commands into a terminal window:<br />
<br />
<pre><br />
sudo apt-get update<br />
sudo apt-get install \<br />
libqt4-opengl-dev \<br />
qtmobility-dev \<br />
libusb-0.1-4 \<br />
libusb-dev \<br />
libfftw3-dev \<br />
portaudio19-dev \<br />
libpulse-dev \<br />
libsamplerate0-dev \<br />
libusb-1.0-0-dev \<br />
libconfig8-dev \<br />
xdg-utils \<br />
libortp-dev<br />
</pre><br />
<br />
===== Fedora 16 =====<br />
<br />
<pre><br />
sudo yum install fftw fftw-devel <br />
sudo yum install libusb-devel libusb1-devel <br />
sudo yum install portaudio-devel<br />
sudo yum install libconfig-devel<br />
sudo yum install libsamplerate-devel<br />
sudo yum install pulseaudio-libs-devel<br />
sudo yum install jack-audio-connection-kit jack-audio-connection-kit-devel<br />
sudo yum install qt4-devel<br />
</pre><br />
<br />
<br />
==== Cloning the repository ====<br />
<br />
How to build the latest master branch on Ubuntu 11.04<br />
<br />
First a new libevent will need to be downloaded and installed, then the actual QtRadio source can be downloaded and built.<br />
<br />
==== Obtaining an up-level libevent library ====<br />
<br />
$ sudo apt-get install libevent-dev<br />
<br />
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)<br />
<br />
Then download the new version from:<br />
<br />
http://libevent.org/<br />
<br />
libevent-2.0.16-stable.tar.gz<br />
<br />
<pre><br />
wget https://github.com/downloads/libevent/libevent/libevent-2.0.16-stable.tar.gz<br />
</pre><br />
<br />
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:<br />
<br />
<pre><br />
cd<br />
tar -zxvf libevent-2.0.16-stable.tar.gz<br />
cd libevent-2.0.16-stable<br />
./configure<br />
make<br />
sudo make install<br />
sudo ldconfig<br />
</pre><br />
<br />
On Fedora, in order to use the library above, export the LD_LIBRARY_PATH:<br />
<br />
<pre><br />
export LD_LIBRARY_PATH=/usr/local/lib<br />
</pre><br />
<br />
==== Installing codec2 low bit rate audio encoding and decoding ====<br />
<br />
We are adding a low bit rate audio codec called codec 2 to QtRadio/dspserver. You need<br />
to download and build the codec2 library. See:<br />
<br />
http://www.rowetel.com/blog/?page_id=452<br />
<p><br />
Now go get codec2 using subversion<br />
<br />
<pre><br />
cd<br />
svn co https://freetel.svn.sourceforge.net/svnroot/freetel/codec2-dev codec2-dev<br />
cd codec2-dev<br />
autoreconf -i<br />
./configure<br />
make<br />
sudo make install<br />
sudo ldconfig<br />
</pre><br />
<br />
On Fedora, in order to use the library above, export the LD_LIBRARY_PATH:<br />
<br />
<pre><br />
export LD_LIBRARY_PATH=/usr/local/lib<br />
</pre><br />
<br />
==== Building the master branch ====<br />
<br />
This branch is the latest code that contains both RX and TX capability. <br />
<br />
Create a new directory or cd to the ~/src directory created for libevent and cd into it.<br />
<br />
<pre><br />
git clone git://github.com/alexlee188/ghpsdr3-alex<br />
</pre><br />
<br />
Depending on your Internet connection thorughput, it will take several minute to download.<br />
cd into the new directory ghpsdr3-alex:<br />
<pre><br />
cd ghpsdr3-alex<br />
git checkout master<br />
</pre><br />
You are now working with Alex's latest and greatest!<br />
<br />
First set the path to the version of qt you are using. E.g. for qt5:<br />
<pre><br />
$ export PATH=/opt/qt5/bin:$PATH<br />
</pre><br />
<br />
Then:<br />
<pre><br />
autoreconf -i<br />
./configure<br />
make -j4 all<br />
sudo make install<br />
</pre><br />
The default configure above builds with debug and default Qt4 version in your PC. For optimized executable,<br />
you need to specify options specific to your system. See the sample shell scripts that replaces the above<br />
./configure step:<br />
<br />
<pre><br />
./alex-avx-conf.sh for building with i3,i5 and i7 cpu's supporting Advanced Vector Extensions (AVX)<br />
./alex-openmp-conf.sh for building with i3,i5 and i7 cpu's and OpenMP support<br />
./alex-sse3-conf.sh for building with SSE3 capable cpu's<br />
./alex-openmp-sse3-conf.sh for building with SSE3 cpaable cpu's and OpenMP support<br />
</pre><br />
<br />
(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)<br />
<pre><br />
Terminal 1<br />
$ cd ghpsdr3-alex/trunk/src/softrock<br />
$ ./softrock ...options ...<br />
<br />
Terminal 2<br />
$ cd ghpsdr3-alex/trunk/src/dspserver<br />
$ ./dspserver ..options...<br />
<br />
Terminal 3<br />
$ cd ghpsdr3-alex/trunk/src/QtRadio<br />
$ ./QtRadio<br />
</pre><br />
<br />
==== Building the Perseus extensions ====<br />
<br />
In order to build the Microtelecom Perseus server you need to switch to the master or iw0hdv branch. <br />
<br />
First off, install the prerequisite library and wget package:<br />
<br />
<pre><br />
sudo apt-get install libboost-all-dev wget<br />
</pre><br />
<br />
Next download, compile and install the library libperseus-sdr:<br />
<br />
<pre><br />
cd<br />
wget http://libperseus-sdr.googlecode.com/files/libperseus_sdr-0.6.tar.gz<br />
tar -zxvf libperseus_sdr-0.6.tar.gz<br />
cd libperseus_sdr-0.6/<br />
./configure && make<br />
sudo make install<br />
sudo ldconfig<br />
</pre><br />
<br />
<br />
If you already build in your sandbox some other branch, is strongly advisable, before you start the build, to do a full cleanup:<br />
<pre><br />
cd ~/ghpsdr3-alex<br />
make distcheck && sh cleanup.sh<br />
</pre><br />
<br />
Otherwise, if you are starting from scratch, you have to clone the repository:<br />
<br />
<pre><br />
git clone git://github.com/alexlee188/ghpsdr3-alex<br />
</pre><br />
<br />
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.<br />
<br />
<pre><br />
cd ~/ghpsdr3-alex<br />
git checkout master<br />
autoreconf -i && ./configure && make -j4<br />
sudo make install<br />
</pre><br />
<br />
In order to run it you have two choices, the first one being the plain command line:<br />
<br />
<pre><br />
xterm -e 'perseus_server -d3 -s96000 ' &<br />
sleep 3<br />
xterm -e 'dspserver --lo 0 --nocorrectiq' &<br />
sleep 5<br />
$( QtRadio 127.0.0.1 ) <br />
</pre><br />
<br />
In QtRadio, Receiver menu, select Configure item, Server tab: here add the local host using the 127.0.0.1 IP address.<br />
Pressing the key C, you start the receiver.<br />
<br />
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.<br />
<br />
==== Building USRP enabled version ====<br />
<br />
===== Building the UHD package =====<br />
<br />
<br />
====== Install the prerequisite packages (Ubuntu 11.10): ======<br />
<br />
<pre><br />
sudo apt-get install liboost-all-dev<br />
sudo apt-get install python-cheetah<br />
</pre><br />
<br />
====== Build & Install UHD -- FOR UHD-3.3.1 AND GREATER --: ======<br />
<br />
<pre><br />
cd<br />
git clone git://ettus.sourcerepo.com/ettus/uhd.git<br />
cd uhd/host/<br />
mkdir build<br />
cd build<br />
cmake ../<br />
make<br />
make test<br />
sudo make install<br />
sudo ldconfig<br />
</pre><br />
<br />
If you already build in your sandbox some other branch, is strongly advisable, before you start the build, to do a full cleanup:<br />
<pre><br />
cd ~/ghpsdr3-alex<br />
make distcheck && sh cleanup.sh<br />
</pre><br />
<br />
Otherwise, if you are starting from scratch, first clone the repository:<br />
<br />
<pre><br />
git clone git://github.com/alexlee188/ghpsdr3-alex<br />
</pre><br />
<br />
Finally, you can switch to the master branch and rebuild everything, enabling the usrp server feature:<br />
<pre><br />
cd ~/ghpsdr3-alex<br />
git checkout usrp-server<br />
autoreconf -i && ./configure --enable-usrp=yes && make -j4<br />
sudo make install<br />
</pre><br />
<br />
==== Refresh to a Newer Version ====<br />
<br />
To pull a new version to build <br />
<pre><br />
$ git pull<br />
$ make -j4 all<br />
$ sudo make install<br />
</pre><br />
If extensive changes have occurred or if you get errors during the make, you may want to do a clean build <br />
<pre><br />
$ git pull<br />
$ make distclean<br />
$ sh cleanup.sh<br />
$ autoreconf -i<br />
$ ./configure<br />
$ make -j4 all<br />
$ sudo make install<br />
</pre><br />
If you continue to get errors, please report the whole ./configure output and the config.log to the mailing list.<br />
<br />
== Installation on Windows ==<br />
See [[ QtRadio on Windows]]<br />
<br />
== Network settings ==<br />
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.<br />
<br />
<br />
<br />
<br />
== Installing ghpsdr3-alex on Raspberry Pi == <br />
<br />
<br />
========== HARDWARE ==========<br />
<br />
*** THIS SECTION DEALS WITH Raspberry Pi DIFFERENCES *** IT DOES NOT CIRCUMVENT THE INSTRUCTIONS STARTING AT STEP 1 OF THE QtRadio Installation. ***<br />
<br />
I recommend installing either the raspbian or raspbian pisces (debian) distributions as there is no Ubuntu release to date.<br />
<br />
*** 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 <br />
document from the beginning after installing raspbian or raspbian pisces.<br />
<br />
<br />
The RasPi USB subsystem is sensitive to power supply voltage levels - A supply of 5.5V at 2A is recommended. <br />
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. <br />
<br />
Measuring the voltage across TP1 and TP2 on the Raspberry Pi and increased it to +4.97V (P.S output +5.59V).<br />
<br />
I also ran "rpi-update" which install new firmware. <br />
<br />
I shorted out the polyfuses F1 and F2 on the Pi and USB is much more stable but still limited.<br />
<br />
With keyboard, mouse, gigabit USB Ethernet, SB Live! 24 USB and RTL-SDR dongle it runs for some hours before it freezes.<br />
<br />
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.<br />
<br />
root@pisces:/usr/src/GHPSDR3_HIGH_SPEED_MASTER/ghpsdr3-alex# date<br />
<br />
Sun Sep 9 13:00:49 BST 2012<br />
<br />
root@pisces:/usr/src/GHPSDR3_HIGH_SPEED_MASTER/ghpsdr3-alex# uptime<br />
<br />
13:00:56 up 2 days, 20:46, 8 users, load average: 0.81, 1.01, 0.67<br />
<br />
<br />
<br />
<br />
****** Do not use power from a USB PC port or from a USB Hub. ********<br />
<br />
<br />
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):-<br />
<br />
Keyboard, mouse, usb sound card, RTL-SDR TV dongle and USB Gigabit Ethernet fully operational using the 7-port powered USB hub.<br />
<br />
root@pisces:~# lsusb<br />
<br />
Bus 001 Device 001: ID 1d6b:0002 Linux Foundation 2.0 root hub<br />
<br />
Bus 001 Device 002: ID 0424:9512 Standard Microsystems Corp. <br />
<br />
Bus 001 Device 003: ID 0424:ec00 Standard Microsystems Corp.<br />
<br />
Bus 001 Device 004: ID 04cc:1521 ST-Ericsson USB 2.0 Hub<br />
<br />
Bus 001 Device 011: ID 04f3:0103 Elan Microelectronics Corp. <br />
<br />
Bus 001 Device 006: ID 047d:1022 Kensington Orbit Optical<br />
<br />
Bus 001 Device 007: ID 1d19:1101 Dexatek Technology Ltd. DK DVB-T Dongle<br />
<br />
Bus 001 Device 008: ID 041e:3040 Creative Technology, Ltd SoundBlaster Live! 24-bit External SB0490<br />
<br />
Bus 001 Device 009: ID 0b95:1780 ASIX Electronics Corp. AX88178<br />
root@pisces:~# ifconfig <br />
<br />
eth0 Link encap:Ethernet HWaddr b8:27:eb:2c:07:c9<br />
<br />
inet addr:192.168.10.31 Bcast:192.168.10.255 Mask:255.255.255.0<br />
inet6 addr: fe80::ba27:ebff:fe2c:7c9/64 Scope:Link<br />
UP BROADCAST RUNNING MULTICAST MTU:1500 Metric:1<br />
RX packets:410 errors:0 dropped:0 overruns:0 frame:0<br />
TX packets:377 errors:0 dropped:0 overruns:0 carrier:0<br />
collisions:0 txqueuelen:1000<br />
RX bytes:28905 (28.2 KiB) TX bytes:35938 (35.0 KiB)<br />
<br />
eth1 Link encap:Ethernet HWaddr 00:10:14:00:9f:fa<br />
<br />
inet addr:192.168.2.199 Bcast:192.168.2.255 Mask:255.255.255.0<br />
inet6 addr: fe80::210:14ff:fe00:9ffa/64 Scope:Link<br />
UP BROADCAST RUNNING MULTICAST MTU:1500 Metric:1<br />
RX packets:5 errors:0 dropped:0 overruns:0 frame:0<br />
TX packets:7 errors:0 dropped:0 overruns:0 carrier:0<br />
collisions:0 txqueuelen:1000<br />
RX bytes:230 (230.0 B) TX bytes:592 (592.0 B)<br />
<br />
lo Link encap:Local Loopback<br />
<br />
inet addr:127.0.0.1 Mask:255.0.0.0<br />
inet6 addr: ::1/128 Scope:Host<br />
UP LOOPBACK RUNNING MTU:16436 Metric:1<br />
RX packets:0 errors:0 dropped:0 overruns:0 frame:0<br />
TX packets:0 errors:0 dropped:0 overruns:0 carrier:0<br />
collisions:0 txqueuelen:0<br />
RX bytes:0 (0.0 B) TX bytes:0 (0.0 B)<br />
<br />
root@pisces:~# cat /proc/asound/cards<br />
0 [ALSA ]: BRCM bcm2835 ALSbcm2835 ALSA - bcm2835 ALSA<br />
bcm2835 ALSA<br />
<br />
1 [External ]: USB-Audio - SB Live! 24-bit External<br />
Creative Technology SB Live! 24-bit External at usb-bcm2708_usb-1.2.2, full spe<br />
<br />
<br />
<br />
<br />
It's running at 855MHz with this config.txt file. <br />
root@pisces:~# cat /boot/config.txt<br />
<br />
over_voltage=6<br />
<br />
arm_freq=855<br />
<br />
core_freq=500<br />
<br />
sdram_freq=500<br />
<br />
<br />
root@pisces:~# cat /etc/network/interfaces<br />
<br />
Used by ifup(8) and ifdown(8). See the interfaces(5) manpage or<br />
/usr/share/doc/ifupdown/examples for more information. <br />
<br />
auto lo<br />
<br />
<br />
iface lo inet loopback<br />
<br />
<br />
File: ifcfg-eth0<br />
<br />
auto eth0<br />
<br />
iface eth0 inet static<br />
<br />
address 192.168.10.31<br />
<br />
netmask 255.255.255.0<br />
<br />
gateway 192.168.10.103<br />
<br />
<br />
auto eth1<br />
<br />
iface eth1 inet static<br />
<br />
address 192.168.2.199<br />
<br />
netmask 255.255.255.0<br />
<br />
<br />
root@pisces:~# cat /etc/modules<br />
<br />
/etc/modules: kernel modules to load at boot time.<br />
This file contains the names of kernel modules that should be loaded<br />
at boot time, one per line. Lines beginning with "#" are ignored.<br />
Parameters can be specified after the module name. <br />
<br />
loop<br />
<br />
snd-bcm2835<br />
<br />
<br />
One problem remains, no sound from the on-board chip.<br />
<br />
==VIRTUALBOX==<br />
<br />
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 [[Dspserver.conf]] file needs to be edited, and you will need to run the dspserver once within a terminal to get the instructions on setting up an SSL key pair. To do that download the [http://people.wallawalla.edu/~Rob.Frohne/ghpsdr3-alex/Ubuntu%2012.10%20ghpsdr3-alex-hermes.zip VirtualBox image], start VirtualBox, select new for the new machine, and when it asks you about the hard drive, say use existing hard drive, and select the image you just downloaded as the hard drive. After it boots up, you need to start a terminal and dspserver.<br />
$ dspserver<br />
Reading conf file /home/frohro/dspserver.conf<br />
Country Lookup is On<br />
gHPSDR rx 0 (Version 0.7)<br />
dspserver string: 20130609;-master<br />
getSoundcardId: HPSDR id=8<br />
setSoundcard: 8<br />
setSoundcard -41.000000 -48.000000<br />
etup sdr thread 0: done<br />
setup sdr thread 1: done<br />
setup sdr thread 2: done<br />
client_thread<br />
[2013-08-26 10:15:12] client_thread: listening on port 8000<br />
Couldn't read 'pkey' or 'cert' file. To generate a key<br />
and self-signed certificate, run:<br />
openssl genrsa -out pkey 2048<br />
openssl req -new -key pkey -out cert.req<br />
openssl x509 -req -days 365 -in cert.req -signkey pkey -out cert<br />
client ctx init failed: No such file or directory<br />
<br />
<br />
Note the message about the SSL keys ("Couldn't read 'pkey' or 'cert' file.") not being set up. This is a process you do once. The three commands to set up the SSL keys are just what the dspserver response above told you to do. <br />
openssl genrsa -out pkey 2048<br />
<br />
openssl req -new -key pkey -out cert.req<br />
<br />
openssl x509 -req -days 365 -in cert.req -signkey pkey -out cert<br />
After generating the keys, you should be able to log out and log back in and your server should be running, if all is well. You should then be able to connect with QtRadio or glSDR. Be sure to set the server IP address in the client (QtRadio, or glSDR). <br />
<br />
If you want to change 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.<br />
<br />
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, but the ghpsdr3-alex and the tools and packages needed to build it. As always, there is a trade off between ease of use, and security.<br />
<br />
== SOFTWARE == <br />
***** START AT THE BEGINNING WHEN BUILDING THE SOFTWARE -- i.e Section 1 and install all the packages recommended and do the pulseaudio setup.<br />
<br />
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.<br />
<br />
Subject: [n2adr-sdr] Raspberry Pi running ghpsdr3-alex<br />
<br />
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.<br />
<br />
<br />
autoreconf -i <br />
<br />
./configure CFLAGS='-O3 -pipe -march=armv6 -mfpu=vfp -mfloat-abi=hard' CXXFLAGS='-O3 -pipe -march=armv6 -mfpu=vfp -mfloat-abi=hard' <br />
<br />
**** Additional steps needed when building rtlsdr-server. Do these before running make ******<br />
# export ac_cv_func_malloc_0_nonnull=yes<br />
# export ac_cv_func_realloc_0_nonnull=yes<br />
<br />
<br />
make all && make all install <br />
<br />
<br />
Sound on the Raspberry Pi is still a problem I have not been able to solve.<br />
<br />
Terry (WB4JFI) suggested the following that work for him but I have had no luck with it.<br />
<br />
"amixer cset numid=3 1"<br />
<br />
Other valid numid's are 0=auto, 1=headphones and 2=hdmi.<br />
<br />
<br />
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.<br />
<br />
When a slave connected and tried changing frequency, dspserver crashed - dspserver can be a bit crash happy.<br />
<br />
The first thing I tried on the Pi was QtRadio standalone, spectrum and waterfall were OK but no sound.<br />
<br />
Just now a client using glSDR (5) is attempting to change frequency, sound went quite distorted then dspserver crashed.<br />
<br />
Restarted dspserver and QtRadio sound started very distorted before it settled down to reasonable.</div>Frohrohttps://napan.ca/ghpsdr3/index.php?title=QtRadio_Installation&diff=756QtRadio Installation2013-08-26T17:25:13Z<p>Frohro: /* VIRTUALBOX */</p>
<hr />
<div>== Installation on Linux ==<br />
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.<br />
<br />
<br />
<br />
<br />
=== Installation from Git ===<br />
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.<br />
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.<br />
<br />
==== Installing compiler and autotool ====<br />
<br />
First off, install the compiler; depending on which distribution are you using, some or all of this stuff could be already installed: <br />
<br />
===== Ubuntu/Debian =====<br />
<pre><br />
sudo apt-get install make gcc g++<br />
sudo apt-get install autoconf automake autotools-dev libtool git subversion<br />
</pre><br />
<br />
===== Fedora =====<br />
<pre><br />
sudo yum install gcc gcc-c++ man-pages autoconf automake subversion libtool git<br />
</pre><br />
<br />
==== Installing prerequisite packages ====<br />
<br />
===== Ubuntu 12.04 and newer =====<br />
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:<br />
<br />
<pre><br />
sudo apt-get update<br />
sudo apt-get install \<br />
libqt4-opengl-dev \<br />
qtmobility-dev \<br />
libusb-0.1-4 \<br />
libusb-dev \<br />
libfftw3-dev \<br />
portaudio19-dev \<br />
libpulse-dev \<br />
libsamplerate0-dev \<br />
libusb-1.0-0-dev \<br />
libconfig8-dev \<br />
xdg-utils \<br />
libortp-dev \<br />
gcc-multilib \<br />
libssl-dev \<br />
libevent-dev \<br />
libglu1-mesa-dev \<br />
freeglut3-dev<br />
</pre><br />
<br />
You will need qt5 installed to complete the build.<br />
<br />
Visit: http://qt-project.org/downloads<br />
<br />
download the current package for your system.<br />
<br />
To build Qt5 on a RaspberryPi visit: http://qt-project.org/wiki/RaspberryPi<br />
<br />
After downloading it go to the download directory and do:<br />
<pre><br />
$ chmod +x the-name-of-the-downloaded-file<br />
$ sudo ./the-name-of-the-downloaded-file<br />
</pre><br />
<br />
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:<br />
<pre><br />
$ export PATH=/opt/Qt5.1.0/5.1.0/gcc_64/bin:/opt/Qt5.1.0/Tools/QtCreator/bin:$PATH<br />
</pre><br />
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.<br />
In any case please remember that<br />
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<br />
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.<br />
For the bash it is typically ~/.bashrc<br />
In any case, after you issue the export, please test it.<br />
<pre><br />
qmake -v<br />
QMake version 2.01a<br />
Using Qt version 4.8.0 in /home/andrew/QtSDK4.8x/Desktop/Qt/4.8.0/gcc/lib<br />
</pre><br />
<br />
===== Ubuntu 11.04 and older ===== <br />
First of all, you have to check that the ''universe repository'' is enabled.<br />
Please see the procedure in the previous section [[#graphical installation]] .<br />
<br />
Next, you will need the following packages installed:<br />
<br />
<pre><br />
sudo apt-get update<br />
sudo apt-get install \<br />
libqt4-opengl-dev \<br />
qtmobility-dev \<br />
libusb-0.1-4 \<br />
libusb-dev \<br />
libfftw3-dev \<br />
portaudio19-dev \<br />
libpulse-dev \<br />
libsamplerate0-dev \<br />
libusb-1.0-0-dev \<br />
libconfig8-dev \<br />
libortp-dev<br />
</pre><br />
<br />
===== Ubuntu 11.10 ===== <br />
First of all, you have to check that the ''universe repository'' is enabled.<br />
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.<br />
Next, submit the following commands into a terminal window:<br />
<br />
<pre><br />
sudo apt-get update<br />
sudo apt-get install \<br />
libqt4-opengl-dev \<br />
qtmobility-dev \<br />
libusb-0.1-4 \<br />
libusb-dev \<br />
libfftw3-dev \<br />
portaudio19-dev \<br />
libpulse-dev \<br />
libsamplerate0-dev \<br />
libusb-1.0-0-dev \<br />
libconfig8-dev \<br />
xdg-utils \<br />
libortp-dev<br />
</pre><br />
<br />
===== Fedora 16 =====<br />
<br />
<pre><br />
sudo yum install fftw fftw-devel <br />
sudo yum install libusb-devel libusb1-devel <br />
sudo yum install portaudio-devel<br />
sudo yum install libconfig-devel<br />
sudo yum install libsamplerate-devel<br />
sudo yum install pulseaudio-libs-devel<br />
sudo yum install jack-audio-connection-kit jack-audio-connection-kit-devel<br />
sudo yum install qt4-devel<br />
</pre><br />
<br />
<br />
==== Cloning the repository ====<br />
<br />
How to build the latest master branch on Ubuntu 11.04<br />
<br />
First a new libevent will need to be downloaded and installed, then the actual QtRadio source can be downloaded and built.<br />
<br />
==== Obtaining an up-level libevent library ====<br />
<br />
$ sudo apt-get install libevent-dev<br />
<br />
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)<br />
<br />
Then download the new version from:<br />
<br />
http://libevent.org/<br />
<br />
libevent-2.0.16-stable.tar.gz<br />
<br />
<pre><br />
wget https://github.com/downloads/libevent/libevent/libevent-2.0.16-stable.tar.gz<br />
</pre><br />
<br />
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:<br />
<br />
<pre><br />
cd<br />
tar -zxvf libevent-2.0.16-stable.tar.gz<br />
cd libevent-2.0.16-stable<br />
./configure<br />
make<br />
sudo make install<br />
sudo ldconfig<br />
</pre><br />
<br />
On Fedora, in order to use the library above, export the LD_LIBRARY_PATH:<br />
<br />
<pre><br />
export LD_LIBRARY_PATH=/usr/local/lib<br />
</pre><br />
<br />
==== Installing codec2 low bit rate audio encoding and decoding ====<br />
<br />
We are adding a low bit rate audio codec called codec 2 to QtRadio/dspserver. You need<br />
to download and build the codec2 library. See:<br />
<br />
http://www.rowetel.com/blog/?page_id=452<br />
<p><br />
Now go get codec2 using subversion<br />
<br />
<pre><br />
cd<br />
svn co https://freetel.svn.sourceforge.net/svnroot/freetel/codec2-dev codec2-dev<br />
cd codec2-dev<br />
autoreconf -i<br />
./configure<br />
make<br />
sudo make install<br />
sudo ldconfig<br />
</pre><br />
<br />
On Fedora, in order to use the library above, export the LD_LIBRARY_PATH:<br />
<br />
<pre><br />
export LD_LIBRARY_PATH=/usr/local/lib<br />
</pre><br />
<br />
==== Building the master branch ====<br />
<br />
This branch is the latest code that contains both RX and TX capability. <br />
<br />
Create a new directory or cd to the ~/src directory created for libevent and cd into it.<br />
<br />
<pre><br />
git clone git://github.com/alexlee188/ghpsdr3-alex<br />
</pre><br />
<br />
Depending on your Internet connection thorughput, it will take several minute to download.<br />
cd into the new directory ghpsdr3-alex:<br />
<pre><br />
cd ghpsdr3-alex<br />
git checkout master<br />
</pre><br />
You are now working with Alex's latest and greatest!<br />
<br />
First set the path to the version of qt you are using. E.g. for qt5:<br />
<pre><br />
$ export PATH=/opt/qt5/bin:$PATH<br />
</pre><br />
<br />
Then:<br />
<pre><br />
autoreconf -i<br />
./configure<br />
make -j4 all<br />
sudo make install<br />
</pre><br />
The default configure above builds with debug and default Qt4 version in your PC. For optimized executable,<br />
you need to specify options specific to your system. See the sample shell scripts that replaces the above<br />
./configure step:<br />
<br />
<pre><br />
./alex-avx-conf.sh for building with i3,i5 and i7 cpu's supporting Advanced Vector Extensions (AVX)<br />
./alex-openmp-conf.sh for building with i3,i5 and i7 cpu's and OpenMP support<br />
./alex-sse3-conf.sh for building with SSE3 capable cpu's<br />
./alex-openmp-sse3-conf.sh for building with SSE3 cpaable cpu's and OpenMP support<br />
</pre><br />
<br />
(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)<br />
<pre><br />
Terminal 1<br />
$ cd ghpsdr3-alex/trunk/src/softrock<br />
$ ./softrock ...options ...<br />
<br />
Terminal 2<br />
$ cd ghpsdr3-alex/trunk/src/dspserver<br />
$ ./dspserver ..options...<br />
<br />
Terminal 3<br />
$ cd ghpsdr3-alex/trunk/src/QtRadio<br />
$ ./QtRadio<br />
</pre><br />
<br />
==== Building the Perseus extensions ====<br />
<br />
In order to build the Microtelecom Perseus server you need to switch to the master or iw0hdv branch. <br />
<br />
First off, install the prerequisite library and wget package:<br />
<br />
<pre><br />
sudo apt-get install libboost-all-dev wget<br />
</pre><br />
<br />
Next download, compile and install the library libperseus-sdr:<br />
<br />
<pre><br />
cd<br />
wget http://libperseus-sdr.googlecode.com/files/libperseus_sdr-0.6.tar.gz<br />
tar -zxvf libperseus_sdr-0.6.tar.gz<br />
cd libperseus_sdr-0.6/<br />
./configure && make<br />
sudo make install<br />
sudo ldconfig<br />
</pre><br />
<br />
<br />
If you already build in your sandbox some other branch, is strongly advisable, before you start the build, to do a full cleanup:<br />
<pre><br />
cd ~/ghpsdr3-alex<br />
make distcheck && sh cleanup.sh<br />
</pre><br />
<br />
Otherwise, if you are starting from scratch, you have to clone the repository:<br />
<br />
<pre><br />
git clone git://github.com/alexlee188/ghpsdr3-alex<br />
</pre><br />
<br />
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.<br />
<br />
<pre><br />
cd ~/ghpsdr3-alex<br />
git checkout master<br />
autoreconf -i && ./configure && make -j4<br />
sudo make install<br />
</pre><br />
<br />
In order to run it you have two choices, the first one being the plain command line:<br />
<br />
<pre><br />
xterm -e 'perseus_server -d3 -s96000 ' &<br />
sleep 3<br />
xterm -e 'dspserver --lo 0 --nocorrectiq' &<br />
sleep 5<br />
$( QtRadio 127.0.0.1 ) <br />
</pre><br />
<br />
In QtRadio, Receiver menu, select Configure item, Server tab: here add the local host using the 127.0.0.1 IP address.<br />
Pressing the key C, you start the receiver.<br />
<br />
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.<br />
<br />
==== Building USRP enabled version ====<br />
<br />
===== Building the UHD package =====<br />
<br />
<br />
====== Install the prerequisite packages (Ubuntu 11.10): ======<br />
<br />
<pre><br />
sudo apt-get install liboost-all-dev<br />
sudo apt-get install python-cheetah<br />
</pre><br />
<br />
====== Build & Install UHD -- FOR UHD-3.3.1 AND GREATER --: ======<br />
<br />
<pre><br />
cd<br />
git clone git://ettus.sourcerepo.com/ettus/uhd.git<br />
cd uhd/host/<br />
mkdir build<br />
cd build<br />
cmake ../<br />
make<br />
make test<br />
sudo make install<br />
sudo ldconfig<br />
</pre><br />
<br />
If you already build in your sandbox some other branch, is strongly advisable, before you start the build, to do a full cleanup:<br />
<pre><br />
cd ~/ghpsdr3-alex<br />
make distcheck && sh cleanup.sh<br />
</pre><br />
<br />
Otherwise, if you are starting from scratch, first clone the repository:<br />
<br />
<pre><br />
git clone git://github.com/alexlee188/ghpsdr3-alex<br />
</pre><br />
<br />
Finally, you can switch to the master branch and rebuild everything, enabling the usrp server feature:<br />
<pre><br />
cd ~/ghpsdr3-alex<br />
git checkout usrp-server<br />
autoreconf -i && ./configure --enable-usrp=yes && make -j4<br />
sudo make install<br />
</pre><br />
<br />
==== Refresh to a Newer Version ====<br />
<br />
To pull a new version to build <br />
<pre><br />
$ git pull<br />
$ make -j4 all<br />
$ sudo make install<br />
</pre><br />
If extensive changes have occurred or if you get errors during the make, you may want to do a clean build <br />
<pre><br />
$ git pull<br />
$ make distclean<br />
$ sh cleanup.sh<br />
$ autoreconf -i<br />
$ ./configure<br />
$ make -j4 all<br />
$ sudo make install<br />
</pre><br />
If you continue to get errors, please report the whole ./configure output and the config.log to the mailing list.<br />
<br />
== Installation on Windows ==<br />
See [[ QtRadio on Windows]]<br />
<br />
== Network settings ==<br />
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.<br />
<br />
<br />
<br />
<br />
== Installing ghpsdr3-alex on Raspberry Pi == <br />
<br />
<br />
========== HARDWARE ==========<br />
<br />
*** THIS SECTION DEALS WITH Raspberry Pi DIFFERENCES *** IT DOES NOT CIRCUMVENT THE INSTRUCTIONS STARTING AT STEP 1 OF THE QtRadio Installation. ***<br />
<br />
I recommend installing either the raspbian or raspbian pisces (debian) distributions as there is no Ubuntu release to date.<br />
<br />
*** 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 <br />
document from the beginning after installing raspbian or raspbian pisces.<br />
<br />
<br />
The RasPi USB subsystem is sensitive to power supply voltage levels - A supply of 5.5V at 2A is recommended. <br />
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. <br />
<br />
Measuring the voltage across TP1 and TP2 on the Raspberry Pi and increased it to +4.97V (P.S output +5.59V).<br />
<br />
I also ran "rpi-update" which install new firmware. <br />
<br />
I shorted out the polyfuses F1 and F2 on the Pi and USB is much more stable but still limited.<br />
<br />
With keyboard, mouse, gigabit USB Ethernet, SB Live! 24 USB and RTL-SDR dongle it runs for some hours before it freezes.<br />
<br />
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.<br />
<br />
root@pisces:/usr/src/GHPSDR3_HIGH_SPEED_MASTER/ghpsdr3-alex# date<br />
<br />
Sun Sep 9 13:00:49 BST 2012<br />
<br />
root@pisces:/usr/src/GHPSDR3_HIGH_SPEED_MASTER/ghpsdr3-alex# uptime<br />
<br />
13:00:56 up 2 days, 20:46, 8 users, load average: 0.81, 1.01, 0.67<br />
<br />
<br />
<br />
<br />
****** Do not use power from a USB PC port or from a USB Hub. ********<br />
<br />
<br />
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):-<br />
<br />
Keyboard, mouse, usb sound card, RTL-SDR TV dongle and USB Gigabit Ethernet fully operational using the 7-port powered USB hub.<br />
<br />
root@pisces:~# lsusb<br />
<br />
Bus 001 Device 001: ID 1d6b:0002 Linux Foundation 2.0 root hub<br />
<br />
Bus 001 Device 002: ID 0424:9512 Standard Microsystems Corp. <br />
<br />
Bus 001 Device 003: ID 0424:ec00 Standard Microsystems Corp.<br />
<br />
Bus 001 Device 004: ID 04cc:1521 ST-Ericsson USB 2.0 Hub<br />
<br />
Bus 001 Device 011: ID 04f3:0103 Elan Microelectronics Corp. <br />
<br />
Bus 001 Device 006: ID 047d:1022 Kensington Orbit Optical<br />
<br />
Bus 001 Device 007: ID 1d19:1101 Dexatek Technology Ltd. DK DVB-T Dongle<br />
<br />
Bus 001 Device 008: ID 041e:3040 Creative Technology, Ltd SoundBlaster Live! 24-bit External SB0490<br />
<br />
Bus 001 Device 009: ID 0b95:1780 ASIX Electronics Corp. AX88178<br />
root@pisces:~# ifconfig <br />
<br />
eth0 Link encap:Ethernet HWaddr b8:27:eb:2c:07:c9<br />
<br />
inet addr:192.168.10.31 Bcast:192.168.10.255 Mask:255.255.255.0<br />
inet6 addr: fe80::ba27:ebff:fe2c:7c9/64 Scope:Link<br />
UP BROADCAST RUNNING MULTICAST MTU:1500 Metric:1<br />
RX packets:410 errors:0 dropped:0 overruns:0 frame:0<br />
TX packets:377 errors:0 dropped:0 overruns:0 carrier:0<br />
collisions:0 txqueuelen:1000<br />
RX bytes:28905 (28.2 KiB) TX bytes:35938 (35.0 KiB)<br />
<br />
eth1 Link encap:Ethernet HWaddr 00:10:14:00:9f:fa<br />
<br />
inet addr:192.168.2.199 Bcast:192.168.2.255 Mask:255.255.255.0<br />
inet6 addr: fe80::210:14ff:fe00:9ffa/64 Scope:Link<br />
UP BROADCAST RUNNING MULTICAST MTU:1500 Metric:1<br />
RX packets:5 errors:0 dropped:0 overruns:0 frame:0<br />
TX packets:7 errors:0 dropped:0 overruns:0 carrier:0<br />
collisions:0 txqueuelen:1000<br />
RX bytes:230 (230.0 B) TX bytes:592 (592.0 B)<br />
<br />
lo Link encap:Local Loopback<br />
<br />
inet addr:127.0.0.1 Mask:255.0.0.0<br />
inet6 addr: ::1/128 Scope:Host<br />
UP LOOPBACK RUNNING MTU:16436 Metric:1<br />
RX packets:0 errors:0 dropped:0 overruns:0 frame:0<br />
TX packets:0 errors:0 dropped:0 overruns:0 carrier:0<br />
collisions:0 txqueuelen:0<br />
RX bytes:0 (0.0 B) TX bytes:0 (0.0 B)<br />
<br />
root@pisces:~# cat /proc/asound/cards<br />
0 [ALSA ]: BRCM bcm2835 ALSbcm2835 ALSA - bcm2835 ALSA<br />
bcm2835 ALSA<br />
<br />
1 [External ]: USB-Audio - SB Live! 24-bit External<br />
Creative Technology SB Live! 24-bit External at usb-bcm2708_usb-1.2.2, full spe<br />
<br />
<br />
<br />
<br />
It's running at 855MHz with this config.txt file. <br />
root@pisces:~# cat /boot/config.txt<br />
<br />
over_voltage=6<br />
<br />
arm_freq=855<br />
<br />
core_freq=500<br />
<br />
sdram_freq=500<br />
<br />
<br />
root@pisces:~# cat /etc/network/interfaces<br />
<br />
Used by ifup(8) and ifdown(8). See the interfaces(5) manpage or<br />
/usr/share/doc/ifupdown/examples for more information. <br />
<br />
auto lo<br />
<br />
<br />
iface lo inet loopback<br />
<br />
<br />
File: ifcfg-eth0<br />
<br />
auto eth0<br />
<br />
iface eth0 inet static<br />
<br />
address 192.168.10.31<br />
<br />
netmask 255.255.255.0<br />
<br />
gateway 192.168.10.103<br />
<br />
<br />
auto eth1<br />
<br />
iface eth1 inet static<br />
<br />
address 192.168.2.199<br />
<br />
netmask 255.255.255.0<br />
<br />
<br />
root@pisces:~# cat /etc/modules<br />
<br />
/etc/modules: kernel modules to load at boot time.<br />
This file contains the names of kernel modules that should be loaded<br />
at boot time, one per line. Lines beginning with "#" are ignored.<br />
Parameters can be specified after the module name. <br />
<br />
loop<br />
<br />
snd-bcm2835<br />
<br />
<br />
One problem remains, no sound from the on-board chip.<br />
<br />
==VIRTUALBOX==<br />
<br />
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 [[Dspserver.conf]] file needs to be edited, and you will need to run the dspserver once within a terminal to get the instructions on setting up an SSL key pair. To do that download the [http://people.wallawalla.edu/~Rob.Frohne/ghpsdr3-alex/Ubuntu%2012.10%20ghpsdr3-alex-hermes.zip VirtualBox image], start VirtualBox, select new for the new machine, and when it asks you about the hard drive, say use existing hard drive, and select the image you just downloaded as the hard drive. After it boots up, you need to start a terminal and dspserver.<br />
$ dspserver<br />
Reading conf file /home/frohro/dspserver.conf<br />
Country Lookup is On<br />
gHPSDR rx 0 (Version 0.7)<br />
dspserver string: 20130609;-master<br />
getSoundcardId: HPSDR id=8<br />
setSoundcard: 8<br />
setSoundcard -41.000000 -48.000000<br />
etup sdr thread 0: done<br />
setup sdr thread 1: done<br />
setup sdr thread 2: done<br />
client_thread<br />
[2013-08-26 10:15:12] client_thread: listening on port 8000<br />
Couldn't read 'pkey' or 'cert' file. To generate a key<br />
and self-signed certificate, run:<br />
openssl genrsa -out pkey 2048<br />
openssl req -new -key pkey -out cert.req<br />
openssl x509 -req -days 365 -in cert.req -signkey pkey -out cert<br />
client ctx init failed: No such file or directory<br />
<br />
<br />
Note the message about the SSL keys ("Couldn't read 'pkey' or 'cert' file.") not being set up. This is a process you do once. The three commands to set up the SSL keys are just what the dspserver response above told you to do. <br />
openssl genrsa -out pkey 2048<br />
<br />
openssl req -new -key pkey -out cert.req<br />
<br />
openssl x509 -req -days 365 -in cert.req -signkey pkey -out cert<br />
After generating the keys, you should be able to log out and log back in and your server should be running, if all is well. You should then be able to connect with QtRadio or glSDR. Be sure to set the server IP address in the client (QtRadio, or glSDR). Some notes about running the [[Hermes]] server might be helpful to review.<br />
<br />
If you want to change or add the automatically started programs, see [http://askubuntu.com/questions/48321/how-do-i-start-applications-automatically-on-login this web page].<br />
<br />
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, but the ghpsdr3-alex and the tools and packages needed to build it. As always, there is a trade off between ease of use, and security.<br />
<br />
== SOFTWARE == <br />
***** START AT THE BEGINNING WHEN BUILDING THE SOFTWARE -- i.e Section 1 and install all the packages recommended and do the pulseaudio setup.<br />
<br />
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.<br />
<br />
Subject: [n2adr-sdr] Raspberry Pi running ghpsdr3-alex<br />
<br />
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.<br />
<br />
<br />
autoreconf -i <br />
<br />
./configure CFLAGS='-O3 -pipe -march=armv6 -mfpu=vfp -mfloat-abi=hard' CXXFLAGS='-O3 -pipe -march=armv6 -mfpu=vfp -mfloat-abi=hard' <br />
<br />
**** Additional steps needed when building rtlsdr-server. Do these before running make ******<br />
# export ac_cv_func_malloc_0_nonnull=yes<br />
# export ac_cv_func_realloc_0_nonnull=yes<br />
<br />
<br />
make all && make all install <br />
<br />
<br />
Sound on the Raspberry Pi is still a problem I have not been able to solve.<br />
<br />
Terry (WB4JFI) suggested the following that work for him but I have had no luck with it.<br />
<br />
"amixer cset numid=3 1"<br />
<br />
Other valid numid's are 0=auto, 1=headphones and 2=hdmi.<br />
<br />
<br />
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.<br />
<br />
When a slave connected and tried changing frequency, dspserver crashed - dspserver can be a bit crash happy.<br />
<br />
The first thing I tried on the Pi was QtRadio standalone, spectrum and waterfall were OK but no sound.<br />
<br />
Just now a client using glSDR (5) is attempting to change frequency, sound went quite distorted then dspserver crashed.<br />
<br />
Restarted dspserver and QtRadio sound started very distorted before it settled down to reasonable.</div>Frohrohttps://napan.ca/ghpsdr3/index.php?title=QtRadio_Installation&diff=755QtRadio Installation2013-08-26T17:19:09Z<p>Frohro: /* VIRTUALBOX */</p>
<hr />
<div>== Installation on Linux ==<br />
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.<br />
<br />
<br />
<br />
<br />
=== Installation from Git ===<br />
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.<br />
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.<br />
<br />
==== Installing compiler and autotool ====<br />
<br />
First off, install the compiler; depending on which distribution are you using, some or all of this stuff could be already installed: <br />
<br />
===== Ubuntu/Debian =====<br />
<pre><br />
sudo apt-get install make gcc g++<br />
sudo apt-get install autoconf automake autotools-dev libtool git subversion<br />
</pre><br />
<br />
===== Fedora =====<br />
<pre><br />
sudo yum install gcc gcc-c++ man-pages autoconf automake subversion libtool git<br />
</pre><br />
<br />
==== Installing prerequisite packages ====<br />
<br />
===== Ubuntu 12.04 and newer =====<br />
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:<br />
<br />
<pre><br />
sudo apt-get update<br />
sudo apt-get install \<br />
libqt4-opengl-dev \<br />
qtmobility-dev \<br />
libusb-0.1-4 \<br />
libusb-dev \<br />
libfftw3-dev \<br />
portaudio19-dev \<br />
libpulse-dev \<br />
libsamplerate0-dev \<br />
libusb-1.0-0-dev \<br />
libconfig8-dev \<br />
xdg-utils \<br />
libortp-dev \<br />
gcc-multilib \<br />
libssl-dev \<br />
libevent-dev \<br />
libglu1-mesa-dev \<br />
freeglut3-dev<br />
</pre><br />
<br />
You will need qt5 installed to complete the build.<br />
<br />
Visit: http://qt-project.org/downloads<br />
<br />
download the current package for your system.<br />
<br />
To build Qt5 on a RaspberryPi visit: http://qt-project.org/wiki/RaspberryPi<br />
<br />
After downloading it go to the download directory and do:<br />
<pre><br />
$ chmod +x the-name-of-the-downloaded-file<br />
$ sudo ./the-name-of-the-downloaded-file<br />
</pre><br />
<br />
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:<br />
<pre><br />
$ export PATH=/opt/Qt5.1.0/5.1.0/gcc_64/bin:/opt/Qt5.1.0/Tools/QtCreator/bin:$PATH<br />
</pre><br />
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.<br />
In any case please remember that<br />
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<br />
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.<br />
For the bash it is typically ~/.bashrc<br />
In any case, after you issue the export, please test it.<br />
<pre><br />
qmake -v<br />
QMake version 2.01a<br />
Using Qt version 4.8.0 in /home/andrew/QtSDK4.8x/Desktop/Qt/4.8.0/gcc/lib<br />
</pre><br />
<br />
===== Ubuntu 11.04 and older ===== <br />
First of all, you have to check that the ''universe repository'' is enabled.<br />
Please see the procedure in the previous section [[#graphical installation]] .<br />
<br />
Next, you will need the following packages installed:<br />
<br />
<pre><br />
sudo apt-get update<br />
sudo apt-get install \<br />
libqt4-opengl-dev \<br />
qtmobility-dev \<br />
libusb-0.1-4 \<br />
libusb-dev \<br />
libfftw3-dev \<br />
portaudio19-dev \<br />
libpulse-dev \<br />
libsamplerate0-dev \<br />
libusb-1.0-0-dev \<br />
libconfig8-dev \<br />
libortp-dev<br />
</pre><br />
<br />
===== Ubuntu 11.10 ===== <br />
First of all, you have to check that the ''universe repository'' is enabled.<br />
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.<br />
Next, submit the following commands into a terminal window:<br />
<br />
<pre><br />
sudo apt-get update<br />
sudo apt-get install \<br />
libqt4-opengl-dev \<br />
qtmobility-dev \<br />
libusb-0.1-4 \<br />
libusb-dev \<br />
libfftw3-dev \<br />
portaudio19-dev \<br />
libpulse-dev \<br />
libsamplerate0-dev \<br />
libusb-1.0-0-dev \<br />
libconfig8-dev \<br />
xdg-utils \<br />
libortp-dev<br />
</pre><br />
<br />
===== Fedora 16 =====<br />
<br />
<pre><br />
sudo yum install fftw fftw-devel <br />
sudo yum install libusb-devel libusb1-devel <br />
sudo yum install portaudio-devel<br />
sudo yum install libconfig-devel<br />
sudo yum install libsamplerate-devel<br />
sudo yum install pulseaudio-libs-devel<br />
sudo yum install jack-audio-connection-kit jack-audio-connection-kit-devel<br />
sudo yum install qt4-devel<br />
</pre><br />
<br />
<br />
==== Cloning the repository ====<br />
<br />
How to build the latest master branch on Ubuntu 11.04<br />
<br />
First a new libevent will need to be downloaded and installed, then the actual QtRadio source can be downloaded and built.<br />
<br />
==== Obtaining an up-level libevent library ====<br />
<br />
$ sudo apt-get install libevent-dev<br />
<br />
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)<br />
<br />
Then download the new version from:<br />
<br />
http://libevent.org/<br />
<br />
libevent-2.0.16-stable.tar.gz<br />
<br />
<pre><br />
wget https://github.com/downloads/libevent/libevent/libevent-2.0.16-stable.tar.gz<br />
</pre><br />
<br />
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:<br />
<br />
<pre><br />
cd<br />
tar -zxvf libevent-2.0.16-stable.tar.gz<br />
cd libevent-2.0.16-stable<br />
./configure<br />
make<br />
sudo make install<br />
sudo ldconfig<br />
</pre><br />
<br />
On Fedora, in order to use the library above, export the LD_LIBRARY_PATH:<br />
<br />
<pre><br />
export LD_LIBRARY_PATH=/usr/local/lib<br />
</pre><br />
<br />
==== Installing codec2 low bit rate audio encoding and decoding ====<br />
<br />
We are adding a low bit rate audio codec called codec 2 to QtRadio/dspserver. You need<br />
to download and build the codec2 library. See:<br />
<br />
http://www.rowetel.com/blog/?page_id=452<br />
<p><br />
Now go get codec2 using subversion<br />
<br />
<pre><br />
cd<br />
svn co https://freetel.svn.sourceforge.net/svnroot/freetel/codec2-dev codec2-dev<br />
cd codec2-dev<br />
autoreconf -i<br />
./configure<br />
make<br />
sudo make install<br />
sudo ldconfig<br />
</pre><br />
<br />
On Fedora, in order to use the library above, export the LD_LIBRARY_PATH:<br />
<br />
<pre><br />
export LD_LIBRARY_PATH=/usr/local/lib<br />
</pre><br />
<br />
==== Building the master branch ====<br />
<br />
This branch is the latest code that contains both RX and TX capability. <br />
<br />
Create a new directory or cd to the ~/src directory created for libevent and cd into it.<br />
<br />
<pre><br />
git clone git://github.com/alexlee188/ghpsdr3-alex<br />
</pre><br />
<br />
Depending on your Internet connection thorughput, it will take several minute to download.<br />
cd into the new directory ghpsdr3-alex:<br />
<pre><br />
cd ghpsdr3-alex<br />
git checkout master<br />
</pre><br />
You are now working with Alex's latest and greatest!<br />
<br />
First set the path to the version of qt you are using. E.g. for qt5:<br />
<pre><br />
$ export PATH=/opt/qt5/bin:$PATH<br />
</pre><br />
<br />
Then:<br />
<pre><br />
autoreconf -i<br />
./configure<br />
make -j4 all<br />
sudo make install<br />
</pre><br />
The default configure above builds with debug and default Qt4 version in your PC. For optimized executable,<br />
you need to specify options specific to your system. See the sample shell scripts that replaces the above<br />
./configure step:<br />
<br />
<pre><br />
./alex-avx-conf.sh for building with i3,i5 and i7 cpu's supporting Advanced Vector Extensions (AVX)<br />
./alex-openmp-conf.sh for building with i3,i5 and i7 cpu's and OpenMP support<br />
./alex-sse3-conf.sh for building with SSE3 capable cpu's<br />
./alex-openmp-sse3-conf.sh for building with SSE3 cpaable cpu's and OpenMP support<br />
</pre><br />
<br />
(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)<br />
<pre><br />
Terminal 1<br />
$ cd ghpsdr3-alex/trunk/src/softrock<br />
$ ./softrock ...options ...<br />
<br />
Terminal 2<br />
$ cd ghpsdr3-alex/trunk/src/dspserver<br />
$ ./dspserver ..options...<br />
<br />
Terminal 3<br />
$ cd ghpsdr3-alex/trunk/src/QtRadio<br />
$ ./QtRadio<br />
</pre><br />
<br />
==== Building the Perseus extensions ====<br />
<br />
In order to build the Microtelecom Perseus server you need to switch to the master or iw0hdv branch. <br />
<br />
First off, install the prerequisite library and wget package:<br />
<br />
<pre><br />
sudo apt-get install libboost-all-dev wget<br />
</pre><br />
<br />
Next download, compile and install the library libperseus-sdr:<br />
<br />
<pre><br />
cd<br />
wget http://libperseus-sdr.googlecode.com/files/libperseus_sdr-0.6.tar.gz<br />
tar -zxvf libperseus_sdr-0.6.tar.gz<br />
cd libperseus_sdr-0.6/<br />
./configure && make<br />
sudo make install<br />
sudo ldconfig<br />
</pre><br />
<br />
<br />
If you already build in your sandbox some other branch, is strongly advisable, before you start the build, to do a full cleanup:<br />
<pre><br />
cd ~/ghpsdr3-alex<br />
make distcheck && sh cleanup.sh<br />
</pre><br />
<br />
Otherwise, if you are starting from scratch, you have to clone the repository:<br />
<br />
<pre><br />
git clone git://github.com/alexlee188/ghpsdr3-alex<br />
</pre><br />
<br />
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.<br />
<br />
<pre><br />
cd ~/ghpsdr3-alex<br />
git checkout master<br />
autoreconf -i && ./configure && make -j4<br />
sudo make install<br />
</pre><br />
<br />
In order to run it you have two choices, the first one being the plain command line:<br />
<br />
<pre><br />
xterm -e 'perseus_server -d3 -s96000 ' &<br />
sleep 3<br />
xterm -e 'dspserver --lo 0 --nocorrectiq' &<br />
sleep 5<br />
$( QtRadio 127.0.0.1 ) <br />
</pre><br />
<br />
In QtRadio, Receiver menu, select Configure item, Server tab: here add the local host using the 127.0.0.1 IP address.<br />
Pressing the key C, you start the receiver.<br />
<br />
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.<br />
<br />
==== Building USRP enabled version ====<br />
<br />
===== Building the UHD package =====<br />
<br />
<br />
====== Install the prerequisite packages (Ubuntu 11.10): ======<br />
<br />
<pre><br />
sudo apt-get install liboost-all-dev<br />
sudo apt-get install python-cheetah<br />
</pre><br />
<br />
====== Build & Install UHD -- FOR UHD-3.3.1 AND GREATER --: ======<br />
<br />
<pre><br />
cd<br />
git clone git://ettus.sourcerepo.com/ettus/uhd.git<br />
cd uhd/host/<br />
mkdir build<br />
cd build<br />
cmake ../<br />
make<br />
make test<br />
sudo make install<br />
sudo ldconfig<br />
</pre><br />
<br />
If you already build in your sandbox some other branch, is strongly advisable, before you start the build, to do a full cleanup:<br />
<pre><br />
cd ~/ghpsdr3-alex<br />
make distcheck && sh cleanup.sh<br />
</pre><br />
<br />
Otherwise, if you are starting from scratch, first clone the repository:<br />
<br />
<pre><br />
git clone git://github.com/alexlee188/ghpsdr3-alex<br />
</pre><br />
<br />
Finally, you can switch to the master branch and rebuild everything, enabling the usrp server feature:<br />
<pre><br />
cd ~/ghpsdr3-alex<br />
git checkout usrp-server<br />
autoreconf -i && ./configure --enable-usrp=yes && make -j4<br />
sudo make install<br />
</pre><br />
<br />
==== Refresh to a Newer Version ====<br />
<br />
To pull a new version to build <br />
<pre><br />
$ git pull<br />
$ make -j4 all<br />
$ sudo make install<br />
</pre><br />
If extensive changes have occurred or if you get errors during the make, you may want to do a clean build <br />
<pre><br />
$ git pull<br />
$ make distclean<br />
$ sh cleanup.sh<br />
$ autoreconf -i<br />
$ ./configure<br />
$ make -j4 all<br />
$ sudo make install<br />
</pre><br />
If you continue to get errors, please report the whole ./configure output and the config.log to the mailing list.<br />
<br />
== Installation on Windows ==<br />
See [[ QtRadio on Windows]]<br />
<br />
== Network settings ==<br />
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.<br />
<br />
<br />
<br />
<br />
== Installing ghpsdr3-alex on Raspberry Pi == <br />
<br />
<br />
========== HARDWARE ==========<br />
<br />
*** THIS SECTION DEALS WITH Raspberry Pi DIFFERENCES *** IT DOES NOT CIRCUMVENT THE INSTRUCTIONS STARTING AT STEP 1 OF THE QtRadio Installation. ***<br />
<br />
I recommend installing either the raspbian or raspbian pisces (debian) distributions as there is no Ubuntu release to date.<br />
<br />
*** 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 <br />
document from the beginning after installing raspbian or raspbian pisces.<br />
<br />
<br />
The RasPi USB subsystem is sensitive to power supply voltage levels - A supply of 5.5V at 2A is recommended. <br />
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. <br />
<br />
Measuring the voltage across TP1 and TP2 on the Raspberry Pi and increased it to +4.97V (P.S output +5.59V).<br />
<br />
I also ran "rpi-update" which install new firmware. <br />
<br />
I shorted out the polyfuses F1 and F2 on the Pi and USB is much more stable but still limited.<br />
<br />
With keyboard, mouse, gigabit USB Ethernet, SB Live! 24 USB and RTL-SDR dongle it runs for some hours before it freezes.<br />
<br />
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.<br />
<br />
root@pisces:/usr/src/GHPSDR3_HIGH_SPEED_MASTER/ghpsdr3-alex# date<br />
<br />
Sun Sep 9 13:00:49 BST 2012<br />
<br />
root@pisces:/usr/src/GHPSDR3_HIGH_SPEED_MASTER/ghpsdr3-alex# uptime<br />
<br />
13:00:56 up 2 days, 20:46, 8 users, load average: 0.81, 1.01, 0.67<br />
<br />
<br />
<br />
<br />
****** Do not use power from a USB PC port or from a USB Hub. ********<br />
<br />
<br />
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):-<br />
<br />
Keyboard, mouse, usb sound card, RTL-SDR TV dongle and USB Gigabit Ethernet fully operational using the 7-port powered USB hub.<br />
<br />
root@pisces:~# lsusb<br />
<br />
Bus 001 Device 001: ID 1d6b:0002 Linux Foundation 2.0 root hub<br />
<br />
Bus 001 Device 002: ID 0424:9512 Standard Microsystems Corp. <br />
<br />
Bus 001 Device 003: ID 0424:ec00 Standard Microsystems Corp.<br />
<br />
Bus 001 Device 004: ID 04cc:1521 ST-Ericsson USB 2.0 Hub<br />
<br />
Bus 001 Device 011: ID 04f3:0103 Elan Microelectronics Corp. <br />
<br />
Bus 001 Device 006: ID 047d:1022 Kensington Orbit Optical<br />
<br />
Bus 001 Device 007: ID 1d19:1101 Dexatek Technology Ltd. DK DVB-T Dongle<br />
<br />
Bus 001 Device 008: ID 041e:3040 Creative Technology, Ltd SoundBlaster Live! 24-bit External SB0490<br />
<br />
Bus 001 Device 009: ID 0b95:1780 ASIX Electronics Corp. AX88178<br />
root@pisces:~# ifconfig <br />
<br />
eth0 Link encap:Ethernet HWaddr b8:27:eb:2c:07:c9<br />
<br />
inet addr:192.168.10.31 Bcast:192.168.10.255 Mask:255.255.255.0<br />
inet6 addr: fe80::ba27:ebff:fe2c:7c9/64 Scope:Link<br />
UP BROADCAST RUNNING MULTICAST MTU:1500 Metric:1<br />
RX packets:410 errors:0 dropped:0 overruns:0 frame:0<br />
TX packets:377 errors:0 dropped:0 overruns:0 carrier:0<br />
collisions:0 txqueuelen:1000<br />
RX bytes:28905 (28.2 KiB) TX bytes:35938 (35.0 KiB)<br />
<br />
eth1 Link encap:Ethernet HWaddr 00:10:14:00:9f:fa<br />
<br />
inet addr:192.168.2.199 Bcast:192.168.2.255 Mask:255.255.255.0<br />
inet6 addr: fe80::210:14ff:fe00:9ffa/64 Scope:Link<br />
UP BROADCAST RUNNING MULTICAST MTU:1500 Metric:1<br />
RX packets:5 errors:0 dropped:0 overruns:0 frame:0<br />
TX packets:7 errors:0 dropped:0 overruns:0 carrier:0<br />
collisions:0 txqueuelen:1000<br />
RX bytes:230 (230.0 B) TX bytes:592 (592.0 B)<br />
<br />
lo Link encap:Local Loopback<br />
<br />
inet addr:127.0.0.1 Mask:255.0.0.0<br />
inet6 addr: ::1/128 Scope:Host<br />
UP LOOPBACK RUNNING MTU:16436 Metric:1<br />
RX packets:0 errors:0 dropped:0 overruns:0 frame:0<br />
TX packets:0 errors:0 dropped:0 overruns:0 carrier:0<br />
collisions:0 txqueuelen:0<br />
RX bytes:0 (0.0 B) TX bytes:0 (0.0 B)<br />
<br />
root@pisces:~# cat /proc/asound/cards<br />
0 [ALSA ]: BRCM bcm2835 ALSbcm2835 ALSA - bcm2835 ALSA<br />
bcm2835 ALSA<br />
<br />
1 [External ]: USB-Audio - SB Live! 24-bit External<br />
Creative Technology SB Live! 24-bit External at usb-bcm2708_usb-1.2.2, full spe<br />
<br />
<br />
<br />
<br />
It's running at 855MHz with this config.txt file. <br />
root@pisces:~# cat /boot/config.txt<br />
<br />
over_voltage=6<br />
<br />
arm_freq=855<br />
<br />
core_freq=500<br />
<br />
sdram_freq=500<br />
<br />
<br />
root@pisces:~# cat /etc/network/interfaces<br />
<br />
Used by ifup(8) and ifdown(8). See the interfaces(5) manpage or<br />
/usr/share/doc/ifupdown/examples for more information. <br />
<br />
auto lo<br />
<br />
<br />
iface lo inet loopback<br />
<br />
<br />
File: ifcfg-eth0<br />
<br />
auto eth0<br />
<br />
iface eth0 inet static<br />
<br />
address 192.168.10.31<br />
<br />
netmask 255.255.255.0<br />
<br />
gateway 192.168.10.103<br />
<br />
<br />
auto eth1<br />
<br />
iface eth1 inet static<br />
<br />
address 192.168.2.199<br />
<br />
netmask 255.255.255.0<br />
<br />
<br />
root@pisces:~# cat /etc/modules<br />
<br />
/etc/modules: kernel modules to load at boot time.<br />
This file contains the names of kernel modules that should be loaded<br />
at boot time, one per line. Lines beginning with "#" are ignored.<br />
Parameters can be specified after the module name. <br />
<br />
loop<br />
<br />
snd-bcm2835<br />
<br />
<br />
One problem remains, no sound from the on-board chip.<br />
<br />
==VIRTUALBOX==<br />
<br />
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 [[Dspserver.conf]] file needs to be edited, and you will need to run the dspserver once within a terminal to get the instructions on setting up an SSL key pair. To do that download the [http://people.wallawalla.edu/~Rob.Frohne/ghpsdr3-alex/Ubuntu%2012.10%20ghpsdr3-alex-hermes.zip VirtualBox image], start VirtualBox, select new for the new machine, and when it asks you about the hard drive, say use existing hard drive, and select the image you just downloaded as the hard drive. After it boots up, you need to start a terminal and dspserver.<br />
$ dspserver<br />
Reading conf file /home/frohro/dspserver.conf<br />
Country Lookup is On<br />
gHPSDR rx 0 (Version 0.7)<br />
dspserver string: 20130609;-master<br />
getSoundcardId: HPSDR id=8<br />
setSoundcard: 8<br />
setSoundcard -41.000000 -48.000000<br />
etup sdr thread 0: done<br />
setup sdr thread 1: done<br />
setup sdr thread 2: done<br />
client_thread<br />
[2013-08-26 10:15:12] client_thread: listening on port 8000<br />
Couldn't read 'pkey' or 'cert' file. To generate a key<br />
and self-signed certificate, run:<br />
openssl genrsa -out pkey 2048<br />
openssl req -new -key pkey -out cert.req<br />
openssl x509 -req -days 365 -in cert.req -signkey pkey -out cert<br />
client ctx init failed: No such file or directory<br />
<br />
<br />
It will give you a message about the SSL keys not being set up (see above), and then you do the three commands that do that for you. <br />
openssl genrsa -out pkey 2048<br />
<br />
openssl req -new -key pkey -out cert.req<br />
<br />
openssl x509 -req -days 365 -in cert.req -signkey pkey -out cert<br />
After that you should be able to log out and log back in and your server should be running, if all is well. You should then be able to connect with QtRadio or glSDR. Be sure to set the server IP address in the client (QtRadio, or glSDR). Some notes about running the [[Hermes]] server might be helpful to review.<br />
<br />
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, but the ghpsdr3-alex and the tools and packages needed to build it. As always, there is a trade off between ease of use, and security.<br />
<br />
== SOFTWARE == <br />
***** START AT THE BEGINNING WHEN BUILDING THE SOFTWARE -- i.e Section 1 and install all the packages recommended and do the pulseaudio setup.<br />
<br />
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.<br />
<br />
Subject: [n2adr-sdr] Raspberry Pi running ghpsdr3-alex<br />
<br />
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.<br />
<br />
<br />
autoreconf -i <br />
<br />
./configure CFLAGS='-O3 -pipe -march=armv6 -mfpu=vfp -mfloat-abi=hard' CXXFLAGS='-O3 -pipe -march=armv6 -mfpu=vfp -mfloat-abi=hard' <br />
<br />
**** Additional steps needed when building rtlsdr-server. Do these before running make ******<br />
# export ac_cv_func_malloc_0_nonnull=yes<br />
# export ac_cv_func_realloc_0_nonnull=yes<br />
<br />
<br />
make all && make all install <br />
<br />
<br />
Sound on the Raspberry Pi is still a problem I have not been able to solve.<br />
<br />
Terry (WB4JFI) suggested the following that work for him but I have had no luck with it.<br />
<br />
"amixer cset numid=3 1"<br />
<br />
Other valid numid's are 0=auto, 1=headphones and 2=hdmi.<br />
<br />
<br />
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.<br />
<br />
When a slave connected and tried changing frequency, dspserver crashed - dspserver can be a bit crash happy.<br />
<br />
The first thing I tried on the Pi was QtRadio standalone, spectrum and waterfall were OK but no sound.<br />
<br />
Just now a client using glSDR (5) is attempting to change frequency, sound went quite distorted then dspserver crashed.<br />
<br />
Restarted dspserver and QtRadio sound started very distorted before it settled down to reasonable.</div>Frohrohttps://napan.ca/ghpsdr3/index.php?title=QtRadio_Installation&diff=754QtRadio Installation2013-08-26T17:12:47Z<p>Frohro: /* VIRTUALBOX */</p>
<hr />
<div>== Installation on Linux ==<br />
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.<br />
<br />
<br />
<br />
<br />
=== Installation from Git ===<br />
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.<br />
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.<br />
<br />
==== Installing compiler and autotool ====<br />
<br />
First off, install the compiler; depending on which distribution are you using, some or all of this stuff could be already installed: <br />
<br />
===== Ubuntu/Debian =====<br />
<pre><br />
sudo apt-get install make gcc g++<br />
sudo apt-get install autoconf automake autotools-dev libtool git subversion<br />
</pre><br />
<br />
===== Fedora =====<br />
<pre><br />
sudo yum install gcc gcc-c++ man-pages autoconf automake subversion libtool git<br />
</pre><br />
<br />
==== Installing prerequisite packages ====<br />
<br />
===== Ubuntu 12.04 and newer =====<br />
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:<br />
<br />
<pre><br />
sudo apt-get update<br />
sudo apt-get install \<br />
libqt4-opengl-dev \<br />
qtmobility-dev \<br />
libusb-0.1-4 \<br />
libusb-dev \<br />
libfftw3-dev \<br />
portaudio19-dev \<br />
libpulse-dev \<br />
libsamplerate0-dev \<br />
libusb-1.0-0-dev \<br />
libconfig8-dev \<br />
xdg-utils \<br />
libortp-dev \<br />
gcc-multilib \<br />
libssl-dev \<br />
libevent-dev \<br />
libglu1-mesa-dev \<br />
freeglut3-dev<br />
</pre><br />
<br />
You will need qt5 installed to complete the build.<br />
<br />
Visit: http://qt-project.org/downloads<br />
<br />
download the current package for your system.<br />
<br />
To build Qt5 on a RaspberryPi visit: http://qt-project.org/wiki/RaspberryPi<br />
<br />
After downloading it go to the download directory and do:<br />
<pre><br />
$ chmod +x the-name-of-the-downloaded-file<br />
$ sudo ./the-name-of-the-downloaded-file<br />
</pre><br />
<br />
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:<br />
<pre><br />
$ export PATH=/opt/Qt5.1.0/5.1.0/gcc_64/bin:/opt/Qt5.1.0/Tools/QtCreator/bin:$PATH<br />
</pre><br />
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.<br />
In any case please remember that<br />
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<br />
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.<br />
For the bash it is typically ~/.bashrc<br />
In any case, after you issue the export, please test it.<br />
<pre><br />
qmake -v<br />
QMake version 2.01a<br />
Using Qt version 4.8.0 in /home/andrew/QtSDK4.8x/Desktop/Qt/4.8.0/gcc/lib<br />
</pre><br />
<br />
===== Ubuntu 11.04 and older ===== <br />
First of all, you have to check that the ''universe repository'' is enabled.<br />
Please see the procedure in the previous section [[#graphical installation]] .<br />
<br />
Next, you will need the following packages installed:<br />
<br />
<pre><br />
sudo apt-get update<br />
sudo apt-get install \<br />
libqt4-opengl-dev \<br />
qtmobility-dev \<br />
libusb-0.1-4 \<br />
libusb-dev \<br />
libfftw3-dev \<br />
portaudio19-dev \<br />
libpulse-dev \<br />
libsamplerate0-dev \<br />
libusb-1.0-0-dev \<br />
libconfig8-dev \<br />
libortp-dev<br />
</pre><br />
<br />
===== Ubuntu 11.10 ===== <br />
First of all, you have to check that the ''universe repository'' is enabled.<br />
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.<br />
Next, submit the following commands into a terminal window:<br />
<br />
<pre><br />
sudo apt-get update<br />
sudo apt-get install \<br />
libqt4-opengl-dev \<br />
qtmobility-dev \<br />
libusb-0.1-4 \<br />
libusb-dev \<br />
libfftw3-dev \<br />
portaudio19-dev \<br />
libpulse-dev \<br />
libsamplerate0-dev \<br />
libusb-1.0-0-dev \<br />
libconfig8-dev \<br />
xdg-utils \<br />
libortp-dev<br />
</pre><br />
<br />
===== Fedora 16 =====<br />
<br />
<pre><br />
sudo yum install fftw fftw-devel <br />
sudo yum install libusb-devel libusb1-devel <br />
sudo yum install portaudio-devel<br />
sudo yum install libconfig-devel<br />
sudo yum install libsamplerate-devel<br />
sudo yum install pulseaudio-libs-devel<br />
sudo yum install jack-audio-connection-kit jack-audio-connection-kit-devel<br />
sudo yum install qt4-devel<br />
</pre><br />
<br />
<br />
==== Cloning the repository ====<br />
<br />
How to build the latest master branch on Ubuntu 11.04<br />
<br />
First a new libevent will need to be downloaded and installed, then the actual QtRadio source can be downloaded and built.<br />
<br />
==== Obtaining an up-level libevent library ====<br />
<br />
$ sudo apt-get install libevent-dev<br />
<br />
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)<br />
<br />
Then download the new version from:<br />
<br />
http://libevent.org/<br />
<br />
libevent-2.0.16-stable.tar.gz<br />
<br />
<pre><br />
wget https://github.com/downloads/libevent/libevent/libevent-2.0.16-stable.tar.gz<br />
</pre><br />
<br />
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:<br />
<br />
<pre><br />
cd<br />
tar -zxvf libevent-2.0.16-stable.tar.gz<br />
cd libevent-2.0.16-stable<br />
./configure<br />
make<br />
sudo make install<br />
sudo ldconfig<br />
</pre><br />
<br />
On Fedora, in order to use the library above, export the LD_LIBRARY_PATH:<br />
<br />
<pre><br />
export LD_LIBRARY_PATH=/usr/local/lib<br />
</pre><br />
<br />
==== Installing codec2 low bit rate audio encoding and decoding ====<br />
<br />
We are adding a low bit rate audio codec called codec 2 to QtRadio/dspserver. You need<br />
to download and build the codec2 library. See:<br />
<br />
http://www.rowetel.com/blog/?page_id=452<br />
<p><br />
Now go get codec2 using subversion<br />
<br />
<pre><br />
cd<br />
svn co https://freetel.svn.sourceforge.net/svnroot/freetel/codec2-dev codec2-dev<br />
cd codec2-dev<br />
autoreconf -i<br />
./configure<br />
make<br />
sudo make install<br />
sudo ldconfig<br />
</pre><br />
<br />
On Fedora, in order to use the library above, export the LD_LIBRARY_PATH:<br />
<br />
<pre><br />
export LD_LIBRARY_PATH=/usr/local/lib<br />
</pre><br />
<br />
==== Building the master branch ====<br />
<br />
This branch is the latest code that contains both RX and TX capability. <br />
<br />
Create a new directory or cd to the ~/src directory created for libevent and cd into it.<br />
<br />
<pre><br />
git clone git://github.com/alexlee188/ghpsdr3-alex<br />
</pre><br />
<br />
Depending on your Internet connection thorughput, it will take several minute to download.<br />
cd into the new directory ghpsdr3-alex:<br />
<pre><br />
cd ghpsdr3-alex<br />
git checkout master<br />
</pre><br />
You are now working with Alex's latest and greatest!<br />
<br />
First set the path to the version of qt you are using. E.g. for qt5:<br />
<pre><br />
$ export PATH=/opt/qt5/bin:$PATH<br />
</pre><br />
<br />
Then:<br />
<pre><br />
autoreconf -i<br />
./configure<br />
make -j4 all<br />
sudo make install<br />
</pre><br />
The default configure above builds with debug and default Qt4 version in your PC. For optimized executable,<br />
you need to specify options specific to your system. See the sample shell scripts that replaces the above<br />
./configure step:<br />
<br />
<pre><br />
./alex-avx-conf.sh for building with i3,i5 and i7 cpu's supporting Advanced Vector Extensions (AVX)<br />
./alex-openmp-conf.sh for building with i3,i5 and i7 cpu's and OpenMP support<br />
./alex-sse3-conf.sh for building with SSE3 capable cpu's<br />
./alex-openmp-sse3-conf.sh for building with SSE3 cpaable cpu's and OpenMP support<br />
</pre><br />
<br />
(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)<br />
<pre><br />
Terminal 1<br />
$ cd ghpsdr3-alex/trunk/src/softrock<br />
$ ./softrock ...options ...<br />
<br />
Terminal 2<br />
$ cd ghpsdr3-alex/trunk/src/dspserver<br />
$ ./dspserver ..options...<br />
<br />
Terminal 3<br />
$ cd ghpsdr3-alex/trunk/src/QtRadio<br />
$ ./QtRadio<br />
</pre><br />
<br />
==== Building the Perseus extensions ====<br />
<br />
In order to build the Microtelecom Perseus server you need to switch to the master or iw0hdv branch. <br />
<br />
First off, install the prerequisite library and wget package:<br />
<br />
<pre><br />
sudo apt-get install libboost-all-dev wget<br />
</pre><br />
<br />
Next download, compile and install the library libperseus-sdr:<br />
<br />
<pre><br />
cd<br />
wget http://libperseus-sdr.googlecode.com/files/libperseus_sdr-0.6.tar.gz<br />
tar -zxvf libperseus_sdr-0.6.tar.gz<br />
cd libperseus_sdr-0.6/<br />
./configure && make<br />
sudo make install<br />
sudo ldconfig<br />
</pre><br />
<br />
<br />
If you already build in your sandbox some other branch, is strongly advisable, before you start the build, to do a full cleanup:<br />
<pre><br />
cd ~/ghpsdr3-alex<br />
make distcheck && sh cleanup.sh<br />
</pre><br />
<br />
Otherwise, if you are starting from scratch, you have to clone the repository:<br />
<br />
<pre><br />
git clone git://github.com/alexlee188/ghpsdr3-alex<br />
</pre><br />
<br />
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.<br />
<br />
<pre><br />
cd ~/ghpsdr3-alex<br />
git checkout master<br />
autoreconf -i && ./configure && make -j4<br />
sudo make install<br />
</pre><br />
<br />
In order to run it you have two choices, the first one being the plain command line:<br />
<br />
<pre><br />
xterm -e 'perseus_server -d3 -s96000 ' &<br />
sleep 3<br />
xterm -e 'dspserver --lo 0 --nocorrectiq' &<br />
sleep 5<br />
$( QtRadio 127.0.0.1 ) <br />
</pre><br />
<br />
In QtRadio, Receiver menu, select Configure item, Server tab: here add the local host using the 127.0.0.1 IP address.<br />
Pressing the key C, you start the receiver.<br />
<br />
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.<br />
<br />
==== Building USRP enabled version ====<br />
<br />
===== Building the UHD package =====<br />
<br />
<br />
====== Install the prerequisite packages (Ubuntu 11.10): ======<br />
<br />
<pre><br />
sudo apt-get install liboost-all-dev<br />
sudo apt-get install python-cheetah<br />
</pre><br />
<br />
====== Build & Install UHD -- FOR UHD-3.3.1 AND GREATER --: ======<br />
<br />
<pre><br />
cd<br />
git clone git://ettus.sourcerepo.com/ettus/uhd.git<br />
cd uhd/host/<br />
mkdir build<br />
cd build<br />
cmake ../<br />
make<br />
make test<br />
sudo make install<br />
sudo ldconfig<br />
</pre><br />
<br />
If you already build in your sandbox some other branch, is strongly advisable, before you start the build, to do a full cleanup:<br />
<pre><br />
cd ~/ghpsdr3-alex<br />
make distcheck && sh cleanup.sh<br />
</pre><br />
<br />
Otherwise, if you are starting from scratch, first clone the repository:<br />
<br />
<pre><br />
git clone git://github.com/alexlee188/ghpsdr3-alex<br />
</pre><br />
<br />
Finally, you can switch to the master branch and rebuild everything, enabling the usrp server feature:<br />
<pre><br />
cd ~/ghpsdr3-alex<br />
git checkout usrp-server<br />
autoreconf -i && ./configure --enable-usrp=yes && make -j4<br />
sudo make install<br />
</pre><br />
<br />
==== Refresh to a Newer Version ====<br />
<br />
To pull a new version to build <br />
<pre><br />
$ git pull<br />
$ make -j4 all<br />
$ sudo make install<br />
</pre><br />
If extensive changes have occurred or if you get errors during the make, you may want to do a clean build <br />
<pre><br />
$ git pull<br />
$ make distclean<br />
$ sh cleanup.sh<br />
$ autoreconf -i<br />
$ ./configure<br />
$ make -j4 all<br />
$ sudo make install<br />
</pre><br />
If you continue to get errors, please report the whole ./configure output and the config.log to the mailing list.<br />
<br />
== Installation on Windows ==<br />
See [[ QtRadio on Windows]]<br />
<br />
== Network settings ==<br />
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.<br />
<br />
<br />
<br />
<br />
== Installing ghpsdr3-alex on Raspberry Pi == <br />
<br />
<br />
========== HARDWARE ==========<br />
<br />
*** THIS SECTION DEALS WITH Raspberry Pi DIFFERENCES *** IT DOES NOT CIRCUMVENT THE INSTRUCTIONS STARTING AT STEP 1 OF THE QtRadio Installation. ***<br />
<br />
I recommend installing either the raspbian or raspbian pisces (debian) distributions as there is no Ubuntu release to date.<br />
<br />
*** 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 <br />
document from the beginning after installing raspbian or raspbian pisces.<br />
<br />
<br />
The RasPi USB subsystem is sensitive to power supply voltage levels - A supply of 5.5V at 2A is recommended. <br />
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. <br />
<br />
Measuring the voltage across TP1 and TP2 on the Raspberry Pi and increased it to +4.97V (P.S output +5.59V).<br />
<br />
I also ran "rpi-update" which install new firmware. <br />
<br />
I shorted out the polyfuses F1 and F2 on the Pi and USB is much more stable but still limited.<br />
<br />
With keyboard, mouse, gigabit USB Ethernet, SB Live! 24 USB and RTL-SDR dongle it runs for some hours before it freezes.<br />
<br />
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.<br />
<br />
root@pisces:/usr/src/GHPSDR3_HIGH_SPEED_MASTER/ghpsdr3-alex# date<br />
<br />
Sun Sep 9 13:00:49 BST 2012<br />
<br />
root@pisces:/usr/src/GHPSDR3_HIGH_SPEED_MASTER/ghpsdr3-alex# uptime<br />
<br />
13:00:56 up 2 days, 20:46, 8 users, load average: 0.81, 1.01, 0.67<br />
<br />
<br />
<br />
<br />
****** Do not use power from a USB PC port or from a USB Hub. ********<br />
<br />
<br />
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):-<br />
<br />
Keyboard, mouse, usb sound card, RTL-SDR TV dongle and USB Gigabit Ethernet fully operational using the 7-port powered USB hub.<br />
<br />
root@pisces:~# lsusb<br />
<br />
Bus 001 Device 001: ID 1d6b:0002 Linux Foundation 2.0 root hub<br />
<br />
Bus 001 Device 002: ID 0424:9512 Standard Microsystems Corp. <br />
<br />
Bus 001 Device 003: ID 0424:ec00 Standard Microsystems Corp.<br />
<br />
Bus 001 Device 004: ID 04cc:1521 ST-Ericsson USB 2.0 Hub<br />
<br />
Bus 001 Device 011: ID 04f3:0103 Elan Microelectronics Corp. <br />
<br />
Bus 001 Device 006: ID 047d:1022 Kensington Orbit Optical<br />
<br />
Bus 001 Device 007: ID 1d19:1101 Dexatek Technology Ltd. DK DVB-T Dongle<br />
<br />
Bus 001 Device 008: ID 041e:3040 Creative Technology, Ltd SoundBlaster Live! 24-bit External SB0490<br />
<br />
Bus 001 Device 009: ID 0b95:1780 ASIX Electronics Corp. AX88178<br />
root@pisces:~# ifconfig <br />
<br />
eth0 Link encap:Ethernet HWaddr b8:27:eb:2c:07:c9<br />
<br />
inet addr:192.168.10.31 Bcast:192.168.10.255 Mask:255.255.255.0<br />
inet6 addr: fe80::ba27:ebff:fe2c:7c9/64 Scope:Link<br />
UP BROADCAST RUNNING MULTICAST MTU:1500 Metric:1<br />
RX packets:410 errors:0 dropped:0 overruns:0 frame:0<br />
TX packets:377 errors:0 dropped:0 overruns:0 carrier:0<br />
collisions:0 txqueuelen:1000<br />
RX bytes:28905 (28.2 KiB) TX bytes:35938 (35.0 KiB)<br />
<br />
eth1 Link encap:Ethernet HWaddr 00:10:14:00:9f:fa<br />
<br />
inet addr:192.168.2.199 Bcast:192.168.2.255 Mask:255.255.255.0<br />
inet6 addr: fe80::210:14ff:fe00:9ffa/64 Scope:Link<br />
UP BROADCAST RUNNING MULTICAST MTU:1500 Metric:1<br />
RX packets:5 errors:0 dropped:0 overruns:0 frame:0<br />
TX packets:7 errors:0 dropped:0 overruns:0 carrier:0<br />
collisions:0 txqueuelen:1000<br />
RX bytes:230 (230.0 B) TX bytes:592 (592.0 B)<br />
<br />
lo Link encap:Local Loopback<br />
<br />
inet addr:127.0.0.1 Mask:255.0.0.0<br />
inet6 addr: ::1/128 Scope:Host<br />
UP LOOPBACK RUNNING MTU:16436 Metric:1<br />
RX packets:0 errors:0 dropped:0 overruns:0 frame:0<br />
TX packets:0 errors:0 dropped:0 overruns:0 carrier:0<br />
collisions:0 txqueuelen:0<br />
RX bytes:0 (0.0 B) TX bytes:0 (0.0 B)<br />
<br />
root@pisces:~# cat /proc/asound/cards<br />
0 [ALSA ]: BRCM bcm2835 ALSbcm2835 ALSA - bcm2835 ALSA<br />
bcm2835 ALSA<br />
<br />
1 [External ]: USB-Audio - SB Live! 24-bit External<br />
Creative Technology SB Live! 24-bit External at usb-bcm2708_usb-1.2.2, full spe<br />
<br />
<br />
<br />
<br />
It's running at 855MHz with this config.txt file. <br />
root@pisces:~# cat /boot/config.txt<br />
<br />
over_voltage=6<br />
<br />
arm_freq=855<br />
<br />
core_freq=500<br />
<br />
sdram_freq=500<br />
<br />
<br />
root@pisces:~# cat /etc/network/interfaces<br />
<br />
Used by ifup(8) and ifdown(8). See the interfaces(5) manpage or<br />
/usr/share/doc/ifupdown/examples for more information. <br />
<br />
auto lo<br />
<br />
<br />
iface lo inet loopback<br />
<br />
<br />
File: ifcfg-eth0<br />
<br />
auto eth0<br />
<br />
iface eth0 inet static<br />
<br />
address 192.168.10.31<br />
<br />
netmask 255.255.255.0<br />
<br />
gateway 192.168.10.103<br />
<br />
<br />
auto eth1<br />
<br />
iface eth1 inet static<br />
<br />
address 192.168.2.199<br />
<br />
netmask 255.255.255.0<br />
<br />
<br />
root@pisces:~# cat /etc/modules<br />
<br />
/etc/modules: kernel modules to load at boot time.<br />
This file contains the names of kernel modules that should be loaded<br />
at boot time, one per line. Lines beginning with "#" are ignored.<br />
Parameters can be specified after the module name. <br />
<br />
loop<br />
<br />
snd-bcm2835<br />
<br />
<br />
One problem remains, no sound from the on-board chip.<br />
<br />
==VIRTUALBOX==<br />
<br />
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 [[Dspserver.conf]] file needs to be edited, and you will need to run the dspserver once within a terminal to get the instructions on setting up an SSL key pair. To do that download the [http://people.wallawalla.edu/~Rob.Frohne/ghpsdr3-alex/Ubuntu%2012.10%20ghpsdr3-alex-hermes.zip VirtualBox image], start VirtualBox, select new for the new machine, and when it asks you about the hard drive, say use existing hard drive, and select the image hard drive. After it boots up, you need to start a terminal and dspserver. It will give you a message about the SSL keys not being set up, and then you do the three commands that do that for you. after that you should be able to log out and log back in and your server should be running if all is well. You should be able to connect with QtRadio or glSDR. Some notes about running the [[Hermes]] server might be helpful to review.<br />
<br />
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, but the ghpsdr3-alex and the tools and packages needed to build it. As always, there is a trade off between ease of use, and security.<br />
<br />
== SOFTWARE == <br />
***** START AT THE BEGINNING WHEN BUILDING THE SOFTWARE -- i.e Section 1 and install all the packages recommended and do the pulseaudio setup.<br />
<br />
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.<br />
<br />
Subject: [n2adr-sdr] Raspberry Pi running ghpsdr3-alex<br />
<br />
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.<br />
<br />
<br />
autoreconf -i <br />
<br />
./configure CFLAGS='-O3 -pipe -march=armv6 -mfpu=vfp -mfloat-abi=hard' CXXFLAGS='-O3 -pipe -march=armv6 -mfpu=vfp -mfloat-abi=hard' <br />
<br />
**** Additional steps needed when building rtlsdr-server. Do these before running make ******<br />
# export ac_cv_func_malloc_0_nonnull=yes<br />
# export ac_cv_func_realloc_0_nonnull=yes<br />
<br />
<br />
make all && make all install <br />
<br />
<br />
Sound on the Raspberry Pi is still a problem I have not been able to solve.<br />
<br />
Terry (WB4JFI) suggested the following that work for him but I have had no luck with it.<br />
<br />
"amixer cset numid=3 1"<br />
<br />
Other valid numid's are 0=auto, 1=headphones and 2=hdmi.<br />
<br />
<br />
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.<br />
<br />
When a slave connected and tried changing frequency, dspserver crashed - dspserver can be a bit crash happy.<br />
<br />
The first thing I tried on the Pi was QtRadio standalone, spectrum and waterfall were OK but no sound.<br />
<br />
Just now a client using glSDR (5) is attempting to change frequency, sound went quite distorted then dspserver crashed.<br />
<br />
Restarted dspserver and QtRadio sound started very distorted before it settled down to reasonable.</div>Frohrohttps://napan.ca/ghpsdr3/index.php?title=Hermes&diff=753Hermes2013-08-26T17:00:57Z<p>Frohro: </p>
<hr />
<div>Thanks to Andrea for providing the Hermes backend for ghpsdr3-alex. <br />
There are two programs you need to start to get the server running. The first is hpsdr-server. It is the software that sets up the Hermes for action. It sends and gets data from the Hermes as shown on the [[Main Page]]. <br />
<br />
====hpsdr-server====<br />
Here is how you start the hpsdr-server from the command line. <br />
$ hpsdr-server --samplerate 48000 --hermes 16 --interface eth2<br />
<br />
Note: <br />
*you can use 48000, 96000, 192000, or 384000 for the --samplerate parameter.<br />
*the --hermes parameter is how much power Hermes will put out on transmit. The values go from 0 to 255.<br />
*the --interface parameter is the network interface that is connected to the same local area network that Hermes is connected to. It may be eth1, eth2, etc. or wlan1, wlan2, etc. You can figure out what it is by using the ifconfig command at the terminal as follows:<br />
<br />
$ ifconfig<br />
eth9 Link encap:Ethernet HWaddr 5c:26:0a:45:28:7b <br />
inet addr:192.168.2.157 Bcast:192.168.2.255 Mask:255.255.255.0<br />
inet6 addr: fe80::5e26:aff:fe45:287b/64 Scope:Link<br />
UP BROADCAST RUNNING MULTICAST MTU:1500 Metric:1<br />
RX packets:1877498 errors:0 dropped:0 overruns:0 frame:0<br />
TX packets:2572794 errors:0 dropped:0 overruns:0 carrier:0<br />
collisions:0 txqueuelen:1000 <br />
RX bytes:881124281 (881.1 MB) TX bytes:3414696100 (3.4 GB)<br />
Interrupt:20 Memory:f6900000-f6920000 <br />
<br />
lo Link encap:Local Loopback <br />
inet addr:127.0.0.1 Mask:255.0.0.0<br />
inet6 addr: ::1/128 Scope:Host<br />
UP LOOPBACK RUNNING MTU:65536 Metric:1<br />
RX packets:7758949 errors:0 dropped:0 overruns:0 frame:0<br />
TX packets:7758949 errors:0 dropped:0 overruns:0 carrier:0<br />
collisions:0 txqueuelen:0 <br />
RX bytes:4143306543 (4.1 GB) TX bytes:4143306543 (4.1 GB)<br />
<br />
wlan2 Link encap:Ethernet HWaddr 18:3d:a2:10:95:80 <br />
inet addr:192.168.2.250 Bcast:192.168.2.255 Mask:255.255.255.0<br />
inet6 addr: fe80::1a3d:a2ff:fe10:9580/64 Scope:Link<br />
UP BROADCAST RUNNING MULTICAST MTU:1500 Metric:1<br />
RX packets:3622385 errors:0 dropped:2 overruns:0 frame:0<br />
TX packets:1970372 errors:0 dropped:0 overruns:0 carrier:0<br />
collisions:0 txqueuelen:1000 <br />
RX bytes:4139564914 (4.1 GB) TX bytes:1254030073 (1.2 GB)<br />
<br />
In this case either eth9 or wlan2 could be used because my Hermes is on the 192.168.2.x network. The eth9 is an ethernet connection and wlan2 is a wireless connection.<br />
Other hpsdr-server options can be seen by using the --? option.<br />
$ hpsdr-server --?<br />
hpsdr-server: unrecognized option '--?'<br />
Usage: <br />
server --receivers N (default 1)<br />
--samplerate 48000|96000|192000|384000<br />
--dither off|on<br />
--random off|on<br />
--preamp off|on<br />
--10mhzsource atlas|penelope|mercury<br />
--122.88mhzsource atlas|penelope|mercury<br />
--micsource janus|penelope<br />
--class other|E<br />
--timing 1<br />
--metis<br />
--interface if<br />
--fpga <file name><br />
--ozyhex <file name><br />
--hermes <power 0-255><br />
<br />
====dspserver====<br />
The second program you need to start is dspserver. It processes the samples coming from hpsdr-server using dttSP and communicates with the client (QtRadio, glSDR, etc.) to determine what signal processing is wanted. <br />
Here is how you start dspserver from the command line.<br />
do dspserver --lo 0 --hpsdr --nocorrectiq --share<br />
The options are described if you use the --? command line option as follows:<br />
$ dspserver --?<br />
dspserver: unrecognized option '--?'<br />
Usage: <br />
dspserver --receivers N (default 1)<br />
--server 0.0.0.0 (default 127.0.0.1)<br />
--soundcard (machine dependent)<br />
--offset 0 <br />
--share (will register this server for other users <br />
use the default config file ~/.dspserver.conf) <br />
--lo 0 (if no LO offset desired in DDC receivers, or 9000 in softrocks<br />
--hpsdr (if using hpsdr hardware with no local mike and headphone)<br />
--hpsdrloc (if using hpsdr hardware with LOCAL mike and headphone)<br />
--nocorrectiq (select if using non QSD receivers, like Hermes, Perseus, HiQSDR, Mercury)<br />
Because the dspserver communicates with the clients and they are the most unstable as far as network connection, etc. I find that sometimes the dspserver crashes, so I have taken to making a script I call do-dspserver-hermes that contains the following to automatically restart it.<br />
<br />
#!/bin/sh<br />
while true<br />
do dspserver --lo 0 --hpsdr --nocorrectiq --share<br />
sleep 5<br />
done<br />
<br />
You have to make this executable ($ chmod 755 do-dspserver-hermes) and put it somewhere in your command search PATH.<br />
<br />
Other useful commands to google that will help you run the server on linux are nohup, top, ps and kill.</div>Frohrohttps://napan.ca/ghpsdr3/index.php?title=Hermes&diff=752Hermes2013-08-26T16:57:13Z<p>Frohro: </p>
<hr />
<div>Thanks to Andrea for providing the Hermes backend for ghpsdr3-alex. <br />
There are two programs you need to start to get the server running. The first is hpsdr-server. It is the software that sets up the Hermes for action. It sends and gets data from the Hermes as shown on the [[Main Page]]. <br />
<br />
====hpsdr-server====<br />
Here is how you start the hpsdr-server from the command line. <br />
$ hpsdr-server --samplerate 48000 --hermes 16 --interface eth2<br />
<br />
Note: <br />
*you can use 48000, 96000, 192000, or 384000 for the --samplerate parameter.<br />
*the --hermes parameter is how much power Hermes will put out on transmit. The values go from 0 to 255.<br />
*the --interface parameter is the network interface that is connected to the same local area network that Hermes is connected to. It may be eth1, eth2, etc. or wlan1, wlan2, etc. You can figure out what it is by using the ifconfig command at the terminal as follows:<br />
<br />
$ ifconfig<br />
eth9 Link encap:Ethernet HWaddr 5c:26:0a:45:28:7b <br />
inet addr:192.168.2.157 Bcast:192.168.2.255 Mask:255.255.255.0<br />
inet6 addr: fe80::5e26:aff:fe45:287b/64 Scope:Link<br />
UP BROADCAST RUNNING MULTICAST MTU:1500 Metric:1<br />
RX packets:1877498 errors:0 dropped:0 overruns:0 frame:0<br />
TX packets:2572794 errors:0 dropped:0 overruns:0 carrier:0<br />
collisions:0 txqueuelen:1000 <br />
RX bytes:881124281 (881.1 MB) TX bytes:3414696100 (3.4 GB)<br />
Interrupt:20 Memory:f6900000-f6920000 <br />
<br />
lo Link encap:Local Loopback <br />
inet addr:127.0.0.1 Mask:255.0.0.0<br />
inet6 addr: ::1/128 Scope:Host<br />
UP LOOPBACK RUNNING MTU:65536 Metric:1<br />
RX packets:7758949 errors:0 dropped:0 overruns:0 frame:0<br />
TX packets:7758949 errors:0 dropped:0 overruns:0 carrier:0<br />
collisions:0 txqueuelen:0 <br />
RX bytes:4143306543 (4.1 GB) TX bytes:4143306543 (4.1 GB)<br />
<br />
wlan2 Link encap:Ethernet HWaddr 18:3d:a2:10:95:80 <br />
inet addr:192.168.2.250 Bcast:192.168.2.255 Mask:255.255.255.0<br />
inet6 addr: fe80::1a3d:a2ff:fe10:9580/64 Scope:Link<br />
UP BROADCAST RUNNING MULTICAST MTU:1500 Metric:1<br />
RX packets:3622385 errors:0 dropped:2 overruns:0 frame:0<br />
TX packets:1970372 errors:0 dropped:0 overruns:0 carrier:0<br />
collisions:0 txqueuelen:1000 <br />
RX bytes:4139564914 (4.1 GB) TX bytes:1254030073 (1.2 GB)<br />
<br />
In this case either eth9 or wlan2 could be used because my Hermes is on the 192.168.2.x network. The eth9 is an ethernet connection and wlan2 is a wireless connection.<br />
<br />
====dspserver====<br />
The second program you need to start is dspserver. It processes the samples coming from hpsdr-server using dttSP and communicates with the client (QtRadio, glSDR, etc.) to determine what signal processing is wanted. <br />
Here is how you start dspserver from the command line.<br />
do dspserver --lo 0 --hpsdr --nocorrectiq --share<br />
The options are described if you use the --? command line option as follows:<br />
$ dspserver --?<br />
dspserver: unrecognized option '--?'<br />
Usage: <br />
dspserver --receivers N (default 1)<br />
--server 0.0.0.0 (default 127.0.0.1)<br />
--soundcard (machine dependent)<br />
--offset 0 <br />
--share (will register this server for other users <br />
use the default config file ~/.dspserver.conf) <br />
--lo 0 (if no LO offset desired in DDC receivers, or 9000 in softrocks<br />
--hpsdr (if using hpsdr hardware with no local mike and headphone)<br />
--hpsdrloc (if using hpsdr hardware with LOCAL mike and headphone)<br />
--nocorrectiq (select if using non QSD receivers, like Hermes, Perseus, HiQSDR, Mercury)<br />
Because the dspserver communicates with the clients and they are the most unstable as far as network connection, etc. I find that sometimes the dspserver crashes, so I have taken to making a script I call do-dspserver-hermes that contains the following to automatically restart it.<br />
<br />
#!/bin/sh<br />
while true<br />
do dspserver --lo 0 --hpsdr --nocorrectiq --share<br />
sleep 5<br />
done<br />
<br />
You have to make this executable ($ chmod 755 do-dspserver-hermes) and put it somewhere in your command search PATH.<br />
<br />
Other useful commands to google that will help you run the server on linux are nohup, top, ps and kill.</div>Frohrohttps://napan.ca/ghpsdr3/index.php?title=Main_Page&diff=751Main Page2013-08-26T16:43:49Z<p>Frohro: /* What is the actual ghpsdr3-alex Project software? */</p>
<hr />
<div>===[[What's New| What's New and latest news]]===<br />
=== '''The ghpsdr3-alex Project''' ===<br />
<br />
This is a modification of the excellent Software Defined Radio (SDR) software by John Melton [G0ORX/N6LYT][http://g0orx.blogspot.com]<br />
<br />
The original software by John is called ghpsdr3. We are working towards merging the two projects (ghpsdr3 and ghpsdr3-alex) source trees to a single source. However BEFORE that happens, you CANNOT mix and match programs from the two projects. See note for HPSDR hardware users below.<br />
<br />
Project README https://github.com/alexlee188/ghpsdr3-alex/blob/master/README [https://github.com/alexlee188/ghpsdr3-alex/blob/master/README]<br />
<br />
Source Code is via git at https://github.com/alexlee188/ghpsdr3-alex [https://github.com/alexlee188/ghpsdr3-alex]<br />
<br />
Discussions take place in the sdr-widget group http://groups.google.com/group/sdr-widget [http://groups.google.com/group/sdr-widget]<br />
<br />
You can browse the list of online dspservers at http://qtradio.napan.ca/qtradio/qtradio.pl[http://qtradio.napan.ca/qtradio/qtradio.pl]<br />
<br />
You can view the map of online dspservers worldwide at http://www.montefusco.com/ghpsdr3[http://www.montefusco.com/ghpsdr3]<br />
<br />
Currently it supports HPSDR, Softrock, UHFSDR, Microtelecom Perseus, SDR-iq, HiQSDR, Ettus Research USRP and [[RTL-SDR|rtl-sdr]] DVB-T dongles.<br />
<br />
=== '''What is the actual ghpsdr3-alex Project software?''' ===<br />
<br />
The software comprises 3 different components:<br />
<br />
'''A)''' server - there is a CLI based server for each type of hardware. For example, there are hpsdr-server, usrp-server, softrock (server), sdriq-server, HiQSDR etc. Some servers are based on soundcard/USB connections to the hardware. Some are connected via ethernet (eg HPSDR Metis).<br />
<br />
'''B)''' dspserver - this is the software in the middle that processes the IQ data from the server (connected over LAN via UDP) using DttSP. The same dspserver can connect to any of the servers in A.<br />
<br />
'''C)''' clients - this is the GUI user interface. There are clients built with Qt and runs on Windows, Linux, and Mac OSX. There is a working Android client that works on Android phones and Android tablets. The clients connect to dspserver via LAN or remotely via Internet. In future we will have java based web clients as well (either specifically written clients, or running Qt inside a web browser) Also, multiple clients can concurrently access the same dspserver. There is also RxTx capability (currently for voice modes). the QtRadio client has a Hamlib interface and can connect to gPredict, xLog, and fldigi (for digital mode)<br />
<br />
[[File:463px-Ghpsdr3.png]]<br />
<br />
'''Project Goals'''<br />
<br />
1. Open source (GPL) SDR software<br />
<br />
2. Client-server network-enabled by design from the ground up<br />
<br />
3. Customized server for each SDR hardware type. Currently supporting HPSDR, Softrock, UHFSDR, Microtelecom Perseus, RFSPACE SDR-IQ, HiQSDR, Ettus Research USRP, and the rtl-sdr DVB-T dongle.<br />
<br />
4. Single dspserver that connects to single server. However, each server can have multiple Rx and Tx channels.<br />
<br />
5. Multiple clients, such as QtRadio, that can concurrently connect to a single dspserver.<br />
<br />
6. Full Rx and Tx capability for hardware capable of Tx<br />
<br />
<br />
<br />
*[[Screenshots and Recordings]] <br />
*[[QtRadio on Windows]]<br />
*[[QtRadio - Operation]]<br />
*[[QtRadio Installation]]<br />
*[[aHPSDR]] Android Client<br />
*[[Pulseaudio Setup]]<br />
*[[Developers Documentation]]<br />
*[[ToDo/- Wishlist]]<br />
*[[dspserver.conf]]<br />
<br />
<br />
'''Note for HPSDR and ghpsdr3 (original) users:'''<br />
In general, you cannot mix and match software from the two projects, ghpsdr3 and ghpsdr3-alex. However, John has updated the programs in the ghpsdr3-alex repository, and the hpsdr-server program in gphsdr3-alex works for HPSDR hardware. The following newbie guide is written by Erich Heinzle (vk5hse at yahoo.com):<br />
<br />
http://openhpsdr.org/wiki/images/6/63/NewbieGuide.pdf</div>Frohrohttps://napan.ca/ghpsdr3/index.php?title=File:463px-Ghpsdr3.png&diff=750File:463px-Ghpsdr3.png2013-08-26T16:42:13Z<p>Frohro: Block Diagram of ghpsdr3-alex</p>
<hr />
<div>Block Diagram of ghpsdr3-alex</div>Frohrohttps://napan.ca/ghpsdr3/index.php?title=Hermes&diff=749Hermes2013-08-26T16:29:26Z<p>Frohro: </p>
<hr />
<div>Thanks to Andrea for providing the Hermes backend for ghpsdr3-alex. Here is how you start the server from the command line.<br />
<br />
$ hpsdr-server --samplerate 48000 --hermes 16 --interface eth2<br />
<br />
Note: <br />
*you can use 48000, 96000, 192000, or 384000 for the --samplerate parameter.<br />
*the --hermes parameter is how much power Hermes will put out on transmit. The values go from 0 to 255.<br />
*the --interface parameter is the network interface that is connected to the same local area network that Hermes is connected to. It may be eth1, eth2, etc. or wlan1, wlan2, etc. You can figure out what it is by using the ifconfig command at the terminal as follows:<br />
<br />
$ ifconfig<br />
eth9 Link encap:Ethernet HWaddr 5c:26:0a:45:28:7b <br />
inet addr:192.168.2.157 Bcast:192.168.2.255 Mask:255.255.255.0<br />
inet6 addr: fe80::5e26:aff:fe45:287b/64 Scope:Link<br />
UP BROADCAST RUNNING MULTICAST MTU:1500 Metric:1<br />
RX packets:1877498 errors:0 dropped:0 overruns:0 frame:0<br />
TX packets:2572794 errors:0 dropped:0 overruns:0 carrier:0<br />
collisions:0 txqueuelen:1000 <br />
RX bytes:881124281 (881.1 MB) TX bytes:3414696100 (3.4 GB)<br />
Interrupt:20 Memory:f6900000-f6920000 <br />
<br />
lo Link encap:Local Loopback <br />
inet addr:127.0.0.1 Mask:255.0.0.0<br />
inet6 addr: ::1/128 Scope:Host<br />
UP LOOPBACK RUNNING MTU:65536 Metric:1<br />
RX packets:7758949 errors:0 dropped:0 overruns:0 frame:0<br />
TX packets:7758949 errors:0 dropped:0 overruns:0 carrier:0<br />
collisions:0 txqueuelen:0 <br />
RX bytes:4143306543 (4.1 GB) TX bytes:4143306543 (4.1 GB)<br />
<br />
wlan2 Link encap:Ethernet HWaddr 18:3d:a2:10:95:80 <br />
inet addr:192.168.2.250 Bcast:192.168.2.255 Mask:255.255.255.0<br />
inet6 addr: fe80::1a3d:a2ff:fe10:9580/64 Scope:Link<br />
UP BROADCAST RUNNING MULTICAST MTU:1500 Metric:1<br />
RX packets:3622385 errors:0 dropped:2 overruns:0 frame:0<br />
TX packets:1970372 errors:0 dropped:0 overruns:0 carrier:0<br />
collisions:0 txqueuelen:1000 <br />
RX bytes:4139564914 (4.1 GB) TX bytes:1254030073 (1.2 GB)<br />
<br />
In this case either eth9 or wlan2 could be used because my Hermes is on the 192.168.2.x network. The eth9 is an ethernet connection and wlan2 is a wireless connection.</div>Frohrohttps://napan.ca/ghpsdr3/index.php?title=Hermes&diff=748Hermes2013-08-26T16:28:48Z<p>Frohro: Created page with "Thanks to Andrea for providing the Hermes backend for ghpsdr3-alex. Here is how you start the server from the command line. $ hpsdr-server --samplerate 48000 --hermes 16 --..."</p>
<hr />
<div>Thanks to Andrea for providing the Hermes backend for ghpsdr3-alex. Here is how you start the server from the command line.<br />
<br />
$ hpsdr-server --samplerate 48000 --hermes 16 --interface eth2<br />
<br />
Note: <br />
*you can use 48000, 96000, 192000, or 384000 for the --samplerate parameter.<br />
*the --hermes parameter is how much power Hermes will put out on transmit. The values go from 0 to 255.<br />
*the --interface parameter is the network interface that is connected to the same local area network that Hermes is connected to. It may be eth1, eth2, etc. or wlan1, wlan2, etc. You can figure out what it is by using the ifconfig command at the terminal as follows:<br />
<br />
$ ifconfig<br />
eth9 Link encap:Ethernet HWaddr 5c:26:0a:45:28:7b <br />
inet addr:192.168.2.157 Bcast:192.168.2.255 Mask:255.255.255.0<br />
inet6 addr: fe80::5e26:aff:fe45:287b/64 Scope:Link<br />
UP BROADCAST RUNNING MULTICAST MTU:1500 Metric:1<br />
RX packets:1877498 errors:0 dropped:0 overruns:0 frame:0<br />
TX packets:2572794 errors:0 dropped:0 overruns:0 carrier:0<br />
collisions:0 txqueuelen:1000 <br />
RX bytes:881124281 (881.1 MB) TX bytes:3414696100 (3.4 GB)<br />
Interrupt:20 Memory:f6900000-f6920000 <br />
<br />
lo Link encap:Local Loopback <br />
inet addr:127.0.0.1 Mask:255.0.0.0<br />
inet6 addr: ::1/128 Scope:Host<br />
UP LOOPBACK RUNNING MTU:65536 Metric:1<br />
RX packets:7758949 errors:0 dropped:0 overruns:0 frame:0<br />
TX packets:7758949 errors:0 dropped:0 overruns:0 carrier:0<br />
collisions:0 txqueuelen:0 <br />
RX bytes:4143306543 (4.1 GB) TX bytes:4143306543 (4.1 GB)<br />
<br />
wlan2 Link encap:Ethernet HWaddr 18:3d:a2:10:95:80 <br />
inet addr:192.168.2.250 Bcast:192.168.2.255 Mask:255.255.255.0<br />
inet6 addr: fe80::1a3d:a2ff:fe10:9580/64 Scope:Link<br />
UP BROADCAST RUNNING MULTICAST MTU:1500 Metric:1<br />
RX packets:3622385 errors:0 dropped:2 overruns:0 frame:0<br />
TX packets:1970372 errors:0 dropped:0 overruns:0 carrier:0<br />
collisions:0 txqueuelen:1000 <br />
RX bytes:4139564914 (4.1 GB) TX bytes:1254030073 (1.2 GB)<br />
<br />
In this case either eth9 or wlan2 could be used because my Hermes is on the 192.168.2.x network. The eth9 is an ethernet connection and wlan2 is a wireless connection.</div>Frohrohttps://napan.ca/ghpsdr3/index.php?title=QtRadio_Installation&diff=747QtRadio Installation2013-08-26T16:14:55Z<p>Frohro: /* VIRTUALBOX */</p>
<hr />
<div>== Installation on Linux ==<br />
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.<br />
<br />
<br />
<br />
<br />
=== Installation from Git ===<br />
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.<br />
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.<br />
<br />
==== Installing compiler and autotool ====<br />
<br />
First off, install the compiler; depending on which distribution are you using, some or all of this stuff could be already installed: <br />
<br />
===== Ubuntu/Debian =====<br />
<pre><br />
sudo apt-get install make gcc g++<br />
sudo apt-get install autoconf automake autotools-dev libtool git subversion<br />
</pre><br />
<br />
===== Fedora =====<br />
<pre><br />
sudo yum install gcc gcc-c++ man-pages autoconf automake subversion libtool git<br />
</pre><br />
<br />
==== Installing prerequisite packages ====<br />
<br />
===== Ubuntu 12.04 and newer =====<br />
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:<br />
<br />
<pre><br />
sudo apt-get update<br />
sudo apt-get install \<br />
libqt4-opengl-dev \<br />
qtmobility-dev \<br />
libusb-0.1-4 \<br />
libusb-dev \<br />
libfftw3-dev \<br />
portaudio19-dev \<br />
libpulse-dev \<br />
libsamplerate0-dev \<br />
libusb-1.0-0-dev \<br />
libconfig8-dev \<br />
xdg-utils \<br />
libortp-dev \<br />
gcc-multilib \<br />
libssl-dev \<br />
libevent-dev \<br />
libglu1-mesa-dev \<br />
freeglut3-dev<br />
</pre><br />
<br />
You will need qt5 installed to complete the build.<br />
<br />
Visit: http://qt-project.org/downloads<br />
<br />
download the current package for your system.<br />
<br />
To build Qt5 on a RaspberryPi visit: http://qt-project.org/wiki/RaspberryPi<br />
<br />
After downloading it go to the download directory and do:<br />
<pre><br />
$ chmod +x the-name-of-the-downloaded-file<br />
$ sudo ./the-name-of-the-downloaded-file<br />
</pre><br />
<br />
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:<br />
<pre><br />
$ export PATH=/opt/Qt5.1.0/5.1.0/gcc_64/bin:/opt/Qt5.1.0/Tools/QtCreator/bin:$PATH<br />
</pre><br />
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.<br />
In any case please remember that<br />
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<br />
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.<br />
For the bash it is typically ~/.bashrc<br />
In any case, after you issue the export, please test it.<br />
<pre><br />
qmake -v<br />
QMake version 2.01a<br />
Using Qt version 4.8.0 in /home/andrew/QtSDK4.8x/Desktop/Qt/4.8.0/gcc/lib<br />
</pre><br />
<br />
===== Ubuntu 11.04 and older ===== <br />
First of all, you have to check that the ''universe repository'' is enabled.<br />
Please see the procedure in the previous section [[#graphical installation]] .<br />
<br />
Next, you will need the following packages installed:<br />
<br />
<pre><br />
sudo apt-get update<br />
sudo apt-get install \<br />
libqt4-opengl-dev \<br />
qtmobility-dev \<br />
libusb-0.1-4 \<br />
libusb-dev \<br />
libfftw3-dev \<br />
portaudio19-dev \<br />
libpulse-dev \<br />
libsamplerate0-dev \<br />
libusb-1.0-0-dev \<br />
libconfig8-dev \<br />
libortp-dev<br />
</pre><br />
<br />
===== Ubuntu 11.10 ===== <br />
First of all, you have to check that the ''universe repository'' is enabled.<br />
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.<br />
Next, submit the following commands into a terminal window:<br />
<br />
<pre><br />
sudo apt-get update<br />
sudo apt-get install \<br />
libqt4-opengl-dev \<br />
qtmobility-dev \<br />
libusb-0.1-4 \<br />
libusb-dev \<br />
libfftw3-dev \<br />
portaudio19-dev \<br />
libpulse-dev \<br />
libsamplerate0-dev \<br />
libusb-1.0-0-dev \<br />
libconfig8-dev \<br />
xdg-utils \<br />
libortp-dev<br />
</pre><br />
<br />
===== Fedora 16 =====<br />
<br />
<pre><br />
sudo yum install fftw fftw-devel <br />
sudo yum install libusb-devel libusb1-devel <br />
sudo yum install portaudio-devel<br />
sudo yum install libconfig-devel<br />
sudo yum install libsamplerate-devel<br />
sudo yum install pulseaudio-libs-devel<br />
sudo yum install jack-audio-connection-kit jack-audio-connection-kit-devel<br />
sudo yum install qt4-devel<br />
</pre><br />
<br />
<br />
==== Cloning the repository ====<br />
<br />
How to build the latest master branch on Ubuntu 11.04<br />
<br />
First a new libevent will need to be downloaded and installed, then the actual QtRadio source can be downloaded and built.<br />
<br />
==== Obtaining an up-level libevent library ====<br />
<br />
$ sudo apt-get install libevent-dev<br />
<br />
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)<br />
<br />
Then download the new version from:<br />
<br />
http://libevent.org/<br />
<br />
libevent-2.0.16-stable.tar.gz<br />
<br />
<pre><br />
wget https://github.com/downloads/libevent/libevent/libevent-2.0.16-stable.tar.gz<br />
</pre><br />
<br />
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:<br />
<br />
<pre><br />
cd<br />
tar -zxvf libevent-2.0.16-stable.tar.gz<br />
cd libevent-2.0.16-stable<br />
./configure<br />
make<br />
sudo make install<br />
sudo ldconfig<br />
</pre><br />
<br />
On Fedora, in order to use the library above, export the LD_LIBRARY_PATH:<br />
<br />
<pre><br />
export LD_LIBRARY_PATH=/usr/local/lib<br />
</pre><br />
<br />
==== Installing codec2 low bit rate audio encoding and decoding ====<br />
<br />
We are adding a low bit rate audio codec called codec 2 to QtRadio/dspserver. You need<br />
to download and build the codec2 library. See:<br />
<br />
http://www.rowetel.com/blog/?page_id=452<br />
<p><br />
Now go get codec2 using subversion<br />
<br />
<pre><br />
cd<br />
svn co https://freetel.svn.sourceforge.net/svnroot/freetel/codec2-dev codec2-dev<br />
cd codec2-dev<br />
autoreconf -i<br />
./configure<br />
make<br />
sudo make install<br />
sudo ldconfig<br />
</pre><br />
<br />
On Fedora, in order to use the library above, export the LD_LIBRARY_PATH:<br />
<br />
<pre><br />
export LD_LIBRARY_PATH=/usr/local/lib<br />
</pre><br />
<br />
==== Building the master branch ====<br />
<br />
This branch is the latest code that contains both RX and TX capability. <br />
<br />
Create a new directory or cd to the ~/src directory created for libevent and cd into it.<br />
<br />
<pre><br />
git clone git://github.com/alexlee188/ghpsdr3-alex<br />
</pre><br />
<br />
Depending on your Internet connection thorughput, it will take several minute to download.<br />
cd into the new directory ghpsdr3-alex:<br />
<pre><br />
cd ghpsdr3-alex<br />
git checkout master<br />
</pre><br />
You are now working with Alex's latest and greatest!<br />
<br />
First set the path to the version of qt you are using. E.g. for qt5:<br />
<pre><br />
$ export PATH=/opt/qt5/bin:$PATH<br />
</pre><br />
<br />
Then:<br />
<pre><br />
autoreconf -i<br />
./configure<br />
make -j4 all<br />
sudo make install<br />
</pre><br />
The default configure above builds with debug and default Qt4 version in your PC. For optimized executable,<br />
you need to specify options specific to your system. See the sample shell scripts that replaces the above<br />
./configure step:<br />
<br />
<pre><br />
./alex-avx-conf.sh for building with i3,i5 and i7 cpu's supporting Advanced Vector Extensions (AVX)<br />
./alex-openmp-conf.sh for building with i3,i5 and i7 cpu's and OpenMP support<br />
./alex-sse3-conf.sh for building with SSE3 capable cpu's<br />
./alex-openmp-sse3-conf.sh for building with SSE3 cpaable cpu's and OpenMP support<br />
</pre><br />
<br />
(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)<br />
<pre><br />
Terminal 1<br />
$ cd ghpsdr3-alex/trunk/src/softrock<br />
$ ./softrock ...options ...<br />
<br />
Terminal 2<br />
$ cd ghpsdr3-alex/trunk/src/dspserver<br />
$ ./dspserver ..options...<br />
<br />
Terminal 3<br />
$ cd ghpsdr3-alex/trunk/src/QtRadio<br />
$ ./QtRadio<br />
</pre><br />
<br />
==== Building the Perseus extensions ====<br />
<br />
In order to build the Microtelecom Perseus server you need to switch to the master or iw0hdv branch. <br />
<br />
First off, install the prerequisite library and wget package:<br />
<br />
<pre><br />
sudo apt-get install libboost-all-dev wget<br />
</pre><br />
<br />
Next download, compile and install the library libperseus-sdr:<br />
<br />
<pre><br />
cd<br />
wget http://libperseus-sdr.googlecode.com/files/libperseus_sdr-0.6.tar.gz<br />
tar -zxvf libperseus_sdr-0.6.tar.gz<br />
cd libperseus_sdr-0.6/<br />
./configure && make<br />
sudo make install<br />
sudo ldconfig<br />
</pre><br />
<br />
<br />
If you already build in your sandbox some other branch, is strongly advisable, before you start the build, to do a full cleanup:<br />
<pre><br />
cd ~/ghpsdr3-alex<br />
make distcheck && sh cleanup.sh<br />
</pre><br />
<br />
Otherwise, if you are starting from scratch, you have to clone the repository:<br />
<br />
<pre><br />
git clone git://github.com/alexlee188/ghpsdr3-alex<br />
</pre><br />
<br />
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.<br />
<br />
<pre><br />
cd ~/ghpsdr3-alex<br />
git checkout master<br />
autoreconf -i && ./configure && make -j4<br />
sudo make install<br />
</pre><br />
<br />
In order to run it you have two choices, the first one being the plain command line:<br />
<br />
<pre><br />
xterm -e 'perseus_server -d3 -s96000 ' &<br />
sleep 3<br />
xterm -e 'dspserver --lo 0 --nocorrectiq' &<br />
sleep 5<br />
$( QtRadio 127.0.0.1 ) <br />
</pre><br />
<br />
In QtRadio, Receiver menu, select Configure item, Server tab: here add the local host using the 127.0.0.1 IP address.<br />
Pressing the key C, you start the receiver.<br />
<br />
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.<br />
<br />
==== Building USRP enabled version ====<br />
<br />
===== Building the UHD package =====<br />
<br />
<br />
====== Install the prerequisite packages (Ubuntu 11.10): ======<br />
<br />
<pre><br />
sudo apt-get install liboost-all-dev<br />
sudo apt-get install python-cheetah<br />
</pre><br />
<br />
====== Build & Install UHD -- FOR UHD-3.3.1 AND GREATER --: ======<br />
<br />
<pre><br />
cd<br />
git clone git://ettus.sourcerepo.com/ettus/uhd.git<br />
cd uhd/host/<br />
mkdir build<br />
cd build<br />
cmake ../<br />
make<br />
make test<br />
sudo make install<br />
sudo ldconfig<br />
</pre><br />
<br />
If you already build in your sandbox some other branch, is strongly advisable, before you start the build, to do a full cleanup:<br />
<pre><br />
cd ~/ghpsdr3-alex<br />
make distcheck && sh cleanup.sh<br />
</pre><br />
<br />
Otherwise, if you are starting from scratch, first clone the repository:<br />
<br />
<pre><br />
git clone git://github.com/alexlee188/ghpsdr3-alex<br />
</pre><br />
<br />
Finally, you can switch to the master branch and rebuild everything, enabling the usrp server feature:<br />
<pre><br />
cd ~/ghpsdr3-alex<br />
git checkout usrp-server<br />
autoreconf -i && ./configure --enable-usrp=yes && make -j4<br />
sudo make install<br />
</pre><br />
<br />
==== Refresh to a Newer Version ====<br />
<br />
To pull a new version to build <br />
<pre><br />
$ git pull<br />
$ make -j4 all<br />
$ sudo make install<br />
</pre><br />
If extensive changes have occurred or if you get errors during the make, you may want to do a clean build <br />
<pre><br />
$ git pull<br />
$ make distclean<br />
$ sh cleanup.sh<br />
$ autoreconf -i<br />
$ ./configure<br />
$ make -j4 all<br />
$ sudo make install<br />
</pre><br />
If you continue to get errors, please report the whole ./configure output and the config.log to the mailing list.<br />
<br />
== Installation on Windows ==<br />
See [[ QtRadio on Windows]]<br />
<br />
== Network settings ==<br />
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.<br />
<br />
<br />
<br />
<br />
== Installing ghpsdr3-alex on Raspberry Pi == <br />
<br />
<br />
========== HARDWARE ==========<br />
<br />
*** THIS SECTION DEALS WITH Raspberry Pi DIFFERENCES *** IT DOES NOT CIRCUMVENT THE INSTRUCTIONS STARTING AT STEP 1 OF THE QtRadio Installation. ***<br />
<br />
I recommend installing either the raspbian or raspbian pisces (debian) distributions as there is no Ubuntu release to date.<br />
<br />
*** 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 <br />
document from the beginning after installing raspbian or raspbian pisces.<br />
<br />
<br />
The RasPi USB subsystem is sensitive to power supply voltage levels - A supply of 5.5V at 2A is recommended. <br />
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. <br />
<br />
Measuring the voltage across TP1 and TP2 on the Raspberry Pi and increased it to +4.97V (P.S output +5.59V).<br />
<br />
I also ran "rpi-update" which install new firmware. <br />
<br />
I shorted out the polyfuses F1 and F2 on the Pi and USB is much more stable but still limited.<br />
<br />
With keyboard, mouse, gigabit USB Ethernet, SB Live! 24 USB and RTL-SDR dongle it runs for some hours before it freezes.<br />
<br />
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.<br />
<br />
root@pisces:/usr/src/GHPSDR3_HIGH_SPEED_MASTER/ghpsdr3-alex# date<br />
<br />
Sun Sep 9 13:00:49 BST 2012<br />
<br />
root@pisces:/usr/src/GHPSDR3_HIGH_SPEED_MASTER/ghpsdr3-alex# uptime<br />
<br />
13:00:56 up 2 days, 20:46, 8 users, load average: 0.81, 1.01, 0.67<br />
<br />
<br />
<br />
<br />
****** Do not use power from a USB PC port or from a USB Hub. ********<br />
<br />
<br />
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):-<br />
<br />
Keyboard, mouse, usb sound card, RTL-SDR TV dongle and USB Gigabit Ethernet fully operational using the 7-port powered USB hub.<br />
<br />
root@pisces:~# lsusb<br />
<br />
Bus 001 Device 001: ID 1d6b:0002 Linux Foundation 2.0 root hub<br />
<br />
Bus 001 Device 002: ID 0424:9512 Standard Microsystems Corp. <br />
<br />
Bus 001 Device 003: ID 0424:ec00 Standard Microsystems Corp.<br />
<br />
Bus 001 Device 004: ID 04cc:1521 ST-Ericsson USB 2.0 Hub<br />
<br />
Bus 001 Device 011: ID 04f3:0103 Elan Microelectronics Corp. <br />
<br />
Bus 001 Device 006: ID 047d:1022 Kensington Orbit Optical<br />
<br />
Bus 001 Device 007: ID 1d19:1101 Dexatek Technology Ltd. DK DVB-T Dongle<br />
<br />
Bus 001 Device 008: ID 041e:3040 Creative Technology, Ltd SoundBlaster Live! 24-bit External SB0490<br />
<br />
Bus 001 Device 009: ID 0b95:1780 ASIX Electronics Corp. AX88178<br />
root@pisces:~# ifconfig <br />
<br />
eth0 Link encap:Ethernet HWaddr b8:27:eb:2c:07:c9<br />
<br />
inet addr:192.168.10.31 Bcast:192.168.10.255 Mask:255.255.255.0<br />
inet6 addr: fe80::ba27:ebff:fe2c:7c9/64 Scope:Link<br />
UP BROADCAST RUNNING MULTICAST MTU:1500 Metric:1<br />
RX packets:410 errors:0 dropped:0 overruns:0 frame:0<br />
TX packets:377 errors:0 dropped:0 overruns:0 carrier:0<br />
collisions:0 txqueuelen:1000<br />
RX bytes:28905 (28.2 KiB) TX bytes:35938 (35.0 KiB)<br />
<br />
eth1 Link encap:Ethernet HWaddr 00:10:14:00:9f:fa<br />
<br />
inet addr:192.168.2.199 Bcast:192.168.2.255 Mask:255.255.255.0<br />
inet6 addr: fe80::210:14ff:fe00:9ffa/64 Scope:Link<br />
UP BROADCAST RUNNING MULTICAST MTU:1500 Metric:1<br />
RX packets:5 errors:0 dropped:0 overruns:0 frame:0<br />
TX packets:7 errors:0 dropped:0 overruns:0 carrier:0<br />
collisions:0 txqueuelen:1000<br />
RX bytes:230 (230.0 B) TX bytes:592 (592.0 B)<br />
<br />
lo Link encap:Local Loopback<br />
<br />
inet addr:127.0.0.1 Mask:255.0.0.0<br />
inet6 addr: ::1/128 Scope:Host<br />
UP LOOPBACK RUNNING MTU:16436 Metric:1<br />
RX packets:0 errors:0 dropped:0 overruns:0 frame:0<br />
TX packets:0 errors:0 dropped:0 overruns:0 carrier:0<br />
collisions:0 txqueuelen:0<br />
RX bytes:0 (0.0 B) TX bytes:0 (0.0 B)<br />
<br />
root@pisces:~# cat /proc/asound/cards<br />
0 [ALSA ]: BRCM bcm2835 ALSbcm2835 ALSA - bcm2835 ALSA<br />
bcm2835 ALSA<br />
<br />
1 [External ]: USB-Audio - SB Live! 24-bit External<br />
Creative Technology SB Live! 24-bit External at usb-bcm2708_usb-1.2.2, full spe<br />
<br />
<br />
<br />
<br />
It's running at 855MHz with this config.txt file. <br />
root@pisces:~# cat /boot/config.txt<br />
<br />
over_voltage=6<br />
<br />
arm_freq=855<br />
<br />
core_freq=500<br />
<br />
sdram_freq=500<br />
<br />
<br />
root@pisces:~# cat /etc/network/interfaces<br />
<br />
Used by ifup(8) and ifdown(8). See the interfaces(5) manpage or<br />
/usr/share/doc/ifupdown/examples for more information. <br />
<br />
auto lo<br />
<br />
<br />
iface lo inet loopback<br />
<br />
<br />
File: ifcfg-eth0<br />
<br />
auto eth0<br />
<br />
iface eth0 inet static<br />
<br />
address 192.168.10.31<br />
<br />
netmask 255.255.255.0<br />
<br />
gateway 192.168.10.103<br />
<br />
<br />
auto eth1<br />
<br />
iface eth1 inet static<br />
<br />
address 192.168.2.199<br />
<br />
netmask 255.255.255.0<br />
<br />
<br />
root@pisces:~# cat /etc/modules<br />
<br />
/etc/modules: kernel modules to load at boot time.<br />
This file contains the names of kernel modules that should be loaded<br />
at boot time, one per line. Lines beginning with "#" are ignored.<br />
Parameters can be specified after the module name. <br />
<br />
loop<br />
<br />
snd-bcm2835<br />
<br />
<br />
One problem remains, no sound from the on-board chip.<br />
<br />
==VIRTUALBOX==<br />
<br />
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 [[Dspserver.conf]] file needs to be edited, and you will need to run the dspserver once within a terminal to get the instructions on setting up an SSL key pair. To do that download the [http://people.wallawalla.edu/~Rob.Frohne/ghpsdr3-alex/Ubuntu%2012.10%20ghpsdr3-alex-hermes.zip VirtualBox image], start VirtualBox, select new for the new machine, and when it asks you about the hard drive, say use existing hard drive, and select the image hard drive. After it boots up, you need to start a terminal and dspserver. It will give you a message about the SSL keys not being set up, and then you do the three commands that do that for you. after that you should be able to log out and log back in and your server should be running if all is well. You should be able to connect with QtRadio or glSDR. Some notes about running the [[Hermes]] server might be helpful to review.<br />
<br />
== SOFTWARE == <br />
***** START AT THE BEGINNING WHEN BUILDING THE SOFTWARE -- i.e Section 1 and install all the packages recommended and do the pulseaudio setup.<br />
<br />
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.<br />
<br />
Subject: [n2adr-sdr] Raspberry Pi running ghpsdr3-alex<br />
<br />
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.<br />
<br />
<br />
autoreconf -i <br />
<br />
./configure CFLAGS='-O3 -pipe -march=armv6 -mfpu=vfp -mfloat-abi=hard' CXXFLAGS='-O3 -pipe -march=armv6 -mfpu=vfp -mfloat-abi=hard' <br />
<br />
**** Additional steps needed when building rtlsdr-server. Do these before running make ******<br />
# export ac_cv_func_malloc_0_nonnull=yes<br />
# export ac_cv_func_realloc_0_nonnull=yes<br />
<br />
<br />
make all && make all install <br />
<br />
<br />
Sound on the Raspberry Pi is still a problem I have not been able to solve.<br />
<br />
Terry (WB4JFI) suggested the following that work for him but I have had no luck with it.<br />
<br />
"amixer cset numid=3 1"<br />
<br />
Other valid numid's are 0=auto, 1=headphones and 2=hdmi.<br />
<br />
<br />
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.<br />
<br />
When a slave connected and tried changing frequency, dspserver crashed - dspserver can be a bit crash happy.<br />
<br />
The first thing I tried on the Pi was QtRadio standalone, spectrum and waterfall were OK but no sound.<br />
<br />
Just now a client using glSDR (5) is attempting to change frequency, sound went quite distorted then dspserver crashed.<br />
<br />
Restarted dspserver and QtRadio sound started very distorted before it settled down to reasonable.</div>Frohrohttps://napan.ca/ghpsdr3/index.php?title=QtRadio_Installation&diff=746QtRadio Installation2013-08-26T16:05:35Z<p>Frohro: /* VIRTUALBOX */</p>
<hr />
<div>== Installation on Linux ==<br />
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.<br />
<br />
<br />
<br />
<br />
=== Installation from Git ===<br />
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.<br />
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.<br />
<br />
==== Installing compiler and autotool ====<br />
<br />
First off, install the compiler; depending on which distribution are you using, some or all of this stuff could be already installed: <br />
<br />
===== Ubuntu/Debian =====<br />
<pre><br />
sudo apt-get install make gcc g++<br />
sudo apt-get install autoconf automake autotools-dev libtool git subversion<br />
</pre><br />
<br />
===== Fedora =====<br />
<pre><br />
sudo yum install gcc gcc-c++ man-pages autoconf automake subversion libtool git<br />
</pre><br />
<br />
==== Installing prerequisite packages ====<br />
<br />
===== Ubuntu 12.04 and newer =====<br />
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:<br />
<br />
<pre><br />
sudo apt-get update<br />
sudo apt-get install \<br />
libqt4-opengl-dev \<br />
qtmobility-dev \<br />
libusb-0.1-4 \<br />
libusb-dev \<br />
libfftw3-dev \<br />
portaudio19-dev \<br />
libpulse-dev \<br />
libsamplerate0-dev \<br />
libusb-1.0-0-dev \<br />
libconfig8-dev \<br />
xdg-utils \<br />
libortp-dev \<br />
gcc-multilib \<br />
libssl-dev \<br />
libevent-dev \<br />
libglu1-mesa-dev \<br />
freeglut3-dev<br />
</pre><br />
<br />
You will need qt5 installed to complete the build.<br />
<br />
Visit: http://qt-project.org/downloads<br />
<br />
download the current package for your system.<br />
<br />
To build Qt5 on a RaspberryPi visit: http://qt-project.org/wiki/RaspberryPi<br />
<br />
After downloading it go to the download directory and do:<br />
<pre><br />
$ chmod +x the-name-of-the-downloaded-file<br />
$ sudo ./the-name-of-the-downloaded-file<br />
</pre><br />
<br />
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:<br />
<pre><br />
$ export PATH=/opt/Qt5.1.0/5.1.0/gcc_64/bin:/opt/Qt5.1.0/Tools/QtCreator/bin:$PATH<br />
</pre><br />
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.<br />
In any case please remember that<br />
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<br />
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.<br />
For the bash it is typically ~/.bashrc<br />
In any case, after you issue the export, please test it.<br />
<pre><br />
qmake -v<br />
QMake version 2.01a<br />
Using Qt version 4.8.0 in /home/andrew/QtSDK4.8x/Desktop/Qt/4.8.0/gcc/lib<br />
</pre><br />
<br />
===== Ubuntu 11.04 and older ===== <br />
First of all, you have to check that the ''universe repository'' is enabled.<br />
Please see the procedure in the previous section [[#graphical installation]] .<br />
<br />
Next, you will need the following packages installed:<br />
<br />
<pre><br />
sudo apt-get update<br />
sudo apt-get install \<br />
libqt4-opengl-dev \<br />
qtmobility-dev \<br />
libusb-0.1-4 \<br />
libusb-dev \<br />
libfftw3-dev \<br />
portaudio19-dev \<br />
libpulse-dev \<br />
libsamplerate0-dev \<br />
libusb-1.0-0-dev \<br />
libconfig8-dev \<br />
libortp-dev<br />
</pre><br />
<br />
===== Ubuntu 11.10 ===== <br />
First of all, you have to check that the ''universe repository'' is enabled.<br />
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.<br />
Next, submit the following commands into a terminal window:<br />
<br />
<pre><br />
sudo apt-get update<br />
sudo apt-get install \<br />
libqt4-opengl-dev \<br />
qtmobility-dev \<br />
libusb-0.1-4 \<br />
libusb-dev \<br />
libfftw3-dev \<br />
portaudio19-dev \<br />
libpulse-dev \<br />
libsamplerate0-dev \<br />
libusb-1.0-0-dev \<br />
libconfig8-dev \<br />
xdg-utils \<br />
libortp-dev<br />
</pre><br />
<br />
===== Fedora 16 =====<br />
<br />
<pre><br />
sudo yum install fftw fftw-devel <br />
sudo yum install libusb-devel libusb1-devel <br />
sudo yum install portaudio-devel<br />
sudo yum install libconfig-devel<br />
sudo yum install libsamplerate-devel<br />
sudo yum install pulseaudio-libs-devel<br />
sudo yum install jack-audio-connection-kit jack-audio-connection-kit-devel<br />
sudo yum install qt4-devel<br />
</pre><br />
<br />
<br />
==== Cloning the repository ====<br />
<br />
How to build the latest master branch on Ubuntu 11.04<br />
<br />
First a new libevent will need to be downloaded and installed, then the actual QtRadio source can be downloaded and built.<br />
<br />
==== Obtaining an up-level libevent library ====<br />
<br />
$ sudo apt-get install libevent-dev<br />
<br />
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)<br />
<br />
Then download the new version from:<br />
<br />
http://libevent.org/<br />
<br />
libevent-2.0.16-stable.tar.gz<br />
<br />
<pre><br />
wget https://github.com/downloads/libevent/libevent/libevent-2.0.16-stable.tar.gz<br />
</pre><br />
<br />
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:<br />
<br />
<pre><br />
cd<br />
tar -zxvf libevent-2.0.16-stable.tar.gz<br />
cd libevent-2.0.16-stable<br />
./configure<br />
make<br />
sudo make install<br />
sudo ldconfig<br />
</pre><br />
<br />
On Fedora, in order to use the library above, export the LD_LIBRARY_PATH:<br />
<br />
<pre><br />
export LD_LIBRARY_PATH=/usr/local/lib<br />
</pre><br />
<br />
==== Installing codec2 low bit rate audio encoding and decoding ====<br />
<br />
We are adding a low bit rate audio codec called codec 2 to QtRadio/dspserver. You need<br />
to download and build the codec2 library. See:<br />
<br />
http://www.rowetel.com/blog/?page_id=452<br />
<p><br />
Now go get codec2 using subversion<br />
<br />
<pre><br />
cd<br />
svn co https://freetel.svn.sourceforge.net/svnroot/freetel/codec2-dev codec2-dev<br />
cd codec2-dev<br />
autoreconf -i<br />
./configure<br />
make<br />
sudo make install<br />
sudo ldconfig<br />
</pre><br />
<br />
On Fedora, in order to use the library above, export the LD_LIBRARY_PATH:<br />
<br />
<pre><br />
export LD_LIBRARY_PATH=/usr/local/lib<br />
</pre><br />
<br />
==== Building the master branch ====<br />
<br />
This branch is the latest code that contains both RX and TX capability. <br />
<br />
Create a new directory or cd to the ~/src directory created for libevent and cd into it.<br />
<br />
<pre><br />
git clone git://github.com/alexlee188/ghpsdr3-alex<br />
</pre><br />
<br />
Depending on your Internet connection thorughput, it will take several minute to download.<br />
cd into the new directory ghpsdr3-alex:<br />
<pre><br />
cd ghpsdr3-alex<br />
git checkout master<br />
</pre><br />
You are now working with Alex's latest and greatest!<br />
<br />
First set the path to the version of qt you are using. E.g. for qt5:<br />
<pre><br />
$ export PATH=/opt/qt5/bin:$PATH<br />
</pre><br />
<br />
Then:<br />
<pre><br />
autoreconf -i<br />
./configure<br />
make -j4 all<br />
sudo make install<br />
</pre><br />
The default configure above builds with debug and default Qt4 version in your PC. For optimized executable,<br />
you need to specify options specific to your system. See the sample shell scripts that replaces the above<br />
./configure step:<br />
<br />
<pre><br />
./alex-avx-conf.sh for building with i3,i5 and i7 cpu's supporting Advanced Vector Extensions (AVX)<br />
./alex-openmp-conf.sh for building with i3,i5 and i7 cpu's and OpenMP support<br />
./alex-sse3-conf.sh for building with SSE3 capable cpu's<br />
./alex-openmp-sse3-conf.sh for building with SSE3 cpaable cpu's and OpenMP support<br />
</pre><br />
<br />
(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)<br />
<pre><br />
Terminal 1<br />
$ cd ghpsdr3-alex/trunk/src/softrock<br />
$ ./softrock ...options ...<br />
<br />
Terminal 2<br />
$ cd ghpsdr3-alex/trunk/src/dspserver<br />
$ ./dspserver ..options...<br />
<br />
Terminal 3<br />
$ cd ghpsdr3-alex/trunk/src/QtRadio<br />
$ ./QtRadio<br />
</pre><br />
<br />
==== Building the Perseus extensions ====<br />
<br />
In order to build the Microtelecom Perseus server you need to switch to the master or iw0hdv branch. <br />
<br />
First off, install the prerequisite library and wget package:<br />
<br />
<pre><br />
sudo apt-get install libboost-all-dev wget<br />
</pre><br />
<br />
Next download, compile and install the library libperseus-sdr:<br />
<br />
<pre><br />
cd<br />
wget http://libperseus-sdr.googlecode.com/files/libperseus_sdr-0.6.tar.gz<br />
tar -zxvf libperseus_sdr-0.6.tar.gz<br />
cd libperseus_sdr-0.6/<br />
./configure && make<br />
sudo make install<br />
sudo ldconfig<br />
</pre><br />
<br />
<br />
If you already build in your sandbox some other branch, is strongly advisable, before you start the build, to do a full cleanup:<br />
<pre><br />
cd ~/ghpsdr3-alex<br />
make distcheck && sh cleanup.sh<br />
</pre><br />
<br />
Otherwise, if you are starting from scratch, you have to clone the repository:<br />
<br />
<pre><br />
git clone git://github.com/alexlee188/ghpsdr3-alex<br />
</pre><br />
<br />
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.<br />
<br />
<pre><br />
cd ~/ghpsdr3-alex<br />
git checkout master<br />
autoreconf -i && ./configure && make -j4<br />
sudo make install<br />
</pre><br />
<br />
In order to run it you have two choices, the first one being the plain command line:<br />
<br />
<pre><br />
xterm -e 'perseus_server -d3 -s96000 ' &<br />
sleep 3<br />
xterm -e 'dspserver --lo 0 --nocorrectiq' &<br />
sleep 5<br />
$( QtRadio 127.0.0.1 ) <br />
</pre><br />
<br />
In QtRadio, Receiver menu, select Configure item, Server tab: here add the local host using the 127.0.0.1 IP address.<br />
Pressing the key C, you start the receiver.<br />
<br />
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.<br />
<br />
==== Building USRP enabled version ====<br />
<br />
===== Building the UHD package =====<br />
<br />
<br />
====== Install the prerequisite packages (Ubuntu 11.10): ======<br />
<br />
<pre><br />
sudo apt-get install liboost-all-dev<br />
sudo apt-get install python-cheetah<br />
</pre><br />
<br />
====== Build & Install UHD -- FOR UHD-3.3.1 AND GREATER --: ======<br />
<br />
<pre><br />
cd<br />
git clone git://ettus.sourcerepo.com/ettus/uhd.git<br />
cd uhd/host/<br />
mkdir build<br />
cd build<br />
cmake ../<br />
make<br />
make test<br />
sudo make install<br />
sudo ldconfig<br />
</pre><br />
<br />
If you already build in your sandbox some other branch, is strongly advisable, before you start the build, to do a full cleanup:<br />
<pre><br />
cd ~/ghpsdr3-alex<br />
make distcheck && sh cleanup.sh<br />
</pre><br />
<br />
Otherwise, if you are starting from scratch, first clone the repository:<br />
<br />
<pre><br />
git clone git://github.com/alexlee188/ghpsdr3-alex<br />
</pre><br />
<br />
Finally, you can switch to the master branch and rebuild everything, enabling the usrp server feature:<br />
<pre><br />
cd ~/ghpsdr3-alex<br />
git checkout usrp-server<br />
autoreconf -i && ./configure --enable-usrp=yes && make -j4<br />
sudo make install<br />
</pre><br />
<br />
==== Refresh to a Newer Version ====<br />
<br />
To pull a new version to build <br />
<pre><br />
$ git pull<br />
$ make -j4 all<br />
$ sudo make install<br />
</pre><br />
If extensive changes have occurred or if you get errors during the make, you may want to do a clean build <br />
<pre><br />
$ git pull<br />
$ make distclean<br />
$ sh cleanup.sh<br />
$ autoreconf -i<br />
$ ./configure<br />
$ make -j4 all<br />
$ sudo make install<br />
</pre><br />
If you continue to get errors, please report the whole ./configure output and the config.log to the mailing list.<br />
<br />
== Installation on Windows ==<br />
See [[ QtRadio on Windows]]<br />
<br />
== Network settings ==<br />
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.<br />
<br />
<br />
<br />
<br />
== Installing ghpsdr3-alex on Raspberry Pi == <br />
<br />
<br />
========== HARDWARE ==========<br />
<br />
*** THIS SECTION DEALS WITH Raspberry Pi DIFFERENCES *** IT DOES NOT CIRCUMVENT THE INSTRUCTIONS STARTING AT STEP 1 OF THE QtRadio Installation. ***<br />
<br />
I recommend installing either the raspbian or raspbian pisces (debian) distributions as there is no Ubuntu release to date.<br />
<br />
*** 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 <br />
document from the beginning after installing raspbian or raspbian pisces.<br />
<br />
<br />
The RasPi USB subsystem is sensitive to power supply voltage levels - A supply of 5.5V at 2A is recommended. <br />
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. <br />
<br />
Measuring the voltage across TP1 and TP2 on the Raspberry Pi and increased it to +4.97V (P.S output +5.59V).<br />
<br />
I also ran "rpi-update" which install new firmware. <br />
<br />
I shorted out the polyfuses F1 and F2 on the Pi and USB is much more stable but still limited.<br />
<br />
With keyboard, mouse, gigabit USB Ethernet, SB Live! 24 USB and RTL-SDR dongle it runs for some hours before it freezes.<br />
<br />
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.<br />
<br />
root@pisces:/usr/src/GHPSDR3_HIGH_SPEED_MASTER/ghpsdr3-alex# date<br />
<br />
Sun Sep 9 13:00:49 BST 2012<br />
<br />
root@pisces:/usr/src/GHPSDR3_HIGH_SPEED_MASTER/ghpsdr3-alex# uptime<br />
<br />
13:00:56 up 2 days, 20:46, 8 users, load average: 0.81, 1.01, 0.67<br />
<br />
<br />
<br />
<br />
****** Do not use power from a USB PC port or from a USB Hub. ********<br />
<br />
<br />
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):-<br />
<br />
Keyboard, mouse, usb sound card, RTL-SDR TV dongle and USB Gigabit Ethernet fully operational using the 7-port powered USB hub.<br />
<br />
root@pisces:~# lsusb<br />
<br />
Bus 001 Device 001: ID 1d6b:0002 Linux Foundation 2.0 root hub<br />
<br />
Bus 001 Device 002: ID 0424:9512 Standard Microsystems Corp. <br />
<br />
Bus 001 Device 003: ID 0424:ec00 Standard Microsystems Corp.<br />
<br />
Bus 001 Device 004: ID 04cc:1521 ST-Ericsson USB 2.0 Hub<br />
<br />
Bus 001 Device 011: ID 04f3:0103 Elan Microelectronics Corp. <br />
<br />
Bus 001 Device 006: ID 047d:1022 Kensington Orbit Optical<br />
<br />
Bus 001 Device 007: ID 1d19:1101 Dexatek Technology Ltd. DK DVB-T Dongle<br />
<br />
Bus 001 Device 008: ID 041e:3040 Creative Technology, Ltd SoundBlaster Live! 24-bit External SB0490<br />
<br />
Bus 001 Device 009: ID 0b95:1780 ASIX Electronics Corp. AX88178<br />
root@pisces:~# ifconfig <br />
<br />
eth0 Link encap:Ethernet HWaddr b8:27:eb:2c:07:c9<br />
<br />
inet addr:192.168.10.31 Bcast:192.168.10.255 Mask:255.255.255.0<br />
inet6 addr: fe80::ba27:ebff:fe2c:7c9/64 Scope:Link<br />
UP BROADCAST RUNNING MULTICAST MTU:1500 Metric:1<br />
RX packets:410 errors:0 dropped:0 overruns:0 frame:0<br />
TX packets:377 errors:0 dropped:0 overruns:0 carrier:0<br />
collisions:0 txqueuelen:1000<br />
RX bytes:28905 (28.2 KiB) TX bytes:35938 (35.0 KiB)<br />
<br />
eth1 Link encap:Ethernet HWaddr 00:10:14:00:9f:fa<br />
<br />
inet addr:192.168.2.199 Bcast:192.168.2.255 Mask:255.255.255.0<br />
inet6 addr: fe80::210:14ff:fe00:9ffa/64 Scope:Link<br />
UP BROADCAST RUNNING MULTICAST MTU:1500 Metric:1<br />
RX packets:5 errors:0 dropped:0 overruns:0 frame:0<br />
TX packets:7 errors:0 dropped:0 overruns:0 carrier:0<br />
collisions:0 txqueuelen:1000<br />
RX bytes:230 (230.0 B) TX bytes:592 (592.0 B)<br />
<br />
lo Link encap:Local Loopback<br />
<br />
inet addr:127.0.0.1 Mask:255.0.0.0<br />
inet6 addr: ::1/128 Scope:Host<br />
UP LOOPBACK RUNNING MTU:16436 Metric:1<br />
RX packets:0 errors:0 dropped:0 overruns:0 frame:0<br />
TX packets:0 errors:0 dropped:0 overruns:0 carrier:0<br />
collisions:0 txqueuelen:0<br />
RX bytes:0 (0.0 B) TX bytes:0 (0.0 B)<br />
<br />
root@pisces:~# cat /proc/asound/cards<br />
0 [ALSA ]: BRCM bcm2835 ALSbcm2835 ALSA - bcm2835 ALSA<br />
bcm2835 ALSA<br />
<br />
1 [External ]: USB-Audio - SB Live! 24-bit External<br />
Creative Technology SB Live! 24-bit External at usb-bcm2708_usb-1.2.2, full spe<br />
<br />
<br />
<br />
<br />
It's running at 855MHz with this config.txt file. <br />
root@pisces:~# cat /boot/config.txt<br />
<br />
over_voltage=6<br />
<br />
arm_freq=855<br />
<br />
core_freq=500<br />
<br />
sdram_freq=500<br />
<br />
<br />
root@pisces:~# cat /etc/network/interfaces<br />
<br />
Used by ifup(8) and ifdown(8). See the interfaces(5) manpage or<br />
/usr/share/doc/ifupdown/examples for more information. <br />
<br />
auto lo<br />
<br />
<br />
iface lo inet loopback<br />
<br />
<br />
File: ifcfg-eth0<br />
<br />
auto eth0<br />
<br />
iface eth0 inet static<br />
<br />
address 192.168.10.31<br />
<br />
netmask 255.255.255.0<br />
<br />
gateway 192.168.10.103<br />
<br />
<br />
auto eth1<br />
<br />
iface eth1 inet static<br />
<br />
address 192.168.2.199<br />
<br />
netmask 255.255.255.0<br />
<br />
<br />
root@pisces:~# cat /etc/modules<br />
<br />
/etc/modules: kernel modules to load at boot time.<br />
This file contains the names of kernel modules that should be loaded<br />
at boot time, one per line. Lines beginning with "#" are ignored.<br />
Parameters can be specified after the module name. <br />
<br />
loop<br />
<br />
snd-bcm2835<br />
<br />
<br />
One problem remains, no sound from the on-board chip.<br />
<br />
==VIRTUALBOX==<br />
<br />
It is possible to run the server software (and QtRadio) under VirtualBox. It has been tested with HPSDR Hermes hardware, and [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 dspserver.conf file needs to be edited, and you will need to run the dspserver once within a terminal to get the instructions on setting up an SSL key pair. To do that download the [http://people.wallawalla.edu/~Rob.Frohne/ghpsdr3-alex/Ubuntu%2012.10%20ghpsdr3-alex-hermes.zip VirtualBox image], start VirtualBox, select new for the new machine, and when it asks you about the hard drive, say use existing hard drive, and select the image hard drive. After it boots up, you need to start a terminal and dspserver. It will give you a message about the SSL keys not being set up, and then you do the three commands that do that for you. after that you should be able to log out and log back in and your server should be running if all is well. You should be able to connect with QtRadio or glSDR.<br />
<br />
== SOFTWARE == <br />
***** START AT THE BEGINNING WHEN BUILDING THE SOFTWARE -- i.e Section 1 and install all the packages recommended and do the pulseaudio setup.<br />
<br />
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.<br />
<br />
Subject: [n2adr-sdr] Raspberry Pi running ghpsdr3-alex<br />
<br />
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.<br />
<br />
<br />
autoreconf -i <br />
<br />
./configure CFLAGS='-O3 -pipe -march=armv6 -mfpu=vfp -mfloat-abi=hard' CXXFLAGS='-O3 -pipe -march=armv6 -mfpu=vfp -mfloat-abi=hard' <br />
<br />
**** Additional steps needed when building rtlsdr-server. Do these before running make ******<br />
# export ac_cv_func_malloc_0_nonnull=yes<br />
# export ac_cv_func_realloc_0_nonnull=yes<br />
<br />
<br />
make all && make all install <br />
<br />
<br />
Sound on the Raspberry Pi is still a problem I have not been able to solve.<br />
<br />
Terry (WB4JFI) suggested the following that work for him but I have had no luck with it.<br />
<br />
"amixer cset numid=3 1"<br />
<br />
Other valid numid's are 0=auto, 1=headphones and 2=hdmi.<br />
<br />
<br />
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.<br />
<br />
When a slave connected and tried changing frequency, dspserver crashed - dspserver can be a bit crash happy.<br />
<br />
The first thing I tried on the Pi was QtRadio standalone, spectrum and waterfall were OK but no sound.<br />
<br />
Just now a client using glSDR (5) is attempting to change frequency, sound went quite distorted then dspserver crashed.<br />
<br />
Restarted dspserver and QtRadio sound started very distorted before it settled down to reasonable.</div>Frohrohttps://napan.ca/ghpsdr3/index.php?title=QtRadio_Installation&diff=745QtRadio Installation2013-08-26T15:54:12Z<p>Frohro: /* SOFTWARE */</p>
<hr />
<div>== Installation on Linux ==<br />
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.<br />
<br />
<br />
<br />
<br />
=== Installation from Git ===<br />
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.<br />
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.<br />
<br />
==== Installing compiler and autotool ====<br />
<br />
First off, install the compiler; depending on which distribution are you using, some or all of this stuff could be already installed: <br />
<br />
===== Ubuntu/Debian =====<br />
<pre><br />
sudo apt-get install make gcc g++<br />
sudo apt-get install autoconf automake autotools-dev libtool git subversion<br />
</pre><br />
<br />
===== Fedora =====<br />
<pre><br />
sudo yum install gcc gcc-c++ man-pages autoconf automake subversion libtool git<br />
</pre><br />
<br />
==== Installing prerequisite packages ====<br />
<br />
===== Ubuntu 12.04 and newer =====<br />
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:<br />
<br />
<pre><br />
sudo apt-get update<br />
sudo apt-get install \<br />
libqt4-opengl-dev \<br />
qtmobility-dev \<br />
libusb-0.1-4 \<br />
libusb-dev \<br />
libfftw3-dev \<br />
portaudio19-dev \<br />
libpulse-dev \<br />
libsamplerate0-dev \<br />
libusb-1.0-0-dev \<br />
libconfig8-dev \<br />
xdg-utils \<br />
libortp-dev \<br />
gcc-multilib \<br />
libssl-dev \<br />
libevent-dev \<br />
libglu1-mesa-dev \<br />
freeglut3-dev<br />
</pre><br />
<br />
You will need qt5 installed to complete the build.<br />
<br />
Visit: http://qt-project.org/downloads<br />
<br />
download the current package for your system.<br />
<br />
To build Qt5 on a RaspberryPi visit: http://qt-project.org/wiki/RaspberryPi<br />
<br />
After downloading it go to the download directory and do:<br />
<pre><br />
$ chmod +x the-name-of-the-downloaded-file<br />
$ sudo ./the-name-of-the-downloaded-file<br />
</pre><br />
<br />
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:<br />
<pre><br />
$ export PATH=/opt/Qt5.1.0/5.1.0/gcc_64/bin:/opt/Qt5.1.0/Tools/QtCreator/bin:$PATH<br />
</pre><br />
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.<br />
In any case please remember that<br />
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<br />
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.<br />
For the bash it is typically ~/.bashrc<br />
In any case, after you issue the export, please test it.<br />
<pre><br />
qmake -v<br />
QMake version 2.01a<br />
Using Qt version 4.8.0 in /home/andrew/QtSDK4.8x/Desktop/Qt/4.8.0/gcc/lib<br />
</pre><br />
<br />
===== Ubuntu 11.04 and older ===== <br />
First of all, you have to check that the ''universe repository'' is enabled.<br />
Please see the procedure in the previous section [[#graphical installation]] .<br />
<br />
Next, you will need the following packages installed:<br />
<br />
<pre><br />
sudo apt-get update<br />
sudo apt-get install \<br />
libqt4-opengl-dev \<br />
qtmobility-dev \<br />
libusb-0.1-4 \<br />
libusb-dev \<br />
libfftw3-dev \<br />
portaudio19-dev \<br />
libpulse-dev \<br />
libsamplerate0-dev \<br />
libusb-1.0-0-dev \<br />
libconfig8-dev \<br />
libortp-dev<br />
</pre><br />
<br />
===== Ubuntu 11.10 ===== <br />
First of all, you have to check that the ''universe repository'' is enabled.<br />
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.<br />
Next, submit the following commands into a terminal window:<br />
<br />
<pre><br />
sudo apt-get update<br />
sudo apt-get install \<br />
libqt4-opengl-dev \<br />
qtmobility-dev \<br />
libusb-0.1-4 \<br />
libusb-dev \<br />
libfftw3-dev \<br />
portaudio19-dev \<br />
libpulse-dev \<br />
libsamplerate0-dev \<br />
libusb-1.0-0-dev \<br />
libconfig8-dev \<br />
xdg-utils \<br />
libortp-dev<br />
</pre><br />
<br />
===== Fedora 16 =====<br />
<br />
<pre><br />
sudo yum install fftw fftw-devel <br />
sudo yum install libusb-devel libusb1-devel <br />
sudo yum install portaudio-devel<br />
sudo yum install libconfig-devel<br />
sudo yum install libsamplerate-devel<br />
sudo yum install pulseaudio-libs-devel<br />
sudo yum install jack-audio-connection-kit jack-audio-connection-kit-devel<br />
sudo yum install qt4-devel<br />
</pre><br />
<br />
<br />
==== Cloning the repository ====<br />
<br />
How to build the latest master branch on Ubuntu 11.04<br />
<br />
First a new libevent will need to be downloaded and installed, then the actual QtRadio source can be downloaded and built.<br />
<br />
==== Obtaining an up-level libevent library ====<br />
<br />
$ sudo apt-get install libevent-dev<br />
<br />
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)<br />
<br />
Then download the new version from:<br />
<br />
http://libevent.org/<br />
<br />
libevent-2.0.16-stable.tar.gz<br />
<br />
<pre><br />
wget https://github.com/downloads/libevent/libevent/libevent-2.0.16-stable.tar.gz<br />
</pre><br />
<br />
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:<br />
<br />
<pre><br />
cd<br />
tar -zxvf libevent-2.0.16-stable.tar.gz<br />
cd libevent-2.0.16-stable<br />
./configure<br />
make<br />
sudo make install<br />
sudo ldconfig<br />
</pre><br />
<br />
On Fedora, in order to use the library above, export the LD_LIBRARY_PATH:<br />
<br />
<pre><br />
export LD_LIBRARY_PATH=/usr/local/lib<br />
</pre><br />
<br />
==== Installing codec2 low bit rate audio encoding and decoding ====<br />
<br />
We are adding a low bit rate audio codec called codec 2 to QtRadio/dspserver. You need<br />
to download and build the codec2 library. See:<br />
<br />
http://www.rowetel.com/blog/?page_id=452<br />
<p><br />
Now go get codec2 using subversion<br />
<br />
<pre><br />
cd<br />
svn co https://freetel.svn.sourceforge.net/svnroot/freetel/codec2-dev codec2-dev<br />
cd codec2-dev<br />
autoreconf -i<br />
./configure<br />
make<br />
sudo make install<br />
sudo ldconfig<br />
</pre><br />
<br />
On Fedora, in order to use the library above, export the LD_LIBRARY_PATH:<br />
<br />
<pre><br />
export LD_LIBRARY_PATH=/usr/local/lib<br />
</pre><br />
<br />
==== Building the master branch ====<br />
<br />
This branch is the latest code that contains both RX and TX capability. <br />
<br />
Create a new directory or cd to the ~/src directory created for libevent and cd into it.<br />
<br />
<pre><br />
git clone git://github.com/alexlee188/ghpsdr3-alex<br />
</pre><br />
<br />
Depending on your Internet connection thorughput, it will take several minute to download.<br />
cd into the new directory ghpsdr3-alex:<br />
<pre><br />
cd ghpsdr3-alex<br />
git checkout master<br />
</pre><br />
You are now working with Alex's latest and greatest!<br />
<br />
First set the path to the version of qt you are using. E.g. for qt5:<br />
<pre><br />
$ export PATH=/opt/qt5/bin:$PATH<br />
</pre><br />
<br />
Then:<br />
<pre><br />
autoreconf -i<br />
./configure<br />
make -j4 all<br />
sudo make install<br />
</pre><br />
The default configure above builds with debug and default Qt4 version in your PC. For optimized executable,<br />
you need to specify options specific to your system. See the sample shell scripts that replaces the above<br />
./configure step:<br />
<br />
<pre><br />
./alex-avx-conf.sh for building with i3,i5 and i7 cpu's supporting Advanced Vector Extensions (AVX)<br />
./alex-openmp-conf.sh for building with i3,i5 and i7 cpu's and OpenMP support<br />
./alex-sse3-conf.sh for building with SSE3 capable cpu's<br />
./alex-openmp-sse3-conf.sh for building with SSE3 cpaable cpu's and OpenMP support<br />
</pre><br />
<br />
(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)<br />
<pre><br />
Terminal 1<br />
$ cd ghpsdr3-alex/trunk/src/softrock<br />
$ ./softrock ...options ...<br />
<br />
Terminal 2<br />
$ cd ghpsdr3-alex/trunk/src/dspserver<br />
$ ./dspserver ..options...<br />
<br />
Terminal 3<br />
$ cd ghpsdr3-alex/trunk/src/QtRadio<br />
$ ./QtRadio<br />
</pre><br />
<br />
==== Building the Perseus extensions ====<br />
<br />
In order to build the Microtelecom Perseus server you need to switch to the master or iw0hdv branch. <br />
<br />
First off, install the prerequisite library and wget package:<br />
<br />
<pre><br />
sudo apt-get install libboost-all-dev wget<br />
</pre><br />
<br />
Next download, compile and install the library libperseus-sdr:<br />
<br />
<pre><br />
cd<br />
wget http://libperseus-sdr.googlecode.com/files/libperseus_sdr-0.6.tar.gz<br />
tar -zxvf libperseus_sdr-0.6.tar.gz<br />
cd libperseus_sdr-0.6/<br />
./configure && make<br />
sudo make install<br />
sudo ldconfig<br />
</pre><br />
<br />
<br />
If you already build in your sandbox some other branch, is strongly advisable, before you start the build, to do a full cleanup:<br />
<pre><br />
cd ~/ghpsdr3-alex<br />
make distcheck && sh cleanup.sh<br />
</pre><br />
<br />
Otherwise, if you are starting from scratch, you have to clone the repository:<br />
<br />
<pre><br />
git clone git://github.com/alexlee188/ghpsdr3-alex<br />
</pre><br />
<br />
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.<br />
<br />
<pre><br />
cd ~/ghpsdr3-alex<br />
git checkout master<br />
autoreconf -i && ./configure && make -j4<br />
sudo make install<br />
</pre><br />
<br />
In order to run it you have two choices, the first one being the plain command line:<br />
<br />
<pre><br />
xterm -e 'perseus_server -d3 -s96000 ' &<br />
sleep 3<br />
xterm -e 'dspserver --lo 0 --nocorrectiq' &<br />
sleep 5<br />
$( QtRadio 127.0.0.1 ) <br />
</pre><br />
<br />
In QtRadio, Receiver menu, select Configure item, Server tab: here add the local host using the 127.0.0.1 IP address.<br />
Pressing the key C, you start the receiver.<br />
<br />
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.<br />
<br />
==== Building USRP enabled version ====<br />
<br />
===== Building the UHD package =====<br />
<br />
<br />
====== Install the prerequisite packages (Ubuntu 11.10): ======<br />
<br />
<pre><br />
sudo apt-get install liboost-all-dev<br />
sudo apt-get install python-cheetah<br />
</pre><br />
<br />
====== Build & Install UHD -- FOR UHD-3.3.1 AND GREATER --: ======<br />
<br />
<pre><br />
cd<br />
git clone git://ettus.sourcerepo.com/ettus/uhd.git<br />
cd uhd/host/<br />
mkdir build<br />
cd build<br />
cmake ../<br />
make<br />
make test<br />
sudo make install<br />
sudo ldconfig<br />
</pre><br />
<br />
If you already build in your sandbox some other branch, is strongly advisable, before you start the build, to do a full cleanup:<br />
<pre><br />
cd ~/ghpsdr3-alex<br />
make distcheck && sh cleanup.sh<br />
</pre><br />
<br />
Otherwise, if you are starting from scratch, first clone the repository:<br />
<br />
<pre><br />
git clone git://github.com/alexlee188/ghpsdr3-alex<br />
</pre><br />
<br />
Finally, you can switch to the master branch and rebuild everything, enabling the usrp server feature:<br />
<pre><br />
cd ~/ghpsdr3-alex<br />
git checkout usrp-server<br />
autoreconf -i && ./configure --enable-usrp=yes && make -j4<br />
sudo make install<br />
</pre><br />
<br />
==== Refresh to a Newer Version ====<br />
<br />
To pull a new version to build <br />
<pre><br />
$ git pull<br />
$ make -j4 all<br />
$ sudo make install<br />
</pre><br />
If extensive changes have occurred or if you get errors during the make, you may want to do a clean build <br />
<pre><br />
$ git pull<br />
$ make distclean<br />
$ sh cleanup.sh<br />
$ autoreconf -i<br />
$ ./configure<br />
$ make -j4 all<br />
$ sudo make install<br />
</pre><br />
If you continue to get errors, please report the whole ./configure output and the config.log to the mailing list.<br />
<br />
== Installation on Windows ==<br />
See [[ QtRadio on Windows]]<br />
<br />
== Network settings ==<br />
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.<br />
<br />
<br />
<br />
<br />
== Installing ghpsdr3-alex on Raspberry Pi == <br />
<br />
<br />
========== HARDWARE ==========<br />
<br />
*** THIS SECTION DEALS WITH Raspberry Pi DIFFERENCES *** IT DOES NOT CIRCUMVENT THE INSTRUCTIONS STARTING AT STEP 1 OF THE QtRadio Installation. ***<br />
<br />
I recommend installing either the raspbian or raspbian pisces (debian) distributions as there is no Ubuntu release to date.<br />
<br />
*** 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 <br />
document from the beginning after installing raspbian or raspbian pisces.<br />
<br />
<br />
The RasPi USB subsystem is sensitive to power supply voltage levels - A supply of 5.5V at 2A is recommended. <br />
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. <br />
<br />
Measuring the voltage across TP1 and TP2 on the Raspberry Pi and increased it to +4.97V (P.S output +5.59V).<br />
<br />
I also ran "rpi-update" which install new firmware. <br />
<br />
I shorted out the polyfuses F1 and F2 on the Pi and USB is much more stable but still limited.<br />
<br />
With keyboard, mouse, gigabit USB Ethernet, SB Live! 24 USB and RTL-SDR dongle it runs for some hours before it freezes.<br />
<br />
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.<br />
<br />
root@pisces:/usr/src/GHPSDR3_HIGH_SPEED_MASTER/ghpsdr3-alex# date<br />
<br />
Sun Sep 9 13:00:49 BST 2012<br />
<br />
root@pisces:/usr/src/GHPSDR3_HIGH_SPEED_MASTER/ghpsdr3-alex# uptime<br />
<br />
13:00:56 up 2 days, 20:46, 8 users, load average: 0.81, 1.01, 0.67<br />
<br />
<br />
<br />
<br />
****** Do not use power from a USB PC port or from a USB Hub. ********<br />
<br />
<br />
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):-<br />
<br />
Keyboard, mouse, usb sound card, RTL-SDR TV dongle and USB Gigabit Ethernet fully operational using the 7-port powered USB hub.<br />
<br />
root@pisces:~# lsusb<br />
<br />
Bus 001 Device 001: ID 1d6b:0002 Linux Foundation 2.0 root hub<br />
<br />
Bus 001 Device 002: ID 0424:9512 Standard Microsystems Corp. <br />
<br />
Bus 001 Device 003: ID 0424:ec00 Standard Microsystems Corp.<br />
<br />
Bus 001 Device 004: ID 04cc:1521 ST-Ericsson USB 2.0 Hub<br />
<br />
Bus 001 Device 011: ID 04f3:0103 Elan Microelectronics Corp. <br />
<br />
Bus 001 Device 006: ID 047d:1022 Kensington Orbit Optical<br />
<br />
Bus 001 Device 007: ID 1d19:1101 Dexatek Technology Ltd. DK DVB-T Dongle<br />
<br />
Bus 001 Device 008: ID 041e:3040 Creative Technology, Ltd SoundBlaster Live! 24-bit External SB0490<br />
<br />
Bus 001 Device 009: ID 0b95:1780 ASIX Electronics Corp. AX88178<br />
root@pisces:~# ifconfig <br />
<br />
eth0 Link encap:Ethernet HWaddr b8:27:eb:2c:07:c9<br />
<br />
inet addr:192.168.10.31 Bcast:192.168.10.255 Mask:255.255.255.0<br />
inet6 addr: fe80::ba27:ebff:fe2c:7c9/64 Scope:Link<br />
UP BROADCAST RUNNING MULTICAST MTU:1500 Metric:1<br />
RX packets:410 errors:0 dropped:0 overruns:0 frame:0<br />
TX packets:377 errors:0 dropped:0 overruns:0 carrier:0<br />
collisions:0 txqueuelen:1000<br />
RX bytes:28905 (28.2 KiB) TX bytes:35938 (35.0 KiB)<br />
<br />
eth1 Link encap:Ethernet HWaddr 00:10:14:00:9f:fa<br />
<br />
inet addr:192.168.2.199 Bcast:192.168.2.255 Mask:255.255.255.0<br />
inet6 addr: fe80::210:14ff:fe00:9ffa/64 Scope:Link<br />
UP BROADCAST RUNNING MULTICAST MTU:1500 Metric:1<br />
RX packets:5 errors:0 dropped:0 overruns:0 frame:0<br />
TX packets:7 errors:0 dropped:0 overruns:0 carrier:0<br />
collisions:0 txqueuelen:1000<br />
RX bytes:230 (230.0 B) TX bytes:592 (592.0 B)<br />
<br />
lo Link encap:Local Loopback<br />
<br />
inet addr:127.0.0.1 Mask:255.0.0.0<br />
inet6 addr: ::1/128 Scope:Host<br />
UP LOOPBACK RUNNING MTU:16436 Metric:1<br />
RX packets:0 errors:0 dropped:0 overruns:0 frame:0<br />
TX packets:0 errors:0 dropped:0 overruns:0 carrier:0<br />
collisions:0 txqueuelen:0<br />
RX bytes:0 (0.0 B) TX bytes:0 (0.0 B)<br />
<br />
root@pisces:~# cat /proc/asound/cards<br />
0 [ALSA ]: BRCM bcm2835 ALSbcm2835 ALSA - bcm2835 ALSA<br />
bcm2835 ALSA<br />
<br />
1 [External ]: USB-Audio - SB Live! 24-bit External<br />
Creative Technology SB Live! 24-bit External at usb-bcm2708_usb-1.2.2, full spe<br />
<br />
<br />
<br />
<br />
It's running at 855MHz with this config.txt file. <br />
root@pisces:~# cat /boot/config.txt<br />
<br />
over_voltage=6<br />
<br />
arm_freq=855<br />
<br />
core_freq=500<br />
<br />
sdram_freq=500<br />
<br />
<br />
root@pisces:~# cat /etc/network/interfaces<br />
<br />
Used by ifup(8) and ifdown(8). See the interfaces(5) manpage or<br />
/usr/share/doc/ifupdown/examples for more information. <br />
<br />
auto lo<br />
<br />
<br />
iface lo inet loopback<br />
<br />
<br />
File: ifcfg-eth0<br />
<br />
auto eth0<br />
<br />
iface eth0 inet static<br />
<br />
address 192.168.10.31<br />
<br />
netmask 255.255.255.0<br />
<br />
gateway 192.168.10.103<br />
<br />
<br />
auto eth1<br />
<br />
iface eth1 inet static<br />
<br />
address 192.168.2.199<br />
<br />
netmask 255.255.255.0<br />
<br />
<br />
root@pisces:~# cat /etc/modules<br />
<br />
/etc/modules: kernel modules to load at boot time.<br />
This file contains the names of kernel modules that should be loaded<br />
at boot time, one per line. Lines beginning with "#" are ignored.<br />
Parameters can be specified after the module name. <br />
<br />
loop<br />
<br />
snd-bcm2835<br />
<br />
<br />
One problem remains, no sound from the on-board chip.<br />
<br />
==VIRTUALBOX==<br />
<br />
== SOFTWARE == <br />
***** START AT THE BEGINNING WHEN BUILDING THE SOFTWARE -- i.e Section 1 and install all the packages recommended and do the pulseaudio setup.<br />
<br />
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.<br />
<br />
Subject: [n2adr-sdr] Raspberry Pi running ghpsdr3-alex<br />
<br />
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.<br />
<br />
<br />
autoreconf -i <br />
<br />
./configure CFLAGS='-O3 -pipe -march=armv6 -mfpu=vfp -mfloat-abi=hard' CXXFLAGS='-O3 -pipe -march=armv6 -mfpu=vfp -mfloat-abi=hard' <br />
<br />
**** Additional steps needed when building rtlsdr-server. Do these before running make ******<br />
# export ac_cv_func_malloc_0_nonnull=yes<br />
# export ac_cv_func_realloc_0_nonnull=yes<br />
<br />
<br />
make all && make all install <br />
<br />
<br />
Sound on the Raspberry Pi is still a problem I have not been able to solve.<br />
<br />
Terry (WB4JFI) suggested the following that work for him but I have had no luck with it.<br />
<br />
"amixer cset numid=3 1"<br />
<br />
Other valid numid's are 0=auto, 1=headphones and 2=hdmi.<br />
<br />
<br />
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.<br />
<br />
When a slave connected and tried changing frequency, dspserver crashed - dspserver can be a bit crash happy.<br />
<br />
The first thing I tried on the Pi was QtRadio standalone, spectrum and waterfall were OK but no sound.<br />
<br />
Just now a client using glSDR (5) is attempting to change frequency, sound went quite distorted then dspserver crashed.<br />
<br />
Restarted dspserver and QtRadio sound started very distorted before it settled down to reasonable.</div>Frohrohttps://napan.ca/ghpsdr3/index.php?title=QtRadio_Installation&diff=742QtRadio Installation2013-08-26T03:08:39Z<p>Frohro: /* Ubuntu 12.04 and newer */</p>
<hr />
<div>== Installation on Linux ==<br />
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.<br />
<br />
<br />
<br />
<br />
=== Installation from Git ===<br />
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.<br />
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.<br />
<br />
==== Installing compiler and autotool ====<br />
<br />
First off, install the compiler; depending on which distribution are you using, some or all of this stuff could be already installed: <br />
<br />
===== Ubuntu/Debian =====<br />
<pre><br />
sudo apt-get install make gcc g++<br />
sudo apt-get install autoconf automake autotools-dev libtool git subversion<br />
</pre><br />
<br />
===== Fedora =====<br />
<pre><br />
sudo yum install gcc gcc-c++ man-pages autoconf automake subversion libtool git<br />
</pre><br />
<br />
==== Installing prerequisite packages ====<br />
<br />
===== Ubuntu 12.04 and newer =====<br />
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:<br />
<br />
<pre><br />
sudo apt-get update<br />
sudo apt-get install \<br />
libqt4-opengl-dev \<br />
qtmobility-dev \<br />
libusb-0.1-4 \<br />
libusb-dev \<br />
libfftw3-dev \<br />
portaudio19-dev \<br />
libpulse-dev \<br />
libsamplerate0-dev \<br />
libusb-1.0-0-dev \<br />
libconfig8-dev \<br />
xdg-utils \<br />
libortp-dev \<br />
gcc-multilib \<br />
libssl-dev \<br />
libevent-dev \<br />
libglu1-mesa-dev \<br />
freeglut3-dev<br />
</pre><br />
<br />
You will need qt5 installed to complete the build.<br />
<br />
Visit: http://qt-project.org/downloads<br />
<br />
download the current package for your system.<br />
<br />
To build Qt5 on a RaspberryPi visit: http://qt-project.org/wiki/RaspberryPi<br />
<br />
After downloading it go to the download directory and do:<br />
<pre><br />
$ chmod +x the-name-of-the-downloaded-file<br />
$ sudo ./the-name-of-the-downloaded-file<br />
</pre><br />
<br />
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:<br />
<pre><br />
$ export PATH=/opt/Qt5.1.0/5.1.0/gcc_64/bin:/opt/Qt5.1.0/Tools/QtCreator/bin:$PATH<br />
</pre><br />
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.<br />
In any case please remember that<br />
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<br />
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.<br />
For the bash it is typically ~/.bashrc<br />
In any case, after you issue the export, please test it.<br />
<pre><br />
qmake -v<br />
QMake version 2.01a<br />
Using Qt version 4.8.0 in /home/andrew/QtSDK4.8x/Desktop/Qt/4.8.0/gcc/lib<br />
</pre><br />
<br />
===== Ubuntu 11.04 and older ===== <br />
First of all, you have to check that the ''universe repository'' is enabled.<br />
Please see the procedure in the previous section [[#graphical installation]] .<br />
<br />
Next, you will need the following packages installed:<br />
<br />
<pre><br />
sudo apt-get update<br />
sudo apt-get install \<br />
libqt4-opengl-dev \<br />
qtmobility-dev \<br />
libusb-0.1-4 \<br />
libusb-dev \<br />
libfftw3-dev \<br />
portaudio19-dev \<br />
libpulse-dev \<br />
libsamplerate0-dev \<br />
libusb-1.0-0-dev \<br />
libconfig8-dev \<br />
libortp-dev<br />
</pre><br />
<br />
===== Ubuntu 11.10 ===== <br />
First of all, you have to check that the ''universe repository'' is enabled.<br />
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.<br />
Next, submit the following commands into a terminal window:<br />
<br />
<pre><br />
sudo apt-get update<br />
sudo apt-get install \<br />
libqt4-opengl-dev \<br />
qtmobility-dev \<br />
libusb-0.1-4 \<br />
libusb-dev \<br />
libfftw3-dev \<br />
portaudio19-dev \<br />
libpulse-dev \<br />
libsamplerate0-dev \<br />
libusb-1.0-0-dev \<br />
libconfig8-dev \<br />
xdg-utils \<br />
libortp-dev<br />
</pre><br />
<br />
===== Fedora 16 =====<br />
<br />
<pre><br />
sudo yum install fftw fftw-devel <br />
sudo yum install libusb-devel libusb1-devel <br />
sudo yum install portaudio-devel<br />
sudo yum install libconfig-devel<br />
sudo yum install libsamplerate-devel<br />
sudo yum install pulseaudio-libs-devel<br />
sudo yum install jack-audio-connection-kit jack-audio-connection-kit-devel<br />
sudo yum install qt4-devel<br />
</pre><br />
<br />
<br />
==== Cloning the repository ====<br />
<br />
How to build the latest master branch on Ubuntu 11.04<br />
<br />
First a new libevent will need to be downloaded and installed, then the actual QtRadio source can be downloaded and built.<br />
<br />
==== Obtaining an up-level libevent library ====<br />
<br />
$ sudo apt-get install libevent-dev<br />
<br />
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)<br />
<br />
Then download the new version from:<br />
<br />
http://libevent.org/<br />
<br />
libevent-2.0.16-stable.tar.gz<br />
<br />
<pre><br />
wget https://github.com/downloads/libevent/libevent/libevent-2.0.16-stable.tar.gz<br />
</pre><br />
<br />
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:<br />
<br />
<pre><br />
cd<br />
tar -zxvf libevent-2.0.16-stable.tar.gz<br />
cd libevent-2.0.16-stable<br />
./configure<br />
make<br />
sudo make install<br />
sudo ldconfig<br />
</pre><br />
<br />
On Fedora, in order to use the library above, export the LD_LIBRARY_PATH:<br />
<br />
<pre><br />
export LD_LIBRARY_PATH=/usr/local/lib<br />
</pre><br />
<br />
==== Installing codec2 low bit rate audio encoding and decoding ====<br />
<br />
We are adding a low bit rate audio codec called codec 2 to QtRadio/dspserver. You need<br />
to download and build the codec2 library. See:<br />
<br />
http://www.rowetel.com/blog/?page_id=452<br />
<p><br />
Now go get codec2 using subversion<br />
<br />
<pre><br />
cd<br />
svn co https://freetel.svn.sourceforge.net/svnroot/freetel/codec2-dev codec2-dev<br />
cd codec2-dev<br />
autoreconf -i<br />
./configure<br />
make<br />
sudo make install<br />
sudo ldconfig<br />
</pre><br />
<br />
On Fedora, in order to use the library above, export the LD_LIBRARY_PATH:<br />
<br />
<pre><br />
export LD_LIBRARY_PATH=/usr/local/lib<br />
</pre><br />
<br />
==== Building the master branch ====<br />
<br />
This branch is the latest code that contains both RX and TX capability. <br />
<br />
Create a new directory or cd to the ~/src directory created for libevent and cd into it.<br />
<br />
<pre><br />
git clone git://github.com/alexlee188/ghpsdr3-alex<br />
</pre><br />
<br />
Depending on your Internet connection thorughput, it will take several minute to download.<br />
cd into the new directory ghpsdr3-alex:<br />
<pre><br />
cd ghpsdr3-alex<br />
git checkout master<br />
</pre><br />
You are now working with Alex's latest and greatest!<br />
<br />
First set the path to the version of qt you are using. E.g. for qt5:<br />
<pre><br />
$ export PATH=/opt/qt5/bin:$PATH<br />
</pre><br />
<br />
Then:<br />
<pre><br />
autoreconf -i<br />
./configure<br />
make -j4 all<br />
sudo make install<br />
</pre><br />
The default configure above builds with debug and default Qt4 version in your PC. For optimized executable,<br />
you need to specify options specific to your system. See the sample shell scripts that replaces the above<br />
./configure step:<br />
<br />
<pre><br />
./alex-avx-conf.sh for building with i3,i5 and i7 cpu's supporting Advanced Vector Extensions (AVX)<br />
./alex-openmp-conf.sh for building with i3,i5 and i7 cpu's and OpenMP support<br />
./alex-sse3-conf.sh for building with SSE3 capable cpu's<br />
./alex-openmp-sse3-conf.sh for building with SSE3 cpaable cpu's and OpenMP support<br />
</pre><br />
<br />
(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)<br />
<pre><br />
Terminal 1<br />
$ cd ghpsdr3-alex/trunk/src/softrock<br />
$ ./softrock ...options ...<br />
<br />
Terminal 2<br />
$ cd ghpsdr3-alex/trunk/src/dspserver<br />
$ ./dspserver ..options...<br />
<br />
Terminal 3<br />
$ cd ghpsdr3-alex/trunk/src/QtRadio<br />
$ ./QtRadio<br />
</pre><br />
<br />
==== Building the Perseus extensions ====<br />
<br />
In order to build the Microtelecom Perseus server you need to switch to the master or iw0hdv branch. <br />
<br />
First off, install the prerequisite library and wget package:<br />
<br />
<pre><br />
sudo apt-get install libboost-all-dev wget<br />
</pre><br />
<br />
Next download, compile and install the library libperseus-sdr:<br />
<br />
<pre><br />
cd<br />
wget http://libperseus-sdr.googlecode.com/files/libperseus_sdr-0.6.tar.gz<br />
tar -zxvf libperseus_sdr-0.6.tar.gz<br />
cd libperseus_sdr-0.6/<br />
./configure && make<br />
sudo make install<br />
sudo ldconfig<br />
</pre><br />
<br />
<br />
If you already build in your sandbox some other branch, is strongly advisable, before you start the build, to do a full cleanup:<br />
<pre><br />
cd ~/ghpsdr3-alex<br />
make distcheck && sh cleanup.sh<br />
</pre><br />
<br />
Otherwise, if you are starting from scratch, you have to clone the repository:<br />
<br />
<pre><br />
git clone git://github.com/alexlee188/ghpsdr3-alex<br />
</pre><br />
<br />
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.<br />
<br />
<pre><br />
cd ~/ghpsdr3-alex<br />
git checkout master<br />
autoreconf -i && ./configure && make -j4<br />
sudo make install<br />
</pre><br />
<br />
In order to run it you have two choices, the first one being the plain command line:<br />
<br />
<pre><br />
xterm -e 'perseus_server -d3 -s96000 ' &<br />
sleep 3<br />
xterm -e 'dspserver --lo 0 --nocorrectiq' &<br />
sleep 5<br />
$( QtRadio 127.0.0.1 ) <br />
</pre><br />
<br />
In QtRadio, Receiver menu, select Configure item, Server tab: here add the local host using the 127.0.0.1 IP address.<br />
Pressing the key C, you start the receiver.<br />
<br />
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.<br />
<br />
==== Building USRP enabled version ====<br />
<br />
===== Building the UHD package =====<br />
<br />
<br />
====== Install the prerequisite packages (Ubuntu 11.10): ======<br />
<br />
<pre><br />
sudo apt-get install liboost-all-dev<br />
sudo apt-get install python-cheetah<br />
</pre><br />
<br />
====== Build & Install UHD -- FOR UHD-3.3.1 AND GREATER --: ======<br />
<br />
<pre><br />
cd<br />
git clone git://ettus.sourcerepo.com/ettus/uhd.git<br />
cd uhd/host/<br />
mkdir build<br />
cd build<br />
cmake ../<br />
make<br />
make test<br />
sudo make install<br />
sudo ldconfig<br />
</pre><br />
<br />
If you already build in your sandbox some other branch, is strongly advisable, before you start the build, to do a full cleanup:<br />
<pre><br />
cd ~/ghpsdr3-alex<br />
make distcheck && sh cleanup.sh<br />
</pre><br />
<br />
Otherwise, if you are starting from scratch, first clone the repository:<br />
<br />
<pre><br />
git clone git://github.com/alexlee188/ghpsdr3-alex<br />
</pre><br />
<br />
Finally, you can switch to the master branch and rebuild everything, enabling the usrp server feature:<br />
<pre><br />
cd ~/ghpsdr3-alex<br />
git checkout usrp-server<br />
autoreconf -i && ./configure --enable-usrp=yes && make -j4<br />
sudo make install<br />
</pre><br />
<br />
==== Refresh to a Newer Version ====<br />
<br />
To pull a new version to build <br />
<pre><br />
$ git pull<br />
$ make -j4 all<br />
$ sudo make install<br />
</pre><br />
If extensive changes have occurred or if you get errors during the make, you may want to do a clean build <br />
<pre><br />
$ git pull<br />
$ make distclean<br />
$ sh cleanup.sh<br />
$ autoreconf -i<br />
$ ./configure<br />
$ make -j4 all<br />
$ sudo make install<br />
</pre><br />
If you continue to get errors, please report the whole ./configure output and the config.log to the mailing list.<br />
<br />
== Installation on Windows ==<br />
See [[ QtRadio on Windows]]<br />
<br />
== Network settings ==<br />
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.<br />
<br />
<br />
<br />
<br />
== Installing ghpsdr3-alex on Raspberry Pi == <br />
<br />
<br />
========== HARDWARE ==========<br />
<br />
*** THIS SECTION DEALS WITH Raspberry Pi DIFFERENCES *** IT DOES NOT CIRCUMVENT THE INSTRUCTIONS STARTING AT STEP 1 OF THE QtRadio Installation. ***<br />
<br />
I recommend installing either the raspbian or raspbian pisces (debian) distributions as there is no Ubuntu release to date.<br />
<br />
*** 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 <br />
document from the beginning after installing raspbian or raspbian pisces.<br />
<br />
<br />
The RasPi USB subsystem is sensitive to power supply voltage levels - A supply of 5.5V at 2A is recommended. <br />
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. <br />
<br />
Measuring the voltage across TP1 and TP2 on the Raspberry Pi and increased it to +4.97V (P.S output +5.59V).<br />
<br />
I also ran "rpi-update" which install new firmware. <br />
<br />
I shorted out the polyfuses F1 and F2 on the Pi and USB is much more stable but still limited.<br />
<br />
With keyboard, mouse, gigabit USB Ethernet, SB Live! 24 USB and RTL-SDR dongle it runs for some hours before it freezes.<br />
<br />
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.<br />
<br />
root@pisces:/usr/src/GHPSDR3_HIGH_SPEED_MASTER/ghpsdr3-alex# date<br />
<br />
Sun Sep 9 13:00:49 BST 2012<br />
<br />
root@pisces:/usr/src/GHPSDR3_HIGH_SPEED_MASTER/ghpsdr3-alex# uptime<br />
<br />
13:00:56 up 2 days, 20:46, 8 users, load average: 0.81, 1.01, 0.67<br />
<br />
<br />
<br />
<br />
****** Do not use power from a USB PC port or from a USB Hub. ********<br />
<br />
<br />
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):-<br />
<br />
Keyboard, mouse, usb sound card, RTL-SDR TV dongle and USB Gigabit Ethernet fully operational using the 7-port powered USB hub.<br />
<br />
root@pisces:~# lsusb<br />
<br />
Bus 001 Device 001: ID 1d6b:0002 Linux Foundation 2.0 root hub<br />
<br />
Bus 001 Device 002: ID 0424:9512 Standard Microsystems Corp. <br />
<br />
Bus 001 Device 003: ID 0424:ec00 Standard Microsystems Corp.<br />
<br />
Bus 001 Device 004: ID 04cc:1521 ST-Ericsson USB 2.0 Hub<br />
<br />
Bus 001 Device 011: ID 04f3:0103 Elan Microelectronics Corp. <br />
<br />
Bus 001 Device 006: ID 047d:1022 Kensington Orbit Optical<br />
<br />
Bus 001 Device 007: ID 1d19:1101 Dexatek Technology Ltd. DK DVB-T Dongle<br />
<br />
Bus 001 Device 008: ID 041e:3040 Creative Technology, Ltd SoundBlaster Live! 24-bit External SB0490<br />
<br />
Bus 001 Device 009: ID 0b95:1780 ASIX Electronics Corp. AX88178<br />
root@pisces:~# ifconfig <br />
<br />
eth0 Link encap:Ethernet HWaddr b8:27:eb:2c:07:c9<br />
<br />
inet addr:192.168.10.31 Bcast:192.168.10.255 Mask:255.255.255.0<br />
inet6 addr: fe80::ba27:ebff:fe2c:7c9/64 Scope:Link<br />
UP BROADCAST RUNNING MULTICAST MTU:1500 Metric:1<br />
RX packets:410 errors:0 dropped:0 overruns:0 frame:0<br />
TX packets:377 errors:0 dropped:0 overruns:0 carrier:0<br />
collisions:0 txqueuelen:1000<br />
RX bytes:28905 (28.2 KiB) TX bytes:35938 (35.0 KiB)<br />
<br />
eth1 Link encap:Ethernet HWaddr 00:10:14:00:9f:fa<br />
<br />
inet addr:192.168.2.199 Bcast:192.168.2.255 Mask:255.255.255.0<br />
inet6 addr: fe80::210:14ff:fe00:9ffa/64 Scope:Link<br />
UP BROADCAST RUNNING MULTICAST MTU:1500 Metric:1<br />
RX packets:5 errors:0 dropped:0 overruns:0 frame:0<br />
TX packets:7 errors:0 dropped:0 overruns:0 carrier:0<br />
collisions:0 txqueuelen:1000<br />
RX bytes:230 (230.0 B) TX bytes:592 (592.0 B)<br />
<br />
lo Link encap:Local Loopback<br />
<br />
inet addr:127.0.0.1 Mask:255.0.0.0<br />
inet6 addr: ::1/128 Scope:Host<br />
UP LOOPBACK RUNNING MTU:16436 Metric:1<br />
RX packets:0 errors:0 dropped:0 overruns:0 frame:0<br />
TX packets:0 errors:0 dropped:0 overruns:0 carrier:0<br />
collisions:0 txqueuelen:0<br />
RX bytes:0 (0.0 B) TX bytes:0 (0.0 B)<br />
<br />
root@pisces:~# cat /proc/asound/cards<br />
0 [ALSA ]: BRCM bcm2835 ALSbcm2835 ALSA - bcm2835 ALSA<br />
bcm2835 ALSA<br />
<br />
1 [External ]: USB-Audio - SB Live! 24-bit External<br />
Creative Technology SB Live! 24-bit External at usb-bcm2708_usb-1.2.2, full spe<br />
<br />
<br />
<br />
<br />
It's running at 855MHz with this config.txt file. <br />
root@pisces:~# cat /boot/config.txt<br />
<br />
over_voltage=6<br />
<br />
arm_freq=855<br />
<br />
core_freq=500<br />
<br />
sdram_freq=500<br />
<br />
<br />
root@pisces:~# cat /etc/network/interfaces<br />
<br />
Used by ifup(8) and ifdown(8). See the interfaces(5) manpage or<br />
/usr/share/doc/ifupdown/examples for more information. <br />
<br />
auto lo<br />
<br />
<br />
iface lo inet loopback<br />
<br />
<br />
File: ifcfg-eth0<br />
<br />
auto eth0<br />
<br />
iface eth0 inet static<br />
<br />
address 192.168.10.31<br />
<br />
netmask 255.255.255.0<br />
<br />
gateway 192.168.10.103<br />
<br />
<br />
auto eth1<br />
<br />
iface eth1 inet static<br />
<br />
address 192.168.2.199<br />
<br />
netmask 255.255.255.0<br />
<br />
<br />
root@pisces:~# cat /etc/modules<br />
<br />
/etc/modules: kernel modules to load at boot time.<br />
This file contains the names of kernel modules that should be loaded<br />
at boot time, one per line. Lines beginning with "#" are ignored.<br />
Parameters can be specified after the module name. <br />
<br />
loop<br />
<br />
snd-bcm2835<br />
<br />
<br />
One problem remains, no sound from the on-board chip.<br />
<br />
== SOFTWARE == <br />
***** START AT THE BEGINNING WHEN BUILDING THE SOFTWARE -- i.e Section 1 and install all the packages recommended and do the pulseaudio setup.<br />
<br />
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.<br />
<br />
Subject: [n2adr-sdr] Raspberry Pi running ghpsdr3-alex<br />
<br />
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.<br />
<br />
<br />
autoreconf -i <br />
<br />
./configure CFLAGS='-O3 -pipe -march=armv6 -mfpu=vfp -mfloat-abi=hard' CXXFLAGS='-O3 -pipe -march=armv6 -mfpu=vfp -mfloat-abi=hard' <br />
<br />
**** Additional steps needed when building rtlsdr-server. Do these before running make ******<br />
# export ac_cv_func_malloc_0_nonnull=yes<br />
# export ac_cv_func_realloc_0_nonnull=yes<br />
<br />
<br />
make all && make all install <br />
<br />
<br />
Sound on the Raspberry Pi is still a problem I have not been able to solve.<br />
<br />
Terry (WB4JFI) suggested the following that work for him but I have had no luck with it.<br />
<br />
"amixer cset numid=3 1"<br />
<br />
Other valid numid's are 0=auto, 1=headphones and 2=hdmi.<br />
<br />
<br />
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.<br />
<br />
When a slave connected and tried changing frequency, dspserver crashed - dspserver can be a bit crash happy.<br />
<br />
The first thing I tried on the Pi was QtRadio standalone, spectrum and waterfall were OK but no sound.<br />
<br />
Just now a client using glSDR (5) is attempting to change frequency, sound went quite distorted then dspserver crashed.<br />
<br />
Restarted dspserver and QtRadio sound started very distorted before it settled down to reasonable.</div>Frohrohttps://napan.ca/ghpsdr3/index.php?title=Utilities&diff=458Utilities2012-05-28T20:46:41Z<p>Frohro: /* Squelch activated cecordings */</p>
<hr />
<div>So, now you have QtRadio running. Let's have some fun and do some useful things.<br />
===Squelch activated recordings===<br />
stay tuned<br />
<br />
===Full featured recording script===<br />
Since we have QtRadio, we have a lot of Radios over the world, which cover the frequency spectrum nearly from dc to uhf. So it is often the case you come along some interesting, odd, seldom transmissions, which you ever wanted to record and maybe analyse later.<br />
<br />
The supplied script will, when started:<br />
*take you actual system time,<br />
*ask QtRadio for the actual tuned frequency,<br />
*will create a wav file stamped by the previos asked data (time+qrg.wav).<br />
*will, when you stopped recording, create a spectrum image from the recorded wav file.<br />
<br />
So, first we need some little helpful programms. Check if you already have or install:<br />
<br />
<pre><br />
sudo apt-get install sox<br />
</pre><br />
<pre><br />
sudo apt-get install hamlib-utils<br />
</pre><br />
<br />
Here is the recording script. Copy it into you favorite editor.<br />
<br />
<pre><br />
##!/bin/bash<br />
QRG="_$(exec rigctl -m2 -r 127.0.0.1:19090 f 2>&1)"<br />
NAME=`date +%Y%m%d%H%M`<br />
rec -r 8000 -c 1 $NAME$QRG.wav<br />
echo "processing spectrogram..."<br />
sox $NAME$QRG.wav -n spectrogram -x 1280 -y 720 -z 100 -t "$NAME$QRG.wav" -c '' -o $NAME$QRG.png<br />
echo "...done !"<br />
</pre><br />
<pre><br />
nano /usr/local/bin/qtradio_rec<br />
</pre><br />
make the script executable:<br />
<pre><br />
sudo chmod +x /usr/local/bin/qtradio_rec<br />
</pre><br />
Create you favorite recording location, for example:<br />
<pre><br />
mkdir QtRadio_Recordings<br />
</pre><br />
change to that directory:<br />
<pre><br />
cd QtRadio_Recordings<br />
</pre><br />
Fire up QtRadio before starting the recording-script and start the recording script from your recording directory:<br />
<pre><br />
qtradio_rec<br />
</pre><br />
you should now see this output from sox:<br />
<pre><br />
dl6kbg@ubuntu:~$ qtradio_rec <br />
<br />
Input File : 'default' (alsa)<br />
Channels : 1<br />
Sample Rate : 8000<br />
Precision : 16-bit<br />
Sample Encoding: 16-bit Signed Integer PCM<br />
<br />
In:0.00% 00:00:21.50 [00:00:00.00] Out:164k [ | ] Clip:0<br />
</pre><br />
<br />
while doing the first recording open pavucontrol and check if sox uses the right audio source. Select the following:<br />
<br />
[[File:Pavucontrol.png]]<br />
<br />
if you are done with your recording, press CRTL-C to quit the script and stop the recording. The script processes the spectrum image from the just recorded wave-file:<br />
<pre><br />
Aborted.<br />
processing spectrogram...<br />
...done !<br />
</pre><br />
when you now have a look into your recording directory, you should have something like this:<br />
<pre><br />
-rw-rw-r-- 1 dl6kbg dl6kbg 207665 2012-04-05 20:41 201204052041_3756000.png<br />
-rw-rw-r-- 1 dl6kbg dl6kbg 32812 2012-04-05 20:41 201204052041_3756000.wav<br />
</pre><br />
You now have a time and frequency stamped audio file and the spectrum view from that audio file.<br />
<br />
[[File:Sox_spec.png|200px]]<br />
<br />
So, if you never want to miss to make a recording, open a terminal every time you use QtRadio and change in that terminal to your recording directory.<br />
Fire up "qtradio_rec" whenever you hear something interesting.<br />
<br />
Enjoy and collect :-)<br />
<br />
===Frequency Scanning===<br />
stay tuned<br />
===Gnome Predict===<br />
stay tuned<br />
===WSPR===<br />
stay tuned</div>Frohrohttps://napan.ca/ghpsdr3/index.php?title=Main_Page&diff=453Main Page2012-05-17T00:29:09Z<p>Frohro: /* What is the actual ghpsdr3-alex Project software? */</p>
<hr />
<div>===[[What's New| What's New and latest news]]===<br />
=== '''The ghpsdr3-alex Project''' ===<br />
<br />
This is a modification of the excellent Software Defined Radio (SDR) software by John Melton [G0ORX/N6LYT][http://g0orx.blogspot.com]<br />
<br />
The original software by John is called ghpsdr3. We are working towards merging the two projects (ghpsdr3 and ghpsdr3-alex) source trees to a single source. However BEFORE that happens, you CANNOT mix and match programs from the two projects. See note for HPSDR hardware users below.<br />
<br />
Project README https://github.com/alexlee188/ghpsdr3-alex/blob/master/README [https://github.com/alexlee188/ghpsdr3-alex/blob/master/README]<br />
<br />
Source Code is via git at https://github.com/alexlee188/ghpsdr3-alex [https://github.com/alexlee188/ghpsdr3-alex]<br />
<br />
Discussions take place in the sdr-widget group http://groups.google.com/group/sdr-widget [http://groups.google.com/group/sdr-widget]<br />
<br />
You can browse the list of online dspservers at http://qtradio.napan.ca/qtradio/qtradio.pl[http://qtradio.napan.ca/qtradio/qtradio.pl]<br />
<br />
Currently it supports HPSDR, Softrock, UHFSDR, Microtelecom Perseus, SDR-iq, HiQSDR, Ettus Research USRP and rtl-sdr DVB-T dongles.<br />
<br />
=== '''What is the actual ghpsdr3-alex Project software?''' ===<br />
<br />
The software comprises 3 different components:<br />
<br />
'''A)''' server - there is a CLI based server for each type of hardware. For example, there are hpsdr-server, usrp-server, softrock (server), sdriq-server, HiQSDR etc. Some servers are based on soundcard/USB connections to the hardware. Some are connected via ethernet (eg HPSDR Metis).<br />
<br />
'''B)''' dspserver - this is the software in the middle that processes the IQ data from the server (connected over LAN via UDP) using DttSP. The same dspserver can connect to any of the servers in A.<br />
<br />
'''C)''' clients - this is the GUI user interface. There are clients built with Qt and runs on Windows, Linux, and Mac OSX. There is a working Android client that works on Android phones and Android tablets. The clients connect to dspserver via LAN or remotely via Internet. In future we will have java based web clients as well (either specifically written clients, or running Qt inside a web browser) Also, multiple clients can concurrently access the same dspserver. There is also RxTx capability (currently for voice modes). the QtRadio client has a Hamlib interface and can connect to gPredict, xLog, and fldigi (for digital mode)<br />
<br />
<br />
<br />
'''Project Goals'''<br />
<br />
1. Open source (GPL) SDR software<br />
<br />
2. Client-server network-enabled by design from the ground up<br />
<br />
3. Customized server for each SDR hardware type. Currently supporting HPSDR, Softrock, UHFSDR, Microtelecom Perseus, RFSPACE SDR-IQ, HiQSDR, Ettus Research USRP, and the rtl-sdr DVB-T dongle.<br />
<br />
4. Single dspserver that connects to single server. However, each server can have multiple Rx and Tx channels.<br />
<br />
5. Multiple clients, such as QtRadio, that can concurrently connect to a single dspserver.<br />
<br />
6. Full Rx and Tx capability for hardware capable of Tx<br />
<br />
<br />
<br />
*[[Screenshots and Recordings]] <br />
*[[QtRadio on Windows]]<br />
*[[QtRadio - Operation]]<br />
*[[QtRadio Installation]]<br />
*[[aHPSDR]] Android Client<br />
*[[Pulseaudio Setup]]<br />
*[[Developers Documentation]]<br />
*[[ToDo/- Wishlist]]<br />
*[[dspserver.conf]]<br />
<br />
<br />
'''Note for HPSDR and ghpsdr3 (original) users:'''<br />
In general, you cannot mix and match software from the two projects, ghpsdr3 and ghpsdr3-alex. However, John has updated the programs in the ghpsdr3-alex repository, and the hpsdr-server program in gphsdr3-alex works for HPSDR hardware. The following newbie guide is written by Erich Heinzle (vk5hse at yahoo.com):<br />
<br />
http://lists.openhpsdr.org/pipermail/hpsdr-openhpsdr.org/2011-December/016334.html[http://lists.openhpsdr.org/pipermail/hpsdr-openhpsdr.org/2011-December/016334.html]</div>Frohrohttps://napan.ca/ghpsdr3/index.php?title=Main_Page&diff=452Main Page2012-05-17T00:28:14Z<p>Frohro: /* What is the actual ghpsdr3-alex Project software? */</p>
<hr />
<div>===[[What's New| What's New and latest news]]===<br />
=== '''The ghpsdr3-alex Project''' ===<br />
<br />
This is a modification of the excellent Software Defined Radio (SDR) software by John Melton [G0ORX/N6LYT][http://g0orx.blogspot.com]<br />
<br />
The original software by John is called ghpsdr3. We are working towards merging the two projects (ghpsdr3 and ghpsdr3-alex) source trees to a single source. However BEFORE that happens, you CANNOT mix and match programs from the two projects. See note for HPSDR hardware users below.<br />
<br />
Project README https://github.com/alexlee188/ghpsdr3-alex/blob/master/README [https://github.com/alexlee188/ghpsdr3-alex/blob/master/README]<br />
<br />
Source Code is via git at https://github.com/alexlee188/ghpsdr3-alex [https://github.com/alexlee188/ghpsdr3-alex]<br />
<br />
Discussions take place in the sdr-widget group http://groups.google.com/group/sdr-widget [http://groups.google.com/group/sdr-widget]<br />
<br />
You can browse the list of online dspservers at http://qtradio.napan.ca/qtradio/qtradio.pl[http://qtradio.napan.ca/qtradio/qtradio.pl]<br />
<br />
Currently it supports HPSDR, Softrock, UHFSDR, Microtelecom Perseus, SDR-iq, HiQSDR, Ettus Research USRP and rtl-sdr DVB-T dongles.<br />
<br />
=== '''What is the actual ghpsdr3-alex Project software?''' ===<br />
<br />
The software comprises 3 different components:<br />
<br />
'''A)''' server - there is a CLI based server for each type of hardware. For example, there are hpsdr-server, usrp-server, softrock (server), sdriq-server, HiQSDR etc. Some servers are based on soundcard/USB connections to the hardware. Some are connected via ethernet (eg HPSDR Metis).<br />
<br />
'''B)''' dspserver - this is the software in the middle that processes the IQ data from the server (connected over LAN via UDP) using DttSP. The same dspserver can connect to any of the servers in A.<br />
<br />
'''C)''' clients - this is the GUI user interface. There are clients built with Qt and runs on Windows, Linux, and Mac OSX. There is a working Android client that works on Android phones and Android tablets. The clients connect to dspserver via LAN or remotely via Internet. In future we will have java based web clients as well (either specifically written clients, or running Qt inside a web browser) Also, multiple clients can concurrently access the same dspserver. There is also RxTx capability (currently for voice modes). the QtRadio client has a Hamlib interface and can connect to gPredict, xLog, and fldigi (for digital mode)<br />
<br />
<br />
<br />
'''Project Goals'''<br />
<br />
1. Open source (GPL) SDR software<br />
<br />
2. Client-server network-enabled by design from the ground up<br />
<br />
3. Customized server for each SDR hardware type. Currently supporting HPSDR, Softrock, UHFSDR, Microtelecom Perseus, RFSPACE SDR-IQ, HiQSDR, Ettus Research USRP, and the rtl SDR DVB-T dongle.<br />
<br />
4. Single dspserver that connects to single server. However, each server can have multiple Rx and Tx channels.<br />
<br />
5. Multiple clients, such as QtRadio, that can concurrently connect to a single dspserver.<br />
<br />
6. Full Rx and Tx capability for hardware capable of Tx<br />
<br />
<br />
<br />
*[[Screenshots and Recordings]] <br />
*[[QtRadio on Windows]]<br />
*[[QtRadio - Operation]]<br />
*[[QtRadio Installation]]<br />
*[[aHPSDR]] Android Client<br />
*[[Pulseaudio Setup]]<br />
*[[Developers Documentation]]<br />
*[[ToDo/- Wishlist]]<br />
*[[dspserver.conf]]<br />
<br />
<br />
'''Note for HPSDR and ghpsdr3 (original) users:'''<br />
In general, you cannot mix and match software from the two projects, ghpsdr3 and ghpsdr3-alex. However, John has updated the programs in the ghpsdr3-alex repository, and the hpsdr-server program in gphsdr3-alex works for HPSDR hardware. The following newbie guide is written by Erich Heinzle (vk5hse at yahoo.com):<br />
<br />
http://lists.openhpsdr.org/pipermail/hpsdr-openhpsdr.org/2011-December/016334.html[http://lists.openhpsdr.org/pipermail/hpsdr-openhpsdr.org/2011-December/016334.html]</div>Frohrohttps://napan.ca/ghpsdr3/index.php?title=Main_Page&diff=451Main Page2012-05-17T00:27:35Z<p>Frohro: /* What is the actual ghpsdr3-alex Project software? */</p>
<hr />
<div>===[[What's New| What's New and latest news]]===<br />
=== '''The ghpsdr3-alex Project''' ===<br />
<br />
This is a modification of the excellent Software Defined Radio (SDR) software by John Melton [G0ORX/N6LYT][http://g0orx.blogspot.com]<br />
<br />
The original software by John is called ghpsdr3. We are working towards merging the two projects (ghpsdr3 and ghpsdr3-alex) source trees to a single source. However BEFORE that happens, you CANNOT mix and match programs from the two projects. See note for HPSDR hardware users below.<br />
<br />
Project README https://github.com/alexlee188/ghpsdr3-alex/blob/master/README [https://github.com/alexlee188/ghpsdr3-alex/blob/master/README]<br />
<br />
Source Code is via git at https://github.com/alexlee188/ghpsdr3-alex [https://github.com/alexlee188/ghpsdr3-alex]<br />
<br />
Discussions take place in the sdr-widget group http://groups.google.com/group/sdr-widget [http://groups.google.com/group/sdr-widget]<br />
<br />
You can browse the list of online dspservers at http://qtradio.napan.ca/qtradio/qtradio.pl[http://qtradio.napan.ca/qtradio/qtradio.pl]<br />
<br />
Currently it supports HPSDR, Softrock, UHFSDR, Microtelecom Perseus, SDR-iq, HiQSDR, Ettus Research USRP and rtl-sdr DVB-T dongles.<br />
<br />
=== '''What is the actual ghpsdr3-alex Project software?''' ===<br />
<br />
The software comprises 3 different components:<br />
<br />
'''A)''' server - there is a CLI based server for each type of hardware. For example, there are hpsdr-server, usrp-server, softrock (server), sdriq-server, HiQSDR etc. Some servers are based on soundcard/USB connections to the hardware. Some are connected via ethernet (eg HPSDR Metis).<br />
<br />
'''B)''' dspserver - this is the software in the middle that processes the IQ data from the server (connected over LAN via UDP) using DttSP. The same dspserver can connect to any of the servers in A.<br />
<br />
'''C)''' clients - this is the GUI user interface. There are clients built with Qt and runs on Windows, Linux, and Mac OSX. There is a working Android client that works on Android phones and Android tablets. The clients connect to dspserver via LAN or remotely via Internet. In future we will have java based web clients as well (either specifically written clients, or running Qt inside a web browser) Also, multiple clients can concurrently access the same dspserver. There is also RxTx capability (currently for voice modes). the QtRadio client has a Hamlib interface and can connect to gPredict, xLog, and fldigi (for digital mode)<br />
<br />
<br />
<br />
'''Project Goals'''<br />
<br />
1. Open source (GPL) SDR software<br />
<br />
2. Client-server network-enabled by design from the ground up<br />
<br />
3. Customized server for each SDR hardware type. Currently supporting HPSDR, Softrock, UHFSDR, Microtelecom Perseus, RFSPACE SDR-IQ, HiQSDR, Ettus Research USRP, and rtl SDR DVB-T dongle.<br />
<br />
4. Single dspserver that connects to single server. However, each server can have multiple Rx and Tx channels.<br />
<br />
5. Multiple clients, such as QtRadio, that can concurrently connect to a single dspserver.<br />
<br />
6. Full Rx and Tx capability for hardware capable of Tx<br />
<br />
<br />
<br />
*[[Screenshots and Recordings]] <br />
*[[QtRadio on Windows]]<br />
*[[QtRadio - Operation]]<br />
*[[QtRadio Installation]]<br />
*[[aHPSDR]] Android Client<br />
*[[Pulseaudio Setup]]<br />
*[[Developers Documentation]]<br />
*[[ToDo/- Wishlist]]<br />
*[[dspserver.conf]]<br />
<br />
<br />
'''Note for HPSDR and ghpsdr3 (original) users:'''<br />
In general, you cannot mix and match software from the two projects, ghpsdr3 and ghpsdr3-alex. However, John has updated the programs in the ghpsdr3-alex repository, and the hpsdr-server program in gphsdr3-alex works for HPSDR hardware. The following newbie guide is written by Erich Heinzle (vk5hse at yahoo.com):<br />
<br />
http://lists.openhpsdr.org/pipermail/hpsdr-openhpsdr.org/2011-December/016334.html[http://lists.openhpsdr.org/pipermail/hpsdr-openhpsdr.org/2011-December/016334.html]</div>Frohrohttps://napan.ca/ghpsdr3/index.php?title=AHPSDR&diff=438AHPSDR2012-05-09T22:11:21Z<p>Frohro: /* Android client for listening to dspservers */</p>
<hr />
<div>==Android client for listening to dspservers==<br />
<br />
<br />
*The original APK can be downloaded HERE:[http://napan.com/ve9gj/aHPSDR.apk http://napan.com/ve9gj/aHPSDR.apk] <br />
[[File:QR_AHPSDR.png]]<br />
--------------------------<br />
*May 4 2012<br />
<br />
aHPSDR (opengl branch). This version uses opengl for waterfall display. Experimental. Uses opengl es v2.0 for waterfall display. Uses Orthographic 2D projection so should work in all devices in portrait and landscape orientations. With offloading of workload from CPU to GPU the app runs smoother and the audio is uninterrupted.<br />
http://code.google.com/p/sdr-widget/downloads/detail?name=aHPSDRgl.apk&can=2&q=<br />
<br />
<br />
*Apr 18 2012 New build of aHPSDR from the opengl branch. Improvements in the spectrum/waterfall refresh rates. Only works with Protocol-3 capable dspservers. Uses newer API's so may not work in older Android. WIP for opengl display - not activated yet.: [http://code.google.com/p/sdr-widget/downloads/detail?name=aHPSDR.apk&can=2&q=]<br />
*Feb 11 2012 Alternate download: [http://napan.com/ve9gj/aHPSDR.apk http://napan.com/ve9gj/aHPSDR.apk]<br />
*Feb 11 2012 svn: [http://svn.tapr.org/listing.php?repname=OpenHPSDR+Main&path=%2Ftrunk%2FN6LYT%2Fghpsdr3%2Fbranches%2Fandroid%2FaHPSDR%2Fbin%2F&#a94c80ff871066a17707aadbebe8526db TAPR svn]<br />
Change list for the Feb 11 2012 build: AHPSDR now has a Server list feature just like QtRadio look under >>menu >>Servers and select from among the active servers.<br />
--------------------------<br />
*Not current pre Feb 11 2012 build can be found HERE:[[http://qsl.net/kj6dzb/stuff/aHPSDR_pre_2_10_11.apk]]<br />
--------------------------<br />
* See the AHPSDR Android Client in use on YouTube:[http://www.youtube.com/watch?v=up-BEKxTTXs http://www.youtube.com/watch?v=up-BEKxTTXs]<br />
<br />
<br />
'''Set up a programming environment for aHPSDR'''<br />
<br />
<br />
Install Eclipse -I chose the "Eclipse Classic 3.7.x" and got it here: <http://www.eclipse.org/downloads/><br />
<br />
Download and set up the Android SDK and ADT plugins for Eclipse by following the instructions located here: <http://developer.android.com/sdk/installing.html><br />
<br />
You may also need to install Java. See the instruction at the bottom of the above link. <br />
<br />
Once all above is installed start Eclipse and go to the menu / Window and select the "Android SDK Manager" Here you add the API packages for the target Android platform(s.) <br />
<br />
John Melton's aHPSDR is currently written for Android 2.2, API level 8. Be sure to check the top level box for API level 8. It should also run well under API level 7 if your device is 2.1. You may have to adjust the properties to get it to build, though.<br />
<br />
Unless you want to tackle rewriting the application for a higher API level, you really don't need to download any of the higher levels, although it wont hurt anything.<br />
<br />
You can also install an android device simulator. You can bypass this step if you would rather test the .apk directly on your USB connected device. The simulators are quite slow and require patience when they initialize. The aHPSDR program runs slow and choppy as well (at least on my box -YMMV). You can set up the simulator from the Menu/ Window / AVD manager<br />
<br />
Get the aHPSDR sources from: svn co http://svn.tapr.org/repos_sdr_hpsdr/trunk/N6LYT/ghpsdr3/branches/android/ This will create a folder named android in you home directory.<br />
<br />
To get started create a new project: File / New / Project. From the select a Wizard window select Android / Android Project then click Next><br />
<br />
Give your project a new name then click Create project from existing source Then Browse to the location the sources are located home/android/aHPSDR then click Next.<br />
Select the target platform/API, Select Android 2.2 (Platform 2.2 API Level 8) then click Finish.<br />
<br />
You will now see your new project in the Package Explorer window on the left. Select it then from the Menu Run/ Run. When the window opens select run as android application then click OK<br />
<br />
Wait for the ADP simulator to initialize ( could take several minutes and you will have to unlock, etc just like the real device. ) Go to the applications on the device and select aHPSDR. <br />
<br />
Have fun!<br />
<br />
73, Kevin<br />
<br />
* If you rebuild aHPSDR for 2.3.3 and when you are using Android 2.3, the performance is improved a lot over the one built for 2.1, so following Kevin's instructions is better than just installing the default aHPSDR.apk with (from the platform-tools directory<br />
./adb install aHPSDR.apk</div>Frohrohttps://napan.ca/ghpsdr3/index.php?title=AHPSDR&diff=437AHPSDR2012-05-09T22:09:38Z<p>Frohro: /* Android client for listening to dspservers */</p>
<hr />
<div>==Android client for listening to dspservers==<br />
<br />
<br />
*The original APK can be downloaded HERE:[http://napan.com/ve9gj/aHPSDR.apk http://napan.com/ve9gj/aHPSDR.apk] <br />
[[File:QR_AHPSDR.png]]<br />
--------------------------<br />
*May 4 2012<br />
<br />
aHPSDR (opengl branch). This version uses opengl for waterfall display. Experimental. Uses opengl es v2.0 for waterfall display. Uses Orthographic 2D projection so should work in all devices in portrait and landscape orientations. With offloading of workload from CPU to GPU the app runs smoother and the audio is uninterrupted.<br />
http://code.google.com/p/sdr-widget/downloads/detail?name=aHPSDRgl.apk&can=2&q=<br />
<br />
<br />
*Apr 18 2012 New build of aHPSDR from the opengl branch. Improvements in the spectrum/waterfall refresh rates. Only works with Protocol-3 capable dspservers. Uses newer API's so may not work in older Android. WIP for opengl display - not activated yet.: [http://code.google.com/p/sdr-widget/downloads/detail?name=aHPSDR.apk&can=2&q=]<br />
*Feb 11 2012 Alternate download: [http://napan.com/ve9gj/aHPSDR.apk http://napan.com/ve9gj/aHPSDR.apk]<br />
*Feb 11 2012 svn: [http://svn.tapr.org/listing.php?repname=OpenHPSDR+Main&path=%2Ftrunk%2FN6LYT%2Fghpsdr3%2Fbranches%2Fandroid%2FaHPSDR%2Fbin%2F&#a94c80ff871066a17707aadbebe8526db TAPR svn]<br />
Change list for the Feb 11 2012 build: AHPSDR now has a Server list feature just like QtRadio look under >>menu >>Servers and select from among the active servers.<br />
--------------------------<br />
*Not current pre Feb 11 2012 build can be found HERE:[[http://qsl.net/kj6dzb/stuff/aHPSDR_pre_2_10_11.apk]]<br />
--------------------------<br />
* See the AHPSDR Android Client in use on YouTube:[http://www.youtube.com/watch?v=up-BEKxTTXs http://www.youtube.com/watch?v=up-BEKxTTXs]<br />
<br />
<br />
'''Set up a programming environment for aHPSDR'''<br />
<br />
<br />
Install Eclipse -I chose the "Eclipse Classic 3.7.x" and got it here: <http://www.eclipse.org/downloads/><br />
<br />
Download and set up the Android SDK and ADT plugins for Eclipse by following the instructions located here: <http://developer.android.com/sdk/installing.html><br />
<br />
You may also need to install Java. See the instruction at the bottom of the above link. <br />
<br />
Once all above is installed start Eclipse and go to the menu / Window and select the "Android SDK Manager" Here you add the API packages for the target Android platform(s.) <br />
<br />
John Melton's aHPSDR is currently written for Android 2.2, API level 8. Be sure to check the top level box for API level 8. It should also run well under API level 7 if your device is 2.1. You may have to adjust the properties to get it to build, though.<br />
<br />
Unless you want to tackle rewriting the application for a higher API level, you really don't need to download any of the higher levels, although it wont hurt anything.<br />
<br />
You can also install an android device simulator. You can bypass this step if you would rather test the .apk directly on your USB connected device. The simulators are quite slow and require patience when they initialize. The aHPSDR program runs slow and choppy as well (at least on my box -YMMV). You can set up the simulator from the Menu/ Window / AVD manager<br />
<br />
Get the aHPSDR sources from: svn co http://svn.tapr.org/repos_sdr_hpsdr/trunk/N6LYT/ghpsdr3/branches/android/ This will create a folder named android in you home directory.<br />
<br />
To get started create a new project: File / New / Project. From the select a Wizard window select Android / Android Project then click Next><br />
<br />
Give your project a new name then click Create project from existing source Then Browse to the location the sources are located home/android/aHPSDR then click Next.<br />
Select the target platform/API, Select Android 2.2 (Platform 2.2 API Level 8) then click Finish.<br />
<br />
You will now see your new project in the Package Explorer window on the left. Select it then from the Menu Run/ Run. When the window opens select run as android application then click OK<br />
<br />
Wait for the ADP simulator to initialize ( could take several minutes and you will have to unlock, etc just like the real device. ) Go to the applications on the device and select aHPSDR. <br />
<br />
Have fun!<br />
<br />
73, Kevin<br />
<br />
* I noted that if you rebuild aHPSDR for 2.3.3 and when you are using Android 2.3, the performance is improved a lot, so following Kevin's instructions is better than just installing the default aHPSDR.apk with (from the platform-tools directory<br />
./adb install aHPSDR.apk</div>Frohrohttps://napan.ca/ghpsdr3/index.php?title=Screenshots_and_Recordings&diff=385Screenshots and Recordings2012-02-19T07:09:12Z<p>Frohro: </p>
<hr />
<div>== Various QtRadio Recordings ==<br />
<br />
Glenn's Windows QtRadio on an XP Virtual Machine: http://www.youtube.com/watch?v=0A5MaSYL6mk<br />
<br />
Glenn demonstrating 3 connections to Kevin's server where the slaves follow master's tuning: http://www.youtube.com/watch?v=EAWkHErtO7U<br />
<br />
Sid's Beagleboard XM and QtRadio on napan.ca - 8000 1 aLaw: http://www.youtube.com/watch?v=LB8Vxb07Ph8 <br />
<br />
Alex testing TX on the rxtx-event branch: http://www.youtube.com/watch?v=oc9TuJucD48&feature=related<br />
<br />
Alex listening in on 15M in VE9 from Singapore: http://www.youtube.com/watch?v=X-pSa5cHq6A&feature=related<br />
<br />
Alex listening in on 10M, kb0omm from Singapore: http://youtu.be/Rt8E0hHMwMY<br />
<br />
Oliver's TX Signal received on 10 Meter by a Softrock RXTX: http://www.youtube.com/watch?v=vsIdDfSHsWA<br />
<br />
Oliver - QtRadio Zapping on a new Server: http://www.youtube.com/watch?v=yY_mUzj357s<br />
<br />
Android Client: http://www.youtube.com/watch?v=up-BEKxTTXs<br />
<br />
Alex - Tx spectrum displayed: http://youtu.be/I4ya56LYUQ0<br />
<br />
Oliver with UHFSDR TXing at 2-Meter: http://www.youtube.com/watch?v=Okx_tCu4hcs<br />
<br />
Oliver rcv with UHFSDR on 70cm: http://www.youtube.com/watch?v=5qr9rmz0OSo<br />
<br />
Oliver rcv with UHFSDR HO-68 Satellite in CW (95mW): http://www.youtube.com/watch?v=fwHSIyLsb54<br />
<br />
Alberto IZ0CEZ with USRP: http://www.youtube.com/watch?v=mD9tUWV_Y-Q<br />
<br />
Frank DG1SBG running QtRadio on OSX http://www.youtube.com/watch?v=LaWnr6Pn3ek<br />
<br />
Rob, KL7NA's TX audio as recorded by Rit, N4BNM. http://people.wallawalla.edu/~rob.frohne/ghpsdr3-alex/KL7NA.wav<br />
<br />
== Various QtRadio Screenshots ==<br />
<gallery><br />
File:Qtradio-cqww-2011-sa5bke.png|QtRadio from CQWW October 2011 running in Ubuntu 10.04<br />
File:QtRadioFedoraXFCE.png|QtRadio running on GNU Linux/Fedora 16 XFCE<br />
File:QtRadioOnUbuntu-iw0hdv.png|QtRadio running on GNU Linux/Ubuntu<br />
File:2011-11-26 CQWWCW qtradio ve9gj 28-MHz.jpg|QtRadio on Windows listening to CQWW CQ<br />
File:QtRadio-Fldigi.png| fldigi using QtRadio including Rig Control via hamlib<br />
File:QtRadiowCQRLog.jpg| CQRLog and QtRadio working together via QtRadio's hamlib interface<br />
</gallery><br />
<br />
== Ghpsdr3-usb-boot ==<br />
<gallery><br />
File:Ghpsdr3-usb-boot_1.jpg<br />
</gallery><br />
<br />
== How to make videos in Ubuntu ==<br />
<br />
In Ubuntu videos are easily recorded with recordmydesktop.<br />
<br />
<pre><br />
sudo apt-get install recordmydesktop<br />
</pre><br />
<br />
Change to a terminal window and type:<br />
<pre><br />
~$ recordmydesktop<br />
</pre><br />
In pavucontrol select the wanted audio source.<br />
<br />
Before you upload the recorded ogg video file to Youtube, it has to be converted:<br />
<br />
<pre><br />
sudo apt-get install mencoder<br />
</pre><br />
<pre><br />
mencoder foo.ogv -o foo.avi -oac mp3lame -lameopts fast:preset=standard -ovc lavc -lavcopts vcodec=mpeg4:vbitrate=4000 <br />
</pre><br />
<br />
== How to take screenshots in Ubuntu ==<br />
<br />
[http://tips.webdesign10.com/how-to-take-a-screenshot-with-ubuntu-linux Taking Screenshots in Ubuntu ]</div>Frohrohttps://napan.ca/ghpsdr3/index.php?title=Dspserver.conf&diff=367Dspserver.conf2012-02-12T18:32:35Z<p>Frohro: /* dspserver.conf */</p>
<hr />
<div>==dspserver.conf==<br />
<br />
*As of version Feb 01 2012 dspserver will now require a dspserver conf file. By default it will be created in a users home directory if one does not exist. dspserver may be started with an alternate file using the --shareconfig option.<br />
<br />
'''The original file contained:'''<br />
<nowiki># Simple config file for ghpsdr3's dspserver.<br />
# default file is located at ~/dspserver.conf when dsp server is started with --share<br />
# The information below will be supplied to a web database which will aid QtRadio<br />
# users find active dspservers to connect to. You may also see the current list at<br />
# http://napan.ca/qtradio/qtradio.pl<br />
# valid fields are call, location, band, rig and ant<br />
# lines must end with ; and any characters after a # is a comment and ignored<br />
# field values must be enclosed with " ie: "xxxx"<br />
# This default file will be created if dspserver is started with the --share option and ~/dspserver.conf does not exist<br />
# You may also start dspserver with an alternate config file by starting dspserver with --shareconfig /home/alternate_filename.conf<br />
# Note field names are all lowercase!<br />
<br />
call = "VE9GJ";<br />
location = "Napan, NB FN77";<br />
band = "20, 15, 10";<br />
rig = "SoftRock rxtx-event";<br />
ant = "4el Yagi Pointed NE";</nowiki><br />
<br />
'''New Sections as of Feb 01 2012:'''<br />
* share and lookupcountry can now be set in the conf file<br />
<nowiki>share = "yes"; # Can be yes, no<br />
lookupcountry = "yes"; # Can be yes, no </nowiki><br />
<br />
* TX needs to be set if not''' TX will be disabled'''<br />
<nowiki>tx = "password"; #Can be: no, yes, password</nowiki><br />
'''tx= no''' will disable all TX<br><br />
'''tx=yes''' will allow all TX dspserver will behave as before Feb 01 2012 version<br><br />
'''tx=password''' will require a user/password pair when sending a mox command and will be checked against the TX rules for that user before TX is allowed This is handled automatically by QtRadio.<br><br />
* User / passwords are added one per line<br />
<br />
<nowiki>ve9gj = "secretpassword"; #add users/passwords one per line (max 20 characters each!)<br />
dl6kbg="hissecret";<br />
zl2apv="anothersecret";</nowiki><br />
<br />
* Multiple rule groups are allowed so permissions can be set by group. You need to list any group names you want to use in the groupnames line. Limit 20 characters and avoid spaces<br />
<nowiki>groupnames = ["txrulesall", "txrules20m_only"];</nowiki><br />
* Now each groupname needs a line that lists it's members. Use the group name with _members appended to it. ''Note the format = [ "user1", "user2"];''<br />
<nowiki>txrulesall_members = ["ve9gj"]; <br />
txrules20m_only_members = ["ve9gj","zl2apv","dl6kbg"];</nowiki><br />
<br />
* Now each rule group need it's own section one line per rule rule are defined as mode, start Mhz, end Mhz. ''Note the format =( ("mode", 7.0, 7.1), ("mode",1.8, 2.0) );''<br />
<nowiki>txrulesall = (<br />
("*",1.8,30.0) # mode, StartFreq Mhz, EndFreq Mhz<br />
);<br />
txrules20m_only = (<br />
("CW",14.0,14.1), # mode, StartFreq Mhz, EndFreq Mhz<br />
("SSB",14.1,14.35), # mode, StartFreq Mhz, EndFreq Mhz<br />
("AM",14.3,14.35)<br />
);</nowiki><br />
<br />
Mode needs to be in double quotes "AM"<br><br />
Mode can use "*" to mean any mode allowed<br><br />
Frequencies are in Mhz with the decimal point<br><br />
The first rule that matches will allow TX<br><br />
the User / Pass is sent with every MOX command so if a connection fails and another user somehow happens to attach as the wrong connected client he still cannot TX without the password<br><br />
<br />
* On the QtRadio Configure-->Transmit Tab you will find a table to save user passwords for specific servers. The server name is the same as what is on the Quick connect list and will now show up in the Main Window title bar. <br />
* When QtRadio connects to a >= Feb 01 2012 dspserver it will check this table for a saved user pass and automatically send it when clicking the tune or mox buttons.<br />
* Still to come is feed back to QtRadio when TX has been denied. At the moment TX just fails. The dspserver console will list the user name that attempt to TX.<br />
<br />
73</div>Frohrohttps://napan.ca/ghpsdr3/index.php?title=Developers_Documentation&diff=184Developers Documentation2011-11-23T03:10:02Z<p>Frohro: </p>
<hr />
<div>*[https://github.com/alexlee188/ghpsdr3-alex Git Repository ]<br />
*[https://github.com/alexlee188/ghpsdr3-alex/blob/master/README README]<br />
*[http://code.google.com/p/sdr-shell/wiki/SDRCore Dttsp]<br />
*[http://www.youtube.com/watch?v=6KtOzh0StTc A Very good video tutorial series on using QT and C++]<br />
*[http://openhpsdr.org/wiki/index.php?title=Ghpsdr3 A Brief Description on the architecture of ghpsdr3]<br />
*[http://openhpsdr.org/wiki/images/4/47/Ghpsdr3-protocols2010-08-07.pdf Ghpsdr3 communication protocols 2010-08-07]<br />
*[http://openhpsdr.org/wiki/index.php?title=Ghpsdr3_protocols More on the Ghpsdr communications protocols (and more up to date)]<br />
<br />
Most of the development discussion has been taking place on the [http://groups.google.com/group/sdr-widget sdr-widget google group].</div>Frohrohttps://napan.ca/ghpsdr3/index.php?title=Developers_Documentation&diff=183Developers Documentation2011-11-23T03:07:06Z<p>Frohro: </p>
<hr />
<div>*[https://github.com/alexlee188/ghpsdr3-alex Git Repository ]<br />
*[https://github.com/alexlee188/ghpsdr3-alex/blob/master/README README]<br />
*[http://code.google.com/p/sdr-shell/wiki/SDRCore Dttsp]<br />
*[http://www.youtube.com/watch?v=6KtOzh0StTc A Very good video tutorial series on using QT and C++]<br />
*[http://openhpsdr.org/wiki/index.php?title=Ghpsdr3 A Brief Description on the architecture of ghpsdr3]<br />
*[http://openhpsdr.org/wiki/images/4/47/Ghpsdr3-protocols2010-08-07.pdf Ghpsdr3 communication protocols 2010-08-07]<br />
<br />
Most of the development discussion has been taking place on the [http://groups.google.com/group/sdr-widget sdr-widget google group].</div>Frohrohttps://napan.ca/ghpsdr3/index.php?title=Developers_Documentation&diff=182Developers Documentation2011-11-23T02:56:00Z<p>Frohro: </p>
<hr />
<div>*[https://github.com/alexlee188/ghpsdr3-alex Git Repository ]<br />
*[https://github.com/alexlee188/ghpsdr3-alex/blob/master/README README]<br />
*[http://code.google.com/p/sdr-shell/wiki/SDRCore Dttsp]<br />
*[http://www.youtube.com/watch?v=6KtOzh0StTc A Very good video tutorial series on using QT and C++]<br />
*[http://openhpsdr.org/wiki/index.php?title=Ghpsdr3 A Brief Description on the architecture of ghpsdr3]<br />
*[http://openhpsdr.org/wiki/images/4/47/Ghpsdr3-protocols2010-08-07.pdf Ghpsdr3 communication protocols 2010-08-07]</div>Frohrohttps://napan.ca/ghpsdr3/index.php?title=Developers_Documentation&diff=181Developers Documentation2011-11-23T02:55:29Z<p>Frohro: </p>
<hr />
<div>*[https://github.com/alexlee188/ghpsdr3-alex Git Repository ]<br />
*[https://github.com/alexlee188/ghpsdr3-alex/blob/master/README README]<br />
*[http://code.google.com/p/sdr-shell/wiki/SDRCore Dttsp]<br />
*[http://www.youtube.com/watch?v=6KtOzh0StTc A Very good video tutorial series on using QT and C++]<br />
*[http://openhpsdr.org/wiki/index.php?title=Ghpsdr3 A Brief Description on the architecture of ghpsdr3]<br />
*[http://openhpsdr.org/wiki/images/4/47/Ghpsdr3-protocols2010-08-07.pdf ghpsdr3 communication protocols 2010-08-07]</div>Frohrohttps://napan.ca/ghpsdr3/index.php?title=Developers_Documentation&diff=180Developers Documentation2011-11-23T02:18:22Z<p>Frohro: </p>
<hr />
<div>*[https://github.com/alexlee188/ghpsdr3-alex Git Repository ]<br />
*[https://github.com/alexlee188/ghpsdr3-alex/blob/master/README README]<br />
*[http://code.google.com/p/sdr-shell/wiki/SDRCore Dttsp]<br />
*[http://www.youtube.com/watch?v=6KtOzh0StTc A Very good video tutorial series on using QT and C++]<br />
*[http://openhpsdr.org/wiki/index.php?title=Ghpsdr3 A Brief Description on the architecture of ghpsdr3]</div>Frohrohttps://napan.ca/ghpsdr3/index.php?title=Main_Page&diff=147Main Page2011-11-16T00:19:08Z<p>Frohro: </p>
<hr />
<div>=== '''The ghpsdr3-alex Project''' ===<br />
<br />
This is a modification of the excellent Software Defined Radio (SDR) software by John Melton ([G0ORX/N6LYT][http://g0orx.blogspot.com]<br />
<br />
The original software by John is called ghpsdr3. We are working towards merging the two projects (ghpsdr3 and ghpsdr3-alex) source trees to a single source. However BEFORE that happens, you CANNOT mix and match programs from the two projects. See note for HPSDR hardware users below.<br />
<br />
Project README https://github.com/alexlee188/ghpsdr3-alex/blob/master/README [https://github.com/alexlee188/ghpsdr3-alex/blob/master/README]<br />
<br />
Source Code is via git at https://github.com/alexlee188/ghpsdr3-alex [https://github.com/alexlee188/ghpsdr3-alex]<br />
<br />
<br />
<br />
'''Project Goals'''<br />
<br />
1. Open source (GPL) SDR software<br />
<br />
2. Client-server network-enabled by design from the ground up<br />
<br />
3. Customized server for each SDR hardware type. Currently supporting hpsdr, softrock, Perseus, and Ettus usrp.<br />
<br />
4. Single dspserver that connects to single server. However, each server can have multiple Rx and Tx channels.<br />
<br />
5. Multiple clients, such as QtRadio, that can concurrently connect to a single dspserver.<br />
<br />
6. Full Rx and Tx capability for hardware capable of Tx<br />
<br />
<br />
<br />
*[[Screenshots and Recordings]] <br />
*[[QtRadio on Windows]]<br />
*[[QtRadio - Operation]]<br />
*[[QtRadio Installation]]<br />
*[[Pulseaudio Setup]]<br />
*[[Developers Documentation]]<br />
*[[ToDo/- Wishlist]]<br />
<br />
<br />
'''Note for HPSDR and ghpsdr3 (original) users:'''<br />
In general, you cannot mix and match software from the two projects, ghpsdr3 and ghpsdr3-alex. However, the following MAY work:<br />
<br />
1. Use the server (for hpsdr hardware) from the ghpsdr3 project to connect to your hpsdr hardware;<br />
<br />
2. Use the QtRadio and dspserver from the ghpsdr3-alex project to connect to server;<br />
<br />
3. It will work for Rx only, where the Rx IQ stream from the server will be sent to dspserver and then QtRadio, and the QtRadio client will be able to display the Rx spectrum and decoded audio;<br />
<br />
4. dspserver from ghpsdr3-alex will NOT send the decoded Rx audio back to the server and hpsdr hardware for playback;<br />
<br />
5. You cannot use the Tx function yet;<br />
<br />
6. You cannot use other clients, such as Java or Android from the ghpsdr3 project to connect to the dspserver from ghpsdr3-alex.</div>Frohrohttps://napan.ca/ghpsdr3/index.php?title=Developers_Documentation&diff=59Developers Documentation2011-11-12T16:51:23Z<p>Frohro: </p>
<hr />
<div>*[https://github.com/alexlee188/ghpsdr3-alex Git Repository ]<br />
*[https://github.com/alexlee188/ghpsdr3-alex/blob/master/README README]<br />
*[http://code.google.com/p/sdr-shell/wiki/SDRCore Dttsp]<br />
*[http://www.youtube.com/watch?v=6KtOzh0StTc A Very good video tutorial series on using QT and C++]</div>Frohro