### Dependencies

- GNU Radio v3.7.X
```
sudo apt-get install gnuradio (3.7.9.1-2ubuntu1)
```
- Build dependencies (cmake, libboost, swig)
```
sudo apt-get install cmake libboost-all-dev liblog4cpp5-dev swig
```
- the python module bitstring
```
sudo pip install bitstring
or
sudo apt-get install python-bitstring
```

- Source Block for RTL-SDR  dongle
http://osmocom.org/projects/sdr/wiki/rtl-sdr
```
sudo apt-get install gr-osmosdr
or build from source:
sudo apt-get install libusb-1.0-0-dev libusb-dev
git clone git://git.osmocom.org/rtl-sdr.git
cd rtl-sdr/
mkdir build
cd build
cmake ../
make
sudo make install
sudo ldconfig
```
or you can use the [GNU Radio Live Image](https://wiki.gnuradio.org/index.php/GNU_Radio_Live_SDR_Environment)
, which can be written to a USB drive with Unetbootin.
It comes with all dependencies except the "bitstring" module, which can be installed with 
```
sudo pip install bitstring
```

### Installation

```
mkdir build
cd build
cmake ..
make
sudo make install
sudo ldconfig
```
if you don't see the new blocks in gnuradio companion, click the reload button

#### without root privileges
put this in your .bashrc file (replace user with your username):
```
BASE=/home/user/gnuradio-prefix
export PATH=${PATH}:${BASE}/bin
export LD_LIBRARY_PATH=${LD_LIBRARY_PATH}:${BASE}/lib64:${BASE}/lib
export PKG_CONFIG_PATH=${PKG_CONFIG_PATH}:${BASE}/lib64/pkgconfig
export PYTHONPATH=${PYTHONPATH}:${BASE}/lib64/python2.7/site-packages/
export GRC_BLOCKS_PATH=${GRC_BLOCKS_PATH}:${BASE}/share/gnuradio/grc/blocks
```
this tells gnuradio companion where to find the blocks, and your system where to find the executables

when building use the following cmake command (replace user with your username):
```
cmake -DCMAKE_INSTALL_PREFIX:PATH=/home/user/gnuradio-prefix ..
```
now make should install the module to the specified folder, without needing root privileges

### TMC Location Lists
to use the tmc_parser block you need to download the TMC location table for your country and put the .DAT files in a subfolder called "LCL" in the data folder
links:
[wikipedia info](https://en.wikipedia.org/wiki/Traffic_message_channel#TMC_services_in_operation)
finland  [download here](http://www.liikennevirasto.fi/web/en/open-data/materials/tmc-location-data)
germany: [request here](http://www.bast.de/DE/Verkehrstechnik/Fachthemen/v2-LCL/location-code-list.html)
sweden: [request here](http://www.trafikverket.se/en/startpage/operations/Operations-road/Traffic-information/The-Swedish-Location-Table-for-TMC/tmc-download-page/)
norway: [download here](http://www.vegvesen.no/en/professional/Technology/RDS+TMC)
italy: [download here](http://www.cciss.it/portale/cciss.portal?_nfpb=true&_windowLabel=quicklinks_1&quicklinks_1_actionOverride=%2Fportlets%2Fquicklinks%2FgoRdsTmc)

### Usage

open the apps/ifft-RDS-decoder_hier-block.grc flow graph in GNU Radio Companion.
Click "generate" to create the hierarchical decoder block.
Click "reload" to load the generated block
open the apps/fft-multi-decoder.grc flow graph.
set the work directory of the "RDS parser Table" block as the full path (~ shortcut doesnt work) of the data directory (with trailing slash)
run the flowgraph

for more infos look in MANUAL.md

### History

forked from https://github.com/bastibl/gr-rds
Continuation of gr-rds on BitBucket (originally from Dimitrios Symeonidis https://bitbucket.org/azimout/gr-rds/ and also on CGRAN https://www.cgran.org/wiki/RDS).
contains code from https://github.com/windytan/redsea