Difference between revisions of "QtRadio Installation"

Revision as of 11:51, 3 December 2011

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 are two PPAs for the binaries produced both from the master and rxtx-event branch, maintained by Andrea IW0HDV. Supported versions are: Ubuntu Lucid, Ubuntu Natty, Ubuntu Oneiric, and known to work, Linux Mint 11

At the time of this writing, (Dec 3 2011) PPA release 2.2 is online (rxtx-event).

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:

rxtx-event branch

sudo add-apt-repository ppa:andrew-montefusco/ghpsdr3rxtx
sudo apt-get update
sudo apt-get install ghpsdr3rxtx

master branch

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

In case you want switch from a PPA to the other one, please remember to manually remove the old PPA file into directory /etc/apt/sources.list.d/ .

graphical installation

Ubuntu 11.04 and older

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

Ubuntu 11.10

• Open the Ubuntu Software Center (from the 'shopper' icon on the left bar)
• Maximize the window, on the top bar the program menu will be shown
• Select the menu Edit->Software Sources, a dialog box Software Sources will be shown
• On the first pane Ubuntu Software check the Community-maintaned Open Source Software (universe) tick
• On the second pane Other Software click on the add button, and, in the dialog software-properties-gtk enter
  for master branch:
  ppa:andrew-montefusco/ghpsdr3
  for rxtx-event branch:
  ppa:andrew-montefusco/ghpsdr3rxtx
• Press Close
• Back to the Software sources dialog, press Close again
• Into the Search entry field (top right), write down 'ghpsdr3' and press Enter, or pull down the menu 'All Software', should be there too
• Click on the name 'ghpsdr3' in order to select it and press the 'Install' button

If the program refuses to install ghpsdr3 complaining that the repository is not found, close it, start a terminal (Ctrl+Alt+T), run sudo apt-get update and retry with Ubuntu Software Center.

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

https://launchpad.net/~andrew-montefusco/+archive/ghpsdr3rxtx

Installation from Git

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

Installing compiler and autotool

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

Ubuntu/Debian

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

Fedora

sudo yum install gcc gcc-c++ man-pages autoconf automake subversion libtool git

Installing prerequisite packages

Ubuntu 11.04 and older

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

Next, you will need the following packages installed:

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

Ubuntu 11.10

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

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

Fedora 16

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

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

wget https://github.com/downloads/libevent/libevent/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:

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

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

export LD_LIBRARY_PATH=/usr/local/lib

Installing codec2 low bit rate audio encoding and decoding

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

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

Now go get codec2 using subversion

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

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

export LD_LIBRARY_PATH=/usr/local/lib

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.

git clone git://github.com/alexlee188/ghpsdr3-alex

Depending on your Internet connection thorughput, it will take several minute to download. cd into the new directory ghpsdr3-alex:

cd ghpsdr3-alex
git checkout rxtx-event

You are now working with Alex's latest and greatest!

autoreconf -i
./configure
make -j4 all
sudo make install

(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)

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

Refresh to a Newer Version

To pull a new version to build

$ git pull
$ make all
$ sudo make install

Installation on Windows