bnetz(1)

✨ NAME ✨

bnetz — bestie, it's the whole thing, and the docs live at http://osmocom-analog.eversberg.eu/docs/ 💖

okay so real talk: this page is from the General Commands Manual, section 1, and every single option below is here, no skips, no summarising, periodt. 🌸

🌍 Global options 🌍

• -h, --help — the help. that's it. that's the option. 💅
• --config [~/]<path to config file> — hand it a config file to use. If it starts with ~/, the path is relative to your home dir. Each line in the config file is one option, and you must NOT put - or -- in there! Default: ~/.osmocom/analog/bnetz.conf
• --no-config — even if a config file exists, don't use it. nope. not today. 🙈
• -v, --verbose <level> | <level>,<category>[,<category>[,...]] | list — use list to get a list of all levels and categories. Verbose level: a digit for the debug level (default = 3). Verbose level + category: level digit followed by one or more categories -> if no category is specified, all categories are selected.
• -v, --verbose date — show the date with debug output 🗓️
• -k, --kanal <channel> / -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 may specify a different recording device by using /. Don't set it 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. In case of buffer underrun, increase the buffer accordingly.
• -b, --buffer <ms> — how many milliseconds are processed in advance (default = 50). A buffer below 10 ms requires a low interval like 0.1 ms.
• -p, --pre-emphasis — enable pre-emphasis, if you directly connect to the oscillator of the transmitter. (No pre-emphasis done by the transmitter.)
• -d, --de-emphasis — enable de-emphasis, if you directly connect 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 — use the echo test, to send back audio from the mobile phone's microphone 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 may 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 are processed in advance (default = 50)
• -x, --osmocc-cross — enable 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
• --cc "<osmo-cc arg>" [--cc ...] — pass arguments to the Osmo-CC endpoint. Use -cc help for 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 by the given wave file.
• --read-tx-wave <file> — replace transmitted audio by 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, 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 source 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 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. 🔄
• --sdr-timestamps 1 | 0 — use TX timestamps on UHD device. (default = 1)

🗼 Network specific options 🗼

• -G, --gfs <gruppenfreisignal> | <lat>,<lon> — Gruppenfreisignal 1..9 | 19 | 10..18 (default = 2). Alternatively give the coordinates of your location, to find the closest base station. (e.g. --gfs 54.487291,9.069993) Or use --gfs list to get a list of all base station locations. 🗺️
• -G, --gfs 19 — set to 19 in order to make the phone transmit at 100 mW instead of the full 15 Watts. If supported, the phone uses the channel with low power (Kanal kleiner Leistung).
• -M, --gebuehrenimpuls <secods> | -<seconds> | 0 — send metering pulses every given number of seconds, or 0 to turn off. Pulses will be sent on outgoing calls only and only if the mobile station requests it. Use a negative value to force metering pulses for all calls. (default = 20) If metering pulses are sent via the Osmo-CC interface, pulses are always sent, if the mobile station requests it. This overrides this option.
• -P, --paging tone | notone | positive | negative | <file>=<on>:<off> — send a tone, give a signal or write to a file when switching to channel 19. (paging the phone). tone, positive, negative is sent on the second audio channel. tone sends a tone whenever channel 19 is switched. notone sends a tone whenever channel 19 is NOT switched. positive sends a positive signal for channel 19, else negative. negative sends a negative signal for channel 19, else positive. Example: /sys/class/gpio/gpio17/value=1:0 writes a 1 to /sys/class/gpio/gpio17/value to switching to channel 19 and a 0 to switch back. (default = tone)
• -S, --squelch <dB> — 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)
• station_id: — give 5 digits of station ID, so you don't need to enter it for every start of this application. Give 5 digits for the B-Netz number. You may use 05xxxxx as prefix.

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 the RX wave form. Press the c key to toggle display of channel status. Press the m key to toggle display of the measurement value. Press the q key to toggle display of the RX I/Q vector. Press the s key to toggle display of the RX spectrum. Press the b key to remove the DC level.

keyboard main character energy fr fr ⌨️✨

and yeah, here's what happens when you get it wrong, kept exactly as it comes out:

[0;33m[1;31mDOPTIONS[0;m[0;33m [1;31mERROR[0;m[0;33m options.c:302 Given command line option '--version' is not a valid option, use '-h' for help![0;m

👀 SEE ALSO 👀

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

info DOPTIONS

should give you access to the complete manual. 📖

and that's the whole page, bestie — from the General Commands Manual, bnetz(1), and the footer just says bnetz(1) right back at you 💅💖 mwah, go page somebody 🎀