origen_testers 0.51.4 → 0.52.0

data/templates/origen_guides/program/flowapi.md.erb

@@ -280,6 +280,9 @@ test :test2, if_flag: :my_pass_flag
 unless_flag :my_pass_flag do
   test :test3
 end
+
+log "Example of manually unsetting flag"
+test :test4, on_pass: { unset_flag :my_custom_flag1 }
 ~~~
 
 Note that flag names will usually be forced to uppercase, this is to institute a convention that
@@ -303,6 +306,14 @@ unless_enable "$MCEn_test" do
 end
 ~~~
 
+For custom environment libraries, there might be a need to reference a flag without using the native
+flag API. `add_flag` will allow the flow and sub-flow to have access to the flag without adding to the flow.
+
+~~~ruby
+log "Example of manually adding a flag to a flow without calling the flag"
+add_flag :my_custom_flag2
+~~~
+
 In all cases the `$` will be removed from the final flag name that appears in the test program.
 
 Whenever you set a flag or automation initializes a variable, you can remove the variable from initialization flow by labeling as a global flag
@@ -352,7 +363,7 @@ end
 ~~~
 
 
-#### Flow Loops for V93k (SMT7 only)
+#### Flow Loops for V93k
 Use flow loop control to permit re-running tests without using additional sequence labels.
 
 ~~~ruby
@@ -381,7 +392,21 @@ loop from: 0, to: 5, var: '$LOOP_VARIABLE', test_num_inc: 2 do
 end
 ~~~
 
+You can also provide a variable starting point:
+~~~ruby
+loop from: '$TEST_VARIABLE', to: 5, var: '$LOOP_VARIABLE' do
+    func :test_myloop6, number: 56600
+end
+~~~
+
 Decrementing loops, having `from:` value > `to:` value and using negative `step:`, is also supported.
+
+##### Loop Rules For Each Environment
+
+`SMT7` cannot support a variable stop location. Only the `from:` parameter is allowed to be a variable.
+
+`SMT8` cannot have a step other than -1 or 1. The limitations of the range flow restrict those steps.
+The `to:` parameter can be a flow variable just like `from:`.
  
 
 

data/templates/origen_guides/program/v93k.md.erb

@@ -74,6 +74,20 @@ or to assign a spec in SMT8:
 t.spec = 'my_spec_min'
 ~~~
 
+The default namespace and folder paths are determined by your environment with `tester.package_namespace` and
+`tester.spec_path`/`tester.seq_path` respectively. If you need to override these values for specific test suites
+you have the following available:
+
+~~~ruby
+# Overrides spec namespace and folder path
+t.spec_namespace
+t.spec_path
+# Overrides sequence and pattern namespace
+t.seq_namespace
+# Overrides sequence folder path
+t.seq_path
+~~~
+
 If the test method provides parameters, you can set them in the same way. As a convenience,
 Origen will automatically work out whether the reference is to a parameter of the test suite
 or of the test method, and will assign it accordingly.

data/templates/origen_guides/program/v93ksmt8.md.erb

@@ -103,10 +103,35 @@ flow Main {
 }
 ~~~
 
+#### Auxiliary Flows
 
+SMT8 utilizes auxiliary flows to perform recurring actions. `add_auxiliary_flow` API exists to symlink to a predefined auxiliary flow.
+This API does not allow variables to be passed to or from the auxiliary flow since they are stand alone flows.
 
+~~~ruby
+add_auxiliary_flow :POWERDOWN, 'testflow.POWERDOWN'
+~~~
+
+~~~java
+flow Main {
+    setup {
+        flow POWERDOWN calls testflow.POWERDOWN {}
+    }
 
+    execute {
+        POWERDOWN.execute();
+    }
+}
+~~~
 
+#### Flow Variable Grouping
 
+Sub-flow variable passing causes variables before and after the execution call to populate the flow.
+If you wish to have a collapse-able block for the variables, you need to set the flow_variable_grouping variable to true.
+
+~~~
+# add this line to your origen_site_config.yml
+flow_variable_grouping: true
+~~~
 
 % end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: origen_testers
 version: !ruby/object:Gem::Version
-  version: 0.51.4
+  version: 0.52.0
 platform: ruby
 authors:
 - Stephen McGinty
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2024-02-28 00:00:00.000000000 Z
+date: 2024-04-25 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: origen
@@ -601,7 +601,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.1.6
+rubygems_version: 3.2.3
 signing_key: 
 specification_version: 4
 summary: This plugin provides Origen tester models to drive ATE type testers like