FIXME **This page is not fully translated, yet. Please help completing the translation.**\\ //(remove this paragraph once the translation is finished)//

====== ghpsdr3 ======

[[http://napan.ca/ghpsdr3/index.php/Main_Page|ghpsdr3]] is a system of software tools for work with SDR receivers.

The system consist of several components:
  *  server
  *  dspserver
  *  clients

===== Installation under Ubuntu 14.04 =====

==== Required libraries ====

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

=== codec2 ===

  svn co https://freetel.svn.sourceforge.net/svnroot/freetel/codec2
  cd codec2
  mkdir build_linux
  cd build_linux/
  cmake ../ && make
  sudo make install
  sudo ldconfig

==== ghpsdr3-alex ====

  git clone git@github.com:alexlee188/ghpsdr3-alex.git
  cd ghpsdr3-alex/
  autoreconf -i
  ./configure
  make
  sudo make install
  

===== Installation under Ubuntu 14.10 =====

Installation is well described [[http://napan.ca/ghpsdr3/index.php/Ubuntu14|here]].


===== Ubuntu 14.10 =====
Make sure that your systems is up-to-date:

  sudo apt-get update
  sudo apt-get upgrade

Install the tools:

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

Install the prerequisite packages:

  sudo apt-get -y install libusb-0.1-4 libusb-dev libfftw3-dev portaudio19-dev libpulse-dev libsamplerate0-dev libusb-1.0-0-dev libconfig8-dev xdg-utils libortp-dev gcc-multilib libssl-dev libevent-dev cmake 

Install Qt5 from Ubuntu repository:


  sudo apt-get install qt5-default qt5-qmake libqt5multimedia5 libqt5multimedia5-plugins qtmultimedia5-dev

==== Build and install codec-2 ====

  svn co https://svn.code.sf.net/p/freetel/code/codec2 codec2
  cd codec2
  mkdir build_linux
  cd build_linux
  cmake ../ && make
  sudo make install
  sudo ldconfig

==== Build and install ghpsdr ====

Download the source code from git:

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

Depending on your Internet connection throughput, the download will take several minutes. 

  cd ghpsdr3-alex
  git checkout master
  autoreconf -i && ./configure && make -j4

  sudo make install

The default configure above builds with debug and default Qt5 version in your PC.  
For optimized executable, you need to specify options specific to your system.  See the sample shell scripts that replaces the above ./configure step: (??)

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


After these steps you should be able to run QtRadio from a command line by executing:
  QtRadio

If you get a segfaut message you should check if there are not old libraries present. 

  sudo apt-get remove qtmobility-dev libqtmultimediakit1 

===== USRP =====

In order to use the ghpsdr3 with [[http://www.ettus.com/|USRP]] radio, it is necessary, after cloning the repository from github, to leave the master branch and enter the branch that contains a specific adjustments for USRP - use the following command:
  git checkout origin/usrp-server

Then you can proceed according to the above-mentioned instructions. 

Repeat the same procedure on the computer you want to connect from (here you don’t need to change the branches).

=== How to run it ===

On the computer with a connected radio, run dspserver and ursp-server.
  dspserver --addres "ip adresa"

In case of radio.ust.cz, see the example below:
  sudo usrp_server --rx-subdev "A:0"
  dspserver

where every server should be run individually in its screen so it can run even after logging out.