Reset Configuration 0x000B

You are here: CSP API Reference > 1 EXS & SwitchKit API Messages > 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
	AIB Address Method 0x00 - Individual AEs	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.