Specifications
Chapter 16 – Audio Commands
Multi-Tech Systems, Inc. AT Commands for EDGE (E1) Modems (S000474A) 266
16.11 AT^SNFG Generate Tone
Description: The AT^SNFG write command generates a 'local tone' via the selected audio output device.
Beside the duration up to 3 combinations of frequency and amplitude can be used to compose a
local tone.
Syntax: Test Command: AT^SNFG=?
Response: ^SNFG:(list of supported <duration>s), (list of supported <frequency>s), (list of
supported <amplitude>s)[, ...]
OK
Write Command: AT^SNFG=<duration>, <frequency>, <amplitude>[, <frequency>,
<amplitude>[, <frequency>, <amplitude>]]
Response: OK
ERROR
+CME ERROR: <err>
Parameters:
<duration>
in Milliseconds.
0...65535
0 Mutes the currently played tone immediately.
65535 Activates a tone with infinit duration.
<frequency>
in Hertz
200...3400
To be input in 1 Hz steps. Audible bandwidth is limited due to the voice band filters.
<amplitude>
of the tone generator belonging to a frequency.
0...100
The output level at the speaker is dependent of the <outBbcGain> value (see AT^SNFO).
If more than one tone should be played, each amplitude level will be divided by the number of running tones to
avoid overdriving of the internal amplifier. For example, if three tones with amplitude of 30 units should be
generated each amplitude is reduced to 10. Setting of amplitude to 100 corresponds with using of current
<outBbcGain> value (see AT^SNFO), 0 is mute.
Notes:
• Response of the command is always "OK" as long as the input parameters are valid.
• If more than one pair of <frequency> and <amplitude> is used then the amplitude for each frequency is devided
by the number of pairs.
• Tone priorities
Ring tones (incoming call/short message), Supervisory tones,Call Progress tones, Battery tones, RTC tones
and DTMF tones always have higher priority than a local tone. This means a local tone will be played only if
no module tone with a higher priority is being played. A local tone will be stopped and ended when a tone or
melody from the module starts to play.
• To suspend a local tone from playing use "AT^SNFG=0".
• Switching the tone generator on and off will trigger AT+CIND indicator "sounder" depending on current
AT+CMER settings.
• If there is a voice call active then the local tone is mixed into the voice signal. In case of a multi party call the
local tones are not available.
• This command is not PIN protected.
• This command is supported in airplane mode.