Provided by: osmocom-analog_0.0~git20250208.4ebf64f-1_amd64 
NAME
bnetz - http://osmocom-analog.eversberg.eu/docs/
Global options:
-h --help
This help
--config [~/]<path to config file>
Give a config file to use. If it starts with '~/', path is at home dir. Each line in config file
is one option, '-' or '--' must not be given! Default: '~/.osmocom/analog/bnetz.conf'
--no-config
Even if a config file exists, don't use it.
-v --verbose <level> | <level>,<category>[,<category>[,...]] | list
Use 'list' to get a list of all levels and categories. Verbose level: digit of 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 date with debug output
-k --kanal <channel>
-k --channel <channel>
Channel (German = Kanal) number of "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 sound device (default = '48000')
-i --interval 0.1..25
Interval of processing loop in ms (default = '1.0' ms) Use 10 to drastically reduce CPU usage. In
case of buffer underrun, increase buffer accordingly.
-b --buffer <ms>
How many milliseconds are processed in advance (default = '50') A buffer below 10 ms requires 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 receiver's RX level by given gain in dB. (Works with sound card only.)
--tx-gain <dB>
Raise/lower transmitters's RX level by given gain in dB. (Works with sound card only.)
-e --echo-test
Use echo test, to send back audio from 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 headset (default = '') You may specify a different recording
device by using '/'.
--call-samplerate <rate>
Sample rate of sound device for 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 channels.
-o --osmocc-sock
Disable built-in call control and offer socket
--cc "<osmo-cc arg>" [--cc ...]
Pass arguments to Osmo-CC endpoint. Use '-cc help' for description.
--no-l16
Disable L16 (linear 16 bit) codec.
-t --tones 0 | 1
Connect call on setup/release to provide classic tones towards 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 given wave file.
--write-tx-wave <file>
Write transmitted audio to given wave file.
--read-rx-wave <file>
Replace received audio by given wave file.
--read-tx-wave <file>
Replace transmitted audio by 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 SoapySDR driver
--sdr-channel <channel #>
Give channel number for 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 frequency offset in Hz to move the local oscillator away from the target frequency. (default
= -1000000)
--sdr-bandwidth <bandwidth>
Give IF filter bandwidth to use. If not, sample rate is used.
--sdr-rx-antenna <name>
SDR device's RX antenna name, use 'list' to get a list
--sdr-tx-antenna <name>
SDR device's TX antenna name, use 'list' to get a list
--sdr-clock-source <name>
SDR device's clock sourc name, use 'list' to get a list
--sdr-rx-gain <gain>
SDR device's RX gain in dB (default = 0.0)
--sdr-tx-gain <gain>
SDR device's TX gain in dB (default = 0.0)
--write-iq-rx-wave <file>
Write received IQ data to given wave file.
--write-iq-tx-wave <file>
Write transmitted IQ data to given wave file.
--read-iq-rx-wave <file>
Replace received IQ data by given wave file.
--read-iq-tx-wave <file>
Replace transmitted IQ data by 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') Alternative give your coordinates of your
location, to find 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 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 mobile station requests it. Use negative value to force metering
pulses for all calls. (default = 20) If metering pulses are sent via Osmo-CC interface, pulses
are always sent, if 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 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 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 B-Netz
number. You may use '05xxxxx' as prefix.
Press digits '0'..'9' and then 'd' key to dial towards mobile station. Press 'h' key to hangup. Press
'w' key to toggle display of RX wave form. Press 'c' key to toggle display of channel status. Press 'm'
key to toggle display of measurement value. Press 'q' key to toggle display of RX I/Q vector. Press 's'
key to toggle display of RX spectrum. Press 'b' key to remove DC level.
[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 [0;33m[1;32mDOPTIONS[0;m[0;33m is maintained as a Texinfo manual. If the info
and [0;33m[1;32mDOPTIONS[0;m[0;33m programs are properly installed at your site, the command
info [0;33m[1;32mDOPTIONS[0;m[0;33m
should give you access to the complete manual.
bnetz(1)