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. |