NAME

       rtl_tcp - an I/Q spectrum server for RTL2832 based DVB-T receivers

DESCRIPTION

       Uses a re-purposed DVB-T receiver as a software defined radio to receive and send I/Q data
       via TCP network to another demodulation, decoding or logging apllication. Written for  and
       incorporated into the osmocom rtl-sdr project.

       Much  software  is  available for the RTL2832. Most of the user-level packages rely on the
       librtlsdr library which comes as part of the rtl-sdr codebase. This codebase contains both
       the  library  itself  and  also  a number of command line tools such as rtl_test, rtl_sdr,
       rtl_tcp, and rtl_fm. These command line tools use the library to test for the existence of
       RTL2832 devices and to perform basic data transfer functions to and from the device.

       Because most of the RTL2832 devices are connected using USB, the librtlsdr library depends
       on the libusb library to communicate with the device.

USAGE

       Run this program on a machine with an rtl-sdr  supported  device  connected  and  it  will
       provide I/Q data to other applications via TCP/IP.

SYNOPSIS

       rtl_tcp [OPTIONS]

OPTIONS

       -a listen address

       -p listen port (default: 1234)

       -f frequency to tune to [Hz]

       -g gain (default: 0 for auto)

       -s samplerate in Hz (default: 2048000 Hz)

       -b number of buffers (default: 32, set by library)

       -n max number of linked list buffers to keep (default: 500)

       -d device_index (default: 0)

       -P ppm_error (default: 0)

Example:

       rtl_tcp -a 10.0.0.2 [-p listen port (default: 1234)]
               Found 1 device(s).
               Found Elonics E4000 tuner
               Using Generic RTL2832U (e.g. hama nano)
               Tuned to 100000000 Hz.
               listening...

       Use  the device argument 'rtl_tcp=10.0.0.2:1234' in OsmoSDR (gr-osmosdr) source to receive
       samples in GRC and control rtl_tcp parameters (frequency, gain, ...).

       use the rtl_tcp=... device argument in gr-osmosdr source to receive the samples in GRC and
       control the rtl settings remotely.

       This  application  has  been  successfully  crosscompiled  for ARM and MIPS devices and is
       providing IQ data in a networked ADS-B setup at a rate of 2.4MSps. The  gr-osmosdr  source
       is  being  used together with an optimized gr-air-modes version (see Known Apps below). It
       is also available as a package in OpenWRT.

       A use case is described ​https://sites.google.com/site/embrtlsdr/

SEE ALSO

       gnuradio(1)

       RTL-SDR wiki documentation: http://sdr.osmocom.org/trac/wiki/rtl-sdr

       Other rtl-sdr programs:

       rtl_adsb(1), rtl_eeprom(1), rtl_fm(1), rtl_sdr(1), rtl_test(1)

AUTHOR

       This manual page was written by Maitland Bottoms for the Debian project (but may  be  used
       by others).

COPYRIGHT

       Copyright (c) 2013 A. Maitland Bottoms <bottoms@debian.org>

       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 2 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.