XJTAG logo
Open search box button
Close search button

PRINT_NETS_LINK

The PRINT_NETS_LINK function prints a hyperlink for a set of nets in the test output, that enables the nets to be visualised in the application.

Links will only be displayed if ODB++ information is available for each board, otherwise just plain text is displayed.

This is similar to the function PRINT_NET_LINK. There is also an equivalent for the test details output: TEST_DETAILS_NETS_LINK.

XJDeveloper and XJInvestigator

If an ODB++ netlist is available for each board, left clicking the hyperlink will launch Layout Viewer and highlight all the nets. Right clicking the link will present the following options - Open in Layout Viewer, Add to Selection in Layout Viewer and Show in Schematic Viewer. If XJAnalyser is available and the net has a pin on a JTAG device, then there will also be a Show in Analyser option, which navigates to that pin in the Analyser screen.

XJRunner

Links will only be highlighted and clickable if ODB++ information is available for each board. In this case left clicking will launch Layout Viewer and highlight the nets. Right clicking the link will present the following options - Open in Layout Viewer, Add to Selection in Layout Viewer and Show in Schematic Viewer.

XJRun command line

No formatting will be applied.

Syntax

PRINT_NETS_LINK( STRING text, STRING netName, ... )

Parameters

text
The text to print for the link.
netName

One or more strings identifying a net in the form 'board.net', e.g. a string returned from GET_NET_FROM_PIN. The board name is optional, but each net name must uniquely identify a net, so if there is any ambiguity then the board name must be supplied.

Errors

If any netName supplied does not contain a board name and matches more than one net, then an error occurs. If the expression is constant, the error will occur at compile-time. Otherwise, the error will occur at run-time, when the function is run.

Examples

CONST STRING constNetA := "NetJP1_14";
STRING varNetB := "XJDemo.NetJP1_16";

// Single net
PRINT_NETS_LINK("One net\n", constNetA);

// Multiple nets
PRINT_NETS_LINK("Two nets\n", constNetA, varNetB);

// Multiple nets, using GET_NET_FROM_PIN
PRINT_NETS_LINK("DATA nets 0,1,2,3\n",
    GET_NET_FROM_PIN(DATA[0]), GET_NET_FROM_PIN(DATA[1]),
    GET_NET_FROM_PIN(DATA[2]), GET_NET_FROM_PIN(DATA[3]));

Output

One net
Two nets
DATA nets 0,1,2,3

See Also