SIP Send DTMFs

Revision as of 14:01, 6 November 2012

This page describes DTMFs send related configuration of SIP channel.

The parameters involved (located in 'general' section of ysipchan.conf) are:

• dtmfmethods
• honor_dtmf_detect
• check_allow_info
• missing_allow_info

dtmfmethods

This parameter configures the allowed methods and the order they are tried. Allowed methods are:

• rfc2833 Send DTMFs as RFC2833 RTP signals. This method will be used if media is started and remote party advertised telephone event support in SDP.
• info Send DTMFs using SIP INFO method.
• inband Send DTMFs in audio stream. This method will succeed if media is started, the tone generator module is loaded and there is a translator from PCM (yate 'slin' format) to current rtp format.

The default value of this parameter is 'rfc2833,info,inband'.
This parameter is apllied on reload for new calls.
Invalid values will be ignored. E.g.
foo,info will be handled as info
foo,info,foo2,inband will be handled as info,inband
foo,foo2 will be handled as default rfc2833,info,inband

This parameter can be overridden when routing by an odtmfmethods parameter for outgoing calls and idtmfmethods parameter for incoming calls.
Also, it can be overridden when sending DTMFs (chan.dtmf messages) by a methods parameter.

honor_dtmf_detect

This parameter instructs the sip channel to use the detected method when sending DTMFs.
The detected method won't be used if not enabled.
This parameter is enabled by default and can be changed at runtime for new calls only.
This parameter can be overridden when routing by an ohonor_dtmf_detect parameter for outgoing calls and ihonor_dtmf_detect parameter for incoming calls.
It can be overridden in chan.dtmf messages by a parameter with the same name.

check_allow_info

This parameter instructs the sip channel to look at 'Allow' header of INVITE (incoming calls) and OK (outgoing calls) for INFO support.
It is enabled by default and can be changed at runtime.
This parameter is ignored if info method is not enabled.
When enabled the info method will be disabled if remote party don't advertise INFO support in 'Allow' header.
This parameter can be overridden when routing by an ocheck_allow_info parameter for outgoing calls and icheck_allow_info parameter for incoming calls.

missing_allow_info

This parameter configures the default value for INFO support if 'Allow' header is missing.
This parameter is ignored if 'check_allow_info' is disabled.
It is enabled by default and can be changed at runtime.
This parameter can be overridden when routing by an omissing_allow_info parameter for outgoing calls and imissing_allow_info parameter for incoming calls.