Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

tonedebug(1) [debian man page]

TONEDEBUG(1)						    Voicetronix Telephony Tools 					      TONEDEBUG(1)

tonedebug - Test parameters for the libvpb programmable tone detector SYNOPSIS
tonedebug [options] DESCRIPTION
The tonedebug utility assists with quickly testing tone detector parameters against the signals they are intended to detect. It has three main modes of operation for testing single continuous or pulsed tones, or for testing a set of tones specified in the environment. OPTIONS
The following common options apply for all modes: --card number Explicitly select the card to test. Default is card 0. --port number Explicitly select the port to test. Default is port 0 of the card being tested. -w wavfile Specify a wav file to play the tones from. For OpenLine and OpenSwitch cards it should be played to an FXO port with no phone line connected, and the tone detector will process the reflected signal from the hybrid circuit. The OpenPCI cards have almost no echo from this circuit, but an on hook phone connected to an FXS port should produce a detectable echo signal. -s filename.c Writes out a C function that can be included in your own code to configure the tone generator with the settings being tested. Environment options To run tonedebug using the settings specified with the VPB_TONE environment variables, call it with the -e option. For example: $ tonedebug -e --port 4 -w my.wav Will use the enviroment settings to try and detect tones from my.wav played into port 4 of card 0. There are no other options specific to this mode. Continuous tone options If passed the -c option, then the tonedebug utility will test parameters suitable for a continuous tone. For example: $ tonedebug -c 425 100 2000 -w dialtone.wav -t dial Will try to detect 2 seconds of 425Hz tone from dialtone.wav, played into port 0 of card 0. If it succeeds it will report a dial event. The following additional options may be used in this mode: -c center-freq bandwidth duration Specifies the primary tone characteristics, its frequency and bandwidth in Hz. and its minimum duration in milliseconds. -d center-freq2 bandwidth2 Specifies the second tone of a multi-frequency tone. -q twist Specifies the twist of a multi-frequency tone. -n snr Specifies the acceptable signal to noise ratio, in dB. -t dial | busy | ringback Specifies the name of a predefined tone to replace with the given settings. Pulsed tone options The -p options will enable testing for pulsed tones. In addition to the common options and the options for continuous tones, the following options are supported in this mode: -p center-freq bandwidth on-time Specifies the primary tone characteristics, its frequency and bandwidth in Hz. and its 'on' time in milliseconds. -off off-time The 'off' time of the pulse in milliseconds. SEE ALSO
tonetrain(1) BUGS
We rely on an echo from the hardware to feed the signal into the tone detector. This should be fixed to feed it in directly at some stage in the future. AUTHOR
Ron Lee, David Rowe, Voicetronix <> This manual page was written by Ron <>, for the Debian project (but may be used by others). VPB driver package Feb 2, 2007 TONEDEBUG(1)

Check Out this Related Man Page

FXOTUNE(8)						System Manager's Manuals: Asterisk						FXOTUNE(8)

fxotune - automatically tune DAHDI FXO channels SYNOPSIS
fxotune -i [options] - detect mode fxotune -d [ options ] - dump mode fxotune -s - Startup mode DESCRIPTION
fxotune is a script that fine-tune parameters of the FXO modules of the card. It has three modes of operation: Detect mode (-i): it detects and tunes all the available FXO channels. It writes settings to a configuration file (/etc/fxotune.conf) from which it can be loaded (e.g: at startup) using -s . Dump mode (-d): Runs detection on a single DAHDI channel, and just dumps waveforms to fxotune_dump.vals is generated in the current direc- tory. Startup mode (-s): fxotune just reads the settings from fxotune.conf into the FXO modules. You are advised to run fxotune on all FXO ports you have that support it and that are connected. Note that the tunning is affected by e.g. the physical parameters of the connection, and thus if it has been radically changed, you may need to re-run fxotune. This program only works for the Digium TDM400P/800P/2400P cards and compatible and the Xorcom Astribank devices. Other cards (notably X100P cards and clones) do not have the hardware to support such tuning. The tuning process needs a clear line to do the tuning. In order to do that, it runs in cycles of the following: sets the line off-hook, dials a dial string (which should set the PSTN provider waiting for the next digit), and then starts tuning. It has a limited ammount of time for tuning before the PSTN gives up and gives a busy tone. So after a while it hangs up and starts a new cycle. fxotune has two operation modes: tune (-i) and set (-s). In the tune mode it generates /etc/fxotune.conf, and in the set mode it merely applies the parameters from fxotune.conf to device's ports. OPTIONS
The following options below except -v (verbose) affect only the detection process and hence apply only to the detect and dump modes. In addition, to maintain compatibility with older versions of fxotune, if in detect or dump mode there is a parameter with option before it, it is considered to be the dialstring parameter (-n). -b startdev Start tuning from dahdi channel num. startdev: skip all previous channels. By default starting from channel 1. In dump mode (-d) this is the single channel that will be tested. -e stopdev Tune only up to dahdi channel num. stopdev: skip all previous channels. By default stopping at channel 252. In dump mode (-d) this parameter is ignored. -l delay-to-silence Time in seconds to wait after dialing the dial-string to get a clear line. The default is 0. before -m silence-good-for Time in seconds which states how long the PSTN will wait after we dialed the dial-string until it starts giving a busy tone. You can test this by connecting an analog phone to the line and dialing. The default is 18 (18 seconds). -n dial-string Digits to dial to the PSTN in order to get it stop its dialtone and waiting for the next digit. The default is "4" (sending just the digit 4). It should work in most cases. Again, this can be tested by connecting a phone to the PSTN line and dialing the dial-string. -t detect-type This option allows using the older detection method used by fxotune of Zaptel 1.2. use -t 1 for that older method. whereas -t 2 (the default) uses the current method. This option only applies to detect mode (-i). -v[vvvv] Sets debugging on. The more v-s, the higher debug level. Note that: -vv -v will actually set debug level to 1 instead of 3. -w wave-form The default: -1, for multitone waveform. Alternatively: a frequency of a single tone. This option only applies to dump mode (-d). EXAMPLES
fxotune -i 9 if you need to dial 9 for an external line. If you always get a line, you can simply use any digit. -s Load settings from the last test. Used at startup. FILES
/etc/fxotune.conf The configuration file generated by fxotune in detect mode and from which configuration is loaded when -s is used. NOTES
Running fxotune takes approximately a minute per port. If you wish to only run fxotune for several ports, you can use the options -b and -e to set a specific range of ports. Another useful trick is to actually keep asterisk running, and only "destroy" the dahdi channels you wish to tune (dahdi destroy channel NNN): other channels will be used by Asterisk, and hence skipped. This can be useful if you have many FXO ports that are not connected. fxotune writes immediately to /etc/fxotune.conf so if you stop it half-way, you may get a half-configured system. If you have already tuned your FXO channels and wish to test-run fxotune again, you are advised to backup /etc/fxotune.conf . The default for -m is 18 seconds. This asusmes that you get a clear line for at least 18 seconds. It is advised that you test that timeout earlier by connecting a phone to the FXO line, dialing 4 (or whatever dial string you put with -n) and see how much time of silence you have. If you connect your device to a PSTN provider that is not in the US, there is a similar operation you should apply before even getting to fxotune: setting the opermode. The opermode sets a number of country-specific parameters. For the Digium analog cards this is set through the kernel module parameter 'opermode' . For the Xorcom Astribank this is set through the variable 'opermode' in /etc/dahdi/xpp.conf . For valid values of this parameter, see /usr/share/asterisk/init_fxo_modes (FIXME: this has changed and will change. Tzafrir). SEE ALSO
dahdi_cfg(8), dahdi_tool(8), dahdi_monitor(8), asterisk(8). AUTHOR
This manual page was written by Tzafrir Cohen <> Permission is granted to copy, distribute and/or modify this docu- ment under the terms of the GNU General Public License, Version 2 any later version published by the Free Software Foundation. On Debian systems, the complete text of the GNU General Public License can be found in /usr/share/common-licenses/GPL. asterisk 9 June 2007 FXOTUNE(8)
Man Page

Featured Tech Videos