J1 Span Configure 0x0019

Configuration API Messages

SwitchKit Name

J1SpanConfig

Type

EXS API and SwitchKit API message

Description

J1 Span Configure 0x0019

This message is used by the host to configure the transmitted pattern of certain bits in different frames of a multi-frame over the J-ONE interface.

NOTE: Before changing span configuration, Cantata ALWAYS RECOMMENDS that you de-assign the spans, assign them again and then send the new span configuration.

 

 

Sent by

Host

SwitchKit Code

Configuration

J1SpanConfig (

Node = integer,

StartSpanRange = integer,

EndSpanRange = integer,

ChanData = byte array,

FrameData = byte array);

C Structure

typedef struct {

unsigned short StartSpanRange;

unsigned short EndSpanRange;

UBYTE ChanData[6];

UBYTE FrameData[217];

} XL_J1SpanConfig;

C++ Class

class XLC_J1SpanConfig : public XLC_SpanRangeMessage {

public:

XBYTE getStartSpan() const;

XBYTE getEndSpan() const;

void setStartSpan(XBYTE s);

void setEndSpan(XBYTE s);

unsigned short getStartSpanRange() const;

void setStartSpanRange(unsigned short x);

unsigned short getEndSpanRange() const;

void setEndSpanRange(unsigned short x);

const UBYTE *getChanData() const;

UBYTE *getChanData();

void setChanData(UBYTE *x);

const UBYTE *getFrameData() const ;

UBYTE *getFrameData();

void setFrameData(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 (0x0019)

3, 4

Message Type (0x0019)

5

Reserved (0x00)

5

Reserved (0x00)

6

Sequence Number

6

Same Sequence Number

7

Logical Node ID

7

Logical Node ID

:

AIB

Address Method

0x01 - Range of AEs

8, 9

Status (MSB, LSB)

10

AIB

:

Checksum

Number of AEs to follow

0x02

AEs

0x0C Logical Span (Starting)

0x0C Logical Span (Ending)

:

Channel Data[0]

Bit mask of values for channels 1–5

:

Channel Data[1]

Bit mask of values for channels 6–10

:

Channel Data[2]

Bit mask of values for channels 11–15

:

Channel Data[3]

Bit mask of values for channels 17–21

:

Channel Data[4]

Bit mask of values for channels 22–26

:

Channel Data[5]

Bit mask of values for channels 27–31

:

Frame Data[0]

Bit mask of values for HG1–HG5 of Frame 0

:

Frame Data[1]

Bit mask of values for HG1–HG5 of Frame 7

:

Frame Data[2]

Bit mask of values for HG1–HG5 of Frame 8

:

Frame Data[3]

Channel or Frame data bit mask of values for HG1–HG5 of Frame 15

Bit 7 Does not matter (MSB)

Bit 6 Does not matter

Bit 5 Does not matter

Bit 4 HG1

Bit 3 HG2

Bit 2 HG3

Bit 1 HG4

Bit 0 HG5 (LSB)

:

Checksum