You are here: CSP API Reference > 1 EXS & SwitchKit API Messages > PPL Create 0x00D4

PPL Create 0x00D4

SwitchKit Name

PPLCreate

Type

EXS API and SwitchKit API message

Description

PPL Create 0x00D4

This message is used to create a PPL protocol from previously downloaded state/event and primitive tables. The host assigns the protocol ID and uses it to identify the protocol in subsequent messages.

Sent by

Host

SwitchKit Code

C Structure

typedef struct {

unsigned short ComponentID;

UBYTE ProtocolID;

char ProtocolName[20];

UBYTE NumTables;

UBYTE TableData[229];

} XL_PPLCreate;

C++ Class

class XLC_PPLCreate : public XLC_OutboundMessage {

public:

unsigned short getComponentID() const;

void setComponentID(unsigned short x);

UBYTE getProtocolID() const;

void setProtocolID(UBYTE x);

const char *getProtocolName() const;

void setProtocolName(const char *x);

UBYTE getNumTables() const;

void setNumTables(UBYTE x);

const UBYTE *getTableData() const;

UBYTE *getTableData();

void setTableData(UBYTE *x);

};

EXS API Hex Format

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 (0x00D4) | 3, 4 | Message Type (0x00D4)
5 | Reserved (0x00) | 5 | Reserved (0x00)
6 | Sequence Number | 6 | Same Sequence Number
7 | Logical Node ID | 7 | Logical Node ID
8, 9 | PPL Component ID MSB, LSB See PPL Component IDs in the API Reference. | 8, 9 | Status MSB, LSB
10 | PPL Protocol ID Number assigned to the protocol by the host (0x01–0x0A). | 10 | Checksum
11–30 | PPL Protocol Name A NULL-terminated ASCII string of up to 20 characters describing the protocol ("ITU-T Protocol"). You must pad any remaining byte offsets up to 20 with 0x00.
31 | Number of Tables (n)
: | Table 1: Type 0x01 Primitive Table 0x02 State/Event Table 0x03 Route Table 0x04 Resource Group Table
: | Table 1: ID Number assigned to the table by the host (0x01–0x0A).
: | Table n: Type
: | Table n: ID
: | Checksum

See Programmable Protocol Language.
In PPL, a condition that, when met, drives a state machine (PPL Component) from one state to another, by invoking an associated Primitive. In PPL files, an Event is marked by an arrow and text.
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.
A programmable software component that uses PPL state machines that can be modified with the PPL Tool.
Most Significant Bit
Least Significant Bit
American Standard Code for Information Interchange
Group of one or more Atomic Functions that allow multiple actions (tests) to be initiated in response to a PPL event for a channel. 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.