jollycom(1)

💖 NAME 💖

jollycom — the cutest little analog radio command, no cap. Official docs live at http://osmocom-analog.eversberg.eu/docs/ 🦋

✨ SYNOPSIS ✨

jollycom -k <kanal/channel> [-F <downlink MHz>,<uplink MHz>,<step KHz>]
[options] [station_id]

🌸 Global options 🌸

• -h, --help — prints the help. That's it, that's the whole vibe. 🙈
• --config [~/]<path to config file> — hand it a config file to use. If the path starts with ~/, it lives in your home dir. Every line in that config file is one option, and you must not write - or -- in front of it! Default: ~/.osmocom/analog/jollycom.conf 📁
• --no-config — even if a config file is sitting right there existing, don't use it. Not today. 💅
• -v, --verbose <level> | <level>,<category>[,<category>[,...]] | list — use list to get a list of all levels and categories. For the level: a digit of debug level (default = 3). For level + category: the level digit followed by one or more categories — and if you don't name a category, all categories get selected. 🎀
• -v, --verbose date — show the date along with the debug output. timestamps bestie, we love context. ⏰
• -k, --kanal <channel>
• -k, --channel <channel> — the channel (German = Kanal) number of the "Sender" (German = Transceiver). 🇩🇪
• -a, --audio-device hw:<card>,<device>[/hw:<card>.<rec-device>] — sound card and device number (default = hw:0,0). You can name a different recording device by using /. Don't set this one for SDR! 🎧
• -s, --samplerate <rate> — sample rate of the sound device (default = 48000). 🎵
• -i, --interval 0.1..25 — interval of the processing loop in ms (default = 1.0 ms). Use 10 to drastically reduce CPU usage. If you get buffer underrun, increase the buffer accordingly. 🔥
• -b, --buffer <ms> — how many milliseconds are processed in advance (default = 50). A buffer below 10 ms needs a low interval like 0.1 ms. 🫶
• -p, --pre-emphasis — enable pre-emphasis, if you're connecting directly to the oscillator of the transmitter. (No pre-emphasis done by the transmitter.) ✨
• -d, --de-emphasis — enable de-emphasis, if you're connecting directly to the discriminator of the receiver. (No de-emphasis done by the receiver.) ✨
• --rx-gain <dB> — raise/lower the receiver's RX level by the given gain in dB. (Works with sound card only.) 📈
• --tx-gain <dB> — raise/lower the transmitter's RX level by the given gain in dB. (Works with sound card only.) 📉
• -e, --echo-test — echo test mode: sends audio from the mobile phone's microphone right back to the speaker. (German: 'Blasprobe'). 🗣️
• -c, --call-device hw:<card>,<device>[/hw:<card>.<rec-device>] — sound card and device number for the headset (default = ''). You can name a different recording device by using /. 🎧
• --call-samplerate <rate> — sample rate of the sound device for the headset (default = 48000). 🎵
• --call-buffer <ms> — how many milliseconds are processed in advance (default = 50). ⏳
• -x, --osmocc-cross — enable the built-in call forwarding between mobiles. Be sure to have at least one control channel and two voice channels. Alternatively use one combined control+voice channel and one voice channel. 📞
• -o, --osmocc-sock — disable built-in call control and offer a socket instead. 🔌
• --cc "<osmo-cc arg>" [--cc ...] — pass arguments through to the Osmo-CC endpoint. Use -cc help for the description. 👑
• --no-l16 — disable the L16 (linear 16 bit) codec. 🚫
• -t, --tones 0 | 1 — connect the call on setup/release to provide classic tones towards the fixed network (default = 1). ☎️
• -l, --loopback <type> — loopback test: 1 = internal | 2 = external | 3 = echo. 🔁
• -r, --realtime <prio> — set prio: 0 to disable, 99 for maximum (default = 0). ⚡
• --fast-math — use fast math approximation for slow CPU / ARM based systems. 🐢➡️🐇
• --write-rx-wave <file> — write received audio to the given wave file. 💾
• --write-tx-wave <file> — write transmitted audio to the given wave file. 💾
• --read-rx-wave <file> — replace received audio with the given wave file. 📂
• --read-tx-wave <file> — replace transmitted audio with the given wave file. 📂
• --limesdr — auto-select several required options for LimeSDR. 🍋
• --limesdr-mini — auto-select several required options for LimeSDR Mini. 🍋

📡 SDR options 📡

• --sdr-soapy — force the 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 not given, 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. 🕰️
• --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 with the given wave file. 📂
• --read-iq-tx-wave <file> — replace transmitted IQ data with the given wave file. 📂
• --sdr-swap-links — swap RX and TX frequencies for loopback tests over the air. 🔄
• --sdr-timestamps 1 | 0 — use TX timestamps on UHD device. (default = 1) ⏱️

🌈 Network specific options 🌈

• -F, --frequency <downlink MHz>,<uplink MHz>,<step KHz> — downlink and uplink frequency to use for channel 0. Give the step for channel spacing. (default = 438.600,431.000,25.0000) 📻
• -S, --squelch <dB> | auto — use the given RF level to detect loss of signal. When the signal gets lost and stays below this level, the connection is released. Use auto to do automatic noise floor calibration to detect loss. Only works with SDR! (disabled by default) 🤫
• -N, --nbfm — use Narrow band FM with deviation of 2.5 KHz instead of 5.0 KHz. 🎛️
• -R, --relay — use the transceiver as a repeater, so multiple radios can communicate with each other. It's still possible to make and receive calls. Multiple radios can talk then to the calling/called party. 📻📻📻
• station_id — give 4 digits of station ID, so you don't need to enter it for every start of this application. Give 4 digits for number. 🔢

Press digits '0'..'9' and then the 'd' key to dial towards a mobile station. Press the 'h' key to hangup. Press the 'w' key to toggle display of RX wave form. Press the 'c' key to toggle display of channel status. Press the 'm' key to toggle display of measurement value. Press the 'q' key to toggle display of RX I/Q vector. Press the 's' key to toggle display of RX spectrum. Press the 'b' key to remove DC level. ⌨️💖

okay bestie that's genuinely all of them, every flag, every default, no gatekeeping 🫶

and that's the whole page, from the General Commands Manual section 1, signed off as jollycom(1) — go forth and transmit, icon behavior only 💅✨