aboutsummaryrefslogtreecommitdiffstats
path: root/debian/osmocom_spectrum_sense.1
diff options
context:
space:
mode:
Diffstat (limited to 'debian/osmocom_spectrum_sense.1')
-rw-r--r--debian/osmocom_spectrum_sense.1196
1 files changed, 196 insertions, 0 deletions
diff --git a/debian/osmocom_spectrum_sense.1 b/debian/osmocom_spectrum_sense.1
new file mode 100644
index 0000000..d10b1d4
--- /dev/null
+++ b/debian/osmocom_spectrum_sense.1
@@ -0,0 +1,196 @@
+.TH osmocom_spectrum_sense "1" "October 2013" "OSMOCOMM" "User Commands"
+.SH NAME
+osmocom_spectrum_sense \- GNU Radio application from OsmoSDR
+.SH SYNOPSIS
+.B osmocom_spectrum_sense
+[\fIoptions\fR] \fImin_freq max_freq\fR
+.SH DESCRIPTION
+GNU Radio application from OsmoSDR
+.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 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\-g\fR GAIN, \fB\-\-gain\fR=\fIGAIN\fR
+Set gain in dB (default is midpoint)
+.TP
+\fB\-\-tune\-delay\fR=\fISECS\fR
+Time to delay (in seconds) after changing frequency
+[default=0.25]
+.TP
+\fB\-\-dwell\-delay\fR=\fISECS\fR
+Time to dwell (in seconds) at a given frequency
+[default=0.25]
+.TP
+\fB\-b\fR Hz, \fB\-\-channel\-bandwidth\fR=\fIHz\fR
+Channel bandwidth of fft bins in Hz [default=6250.0]
+.TP
+\fB\-q\fR dB, \fB\-\-squelch\-threshold\fR=\fIdB\fR
+Squelch threshold in dB [default=none]
+.TP
+\fB\-F\fR FFT_SIZE, \fB\-\-fft\-size\fR=\fIFFT_SIZE\fR
+Specify number of FFT bins
+[default=samp_rate/channel_bw]
+.TP
+\fB\-\-real\-time\fR
+Attempt to enable real\-time scheduling
+.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 "SEE ALSO"
+osmocom_fft(1) osmocom_siggen(1) osmocom_siggen_nogui(1)