ClearSoftware

Type:

SwitchKit API message

Purpose

Use the ClearSoftware message to clear system software and to reset the matrix controller or device server of the Excel platform.

Description

This message is used for clearing system software and for resetting the the matrix controller card(s).

Sent by

Application or CSA

How to use

To use a ClearSoftware message, construct the message and set the matrix and action arguments as shown below:

SKC_ClearSoftware cls();

cls.setMatrix(matrix);

cls.setAction(action);

cls.setNodeId(node);

 

Arguments

The following table shows the arguments you can change:

Arguments

Description

Matrix

This argument specifies on which matrix controller card the action is applied:

SK_CLEARSW_ACTIVE (1) = Apply action to active matrix controller

SK_CLEARSW_STANDBY (2) = Apply action to standby matrix controller

SK_CLEARSW_ALL (3) = Apply action on both matrix controller cards in the Excel platform

Action

This argument specifies which action is applied:

SK_CLEARSW_CLEAR (1) = Clear software but do not reset the matrix controller.

SK_CLEARSW_CLEAR_AND_RESET (2) = Clear software and reset the matrix controller.

Node

This argument specifies the logical node ID of the matrix controller pair or the Device Server ID of the Device Server card to which the action is to be applied.

Status Field

The following table shows the possible return values of the status field. The status field can contain any of the values or the logical OR combination of two or more of the following:

Value

Description

SK_SUCCESS (0x10)

Message successfully executed.

SK_ACTIVE_NOT_
CLEARED (0x0001)

The active matrix controller card was not cleared.

SK_STANDBY_NOT_
CLEARED (0x0002)

The standby matrix controller card was not cleared.

SK_ACTIVE_NOT_
RESET (0x0004)

The active matrix controller card was not reset.

SK_STANDBY_NOT_
RESET (0x0008)

The standby matrix controller card was not reset.

SK_INVALID_NODE (0xf002)

This indicates that the application has no description data associated with it.

C Structure

typedef struct {

UBYTE Matrix;

UBYTE Action;

unsigned short NodeId;

} SK_ClearSoftware;

C++ Class

class SKC_ClearSoftware : public SKC_ToolkitMessage {

public:

UBYTE getMatrix() const;

void setMatrix(UBYTE x);

UBYTE getAction() const;

void setAction(UBYTE x);

unsigned short getNodeId() const

void setNodeId(unsigned short x)

};