Test Program Generator

V93K SMT7 API

This guide covers aspects of the V93K program generator API that are unique to SmarTest 7.

Be sure to also consult the V93K Common API guide which is also applicable to SMT7.

The SMT7 API is enabled by default when instantiating a V93K test environment:

# environment/v93k_smt7.rb
OrigenTesters::V93K.new

SmarTest comes with a standard AC and DC test method library and Origen provides a built-in API to generate a test flow which uses those test methods, here are some examples:

# Execute a functional test
test_method = test_methods.ac_tml.ac_test.functional_test

# A basic DC voltage measurement
test_method = test_methods.dc_tml.dc_test.general_pmu force_mode: 'CURR', force_value: 100.uA

Generally the parameter naming is the lower-cased and underscored version of the name that appears in the SMT documentation.

See the DC library API and the AC library API for up-to-date details of the implemented test methods and the parameter names.

However, some of these test methods are not particularly good and the recommendation from Advantest these days is generally not to use them.

Since that means there is now a void where a universally available test method library should be, work is underway to provide an Origen standard test method library. The aim of this is to provide a complete generation solution from Origen so that those who have a fairly conventional use case can rapidly build a complete test program from off-the-shelf components, but that is still a work in progress and not yet ready for prime time use.

Many users of the V93K program generator however, are likely to want to use it in combination with their own custom test method library, see how to define one here.

By default, a top-level Flow.create call in Origen will generate a standalone V93K testflow file which is internally wrapped by a flow group, like this:

group <FLOW_NAME> {
  // Flow content here
}

When such flows are imported into a master flow file, SmarTest does not provide a standard enable mechanism to control which sub-flows are executed.

However, Origen provides the ability to generate V93K flow modules with an enable-word wrapper, thereby allowing the top-level flow to easily enable/disable the execution of flow modules via flow variables.

By enabling this feature in the target like this:

OrigenTesters::V93K.new(add_flow_enable: :enabled)

the flow will now generate like this:

group <FLOW_NAME> {
  if @<FLOW_NAME>_ENABLE == 1 {
    // Flow content here
  }
}

The @<FLOW_NAME>_ENABLE variable will be initialized to 1 in the generated variables file for the given flow, meaning that the module will run by default if the top-level flow does nothing with this variable.

Alternatively, the variable can be initialized to off like this:

OrigenTesters::V93K.new(add_flow_enable: :disabled)

Meaning that by default, the module will not run and the top-level flow must always enable it by including @<FLOW_NAME>_ENABLE = 1 before hitting the module.

Setting this attribute in the target means that it will apply to all flows. Alternatively, it can be set within the flow itself (or the interface) if it is necessary to use this feature for only a subset of flows, or to override the default setting for a particular flow.

Here is an example:

Flow.create interface: 'MyApp::Interface' do

  # Ensure that this flow is always generated with an enable word wrapper that is enabled by default
  self.add_flow_enable = :enabled

  # Some functional test
  func :blah
end

This same API may be used to implement similar features on other platforms in future, but for now only the V93K is implemented.

Test (suite) naming collisions can occur when importing multiple independent test flow modules into a V93K master flow file.

To prevent that from ever occurring, Origen will generate and append a unique signature to the end of all test names by default, for example:

t = test_suites.add("my_test_name", options)

t.name   # => "my_test_name_E32ABE8"

Applications can override this default behavior by setting the corresponding test interface attribute, unique_test_names, to one of the following values:

• :signature - this is the default which will generate a unique signature as shown in the above example
• nil - no value will be appended to the test names at all
• :flowname - the name of the current top-level flow will be appended to all test names
• Setting this attribute to any other value will append that value directly to all test names

This attribute can be set in the environment file when instantiating the tester:

OrigenTesters::V93K.new unique_test_names: nil

This provides a single place to control the behavior within a monolithic application architecture.

However, under a distributed application architecture a given test flow module may be generated under a target/environment that is controlled by a 3rd party.

In that case, it is recommended to either set it at the flow-level, which will override any setting set at the environment-level:

# program/wt1_start.rb
Flow.create interface: 'MyApp::Interface', unique_test_names: 'wt1' do

end

Or, it can be set directly within your interface logic which will take the highest precedence:

# lib/my_app/interface.rb
self.unique_test_names = :flowname