radiocom2000(1)

💖 radiocom2000 💖

okay so bestie, welcome to radiocom2000(1) — yes that's the manual name, it's from the General Commands Manual, and it's literally the whole analog radio situation at http://osmocom-analog.eversberg.eu/docs/ . Sit down, grab a strawberry 🍓, we're doing this.

🎀 NAME 🎀

radiocom2000 — http://osmocom-analog.eversberg.eu/docs/

✨ SYNOPSIS ✨

radiocom2000 -k <kanal/channel> [-R <relais number>] [options]
[station_id]

🌸 Global options 🌸

• -h, --help — the classic. it shows you this help. king behavior 👑
• --config [~/]<path to config file> — hand it a config file to use. if the path starts with ~/, that path lives in your home dir. each line in the config file is exactly one option — and do NOT put the - or -- in there, we're not doing that. default: ~/.osmocom/analog/radiocom2000.conf
• --no-config — even if a config file is sitting there existing, don't use it. bye 💅
• -v, --verbose <level> | <level>,<category>[,<category>[,...]] | list — throw list in to get a list of every level and category. the verbose level is a digit for the debug level (default = 3). level + category is that level digit followed by one or more categories → and if you don't name a category, all categories get selected, no cap.
• -v, --verbose date — slap the date onto the debug output 🗓️
• -k, --kanal <channel>
• -k, --channel <channel> — the channel (German = Kanal) number of the "Sender" (German = Transceiver). yes, two spellings, same vibe.
• -a, --audio-device hw:<card>,<device>[/hw:<card>.<rec-device>] — sound card and device number (default = hw:0,0). you can point at 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're getting buffer underrun, increase the buffer accordingly, bestie.
• -b, --buffer <ms> — how many milliseconds get 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. (because no pre-emphasis is being done by the transmitter. she's not doing it. it's on you.)
• -d, --de-emphasis — enable de-emphasis, if you're connecting directly to the discriminator of the receiver. (no de-emphasis done by the receiver. same energy.)
• --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 transmitters's RX level by the given gain in dB. (works with sound card only.)
• -e, --echo-test — echo test time: audio from the mobile phone's microphone gets sent 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 specify 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 get processed in advance (default = 50)
• -x, --osmocc-cross — enables the built-in call forwarding between mobiles. be sure you have at least one control channel and two voice channels. alternatively, use one combined control+voice channel and one voice channels.
• -o, --osmocc-sock — disables built-in call control and offers a socket instead
• --cc "<osmo-cc arg>" [--cc ...] — pass arguments to the Osmo-CC endpoint. use -cc help for the description.
• --no-l16 — disable the L16 (linear 16 bit) codec. she's gone 🙈
• -t, --tones 0 | 1 — connect the call on setup/release so you get 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 the received audio to the given wave file.
• --write-tx-wave <file> — write the transmitted audio to the given wave file.
• --read-rx-wave <file> — replace the received audio with the given wave file.
• --read-tx-wave <file> — replace the transmitted audio with the given wave file.
• --limesdr — auto-selects several required options for LimeSDR ✨
• --limesdr-mini — auto-selects 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> — the 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 gets 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 the received IQ data to the given wave file.
• --write-iq-tx-wave <file> — write the transmitted IQ data to the given wave file.
• --read-iq-rx-wave <file> — replace the received IQ data with the given wave file.
• --read-iq-tx-wave <file> — replace the 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 the UHD device. (default = 1)

👑 Network specific options 👑

• -B, --band <number> | list
• -B, --bande <number> | list — give the frequency band; use list to get a list. (default = 1)
• -T, --channel-type <channel type> | list — give the channel type; use list to get a list. (default = CC/TC)
• -R, --relais <relais number> — give the relais number (that's the base station ID), 1..511. (default = 32) be sure to set the station mobile to the same relais number!
• --deport 0..7 — supervisory information to tell about sub-stations. the functionality is unknown. (default = 0) 🤷‍♀️
• -I, --agi 0..7 | list — supervisory information to tell which phone is allowed to register. use list to get a list of possible valued. (default = 7 = Registration permissible for all mobile station)
• -P, --sm-power <power level> — give the power level of the station mobile, 0..1. (default = 0) 0 = low (about 1 Watts) · 1 = high (up to 10 Watts)
• --taxe 0..1 — supervisory information to tell about rate information. the functionality is unknown. (default = 0) 🫠
• -C, --crins 0..7 | list [--destruction YES] — the result that gets returned when the phone registers. NEVER USE 3, IT WILL DESTROY YOUR PHONE, but it shows a warning first! use list to get a list of possible valued. (default = 0 = Finished or just registering)

💀 bestie I am BEGGING you. do not pick 3. that's not a vibe, that's a funeral.

• -N, --nconv 0..7 — supervisory digit, sent during conversation. (default = 0) it's used to detect a lost signal. when using multiple traffic channels, this value is incremented per channel.
• -S, --recall — suspend the outgoing call after dialing, and recall when the called party has answered.

📱 station-id 📱

station-id: give 1 digit of station mobile type + 3 digits of home relais ID + 5 digits of mobile ID.

like, e.g. 103200819 = type 1, relais ID 32, mobile ID 819. cute, right?

🎮 Keys, because you're the main character 🎮

• 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 that's genuinely the whole page. every flag, every default, every dB, every "functionality is unknown", all of it. nothing skipped, periodt. 💅

and that's the wrap, bestie 🫶 — this was radiocom2000(1), straight out of the General Commands Manual. the footer is just radiocom2000(1) again (iconic minimalism, honestly), no extra version or date drama on this one. go make some radio magic ✨📻💜