You are here: CSP Developer’s Guide: Internet Protocols > 8 H.323 Software > PPL Component for H.225 - 0x00A1
PPL Component for H.225 - 0x00A1
Overview
This section includes configuration bytes, PPL Events, and Event Indications for the PPL Component H.225. This section also includes information on how this component affects the Call Progress and Alerting messages
Table 8-7 Configuration Bytes
|
Byte (Hex) |
Function |
Option (*default) |
|---|---|---|
|
0x01 |
0x00* - Do not propagate 0x01 - Propagate |
|
|
0x02 |
Cut voice path after sending/receiving Alerting message. |
0x00 - Disable 0x01 - Enable |
|
0x03 |
Cut voice path after sending/receiving Progress message. |
0x00 - Disable 0x01 - Enable |
Table 8-8 PPL Event Request
|
PPL Event Request ID |
Purpose |
|---|---|
|
0x09 |
H.225 Alerting |
|
0x0A |
H.225 Progress Request |
Table 8-9 PPL Event Indications
|
PPL Event Indication ID |
Purpose |
|---|---|
|
0x01 |
Fax Start |
|
0x02 |
Fax End |
|
0x05 |
Modem Start (not supported) |
|
0x06 |
Modem End (not supported) |
|
0x07 |
RTP Timer Expired |
|
0x08 |
Media Inactivity Timer Expired |
|
0x09 |
H.225 Alerting Indication |
|
0x0A |
H.225 Progress Indication |
Important! The PPL Indications will always have one ICB which give the IP Signaling Series 3 card ID ICB information.
Call Progress and Alerting Messages
Configuring the PPL Component 0xA1 to Transmit the PPL Event Indications
To enable the Excel platform to transmit the PPL Event Indication message to the host, you must set Configuration Byte 1 for PPL Component L3P H.225 (0xA1) to 0x01. To disable, set the configuration byte to 0x00.
Table 8-10 Sample PPL Configure message
|
Header |
00 01 00 D7 00 00 01 |
|---|---|
|
AIB (Range of Channels) |
01 02 0D 03 00 A8 00 0D 03 00 AC 1F |
|
Component ID |
00 A1 |
|
Entity |
01 |
|
Number of Config. Bytes |
01 |
|
Config. Byte Number |
01 |
|
Data |
00 - disable 01 - enable |
The PPL Event Indications will include an ICB of Progress Indicator IE (Information Element) if this IE is included in the Alerting or Progress message received from the network.
Table 8-11 Example
|
Header |
00 16 00 43 00 00 01 |
|---|---|
|
AIB |
00 01 0D 03 00 A8 00 |
|
Component ID |
00 A1 |
|
PPL Event |
00 09 or 00 0A |
|
Count |
0x01 or 0x02 |
|
Type |
Data 0x02 |
|
Subtype |
IP Signaling Card ID 0x5B Example: 0x003C |
|
Following data is optional |
|
|
Type |
Data 0x02 |
|
Subtype |
ISDN formatted IE 0x10 |
|
Length |
0x06 |
|
Data |
01 08 03 00 00 01 |
H.225 Progress Request (0x0A) signals to the IP Signaling Series 3 card when to transmit the Progress message to the network.
Table 8-12 Sample PPL Event Request
|
Header |
00 11 00 44 00 00 01 |
|---|---|
|
AIB (Channel) |
00 01 0D 03 00 A8 00 |
|
Component ID |
00 A1 |
|
PPL Event Request |
00 0A |
|
Number of ICBs |
00 or 01 If the application requires the voice path brought in, select 01 (see ICB below) |
Data ICB Progress Indicator IE
The PLL Event Request message may also include a data ICB - Progress Indicator Information Element (IE). This IE requests the IP Signaling Series 3 card to transmit a Progress message to the network and include the Progress IE.
This IE may be ISDN Raw (0x11) or Formatted (0x10). See the following examples:
Table 8-13 ISDN Raw Data
|
Header |
00 19 00 44 00 00 FF |
|---|---|
|
AIB (Channel) |
00 01 0D 03 00 00 00 |
|
Component ID |
00 A1 |
|
PPL Event Request |
00 0A |
|
Number of ICBs |
01 |
|
ICB Type |
02 |
|
IE (ISDN Raw) |
11 |
|
Length |
05 |
|
Number of IEs |
01 |
|
IE Type |
1E |
|
IE Length |
02 |
|
IE Data |
80 88 or 80 81 |
Table 8-14 Formatted Data
|
Header |
00 19 00 44 00 00 FF |
|---|---|
|
AIB (Channel) |
00 01 0D 03 00 00 00 |
|
Component ID |
00 A1 |
|
PPL Event Request |
00 0A |
|
Number of ICBs |
01 |
|
ICB Type |
02 |
|
IE (ISDN Raw) |
10 |
|
Length |
06 |
|
Number of IEs |
01 |
|
IE Type |
08 |
|
IE Length |
03 |
|
IE Data |
00 00 08 or 00 00 01 |
Configuring the PPL Component 0xA1 to Establish the Voice Path
To enable the Excel platform to establish the voice path before sending or receiving the Connect message, you must set either Configuration Byte 2 or 3 for the PPL Component H.255 (0x00A1) as described below.
Parking the channel allows the Alerting or Progress message to be sent to the host. Parking is optional when you set Configuration Byte 2 but mandatory when you set Configuration Byte 3.
If you enable Configuration Byte 2 as indicated below, the voice path cut-through happens after the Alerting message is sent or received, whether or not the Progress Indicator IE is present.
Table 8-15 PPL Configure Message with Configuration Byte 2
|
Header |
01 17 00 D7 00 00 01 |
|---|---|
|
AIB (Range of Channels) |
01 02 0D 03 00 A8 00 0D 03 00 AC 1F |
|
Component ID |
00 A1 |
|
Entity |
01 |
|
Number of Config. Bytes |
01 |
|
Config. Byte Number |
02 |
|
Data |
00 - Disable 01 - Enable |
If you enable the configuration byte below, the voice path cut-through happens after the Progress message is sent. This happens if the Progress message is sent or received when the Progress message contains the Progress Indicator IE and the Progress Description is set to 1 or 8.
Table 8-16 PPL Configure Message with Configuration Byte 3
|
Header |
00 17 00 D7 00 00 01 |
|---|---|
|
AIB (Range of Channels) |
01 02 0D 03 00 A8 00 0D 03 00 AC 1F |
|
Component ID |
00 A1 |
|
Entity |
01 |
|
Number of Config. Bytes |
01 |
|
Config. Byte Number |
03 |
|
Data |
00 - Disable 01 - Enable |
If you set both configuration bytes above, the voice path cut-through happens after the Excel platform sends or receives either the Alerting or Progress messages, whichever is processed first.