Connect With Pad 0x0003

SwitchKit Name

ConnectWithPad

Type

EXS API and SwitchKit API message

Description

This message instructs the Excel platform to establish a connection between the two channels specified while maintaining the dB gain/loss adjustment specified for the duration of the connection.

Sent by

Host

SwitchKit Code

C Structure

typedef struct {

unsigned short SpanA;

UBYTE ChannelA;

unsigned short SpanB;

UBYTE ChannelB;

UBYTE APad;

UBYTE BPad;

} XL_ConnectWithPad;

C++ Class

class XLC_ConnectWithPad : 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);

UBYTE getAPad() const;

void setAPad(UBYTE x);

UBYTE getBPad() const;

void setBPad(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 (0x00nn)

1, 2

Length (0x0007)

3, 4

Message Type (0x0003)

3, 4

Message Type (0x0003)

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)

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.

12

Checksum

Number of AEs to follow

0x02

AEs

0x0D Channel A

0x0D Channel B

:

Channel A Pad Value

The dB gain/loss adjustment of the signal being transmitted to Channel A.

0x00 +3 dB Gain/Loss

0x01 0 dB

0x02 2 dB

0x03 3 dB

0x04 4 dB

0x05 6 dB

0x06 9 dB

 

:

Channel B Pad Value

The dB gain/loss adjustment of the signal being transmitted to Channel B.

0x00 +3 dB Gain/Loss

0x01 0 dB

0x02 2 dB

0x03 3 dB

0x04 4 dB

0x05 6 dB

0x06 9 dB

:

Checksum