6.3.  TN_AMP: Tone Amplitude

The TN_AMP structure is declared as follows:

typedef  struct  {

   short int  tn_fq1_minamp;         /* 1st tone min. amplitude (dB) */

   short int  tn_fq1_maxamp;         /* 1st tone max. amplitude (dB) */

   short int  tn_fq2_minamp;         /* 2nd tone min. amplitude (dB) */

   short int  tn_fq2_maxamp;         /* 2nd tone max. amplitude (dB) */

} TN_AMP;

The TN_AMP structure specifies tone amplitude boundaries. It is used by learn mode for input to the lm_LearnTone( ) function to restrict the learning to a specified amplitude range. For example, you can set the amplitude range lower to learn a poor-quality tone, although noise may interfere with the results, or you can set the amplitude range higher to detect a high-quality tone.

When setting the amplitude range for a dual tone, it is typical to use the same amplitude range for both frequencies.

NOTE:

Set any field to 0 to use the default value.

Use the lm_clramp( ) function to clear the fields of a TN_AMP structure.

Table 2.  TN_AMP Structure

Field	Description
tn_fq1_minamp	Length: 2 (short int) Default: -42 Range: -42 dBm to 0 dBm Units: dBm First frequency minimum amplitude. Specifies in dBm the minimum amplitude of the tone with the lower frequency.
	The value 0 sets the amplitude to the default (-42).
tn_fq1_maxamp	Length: 2 (short int) Default: 0 Range: -42 dBm to 0 dBm Units: dBm First frequency maximum amplitude. Specifies in dBm the maximum amplitude of the tone with the lower frequency.
	The value 0 sets the amplitude to the default (-0).
tn_fq2_minamp	Length: 2 (short int) Default: -42 Range: -42 dBm to 0 dBm Units: dBm Second frequency minimum amplitude. Specifies in dBm the minimum amplitude of the tone with the higher frequency.
	The value 0 sets the amplitude to the default (-42).
tn_fq2_maxamp	Length: 2 (short int) Default: 0 Range: -42 dBm to 0 dBm Units: dBm Second frequency maximum amplitude. Specifies in dBm the maximum amplitude of the tone with the higher frequency.
	The value 0 sets the amplitude to the default (-0).

Click here to contact Telecom Support Resources