Connect 0x0000

SwitchKit Name

Connect

Type

EXS API and SwitchKit API message

Description

This message instructs the Excel platform to establish a two-way connection between the two channels specified, for example, Channel A and Channel B.

If there is no active call up for Channel B, a seizure will be generated on that channel, and once seize ACKs have been met, the voice path is connected.

 

NOTE: This message treats the first span/channel and the second span/channel the same regardless of their inbound or outbound nature. Therefore, the answer supervision mode of only the second span/channel is meaningful in the Connect API message.

Sent by

Host

Example Message (Socket Log Output for SwitchKit)

For EXS API, the example message below configures the Excel platform to establish a two-way connection between span 01 channel 01 and span 02 channel 02:

For SwitchKit, the socket log output below shows configuration of the Excel platform, which establishes a two-way connection between span 01 channel 01 and span 02 channel 02:

00 11 00 00 00 00 FF 00 02 0D 03 00 01 01 0D 03 00 02 02

SwitchKit Code

C Structure

typedef struct {

unsigned short SpanA;

UBYTE ChannelA;

unsigned short SpanB;

UBYTE ChannelB;

} XL_Connect;

C++ Class

class XLC_Connect : public XLC_OutboundMessage {

public:

unsigned short getSpanA() const;

void setSpanA(unsigned short x);

UBYTE getChannelA() const;

void setChannelA(UBYTE x);

unsigned short getSpanB() const;

void setSpanB(unsigned short x);

UBYTE getChannelB() const;

void setChannelB(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 (0x0011)

1, 2

Length (0x0007)

3, 4

Message Type (0x0000)

3, 4

Message Type (0x0000)

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

8, 9

Status (MSB, LSB)

See Response Status Values.

10,11

State (MSB, LSB)

If the MSB of the preceding Status field is 0x18 (Invalid Channel B State) or 0x1D (Invalid Channel A State), then this field indicates the component state. If the State value is greater than 0xFF (255), then it is truncated to 0xFF.

 

If the MSB of the preceding Status field is neither 0x18 nor 0x1D, then the value in this field is 0x0000.

 

If the preceding Status field is a positive acknowledgement, this field does not apply.

Number of AEs to follow

0x02

AEs

0x0D Channel A

0x0D Channel B

:

Checksum

12

Checksum