16.16. Custom tones

The configuration also allows customised tones to be generated. You can replace these with your own versions.

The format for a tone is either a single tone or a series of duration@tone sections. In a sequence you can use duration for a period of silence. A duration is a number and then ms and a tone is a frequency or frequency+frequency for mixing two tones. Each frequency is a number of Hz and can have a volume suffix which is - and a number if dB. The tone can be followed by ^ if you want it to be shaped (rise at start and fall at end).

Whilst internally only the basic tones for silence, progress, ring, queue, hold, wait, you can configure the use of tones for various cases when no audio is present and calling a specific carrier.

Table 16.4. Default tones

TonePlan
silence100ms
progress1000ms 1000ms@400Hz-3dB+450Hz-3dB 1000ms
ring1000ms 400ms@400Hz-3dB+450Hz-3dB 200ms 400ms@400Hz-3dB+450Hz-3dB 1000ms
queue700ms 400ms@400Hz-3dB+450Hz-3dB 200ms 400ms@400Hz-3dB+450Hz-3dB 200ms 400ms@400Hz-3dB+450Hz-3dB 700ms
busy375ms@400Hz 375ms
hold100ms@400Hz-3dB+450Hz-3dB 200ms 100ms@400Hz-3dB+450Hz-3dB 2600ms
wait2600ms 100ms@400Hz-3dB+450Hz-3dB 200ms 100ms@400Hz-3dB+450Hz-3dB
close-encounter1000ms 300ms@588Hz^ 300ms@654Hz^ 400ms@524Hz^ 600ms@262Hz^ 1000ms@392Hz^ 1000ms
bbc50ms 345ms@122Hz 35ms 300ms@525Hz 2000ms
1000Hz1000Hz
1000Hz1000Hz
beep200ms 200ms@800Hz 200ms
pi350Hz-3dB+440Hz-3dB
spi750ms@350Hz-3dB+440Hz-3dB 750ms@440Hz-3dB
pet400ms@400Hz-6dB 350ms 225ms@400Hz 525ms
sct200ms@400Hz 300ms@1004Hz
cnai100ms@400Hz
sit330ms@950Hz 5ms 330ms@1400Hz 5ms 330ms@1800Hz
cwi100ms@400Hz 5000ms
scwi30ms@400Hz 10ms 30ms@400Hz 6000ms
pt125ms@400Hz 125ms
ct20000ms@1400Hz
st200ms@400Hz 400ms 2000ms@400Hz 400ms

Tip

Accessing a url on the FireBrick of /voip/ring.wav serves a WAV format of the tone. You can test tones using a URL like /voip/tone.wav?100ms@1000Hz+200ms@2000Hz but ensure you URL escape the query string.