Quectel Cellular Engine

GSM DTMF
AT Commands
GSM_DTMF_ATC_DRAFT

GSM_DTMF_ATC_DRAFT

-1-

GSM_DTMF_ATC_DRAFT

Document Title

GSM DTMF AT Commands

Version

1.0

Date
Status

Draft

Document Control ID

GSM_DTMF_ATC_DRAFT

General Notes
Quectel offers this information as a service to its customers, to support application and
engineering efforts that use the products designed by Quectel. The information provided is
based upon requirements specifically provided to Quectel by the customers. Quectel has not
undertaken any independent search for additional relevant information, including any
information that may be in the customers possession. Furthermore, system validation of this
product designed by Quectel within a larger electronic system remains the responsibility of
the customer or the customers system integrator. All specifications supplied herein are
subject to change.
Copyright
This document contains proprietary technical information which is the property of Quectel
Limited., copying of this document and giving it to others and the using or communication of
the contents thereof, are forbidden without express authority. Offenders are liable to the
payment of damages. All rights reserved in the event of grant of a patent or the registration of
a utility model or design. All specification supplied herein are subject to change without
notice at any time.
Copyright Shanghai Quectel Wireless Solutions Co., Ltd. 2010

GSM_DTMF_ATC_DRAFT

-1-

GSM_DTMF_ATC_DRAFT

Contents
Contents ............................................................................................................................................ 2
Table Index........................................................................................................................................ 3
1. Revision history ........................................................................................................................ 4
2. Introduction ............................................................................................................................... 5
2.1. Reference ........................................................................................................................... 5
2.2. Terms and abbreviations .................................................................................................... 5
3. AT Commands for local DTMF Service ................................................................................... 6
3.1. Overview of AT Commands for local DTMF Service ....................................................... 6
3.2. Detailed Description of AT Commands for local DTMF Service ...................................... 6
3.2.1.
AT+QTONEDET Detect DTMF...................................................................... 6
3.2.2.
AT+QWDTMF Play DTMF tone to call each other ........................................ 7

-2-

GSM_DTMF_ATC_DRAFT

GSM_DTMF_ATC_DRAFT

Table Index

TABLE 1: REFERENCE .......................................................................................................................... 5

TABLE 2: TERMS AND ABBREVIATIONS.......................................................................................... 5

GSM_DTMF_ATC_DRAFT

-3-

GSM_DTMF_ATC_DRAFT

1. Revision history

Revision
1.00

-4-

Date

Author

Description of change
Initial

GSM_DTMF_ATC_DRAFT

GSM_DTMF_ATC_DRAFT

2. Introduction
Quectel Module provides an internal DTMF generator with decoder that is driven by AT
commands and enables the host application to easily communicate with alarm systems which
works with the Contact ID or similar protocol. This document introduces how to use the
internal DTMF generator and decoder.

2.1. Reference
Table 1: Reference
SN
[1]

Document name
M10_ATC.pdf

Remark
The introduction of AT commands for M10

2.2. Terms and abbreviations

Table 2: Terms and abbreviations
Abbreviation
DTMF

Description
Dual-Tone Multi-Frequency Signal

GSM_DTMF_ATC_DRAFT

-5-

GSM_DTMF_ATC_DRAFT

3. AT Commands for DTMF Service

3.1. Overview of AT Commands for DTMF Service

Command
AT+QTONEDET
AT+QWDTMF

Description
DETECT DTMF
PLAY DTMF TONE TO CALL EACH OTHER

3.2. Detailed Description of AT Commands for DTMF Service

3.2.1. AT+QTONEDET Detect DTMF
AT+QTONEDET Detect DTMF
Test Command
AT+QTONEDET=?

Response
+QTONEDET: (0,1)

Write Command
AT+QTONEDET=<onoff >

OK
Parameter
See Write Command
Response
OK
If error is related to ME functionality:
+CME ERROR: <err>
Open after successful DTMF tone is detected, will be
reported:
+QTONEDET: <dtmfcode>
Parameter
< onoff> open or close the function
0
close the function
1
open the function
<dtmfcode> DTMF tone code corresponding ASSCII
48 DTMF 0
49 DTMF 1
50 DTMF 2
51 DTMF 3
52 DTMF 4
53 DTMF 5
54 DTMF 6
55 DTMF 7
56 DTMF 8
57 DTMF 9
65 DTMF A
66 DTMF B
67 DTMF C
68 DTMF D
42 DTMF *
35 DTMF #
69 frequency of 1400 Hz continued to 400 ms
70 frequency of 1400 Hz continued to 100 ms,
mute 100 ms, and frequency of 2300 Hz
continued to 100 ms

-6-

GSM_DTMF_ATC_DRAFT

GSM_DTMF_ATC_DRAFT

AT+QTONEDET Detect DTMF

Reference

Note:
Available for calling.

3.2.2. AT+QWDTMF Play DTMF tone to call each other

AT+QWDTMF Play DTMF tone to call each other
Test Command
Response
AT+QWDTMF=?
+QWDTMF: <ul_volume>(0-7),<dl_volume>(07),(<dtmfcode>,<continuancetime>,<mutetime>)

Write Command
AT+QWDTMF=<ul_volume>,
<dl_volume>,(<dtmfcode>,<continu
ancetime>,<mutetime>)

OK
Parameter
See Write Command
Response
If format is error, response
+CME ERROR: <err>
If success is related to ME functionality
+QWDTMF: 5
OK
If fail is related to ME functionality
+QWDTMF: <playcode>
OK

If error is related to ME functionality:

+CME ERROR: <err>
Parameter
<ul_volume> Uplink channel of the volume
0 mute, 7 is the maximum
<dl_volume> downlink channel of the volume
0 mute, 7 is the maximum, recommended set to 0
<dtmfcode> Play the DTMF tone strings
'0' DTMF 0
'1' DTMF 1
'2' DTMF 2
'3' DTMF 3
'4' DTMF 4
'5' DTMF 5
'6' DTMF 6
'7' DTMF 7
'8' DTMF 8
'9' DTMF 9
'A' DTMF A
'B' DTMF B
'C' DTMF C
'D' DTMF D
'*' DTMF *
'#' DTMF #
'G' frequency of 1 kHz
'H' frequency of 1400 Hz
'I' frequency of 2300 Hz
<continuancetime> Play the DTMF tone time
Units are ms
GSM_DTMF_ATC_DRAFT

-7-

GSM_DTMF_ATC_DRAFT

AT+QWDTMF Play DTMF tone to call each other

<mutetime> Mute time
Units are ms
<playcode> Play success tips
If not equal to 5, that player fails
Reference
Note:
Example
AT+QWDTMF=7,7,0,50,50,A,55,50,H,100,50
Express DTMF 0 Play 50 ms, mute for 50 ms, DTMF
A play 55 ms, mute for 50 ms, frequency of 1400 Hz
play 100 ms, mute for 50 ms

-8-

GSM_DTMF_ATC_DRAFT

GSM_DTMF_ATC_DRAFT

Shanghai Quectel Wireless Solutions Co., Ltd.

Room 501, Building 9, No. 99 Tianzhou Road, Xuhui District, Shanghai, China 200233
Tel: +86 21 5108 2965
Mail: info@quectel.com

-2-

GSM_DTMF_ATC_DRAFT