You are here: CSP Developer’s Guide: Overview > 3 Getting Started > Creating a TFTP Configuration File

Creating a TFTP Configuration File

Overview

You must create a TFTP Configuration File that indicates the loads to be downloaded. Each software release comes with a default configuration file which contains information for all cards supported in that release. You can modify the default configuration file.

See the sample TFTP Configuration File below.

TFTP Configuration FIle Format

The entries in the configuration file do not need to be in a specific order, but they must follow this format:

<Card Label_LOAD>=<path/filename>:SAVE_LOAD_<TRUE or FALSE> ‘ Comment

No space is allowed on the line until after the SAVE_LOAD label. The path/filename can be up to 127 characters long.

Card Label

The table below shows the labels used in the TFTP Configuration File for each card.

Table 3-4 Labels for TFTP Configuration File

Card Name | Card Label
--- | ---
Matrix Controller Series 3 | EXCPU
E-ONE, T-ONE, J-ONE | ONELC
ST1LC | ST1LC
SE1LC | SE1LC
SJ1LC | SJ1LC
DSP-ONE | DSPONE
SS7 PQ | SS7PQLC
SS7 Series 3 | SS7HPLC
Subrate Controller | SRC
DSP Series 2 |
ISDN PRI, ISDN BRI, DASS2/DPNSS | ISDN32
ISDN Series 3 | ISDNHPLC
EXNET-ONE | EXNTONE
DS3 | DS3
VDAC Module | VOIPMOD
VDAC Main Board | VOIPMBRD
IP Signaling Series 3 (H.323) | EXCPU

Matrix Controller Load

You must set the Matrix Controller load to be saved on the Matrix Controller card by including "TRUE" in the line for the matrix (for example, SAVE_LOAD_TRUE). The Save Load option is not supported for any other cards. The load for cards other than the Matrix Controller are retrieved as needed via TFTP.

Timestamp

If you are using BOOTP to initiate the download, you must provide a timestamp in the configuration file.

Important! The configuration filename on the BOOTP server must match the .bin name on the TFTP server.

If you are using the TFTP Manage message to initiate the download, you can include the timestamp in either the TFTP configuration file or in the TFTP Manage message. The TFTP Manage response Status is 0x01 (Two Timestamps Provided).

The timestamp in the TFTP configuration file is formatted as follows:

<month (01-12)>/<day(01-31)>/<year(0000-9999)> <space> <hour(01-23)>:<minute(01-59)>:<second (01-59)>

or as a raw value, such as a hexadecimal number (beginning with "0x"), representing the number of seconds since 1/1/70.

If you are configuring the timestamp in the TFTP Manage message, see the message format in the API Reference for the format of the Timestamp ICB subtype.

Sample TFTP Configuration File

The following is an example of a TFTP configuration file.

Important! If using the TFTP Manage message to initiate the download, the timestamp must be included in either the TFTP Manage message or the TFTP configuration file, but not both.

EXCPU_LOAD=c:\tftpboot\ELX0800073\MTX0800073.BIN=SAVE_LOAD_TRUE

ST1LC_LOAD=c:\tftpboot\ELX0800073\ST10800073.BIN=SAVE_LOAD_FALSE

SE1LC_LOAD=c:\tftpboot\ELX0800073\SE10800073.BIN=SAVE_LOAD_FALSE

SJ1LC_LOAD=c:\tftpboot\ELX0800073\SJ10800073.BIN=SAVE_LOAD_FALSE

SS7PQLC_LOAD=c:\tftpboot\ELX0800073\SPQ0800073.BIN=SAVE_LOAD_FALSE

ISDN32_LOAD=c:\tftpboot\ELX0800073\ISD0800073.BIN=SAVE_LOAD_FALSE

DS3_LOAD=c:\tftpboot\ELX0800073\DS30800073.BIN=SAVE_LOAD_FALSE

EXNTONE_LOAD=c:\tftpboot\ELX0800073\EX10800073.BIN=SAVE_LOAD_FALSE

DSPONE_LOAD=c:\tftpboot\ELX0800073\DSP0800073.BIN=SAVE_LOAD_FALSE

VOIPMOD_LOAD=c:\tftpboot\ELX0800073\VMD0800073.BIN=SAVE_LOAD_FALSE

VOIPMBRD_LOAD=c:\tftpboot\ELX0800073\MBR0800073.BIN=SAVE_LOAD_FALSE

ONELC_LOAD=c:\tftpboot\ELX0800073\TE10800073.BIN=SAVE_LOAD_FALSE

SS7HPLC_LOAD=c:\tftpboot\ELX0800073\SHP0800073.BIN=SAVE_LOAD_FALSE

TIMESTAMP=09/27/01 10:30:15

Using the TFTP Manage Message

The TFTP Manage message is used to initiate a download of system software, update download information, and query the TFTP Configuration.

Initiating a Download

Send the TFTP Manage message to the CSP with the following information:

• Local Matrix Controller configuration filename (Data ICB Subtype 0x37)

• Local Matrix Controller server IP address (Data ICB Subtype 0x38)

• Adjacent Matrix Controller configuration filename (Data ICB Subtype 0x39)

• Adjacent Matrix Controller server IP address (Data ICB Subtype 0x39)

• Timestamp (Data ICB Subtype 0x3B) (if not included in the TFTP Configuration File)

• Begin Download (Action ICB Subtype 0x00)

See the API Reference for the format of the TFTP Manage message.

Important! The term "Local" refers to the Matrix Controller to which you are downloading the files.

Updating Information

If you are simply updating information (such as configuration filename or Server IP address) but not downloading a new version of system software, send the relevant data ICBs but do not send the Begin Download action ICB.

Querying TFTP Configuration

You can use the TFTP Manage message to query the following information:

• Local Matrix Configuration Filename

• Adjacent Matrix Configuration Filename

• Local Matrix Server IP Address

• Adjacent Matrix Server IP Address

• Timestamp

• Save Options

• Load Version

• Load Filename

Each query option is performed by inserting the appropriate action ICB into the TFTP Manage message. The response contains an ICB with the relevant data for the query. See the TFTP Manage message in the API Reference for ICB values and a sample message trace.

The Matrix Controller Series 3 card is based on Motorola’s 750 PowerPC processor (68750). It is often referred to as the Matrix Controller.
Digital Signal Processor
See Signaling System Number Seven.
See Integrated Services Digital Network.
See Basic Rate Interface.
Excel's open architecture, proprietary, 1.3 Gbps fiber optic network using a packet-based protocol.
Internet Protocol. Part of the TCP/IP family of protocols used to route messages and tracks the addresses of nodes.
ITU-T standard defines a set of call control, channel setup, and codec specifications for transmitting real-time voice and video over networks that do not offer guaranteed service or quality of service.
Boot protocol for TCP/IP
See Information Control Block.
A 32-bit address, used in IP routing, which includes a Network address identifier assigned by a central authority and a Host ID (an end station identifier assigned by a LAN administrator).