Return values

The following table lists the values that can be returned from TxLoader. These return values are defined in the cplot.h include file.

In addition to the return values listed in the table, it is also possible to receive a CPI error code that is transparently passed back to the calling function. CPI error codes are defined in txcpi.h and can be differentiated from loader errors as follows:

if (error >= CPI_ERRCODE_BASE)
<handle as CPI error code>
else
<handle as loader error>

 

Return value

Description

TXLDERR_CPI

CPI library returned an error that was not transparently passed back to the calling function.

TXLDERR_OPEN

Unable to open the task load file specified in loadfile.

TXLDERR_TRUNC

Truncated load file detected. The task load file header indicates more data than the file actually includes.

TXLDERR_INVALID

Invalid load file detected. The task load file either is not a loadable object file or is corrupt.

TXLDERR_XFER

Error occurred while transferring a code block to the TX board.

TXLDERR_EXISTS

Task of the name specified in task_name already exists on the TX board.

TXLDERR_CREATE

Unable to create the task on the TX board.

TXLDERR_NOMEM

Insufficient memory on the host system to complete the load request.

TXLDERR_CPMEM

Unable to obtain the required TX-board based memory.

TXLDERR_CLOSING

Error while closing the load file.

TXLDERR_TASKPC

Error while setting the task’s program counter.

TXLDERR_BADFUNC

Unknown kernel function requested.

TXLDERR_DRVINIT

Unable to access the TX device driver.

TXLDERR_CHANNEL

Unable to obtain the communications channel used for task loading.

TXLDERR_BADTYPE

Unknown type of TX board reported.

TXLDERR_TASKNAME

Invalid task name specified in taskname.

TXLDERR_TSKSTART

Error when attempting to start the task.

TXLDERR_MAXFRAG

Number of code fragments in the load file exceeds the maximum allowed.

TXLDERR_FRAGHDR

Bad fragment header detected in the load file.

TXLDERR_DPR

Anomaly detected in the dual-port-ram communication.