You are here: CSP API Reference > 1 EXS & SwitchKit API Messages > Call Progress Analysis Class Configure 0x00B3
Call Progress Analysis Class Configure 0x00B3
SwitchKit Name
CPAClassConfig
Type
EXS API and SwitchKit API message
Description
Use this message to add a pattern, delete a pattern, or to change the parameters of a pattern in a call progress analysis class.
Sent by
Overview of message
The following table provides an overview of this message. The table following it, provides the detail for each byte.
MESSAGE (White) |
RESPONSE (Gray) |
||
Byte |
Field Description |
Byte |
Field Description |
0 |
Frame (0xFE) |
0 |
Frame (0xFE) |
1, 2 |
Length (0xNNNN) |
1, 2 |
Length (0x0007) |
3, 4 |
Message Type (0x00B3) |
3, 4 |
Message Type (0x00B3) |
5 |
Reserved (0x00) |
5 |
Reserved (0x00) |
6 |
Sequence Number |
6 |
Same Sequence Number |
7 |
Logical Node ID |
7 |
Logical Node ID |
8, 9 |
|||
10 |
Checksum |
||
8 |
Update All Flag (see also text below this table) |
||
9 |
Class ID |
||
10 |
Action |
||
11 |
Data[0] |
||
: |
: |
|
|
: |
Data[n] |
||
: |
Checksum |
SwitchKit Code
Configuration
CPAClassConfig (
Node = integer,
UpdateFlag = integer,
Class = integer,
Action = integer,
Data = byte array);
C Structure
typedef struct {
UBYTE UpdateFlag;
UBYTE Class;
UBYTE Action;
UBYTE Data[250];
} XL_CPAClassConfig;
C++ Class
class XLC_CPAClassConfig : public XLC_OutboundMessage {
public:
UBYTE getUpdateFlag() const;
void setUpdateFlag(UBYTE x);
UBYTE getClass() const;
void setClass(UBYTE x);
UBYTE getAction() const;
void setAction(UBYTE x);
const UBYTE *getData() const;
UBYTE *getData();
void setData(UBYTE *x);
};
EXS API Hex Format - Detailed
MESSAGE (White) |
RESPONSE (Gray) |
||
Byte |
Field Description |
Byte |
Field Description |
0 |
Frame (0xFE) |
0 |
Frame (0xFE) |
1 |
Length, MSB Length, LSB (N) |
1 |
Length, MSB (0x00) Length, LSB (0x07) |
2 |
2 |
||
3 |
Message Type, MSB (0x00) Message Type, LSB (0xB3) |
3 |
Message Type, MSB (0x00) Message Type, LSB (0xB3) |
4 |
4 |
||
5 |
Reserved (0x00) |
5 |
Reserved (0x00) |
6 |
Sequence Number |
6 |
Same Sequence Number |
7 |
Logical Node ID |
7 |
Logical Node ID |
8, 9 |
Status MSB, LSB |
||
10 |
Checksum |
||
8 |
Update All Flag (see also text below this table) 0x00 Store new configuration but do not use it. Use if you are sending more configuration messages. Use for a new configuration
0x01 Use new configuration immediately Use in the last configuration message. When the Excel platform detects this value,
This field indicates whether you are going to update all fields with the configuration that you are defining in this and previous messages.
For example, suppose you are updating several characteristics of call progress analysis. |
||
9 |
Class ID This field indicates the class number, which contains the information |
||
10 |
Action 0x01 Add member pattern 0x02 Delete member pattern 0x03 Change class parameter |
||
11 . . . |
Data[0-n] This field or set of fields provides the necessary information to perform the action indicated in the Action field.
0x01 Add Member Pattern
0x02 Delete Member Pattern Data[0] Pattern ID
0x03 Change Class Parameter For parameter definitions, refer to the appropriate Developer’s Guide. Data[0] Parameter 0x01 Mode* 0x02 Start Delay** 0x03 Continuous Silence Timeout** 0x04 Time to Wait for Pattern Confirmation** 0x05 Time to Wait after Confirmation and No Report** 0x06 Minimum Frequency Glitch Time* 0x07 Minimum Silence Glitch Time** 0x08 Maximum On Timer** 0x09 Maximum Off Timer** 0x0A Advanced Answer Detect*** 0x0B Mode Specific 1† 0x0C Mode Specific 2‡ Data[1] Reserved Data[2] Mode This field is a bit mask that defines the mode. Bit 0 Advanced Answer Detect Bit 1 Energy Detection Bits 2–7 Reserved
Data[1] The time in 10-ms units, MSB Data[2] The time in 10-ms units, LSB
Data[1] 0x00 Data[2] Number of Frequency Bursts in 500 ms before answer is declared |
||
|
†If Data[0] is 0x0B, Data[1–2] are as follows: Data[1] 0x00 (Reserved) Data[2] Sensitivity Level (for more information on Energy Detection mode, 0x00 0 dBm 0x01 5 dBm 0x02 10 dBm 0x03 15 dBm 0x04 20 dBm 0x05 25 dBm 0x06 30 dBm
Data[1] Scan Duration in 20-ms increments, MSB Data[2] Scan Duration in 20-ms increments, LSB |
||
: |
Checksum |
Example 1
The table that follows shows a message that changes the number of frequency bursts per 500 ms (before declaring answer) to "5."
MESSAGE |
||
---|---|---|
Byte |
Field |
Field Value |
0 |
Frame |
0xFE |
1 |
Length, MSB |
0x00 |
2 |
Length, LSB |
0x0B |
3 |
Message Type, MSB |
0x00 |
4 |
Message Type, LSB |
0xB3 |
5 |
Reserved |
0x00 |
6 |
Sequence Number |
0x01 |
7 |
Logical Node ID |
0xFF |
8 |
Update All Flag |
0x01 |
9 |
Class ID |
0x00 |
10 |
Action |
0x03 (Change Class Parameter) |
11 |
Data[0] Parameter |
0x0A (Advanced Answer Detect) |
12 |
Data[1] Number of Frequency Bursts, MSB |
0x00 |
13 |
Data[2] Number of Frequency Bursts, LSB |
0x05 (5 bursts per 500 ms) |
14 |
Checksum |
0xD1 |
Example 2
This example shows the message sequence you would use to change the mode of Call Progress Analysis Class 3 to Energy Detection, with a sensitivity level of -30 dBm and a scan duration of 60ms.
To change the mode, you send the following three Call Progress Analysis Class Configure messages in this sequence:
Byte |
Message Field |
Field Value |
---|---|---|
8 |
Action |
0x03 (Change Class Parameter) |
9 |
Data[0] – Parameter |
0x01 (Mode) |
10 |
Data[1] – Reserved |
0x00 |
11 |
Data[2] – Mode |
0x02 (Energy Detection enabled) |
Byte |
Message Field |
Field Value |
---|---|---|
8 |
Action |
0x03 (Change Class Parameter) |
9 |
Data[0] – Parameter |
0x0B (Mode Specific 1) |
10 |
Data[1] – Reserved |
0x00 |
11 |
Data[2] – Sensitivity Level |
0x06 (-30 dBm) |
Byte |
Message Field |
Field Value |
---|---|---|
8 |
Action |
0x03 (Change Class Parameter) |
9 |
Data[0] – Parameter |
0x0C (Mode Specific 2) |
10 |
Data[1] – Reserved |
0x00 |
11 |
Data[2] – Scan Duration |
0x06 (60 ms) |