mirror of
https://github.com/rtlsdrblog/rtl-sdr-blog.git
synced 2024-11-10 04:37:37 +01:00
74 lines
2.8 KiB
Groff
74 lines
2.8 KiB
Groff
|
.TH "rtl_sdr" 1 "0.5.0" RTL-SDR "User Commands"
|
||
|
|
.SH NAME
|
||
|
|
rtl-sdr \- an I/Q recorder for RTL2832 based DVB-T receivers
|
||
|
|
.SH DESCRIPTION
|
||
|
|
Uses a re-purposed DVB-T receiver as a software defined
|
||
|
|
radio to receive signals in I/Q data form. Written for
|
||
|
|
and incorporated in the osmocom rtl-sdr project.
|
||
|
|
.LP
|
||
|
|
In-Phase and Quadrature Phase data can faithfully represent
|
||
|
|
all of the information in a band of frequencies centered
|
||
|
|
on a carrier signal frequency.
|
||
|
|
.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
|
||
|
|
This program captures information from a band of frequencies
|
||
|
|
and outputs the data in a form useful to other software radio
|
||
|
|
programs.
|
||
|
|
.SH SYNOPSIS
|
||
|
|
.B rtl_adsb [-f freq] [OPTIONS] [output file]
|
||
|
|
.SH OPTIONS
|
||
|
|
.IP "-f frequency_to_tune_to [Hz]"
|
||
|
|
.IP "-s samplerate (default: 2048000 Hz)"
|
||
|
|
.IP "-d device_index (default: 0)"
|
||
|
|
.IP "-g gain (default: 0 for auto)"
|
||
|
|
.IP "-p ppm_error (default: 0)"
|
||
|
|
.IP "-b output_block_size (default: 16 * 16384)"
|
||
|
|
.IP "-n number of samples to read (default: 0, infinite)"
|
||
|
|
.IP "-S force sync output (default: async)"
|
||
|
|
.IP tfilename
|
||
|
|
(a '-' dumps samples to stdout)
|
||
|
|
.SH EXAMPLES
|
||
|
|
.IP "Example: To tune to 392.0 MHz, and set the sample-rate to 1.8 MS/s, use:"
|
||
|
|
./rtl_sdr /tmp/capture.bin -s 1.8e6 -f 392e6
|
||
|
|
.LP
|
||
|
|
to record samples to a file or to forward the data to a fifo.
|
||
|
|
.LP
|
||
|
|
If the device can't be opened, make sure you have the appropriate
|
||
|
|
rights to access the device (install udev-rules from the repository,
|
||
|
|
or run it as root).
|
||
|
|
.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_power(1), rtl_tcp(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.
|