origen_testers 0.4.0

data/program/prb1.rb

@@ -0,0 +1,226 @@
+# An instance of the interface is
+# passed in here, iterators and other
+# argument passing will be supported
+# similar to Pattern.create.
+Flow.create do
+
+  self.resources_filename = 'prb1'
+
+  # Instantiate tests via the
+  # interface
+  func 'program_ckbd', :tname => 'PGM_CKBD', :tnum => 1000, :bin => 100, :soft_bin => 1100
+  func 'margin_read1_ckbd'
+
+  # Control the build process based on
+  # the current target
+  if $dut.has_margin0_bug?
+    func 'normal_read_ckbd'
+  else
+    func 'margin_read0_ckbd'
+  end
+
+  # Include a sub flow, example of
+  # parameter passing
+  import 'erase', :pulses => 6
+
+  # Render an ERB template, or raw
+  # text file
+  if $tester.j750?
+    flow.render 'templates/j750/vt_flow', :include_tifr => true
+  end
+
+  log 'Should be v1'
+  func :program_ckbd
+  log 'Should be v2'
+  func :program_ckbd, :duration => :dynamic
+  log 'Should be v1'
+  func :program_ckbd
+  log 'Should be v2'
+  func :program_ckbd, :duration => :dynamic
+
+  log 'Should be a v1 test instance group'
+  func :program_ckbd, :by_block => true
+  log 'Should be a v2 test instance group'
+  func :program_ckbd, :by_block => true, :duration => :dynamic
+  log 'Should be a v1 test instance group'
+  func :program_ckbd, :by_block => true
+  log 'Should be a v2 test instance group'
+  func :program_ckbd, :by_block => true, :duration => :dynamic
+
+  # Test job conditions
+  func :p1_only_test, :if_job => :p1
+  if_job [:p1, :p2] do
+    func :p1_or_p2_only_test
+  end
+  func :not_p1_test, :unless_job => :p1
+  func :not_p1_or_p2_test, :unless_job => [:p1, :p2]
+  unless_job [:p1, :p2] do
+    func :another_not_p1_or_p2_test
+  end
+
+  log 'Verify that a test with an external instance works'
+  por
+
+  log 'Verify that a request to use the current context works'
+  func :erase_all, :if_job => :p1             # Job should be P1
+  func :erase_all, :context => :current    # Job should be P1
+  unless_job :p2 do
+    func :erase_all, :context => :current  # Job should be P1
+    func :erase_all                        # Job should be !P2
+  end
+
+  # Deliver an initial erase pulse
+  func :erase_all
+
+  # Deliver additional erase pulses as required until it verifies, maximum of 5 additional pulses
+  5.times do |x|
+    # Assign a unique id attribute to each verify so that we know which one we are talking about when
+    # making other tests dependent on it.
+    # When Origen sees the if_failed dependency on a future test it will be smart enough to inhibit the binning
+    # on this test without having to explicitly declare that.
+    func :margin_read1_all1, :id => "erase_vfy_#{x}"
+    # Run this test only if the given verify failed
+    func :erase_all, :if_failed => "erase_vfy_#{x}"
+  end
+
+  # A final verify to set the binning
+  func :margin_read1_all1
+
+  log 'Test if enable'
+  func :erase_all, :if_enable => 'do_erase'
+
+  if_enable 'do_erase' do
+    func :erase_all
+  end
+
+  log 'Test unless enable'
+  func :erase_all, :unless_enable => 'no_extra_erase'
+
+  unless_enable 'no_extra_erase' do
+    func :erase_all
+    func :erase_all
+  end
+
+  unless_enable 'no_extra_erase', :or => true do
+    func :erase_all
+    func :erase_all
+  end
+
+  log 'Test if_passed'
+  func :erase_all, :id => 'erase_passed_1'
+  func :erase_all, :id => 'erase_passed_2'
+
+  func :margin_read1_all1, :if_passed => 'erase_passed_1'
+  if_passed 'erase_passed_2' do
+    func :margin_read1_all1
+  end
+
+  log 'Test unless_passed'
+  func :erase_all, :id => 'erase_passed_3'
+  func :erase_all, :id => 'erase_passed_4'
+
+  func :margin_read1_all1, :unless_passed => 'erase_passed_3'
+  unless_passed 'erase_passed_4' do
+    func :margin_read1_all1
+  end
+
+  log 'Test if_failed'
+  func :erase_all, :id => 'erase_failed_1'
+  func :erase_all, :id => 'erase_failed_2'
+
+  func :margin_read1_all1, :if_failed => 'erase_failed_1'
+  if_failed 'erase_failed_2' do
+    func :margin_read1_all1
+  end
+
+  log 'Test unless_failed'
+  func :erase_all, :id => 'erase_failed_3'
+  func :erase_all, :id => 'erase_failed_4'
+
+  func :margin_read1_all1, :unless_failed => 'erase_failed_3'
+  unless_failed 'erase_failed_4' do
+    func :margin_read1_all1
+  end
+
+  log 'Test if_ran'
+  func :erase_all, :id => 'erase_ran_1'
+  func :erase_all, :id => 'erase_ran_2'
+
+  func :margin_read1_all1, :if_ran => 'erase_ran_1'
+  if_ran 'erase_ran_2' do
+    func :margin_read1_all1
+  end
+
+  log 'Test unless_ran'
+  func :erase_all, :id => 'erase_ran_3'
+  func :erase_all, :id => 'erase_ran_4'
+
+  func :margin_read1_all1, :unless_ran => 'erase_ran_3'
+  unless_ran 'erase_ran_4' do
+    func :margin_read1_all1
+  end
+
+  log 'Test if_all_passed'
+  func :erase_all, :id => 'erase_all_passed_1'
+  func :erase_all, :id => 'erase_all_passed_2'
+
+  func :margin_read1_all1, :if_all_passed => 'erase_all_passed_1'
+  if_all_passed 'erase_all_passed_2' do
+    func :margin_read1_all1
+  end
+
+  log 'Test unless_any_failed'
+  func :erase_all, :id => 'erase_all_passed_3'
+  func :erase_all, :id => 'erase_all_passed_4'
+
+  func :margin_read1_all1, :unless_any_failed => 'erase_all_passed_3'
+  unless_any_failed 'erase_all_passed_4' do
+    func :margin_read1_all1
+  end
+
+  log 'Test if_any_passed'
+  func :erase_all, :id => 'erase_any_passed_1'
+  func :erase_all, :id => 'erase_any_passed_2'
+
+  func :margin_read1_all1, :if_any_passed => 'erase_any_passed_1'
+  if_any_passed 'erase_any_passed_2' do
+    func :margin_read1_all1
+  end
+
+  log 'Test if_all_failed'
+  func :erase_all, :id => 'erase_all_failed_1'
+  func :erase_all, :id => 'erase_all_failed_2'
+
+  func :margin_read1_all1, :if_all_failed => 'erase_all_failed_1'
+  if_all_failed 'erase_all_failed_2' do
+    func :margin_read1_all1
+  end
+
+  log 'Test if_any_failed'
+  func :erase_all, :id => 'erase_any_failed_1'
+  func :erase_all, :id => 'erase_any_failed_2'
+
+  func :margin_read1_all1, :if_any_failed => 'erase_any_failed_1'
+  if_any_failed 'erase_any_failed_2' do
+    func :margin_read1_all1
+  end
+
+  log 'Verify that job context wraps import'
+  if_job :fr do
+    import 'erase'
+  end
+
+  log 'Verify that job context wraps enable block within an import'
+  if_job :fr do
+    import 'additional_erase'
+    import 'additional_erase', :force => true
+  end
+
+  log 'Verify that flow.cz works...'
+  func :margin_read1_all1, :pin_levels => :cz, :cz_setup => 'vbplus_sweep'
+
+  log 'Verify that MTO template works...'
+  mto_memory :mto_read1_all1
+
+  bin 1, description: "Good die!"
+end

data/program/prb1_resources.rb

@@ -0,0 +1,28 @@
+# Similar to the test flows an interface instance is passed in as the first argument.
+Resources.create do
+
+  self.resources_filename = 'prb1'
+
+  # Logic here should be minimal,
+  # pass whatever options you want
+  # but the recommended approach is
+  # to infer the pattern name and as
+  # many additional details as
+  # possible from the test name
+  func :program_ckbd, :duration => :dynamic
+
+  import 'efa_resources'
+
+  func :margin_read1_ckbd
+  func :normal_read_ckbd
+  func :margin_read0_ckbd
+
+  func :erase_all, :duration => :dynamic
+
+  para 'charge_pump', :high_voltage => true
+
+  if $tester.j750?
+    test_instances.render 'templates/j750/vt_instances'
+    compile 'templates/j750/program_sheet.txt', :passed_param => true
+  end
+end

data/program/prb2.rb

@@ -0,0 +1,40 @@
+# An example of creating an entire test program from
+# a single source file
+Flow.create do
+
+  self.resources_filename = 'prb2'
+
+  func :erase_all, :duration => :dynamic
+
+  func :margin_read1_all1
+
+  func :erase_all, :duration => :dynamic
+  func :margin_read1_all1
+
+  import 'components/prb2_main'
+
+  func :erase_all, :duration => :dynamic
+  func :margin_read1_all1, :id => 'erased_successfully'
+
+  skip :if_all_passed => 'erased_successfully' do
+    import 'components/prb2_main'
+  end
+
+  if_enable 'extra_tests' do
+    import 'components/prb2_main'
+  end
+
+  func :margin_read1_all1
+  
+  log '"Check OOF passcodes in both locations"'
+  func :pgm_vfy_oof_passcode_tst, tname: "TST_VFY_OOF_PASSCODE", tnum: 1300, continue: true, id: :oof_passcode1
+  func :pgm_vfy_oof_passcode_redcols_utst, tname: "UTST_VFY_OOF_PASSCODE_REDCOLS", tnum: 1300, continue: true, id: :oof_passcode2
+  nop
+  
+  # Will create a better API when implementing this on V93K
+  if Origen.tester.is_a?(OrigenTesters::IGXLBasedTester::Base)
+    or_ids id1: :oof_passcode1, id2: :oof_passcode2, id: :OR, condition: :fail
+    func :testme, tname: "", if_failed: :OR
+  end
+  
+end

data/program/test.rb

@@ -0,0 +1,20 @@
+# An instance of the interface is
+# passed in here, iterators and other
+# argument passing will be supported
+# similar to Pattern.create.
+Flow.create do
+
+  # Instantiate tests via the
+  # interface
+#  func 'program_ckbd', :tname => 'PGM_CKBD', :tnum => 1000, :bin => 100, :soft_bin => 1100
+
+#  para 'charge_pump', :high_voltage => true, :lo_limit => 5, :hi_limit => 6
+
+  meas :read_pump, tnum: 1050, bin: 119, soft_bin: 2, lo_limit: 35
+  meas :read_pump, tnum: 1050, bin: 119, soft_bin: 2, hi_limit: 45
+  meas :read_pump, tnum: 1050, bin: 119, soft_bin: 2, hi_limit: 45, lo_limit: 35
+  meas :read_pump, tnum: 1050, bin: 119, soft_bin: 2, hi_limit: 45, lo_limit: 35, units: "V"
+  meas :read_pump, tnum: 1050, bin: 119, soft_bin: 2, hi_limit: 45, lo_limit: 35, scale: "k", units: "V"
+  meas :read_pump, tnum: 1050, bin: 119, soft_bin: 2, hi_limit: 45, lo_limit: 35, scale: "k", units: "V", result: "None"
+
+end

data/templates/example.txt.erb

@@ -0,0 +1,53 @@
+RGen can compile any ASCII files within the context of a target, in other words
+you can select a target file and access the objects instantiated in the target
+from here and use them to generate dynamic content.
+
+To try it run the compile task on this file:
+
+> rgen c templates/example.txt.erb
+
+You can also compile entire directories like this:
+
+> rgen c templates
+
+In the case of compiling a directory any .erb files in the directory and its
+subdirectory will be compiled, whereas any non .erb files will simply be
+copied over to the output location un-modified.
+
+See the help for the other available options:
+
+> rgen c -h
+
+SYNTAX
+------
+
+The syntax is very simple:
+
+% # Lines that start with % (no spaces allowed before it) will be interpreted
+% # as Ruby. Since these lines start with a comment char they will simply be
+% # deleted by the compilation process.
+
+Ruby logic can be used to conditionally include lines:
+% if 1 == 1 
+  You will see me in the compiled file
+% else
+  But you won't see me :-(
+% end
+
+Loops can be used to expand the content:
+% 10.times do
+  I must not talk in class
+% end
+
+To inject content use this syntax: 4 + 4 = <%= 4 + 4 %>
+
+Whatever is returned by a Ruby snippet like this will be converted to a string and
+output to the compiled file.
+
+That's pretty much it.
+
+Oh almost forgot the best bit, you can access your objects:
+
+"DUT, are you there?"
+
+<%= $dut.say_hello %>

data/templates/j750/_vt_flow.txt.erb

@@ -0,0 +1,8 @@
+		data_collection				Test	nvm_allflash_vsgdist	ErsSatVsg						None														
+% if options[:include_fw]        
+		data_collection				Test	nvm_allflash_vsgdist_fw	ErsSatVsgFW						None														
+% end
+% if options[:include_tifr]        
+		data_collection				Test	nvm_allflash_vsgdist_tifr	ErsSatVsgTIFR						None														
+% end
+		data_collection				Test	nvm_allflash_vsgdist_uifr	ErsSatVsgUIFR						None														

data/templates/j750/_vt_instances.txt.erb

@@ -0,0 +1,4 @@
+	nvm_allflash_vsgdist	IG-XL Template	Empty_T	Excel Macro	NVM	Typ	Spec	Default	Tim		Lvl			TfsC90InterposeFunc				VtDist		SetHRAMForRead,32				ArgData:0,1,15,1,vsg,array																																																																						
+	nvm_allflash_vsgdist_fw	IG-XL Template	Empty_T	Excel Macro	NVM	Typ	Spec	Default	Tim		Lvl			TfsC90InterposeFunc				VtDist		SetHRAMForRead,32				ArgData:0,1,15,1,vsg,fw																																																																						
+	nvm_allflash_vsgdist_uifr	IG-XL Template	Empty_T	Excel Macro	NVM	Typ	Spec	Default	Tim		Lvl			TfsC90InterposeFunc				VtDist		SetHRAMForRead,32				ArgData:0,1,15,1,vsg,uifr																																																																						
+	nvm_allflash_vsgdist_tifr	IG-XL Template	Empty_T	Excel Macro	NVM	Typ	Spec	Default	Tim		Lvl			TfsC90InterposeFunc				VtDist		SetHRAMForRead,32				ArgData:0,1,15,1,vsg,tifr																																																																						

data/templates/j750/program_sheet.txt.erb

@@ -0,0 +1,9 @@
+This is some test program sheet or other.
+
+The test compile has:
+
+% if options[:passed_param]
+  PASSED!
+% else  
+  FAILED!
+% end

data/templates/manifest/v93k.yaml.erb

@@ -0,0 +1,22 @@
+flows:
+  prb1:
+    - continuity
+    - scan
+  prb2:
+    - continuity
+    - functional
+
+sub_programs:  
+  - name:           continuity
+    # Paths can be relative to your RGen application root
+    flow:           output/v93k/testflow/continuity.flow
+
+  - name:           scan
+    # Or relative to this file
+    flow:           ../../output/v93k/testflow/test.flow
+    pattern_master: ../../output/v93k/vectors/test.pmfl
+
+  - name:           functional
+    # Or absolute
+    flow:           /proj/devicex/modules/functional/v93k/testflow/main.flow
+    pattern_master: /proj/devicex/modules/functional/v93k/vectors/main.pmfl

data/templates/web/index.md.erb

@@ -0,0 +1,51 @@
+% render "layouts/basic.html" do
+
+%# HTML tags can be embedded in mark down files if you want to do specific custom
+%# formatting like this, but in most cases that is not required.
+<h1><%= Origen.config.name %> <span style="font-size: 14px">(<%= Origen.app.version %>)</span></h1>
+
+### Purpose
+
+This origen gem provides tester models to drive ATE type testers like the J750, UltraFLEX, V93K. 
+
+### How To Import
+
+In your Gemfile add:
+
+~~~ruby
+gem "<%= Origen.app.name %>", ">= <%= Origen.app.version %>"
+~~~
+
+or if your application is a gem add this to your <code>.gemspec</code>
+
+~~~ruby
+spec.add_runtime_dependency "<%= Origen.app.name %>", ">= <%= Origen.app.version %>"
+~~~
+
+### How To Use
+
+To use a tester, instantiate it in the current environment file:
+
+~~~ruby
+# environment/j750.rb
+$tester = OrigenTesters::J750.new
+~~~
+
+Tester programs and patterns can easily be generated for different testers simply by changing the above instantiation.
+
+### How To Setup a Development Environment
+
+[Clone the repository from Github](https://github.com/Origen-SDK/origen_testers).
+
+Follow the instructions here if you want to make a 3rd party app
+workspace use your development copy of the OrigenTesters plugin:
+[Setting up a Plugin Development Environment](http://origen-sdk.org/origen/latest/guides/plugins)
+
+This plugin also contains a test suite, makes sure this passes before committing
+any changes!
+
+~~~text
+origen test
+~~~
+
+% end