anetz_user_commands(1)

Okay bestie, this is anetz_user_commands(1), the General Commands Manual entry for anetz 💅✨ Let's get into it.

✨ NAME ✨

Meet anetz, the app for A-Netz vibes 🦋 Its homepage is http://osmocom-analog.eversberg.eu/docs/ 🌈

🎀 SYNOPSIS 🎀

Here's the basic shape of the command you'll be typing 💖

anetz -k <kanal/channel> [-V 12] [options] [station_id]

🌸 Global options 🌸

• -h, --help — Shows this help. Obviously 🙈
• --config [~/]<path to config file> — Pass in a config file to use 📄 If the path starts with ~/, it's relative to your home dir. Each line in the config file is one option, and you must not type the - or -- in front of it 💅 Default is ~/.osmocom/analog/anetz.conf.
• --no-config — Even if a config file exists, just ignore it 🙅‍♀️
• -v, --verbose <level> | <level>,<category>[,<category>[,...]] | list — Use list to see every level and category 📋 The level is a debug digit (default 3). You can add categories after the level digit too. If you don't pick any categories, you get all of them 🔥
• -v, --verbose date — Stamps the date onto your debug output 📅
• -k, --kanal <channel> — Your channel (German: Kanal) number for the "Sender" (German: Transceiver) 📡
• -k, --channel <channel> — Same energy, the English name for the channel number 📡
• -a, --audio-device hw:<card>,<device>[/hw:<card>.<rec-device>] — Picks your sound card and device number. Default is hw:0,0 🔊 You can use / to give it a different recording device.

Don't set this one for SDR! It's a whole mood-killer if you do 🙈

• -s, --samplerate <rate> — Sample rate of your sound device (default 48000) 🎶
• -i, --interval 0.1..25 — How often the processing loop runs, in ms (default 1.0 ms) ⏱️ Go with 10 if you want to drastically cut CPU usage 💻 If you get buffer underruns, bump the buffer up to match.
• -b, --buffer <ms> — How many milliseconds get processed in advance (default 50) 🧠 A buffer under 10 ms needs a low interval, like 0.1 ms.
• --rx-gain <dB> — Turns your receiver's RX level up or down by the gain you give in dB 🎚️ (Sound card only!)
• --tx-gain <dB> — Turns the transmitter's level up or down by the gain you give in dB 🎚️ (Sound card only!)
• -e, --echo-test — Sends the audio from your phone's mic straight back to the speaker 🎤➡️🔈 (German: Blasprobe, lol iconic 💀)
• -c, --call-device hw:<card>,<device>[/hw:<card>.<rec-device>] — Sound card and device number for your headset (default is '', so nothing) 🎧 Use / to give it a different recording device.
• --call-samplerate <rate> — Sample rate for the headset's sound device (default 48000) 🎧
• --call-buffer <ms> — How many milliseconds get processed in advance for the headset (default 50) 🎧
• -x, --osmocc-cross — Turns on built-in call forwarding between mobiles 📲 You need at least one control channel and two voice channels. Or, alternatively, one combined control+voice channel and one voice channels. Choose your fighter 👑
• -o, --osmocc-sock — Turns off the built-in call control and offers a socket instead 🔌
• --cc "<osmo-cc arg>" [--cc ...] — Passes arguments to the Osmo-CC endpoint 🧚 For a description, try -cc help.
• --no-l16 — Disables the L16 (linear 16 bit) codec 🚫
• -t, --tones 0 | 1 — Connects the call on setup and release so you get classic tones toward the fixed network 🔔 (default 1)
• -l, --loopback <type> — Loopback test: 1 = internal, 2 = external, 3 = echo 🔁
• -r, --realtime <prio> — Sets priority: 0 to disable, 99 for maximum (default 0) 🏎️
• --fast-math — Uses a fast math approximation, perfect for slow CPUs and ARM-based systems 🐢➡️🐇
• --write-rx-wave <file> — Saves the received audio to the wave file you name 💾
• --write-tx-wave <file> — Saves the transmitted audio to the wave file you name 💾
• --read-rx-wave <file> — Swaps the received audio out for the wave file you give it 🎞️
• --read-tx-wave <file> — Swaps the transmitted audio out for the wave file you give it 🎞️
• --limesdr — Auto-picks several of the options you need for LimeSDR 🌟
• --limesdr-mini — Auto-picks several of the options you need for LimeSDR Mini 🌟

🦋 SDR options 🦋

• --sdr-soapy — Forces the SoapySDR driver 💫
• --sdr-channel <channel #> — 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 arguments, separated by commas 🧩 Here's the vibe:

--sdr-device-args <key>=<value>[,<key>=<value>[,...]]

• --sdr-samplerate <samplerate> — The SDR sample rate. By default it matches your regular sample rate 🎶
• --sdr-lo-offset <Hz> — A frequency offset in Hz that moves the local oscillator away from your target frequency (default -1000000) 🎯
• --sdr-bandwidth <bandwidth> — The IF filter bandwidth to use. If you don't give one, the sample rate gets used 📶
• --sdr-rx-antenna <name> — The SDR device's RX antenna name. Type list to see your options 📋
• --sdr-tx-antenna <name> — The SDR device's TX antenna name. Type list to see your options 📋
• --sdr-clock-source <name> — The SDR device's clock source name. Type list to see your options ⏰
• --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> — Saves the received IQ data to the wave file you name 💾
• --write-iq-tx-wave <file> — Saves the transmitted IQ data to the wave file you name 💾
• --read-iq-rx-wave <file> — Swaps the received IQ data for the wave file you give it 🎞️
• --read-iq-tx-wave <file> — Swaps the transmitted IQ data for the wave file you give it 🎞️
• --sdr-swap-links — Swaps the RX and TX frequencies for over-the-air loopback tests 🔄
• --sdr-timestamps 1 | 0 — Uses TX timestamps on a UHD device (default 1) ⏱️

💅 Network specific options 💅

• -O, --operator <number> — The number to dial when a mobile station starts a call. A-Netz doesn't do automatic dialing, so you need operator assistance 📞 By default the operator 010 gets dialed.
• -G, --geo <lat>,<lon> — Your coordinates, so the app can find the closest base station 🗺️ For example: --geo 51.186959,7.080194. Or type --geo list to see every base station location 📍
• -V, --page-gain <dB> — Raises the gain of the paging tones to make up for the loss from the transmitter's pre-emphasis 📈 (Use this if you can't turn pre-emphasis off 🙃)
• -P, --page-sequence 0 | <ms> — Cycles the paging tones instead of sending them all at once 🔁 Try 100 (default 0).
• -S, --squelch <dB> | auto — Uses the RF level you give to detect loss of signal. If the signal drops and stays below that level, the connection gets released 📉 Use auto for automatic noise floor calibration.

This only works with SDR! It's disabled by default, so don't be surprised 🙈

• station_id — Give 5 or 7 digits of station ID 🪪 so you don't have to type it in every time you start the app. 5 digits is for a number without the channel prefix, and 7 digits is for a number with the channel prefix.

Once you're in, here are the keypresses that make you the main character 👑

• Press digits 0..9 and then the d key to dial the mobile station 📞
• Press h to hang up 📴
• Press w to toggle the RX waveform display 🌊
• Press c to toggle the channel status display 📊
• Press m to toggle the measurement value display 📏
• Press q to toggle the RX I/Q vector display 🧭
• Press s to toggle the RX spectrum display 🌈
• Press b to remove the DC level 🧹

Okay that's the whole tea 🫶 The footer just said anetz_user_commands(1) again, so you're totally caught up now 🦋 Go make some noise, bestie 💖✨