eurosignal(1)

👑 eurosignal(1) — General Commands Manual 👑

okay bestie, welcome to the eurosignal era ✨ this is a page from the General Commands Manual, and yes we're doing this together, hand in hand, because Unix is scary but we are scarier 💅

🌸 NAME 🌸

eurosignal — literally just points you at http://osmocom-analog.eversberg.eu/docs/ like a little linktree for a very specific hobby, no cap 🫶

🦋 SYNOPSIS 🦋

eurosignal -k <kanal/channel> [--random] [options] [station_id]

that's the whole vibe. give it a channel, maybe some extras, maybe a station ID, and she goes 💖

✨ DESCRIPTION ✨

so before we even get to the good stuff, here's the actual terminal chatter that shows up — because yes it's part of the page, and yes we're keeping it, every character, periodt:

[0;33m[1;32mDOPTIONS[0;m[0;33m [1;32mINFO[0;m[0;33m options.c:128 Config file '/build/osmocom-analog-pdpgXJ/osmocom-analog-0.0/debian/.debhelper/generated/_source/home/.osmocom/analog/eurosignal.conf' seems not to exist, using command line options only.[0;m
[0;33m[1;32mDOPTIONS[0;m[0;33m [1;32mINFO[0;m[0;33m options.c:296 Command line option '--help'[0;m

she's telling you the config file wasn't there so she's rolling with command line options only. iconic honestly.

🌈 Global options: 🌈

• -h, --help — the help. that's it. that's the option 💅
• --config [~/]<path to config file> — hand her a config file to use. if the path starts with ~/, it's relative to your home dir. every line in the config file is exactly one option, and you must NOT put - or -- in front of it, ok? default is ~/.osmocom/analog/eurosignal.conf 🎀
• --no-config — even if a config file is sitting right there being all available, do not use it. we ignore her. respectfully 🙈
• -v, --verbose <level> | <level>,<category>[,<category>[,...]] | list — use list to get a list of all the levels and categories. verbose level = just a digit for the debug level (default is 3). verbose level + category = level digit followed by one or more categories → and if you don't specify any category, all categories get selected 💀
• -v, --verbose date — show the date along with the debug output 📅
• -k, --kanal <channel> — channel number of the "Sender" (German = Transceiver) 🇩🇪
• -k, --channel <channel> — channel number of the "Sender" (German = Transceiver). same option, different spelling, we love a bilingual king 👑
• -a, --audio-device hw:<card>,<device>[/hw:<card>.<rec-device>] — sound card and device number (default is hw:0,0). you can point at a different recording device by using /. and bestie listen: don't set this for SDR! 🚫
• -s, --samplerate <rate> — sample rate of the sound device (default is 48000) 🎵
• -i, --interval 0.1..25 — interval of the processing loop, in ms (default is 1.0 ms). use 10 to drastically reduce CPU usage. if you get buffer underrun, increase the buffer accordingly 📈
• -b, --buffer <ms> — how many milliseconds get processed in advance (default is 50). 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. (only works with a sound card, just so you know.) 🎚️
• --tx-gain <dB> — raise or lower the transmitter's RX level by the given gain in dB. (also sound card only.) 🎚️
• -e, --echo-test — echo test mode: sends 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 is ''). you can give a different recording device with / 🎧
• --call-samplerate <rate> — sample rate of the sound device for the headset (default is 48000) 🎶
• --call-buffer <ms> — how many milliseconds get processed in advance (default is 50) ⏳
• -x, --osmocc-cross — turn on 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 channel 📞
• -o, --osmocc-sock — disable built-in call control and offer a socket instead 🔌
• --cc "<osmo-cc arg>" [--cc ...] — pass arguments to the Osmo-CC endpoint. use -cc help for a 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 is 1) ☎️
• -l, --loopback <type> — loopback test: 1 = internal | 2 = external | 3 = echo 🔁
• -r, --realtime <prio> — set priority: 0 disables it, 99 is maximum (default is 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 with the given wave file 📂
• --read-tx-wave <file> — replace transmitted audio with 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 a channel number for a multi channel SDR device (default is 0) 📡
• --sdr-device-args <args> — optional SDR device arguments, separated by comma, e.g. --sdr-device-args <key>=<value>[,<key>=<value>[,...]] 🛠️
• --sdr-stream-args <args> — optional SDR device arguments, separated by comma, e.g. --sdr-device-args <key>=<value>[,<key>=<value>[,...]] 🛠️
• --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> — frequency offset in Hz to move the local oscillator away from the target frequency (default is -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 source name, use list to get a list 📋
• --sdr-rx-gain <gain> — the SDR device's RX gain in dB (default is 0.0) 📈
• --sdr-tx-gain <gain> — the SDR device's TX gain in dB (default is 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 with the given wave file 📂
• --read-iq-tx-wave <file> — replace 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 a UHD device (default is 1) ⏰

🎀 Network specific options: 🎀

• -F, --fm — use frequency modulation instead of amplitude modulation. the carrier frequency will be 7.5 KHz above/below the actual frequency. this makes sure the change in frequency shows up as a change in amplitude at the demodulator of the receiver 🌀
• -T, --tx — transmit Eurosignal on the given channel, to page a receiver. (this is the default) 📤
• -R, --rx — receive Eurosignal on the given channel, so we are the receiver. if neither -T nor -R is given, only the transmitter is enabled 📥
• -I, --id <id> [-I ...] — give one or more IDs so only those IDs are allowed to be transmitted and received. this option can be repeated many times. if you don't specify it, any ID is allowed to transmit. also, any given ID causes a beep when received. this requires a call device (sound card) to be defined, or an MNCC interface. (the caller ID will be the received pager ID. the called number will be 1 for the first ID given, 2 for scond, ...) 📟
• -D, --degraded — play the announcement that the system is degraded due to failure of one or more transmitters. if the caller hangs up during or right after the announcement, no paging is performed ⚠️
• -S, --scan <from> <to> — scan through the given IDs once (no repetition). this is genuinely useful for finding the ID of a vintage receiver. heads up: scanning all IDs from 000000 through 999999 would take almost 10 Days 😭
• --random — repeat some pseudo random IDs, so the transmitted signal sounds authentic and like it's handling many calls. it will still be possible to page a recevier 🎲
• --repeat <num> — repead paging ID <num> times when transmitting (default is 4) 🔁
• station_id — give 6 digits of station ID, so you don't need to enter it for every start of this application. give 6 digits for number. you may use '0279xxxxxx' as prefix. you may use '+49279xxxxxx' as prefix. you may use '0509xxxxxx' as prefix. you may use '+49509xxxxxx' as prefix. you may use '0709xxxxxx' as prefix. you may use '+49709xxxxxx' 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 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 ⌨️✨

and then, because the universe is a comedy, you get this:

[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

she said what she said. --version is not a valid option, use -h for help 💀

🌟 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, this command

info [0;33m[1;32mDOPTIONS[0;m[0;33m

should give you access to the complete manual 📚

and that's the whole page, bestie 🫶 the footer at the very bottom just says eurosignal(1) — that's the manual page tag and the date line closing us out, so let's give her a little curtsy, she earned it 👑💖✨