The ASAM XIL Steps for NI TestStand are sets of custom steps that allow you to reuse test sequences developed for other hardware-in-the-loop (HIL) systems that use the ASAM XIL API.
This document describes how to download these steps and provides reference information for each step. For information on new features on each release, refer to the ASAM XIL TestStand Steps Release Notes.
This product is available for download from the ASAM XIL Steps for NI TestStand download page. Follow the prompts from NI Package Manager to install the product.
ASAM XIL TestStand Steps 2024 Q1 supports the following application software versions, including service packs. If you are not using NI application software, refer to Microsoft Visual Studio Support.
Application Software | Versions Supported by ASAM XIL TestStand Steps 2024 Q1 |
---|---|
TestStand | 2020, 2021, 2022, 2023 |
VeriStand | 2021, 2023, 2024 |
Use the Open VeriStand Project step to create a reference to an existing NI VeriStand project. You can use this reference in subsequent steps, such as Framework Create and Target Script Create.
Note: You must have NI VeriStand installed in order to use this step.
Configuring the Step
Use the Open VeriStand Project edit tab in the TestStand Sequence Editor to configure the Open VeriStand Project step.
Step Properties
In addition to the custom result properties, the OpenVeriStandProject step type defines the following step properties:
Use the Framework Create step to create a new instance of the ASAM XIL framework.
Configuring the Step
Use the Framework Create edit tab in the TestStand Sequence Editor to configure the Framework Create step.
Step Properties
In addition to the custom result properties, the Framework Create step type defines the following step properties:
Note: These variables are dynamic and are only created if the user sets values for the corresponding panel controls.
Use the Framework Set Variable Values step to specify the value(s) for the available variable(s) from the specified Framework.
Configuring the Step
Use the Framework Set Variable Values edit tab in the TestStand Sequence Editor to configure the Framework Set Variable Values step.
Step Properties
In addition to the custom result properties, the Framework Set Variable Values step type defines the following step properties:
Use the Framework Get Variable Values step to acquire the current value of the selected Framework variables.
Configuring the Step
Use the Framework Get Variable Values edit tab in the TestStand Sequence Editor to configure the Framework Get Variable Values step.
Step Properties
In addition to the custom result properties, the Framework Get Variable Values step type defines the following step properties:
Use the Framework Clean Up step to destroy a Framework object.
Configuring the Step
Use the Framework Clean Up edit tab in the TestStand Sequence Editor to configure the Framework Clean Up step.
Step Properties
In addition to the custom result properties, the Framework Clean Up step type defines the following step properties:
True | NI TestStand ignores any errors that occur and destroys the reference to the Framework object. |
---|---|
False | Errors can occur and prevent NI TestStand from destroying the reference to the Framework object. |
Use the Target Script Create step to specify the target script object to run a VeriStand RT sequence.
Configuring the Step
Use the TargetScriptCreate edit tab in the TestStand Sequence Editor to configure the Target Script Create step.
Step Properties
In addition to the custom result properties, the Target Script Create Step defines the following step properties:
Use the Target Script Set Parameter Values step to specify the value(s) for the input parameters available in the script file specified for the referenced Target Script Create step.
Configuring the Step
Use the Target Script Set Parameter Values edit tab in the TestStand Sequence Editor to specify the input parameter(s) you want to set values for and the values you want to set them to.
Step Properties
In addition to the custom result properties, the Target Script Set Parameter Values Step defines the following step properties:
Use the Target Script Get Parameter Values step to acquire the current value of the RT sequence output parameters.
Configuring the Step
Use the Target Script Get Parameter Values edit tab in the TestStand Sequence Editor to specify the target script and outputs for which you want to acquire values.
Step Properties
In addition to the custom result properties, the Target Script Get Parameter Values Step defines the following step properties:
Use the Target Script Load to Target step to transfer the script to the RT target.
Configuring the Step
Use the Target Script Load To Target edit tab in the TestStand Sequence Editor to specify the target script you want to load to your hardware.
Step Properties
In addition to the custom result properties, the Target Script Load to Target defines the following step properties:
Use the Target Script Start step to run the script on the target.
Configuring the Step
Use the Target Script Start edit tab in the TestStand Sequence Editor to specify the target script you want to start.
Step Properties
In addition to the custom result properties, the Target Script Start step defines the following step properties:
Use the Target Script Wait for State step to wait to execute the step until the target reaches the first state you specify.
Note: If the target script is already in the state you specify in this step when this step begins, no wait occurs.
Configuring the Step
Use the Target Script Wait For State edit tab in the TestStand Sequence Editor to specify the target script, the configuration state(s) you want the script to wait for, and the amount of time you want the script to wait.
Step Properties
In addition to the custom result properties, the Target Script Wait for State step defines the following step properties:
Use the Target Script Pause step to suspend execution of the script on the target.
Configuring the Step
Use the Target Script Pause edit tab in the TestStand Sequence Editor to specify the target script you want to pause.
Step Properties
In addition to the custom result properties, the Target Script Pause step defines the following step properties:
Use the Target Script Stop step to end the execution of the script on the target.
Configuring the Step
Use the Target Script Stop edit tab in the TestStand Sequence Editor to specify the target script you want to stop.
Step Properties
In addition to the custom result properties, the Target Script Stop step defines the following step properties:
Use the Target Script Destroy on Target step to remove a target script object from the hardware. Subsequent steps will be able to reference the removed script.
Configuring the Step
Use the Target Script Destroy on Target edit tab in the TestStand Sequence Editor to specify the target script you want to remove from the hardware.
Step Properties
In addition to the custom result properties, the Target Script Destroy On Target step defines the following step properties:
Use the Target Script Clean Up step to delete a target script object. If the script is loaded to a RT target, it will be removed from the hardware. Subsequent steps will not be able to reference the removed script. Use the Target Script Clean Up step at the end of a test sequence to conserve resources.
Configuring the Step
Use the Target Script Clean Up edit tab in the TestStand Sequence Editor to specify the target script you want to remove from the hardware. The specified target script object will also be deleted.
Step Properties
In addition to the custom result properties, the Target Script Clean Up step defines the following step properties: