Distinctive Ringing

Distinctive Ringing is applicable only to FXS interfaces. Using the Distinctive Ringing section of the Call Progress Tones Auxiliary file, you can create up to 16 Distinctive Ringing patterns. Each ringing pattern configures the ringing tone frequency and up to four ringing cadences. The same ringing frequency is used for all the ringing pattern cadences. The ringing frequency can be configured in the range of 10 to 200 Hz with a 5 Hz resolution.

Each of the ringing pattern cadences is specified by the following parameters:

■

Burst Ring On Time: Configures the cadence to be a burst cadence in the entire ringing pattern. The burst relates to On time and the Off time of the same cadence. It must appear between 'First/Second/Third/Fourth' string and the 'Ring On/Off Time' This cadence rings once during the ringing pattern. Otherwise, the cadence is interpreted as cyclic: it repeats for every ringing cycle.

■

Ring On Time: Specifies the duration of the ringing signal.

■

Ring Off Time: Specifies the silence period of the cadence.

The Distinctive Ringing section of the ini file format contains the following strings:

■

[NUMBER OF DISTINCTIVE RINGING PATTERNS]: Contains the following key:

●

'Number of Distinctive Ringing Patterns' defining the number of Distinctive Ringing signals that are defined in the file.

■

[Ringing Pattern #X]: Contains the Xth ringing pattern definition (starting from 0 and not exceeding the number of Distinctive Ringing patterns defined in the first section minus 1) using the following keys:

●

Ring Type: Must be equal to the Ringing Pattern number.

●

Freq [Hz]: Frequency in hertz of the ringing tone.

●

First (Burst) Ring On Time [10 msec]: 'Ring On' period (in 10 msec units) for the first cadence on-off cycle.

●

First (Burst) Ring Off Time [10 msec]: 'Ring Off' period (in 10 msec units) for the first cadence on-off cycle.

●

Second (Burst) Ring On Time [10 msec]: 'Ring On' period (in 10 msec units) for the second cadence on-off cycle.

●

Second (Burst) Ring Off Time [10 msec]: 'Ring Off' period (in 10 msec units) for the second cadence on-off cycle.

●

Third (Burst) Ring On Time [10 msec]: 'Ring On' period (in 10 msec units) for the third cadence on-off cycle.

●

Third (Burst) Ring Off Time [10 msec]: 'Ring Off' period (in 10 msec units) for the third cadence on-off cycle.

●

Fourth (Burst) Ring On Time [10 msec]: 'Ring Off' period (in 10 msec units) for the fourth cadence on-off cycle.

●

Fourth (Burst) Ring Off Time [10 msec]: 'Ring Off' period (in 10 msec units) for the fourth cadence on-off cycle.

An example of a ringing burst definition is shown below:

#Three ringing bursts followed by repeated ringing of 1 sec on and 3 sec off.
[NUMBER OF DISTINCTIVE RINGING PATTERNS]
Number of Ringing Patterns=1

[Ringing Pattern #0]
Ring Type=0
Freq [Hz]=25
First Burst Ring On Time [10msec]=30
First Burst Ring Off Time [10msec]=30
Second Burst Ring On Time [10msec]=30
Second Burst Ring Off Time [10msec]=30
Third Burst Ring On Time [10msec]=30
Third Burst Ring Off Time [10msec]=30
Fourth Ring On Time [10msec]=100
Fourth Ring Off Time [10msec]=300

An example of various ringing signals definition is shown below:

[NUMBER OF DISTINCTIVE RINGING PATTERNS]
Number of Ringing Patterns=3

#Regular North American Ringing Pattern
[Ringing Pattern #0]
Ring Type=0
Freq [Hz]=20
First Ring On Time [10msec]=200
First Ring Off Time [10msec]=400

#GR-506-CORE Ringing Pattern 1
[Ringing Pattern #1]
Ring Type=1
Freq [Hz]=20
First Ring On Time [10msec]=200
First Ring Off Time [10msec]=400

#GR-506-CORE Ringing Pattern 2
[Ringing Pattern #2]
Ring Type=2
Freq [Hz]=20
First Ring On Time [10msec]=80
First Ring Off Time [10msec]=40
Second Ring On Time [10msec]=80
Second Ring Off Time [10msec]=400