.TH "rtl_tcp" 1 "0.5.0" RTL-SDR "User Commands"
  .SH NAME
  rtl_tcp \- an I/Q spectrum server for RTL2832 based DVB-T receivers
  .SH 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.
  .LP
  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.
  .LP
  Because most of the RTL2832 devices are connected using USB, the
  librtlsdr library depends on the libusb library to communicate with
  the device.
  .SH 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.
  .SH SYNOPSIS
  .B  rtl_tcp [OPTIONS]
  .SH OPTIONS
  .IP "-a listen address"
  .IP "-p listen port (default: 1234)"
  .IP "-f frequency to tune to [Hz]"
  .IP "-g gain (default: 0 for auto)"
  .IP "-s samplerate in Hz (default: 2048000 Hz)"
  .IP "-b number of buffers (default: 32, set by library)"
  .IP "-n max number of linked list buffers to keep (default: 500)"
  .IP "-d device_index (default: 0)"
  .IP "-P ppm_error (default: 0)"
  .SH  Example:
  .IP "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...
  .LP
  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, ...).
  .LP
  use the rtl_tcp=... device argument in gr-osmosdr source to receive
  the samples in GRC and control the rtl settings remotely.
  .LP
  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.
  .LP
  A use case is described ​https://sites.google.com/site/embrtlsdr/
  .SH SEE ALSO
  gnuradio(1)
  .LP
  RTL-SDR wiki documentation:
  .B http://sdr.osmocom.org/trac/wiki/rtl-sdr
  .LP
  Other rtl-sdr programs:
  .sp
  rtl_adsb(1), rtl_eeprom(1), rtl_fm(1), rtl_sdr(1), rtl_test(1)
  .SH AUTHOR
  This manual page was written by Maitland Bottoms
  for the Debian project (but may be used by others).
  .SH COPYRIGHT
  Copyright (c) 2013 A. Maitland Bottoms <bottoms@debian.org>
  .LP
  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.
  .LP
  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.