> 18.11 | AT^SNFG Generate Tone

> 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(s)
> ^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(s)
> OK
> ERROR

> Reference(s) |  | PIN |  | ASC0 | ASC1 | USB | MUX1 | MUX2 | MUX3 |  |  | Charge | Q | Last
> SIEMENS |  | - |  | + | + | + | + | + | + |  |  | - | + | -

> Parameter Description

> <duration>(num)

> in Milliseconds.
> 0...65535
> 0
> Mutes the currently played tone immediately.
> 65535
> Activates a tone with infinit duration.

> <frequency>(num)

> in Hertz
> 200...3400
> to be input in 1 Hz steps. Audible bandwidth is limited due to the voice band filters.

> <amplitude>(num)

> 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.