XJTAG logo
Open search box button
Close search button

TEST_DETAILS_PINS_LINK

The TEST_DETAILS_PINS_LINK function is part of the TEST_DETAILS output framework and prints a hyperlink for a set of devices in the test output, that enables the pins to be visualised in the application.. It is defined and used the same way as PRINT_PINS_LINK but outputs to the test details section instead of being printed immediately as part of the normal test output. A single pin can be linked to using TEST_DETAILS_PINS_LINK.

TEST_DETAILS_PINS_LINK was added in XJTAG v3.1.0.

Syntax

TEST_DETAILS_PINS_LINK( STRING text, STRING pinReference, ... )

Parameters

text
The text to print for the link.
pinReference

One or more strings that identify a pin in the netlist in the form 'board.component.pin'. These may be strings returned from the GET_PIN function. The board name is optional, but each pin reference must uniquely identify a pin, so if there is any ambiguity with the device reference, then the board name must be supplied.

Errors

An error can occur in the following circumstances:

  • The device referenced by any pinReference does not match a device in the project.
  • The pin referenced by any pinReference does not exist on the device.
  • Any pinReference supplied does not contain a board name and matches more than one device.

In both these cases, if the expressions are constant, the error will occur at compile-time. Otherwise, the error will occur at run-time, when the function is run.

See Also