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