You are here: CSP API Reference > 1 EXS & SwitchKit API Messages > 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
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 |
|
|
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.