You are here: CSP API Reference > 1 EXS & SwitchKit API Messages > Download Complete 0x00A4

Download Complete 0x00A4

SwitchKit Name

DownloadComplete

Type

EXS API and SwitchKit API message

Description

Download Complete 0x00A4

This message should not be sent by the host to standby CSP 2000 Matrix Cards, since the CSP Matrix Series 3 Cards receive their loads from the TFTP download.

However, you can use this message to configure active CSP 2000 Matrix 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.

A computer, attached to the Excel platform through an RS-232 or Ethernet link, from which you run the telecommunications application that controls the Excel platform.
A group of data bits in a specific format, with a flag at each end to indicate the beginning and the end of the frame.
Most Significant Bit
Least Significant Bit