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