You are here: CSP API Reference > 1 EXS & SwitchKit API Messages > Clear System Software 0x000C
SwitchKit Name
ClearSystemSoftware
Type
EXS API and SwitchKit API message
Description
NOTE: This message is for use in a lab environment only. You must not send this message to a live system.
This message clears the system software stored in memory on the Matrix Controller card. Use this message immediately before you send a new load to the Matrix Controller card. To stop the running system software, push the Reset button or send a Reset Matrix message.
System software is copied into maintained storage. Upon reset or boot, software is copied from maintained storage to RAM for execution. When the host sends this message, the copy in maintained storage is cleared, but the RAM is unaffected.
If a card resets after you send this message, the card will not retrieve a software load from maintained storage and will not come back into service.
Redundant Matrix Cards
In a redundant system, sending this message to the active Matrix Controller card clears both Matrix Controller cards. After sending this message to the active Matrix Controller card, you must send a Reset Matrix message to both Matrix Controller cards.
Sent by
Related API Message
Reset Matrix 0x009D (ResetMatrix)
SwitchKit Code
C Structure
typedef struct {
} XL_ClearSystemSoftware;
C++ Class
class XLC_ClearSystemSoftware : public XLC_OutboundMessage {
public:
};
EXS API Hex Format
MESSAGE (White) |
RESPONSE (Gray) |
||
Byte |
Field Description |
Byte |
Field Description |
0 |
Frame (0xFE) |
0 |
Frame (0xFE) |
1, 2 |
Length (0x0005) |
1, 2 |
Length (0x0007) |
3, 4 |
Message Type (0x000C) |
3, 4 |
Message Type (0x000C) |
5 |
Reserved (0x00) |
5 |
Reserved (0x00) |
6 |
Sequence Number |
6 |
Same Sequence Number |
7 |
Logical Node ID |
7 |
Logical Node ID |
8 |
Checksum |
8, 9 |
|
10 |
Checksum |