Download Complete 0x00A4

SwitchKit Name

DownloadComplete

Type

EXS API and SwitchKit API message

Description

This message should not be sent by the host to standby Matrix Controller cards, since the Matrix Controller cards receive their loads from the TFTP download.

However, you can use this message to configure active Matrix Controller cards.

Sent by

Host

SwitchKit Code

C Structure

typedef struct {

int Timestamp;

} XL_DownloadComplete;

C++ Class

class XLC_DownloadComplete : public XLC_OutboundMessage {

public:

int getTimestamp() const;

void setTimestamp(int x);

};

EXS API Hex Format

MESSAGE (White)

RESPONSE (Gray)

Byte

Field Description

Byte

Field Description

0

Frame (0xFE)

0

Frame (0xFE)

1, 2

Length (0xNNNN)

1, 2

Length (0x0007)

3, 4

Message Type (0x00A4)

3, 4

Message Type (0x00A4)

5

Reserved (0x00)

5

Reserved (0x00)

6

Sequence Number

6

Same Sequence Number

7

Logical Node ID

7

Logical Node ID

8-11

Timestamp (See below)

8, 9

Status MSB, LSB

12

Checksum

10

Checksum

Timestamp

This field is a long word received Most Significant Byte first, and Least Significant Byte last. It is associated with the newly downloaded system software once it has been validated.

This field is used to determine which matrix has the most recent system software in a redundant system when two different system software versions are present. In this situation the system software with the highest timestamp will be transferred to the other matrix.

As far as the matrices are concerned, the timestamp has nothing to do with time, but it is suggested that the host use a time-related number in this field. The host must guarantee that each new load has a higher timestamp than the previous one or the new load will be overwritten with the system software from the other matrix. The format of the timestamp is number of seconds since January 1, 1970.