Using XJIntegration
XJIntegration allows a user’s own software to utilise the features of XJRunner and XJAnalyser. It comprises two components: XJRunner Integration, which allows pre-defined boundary scan tests to be integrated into a user’s code alongside their own functional test routines, and XJAnalyser Integration, which provides direct access to the pins of a JTAG-enabled device to allow them to be set and read.
An example application of XJAnalyser Integration is the control of a device’s pins to enable / disable a board’s power rails during testing; and to receive notifications if monitored pins change state. This provides engineers with flexibility when designing functional tests. XJRunner Integration could be used, for example, to reduce test time by allowing a user’s code to perform a set of boundary scan tests while the software controls other types of test that are running elsewhere on the board.
XJIntegration has been written for C#, Visual Basic and other .NET environments, and works with test executives such as National Instruments’ LabVIEW™, TestStand™ and LabWindows™/CVI. It is available to any user with an XJTAG system that includes XJAnalyser and/or XJRunner respectively.
In this user guide, the basic principles of XJIntegration are explained. The user is introduced to the most important classes and methods, and VI and C# examples are used to illustrate the different points. The examples used come from those included in the XJTAG installation, which users can freely use and edit in their own code.
- To use the example LabVIEW VIs, it is important to EITHER reference the VI in its original installed location OR copy the entire set of XJTAG VIs to your desired location; do not just copy and paste an individual VI into your own project.
- XJAnalyser Integration was introduced in XJTAG 3.9. Previous software versions only include the functionality of XJRunner Integration.
- Due to changes introduced in XJTAG 3.9, users with projects created using the XJRunner .NET Integration from earlier software versions will need to make changes to ensure the project continues to work correctly. These are detailed in the XJTAG Help files.
- XJIntegration is built using .NET Framework version 4.8; it can only be used with C# projects that are built against .NET Framework version 4.8 or later. It cannot be used in projects built against any version of .NET Core or .NET 5 or later. It is not compatible with TestStand 2024 Q4 and later.
Structure of this User Guide
The following items are described:
- LabVIEW 32- and 64-bit configurations
- Important principles for running tests
- Creating an XJLink instance
- How to work with projects
- How to run tests
- Dealing with tests with conditions that define when they run
- The principles of using XJRunner Integration
- The principles of using XJAnalyser Integration
- Closing a project
- Cleaning up memory after use
- Examples of using XJRunner and XJAnalyser integrations
- Using the detailed API documentation
XJTAG v4.1.101