Command-line switches

XJRun is invoked like so:

xjrun [SWITCHES] [FILENAME]

The FILENAME can be an XJPack file, XJDeveloper project file, XJEase circuit file, SVF file or STAPL file.

General options

-rec filename

The interactions with the circuit board may be recorded to a file, to aid in technical support.

-recsync filename

The same as -rec except data is not buffered but written to the record file immediately. This causes the system to run much slower.

-dir Directory

Specify a directory to change to before starting to run.

-version

Display the version of the application.

-h

Display help.

Controlling output

-log filename

Log all output to the specified file.

-stdout

Print all error messages to stdout rather than stderr.

-E warning

Treat warnings as errors, which will then cause syntax checking or compilation to fail. Either provide one or more warning numbers separated by commas, or use an asterisk to indicate that all warnings should be treated as errors.

-I warning

Don't display particular warnings. Either provide one or more warning numbers separated by commas, or use an asterisk to indicate that all warnings should be ignored.

-nowarn

Disable all warning messages.

Hardware configuration

-x serial

Specify the serial number of the XJLink to use.

-f frequency

Override any TCK frequency specified in the project or in the STAPL or SVF file. Use either a k or M suffix to specify a frequency in either kHz or MHz. The default is MHz if no suffix is given. Valid frequencies range from 100kHz to 60MHz.

-power

Power the target device via the XJLink.

-pinmap filename

Specify a custom XJLink pin mapping file. This will override any pin mapping specified in the project or included in the XJPack file.

-multiice

Use a Multi-ICE pin map.

-altera

Use an Altera ByteBlaster pin map.

--enable-all-external-hardware

Set all external hardware in the project to be included in testing, regardless of the project defaults.

--disable-all-external-hardware

Set all external hardware in the project to be excluded from testing, regardless of the project defaults.

XJEase projects

-testlist

Run all the functions in the XJRunner test list rather than the CircuitTest function.

-loop

Continually run all the functions in the XJRunner test list in a loop until a test fails or it execution is interrupted. This switch implies -testlist is also set.

-continue true/false

Continue running functions in the XJRunner test list upon test failure. The value specified will override the existing setting. If no value is set, it will default to true.

-set global=value

Override the initial value of a global variable. This argument may be specified more than once so more than one variable can be overridden.

-set board.device.variable=value

Override the initial value of a global variable defined in the device file for a particular device. The board name can be omitted if the device reference is unique across all boards in the project, or if there is only a single board. This argument may be specified more than once so more than one variable can be overridden.

-s

Verify the XJEase project and display any errors or warnings that are found. An XJEase licence is required to use this functionality.

-p

When running XJEase, display what JTAG pins are selected to read and write pins.

-v

Specify a variant to load from the project or XJPack file. If this argument is omitted then the root project is loaded.

XJPack files

-info

Output information about an XJPack file. This switch cannot be combined with any other switches.

STAPL files

-action

Action to run when processing a STAPL file. This switch is required when running a STAPL file.

-set global=value

Set the initial value of a global variable. This argument may be specified more than once so more than one variable can be set.

-l

List available actions in a file.

-verbose

Show verbose output when running.

SVF files

-verbose

Show verbose output when running.