osmocom_fft(1)

🌸 osmocom_fft(1) — the manual, but make it cute 🌸

okay bestie, welcome to the osmocom_fft manual page 💖 this is the User Commands side of the house, and I'm about to walk you through every single flag like we're texting at 2am.

---

✨ NAME ✨

osmocom_fft — Spectrum Browser 📡✨

---

🫶 SYNOPSIS 🫶

osmocom_fft [options]

---

💅 DESCRIPTION 💅

Spectrum Browser. that's the whole vibe. it browses spectra. main character energy fr fr 👑

---

🎀 OPTIONS 🎀

• -h, --help — show this help message and exit 🙋‍♀️
• -a ARGS, --args=ARGS — Device args, [default=] (yes, the default is literally empty, that's not me being lazy, that's the manpage)
• -A ANTENNA, --antenna=ANTENNA — Select RX antenna where appropriate 📶
• -s SAMP_RATE, --samp-rate=SAMP_RATE — Set sample rate (bandwidth), minimum by default
• -f FREQ, --center-freq=FREQ — Set frequency to FREQ 🎯
• -c FREQ_CORR, --freq-corr=FREQ_CORR — Set frequency correction (ppm)
• -g GAIN, --gain=GAIN — Set gain in dB (default is midpoint)
• -W, --waterfall — Enable waterfall display 🌊 (iconic, obviously)
• -S, --oscilloscope — Enable oscilloscope display 📈
• --avg-alpha=AVG_ALPHA — Set fftsink averaging factor, default=[0.1]
• --averaging — Enable fftsink averaging, default=[False]
• --ref-scale=REF_SCALE — Set dBFS=0dB input value, default=[1.0]
• --fft-size=FFT_SIZE — Set number of FFT bins [default=1024]
• --fft-rate=FFT_RATE — Set FFT update rate, [default=30]
• -v, --verbose — Use verbose console output [default=False] 🗣️

---

🦋 SEE ALSO 🦋

The full documentation for linux; is maintained as a Texinfo manual. If the info and linux; programs are properly installed at your site, the command

info linux;

should give you access to the complete manual.

no bestie I don't know why it says linux; either, that's literally what it says, so that's literally what I'm telling you 💀

---

🌈 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 🍓

• 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 💜

• 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 🔥

• 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 ⭐

• 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 🧚

• miri=<device-index> — 0-based device identifier
• buffers=<number-of-buffers> — Default is 32

---

👑 UHD Source / Sink 👑

• 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 🎀

• 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 📡

• 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 🌸

• 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_fft -a rtl=0 -v -f 100e6 -s 2.4e6 -g 15

osmocom_fft -a hackrf -v

osmocom_fft -a uhd -v

---

💖 SEE ALSO 💖

osmocom_siggen(1) osmocom_siggen_nogui(1) osmocom_spectrum_sense(1)

---

and that's the whole page bestie, you ate it, no crumbs left 🫶✨ this lil masterpiece comes to you from OSMOCOM, dated October 2013, and it's the osmocom_fft(1) page — go forth and browse some spectra, periodt 💅🌈