SIGLEVDETCAL(1)

📦
version 24.02 · 3 versions
, in debian trixie, fedora 43, fedora 44, ubuntu questing

okay bestie so this is a page from the User Manuals, and it's literally all about siglevdetcal — the SvxLink signal level detector calibration utility. Sit down, grab a strawberry 🍓, we're gonna calibrate your receiver and it's gonna be iconic.

✨ NAME ✨

siglevdetcal — the SvxLink signal level detector calibration utility. That's it, that's the vibe. 🎀

✨ SYNOPSIS ✨

siglevdetcal <configuration file> <RX config section name>

two arguments, no cap. the config file and the name of the RX config section, periodt. 💅

✨ DESCRIPTION ✨

so siglevdetcal is the SvxLink signal level detector calibration utility, and it's here to help you set up the SIGLEV_SLOPE and SIGLEV_OFFSET configuration variables for a local receiver 🫶. Heads up though: the signal level detector needs to be calibrated if a voter or the SIGLEV squelch detector is gonna be used. No calibration = no slay. 😭

the calibration procedure is quite simple ngl — everything is more or less explained at run-time, so it literally walks you through it. But here's the outline in case you want the whole tea upfront: 🦋

  • Disconnect the antenna and the PTT cable. The PTT might be triggered by the siglevdetcal utility. If you want to be really sure that no harm come to your transceiver, connect a dummy load. 🔥 (yes this is the serious one, don't skip it)
  • Setup the audio input level. The audio input level must not be changed after the calibration has been done. ⭐
  • Start the siglevdetcal utility. 💖
  • Transmit on another radio so that the receiver under calibration will receive full signal strength. 👑
  • Still holding the PTT, press ENTER and wait until the squelch open level measurements have been done. 🌸
  • Release the PTT. Make sure the squelch is open so that only noise is received. 🎧
  • Press ENTER to start the squelch close level measurements. 🦋
  • When finished, the two config variables SIGLEV_SLOPE and SIGLEV_OFFSET are printed. Put these in your configuration file under the corresponding receiver configuration section. ✨
  • Start the SvxLink server and verify that full signal strength is showed as about 100 and open squelch is showed as about 0. If full signal strength is not showed, you might have to setup SQL_DELAY to delay the signal level measurement until the signal is stable. 💜
fr fr, that first bullet is the main character of safety warnings — disconnect the antenna and PTT cable, and use a dummy load if you want to be really sure nothing happens to your transceiver. 💀

🌈 ENVIRONMENT 🌈

  • ASYNC_AUDIO_NOTRIGGER — set this environment variable to 1 if you get an error about ioctl: Broken pipe when the remotetrx server starts. 🙈
  • ASYNC_AUDIO_ALSA_ZEROFILL — set this environment variable to 0 to stop the Alsa audio code from writing zeros to the audio device when there is no audio to write available. 🔇
  • ASYNC_AUDIO_UDP_ZEROFILL — set this environment variable to 1 to enable the UDP audio code to write zeros to the UDP connection when there is no audio to write available. 📡

💖 AUTHOR 💖

Tobias Blomberg (SM0SVX) <sm0svx at svxlink dot org> — the icon who made this 🫶

🐛 REPORTING BUGS 🐛

Bugs should be reported using the issue tracker at https://github.com/sm0svx/svxlink. 🦋

okay so real talk: questions about SvxLink should not be asked using the issue tracker. Instead use the group set up for this purpose at groups.io: https://groups.io/g/svxlink. The issue tracker is for bugs, the group is for questions — that's the vibe check. 💅

⭐ SEE ALSO ⭐

svxlink(1), remotetrx(1), svxlink.conf(5) — go read them, iykyk 📚

and that's the whole page bestie! ✨ this cutie came from Linux, dated AUGUST 2021 — mwah, go calibrate something iconic 💅💖🎀

📦 where this page comes from