fuvst(1)

🌸 NAME

fuvst — okay bestie, this is the one. It's the Osmocom Analog C-Netz thing, and the docs live at http://osmocom-analog.eversberg.eu/docs/ if you wanna go read more 💖

✨ SYNOPSIS

fuvst -k <kanal/channel> [options] [station_id]

🎀 OPTIONS

💅 Global options

• -h, --help — prints this help. iconic of it tbh ✨
• --config [~/]<path to config file> — hand it a config file to use. If it starts with ~/, the path is relative to your home dir. Every single line in the config file is one option, and you must NOT write the - or -- in front of it! Default is ~/.osmocom/cnetz/fuvst.conf 🫶
• --no-config — even if a config file is sitting right there existing, don't use it. ignore it, no cap 🙈
• -v, --verbose <level> | <level>,<category>[,<category>[,...]] | list — pass list and it hands you back a list of every level and category. Verbose level alone = a digit for the debug level (default = 3). Verbose level + category = that level digit followed by one or more categories, and if you don't name a category at all, then all the categories get selected 💅
• -v, --verbose date — shows the date alongside your debug output ⭐
• -k, --kanal <channel> — the channel. Also --channel, same thing.
• -k, --channel <channel> — 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 point at a different recording device by using /. Don't set this at all if you're on 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. And if you're getting buffer underrun, increase the buffer to match, bestie 📉
• -b, --buffer <ms> — how many milliseconds get processed in advance (default = 50). Heads up: a buffer below 10 ms needs a low interval like 0.1 ms 🧚
• --rx-gain <dB> — raise or lower the receiver's RX level by the given gain in dB. (Works with sound card only.) 💜
• --tx-gain <dB> — raise or lower the transmitter's RX level by the given gain in dB. (Works with sound card only.) 💜
• -e, --echo-test — echo test mode: it sends the 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 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 — enable the built-in call forwarding between mobiles. Make sure you have at least one control channel and two voice channels. Or 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 and it'll describe itself ✨
• --no-l16 — disable the L16 (linear 16 bit) codec 💀
• -t, --tones 0 | 1 — connect the call on setup/release so it provides the classic tones towards the fixed network (default = 1) ☎️
• -l, --loopback <type> — loopback test: 1 = internal | 2 = external | 3 = echo 🔁
• -r, --realtime <prio> — set the prio: 0 disables it, 99 is maximum (default = 0) 👑
• --fast-math — use the fast math approximation, for slow CPU / ARM based systems 🐌➡️🚀
• --write-rx-wave <file> — write the received audio out to the given wave file 📝
• --write-tx-wave <file> — write the transmitted audio out 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 🔄

🌈 Network specific options

• -T, --channel-type ZZK / SpK — the channel type to use. One ZZK is the default 💅
• -S, --sio <hex value> — Service Indicator Object. Must be 0xcd! (default = 0xcd) 😤
• -U, --uele <value> — Point Code of the MSC, which must match the EEPROM configuration data of the base station. (default = 1400) 🎯
• -F, --fuko <value> — Point Code of the BS, which must match the EEPROM configuration data of the base station. (default = 1466) 🎯
• -A, --authentication 1 | 0 — enable or disable the authentication procedure. (default = 0) 🔐
• -E, --emergency <prefix> — add the given prefix to the list of emergency numbers 🚑
• --alarms 1 | 0 — enable or disable alarm messages from BS to MSC (default = 1) 🚨
• -G, --gebuehren <duration> — give the Metering pulse duration in seconds (default = 12.00) 💰
• --ignore-link-monitor — don't do any link error checking at MTP 🙈
• -C, --bs-config <filename> — give the DKO config file (a 6 KBytes tape file) to be loaded at boot time 📼
• station_id — give 7 or 8 digits of station ID, so you don't need to type it in for every single start of this application. Give 7 digits for the regular number format. Give 8 digits for the extended number format. You may use '0161xxxxxxx' as a prefix. You may use '0161xxxxxxxx' as a prefix. You may use '+49161xxxxxxx' as a prefix. You may use '+49161xxxxxxxx' as a prefix. 🫶

Keyboard shortcuts, because you're the main character here:

Press the 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 the RX wave form. Press the 'c' key to toggle display of the channel status. Press the 'm' key to toggle display of the measurement value. 🎹✨

okay that's literally the whole page bestie, go forth and slay 💖

This one's signed off as fuvst(1) at the bottom, living in the General Commands Manual — that's the source/version and date tag, and you're all caught up fr fr 🌟👑