diff options
Diffstat (limited to 'debian/osmocom_fft.1')
-rw-r--r-- | debian/osmocom_fft.1 | 224 |
1 files changed, 224 insertions, 0 deletions
diff --git a/debian/osmocom_fft.1 b/debian/osmocom_fft.1 new file mode 100644 index 0000000..0b24d71 --- /dev/null +++ b/debian/osmocom_fft.1 @@ -0,0 +1,224 @@ +.TH osmocom_fft "1" "October 2013" "OSMOCOM" "User Commands" +.SH NAME +osmocom_fft \- Spectrum Browser +.SH SYNOPSIS +.B osmocom_fft +[\fIoptions\fR] +.SH DESCRIPTION +Spectrum Browser +.SH OPTIONS +.TP +\fB\-h\fR, \fB\-\-help\fR +show this help message and exit +.TP +\fB\-a\fR ARGS, \fB\-\-args\fR=\fIARGS\fR +Device args, [default=] +.TP +\fB\-A\fR ANTENNA, \fB\-\-antenna\fR=\fIANTENNA\fR +Select RX antenna where appropriate +.TP +\fB\-s\fR SAMP_RATE, \fB\-\-samp\-rate\fR=\fISAMP_RATE\fR +Set sample rate (bandwidth), minimum by default +.TP +\fB\-f\fR FREQ, \fB\-\-center\-freq\fR=\fIFREQ\fR +Set frequency to FREQ +.TP +\fB\-c\fR FREQ_CORR, \fB\-\-freq\-corr\fR=\fIFREQ_CORR\fR +Set frequency correction (ppm) +.TP +\fB\-g\fR GAIN, \fB\-\-gain\fR=\fIGAIN\fR +Set gain in dB (default is midpoint) +.TP +\fB\-W\fR, \fB\-\-waterfall\fR +Enable waterfall display +.TP +\fB\-S\fR, \fB\-\-oscilloscope\fR +Enable oscilloscope display +.TP +\fB\-\-avg\-alpha\fR=\fIAVG_ALPHA\fR +Set fftsink averaging factor, default=[0.1] +.TP +\fB\-\-averaging\fR +Enable fftsink averaging, default=[False] +.TP +\fB\-\-ref\-scale\fR=\fIREF_SCALE\fR +Set dBFS=0dB input value, default=[1.0] +.TP +\fB\-\-fft\-size\fR=\fIFFT_SIZE\fR +Set number of FFT bins [default=1024] +.TP +\fB\-\-fft\-rate\fR=\fIFFT_RATE\fR +Set FFT update rate, [default=30] +.TP +\fB\-v\fR, \fB\-\-verbose\fR +Use verbose console output [default=False] +.SH "SEE ALSO" +The full documentation for +.B linux; +is maintained as a Texinfo manual. If the +.B info +and +.B linux; +programs are properly installed at your site, the command +.IP +.B info linux; +.PP +should give you access to the complete manual. +.SH Device specification +You can specify the source or sink device using a comma separated string of argument=value pairs. The always-up-to-date block documentation with examples is available right here. +.SH FCD Source +.TP +Argument +Notes +.TP +fcd=<device-index> +0-based device identifier, optional +.TP +device=hw:2 +overrides the audio device +.TP +type=2 +selects the dongle type, 1 for Classic, 2 for Pro+ +.LP +The "device" argument overrides the audio device used by the underlying driver to access the dongle's IQ sample stream. +.LP +The "type" argument selects the dongle type, 1 for Classic, 2 for Pro+. +.SH OsmoSDR Source +.TP +Argument +Notes +.TP +osmosdr=<device-index> +0-based device identifier +.TP +buffers=<number-of-buffers> +Default is 32 +.TP +buflen=<length-of-buffer> +Default is 256kB, must be multiple of 512 +.SH RTL-SDR Source +.TP +Argument +Notes +.TP +rtl=<device-index> +0-based device identifier OR serial number +.TP +rtl_xtal=<frequency> +Frequency (Hz) used for the RTL chip, accepts eng notation +.TP +tuner_xtal=<frequency> +Frequency (Hz) used for the tuner chip, accepts eng notation +.TP +buffers=<number-of-buffers> +Default is 32 +.TP +buflen=<length-of-buffer> +Default is 256kB, must be multiple of 512 +.TP +direct_samp=0|1|2 +Enable direct sampling mode on the RTL chip. 0: Disable, 1: use I channel, 2: use Q channel +.TP +offset_tune=0|1 +Enable offset tune mode for E4000 tuners +.LP +NOTE: use rtl_eeprom -s to program your own serial number to the device +.LP +NOTE: if you don't specify rtl_xtal/tuner_xtal, the underlying driver will use 28.0MHz +.SH RTL-SDR TCP Source +.TP +Argument +Notes +.TP +rtl_tcp=<hostname>:<port> +hostname defaults to "localhost", port to "1234" +.TP +psize=<payload-size> +Default is 16384 bytes +.TP +direct_samp=0|1|2 +Enable direct sampling mode on the RTL chip 0=Off, 1=I-ADC input enabled, 2=Q-ADC input enabled +.TP +offset_tune=0|1 +Enable offset tune mode for E4000 tuners +.SH Miri Source +.TP +Argument +Notes +.TP +miri=<device-index> +0-based device identifier +.TP +buffers=<number-of-buffers> +Default is 32 +.SH UHD Source / Sink +Argument +Notes +.TP +uhd +Use this argument without a value +.TP +nchan=<channel-count> +For multichannel USRP configurations use the subdev parameter to specify stream mapping +.TP +subdev=<subdev-spec> +Examples: "A:0", "B:0", "A:0 B:0" when nchan=2. Refer original ettus documentation on this +.TP +lo_offset=<frequency> +Offset frequency in Hz, must be within daughterboard bandwidth. Accepts eng notation +.LP +Additional argument/value pairs will be passed to the underlying driver, for more information see specifying the subdevice and common device identifiers in the Ettus documentation. +.SH bladeRF Source / Sink +.TP +Argument +Notes +.TP +bladerf[=0] +0-based device identifier (optional) +.TP +fw='/path/to/the/firmware.img' +program MCU firmware from given file. usually not needed. power cycle required. +.TP +fpga='/path/to/the/bitstream.rbf' +load FPGA bitstream from given file. required only at first run at the moment. +.SH HackRF Source / Sink +.TP +Argument +Notes +.TP +hackrf +Use this argument without a value +.TP +buffers=<number-of-buffers> +Default is 32 +.LP +Only the first device found may be used at the moment because of libhackrf limitation. +.LP +Transmit support has been verified by using the crc-mmbTools DAB sdr transmitter. +.SH IQ File Source +.TP +Argument +Notes +.TP +file=<path-to-file-name> +.TP +freq=<frequency> +Center frequency in Hz, accepts eng notation +.TP +rate=<sampling-rate> +Mandatory, in samples/s, accepts eng notation +.TP +repeat=true|false +Default is true +.TP +throttle=true|false +Throttle flow of samples, default is true +.SH EXAMPLES +.LP +osmocom_fft -a rtl=0 -v -f 100e6 -s 2.4e6 -g 15 +.LP +osmocom_fft -a hackrf -v +.LP +osmocom_fft -a uhd -v +.SH "SEE ALSO" +osmocom_siggen(1) osmocom_siggen_nogui(1) osmocom_spectrum_sense(1) |