.\" Hey, EMACS: -*- nroff -*- .\" First parameter, NAME, should be all caps .\" Second parameter, SECTION, should be 1-8, maybe w/ subsection .\" other parameters are allowed: see man(7), man(1) .TH TONEDEBUG 1 "Feb 2, 2007" "VPB driver package" "Voicetronix Telephony Tools" .\" Please adjust this date whenever revising the manpage. .\" .\" Some roff macros, for reference: .\" .nh disable hyphenation .\" .hy enable hyphenation .\" .ad l left justify .\" .ad b justify to both left and right margins .\" .nf disable filling .\" .fi enable filling .\" .br insert line break .\" .sp insert n+1 empty lines .\" for manpage-specific macros, see man(7) .SH NAME tonedebug \- Test parameters for the libvpb programmable tone detector .SH SYNOPSIS .B tonedebug .RI [ options ] .SH DESCRIPTION The \fBtonedebug\fP 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 \fIcontinuous\fP or \fIpulsed\fP tones, or for testing a set of tones specified in the environment. .SH OPTIONS The following common options apply for all modes: .TP .BR \-\-card " number" Explicitly select the card to test. Default is card 0. .TP .BR \-\-port " number" Explicitly select the port to test. Default is port 0 of the card being tested. .TP .BR \-w " wavfile" Specify a wav file to play the tones from. For OpenLine and OpenSwitch cards it should be played to an \fIFXO\fP 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 \fIFXS\fP port should produce a detectable echo signal. .\" This one doesn't seem to do much right now, so don't document that it does .\" do something that it doesn't actually do. People will just try to do it .\" then complain that they can't. IIB. .\".TP .\".BR \-l " logfile secs" .\"Will log tone detector parameters to a file for the specified number of seconds. .TP .BR \-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. .SS Environment options To run \fBtonedebug\fP using the settings specified with the \fBVPB_TONE\fP environment variables, call it with the \fB\-e\fP 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. .SS Continuous tone options If passed the \fB\-c\fP option, then the \fBtonedebug\fP 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: .TP .BR \-c " center-freq bandwidth duration" Specifies the primary tone characteristics, its frequency and bandwidth in Hz. and its minimum duration in milliseconds. .TP .BR \-d " center-freq2 bandwidth2" Specifies the second tone of a multi-frequency tone. .TP .BR \-q " twist" Specifies the twist of a multi-frequency tone. .TP .BR \-n " snr" Specifies the acceptable signal to noise ratio, in dB. .TP .BR \-t " dial | busy | ringback" Specifies the name of a predefined tone to replace with the given settings. .SS Pulsed tone options The \fB\-p\fP 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: .TP .BR \-p " center-freq bandwidth on-time" Specifies the primary tone characteristics, its frequency and bandwidth in Hz. and its 'on' time in milliseconds. .TP .B \-off " off-time" The 'off' time of the pulse in milliseconds. .SH SEE ALSO .BR tonetrain (1) .SH 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. .SH AUTHOR Ron Lee, David Rowe, Voicetronix .PP This manual page was written by Ron , for the Debian project (but may be used by others).