You are here: CSP API Reference > 1 EXS & SwitchKit API Messages > Connect With Pad 0x0003
SwitchKit Name
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
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 |
: |
Address Method 0x00 - Individual
|
8, 9 |
|
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 |
|||
: |
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 |