You are here: CSP API Reference > 1 EXS & SwitchKit API Messages > PPL Timer Configure 0x00CF

PPL Timer Configure 0x00CF

SwitchKit Name

PPLTimerConfig

Type

EXS API and SwitchKit API message

Description

PPL Timer Configure 0x00CF

This message allows the host to configure PPL timers.

The 100 generic timers are used as defined by the protocol tables. The protocol designer must specify which timers are used, and how. This message allows the timers to be adjusted without having to modify the PPL State/Event or Primitive Tables.

NOTE: This message does not support the older ST1LC line cards. The correct message to use for these older line cards is the Filter/Timer Configure message (0x12).

Sent by

Host

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 (0x00CF) | 3, 4 | Message Type (0x00CF)
5 | Reserved (0x00) | 5 | Reserved (0x00)
6 | Sequence Number | 6 | Same Sequence Number
7 | Logical Node ID | 7 | Logical Node ID
8 | AIB | 8, 9 | Status, MSB, LSB
: |
: | PPL Component ID MSB, LSB | 10 | Checksum
: | PPL Timer Type
: | PPL Timer ID
: | PPL Timer Value MSB, LSB
: | Checksum

SwitchKit Code

Configuration

PPLTimerConfig (

Node = integer,

StartSpan = integer,

StartChannel = integer,

EndSpan = integer,

Range = StartSpan:StartChan - EndSpan:EndChan,

EndChannel = integer,

Span = integer,

Channel = integer,

Subrate = integer,

StackID = integer,

LinkID = integer,

Destination = integer,

Route = integer,

SSLGroupID = integer,

SSLProfileID = integer,

SSLServiceNumber = integer,

V5ID = integer,

ComponentID = integer,

TimerType = integer,

TimerID = integer,

TimerValue = integer);

C Structure

typedef struct {

UBYTE AddrInfo[30];

unsigned short ComponentID;

UBYTE TimerType;

UBYTE TimerID;

unsigned short TimerValue;

} XL_PPLTimerConfig;

C++ Class

class XLC_PPLTimerConfig : public XLC_OutboundMessage {

public:

const UBYTE *getAddrInfo() const;

UBYTE *getAddrInfo();

void setAddrInfo(UBYTE *x);

XBYTE getStartSpan() const;

void setStartSpan(XBYTE x);

UBYTE getStartChannel() const;

void setStartChannel(UBYTE x);

XBYTE getEndSpan() const;

void setEndSpan(XBYTE x);

UBYTE getEndChannel() const;

void setEndChannel(UBYTE x);

XBYTE getSpan() const;

void setSpan(XBYTE x);

UBYTE getChannel() const;

void setChannel(UBYTE x);

XBYTE getV5ID() const;

void setV5ID(XBYTE x);

unsigned short getComponentID() const;

void setComponentID(unsigned short x);

UBYTE getTimerType() const;

void setTimerType(UBYTE x);

UBYTE getTimerID() const;

void setTimerID(UBYTE x);}

unsigned short getTimerValue() const;

void setTimerValue(unsigned short x);

};

EXS API Hex Format - Detailed

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 (0x00CF) | 3, 4 | Message Type (0x00CF)
5 | Reserved (0x00) | 5 | Reserved (0x00)
6 | Sequence Number | 6 | Same Sequence Number
7 | Logical Node ID | 7 | Logical Node ID
: | AIB Address Method Depends on component being addressed. | 8, 9 | Status, MSB, LSB
10 | Checksum
Number of AEs to follow
AE The AE used depends on the component being addressed. See PPL Component Addressing in the API Reference.
: | PPL Component ID (MSB, LSB) See PPL Component IDs in the API Reference. |  |
: | PPL Timer Type 0x01 Generic Protocol Timer 0x02 R2 Signaling Timer 0x03 DTMF Signaling Timer 0x04 MFR1 Signaling Timer 0x05 Dial Pulse Timer T1 must use 0x01 Generic Protocol Timer. E1 can use any of the timers above.
: | PPL Timer ID The specific timer according to its type. The meaning of the time ID depends on the value of the PPL Timer Type field. Valid entries for this field are listed below by PPL Timer Type field value. The default durations for timers are shown in parenthesis in 10 ms units. 0x01 Generic Protocol Timer IDs Refer to Transmit Signaling Timers in the Timers and Filters chapter for the range of values. 0x02 R2 Signaling Timer 0x01 Pulse Duration (15) The length of time to transmit a pulsed R2 signal. 0x02 Pulse Delay (15) The minimum delay between the end of transmission of the last R2 signal of the compelled cycle and the start of transmission of a pulsed signal. 0x03 Minimum Valid Duration (7) The minimum length of time a signal must be received before it is declared a valid signal. 0x04 Maximum Tone State Change (2000) ń the length of time to scan a receive R2 signal state change. 0x03 DTMF Signaling Timer 0x01 DTMF Transmit Duration (6) 0x02 DTMF Transmit Inter-digit Duration (6) 0x03 DTMF Maximum Receive 1st Digit Detect (2000) 0x04 DTMF Maximum Receive Inter-digit Timeout (2000) 0x05 DTMF Minimum Receive Digit Duration (4) 0x06 DTMF Minimum Receive Inter-digit Timeout (4) 0x04 MFR1 Signaling Timer 0x01 MFR1 Transmit KP Duration (10) 0x02 MFR1 Transmit Digit Duration (6) 0x03 MFR1 Transmit Inter-digit Duration (6) 0x04 MFR1 Minimum Receive KP Duration (5) 0x05 MFR1 Minimum Receive Digit Duration (3) 0x06 MFR1 Maximum Receive KP Detect (1000) 0x07 MFR1 Minimum Receive Inter-digit Timeout (3) 0x08 MFR1 Maximum Receive Inter-digit Timeout (1000)
: | 0x05 Dial Pulse Signaling Timer 0x01 Dial Pulse Transmit Make Duration (4) 0x02 Dial Pulse Transmit Break Duration (6) 0x03 Dial Pulse Transmit Inter-digit Timeout (60) 0x04 Dial Pulse Receive Minimum Make Duration (3) 0x05 Dial Pulse Receive Maximum Make Duration (10) 0x06 Dial Pulse Receive Minimum Break Duration (4) 0x07 Dial Pulse Receive Maximum Break Duration (10) 0x08 Dial Pulse Receive Maximum First Digit Detect (2000) 0x09 Dial Pulse Receive Maximum Inter-digit Timeout (2000)
: | PPL Timer Value MSB, LSB Timers are in 10 millisecond units. See the Timer Conversion Table. Changing the Connection Type with the ISDN Interface Configure message sets all B channel configuration parameters back to their defaults. If you need to change the default ISDN PPL configuration bytes or PPL timers you should first change the Connection Type. Note: For Generic Protocol Timer ID 0x04, the PPL Timer Value the preferred value is 0x0078. Set this timer to a value less than T7 to enable the CSP to release the call if the IAM is not handled by the host application.
: | Checksum

See Programmable Protocol Language.
The condition of a component at a given instant. The current "context" of a PPL object, such as Idle, Seizing, Answered. In PPL files, a State is represented by a circle.
A computer, attached to the Excel platform through an RS-232 or Ethernet link, from which you run the telecommunications application that controls the Excel platform.
A group of data bits in a specific format, with a flag at each end to indicate the beginning and the end of the frame.
See Address Information Block.
Most Significant Bit
Least Significant Bit
A programmable software component that uses PPL state machines that can be modified with the PPL Tool.
Range of channels provided by T1 or E1 transmission service. A physical span is a group of channels taking up a single physical wire. A logical span is a group of channels taking up less than a single logical wire, or carried over more than one physical wire.
Digital communications link - voice, data, and video at a 1.544 Mbps rate (24 64 Kbps channels)
A digital communications link - voice, data, and video at a 2.048 Mbps rate; 30B/2D or 31B/1D (ISDN); non-North American version of T1.
See Integrated Services Digital Network.