SIP Send DTMFs
(Created page with "This page describes DTMFs send related configuration of sip channel. The parameters involved (located in 'general' section of ysipchan.conf are: * dtmfmethods * honor_dtmf_de...") |
(→missing_allow_info) |
||
(18 intermediate revisions by 2 users not shown) | |||
Line 1: | Line 1: | ||
− | + | In SIP Channel Module are configuration parameters related to DTMFs like dtmfmethods, honor_dtmf_detect, check_allow_info, missing_allow_info. | |
− | + | Below are described the parameters involved, they are located in [general] section of ysipchan.conf. | |
− | + | ||
− | + | ||
− | + | ||
− | + | ||
=== dtmfmethods === | === dtmfmethods === | ||
− | This parameter configures the allowed methods and | + | ''' Description ''' |
+ | |||
+ | This parameter configures the allowed methods and their order. | ||
+ | |||
Allowed methods are: | 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. | * '''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. | ||
Line 16: | Line 15: | ||
The default value of this parameter is 'rfc2833,info,inband'.<br> | The default value of this parameter is 'rfc2833,info,inband'.<br> | ||
− | This parameter is | + | This parameter is applied on reload for new calls.<br> |
− | Invalid values will be ignored. E.g.<br> | + | |
− | '''foo,info''' will be handled as '''info'''<br> | + | '''Example''' |
− | '''foo,info,foo2,inband''' will be handled as '''info,inband'''<br> | + | |
− | '''foo,foo2''' will be handled as default '''rfc2833,info,inband''' | + | Invalid values will be ignored. |
+ | E.g.<br> | ||
+ | '''foo,info''' will be handled as '''info'''<br> | ||
+ | '''foo,info,foo2,inband''' will be handled as '''info,inband'''<br> | ||
+ | '''foo,foo2''' will be handled as default '''rfc2833,info,inband''' | ||
+ | |||
+ | '''How to override''' | ||
This parameter can be overridden when routing by an '''odtmfmethods''' parameter for outgoing calls and '''idtmfmethods''' parameter for incoming calls.<br> | This parameter can be overridden when routing by an '''odtmfmethods''' parameter for outgoing calls and '''idtmfmethods''' parameter for incoming calls.<br> | ||
Line 26: | Line 31: | ||
===honor_dtmf_detect=== | ===honor_dtmf_detect=== | ||
+ | |||
+ | ''' Description ''' | ||
This parameter instructs the sip channel to use the detected method when sending DTMFs.<br> | This parameter instructs the sip channel to use the detected method when sending DTMFs.<br> | ||
The detected method won't be used if not enabled.<br> | The detected method won't be used if not enabled.<br> | ||
This parameter is enabled by default and can be changed at runtime for new calls only.<br> | This parameter is enabled by default and can be changed at runtime for new calls only.<br> | ||
+ | |||
+ | '''How to override''' | ||
+ | |||
This parameter can be overridden when routing by an '''ohonor_dtmf_detect''' parameter for outgoing calls and '''ihonor_dtmf_detect''' parameter for incoming calls.<br> | This parameter can be overridden when routing by an '''ohonor_dtmf_detect''' parameter for outgoing calls and '''ihonor_dtmf_detect''' parameter for incoming calls.<br> | ||
− | It can be overridden in chan.dtmf messages by a parameter with the same name. | + | It can be overridden in [[chan.dtmf]] messages by a parameter with the same name. |
=== check_allow_info=== | === check_allow_info=== | ||
+ | |||
+ | ''' Description ''' | ||
This parameter instructs the sip channel to look at 'Allow' header of INVITE (incoming calls) and OK (outgoing calls) for INFO support.<br> | This parameter instructs the sip channel to look at 'Allow' header of INVITE (incoming calls) and OK (outgoing calls) for INFO support.<br> | ||
Line 39: | Line 51: | ||
This parameter is ignored if '''info''' method is not enabled.<br> | This parameter is ignored if '''info''' method is not enabled.<br> | ||
When enabled the '''info''' method will be disabled if remote party don't advertise INFO support in 'Allow' header.<br> | When enabled the '''info''' method will be disabled if remote party don't advertise INFO support in 'Allow' header.<br> | ||
+ | |||
+ | '''How to override''' | ||
+ | |||
This parameter can be overridden when routing by an '''ocheck_allow_info''' parameter for outgoing calls and '''icheck_allow_info''' parameter for incoming calls.<br> | This parameter can be overridden when routing by an '''ocheck_allow_info''' parameter for outgoing calls and '''icheck_allow_info''' parameter for incoming calls.<br> | ||
=== missing_allow_info=== | === missing_allow_info=== | ||
+ | |||
+ | ''' Description''' | ||
This parameter configures the default value for INFO support if 'Allow' header is missing.<br> | This parameter configures the default value for INFO support if 'Allow' header is missing.<br> | ||
This parameter is ignored if 'check_allow_info' is disabled.<br> | This parameter is ignored if 'check_allow_info' is disabled.<br> | ||
It is enabled by default and can be changed at runtime.<br> | It is enabled by default and can be changed at runtime.<br> | ||
− | This parameter can be overridden when routing by an '''omissing_allow_info''' parameter for outgoing calls and '''imissing_allow_info''' parameter for incoming calls. | + | |
+ | '''How to override''' | ||
+ | |||
+ | This parameter can be overridden when routing by an '''omissing_allow_info''' parameter for outgoing calls and '''imissing_allow_info''' parameter for incoming calls. | ||
+ | |||
+ | |||
+ | '''See also''' | ||
+ | |||
+ | * [[SIP in Yate]] | ||
+ | * [[SIP Configuration File]] | ||
+ | * [[chan.dtmf]] | ||
+ | * [[Telephony]] | ||
+ | |||
+ | [[Category:SIP]] [[Category:DTMF]] |
Latest revision as of 10:59, 4 November 2013
In SIP Channel Module are configuration parameters related to DTMFs like dtmfmethods, honor_dtmf_detect, check_allow_info, missing_allow_info.
Below are described the parameters involved, they are located in [general] section of ysipchan.conf.
Contents |
[edit] dtmfmethods
Description
This parameter configures the allowed methods and their order.
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 applied on reload for new calls.
Example
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
How to override
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.
[edit] honor_dtmf_detect
Description
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.
How to override
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.
[edit] check_allow_info
Description
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.
How to override
This parameter can be overridden when routing by an ocheck_allow_info parameter for outgoing calls and icheck_allow_info parameter for incoming calls.
[edit] missing_allow_info
Description
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.
How to override
This parameter can be overridden when routing by an omissing_allow_info parameter for outgoing calls and imissing_allow_info parameter for incoming calls.
See also