SMU/PPS - Read Measurement Step

Use the SMU/PPS - Read Measurement step to read, publish and return the voltage, current, and power measurement results for the specified SMU/PPS pins on all sites in the Pin Map context.

This step publishes measurement data for the specified pins to the ECU Multi Test step type instances with their module adapter configured as Sequence for all sites in the Pin Map context.

If the DCPowerMeasurementConfiguration.MeasureWhen property is set to DCPowerMeasurementWhen.OnDemand, this step reads measurements using the DCPowerMeasurement.Measure method. Otherwise, this step reads a measurement from the NI-DCPower buffer using the DCPowerMeasurement.Fetch method. You must call the SMU/PPS – Initiate step before calling this step while using the DCPowerMeasurement.Fetch method to obtain measurements.
Note The SMU/PPS - Read Measurement step must be used inside of an ECU Multi Test or ECU Action step with its module adapter configured as Sequence. The SMU/PPS - Read Measurement step requires the Pin Map context passed from these steps as an input.

Use the SMU/PPS - Read Measurement step edit tab in the TestStand Sequence Editor to specify the Pin Map context and the pins to query to obtain their associated NI-DCPower instrument sessions.

SMU/PPS - Read Measurement Step Settings Tab

The SMU/PPS - Read Measurement Step Settings tab contains the following options:
  • Pin Map Context—Specifies a reference to a Pin Map Context object. This object describes a subset of pins, sites, and instruments from the pin map file and provides data pertinent to each site executing during a test.
  • Pins—Specifies the pins to query to obtain their associated NI-DCPower instrument sessions. These instrument sessions are used to read voltage, current, and power measurements on the specified pins. The specified pins must be defined in the pin map file and included in the Pin Map context Pins and Relays list in the Options tab of the ECU Multi Test step.
    Note The SMU/PPS - Read Measurement step filters the pins specified by instrument type ID. If none of the pins specified have an instrument type ID of niDCPower, the step will do nothing, as none of the specified pins are connected to NI-DCPower instruments.
  • Timeout—Specifies the maximum time allowed for the DCPowerMeasurement.Fetch operation to complete. The default timeout is set to 5 seconds.
    Note This parameter is not used when the DCPowerMeasurementConfiguration.MeasureWhen property is set to DCPowerMeasurementWhen.OnDemand.
  • Published Data ID - Voltage— Specifies the unique ID for distinguishing measurements when you publish multiple measurements for a single pin within the same step or low-level sequence. The published data ID is represented as a constant string value. The default published data ID for SMU/PPS voltage measurements is Voltage.
  • Published Data ID - Current— Specifies the unique ID for distinguishing measurements when you publish multiple measurements for a single pin within the same step or low-level sequence. The published data ID is represented as a constant string value. The default published data ID for SMU/PPS current measurements is Current.
  • Published Data ID - Power— Specifies the unique ID for distinguishing measurements when you publish multiple measurements for a single pin within the same step or low-level sequence. The published data ID is represented as a constant string value. The default published data ID for SMU/PPS power measurements is Power.
  • Voltage—Specifies a location to store SMU/PPS voltage measurement results for the specified SMU/PPS pins on all sites in the Pin Map context.
  • Current—Specifies a location to store SMU/PPS current measurement results for the specified SMU/PPS pins on all sites in the Pin Map context.
  • Power—Specifies a location to store SMU/PPS power measurement results for the specified SMU/PPS pins on all sites in the Pin Map context.

    • The measurement results are organized as a two-dimensional array of Number values. Each array row corresponds to a pin, with the first row representing the first valid pin in the list of pins defined by Pins. Each array column corresponds to a site, with column indexes corresponding with the site order in the Pin Map Context. Use a two-dimensional array of Number values to store the measurement results for use in subsequent steps.