5.11. ToneParm

When using DM3 boards, the ToneParm data structure is not supported.

When using Springware boards, the ToneParm data structure is used to redefine a firmware-applied tone's attributes using the cc_ToneRedefine( ) function or to play a user-defined tone using the cc_PlayTone( ) function.

Note: Global Call does not provide functions for tone management. The ISDN call control library functions cc_ToneRedefine( ), cc_PlayTone( ), and cc_StopTone( ) are appropriate in this context. However, the use of the ISDN call control library is not officially supported and the ISDN Software Reference, in which these functions are documented, may not be included in the documentation for future system releases.

The data structure is defined as follows:

Struct toneParm
{
    uint16    duration;    //1 ~ 65535 (in 10 ms, 0xffff - forever)  
    uint16    freq1;       //200 ~ 3100 Hz
    int16     amp1;        //-40 ~ +3 dB
    uint16    freq2;       //200 ~ 3100 Hz
    int16     amp2;        //-40 ~ +3 dB
    uint16    toneOn1;     //1 ~ 65535 (in 10 ms)
    uint16    toneOff1;    //0 ~ 65534 (in 10 ms)
    uint16    reserv1;     //reserved for future use
    uint16    reserv2;     //reserved for future use
} 

Table 52. ToneParm Field Descriptions 

Field	Description
duration	Specifies the duration of the tone in 10 ms units. The range is 1 - 65535. Set to -1 to play forever.
freq1	Specifies the frequency of the tone. The range is 200 - 3100 Hz.
amp1	Specifies the amplitude of the tone. The range is -40 - +3 dB.
freq2	Specifies the frequency of the tone. The range is 200-3100 Hz.
amp2	Specifies the amplitude of the tone. The range is -40 - +3 dB.
toneOn1	Specifies the tone interval, in 10 ms units. The range is 1 - 65535 ms. Set to 1 or greater for continuous tone.
toneOff1	Specifies the tone interval, in 10 ms units. The range is 0 - 65534 ms. Set to 0 to play a continuous tone.
reserv1	Reserved for future use
reserv2	Reserved for future use

Click here to contact Telecom Support Resources