Ring Status Query 0x0071

SwitchKit Name

RingStatusQuery

Type

EXS API and SwitchKit API message

Description

Use this message to query either the ring status or the ring configuration.

To Query Ring Configuration

Use the Ring Configuration Query address type in the AIB to query the ring configuration. See "Response Data" for the format of the data returned by the Excel platform.

Sent by

Host

SwitchKit Code

C Structure

typedef struct {

UBYTE AddrInfo[253];

} XL_RingStatusQuery;

C Structure Response

typedef struct {

unsigned short Status;

UBYTE Slot;

UBYTE Data[221];

} XL_RingStatusQueryAck;

C++ Class

class XLC_RingStatusQuery : public XLC_OutboundMessage {

public:

const UBYTE *getAddrInfo() const;

UBYTE *getAddrInfo();

void setAddrInfo(UBYTE *x);

UBYTE getSlot() const;

void setSlot(UBYTE x);

};

C++ Class Response

class XLC_RingStatusQueryAck : public XLC_AcknowledgeMessage {

public:

unsigned short getStatus() const;

void setStatus(unsigned short x);

UBYTE getSlot() const;

void setSlot(UBYTE x);

const UBYTE *getData() const;

UBYTE *getData();

void setData(UBYTE *x);

};

Overview of message

The following table provides an overview of this message. The table following it, provides the detail for each byte.

MESSAGE (White)

RESPONSE (Gray)

Byte

Field Description

Byte

Field Description

0

Frame (0xFE)

0

Frame (0xFE)

1, 2

Length (0xNNNN)

1, 2

Length (0xNNNN)

3, 4

Message Type (0x0071)

3, 4

Message Type (0x0071)

5

Reserved (0x00)

5

Reserved (0x00)

6

Sequence Number

6

Same Sequence Number

7

Logical Node ID

7

Logical Node ID

8

:

AIB

Address Method

8, 9

Status MSB, LSB

Number of AEs to follow

10

:

AIB (same as message)

AEs

:

:

:

Checksum

:

Data

 

:

:

:

Checksum

 

EXS API Hex Format - Detailed

MESSAGE (White)

RESPONSE (Gray)

Byte

Field Description

Byte

Field Description

0

Frame (0xFE)

0

Frame (0xFE)

1, 2

Length (0xNNNN)

1, 2

Length (0xNNNN)

3, 4

Message Type (0x0071)

3, 4

Message Type (0x0071)

5

Reserved (0x00)

5

Reserved (0x00)

6

Sequence Number

6

Same Sequence Number

7

Logical Node ID

7

Logical Node ID

8

:

AIB

Address Method

0x00 - Individual AEs

8, 9

Status MSB, LSB

Number of AEs to follow

10

:

AIB (same as message)

AE

0x01 Slot

0x3D Ring Configuration Query

:

Checksum

:

Data (also see Response Data section below this table)

For a Ring Configuration Query, see the information below this table

For a Ring Status Query, see the information directly below:

 

Data[0] Logical Ring ID

Data[1] Ring Status

This field indicates the status of the ring to which this node belongs.

0x00 In Service: Ring capable of passing data

0x01 Ring Initializing: Validating integrity of the ring

0x02 Connected: Adjacent nodes are physically connected and seeing light

0xFE RIC Failure State: Must cycle the ring service state or run diagnostics

0xFF Out of Service: Ring is down and unable to pass data

Data[2] More Status

This field indicates the ring status information whenever the ring unexpectedly goes down.

0x00 EXNET Card Reset Host has taken ring out-of-service (normal reset)

0x01 Ring Configuration Incomplete

0x02 Waiting for Addition

0x05 Unsupported Ring Mod

0xF6 EXNET Card In Failed State: EXNET Card has reset too many times

0xF7 EXNET Card Reset: EXNET Card configuration information changed

0xF8 EXNET Card Reset: Remote node timed out

0xF9 EXNET Card Timed Out During Ring Initialization

0xFA Internal Diagnostics Failed

0xFB EXNET Card Isolated From Ring

0xFC Ring Out of Service: Internal failure

0xFE Not Receiving Light

0xFF Ring Out of Service

 

Data[3] EXNET Port A Status

This field indicates the status of EXNET port A.

0x00 Normal

0x01 Loop Back

 

Data[4] EXNET Port B Status

This field indicates the status of EXNET port B.

0x00 Normal

0x01 Loop Back

 

Data[5] Master Status

This field indicates whether or not this node is the master.

0x00 Not Master

0x01 Master

 

Data[6] Transmit Mode

This field indicates status of the transmit and receive mode.

0x00 Receive Only

0x01 Transmit/Receive

 

Data[7] Source Packet Number

This field indicates the ID number of the source packet.

0x00–0x1F Source Packet Number

0xFF Source Packet Number Unassigned

Data[8] Master Arbitration Flag

This field indicates whether or not a node is allowed to become EXNET Ring Master:

0x01 This node is allowed to participate in EXNET Ring Master Arbitration.

0x00 This node is not allowed to participate in EXNET Ring Master Arbitration.

 

Data[9] Redundancy State

This field indicates redundancy state of the RICs:

0x00 No Redundancy

0x01 Active RIC

0x02 Standby RIC

0xFF Role Not Yet Defined

 

Data[10] Current Ring Mode

This field indicates the Ring Mode:

0x00 Normal Ring Mode

0x01 Enhanced Fault Tolerance Ring Mode

:

Checksum

 

Response Data

Ring Configuration Query

When querying the ring configuration, the following Data is returned.

Figure 0-1 Ring Configuration Query Response Data Format

 

Data[0] Number of Rings Configured

Data[1] Number of Unconfigured Nodes

NOTE: Data[2-12] is reported for each ring in the system.

Data[2] Logical Ring ID

Data[3] Ring Service State

0x00 Out of Service

0x01 In Service

Data[4] Number of Nodes on Ring

Data[5] Ring Master Node ID

NOTE: Data[6-12] is repeated for each node on the ring.

Data[6] Logical Node ID

Data[7] Physical Node ID

Data[8] IP Address

Data[9] Load Major Revision

0x00 Unavailable

0x01 Major Revision Number of the Load on the Matrix greater

Data[10] Load Minor Revision

0x00 Unavailable

0x01 Minor Revision Number of the Load on the Matrix greater

Data[11] Load Build Number

0x00 Unavailable

0x01 Build Number of the Load on the Matrix greater

Data[12] Transmit/Receive Mode

0x00 Receive Only

0x01 Transmit and Receive