Creating a Waveform Custom Step Type and Adding Information to the ASCII Report

Publish Date: Mar 09, 2018 | 15 Ratings | 2.13 out of 5 | Print | 3 Customer Reviews | Submit your review

Overview

This tutorial demonstrates how to create a custom step type that makes use of LabVIEW Substeps. Before starting, it is important to differentiate between the terms step and step type. A sequence developer creates (instantiates) steps of a particular step type in a sequence file. This is analogous to creating a variable of an integer or Boolean data type. Sometimes, the default step types do not provide the necessary features for a test application. TestStand allows you to create custom step types for your application.

The step type you create in this tutorial is similar to the Numeric Limit Test step type, with a couple exceptions:
  • The code module must return a numeric array to a step property, Step.Waveform.
  • A Post Substep, rather than the Status Expression, is used to evaluate the status.
  • This step type contains a custom step property, Step.Result.RMSvalue, which you will display in the report.

See Creating a Waveform Custom Step Type and Adding Information to the ASCII Report -- example VIs, for LabVIEW VIs that compliment this entry.

Table of Contents

  1. Setting Up the Example
  2. Creating the Waveform Step Type
  3. Configuring the Waveform Step Type Properties
  4. Creating a Step from the Waveform Step Type
  5. Including Step.Result.RMSvalue in the Text Report
  6. Testing
  7. Summary

1. Setting Up the Example

Create a new directory named Waveform in your <TestStand Public>\Components\StepTypes directory if using TestStand 4.1 or later.  If you are using TestStand 4.0 or earlier, create the new directory in your <TestStand>\Components\USER\StepTypes directory.  Copy the contents of the zip file for this tutorial to your new directory. This zip file contains EditLimits.vi which displays an edit dialog box and SetStatus.vi which sets the step status. The zip file also contains Get Waveform.vi which is the code module that the step calls. Get Waveform.vi creates a sinusoidal waveform and returns the waveform to the step property, Step.Waveform. The zip file also contains Start Modal Dialog.vi and End Modal Dialog.vi which are used in the Edit substep.

 

Back to Top

2. Creating the Waveform Step Type

1. In the TestStand Sequence Editor, click the Type Palette button  in the toolbar, or select View » Types to bring up the Types window.

If you create the custom step type in the Type Palettes section of the Types window, it will be available in all sequence files. You can also create a step type in the Sequence File Types view by selecting an opened sequence file underneath the Sequence Files section of the Types window.

However, a step type that is created in a sequence file will only be available in that sequence file. Of course, you can copy that step type to the Type Palette or to other sequence files.

2. Under the Type Palettes section, select MyTypes.ini, and then right-click in the right pane underneath Step Types and select Insert Step Type from the context menu.


Name the new step “Waveform” as shown below.

3. Click the  button next to the Waveform step type to expand its properties, and then right-click on the child item of the step type labeled <Right click to insert Field> and select Insert Field » Container from the right-click menu.  Name the container “Limits”.


4. Expand the Limits container, and right-click beneath it and select Insert Field » Number to create two new numeric fields within the Limits container.  Name them “High” and “Low”, as shown below.  You can assign initial values to Limits.High and Limits.Low properties, if you like.




5. Under the Waveform step type, create a new numeric array property. Leave the default values for the array in the Array Bounds popup dialogue, and name the array “Waveform”.

6. Under the Waveform step type, create a new string property. Name the string property "Comp". Give the string property a default value of “GELT” which corresponds to Greater than or Equal – Less Than. This matches LabVIEW’s In Range function which is used in the SetStatus.vi. The Comp property will be used to evaluate the precondition when the report includes the high and low limits.

7. Under the Result container of the Waveform step type, insert a new numeric property and name it RMSvalue. When the step executes, the TestStand engine automatically copies any step properties under the Result container to the ResultList. The report generation sequence creates the report from the entries in the ResultList. Later in this tutorial, you will modify the report generation sequence to include RMSvalue in the report.

8. Your new step type properties should appear as shown below.




9. Save the Type Palette.  If you get a prompt like the one shown below, select Do Not Increment Type Versions and Remove Modified Mark From Types and click OK.

 

Back to Top

3. Configuring the Waveform Step Type Properties


1. In the Type Palette, right-click on the Waveform step type in the right pane and select Properties from the context menu. This displays the Step Type Properties dialog box. The Step Type Properties dialog box is for configuring the properties, code modules, and default actions for a step type. For more information on the Step Type Properties dialog box, refer to Chapter 13 of the TestStand Reference Manual.

You will now examine several tabs and configure the properties for the new step type.

General Tab

This tab contains the default name, description, icon, and adapter type associated with a step type.

2. In the Default Step Name Expression control, enter “Waveform”, as shown below. When a step is created from this custom step type, it will have this default name. The sequence developer can later change the name of the step.




3. In this tutorial, leave the Step Description Expression as “%ModuleDescription”. When a step of this step type is created, the description will be the name of the code module that the step calls.

4. For this example we will not designate an adapter. If you designate an adapter for this step type, any steps created from this step type would be restricted to use the specified adapter. If you were to designate an adapter, you could further restrict the step type to call a specific code module of your choice. If you did not want to call any code module from your step type, you could select None for the adapter. If you wanted to prevent sequence developers from specifying a different code module, you could go to the Disable Properties tab and check Specify Module

Menu Tab

5. Click on the Menu tab. The Menu tab specifies the text that appears in the Insert Step context menu when a step is inserted into the sequence file. Enter "Waveform" in the Item Name Expression control, as shown below.



Substeps Tab

The Substeps tab specifies substeps for the step type. It is possible to call code modules as Pre-Steps and Post-Steps for each step type. This is not the same code module that can be specified for each step instance. The sequence developer cannot customize the substeps for a particular step. If a Pre-Step or Post-Step Substep is specified, that code module is called at every execution in every instance of the step type. During execution, TestStand calls the Pre-Step substep before calling the step module and the Post-Step substep after calling the step module. You can use any of the TestStand adapters when specifying code modules in the Substeps.

The default step types use the Status Expression to set the step status at run time. In this tutorial, you will use the Post-Step Substep to set the step status of the Waveform step type.

6. On the Substeps tab, select LabVIEW from the Adapter pull-down ring, and then click Add… » Post-Step.

7. With the newly created Post-Step Substep selected, click Specify Module…. In the Edit LabVIEW VI Call dialog box, click the Browse For VI... button  and browse for Set_Status.vi in the <TestStand Public>\Components\StepTypes\Waveform directory if using TestStand 4.1 or later, or from the <TestStand>\Components\USER\StepTypes\Waveform directory if using TestStand 4.0 or earlier. If prompted, select Use a Relative Path for the file shown above. Click OK to return to the Edit LabVIEW VI Call dialog box.

The diagram of SetStatus.vi is shown below where the RMS Value of the waveform is compared to the high and low limits. If the RMS Value is within the high and low limits, the status is set to Passed, otherwise the status is set to Failed.



Click OK to exit the Edit LabVIEW VI Call dialog.

8. On the Substeps tab, click Add… » Edit to create an Edit Substep, and name the substep “Edit Limits”.

9. Click Specify Module… to bring up the Edit LabVIEW VI Call dialog.
10. In the Edit LabVIEW VI Call dialog, click the Browse For VI... button  and browse for Edit_Limits.vi in the <TestStand Public>\Components\ StepTypes\Waveform directory (<TestStand>\Components\USER\StepTypes\Waveform if using TestStand 4.0 or earlier). If prompted, select Use a Relative Path for the file shown above, and click OK to return to the Edit LabVIEW VI Call dialog box. Click the Show VI Front Panel button so that it is enabled . This way the Edit Limits.vi will open its front panel when running, so that the user can interact with the VI to configure the step.



The Edit_Limits.vi is shown below. All edit substeps must be modal to the sequence editor.  Refer to How Can I Change the Modality of My Front Panel? for additional information.


Click OK to exit the Edit LabVIEW VI Call dialog.

Disable Properties Tab

The Disable Properties tab allows you to prevent sequence developers from modifying certain step properties. In this example, you will prevent sequence developers from setting a Status Expression because that would override the status the Post-Step Substep sets.

11. Check Status Expression in the Disable Properties tab.


12. Click OK to close the Waveform Step Type Properties dialog box and save the Type Palette.

13. Click File » Save from the menu bar.  If you get a warning about modified types, select Do Not Increment Type Versions and Remove Modified Mark From Types and click OK.

Back to Top

4. Creating a Step from the Waveform Step Type


1. Create a new sequence file by selecting File » New Sequence File from the menu bar.  

2. Change the adapter to LabVIEW in the Selected Adapter pull-down ring menu.


3. Drag the Waveform step type from the Insertion Palette, and drop it into the Main step group of MainSequence in your sequence file.



4. On the Waveform tab of the Step Setting pane, click the Edit Limits button to bring up the Edit Limits VI. 

Set the High Limit to 1.0 and the Low Limit to 0.0 and click OK.

5. Switch to the Module tab in the Step Settings pane, and click on the Browse for VI… button  and select Get_Waveform.vi from the <TestStand Public>\Components\StepTypes\Waveform directory for TestStand 4.1 or later, or <TestStand>\Components\USER\StepTypes\Waveform directory for TestStand 4.0 or earlier.

Get_Waveform.vi will pass a sinusoidal waveform to Step.Waveform. At run time, the user specifies the amplitude and number of cycles for the waveform.

6. Click the Show VI Front Panel button   so that it is enabled .  This way the VI's front panel will allow the user to specify the characteristics of the waveform at run time.

When you run your sequence, the status will be Passed if the RMS Value is greater than or equal to the Low Limit and less than the High Limit. The report includes the limits because the default process model calls the Include Limits in Results step. The report also includes the comparison property, Comp, because the default process model calls Include Comparison Type in Results. However, Step.Result.RMSvalue is not included in the report. You will include this in the next section.

Back to Top

5. Including Step.Result.RMSvalue in the Text Report


In this section, you will modify the text report generation sequence in the TestStand process model. If you do not want to modify the process model, you can use the ModifyReportEntry callback. Refer to the solution to this tutorial which uses the ModifyReportEntry callback.

1. Select Configure>>Results Processing from the menu bar, and select the Options... button from the Report row of the Results Processing window to bring up the Report Options dialog.

2. In the Report Options Dialog, select ASCII Text File from the Report Format pull-down ring menu.


3. In the Select a Report Generator for Producing the Report Body section, select Sequence

As you may know, the report body may be generated in either a DLL or a sequence, but this tutorial does not discuss modifying the DLL. If you want to ensure that the report body is always generated with a sequence, you may use a ReportOptions callback. For more information, refer to the solution to this tutorial.

4. Click OK to close the Report Options dialog box.

5. Do not modify the default process model. Make a copy of the default process model and modify the copy. To copy the process model, use Windows Explorer and browse to <TestStand>\Components\Models\ if using TestStand 4.1 or later, or <TestStand>\Components\NI\Models if using TestStand 4.0 or earlier. Select and copy the TestStandModels folder. Next, browse to the <TestStand Public>\Components\Models\ directory if using TestStand 4.1 or later, or the <TestStand>\Components\USER\Models\ directory if using version 4.0 or earlier. Paste the TestStandModels folder that you just copied. If the TestStandModels directory already exists, delete it or move it to a temporary directory. By default, TestStand will use files from the <TestStand Public> directory before those kept in the <TestStand> directory.

6. In the Sequence Editor select File » Open File…, and navigate to <TestStand Public>\Components\Models\TestStandModels\ (<TestStand>\Components\USER\Models\TestStandModels\ for TestStand 4.0 or earlier) and open the ReportGen_txt.seq file. This sequence file generates the text report.  

7. Select the PutOneResultInReport sequence from the Sequences pane.


Each time the PutOneResultInReport sequence executes, it adds a single step result entry to the report. For every step result in the main sequence, this sequence is executed.

8. Expand the Parameters container in the Variables pane to see that the details of the report are passed in the Result container, as shown below. Data is placed into this container during execution. Each Statement step (e.g. Add Step Name and Status step) in this sequence adds a string to the local string variable Locals.ReportEntry.  After this sequence executes, the completed ReportEntry is returned to the calling sequence.


9. In the Main step group of the PutOneResultInReport sequence, double click on the sequence call step Call PutOneResultInReport_lmpl. From there, right-click on the Add Flagged Values step, and select Insert Step » Statement to insert a statement step.  Name the new step “Add RMS Value”.

10. In the Step Settings pane for the step, select the Expression tab, and enter the expression for the step as follows:

Locals.ReportEntry += Parameters.DetailsIndentation + "RMS Value: " + Str(Parameters.Result.RMSvalue) + "\n"


11. In the Properties tab of the Step Settings pane for the step, select Preconditions.  In the Precondition Expression, enter the expression as shown below:

Parameters.ReportOptions.IncludeMeasurements && PropertyExists("Parameters.Result.RMSvalue")

This precondition ensures that this step executes only if Parameters.Result.RMSvalue exists and the user has selected the Include Measurements report option.

Notice that the Preconditions for the Add High Limit and Add Low Limit steps refers to the Comp step property. This is the primary reason that you added the Comp property to the Waveform step type. If you did not add the Comp property, the preconditions for Add High Limit and Add Low Limit would not have allowed these steps to execute and include the limits in the report.

12. Save ReportGen_txt.seq.

When you run your new sequence file, you should see the RMS Value included in the text report.

Back to Top

6. Testing


1. Go back to the sequence file you created with the Waveform Step Type, and run the sequence by selecting Execute » Single Pass from the menu bar.

2. When the Get_Waveform.vi front panel appears, configure the waveform to have an amplitude of ~1, and click Done.

3. Observe in the report that the step result is “Passed” and that the RMS Value included in the report is within the limits that we previously defined (0 .0 to 1.0).

4. Run the sequence again, only this time changing the waveform so that its RMS value is outside of the defined limits, and verify that the result of the step is “Failed”.

 

Back to Top

7. Summary


You may refer to the attached solution.  The sequence file included in it uses a different name for the step type.  You can apply the concepts used in this tutorial when you create your own step types.

Back to Top

Customer Reviews
3 Reviews | Submit your review

Tutorial for newer TS?  - Aug 1, 2017

Hi Where can I find a tutorial like this that is covering TS16? Please. Thanks in advance Bjarne

Missing required files  - Nov 3, 2015

Step 7 in section 3 refers to Set_Status.vi. This VI is not included in the download.

Update to TS 3.5 & 4.0  - May 21, 2007

Anyone using a newer version of TestStand will not be able to follow this tutorial, due to the fact the dialog boxes have changed.

Bookmark & Share


Downloads


Ratings

Rate this document

Answered Your Question?
Yes No

Submit