NAME

osmocom_siggen - Signal Generator Application with GUI controls

SYNOPSIS

osmocom_siggen: [options]

DESCRIPTION

Signal Generator Application with GUI controls

OPTIONS

-h, --help: show this help message and exit
-a ARGS, --args=ARGS: Device args, [default=]
-A ANTENNA, --antenna=ANTENNA: Select Rx Antenna where appropriate
-s SAMP_RATE, --samp-rate=SAMP_RATE: Set sample rate (bandwidth), minimum by default
-g GAIN, --gain=GAIN: Set gain in dB (default is midpoint)
-f FREQ, --tx-freq=FREQ: Set carrier frequency to FREQ [default=mid-point]
-c FREQ_CORR, --freq-corr=FREQ_CORR: Set carrier frequency correction [default=0]
-x WAVEFORM_FREQ, --waveform-freq=WAVEFORM_FREQ: Set baseband waveform frequency to FREQ [default=0]
-y WAVEFORM2_FREQ, --waveform2-freq=WAVEFORM2_FREQ: Set 2nd waveform frequency to FREQ [default=none]
--sine: Generate a carrier modulated by a complex sine wave
--const: Generate a constant carrier
--offset=OFFSET: Set waveform phase offset to OFFSET [default=0]
--gaussian: Generate Gaussian random output
--uniform: Generate Uniform random output
--2tone: Generate Two Tone signal for IMD testing
--sweep: Generate a swept sine wave
--gsm: Generate GMSK modulated GSM Burst Sequence
--amplitude=AMPL: Set output amplitude to AMPL (0.1-1.0) [default=0.3]
-v, --verbose: Use verbose console output [default=False]

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.

FCD Source

Argument: Notes
fcd=<device-index>: 0-based device identifier, optional
device=hw:2: overrides the audio device
type=2: selects the dongle type, 1 for Classic, 2 for Pro+

The "device" argument overrides the audio device used by the underlying driver to access the dongle's IQ sample stream.

The "type" argument selects the dongle type, 1 for Classic, 2 for Pro+.

OsmoSDR Source

Argument: Notes
osmosdr=<device-index>: 0-based device identifier
buffers=<number-of-buffers>: Default is 32
buflen=<length-of-buffer>: Default is 256kB, must be multiple of 512

RTL-SDR Source

Argument: Notes
rtl=<device-index>: 0-based device identifier OR serial number
rtl_xtal=<frequency>: Frequency (Hz) used for the RTL chip, accepts eng notation
tuner_xtal=<frequency>: Frequency (Hz) used for the tuner chip, accepts eng notation
buffers=<number-of-buffers>: Default is 32
buflen=<length-of-buffer>: Default is 256kB, must be multiple of 512
direct_samp=0|1|2: Enable direct sampling mode on the RTL chip. 0: Disable, 1: use I channel, 2: use Q channel
offset_tune=0|1: Enable offset tune mode for E4000 tuners

NOTE: use rtl_eeprom -s to program your own serial number to the device

NOTE: if you don't specify rtl_xtal/tuner_xtal, the underlying driver will use 28.0MHz

RTL-SDR TCP Source

Argument: Notes
rtl_tcp=<hostname>:<port>: hostname defaults to "localhost", port to "1234"
psize=<payload-size>: Default is 16384 bytes
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
offset_tune=0|1: Enable offset tune mode for E4000 tuners

Miri Source

Argument: Notes
miri=<device-index>: 0-based device identifier
buffers=<number-of-buffers>: Default is 32

UHD Source / Sink

Argument Notes

uhd: Use this argument without a value
nchan=<channel-count>: For multichannel USRP configurations use the subdev parameter to specify stream mapping
subdev=<subdev-spec>: Examples: "A:0", "B:0", "A:0 B:0" when nchan=2. Refer original ettus documentation on this
lo_offset=<frequency>: Offset frequency in Hz, must be within daughterboard bandwidth. Accepts eng notation

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.

bladeRF Source / Sink

Argument: Notes
bladerf[=0]: 0-based device identifier (optional)
fw='/path/to/the/firmware.img': program MCU firmware from given file. usually not needed. power cycle required.
fpga='/path/to/the/bitstream.rbf': load FPGA bitstream from given file. required only at first run at the moment.

HackRF Source / Sink

Argument: Notes
hackrf: Use this argument without a value
buffers=<number-of-buffers>: Default is 32

Only the first device found may be used at the moment because of libhackrf limitation.

Transmit support has been verified by using the crc-mmbTools DAB sdr transmitter.

IQ File Source

Argument: Notes
file=<path-to-file-name>
freq=<frequency>: Center frequency in Hz, accepts eng notation
rate=<sampling-rate>: Mandatory, in samples/s, accepts eng notation
repeat=true|false: Default is true
throttle=true|false: Throttle flow of samples, default is true

EXAMPLES

osmocom_siggen -a hackrf -f 100e6 --sine

osmocom_siggen -a hackrf -f 100e6 --sweep -x 2M -y 1 -c34