You are here: CSP Developer’s Guide: Overview > 9 Configuring The DSP-ONE Card > Energy Detection
Energy On Channel
The Energy Detection feature detects energy on a channel. You can use this feature for CPA or to report energy detection to the host application. To compensate for background noise and to filter out short energy bursts, the host application can set the sensitivity level and the scan duration (defined below). You can determine these settings based upon the type of energy to be detected, and to some extent, by trial and error. After setting both levels, test to see if the desired energy is being detected, then adjust the settings as necessary.
For CPA, the Energy Detection feature determines only that a pattern has occurred. It does not distinguish tones. The Energy Detection class (Class 3) is composed of the most common call setup tones: Ringback, Double Ringback, Busy, and Reorder. You can add any pattern to this class, or use any other class for Energy Detection, with the following restrictions:
• The pattern must consist of alternating periods of tones and silence. Energy Detection recognizes a pattern by periods with energy (tone) and no energy (silence). Because Energy Detection must detect both tone and silence, it cannot detect a "pattern" that has tone but no silent interval.
• The Energy Detection DSP function can detect only tones from the default patterns defined for the Energy Detection class (Tone IDs 0, 1, 2, and 5). You can still use a pattern for Energy Detection that does not use one of these tones. To do so, you must change the Tone IDs in the pattern to one of those allowed, using the CPA Pattern Configure message.
To use the Energy Detection feature, you must configure at least one DSP chip for Energy Detection, with the DSP SIMM Configure message.
Configurable Parameters
Use the following parameters to modify energy detection:
• Sensitivity Level: the amplitude above which the energy detector perceives a signal. Set the sensitivity level to detect and report energy that is greater than the prevailing background noise. When you expect a significant background noise, use the least sensitive setting (0 dBm). When you expect little background noise, use the most sensitive setting (-30 dBm).
• Scan Duration: the repeating time interval over which the energy detector determines that energy is either Present or Not Present.
Set the scan duration to be longer than expected energy bursts. You must use 20 millisecond intervals to set the scan duration, so energy is sampled for each 20 millisecond block within the specified duration.
The scan cycles repeat until the completion timer expires. The calculated energy level is the average over all blocks, as shown in Scan Cycle. If the calculated energy level exceeds the configured sensitivity level, energy is reported.
• Completion Timer
The completion timer determines the maximum amount of time to scan for energy. Each scan cycle, as defined by the scan duration, is repeated until either energy is detected, or the completion timer expires. We recommend setting the completion timer for 3 to 4 times the scan duration, depending on the application. If the timer expires before energy is detected, the host receives a Call Processing Event message of "No Energy Detected."
Detection Methods
You can invoke Energy Detection in the following two ways:
• Interactively, with the DSP Service Request message
• As a part of Call Progress Analysis
Interactive Energy Detection
You can invoke Energy Detection interactively, with the DSP Service Request message. Use the data bytes of the message to configure the sensitivity level, reporting mode, scan duration, and completion timer. The detected energy is reported to the host in a Call Processing Event message in one of two modes: Report Initial Energy Detection Only, or Report All Energy Threshold Crossings.
• Report Initial Energy Detection Only
The host receives a Call Processing Event of "Energy Result Report" with Data[0], indicating Energy Detected. Data[1] indicates the duration of the period of no energy. The DSP resource is then automatically released.
• Report All Energy Threshold Crossings
All of the following are reported: the initial energy detection, all subsequent changes, and the duration of the previous state’s ON or OFF interval.
When energy (A) is first detected, the host receives a Call Processing Event of "Energy Result Report" with Data[0] indicating "Energy Detected." Data[1] indicates the duration of the preceding period of no energy (D1).
When energy is no longer detected (B), the host receives a Call Processing Event message of "Energy Result Report" with Data[0] indicating "No Energy Detected." Data[1] indicates the duration of the preceding period of energy (D2).
Figure 9-7 Energy Result Report
The DSP resource remains attached and reports energy changes until the completion timer expires, or until the host sends a DSP Service Cancel 0x00BE message, or until the channel returns to an idle state.
Energy Detection as Call Progress Analysis
Energy Detection allows the Excel platform to perform Call Progress Analysis for frequencies not supported by the default CPA DSP load. The Energy Detection DSP function matches cadences, based on the reported energy levels. CPA Class 3 is preconfigured for Energy Detection, using the standard CPA tones of ringback, double ringback, busy, and re-order.
To accommodate unique requirements for matching cadences, you can modify these patterns or add new patterns to the class. The host can change the pattern cadence that energy detection scans for, using the CPA Pattern Configure message.
Changing Mode Parameters
You can also configure the other CPA classes for Energy Detection by changing the mode parameter in the CPA Class Configure message, as shown in Changing mode parameters.
Table 9-24 Changing mode parameters
Message Field |
Values |
---|---|
CLASS ID |
Class to be changed |
ACTION |
0x03 (Change Class Parameter) |
DATA[0] Parameter |
0x01 (Mode) |
DATA[1] Reserved |
0x00 |
DATA[2] Mode |
0x02 (Energy Detection enabled) |
Specifying Sensitivy Level
The sensitivity level and scan duration are specified in the "Mode Specific Data" of the CPA Class Configure message, as shown in Sensitivity Level Fieldsl and Scan Duration Fields.
Table 9-25 Sensitivity Level Fieldsl
Message Field |
Values |
---|---|
Class ID |
Class to be changed |
Action |
0x03 (Change Class Parameter) |
Data[0] Parameter |
0x0B (Mode Specific 1) |
Data[1] Reserved |
0x00 |
Data[2] Sensitivity Level |
0x00 = 0 dBm 0x01 = -5 dBm 0x02 = -10 dBm 0x03 = -15 dBm 0x04 = -20 dBm 0x05 = -25 dBm 0x06 = -30 dBm |
Specifying Scan Duration
Table 9-26 Scan Duration Fields
Message Field |
Values |
---|---|
Class ID |
Class to be changed |
Action |
0x03 (Change Class Parameter) |
Data[0] Parameter |
0x0C (Mode Specific 2) |
Data[1,2] Scan Duration |
16-bit word defining the scan duration, in 10ms units |