Reset Configuration 0x000B

SwitchKit Name

ResetConfig

Type

API and SwitchKit API message

Description

This message resets a card’s configuration to the default values by corrupting the battery-backed configuration and initiating a hardware reset on the local processor. To reset the configuration on a Matrix Controller, all cards must be specified and the force flag must be set.

This message is useful for completely reinitializing the Excel platform or any component in the Excel platform. Generally, it should not be used on a live system.

Sent by

Host

SwitchKit Code

Configuration

ResetConfig (

Node = integer,

Slot = integer,

ForcedFlag = integer);

C Structure

typedef struct {

UBYTE Slot;

UBYTE ForcedFlag;

} XL_ResetConfig;

C++ Class

class XLC_ResetConfig : public XLC_OutboundMessage {

public:

UBYTE getSlot() const;

void setSlot(UBYTE x);

UBYTE getForcedFlag() const;

void setForcedFlag(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 (0x000B)

3, 4

Message Type (0x000B)

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

10

Checksum

Number of AEs to follow

AEs

0x01 Slot

The location of the line
card to be reset (0xFF = all cards
in the system)

:

Force Flag

0xFF: Card configuration will be reset even if it has spans in service.
All cards in the system will have their configuration reset.

 

If this flag is not set, messages sent to a card with spans in service fail,
and the host receives a Response Status of 0x72 (Span In Service).

:

Checksum

Notes:

1. When resetting a line card’s configuration, the host must wait for a Card Status Report message on the specified line card before considering its configuration reset.

2. Switchover will occur if all cards in the system are specified and there is a standby Matrix Controller present.

3. The Matrix Controller that gains control of the system after you send the Reset Configuration message becomes the active Matrix Controller. This Matrix Controller may not necessarily be the on that was active before you sent the message.