TEST_DETAILS_DEVICES_LINK

The TEST_DETAILS_DEVICE_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 devices to be visualised in the application. It is the same as PRINT_DEVICES_LINK, but outputs to the test details section instead of being printed immediately as part of the normal test output. A single device can be linked to using TEST_DETAILS_DEVICE_LINK.

TEST_DETAILS_DEVICES_LINK was added in XJTAG v3.1.0.

Syntax

TEST_DETAILS_DEVICES_LINK( text, deviceReference, ... )

Parameters

text
The text to print for the link.
deviceReference

One or more device references in the form 'board.device'. The board name is optional, but each device reference must uniquely identify a device; if there is any ambiguity, then the board name must be supplied.

Errors

An error can occur in the following circumstances:

  • Any deviceReference supplied does not match any test device in the project.
  • Any deviceReference 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.