XJAPI_SetPinMapFromFile

Select or change the pin mapping using a pin mapping description contained in a file. If the pin mapping file contains a test reset sequence then this will be setup too and run when XJAPI_Trst is called.

XJAPI_ERROR XJAPI_SetPinMapFromFile(
    const char *filename
);

Version

This function was added in XJTAG version 2.3.0 and so requires that XJAPI_VERSION be defined to be greater than or equal to 0x020300.

Arguments

filename

The file to open.

Return value

An XJAPI_ERROR value indicating whether the function call was successful or not.

Notes

XJAPI_HardwareSetup must be called before this function.

The number of pin mapping options for XJLink2-based JTAG controllers is very high, meaning that setting these options programmatically would be both impractical and prone to user error. The JTAG Chain Debugger tool is designed to allow pin mappings and test reset sequences to be easily and quickly set up, tested, and saved to file. This function allows such files to be used.