Ghpsdr3 SDR project - User contributions [en]

QtRadio Installation

2011-11-14T21:05:05Z

94.39.9.239: /* Building the rxtx-event branch */

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

=== Installation from PPA ===
For Ubuntu Users there is a ppa for the binaries produced from the master branch, maintained by Andrea.
Supported versions are:
Ubuntu Lucid,
Ubuntu Natty,
Ubuntu Oneiric, and known to work, Linux Mint 11 

At the time of this writing, (Nov 12 2011) PPA release 1.7 is online. 

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

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

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

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

<ul>

<li>Start the Synaptic Package Manager
<li>From the menu ''Settings'' select ''Repositories'', a dialog box ''Software Sources'' will be shown
<li>On the first pane ''Ubuntu Software'' check the ''Community-maintaned Open Source Software (universe)'' tick
<li>On the second pane ''Other Software'' click on the add button, and, in the dialog ''software-properties-gtk'' enter 
'''ppa:andrew-montefusco/ghpsdr3'''
<li>Back to the ''Software sources'' dialog, press ''Close''
<li>Press the ''Reload'' button on the top bar of main window
<li>Press the ''Section'' button (bottom left pane) and next select ''Amateur Radio'' and, on the right pane, the ghpsdr3 package
<li>Press ''Apply'' button on the top bar: answer '''yes''', if so requested, in order to install the required dependencies
</ul>

 

You will then find the QtRadio app in the ''Applications'', ''Internet menu.'' If you have the ''Hamradio'' menu installed you will find it there also. 
Subsequently you can use the Ubuntu software update process to update to the latest ppa version. 
More information about Andrea's PPA is at https://launchpad.net/~andrew-montefusco/+archive/ghpsdr3

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

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

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

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

==== Installing prerequisite packages ====

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

Next, you will need the following packages installed.

===== Ubuntu 11.04 and older =====

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

===== Ubuntu 11.10 =====
<pre>
sudo apt-get install libqt4-opengl-dev
sudo apt-get install libusb-0.1-4
sudo apt-get install libusb-dev
sudo apt-get install libfftw3-dev
sudo apt-get install portaudio19-dev
sudo apt-get install libpulse-dev
sudo apt-get install libsamplerate0-dev
sudo apt-get install libusb-1.0-0-dev
sudo apt-get install libconfig8-dev
sudo apt-get install libtool
sudo apt-get install qtmobility-dev
</pre>

==== Installing Git ====

Now you can install git

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

==== Cloning the repository ====

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

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

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

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

Then download the new version from:

http://libevent.org/

libevent-2.0.15-stable.tar.gz

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

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

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

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

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

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

If you don't have subversion installed you will need to get it

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

Now go get codec2 using subversion

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

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

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

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

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

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

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

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

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

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

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

QtRadio Installation

2011-11-14T21:04:32Z

94.39.9.239: /* Building the rxtx-event branch */

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

=== Installation from PPA ===
For Ubuntu Users there is a ppa for the binaries produced from the master branch, maintained by Andrea.
Supported versions are:
Ubuntu Lucid,
Ubuntu Natty,
Ubuntu Oneiric, and known to work, Linux Mint 11 

At the time of this writing, (Nov 12 2011) PPA release 1.7 is online. 

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

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

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

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

<ul>

<li>Start the Synaptic Package Manager
<li>From the menu ''Settings'' select ''Repositories'', a dialog box ''Software Sources'' will be shown
<li>On the first pane ''Ubuntu Software'' check the ''Community-maintaned Open Source Software (universe)'' tick
<li>On the second pane ''Other Software'' click on the add button, and, in the dialog ''software-properties-gtk'' enter 
'''ppa:andrew-montefusco/ghpsdr3'''
<li>Back to the ''Software sources'' dialog, press ''Close''
<li>Press the ''Reload'' button on the top bar of main window
<li>Press the ''Section'' button (bottom left pane) and next select ''Amateur Radio'' and, on the right pane, the ghpsdr3 package
<li>Press ''Apply'' button on the top bar: answer '''yes''', if so requested, in order to install the required dependencies
</ul>

 

You will then find the QtRadio app in the ''Applications'', ''Internet menu.'' If you have the ''Hamradio'' menu installed you will find it there also. 
Subsequently you can use the Ubuntu software update process to update to the latest ppa version. 
More information about Andrea's PPA is at https://launchpad.net/~andrew-montefusco/+archive/ghpsdr3

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

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

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

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

==== Installing prerequisite packages ====

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

Next, you will need the following packages installed.

===== Ubuntu 11.04 and older =====

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

===== Ubuntu 11.10 =====
<pre>
sudo apt-get install libqt4-opengl-dev
sudo apt-get install libusb-0.1-4
sudo apt-get install libusb-dev
sudo apt-get install libfftw3-dev
sudo apt-get install portaudio19-dev
sudo apt-get install libpulse-dev
sudo apt-get install libsamplerate0-dev
sudo apt-get install libusb-1.0-0-dev
sudo apt-get install libconfig8-dev
sudo apt-get install libtool
sudo apt-get install qtmobility-dev
</pre>

==== Installing Git ====

Now you can install git

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

==== Cloning the repository ====

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

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

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

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

Then download the new version from:

http://libevent.org/

libevent-2.0.15-stable.tar.gz

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

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

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

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

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

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

If you don't have subversion installed you will need to get it

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

Now go get codec2 using subversion

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

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

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

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

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

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

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

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

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

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

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

QtRadio Installation

2011-11-14T21:02:40Z

94.39.9.239: /* Building the rxtx-event branch */

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

=== Installation from PPA ===
For Ubuntu Users there is a ppa for the binaries produced from the master branch, maintained by Andrea.
Supported versions are:
Ubuntu Lucid,
Ubuntu Natty,
Ubuntu Oneiric, and known to work, Linux Mint 11 

At the time of this writing, (Nov 12 2011) PPA release 1.7 is online. 

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

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

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

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

<ul>

<li>Start the Synaptic Package Manager
<li>From the menu ''Settings'' select ''Repositories'', a dialog box ''Software Sources'' will be shown
<li>On the first pane ''Ubuntu Software'' check the ''Community-maintaned Open Source Software (universe)'' tick
<li>On the second pane ''Other Software'' click on the add button, and, in the dialog ''software-properties-gtk'' enter 
'''ppa:andrew-montefusco/ghpsdr3'''
<li>Back to the ''Software sources'' dialog, press ''Close''
<li>Press the ''Reload'' button on the top bar of main window
<li>Press the ''Section'' button (bottom left pane) and next select ''Amateur Radio'' and, on the right pane, the ghpsdr3 package
<li>Press ''Apply'' button on the top bar: answer '''yes''', if so requested, in order to install the required dependencies
</ul>

 

You will then find the QtRadio app in the ''Applications'', ''Internet menu.'' If you have the ''Hamradio'' menu installed you will find it there also. 
Subsequently you can use the Ubuntu software update process to update to the latest ppa version. 
More information about Andrea's PPA is at https://launchpad.net/~andrew-montefusco/+archive/ghpsdr3

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

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

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

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

==== Installing prerequisite packages ====

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

Next, you will need the following packages installed.

===== Ubuntu 11.04 and older =====

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

===== Ubuntu 11.10 =====
<pre>
sudo apt-get install libqt4-opengl-dev
sudo apt-get install libusb-0.1-4
sudo apt-get install libusb-dev
sudo apt-get install libfftw3-dev
sudo apt-get install portaudio19-dev
sudo apt-get install libpulse-dev
sudo apt-get install libsamplerate0-dev
sudo apt-get install libusb-1.0-0-dev
sudo apt-get install libconfig8-dev
sudo apt-get install libtool
sudo apt-get install qtmobility-dev
</pre>

==== Installing Git ====

Now you can install git

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

==== Cloning the repository ====

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

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

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

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

Then download the new version from:

http://libevent.org/

libevent-2.0.15-stable.tar.gz

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

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

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

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

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

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

If you don't have subversion installed you will need to get it

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

Now go get codec2 using subversion

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

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

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

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

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

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

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

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

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

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

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

QtRadio Installation

2011-11-14T21:00:49Z

94.39.9.239: /* Installing codec2 low bit rate audio encoding and decoding */

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

=== Installation from PPA ===
For Ubuntu Users there is a ppa for the binaries produced from the master branch, maintained by Andrea.
Supported versions are:
Ubuntu Lucid,
Ubuntu Natty,
Ubuntu Oneiric, and known to work, Linux Mint 11 

At the time of this writing, (Nov 12 2011) PPA release 1.7 is online. 

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

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

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

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

<ul>

<li>Start the Synaptic Package Manager
<li>From the menu ''Settings'' select ''Repositories'', a dialog box ''Software Sources'' will be shown
<li>On the first pane ''Ubuntu Software'' check the ''Community-maintaned Open Source Software (universe)'' tick
<li>On the second pane ''Other Software'' click on the add button, and, in the dialog ''software-properties-gtk'' enter 
'''ppa:andrew-montefusco/ghpsdr3'''
<li>Back to the ''Software sources'' dialog, press ''Close''
<li>Press the ''Reload'' button on the top bar of main window
<li>Press the ''Section'' button (bottom left pane) and next select ''Amateur Radio'' and, on the right pane, the ghpsdr3 package
<li>Press ''Apply'' button on the top bar: answer '''yes''', if so requested, in order to install the required dependencies
</ul>

 

You will then find the QtRadio app in the ''Applications'', ''Internet menu.'' If you have the ''Hamradio'' menu installed you will find it there also. 
Subsequently you can use the Ubuntu software update process to update to the latest ppa version. 
More information about Andrea's PPA is at https://launchpad.net/~andrew-montefusco/+archive/ghpsdr3

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

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

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

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

==== Installing prerequisite packages ====

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

Next, you will need the following packages installed.

===== Ubuntu 11.04 and older =====

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

===== Ubuntu 11.10 =====
<pre>
sudo apt-get install libqt4-opengl-dev
sudo apt-get install libusb-0.1-4
sudo apt-get install libusb-dev
sudo apt-get install libfftw3-dev
sudo apt-get install portaudio19-dev
sudo apt-get install libpulse-dev
sudo apt-get install libsamplerate0-dev
sudo apt-get install libusb-1.0-0-dev
sudo apt-get install libconfig8-dev
sudo apt-get install libtool
sudo apt-get install qtmobility-dev
</pre>

==== Installing Git ====

Now you can install git

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

==== Cloning the repository ====

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

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

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

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

Then download the new version from:

http://libevent.org/

libevent-2.0.15-stable.tar.gz

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

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

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

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

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

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

If you don't have subversion installed you will need to get it

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

Now go get codec2 using subversion

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

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

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

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

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

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

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

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

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

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

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

QtRadio Installation

2011-11-14T21:00:24Z

94.39.9.239: /* Obtaining an up-level libevent library */

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

=== Installation from PPA ===
For Ubuntu Users there is a ppa for the binaries produced from the master branch, maintained by Andrea.
Supported versions are:
Ubuntu Lucid,
Ubuntu Natty,
Ubuntu Oneiric, and known to work, Linux Mint 11 

At the time of this writing, (Nov 12 2011) PPA release 1.7 is online. 

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

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

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

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

<ul>

<li>Start the Synaptic Package Manager
<li>From the menu ''Settings'' select ''Repositories'', a dialog box ''Software Sources'' will be shown
<li>On the first pane ''Ubuntu Software'' check the ''Community-maintaned Open Source Software (universe)'' tick
<li>On the second pane ''Other Software'' click on the add button, and, in the dialog ''software-properties-gtk'' enter 
'''ppa:andrew-montefusco/ghpsdr3'''
<li>Back to the ''Software sources'' dialog, press ''Close''
<li>Press the ''Reload'' button on the top bar of main window
<li>Press the ''Section'' button (bottom left pane) and next select ''Amateur Radio'' and, on the right pane, the ghpsdr3 package
<li>Press ''Apply'' button on the top bar: answer '''yes''', if so requested, in order to install the required dependencies
</ul>

 

You will then find the QtRadio app in the ''Applications'', ''Internet menu.'' If you have the ''Hamradio'' menu installed you will find it there also. 
Subsequently you can use the Ubuntu software update process to update to the latest ppa version. 
More information about Andrea's PPA is at https://launchpad.net/~andrew-montefusco/+archive/ghpsdr3

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

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

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

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

==== Installing prerequisite packages ====

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

Next, you will need the following packages installed.

===== Ubuntu 11.04 and older =====

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

===== Ubuntu 11.10 =====
<pre>
sudo apt-get install libqt4-opengl-dev
sudo apt-get install libusb-0.1-4
sudo apt-get install libusb-dev
sudo apt-get install libfftw3-dev
sudo apt-get install portaudio19-dev
sudo apt-get install libpulse-dev
sudo apt-get install libsamplerate0-dev
sudo apt-get install libusb-1.0-0-dev
sudo apt-get install libconfig8-dev
sudo apt-get install libtool
sudo apt-get install qtmobility-dev
</pre>

==== Installing Git ====

Now you can install git

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

==== Cloning the repository ====

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

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

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

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

Then download the new version from:

http://libevent.org/

libevent-2.0.15-stable.tar.gz

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

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

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

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

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

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

If you don't have subversion installed you will need to get it

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

Now go get codec2 using subversion

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

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

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

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

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

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

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

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

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

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

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

Pulseaudio Setup

2011-11-13T19:31:16Z

94.39.9.239:

To run the softrock server use:
<pre>
pavucontrol
</pre>

In order to install it, submit the following command:

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

to choose the default pulse audio sources:

For TX Audio
<pre>
Softrock:IQ = shared ID for use with libusb Analog Stereo
</pre>

and for RX Audio:
<pre>
Softrock:IQ = shared ID for use with libusb Analog Stereo
</pre>

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

In order to install it, submit the following command:

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

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

'''Pulseaudio Setup independant on a X-Server installation '''

Make sure you add your username to the following system groups:
<ul>
<li>pulse
<li>pulse-access
<li>audio
</ul>

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

Example, for the user dl6kbg the grup file must contain:
<pre>
grep dl6kbg /etc/group
...
audio:x:29:pulse,dl6kbg
pulse:x:119:dl6kbg
pulse-access:x:120:dl6kbg
...
</pre>
<pre>
sudo nano /etc/default/pulseaudio
</pre>

change settings to:

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

<pre>
sudo nano /etc/pulse/system.pa
</pre>

and add:

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

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

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

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

Uncomment these settings and change it for your needs.

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

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

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

QtRadio Installation

2011-11-13T07:49:13Z

94.39.9.239:

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

=== Installation from PPA ===
For Ubuntu Users there is a ppa for the binaries produced from the master branch, maintained by Andrea.
Supported versions are:
Ubuntu Lucid,
Ubuntu Natty,
Ubuntu Oneiric, and known to work, Linux Mint 11 

At the time of this writing, (Nov 12 2011) PPA release 1.7 is online. 

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

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

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

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

<ul>

<li>Start the Synaptic Package Manager
<li>From the menu ''Settings'' select ''Repositories'', a dialog box ''Software Sources'' will be shown
<li>On the first pane ''Ubuntu Software'' check the ''Community-maintaned Open Source Software (universe)'' tick
<li>On the second pane ''Other Software'' click on the add button, and, in the dialog ''software-properties-gtk'' enter 
'''ppa:andrew-montefusco/ghpsdr3'''
<li>Back to the ''Software sources'' dialog, press ''Close''
<li>Press the ''Reload'' button on the top bar of main window
<li>Press the ''Section'' button (bottom left pane) and next select ''Amateur Radio'' and, on the right pane, the ghpsdr3 package
<li>Press ''Apply'' button on the top bar: answer '''yes''', if so requested, in order to install the required dependencies
</ul>

 

You will then find the QtRadio app in the ''Applications'', ''Internet menu.'' If you have the ''Hamradio'' menu installed you will find it there also. 
Subsequently you can use the Ubuntu software update process to update to the latest ppa version. 
More information about Andrea's PPA is at https://launchpad.net/~andrew-montefusco/+archive/ghpsdr3

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

==== Installing Git ====

You will need the following build dependencies installed.

<pre>
$sudo apt-get install libqt4-opengl-dev
$sudo apt-get install glutg3-dev
$sudo apt-get install libusb-0.1-4
$sudo apt-get install libfftw3-dev
$sudo apt-get install portaudio19-dev
$sudo apt-get install libpulse-dev
$sudo apt-get install libsamplerate0-dev
$sudo apt-get install libusb-1.0-0-dev
$sudo apt-get install libconfig8-dev
$sudo apt-get install libtool
$sudo apt-get install qtmobility-dev
</pre>

Now you can install git

<pre>
$sudo apt-get install git
</pre>

==== Cloning the repository ====

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

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

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

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

Then download the new version from:

http://libevent.org/

libevent-2.0.15-stable.tar.gz

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

<pre>
$ gunzip libevent-2.0.15-stable.tar.gz
$ tar -ivf libevent-2.0.15-stable.tar

$ cd libevent-2.0.15-stable

$ ./configure
$ make
$ sudo make install
$ sudo ldconfig
</pre>

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

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

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


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

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

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

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

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

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

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

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

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

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

== Installation on Windows ==
[[QtRadio]], the client, is available on Windows for RX. A zip can be downloaded from: http://napan.com/ve9gj/qtradio.zip

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