TONEGEN(1)

📦 version 4.2.61, in debian bookworm, ubuntu jammy, ubuntu noble, ubuntu questing, ubuntu resolute, ubuntu stonking

💖 TONEGEN(1) — Voicetronix Telephony Tools 💖

okay bestie, welcome to tonegen, the little tool from the Voicetronix Telephony Tools crew. yes we're doing manpage homework but it's actually fun, i promise. 🎀

✨ NAME ✨

tonegen — Test the Voicetronix programmable tone generator

like... it makes tones. on purpose. to test stuff. iconic behaviour honestly. 🔥

🌸 SYNOPSIS 🌸

tonegen [options]

that's it. that's the whole vibe. just options, no positional drama. 💅

🦋 DESCRIPTION 🦋

okay so the tonegen utility uses the programmable tone generator to send tones to some port. that's the whole job. it's giving "professional beeper" and honestly? respect. 💜

⭐ OPTIONS ⭐

here's the full menu, no skipping, we're eating everything on the plate:

  • --card number — Explicitly select the card to test. Default is card 0. (yes, card zero, the main character by default 👑)
  • --port number — Explicitly select the port to test. Default is port 0 of the card being tested.
  • --toneid num — Play a locale specific predefined tone, where 0 <= num < VPB_TONE_ID_MAX. The locale is decided according to the value of the VPB_COUNTRY environment variable. (env var girlies rise up, the whole tone personality is coming from VPB_COUNTRY 🫶)
  • --tone n freq mag — Set a single component for a user defined tone. This option may be used more than once with different values of n to set the components of a multi-frequency tone. Legal values for the other parameters are 0 < freq <= 4000 (Hz), and -inf < mag < 0.0 (dB). (stack these like friendship bracelets for a multi-frequency glow-up ✨)
  • --ontime ms — The number of milliseconds that a user defined tone should be on for.
  • --offtime ms — The number of milliseconds that a user defined tone should be off for.
  • --dial digits — Generates a dial string using the specified dtmf digits.
  • --sync — Play tones using the synchronous api functions. The default is to use the async api. (default = async, so if you want sync you gotta say it out loud 📢)
  • --loop — Loop cadenced tones continuously. Has no effect if a continuous tone has been specified. (continuous tone said "not today" 💀)
  • --recgain db — Set software record gain in dB. Default is 0.0
  • --rec file — Record audio to a file while playing.
  • --contest — Do not wait for a tone to complete before starting the next one. This can be useful for stress testing the coherency of the tone generator. (chaos mode. tones overlapping. stress testing. it's giving finals week 😭)
  • --help, -? — Show summary of these options. (the classic "help me bestie" flag 🧚)

👑 AUTHOR 👑

Ron Lee, Voicetronix <support@voicetronix.com.au>

This manual page was written by Ron <ron@debian.org>, for the Debian project (but may be used by others). (shoutout Ron, absolute legend for writing this down so the rest of us could vibe 💖)

and that's the whole page bestie!! 🌈✨ this little gem shipped as part of the VPB driver package, dated Feb 18, 2007 — yes she's vintage, yes she still slays, periodt. 💅🎀🦋

📦 where this page comes from