Difference between revisions of "Developers Documentation"

From Ghpsdr3 SDR project
Jump to: navigation, search
(Installing Qt5)
(Installing codec2 low bit rate audio encoding and decoding)
 
(17 intermediate revisions by 3 users not shown)
Line 72: Line 72:
 
<pre>
 
<pre>
 
cd
 
cd
svn co https://freetel.svn.sourceforge.net/svnroot/freetel/codec2-dev
+
svn co https://freetel.svn.sourceforge.net/svnroot/freetel/codec2
cd codec2-dev
+
cd codec2
autoreconf -i
+
mkdir build
./configure
+
cd build
 +
cmake ..
 +
 
 +
If cmake complains it will ask you to remove ../CMakelists.txt and may be the ../CMakeFiles directory.
 +
After removal of those.
 +
cmake ..
 
make
 
make
 
sudo make install
 
sudo make install
 
sudo ldconfig
 
sudo ldconfig
 
</pre>
 
</pre>
 +
 +
*** The codec2 developers have warned that codec2-dev is the development version which may or may not work, codec2 is the stable branch.
  
 
= Installing Qt5 =
 
= Installing Qt5 =
You need to add the unsupported packages to your system. It will exist as a stand alone system separate from any other version of qt or creator etc. that you may have installed.
 
  
Two options are available:
+
http://qt-project.org/downloads
  
# Qt5 beta (preferred)
+
U should download the Qt5.0.0 libraries file.  64 bit for x86_64 and 32 bit for x86 PC etc.
# Canonical Qt5 Edgers ppa
+
  
 +
** Download the latest file from the above URL - it will not be 5.0.0 but the instructions that follow are to be amended according to the version downloaded.
 +
** For ARM follow Andrea's instructions in the ODROID section of this wiki as there are no binaries available for ARM platforms.
  
== Installing Qt5 Beta ==
+
After downloading you go to the download directory and do:
  
You download and install the Qt5 Beta:
+
$ chmod +x the-name-of-the-downloaded-file
  
<pre>http://releases.qt-project.org/qt5.0/beta1/</pre>
+
$ sudo ./the-name-of-the-downloaded-file
  
You set the path to point to the qmake you want to use:
+
After that you should have something installed in /opt/Qt5.0.0
  
<pre>
+
== Setting the path to qt5 ==
$ export PATH=/where/the/Qt/bin/dir/is:$PATH
+
</pre>
+
  
For example, mine is:
+
From a terminal
 
+
<pre>export PATH=/home/alex/Qt5.0.0beta1/Desktop/Qt/5.0.0-beta1/gcc_64/bin:$PATH
+
</pre>
+
 
+
 
+
You can check which version of Qt is active by:
+
 
+
<pre>$ qmake --version
+
QMake version 2.01a Using Qt version 5.0.0 in /home/alex/Qt5.0.0beta1/Desktop/Qt/5.0.0-beta1/gcc_64/lib
+
</pre>
+
 
+
 
+
The master branch now has conditional compile for Qt5 Beta and for older versions of Qt. Once the above PATH is set for the version of Qt you want, you can just use the usual automake steps to build.
+
 
+
The opengl-qt5 branch is customised for qt5 Beta ONLY. You also need to have a video card/ video chip in your PC that is opengl 2.0 compatible for it to compile and run.
+
 
+
== Adding the qt5 “Canonical Qt5 Edgers” ppa to your system ==
+
 
+
In a terminal, copy and paste ...
+
 
<pre>
 
<pre>
sudo add-apt-repository ppa:canonical-qt5-edgers/qt5-daily
+
$ export PATH=/opt/Qt5.0.0/5.0.0/gcc_64/bin:/opt/Qt5.0.0/Tools/QtCreator/bin:$PATH
 
</pre>
 
</pre>
Your system will now fetch the PPA's key. This enables your Ubuntu system to verify that the packages in the PPA have not been interfered with since they were built.
 
  
Now, as a one-off, you should tell your system to pull down the latest list of software from each archive it knows about, including the PPA you just added:
+
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.
<pre>
+
Therefore the autotools build system should search virtually over the whole filesystem.
sudo apt-get update
+
</pre>
+
Now you're ready to start installing software from the PPA!
+
  
== Installing from the ppa ==
+
In any case please remember that
  
You will be installing the packages from the daily build of qt5 and the version date etc. could change but it is important to check that you have marked for install the package corresponding to the qt5 build as some of the packages may also be installed for qt 4.8.x A good check is to open the url for the Edgers and compare your selection to their file list at [https://launchpad.net/~canonical-qt5-edgers/+archive/qt5-daily canonical-qt5-edgers]
+
* 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
  
The packages will be identified with similar to
+
* 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.
  5.0-2012xxx ubuntu5 Zoltan Balogh (2012-04-05)
+
For the bash it is typically ~/.bashrc
I have shown the example on the first entry in the list only.
+
  
Open Synaptic and use the quick find to look for and mark for install each of the packages in the following list ...
+
In any case, after you issue the export, please test it.
 
<pre>
 
<pre>
qt-components-qtquick2    5.0-2012xxx ubuntu5 Zoltan Balogh (2012-04-05)
+
qmake -v
qt3d
+
QMake version 2.01a
qtbase
+
Using Qt version 4.8.0 in /home/andrew/QtSDK4.8x/Desktop/Qt/4.8.0/gcc/lib
qtdeclarative
+
qtdoc
+
qtjsbackend
+
qtmultimedia
+
qtquick1
+
qtscript
+
qtsvg
+
qttools
+
qtwebkit
+
qtxmlpatterns
+
 
+
These packages will install by default in /opt/qt5
+
</pre>
+
note: there are a couple of packages which you do not need to install.
+
 
+
If you are using the command line, the needed command are shown below for convenience:
+
 
+
<pre>
+
sudo apt-get install qt-components-qtquick2 qt3d qtbase
+
sudo apt-get install qtdeclarative qtdoc  qtjsbackend  qtmultimedia  qtquick1
+
sudo apt-get install qtscript qtsvg qttools  qtwebkit qtxmlpatterns
+
</pre>
+
 
+
== Setting the path to qt5 ==
+
 
+
From a terminal
+
<pre>
+
$ export PATH=/opt/qt5/bin:$PATH
+
 
</pre>
 
</pre>
  
 
== Compiling QtRadio ==
 
== Compiling QtRadio ==
 
 
<pre>
 
<pre>
 
cd
 
cd
Line 186: Line 138:
 
sh ./cleanup.sh
 
sh ./cleanup.sh
 
autoreconf -i
 
autoreconf -i
./configure CFLAGS='-fopenmp -O3 -msse3' CXXFLAGS='-fopenmp -O3 -msse3'
+
 
 +
sh ./alex-conf.sh
  
 
</pre>
 
</pre>
  
for those of us with older machines use the line below instead:
 
 
<pre>
 
./configure CXXFLAGS='-O3 -msse2 -fopenmp'
 
</pre>
 
 
Last, build everything:
 
Last, build everything:
  
Line 211: Line 159:
 
Click on the Qt Versions panel
 
Click on the Qt Versions panel
 
Click on Add button
 
Click on Add button
Navigate to /opt/qt5/bin
+
Navigate to /opt/Qt5.0.0/5.0.0/gcc_64/bin
 
Click on qmake
 
Click on qmake
 
Click on open
 
Click on open
 
Click on Apply then OK
 
Click on Apply then OK
 
</pre>
 
</pre>
You need to point to the qmake file which is found in /opt/qt5/bin
+
You need to point to the qmake file which is found in /opt/Qt5.0.0/5.0.0/gcc_64/bin
  
 
== Choosing the build library in QtCreator ==
 
== Choosing the build library in QtCreator ==
Line 223: Line 171:
  
 
It may be necessary to edit the project file (QtRadio.pro) to choose which version of Qt Creator you are using which can be the SDK directly from Nokia, or the Ubuntu install of Creator. The line "_UsingSDK" needs to be set to true or false as appropriate.
 
It may be necessary to edit the project file (QtRadio.pro) to choose which version of Qt Creator you are using which can be the SDK directly from Nokia, or the Ubuntu install of Creator. The line "_UsingSDK" needs to be set to true or false as appropriate.
 +
 +
== Qt5.0.0 bug ==
 +
 +
There is likely to be a bug in the Qt5.0.0 release that leads to QtRadio hangs when you click on the menu after running QtRadio for a while when a buffer underun has occured.
 +
 +
This happens only one some PC's, but not others.
 +
 +
If it does, you can revert to an older Qt5 BETA:
 +
 +
On my one of 3 PC's with the QtRadio lockup problem (when you click on any menu items after running QtRadio for a while, especially after a buffer underflow), I rebuild QtRadio using Qt5 from the Edgers ppa (which is a late BETA version), and the problem disappears completely :-)
 +
 +
https://launchpad.net/~canonical-qt5-edgers/+archive/qt5-daily
 +
 +
To get it to build in the Edgers, you just have to set the path to the Edgers directory.  E.g. in mine, it is:
 +
 +
<pre>
 +
$ export PATH=/opt/qt5/bin:$PATH
 +
</pre>
 +
 +
Use these commands to create symbolic links in the qt5 library (which you have to do only once):
 +
 +
<pre>
 +
$ cd /opt/qt5/lib
 +
$ sudo ln -s libQtMultimedia.so.5.0.0 libQt5Multimedia.so
 +
$ sudo ln -s libQtMultimedia.so.5.0.0 libQt5Multimedia.so.5
 +
$ sudo ln -s libQtMultimedia.so.5.0.0 libQt5Multimedia.so.5.0
 +
</pre>
 +
 +
then you should be able to do the usual build steps.

Latest revision as of 13:29, 3 September 2014

Most of the development discussion has been taking place on the sdr-widget google group.


Installing portaudio19-dev with jackd2

Portaudio19-dev depends on having a copy of libjack-dev installed and if the libkjack-jackd2-dev package is installed before portaudio19-dev it's dependency will be satisfied and it will not uninstall jackd2 and install jackd1 if you have already installed jackd2 on your system.

If jackd1 and portaudio19-dev already installed

From Synaptic

Uninstall portaudio19-dev
Uninstall jackd1
Install Jackd2
Install libjack-jackd2-dev
Install portaudio19-dev

If you are starting from scratch

From Synaptic

Install Jackd2
Install libjack-jackd2-dev
Install portaudio19-dev


The following commands install all the environment needed (Debian/Ubuntu):

sudo apt-get install jackd2 libjack-jackd2-dev portaudio19-dev

sudo apt-get install make gcc g++ autoconf automake autotools-dev libtool git subversion
sudo apt-get install libusb-0.1-4 libusb-dev libfftw3-dev libpulse-dev libsamplerate0-dev 
sudo apt-get install libusb-1.0-0-dev libconfig8-dev xdg-utils libortp-dev
sudo apt-get install libevent-dev

If the machine doesn't have an OpenGL aware accelerated video card, please install also the following packages:

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

Note: in at least one case (thanks to Pierluigi iw4blg), even if the machine was running with an NVidia card and proprietary NVidia device drivers, the test for Qt in configure did fail, as well did the example programs enclosed in qt5 package, complaining that both GL/gl.h and libGL were missing. Installing all the above packages the problem was solved.

Installing codec2 low bit rate audio encoding and decoding

To download and build the codec2 library. See:

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

Now go get codec2 using subversion

cd
svn co https://freetel.svn.sourceforge.net/svnroot/freetel/codec2
cd codec2
mkdir build
cd build
cmake ..

If cmake complains it will ask you to remove ../CMakelists.txt and may be the ../CMakeFiles directory.
After removal of those.
cmake ..
make
sudo make install
sudo ldconfig
      • The codec2 developers have warned that codec2-dev is the development version which may or may not work, codec2 is the stable branch.

Installing Qt5

http://qt-project.org/downloads

U should download the Qt5.0.0 libraries file. 64 bit for x86_64 and 32 bit for x86 PC etc.

    • Download the latest file from the above URL - it will not be 5.0.0 but the instructions that follow are to be amended according to the version downloaded.
    • For ARM follow Andrea's instructions in the ODROID section of this wiki as there are no binaries available for ARM platforms.

After downloading you go to the download directory and do:

$ chmod +x the-name-of-the-downloaded-file

$ sudo ./the-name-of-the-downloaded-file

After that you should have something installed in /opt/Qt5.0.0

Setting the path to qt5

From a terminal

$ export PATH=/opt/Qt5.0.0/5.0.0/gcc_64/bin:/opt/Qt5.0.0/Tools/QtCreator/bin:$PATH

This is due because the several packages from Qt sources and binary repositories web sites are not really installed in the system but simply copied on it. Therefore the autotools build system should search virtually over the whole filesystem.

In any case please remember that

  • the export above is effective only into the current terminal windows, if you open another window and/or reboot the system, you have to resubmit again the command
  • if you want to make permanent it, you have to add the export into the right configuration shell, suitable for the shell that you are currently using.

For the bash it is typically ~/.bashrc

In any case, after you issue the export, please test it.

qmake -v
QMake version 2.01a
Using Qt version 4.8.0 in /home/andrew/QtSDK4.8x/Desktop/Qt/4.8.0/gcc/lib

Compiling QtRadio

cd
git clone https://github.com/alexlee188/ghpsdr3-alex.git
cd ghpsdr3-alex
git checkout master

sh ./cleanup.sh
autoreconf -i

sh ./alex-conf.sh

Last, build everything:

make
sudo make install

Setting QtCreator to use the qt5 libraries

If you want to use Qt Creator (you use the same Qt Creator as with Qt4), you need to configure it to use Qt5 as one of the options:

From the top line menu of QtCreator ...

Tools > Options > Build & Run
Click on the Qt Versions panel
Click on Add button
Navigate to /opt/Qt5.0.0/5.0.0/gcc_64/bin
Click on qmake
Click on open
Click on Apply then OK

You need to point to the qmake file which is found in /opt/Qt5.0.0/5.0.0/gcc_64/bin

Choosing the build library in QtCreator

you need to (re)import your QtRadio project and then you will be able to select Qt5 (or the previous Qt4.8 etc.) for building the application.

It may be necessary to edit the project file (QtRadio.pro) to choose which version of Qt Creator you are using which can be the SDK directly from Nokia, or the Ubuntu install of Creator. The line "_UsingSDK" needs to be set to true or false as appropriate.

Qt5.0.0 bug

There is likely to be a bug in the Qt5.0.0 release that leads to QtRadio hangs when you click on the menu after running QtRadio for a while when a buffer underun has occured.

This happens only one some PC's, but not others.

If it does, you can revert to an older Qt5 BETA:

On my one of 3 PC's with the QtRadio lockup problem (when you click on any menu items after running QtRadio for a while, especially after a buffer underflow), I rebuild QtRadio using Qt5 from the Edgers ppa (which is a late BETA version), and the problem disappears completely :-)

https://launchpad.net/~canonical-qt5-edgers/+archive/qt5-daily

To get it to build in the Edgers, you just have to set the path to the Edgers directory. E.g. in mine, it is:

$ export PATH=/opt/qt5/bin:$PATH

Use these commands to create symbolic links in the qt5 library (which you have to do only once):

$ cd /opt/qt5/lib
$ sudo ln -s libQtMultimedia.so.5.0.0 libQt5Multimedia.so
$ sudo ln -s libQtMultimedia.so.5.0.0 libQt5Multimedia.so.5
$ sudo ln -s libQtMultimedia.so.5.0.0 libQt5Multimedia.so.5.0
then you should be able to do the usual build steps.