SDR (Software Defined Radio)

= gr-fosphor

GNU Radio block for RTSA-like spectrum visualization using GPU

http://git.osmocom.org/gr-fosphor/

== Building

Warning: Mixed prefix install is not supported. You need to install gr-fosphor in the same prefix as your GNU Radio install. If you used build-gnuradio this will be /usr/local and this is what's used in the instructions below. If you use a packaged version of GNU Radio, it's most likely /usr and the best way is then to make a package for gr-fosphor for your distribution.

=== GLFW3

Install dependencies

{{{

sudo apt-get install cmake xorg-dev libglu1-mesa-dev

}}}

Build GLFW

{{{

git clone https://github.com/glfw/glfw

cd glfw

mkdir build

cd build

cmake ../ -DBUILD_SHARED_LIBS=true

make

sudo make install

sudo ldconfig

}}}

=== gr-fosphor

Install dependencies

==== For NVidia

 * install [http://www.nvidia.com/object/unix.html NVidia drivers]

{{{

sudo apt-get install nvidia-opencl-dev opencl-headers

}}}

==== For AMD

 * install [http://support.amd.com/en-us/download AMD drivers] (13.4, 13.11 beta6, 13.12 and 14.10 drivers are known to work on linux)

 * install [http://developer.amd.com/tools-and-sdks/heterogeneous-computing/amd-accelerated-parallel-processing-app-sdk/ AMD APP SDK]

==== For Intel

 * No OpenCL support on Linux for HD and Iris Graphics (Wake up, Intel!).

 * Fosphor has been confirmed to work with Iris graphics on OSX.

Build gr-fosphor

{{{

git clone git://git.osmocom.org/gr-fosphor

cd gr-fosphor

mkdir build

cd build

cmake ..

make

sudo make install

sudo ldconfig

}}}

Build benchmark tool

{{{

cd gr-fosphor/lib/fosphor

make

}}}

Fosphor is known to build successfully on Linux, OSX and Windows.

==== Known issues

 * Some version of ubuntu (like 13.10) have screwed up OpenCL dev files setup and it might be required to manually specify a path to the actual OpenCL library during the cmake step ( like {{{-DOPENCL_LIBRARY=/usr/lib/nvidia-304/libOpenCL.so}}} )

 * When running python flowgraphs on machines with AMD graphics (fglrx driver) and UHD enabled in gr-osmosdr you may experience the following error {{{[!] CL Error (-1001, fosphor/cl.c:268): Unable to fetch platform IDs}}}. This is due to TLS sections in both, AMD OpenCL library and UHD library interfering with each other. A workaround is available through preloading the AMD OpenCL library {{{LD_PRELOAD=/usr/lib/x86_64-linux-gnu/libamdocl64.so osmocom_fft -F}}} (path may vary). C++ flowgraphs are not affected.

== Screenshots

=== Short video examples

http://www.youtube.com/watch?v=mjD-l3GAghU

{{{

#!html

<iframe width="960" height="720" src="http://www.youtube.com/embed/mjD-l3GAghU" frameborder="0" allowfullscreen></iframe>

}}}

=== osmocom_fft in fosphor mode

[[Image(GrOsmoSDR:fosphor.png)]]

[[Image(GrOsmoSDR:fosphor2.png)]]

== Bandwidth figures

There's a benchmark program available which allows to estimate the maximal bandwidth that can be processed with a specific GPU.

To build it:

{{{

cd gr-fosphor/lib/fosphor

make

}}}

Then execute it by providing a prerecorded complex float file (a couple of 100MB should be fine) in gnuradio format.

{{{

./main some.cfile

}}}

Try to leave the window to its default size if possible and watch out for the Msps numbers printed out to the console.

Submit your numbers & help us to create a GPU survey. We are especially interested in the top end and mobile graphics figures.

||'''CPU'''||'''GPU'''||'''Msps'''||

||?||AMD R290(X)||WANTED||

||?||NVidia Titan||WANTED||

||i7-4770K 3.5 GHz||NVidia !GeForce GTX 760||~228||

||?||AMD Radeon HD 7970 (Tahiti)||~220||

||i5-3570K 3.4 GHz||AMD Radeon HD 7870 (Tahiti)||~220||

||i7-3770K 3.4 GHz||Nvidia GTX 660||~202||

||i7-3770K 3.4 Ghz||Nvidia GTX 760||~191||

||i7-4770K 3.5 GHz||Nvidia GTX 650 Ti Boost||~188||

||i5-2500 3.3 GHz||NVidia GTX 460 SE||~129||

||i5-3570K 3.4GHz||AMD Radeon HD 7870 (Pitcairn)||~112||

||i5-2500 3.3GHz||NVidia GTX 550 Ti||~110||

||i5-2500k 3.8GHz||AMD Radeon HD 6850||~100||

||?||NVidia GTX 550 Ti||~97||

||QC Xeon 2 GHz||Nvidia !GeForce 560 Ti||~73||

||C2D 2.66 GHz||NVidia !GeForce GT 640 (GK107)||~67||

||i5 2.4 GHz||Intel Iris Pro 5100||~65||

||i7-3610QM||NVidia !GeForce GT 640M LE||~63||

||i7-950 3.06 GHz||NVidia GT9800||~61||

||i5-2500K 4.2 GHz||AMD Radeon HD 6570||~58||

||C2D 3.00GHz||NVidia !GeForce 9800 GT||~47||

||i5-2520M 2.5 GHz||NVidia GF119M||~46||

||C2D 2.4GHz||NVidia 9600M GT||~31||

||?||NVidia GT330M||~22||

||?||NVidia 8600GT||~15||

||C2D 2.2GHz||NVidia NVS 140M||~14||

||AMD E350 Fusion APU||AMD Radeon 6310||~12||

||C2Q Q9650 3.00GHz||!GeForce 9300 GE||~11||

||Atom 330||NVidia ION||~10||