Tone detector - Revision history

Monica: /* Message examples */

2013-11-04T11:22:50Z

‎Message examples

Dana: /* Message examples */

2012-11-19T09:50:39Z

‎Message examples

Dana: /* Common parameters */

2012-10-19T14:02:00Z

‎Common parameters

Dana: /* Tone detector resource format */

2012-10-19T14:01:27Z

‎Tone detector resource format

Dana at 14:00, 19 October 2012

2012-10-19T14:00:26Z

Dana at 13:57, 19 October 2012

2012-10-19T13:57:52Z

Dana: Created page with " This helper module provides inband detection of '''DTMF''', '''DNIS''', '''Fax''' and '''Continuity''' tones. The audio signal must be perfect quality (no codecs in the data ..."

2012-10-19T13:52:16Z

Created page with " This helper module provides inband detection of '''DTMF''', '''DNIS''', '''Fax''' and '''Continuity''' tones. The audio signal must be perfect quality (no codecs in the data ..."

New page

This helper module provides inband detection of '''DTMF''', '''DNIS''', '''Fax''' and '''Continuity''' tones. The audio signal must be perfect quality (no codecs in the data path) which normally means that only uncompressed ''slin'' and G.711 (''alaw'' or ''mulaw'') will work.

The module creates and attaches data consumers by handling the [[chan.attach]] and [[chan.record]] messages.

When a [http://www.wikipedia.org/wiki/DTMF DTMF] is detected the module masquerades a [[chandtmf|chan.dtmf]] as the channel to which it is attached. On detection of a continuity tone a DTMF with the text '''O''' is masqueraded.

When a [http://en.wikipedia.org/wiki/DNIS DNIS] is detected the module masquerades a [[chan.notify]] as the channel to which it is attached.

When a Fax CNG (or, as an option, CED) tone is detected the module can either masquerade a [[call.fax]] message or directly divert the call to another target by masquerading a [[call.execute]] to a specified target.

=== Tone detector resource format===

The general format is '''tone/[channel/]mode''' where:
:channel:channel side to detect, can be ''left'', ''right'', ''mixed'' or ''mono'' (default)
:mode:what to detect, can be ''*'' or a comma separated list of ''dtmf'', ''fax'', ''rfax'', ''cotv'', ''cots'' and ''callsetup''
** dmtf - detect DTMFs
** fax - detect Fax CNG
** rfax - detect Fax CED (reverse direction, exclusive with ''fax'')
** cotv - detect Continuity Verify
** cots - detect Continuity Send (exclusive with ''cotv'')
** callsetup - detect DNIS during call setup, used in E&M signaling
A single ''*'' is equivalent to ''dtmf,fax''

=== Parameters for chan.attach ===

;consumer
:specify a tone detect resource if the detector must attach as the consumer
;sniffer
:specify a tone detect resource if the detector must attach as a sniffer

===Parameters for chan.record===

;call
:must specify a tone detect resource
;id
:optional, apparent ID of the channel if attaching to a DataEndpoint

=== Common parameters===

;notify
:optional target for [[channotify|chan.notify]] when a DNIS is detected
;fax_divert
:optional target for automatic divert of a Fax
;caller
:caller party number to masquerade when diverting a Fax
;called
:called party number to masquerade when diverting a Fax

=== Message examples===

'''chan.attach'''
sniffer=tone/*
fax_divert=fax/receive/test.tiff
caller=12345
called=67890

'''chan.record'''
call=tone/left/dtmf,fax,cotv
notify=dialer/115

@@ Line 64: / Line 64: @@
 '''See also'''
-*[[chan.attach]]
+* [[chan.attach]]
 * [[chan.record]]

← Older revision		Revision as of 09:50, 19 November 2012
Line 61:		Line 61:
	call=tone/left/dtmf,fax,cotv		call=tone/left/dtmf,fax,cotv
	notify=dialer/115		notify=dialer/115
		+
		+
		+	'''See also'''
		+	*[[chan.attach]]
		+	* [[chan.record]]

@@ Line 42: / Line 42: @@
 ;notify
-:optional target for [[channotify|chan.notify]] when a DNIS is detected
+:optional target for [[chan.notify]] when a DNIS is detected
 ;fax_divert
 :optional target for automatic divert of a Fax

@@ Line 13: / Line 13: @@
 The general format is '''tone/[channel/]mode''' where:
-:channel:channel side to detect, can be ''left'', ''right'', ''mixed'' or ''mono'' (default)
+;channel
-:mode:what to detect, can be ''*'' or a comma separated list of ''dtmf'', ''fax'', ''rfax'', ''cotv'', ''cots'' and ''callsetup''
+:channel side to detect, can be ''left'', ''right'', ''mixed'' or ''mono'' (default)
-** dmtf - detect DTMFs
+;mode
-** fax - detect Fax CNG
+:what to detect, can be ''*'' or a comma separated list of ''dtmf'', ''fax'', ''rfax'', ''cotv'', ''cots'' and ''callsetup''
-** rfax - detect Fax CED (reverse direction, exclusive with ''fax'')
+:* dmtf - detect DTMFs
-** cotv - detect Continuity Verify
+:* fax - detect Fax CNG
-** cots - detect Continuity Send (exclusive with ''cotv'')
+:* rfax - detect Fax CED (reverse direction, exclusive with ''fax'')
-** callsetup - detect DNIS during call setup, used in E&M signaling
+:* cotv - detect Continuity Verify
 A single ''*'' is equivalent to ''dtmf,fax''

@@ Line 8: / Line 8: @@
 When a [http://en.wikipedia.org/wiki/DNIS DNIS] is detected the module masquerades a [[chan.notify]] as the channel to which it is attached.
-When a Fax CNG (or, as an option, CED) tone is detected the module can either masquerade a [[call.fax]] message or directly divert the call to another target by masquerading a [[call.execute]] to a specified target.
+When a Fax CNG (or, as an option, CED) tone is detected the module can either masquerade a call.fax message or directly divert the call to another target by masquerading a [[call.execute]] to a specified target.
 === Tone detector resource format===

@@ Line 4: / Line 4: @@
 The module creates and attaches data consumers by handling the [[chan.attach]] and [[chan.record]] messages.
-When a [http://www.wikipedia.org/wiki/DTMF DTMF] is detected the module masquerades a [[chandtmf|chan.dtmf]] as the channel to which it is attached. On detection of a continuity tone a DTMF with the text '''O''' is masqueraded.
+When a [http://www.wikipedia.org/wiki/DTMF DTMF] is detected the module masquerades a [[chan.dtmf]] as the channel to which it is attached. On detection of a continuity tone a DTMF with the text '''O''' is masqueraded.
 When a [http://en.wikipedia.org/wiki/DNIS DNIS] is detected the module masquerades a [[chan.notify]] as the channel to which it is attached.