YEALINK NETWORK TECHNOLOGY CO.,LTD.

www.yealink.com

DTMF issue

 Feature mechanism:
A． What’s DTMF?
DTMF (Dual Tone Multi-frequency) are signals/tones that are sent when you press a
telephone's touch keys, for details please refer to:
https://en.wikipedia.org/wiki/Dual-tone_multi-frequency_signaling
B． DTMF for VoIP:
Yealink phones support three way to deliver the DTMF tones, they are INBAND, RFC2833 and
SIP INFO:

a) INBAND: With Inband digits are passed along just like the rest of your voice as normal
audio tones with no special coding or markers using the same codec as your voice does
and are generated by your phone.
b) RFC2833: (Preferred setting in most cases) is a standards based way to define signaling
for various events including DTMF tones, fax-related tones and country-specific
subscriber line tones.

1
 YEALINK NETWORK TECHNOLOGY CO.,LTD.
www.yealink.com

Attached the trace for your reference:

RFC2833.pcapng

c) SIP INFO: SIP signaling will negotiate preferences with the other end to help establish
the call's parameters. The choices can then be set for what to send (outbound) and
what want to receive (inbound). Only available with SIP channels and is transmitted
through a SIP message.

Attached is the trace for your reference:

DTMF-SIP INFO.pcapng

C． Parameters related ‘DTMF’ feature:

2
 YEALINK NETWORK TECHNOLOGY CO.,LTD.
www.yealink.com
a) WEB path: Features->General Information->Suppress DTMF Display
Auto provisioning parameter:
features.dtmf.hide =
# It enables or disables the IP phone to suppress the display of DTMF digits during an active call.
0-Disabled
1-Enabled
#Scenario：Sometimes when the DTMF digits are related sensitive information, you wish the phone not to display
the DTMF digits.
b) WEB path：Features->General Information->Suppress DTMF Display Delay
Auto provisioning parameter:
features.dtmf.hide_delay=
# It enables or disables the IP phone to display the DTMF digits for a short period before displaying asterisks
during an active call.
0-Disabled
1-Enabled
Note: It works only if the value of the parameter “features.dtmf.hide” is set to 1 (Enabled).
Scenario: The user can check the input but wish the phone not to display them for security purpose.
c) WEB path：Features->General Information->Play Local DTMF Tone
Auto provisioning parameter:
features.play_local_dtmf_tone_enable=
#It enables or disables the IP phone to play a local DTMF tone.
0-Disabled
1-Enabled
Scenario：The user hope to hear the DTMF tone to make sure the input is successful
d) WEB path：Features->General Information->DTMF Repetition
Auto provisioning parameter:
features.dtmf.repetition=
#It configures the repetition times for the IP phone to send the end RTP Event packet during an active call.
Value：1, 2 or 3
Scenario: Only take effect when the DTMF type is RFC2833. The phone will send 3/2/1 repeated ‘end’ message to
avoid losing end mark by another party.
e) WEB path: Features->General Information->DTMF Replace Tran
Auto provisioning parameter:
features.dtmf.replace_tran=
#It enables or disables the IP phone to send DTMF sequences for transfer function when pressing the
Tran/Transfer soft key or TRAN/TRANSFER key.
0-Disabled
1-Enabled
#If it is set to 0 (Disabled), the IP phone will perform the transfer as normal when pressing the Tran/Transfer soft
key or TRAN/TRANSFER key during a call.
#If it is set to 1 (Enabled), the IP phone will transmit the designated DTMF digits to the server for performing call
transfer when pressing the Tran/Transfer soft key or TRAN/TRANSFER key during a call.
f) WEB path：Features->General Information->Tran Send DTMF
Auto provisioning parameter:

3
 YEALINK NETWORK TECHNOLOGY CO.,LTD.
www.yealink.com
features.dtmf.transfer=
It configures the DTMF digits to be transmitted to perform call transfer. Valid values are: 0-9, *, # and A-D.
Example:
features.dtmf.transfer = 123
#Note: It works only if the value of the parameter “features.dtmf.replace_tran” is set to 1 (Enabled).
Scenario: Some specified server will need this mechanism for transfer
g) No WEB option
Auto provisioning parameter:
features.dtmf.volume=
#It configures the frequency level of DTMF digits (in db).
Integer from -33 to 0 (default value:-10)
h) No WEB option
Auto provisioning parameter:
features.dtmf.duration=
#It configures the duration time (in milliseconds) for DTMF.
Integer from 0 to 300 (default value: 100)
Scenario: Some specified server will require specific DTMF volume duration.

 Issue Description:
A. Need to suppress the DTMF digits because of security
B. DTMF doesn’t take effect sometimes (Like during conference or calling IVR system)

 Resolution: （Checking list）

For issue A, customer can hide the DTMF digits by WEB option:

Or auto provisioning parameter: features.dtmf.hide = 1

For issue B: DTMF doesn’t take effect sometimes
A. First of all, please make sure there is no packet loss in your network. If yes, please correct any
packet loss and test again.
B. Check with server administrator to see if there is any special DTMF volume or duration that is
mandatory. (Yealink default DTMF volume is -10db; default DTMF duration is 100ms). If the
default can’t meet the server, you can change them via auto provisioning parameters:
features.dtmf.volume=
features.dtmf.duration=
C. If the issue still occurred, please kindly confirm and provide below information then submit
to Yealink for further analysis:

4
 YEALINK NETWORK TECHNOLOGY CO.,LTD.
www.yealink.com
a) The detailed steps to reproduce your issue?
b) How often the issue occurred?
c) How many phones you have? And how many phones have this issue?
d) Any other Yealink Models or brand works fine in same scenario?
e) Please kindly provide us Syslog (must be Level6)/ Trace/ config.bin files. (For how to get
these three files, please refer to:
https://support.yealink.com/en/portal/knowledge/show?id=84b84b529641f28b843eb4
45 )
Note: Please make sure the trace are with completed with DTMF message:
RFC2833:

SIP INFO:

Syslog file is in Level6: if it have <6+info> means its Level 6 syslog:

5
 YEALINK NETWORK TECHNOLOGY CO.,LTD.
www.yealink.com

For more information about DTMF, refer to: http://www.voipmechanic.com/dtmf-issues.htm

 Products:
All

 Firmware version:
All