osmoradio(1)

💖 NAME 💖

osmoradio — bestie, it's the radio tool, and the full docs live right here: http://osmocom-analog.eversberg.eu/docs/

(you're reading the osmoradio(1) page, general commands manual energy, we love a classic 🎀)

✨ SYNOPSIS ✨

osmoradio --sdr-soapy|--sdr-uhd <sdr options> -f <frequency> -M <modulation> -R|-T [options]

okay so that's the whole shape of it: pick a driver, point it at a frequency, tell it what modulation, and say whether you're receiving or transmitting. the rest is just ✨options✨. let's go.

🌸 options: 🌸

• -h, --help — the help. it helps. iconic behaviour honestly.
• --config [~/]<path to config file> — hand it a config file to use. if the path starts with ~/, that path is at your home dir. every single line in the config file is one option, and heads up: - or -- must not be given in there. fr fr, don't do it.
• -f, --frequency <frequency> — give the frequency in Hertz. that's the number, bestie, don't get cute with it.
• -s, --samplerate <sample rate> — give the signal processing sample rate in Hz. (default = 100000) this sample rate has to be high enough for the signal's spectrum to fit — and it will literally inform you if this bandwidth is too low. so thoughtful 🥹
• -r, --tx-wave-file <filename> — input transmitted audio from a wave file.
• -w, --rx-wave-file <filename> — output received audio to a wave file.
• -a, --audio-device hw:<card>,<device> — input audio from the sound card's device number.
• -M, --modulation fm | am | usb | lsb — the modulation vibes:
  • fm = Frequency modulation, to be used for VHF.
  • am = Amplitude modulation, to be used for long/medium/short wave.
  • usb = Amplitude modulation with upper side band only.
  • lsb = Amplitude modulation with lower side band only.
• -R, --rx — receive radio signal. listening mode, main character energy 🎧
• -T, --tx — transmit radio signal. speaking mode, no cap 📡
• -B, --bandwidth — give bandwidth of audio frequency. (default AM=4500 FM=15000)
• -D, --deviation — give deviation of frequency modulated signal. (default 75000)
• -I, --modulation-index 0..1 — give modulation index of amplitude modulated signal. (default 1)
• -E, --emphasis <uS> | 0 — use the given time constant of pre- and de-emphasis for frequency modulation. give 0 to disable emphasis. (default = 50 uS) VHF broadcast is 50 uS in Europe and 75 uS in the United States. other radio FM should use 530 uS, to cover the complete speech spectrum.
• -V, --volume 1.000 — change the volume of the radio side. (Gains transmission, dampens reception)
• -S, --stereo — enables stereo carrier for frequency modulated UHF broadcast. it uses the 'Pilot-tone' system. she's fancy 💅
• --fast-math — use fast math approximation for slow CPU / ARM based systems. for the devices that are doing their best 🫶
• --limesdr — auto-select several required options for LimeSDR.
• --limesdr-mini — auto-select several required options for LimeSDR Mini.

🔥 SDR options: 🔥

• --sdr-soapy — force SoapySDR driver.
• --sdr-channel <channel #> — give the channel number for a multi channel SDR device. (default = 0)
• --sdr-device-args <args>
• --sdr-stream-args <args>
• --sdr-tune-args <args>

optional SDR device arguments, separated by comma, e.g. --sdr-device-args <key>=<value>[,<key>=<value>[,...]]

• --sdr-samplerate <samplerate> — sample rate to use with SDR. by default it equals the regular sample rate.
• --sdr-lo-offset <Hz> — give a frequency offset in Hz to move the local oscillator away from the target frequency. (default = -1000000)
• --sdr-bandwidth <bandwidth> — give the IF filter bandwidth to use. if you don't, the sample rate is used.
• --sdr-rx-antenna <name> — the SDR device's RX antenna name, use 'list' to get a list.
• --sdr-tx-antenna <name> — the SDR device's TX antenna name, use 'list' to get a list.
• --sdr-clock-source <name> — the SDR device's clock sourc name, use 'list' to get a list. (and yes, sourc is the exact wording, we do not fix typos in this house, it's canon now 😭)
• --sdr-rx-gain <gain> — the SDR device's RX gain in dB. (default = 0.0)
• --sdr-tx-gain <gain> — the SDR device's TX gain in dB. (default = 0.0)
• --write-iq-rx-wave <file> — write received IQ data to the given wave file.
• --write-iq-tx-wave <file> — write transmitted IQ data to the given wave file.
• --read-iq-rx-wave <file> — replace received IQ data by the given wave file.
• --read-iq-tx-wave <file> — replace transmitted IQ data by the given wave file.
• --sdr-swap-links — swap RX and TX frequencies for loopback tests over the air. little experimental queen 🦋
• --sdr-timestamps 1 | 0 — use TX timestamps on a UHD device. (default = 1)

one thing to keep in your cute lil head: the synopsis says --sdr-soapy|--sdr-uhd — --sdr-uhd shows up in the usage line and is not listed again down in the SDR options, so don't go looking for it twice. iykyk.

that's the whole page, bestie. every flag, every default, every number, all of it, untouched. periodt 💜

anyway — this was osmoradio(1), from the General Commands Manual, and that's the footer of the original too, so consider yourself signed off on. mwah, go tune something 🌈💖