RTLSDR-Airband

RTLSDR Airband is intended for Airband reception and online streaming to services such as liveatc.net

Very Important: This origin is not actively maintained. is recommended (and required for Raspberry Pi 2)

Features

Decode up to eight AM channels per dongle (within bandwidth frequency range)
Decode multiple dongles simutaneously
Auto squelch and Automatic Gain Control
MP3 encoding
Stream to Icecast or SHOUTcast server

Performance

Windows

~4% per dongle on i5-2430m at 2.1 GHz

Raspberry Pi

FFT using Broadcom Videocore IV GPU
No overclock required when using 1 dongle plus another dongle running dump1090
Turbo overclock setting recommended when using 2 dongles

Demo

Windows Binary

Requires CPU with SSE3 support.
Requires Visual C++ 2013 vcredist_x86.exe
Download (build 2014-08-11)

Building

Windows using VS Express 2013 for Desktop

Getting/Building prerequisites

FFTW3

Download fftw-3.3.4-dll32.zip from http://www.fftw.org/install/windows.html
Start the VS2013 x86 Native Tools Command Prompt
Run lib /def:libfftw3f-3.def to get libfftw3f-3.lib
Place the lib into win32/lib
Place fftw3.h into win32/include
Place libfftw3f-3.dll into the root folder

libogg and libvorbis

Download libogg-1.3.1.zip and libvorbis-1.3.4.zip from http://www.xiph.org/downloads/
Extract both zip files in the same folder
Rename libogg-1.x.x to libogg
Open libogg/win32/libogg_static.sln
Change to "Release" and build libogg_static
Open libvorbis-1.x.x/win32/VS2010/vorbis_static.sln
Change to "Release" and build libvorbis_static (NOT the highlighted libvorbisfile)
Copy both the generated .libs to win32/lib
Copy libogg/includes/ogg (the folder) to win32/include
Copy libvorbis-1.x.x/includes/vorbis (the folder) to win32/include

libmp3lame

Download from http://sourceforge.net/projects/lame/files/lame/3.99/
Open vc_solution/vc9_lame.sln
Change the Configuration to ReleaseSSE2
(optional) Right click libmp3lame-static and open Properties... C/C++... Code Generation... Enable Enhanced Instruction Set... Advanced Vector Instructions
Build libmp3lame-static
Copy output/ReleaseSSE2/libmp3lame-static.lib and libmpghip-static.lib to win32/lib
Copy include/lame.h to win32/include

librtlsdr

Download from http://sdr.osmocom.org/trac/wiki/rtl-sdr (search word: "pre-built")
Copy rtl-sdr-release/rtl-sdr.h and rtl-sdr_export.h to win32/includes
Copy rtl-sdr-release/x32/rtlsdr.lib to win32/lib
Copy rtl-sdr-release/x32/rtlsdr.dll and libusb-1.0.dll to root folder

pthreads

Download from ftp://sourceware.org/pub/pthreads-win32/
Extract Pre-built.2 to the same folder where libogg and libvorbis are located
Copy Pre-built.2/lib/x86/pthreadVCE2.lib to win32/lib
Copy Pre-built.2/dll/x86/pthreadVCE2.dll to root folder

libshout

This is the most complicated one
Download from http://www.icecast.org/download.php
Extract libshout to the same folder where libogg and libvorbis are located
Go to libshout-2.x.x/include/shout and rename shout.h.in to shout.h
Open libshout/win32/libshout.dsw
Change to "Release"... and then open project properties
On the General page change Character Set to Use Unicode Character Set
Go to C/C++... edit Additional Include Directories
Add ../../libogg/include, ../../libvorbis-1.x.x/include and ../../Pre-built.2/include
Go to C/C++... Preprocessor... edit Preprocessor Definitions
Add HAVE_SYS_TIMEB_H and HAVE_FTIME
Try to build, you should get errors
One of the error is "error C1083: Cannot open include file: 'compat.h': No such file or directory"
Double click on it and change that line from #include <compat.h> to #include <os.h>
Build again
Copy win32/Release/libshout.lib to win32/lib
Copy include/shout (the folder) to win32/include

Building this project

Browse into win32 and open the solution
Simply build solution or click the "Start Local Windows Debugger" button

Raspberry Pi (Raspbian)

I assume you already have RTLSDR library installed: http://www.hamradioscience.com/raspberry-pi-as-remote-server-for-rtl2832u-sdr/
sudo apt-get install libmp3lame-dev libvorbis-dev libshout-dev libfftw3-dev
sudo rpi-update && sudo reboot
cd into the project folder (where makefile is located)
cp -r /opt/vc/src/hello_pi/hello_fft .
sudo mknod char_dev c 100 0
make
You need to run the program with sudo

Configuring

All configurations are saved in config.txt file. Fields should be separated by space(s) or tab(s).

You may edit config.txt.example using a spreadsheet program.

Format:

NumDongles
DongleNo NumChannels Gain CenterFreq FreqCorrection
Hostname Port MountPoint Frequency Username Password
Hostname Port MountPoint Frequency Username Password
....
DongleNo NumChannels Gain CenterFreq FreqCorrection
Hostname Port MountPoint Frequency Username Password
.....

License

This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program. If not, see http://www.gnu.org/licenses/.

Open Source Licenses

###fftw3

GNU General Public License Version 2

Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:

Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.
Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution.
Neither the name of the copyright holder nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission.

THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

###libmp3lame

 Copyright (c) 2000-2002 Takehiro Tominaga

 Copyright (c) 2000-2011 Robert Hegemann

GNU Library General Public License Version 2

Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:

Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.
Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution.
Neither the name of the Xiph.org Foundation nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission.

THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

###librtlsdr

GNU General Public License Version 2

###libshout

GNU Library General Public License Version 2

Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:

Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.
Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution.
Neither the name of the Xiph.org Foundation nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission.

microtony/RTLSDR-Airband

microtony

Reviews

Repository Details

RTLSDR-Airband

Features

Performance

Windows

Raspberry Pi

Demo

Windows Binary

Building

Windows using VS Express 2013 for Desktop

Getting/Building prerequisites

FFTW3

libogg and libvorbis

libmp3lame

librtlsdr

pthreads

libshout

Building this project

Raspberry Pi (Raspbian)

Configuring

License

Open Source Licenses

More Repositories