You are here: CSP API Reference > 1 EXS & SwitchKit API Messages > Call Processing Event 0x002E
SwitchKit Name
Type
EXS API and SwitchKit API message
Description
The Excel platform uses this message to report a call processing event on a specified channel. The event to be reported is specified by the host in the messages that support the generation of call processing events.
Sent by
Excel platform
Resent in EXS API
This message is resent once after five seconds.
SwitchKit Code
C Structure
typedef struct {
UBYTE AddrInfo[30];
unsigned short Span;
UBYTE Channel;
UBYTE Event;
UBYTE Data[222];
} XL_CallProcessingEvent;
C++ Class
class XLC_CallProcessingEvent : public XLC_OneChannelMessage {
public:
const UBYTE *getAddrInfo() const;
UBYTE *getAddrInfo();
void setAddrInfo(UBYTE *x);
XBYTE getConferenceID() const;
void setConferenceID(XBYTE x);
XBYTE getParentConferenceID() const;
void setParentConferenceID(XBYTE x);
XBYTE getChildConferenceID() const;
void setChildConferenceID(XBYTE x);
XBYTE getSpan() const;
void setSpan(XBYTE x);
UBYTE getChannel() const;
void setChannel(UBYTE x);
UBYTE getEvent() const;
void setEvent(UBYTE x);
const UBYTE *getData() const;
UBYTE *getData();
void setData(UBYTE *x);
};
Overview of message
The following table provides an overview of this message. The table following it, provides the detail for each byte.
MESSAGE |
RESPONSE |
||
Byte |
Field Description |
Byte |
Field Description |
0 |
Frame (0xFE) |
0 |
Frame (0xFE) |
1, 2 |
Length (0x00NN) |
1, 2 |
Length (0x0005) |
3, 4 |
Message Type (0x002E) |
3, 4 |
Message Type (0x002E) |
5 |
Reserved (0x00) |
5 |
Reserved (0x00) |
6 |
Sequence Number |
6 |
Same Sequence Number |
7 |
Logical Node ID |
7 |
Logical Node ID |
8 |
AIB (starting with byte 0) |
8 |
Checksum |
: |
Call Processing Event |
|
|
: |
Data (0) |
|
|
: |
: |
|
|
: |
Data (n) |
|
|
: |
Checksum |
|
|
EXS API Hex Format - Detailed
MESSAGE |
RESPONSE |
||
Byte |
Field Description |
Byte |
Field Description |
0 |
Frame (0xFE) |
0 |
Frame (0xFE) |
1, 2 |
Length (0x00NN) |
1, 2 |
Length (0x0005) |
3, 4 |
Message Type (0x002E) |
3, 4 |
Message Type (0x002E) |
5 |
Reserved (0x00) |
5 |
Reserved (0x00) |
6 |
Sequence Number |
6 |
Same Sequence Number |
7 |
Logical Node ID |
7 |
Logical Node ID |
: |
AIB Address Method 0x00 - Individual AEs |
8 |
Checksum |
Number of AEs to follow |
|||
AEs One of the following: |
|||
: |
Call Processing Event 0x00* No Event (the specified event did not occur before the 0x01* ANI Request Off-hook 0x02 Digits 0x03* Wink 1 0x04* Wink 2 0x05* Wink 3 0x06* Wink 4 0x07* Wink 5 0x08* Wink 6 0x09* Wink 7 0x0A* Wink 8 0x0B* Dialtone Detected 0x0C Reserved 0x0D Backward R2 Signal 0x0E First Digit Report 0x0F PPL Event 0x10 Digit With Timing Information 0x11* Receive Idle 0x13* FAX Tone Detection 0x20* Answer 0x21* Tone Complete 0x22* Outpulsing Complete 0x23* Flash Detected 0x24* CPC Detected 0x25 Recorded Announcement Started 0x26 Recorded Announcement Complete 0x27* Timed-out waiting for energy 0x28 Energy Result Report 0x29* Coin Tone Detection Timeout 0x2A Coin Tone Detection Report 0x2B Play File Started 0x2C Play File Complete 0x2D Record File Started 0x2E Record File Complete 0x2F File Not Found 0x30 File Play Underrun 0x31 File Record Overrun 0x32 Record Initial Silence Timeout 0x33 Play File Queue Failure 0x34 Play File Stopped 0x35 Record File Stopped 0x40* DTMF Subscription Terminated (either by remote end or because of subscription refresh failure.) 0x41 DSP Series 2 Fax Processing Events 0x42 Truly Silent Channel (PVD/AMD) 0x43 Voice Detect Rising Edge (PVD/AMD) 0x44 Voice Detect Falling Edge (PVD/AMD) 0x45 Long Term Voice Detect Rising Edge (PVD/AMD) 0x46 Long Term Voice Detect Falling Edge (PVD/AMD) 0x47 Tone Detect Rising Edge (PVD/AMD)
|
||
|
0x48 Tone Detect Falling Edge (PVD/AMD) 0x49 Echo Canceller Event (when a G.164 tone disabling event occurs on the near or far end) 0x48 0xfff0 |
||
|
*Event includes no data for Data fields |
||
: |
Data These fields provide the specific information for each Event. The length and contents of the information depend on the Event. Some events contain no data. |
||
|
|
||
|
0x02 Digits Data[0] Number of Stages Reported Data[1] Inpulsed Stage Number Data[2] Inpulsed Stage Status Data[3] Stage String Count Data[4] String 1: Digit Count Data[5] String 1: First BCD Encoded Digit Pair : Data[n] String 1: Last BCD Encoded Digit Pair Data[n+1] String 2: First BCD Encoded Digit Pair : Data[m] String 2: Last BCD Encoded Digit Pair Data[4–n] are repeated for each string reported. Data[1–n] are repeated for each stage reported.
Stage Status The system reports the stage status for each of the four stages. Timers can be configured.
Valid entries for this field are as follows:
0x10 Positive Acknowledgment - Digits received 0x80 Partial Dial Condition - Receive Inter-digit Duration timer expired 0x81 Permanent Signal Condition - Receive 1st Digit Detection timer expired 0x91 Inpulse Stage Not Collected - Stage not collected; no further stage information will 0x92 Digit Complete Timeout
|
||
|
If the Call Processing Event message is in response to a DSP Service Request or Collect Digit String message, the Inpulsed Stage Number is 0xFF. When the digits are collected using a KP_ST framed digit string collection method, the KP_ST digits are not contained in the reported string.
0x0D Backward R2 Signal Data[0] R2 Signal Value (0x01–0x0F)
Data[0] DTMF/MFR1 Digit Value (0x00–0x0F) |
||
|
0x0F PPL Event
Data[0] Number of Stages Reported * Data[1] Inpulsed Stage Number Data[2] Inpulsed Stage Status Data[3] Stage String Count * Data[4] Digit Count * Data[5] BCD-encoded Digit Data[6, 7] Digit Duration (in 10 ms units) |
||
|
The Inpulsed Stage Number will be 0xFF if the Call Processing Event message is in response to a DSP Service Request or Collect Digit String message. The maximum time detected for digit duration is 26.35 seconds. When actual digit duration is greater than 26.35 seconds, it reports as 26.35 (0x0A4B) seconds. Only a DSP Service Request message request can result in the Call Processing Event of "Digit With Timing Information" being returned by the Excel platform. 0x25 Recorded Announcement Started Data[0,1] ID of announcement being played (MSB, LSB)
0x26 Recorded Announcement Completed Data[0,1] ID of announcement completed (MSB, LSB) Data[0] Energy Result Flag 0x00 No Energy Detected 0x01 Energy Detected Data[1,2] Duration of previous Energy Result in 10 ms units
0x2A Coin Tone Detection Report Data[0,1] Value of coin detected, in cents 0x0005 5 cents (Nickel) 0x000A 10 cents (Dime) 0x0019 25 cents (Quarter) 0x0064 100 cents (Dollar)
0x2B Play File Started Data[0-3] File ID (MSB, ... , ... , LSB) Data[4-7] Offset (starting byte) Data[8-10] Server ID
0x2C Play File Complete Data[0-3] File ID (MSB, ... , ... , LSB) Data[4-7] Offset (ending byte) Data[8-10] Server ID
0x2D Record File Started Data[0-3] File ID (MSB, ... , ... , LSB) Data[4-7] Offset (starting byte) Data[8-10] Server ID
0x2E Record File Complete Data[0-3] File ID (MSB, ... , ... , LSB) Data[4-7] Offset (ending byte) Data[8-10] Server ID
0x2F File Not Found Data[0-3] File ID (MSB, ... , ... , LSB)
0x30 File Play Underrun Data[0-3] File ID (MSB, ... , ... , LSB)
0x31 File Record Overrun Data[0-3] File ID (MSB, ... , ... , LSB) |
||
|
0x32 Record Initial Silence Timeout Data[0-3] File ID (MSB, ... , ... , LSB)
0x33 Play File Queue Failure Data[0-3] File ID (MSB, ... , ... , LSB) Data[4-7] Offset (starting byte) Data[8-10] Server ID
0x34 Play File Stopped Data[0-3] File ID (MSB, ... , ... , LSB) Data[4-5] Stop Reason 0x0000 - Channel Released 0x0001 - Host Initiated Stop Data[6-9] Duration of Play (seconds) Data[10-12] Server ID
0x35 Record File Stopped Data[0-3] File ID (MSB, ... , ... , LSB) Data[4-5] Stop Reason 0x0000 - Channel Released 0x0001 - Host Initiated Stop 0x0002 - Out of File Space 0x0003 - NFS Write Error Data[6-9] Duration of Record (seconds) Data[10-12] Server ID
0x41 DSP Series 2 Fax Processing Events Data[0, 1] Fax processing event code (see below) Data[2, n] Fax processing event data
For Data[0, 1] Fax processing event code, above:
Phase A, B, C, D, or E: 9 Got CRC error in V.21 frame 15 Transmit V21 complete 29 ERR frame received 53 HS modem detected V21. Switch to receive V21 57 Unknown V21 frame received with correct CRC 60 CRP frame received
Phase A 62 Request the operator line
|
||
|
Phase B 6 DCS frame received 7 DIS frame received 8 DTC frame received 12 Switch to ECM mode 17 CFR frame received 18 CTC frame received 30 FTT frame received 47 Remote machine can receive detected 48 Remote machine can transmit detected 54 Receive training ended successfully 55 Receive training ended in failure 56 Transmit training ended 61 CTR frame received 66 Switch from ECM mode to Normal mode 67 Change mode after EOM
|
||
|
Phase C 0 Command to start receiving 1 Command to start transmitting 21 EOR frame received 22 EOR_EOM frame received 23 EOR_EOP frame received 24 EOR_MPS frame received 25 EOR_NULL frame received 26 EOR_PRI_EOM frame received 27 EOR_PRI_EOP frame received 28 EOR_PRI_MPS frame received 58 Start of image receive 64 ECM frames where detected in error 71 End of image transmit 72 Start of image transmit 74 Receive image operation complete 76 Go to point D in the T.30 flow chart 77 Got the 4th PPR 78 Decided to continue to correct after 4th PPR
|
||
|
Phase D 19 EOM frame received 20 EOP frame received 32 MCF frame received 33 MPS frame received 34 PIN frame received 35 PIP frame received 36 PPR frame received 37 PPS_EOM frame received 38 PPS_EOP frame received 39 PPS_MPS frame received 40 PPS_NULL frame received 41 PPR_PRI_EOM frame received 42 PPS_PRI_EOP frame received 43 PPS_PRI_MPS frame received 44 PRI_EOM frame received 45 PRI_EOP frame received 46 PRI_MPS frame received 49 RNR frame received 50 RR frame received 51 RTN frame received 52 RTP frame received 65 Receiver is not ready to continue 68 Got end of a page 69 Last document in the queue was processed
|
||
|
Phase E 5 DCN frame received 10 Go to B point in T.30 flow chart 31 Transition to C-point on T.30 flow charts 00FF FAX completed gracefully |
||
|
Timer Event 3 Hardware failure timer expired 13 T1 timer expired 14 T4 timer expired 59 T2 timer expired (see T.30) 75 T3 timer expired 79 T5 timer expired
Data Pump 2 T.30 is ready to receive 4 T.30 is ready to transmit 16 Hardware close completed 81 V.21 receiver has started to send preamble 82 V.21 receiver has completed operation 83 V.21 transmitter has started to send preamble 84 V.21 transmitter has completed operation 85 High-speed receiver has started to send preamble 86 High-speed receiver has received TCF, no errors 87 High-speed receiver has received TCF with errors 88 High-speed transmitter has started to send TCF 89 High-speed transmitter has completed TCF 90 High-speed transmitter has started 91 High-speed transmitter has completed operation 92 High-speed receiver has started to send preamble 93 High-speed receiver has lost carrier 94 V21 Receive Frame 95 V21 Transmit Frame 98 V21 signal detected by the HS receiver 99 Modem subsystem ready to transmit 100 Modem subsystem ready to receive 101 Modem subsystem has stopped operations 121 Non-Standard facilities (NSF) frame sent or receive 122 Non-Standard facilities Set-up (NSS) frame sent or receive 123 Non-Standard facilities Command (NSC) frame sent or receive 12 4 Called Subscriber Identification (CSI) frame sent or receive 125 Transmitting Subscriber Identification ( TSI) frame sent or receive 12 6 Calling Subscriber Identification ( CIG) frame sent or receive 12 7 Selective Polling (SEP) frame sent or receive 12 8 Subaddress (SUB) frame sent or receive 12 9 Password ( PWD) frame sent or receive 13 0 Digital Identification Signal (DIS) frame sent or received 13 1 Digital Command Signal ( DCS) frame sent or receive |
||
|
13 2 Digital Transmit Command (DTC) frame sent or receive 13 3 Continue To Correct (CTC) frame sent or receive 13 4 Partial Page Request ( PPR) frame sent or received 13 5 Partial Page Signal-NULL ( PPS-NULL) frame sent or receive 13 6 Partial Page Signal (PPS)-MPS frame sent or receive 13 7 Partial Page Signal (PPS)-EOM frame sent or receive 13 8 Partial Page Signal (PPS)-EOP frame sent or receive 13 9 PRI-PPS-MPS frame sent or receive 14 0 PRI-PPS-EOM frame sent or receive 14 1 PRI-PPS-EOP frame sent or receive 14 2 EOR-NULL frame sent or receive 14 3 EOR-MPS frame sent or receive 14 4 EOR-EOM frame sent or receive 14 5 EOR-EOP frame sent or receive 14 6 PRI-EOR-MPS frame receive 14 7 PRI-EOR-EOM frame sent or receive 14 8 PRI-EOR-EOP frame sent or receive 14 9 CRC error reported |
||
|
0x42-0x48 (Positive Voice Detection/Answering Machine Detection (PVD/AMD)) Data[0-3] Calendar Time (seconds since Jan. 1, 1970) Data[4, 5] Milliseconds Remainder Data[6, 7] Milliseconds Since Last Event Data[8, 9] Frequency Band Detected (Events 0x47 and 0x48 only) |
||
: |
Checksum |