origen_link 0.1.0.pre0

data/lib/origen_link_server/jtag_interface.rb

@@ -0,0 +1,177 @@
+# rubocop:disable Style/For: Prefer each over for.
+require_relative 'pin_interface'
+
+class OrigenLinkJtag
+  attr_reader :tdoval
+  attr_accessor :verbose_enable
+  attr_accessor :anytdofail
+
+  def initialize(tdiio = 16, tdoio = 23, tmsio = 19, tckio = 26, tck_period = 0.000001)
+    @tdipin = OrigenLinkPin.new(tdiio, :out_low)
+    @tdopin = OrigenLinkPin.new(tdoio, :in)
+    @tmspin = OrigenLinkPin.new(tmsio, :out_low)
+    @tckpin = OrigenLinkPin.new(tckio, :out_low)
+    @tck_half_period = tck_period / 2
+    @tdoval = 0
+    @tdostr = ''
+    @verbose_enable = true
+    @anytdofail = false
+  end
+
+  def tck_period=(value)
+    @tck_half_period = value / 2
+  end
+
+  def destroy
+    @tdipin.destroy
+    @tdopin.destroy
+    @tmspin.destroy
+    @tckpin.destroy
+    @tdipin = nil
+    @tdopin = nil
+    @tmspin = nil
+    @tckpin = nil
+  end
+
+  def do_cycle(tdival, tmsval, capturetdo = false)
+    @tdipin.out(tdival)
+    @tmspin.out(tmsval)
+    sleep @tck_half_period
+    @tckpin.out(1)
+    sleep @tck_half_period
+
+    if capturetdo
+      @tdostr = @tdopin.in + @tdostr
+    end
+    @tckpin.out(0)
+  end
+
+  def do_tlr
+    for step in 1..8 do do_cycle(0, 1) end
+    do_cycle(0, 0)
+  end
+
+  def do_shift(numbits, value, capturetdo = false, suppresscomments = false, tdocompare = '')
+    @tdoval = 0
+    @tdostr = ''
+    for bit in 0..numbits - 2 do
+      do_cycle(value[bit], 0, capturetdo)
+    end
+    do_cycle(value[numbits - 1], 1, capturetdo)
+
+    @tdoval = @tdostr.to_i(2) if capturetdo
+
+    if !(suppresscomments) && @verbose_enable && capturetdo
+      puts 'TDO output = 0x' + @tdoval.to_s(16)
+    end
+
+    if capturetdo && tdocompare != ''
+      thiscomparefail = false
+      for bit in 0..numbits - 1 do
+        if tdocompare[numbits - 1 - bit] == 'H'
+          compareval = 1
+        elsif tdocompare[numbits - 1 - bit] == 'L'
+          compareval = 0
+        else
+          compareval = @tdoval[bit]
+        end
+
+        if @tdoval[bit] != compareval
+          @anytdofail = true
+          thiscomparefail = true
+        end
+      end
+
+      tdovalstr = @tdoval.to_s(2)
+      tdovalstr = '0' * (numbits - tdovalstr.length) + tdovalstr
+
+      if thiscomparefail
+        puts '****************************>>>>>>>>>>>>>>>>> TDO failure <<<<<<<<<<<<<<<<<<****************************'
+        puts 'expected: ' + tdocompare
+        puts 'received: ' + tdovalstr
+      else
+        puts 'TDO compare pass'
+        puts 'expected: ' + tdocompare
+        puts 'received: ' + tdovalstr
+      end
+    end
+  end
+
+  def do_ir(numbits, value, options = {})
+    defaults = {
+      capturetdo:	      false,
+      suppresscomments:	false,
+      tdocompare:	      ''
+    }
+    options = defaults.merge(options)
+
+    if !(options[:suppresscomments]) && @verbose_enable
+      puts "	shift IR, #{numbits} bits, value = 0x" + value.to_s(16)
+    end
+
+    if options[:tdocompare] != ''
+      capturetdo = true
+    else
+      capturetdo = options[:capturetdo]
+    end
+
+    # Assume starting from run test idle
+    # Advance to shift IR
+    do_cycle(0, 1)
+    do_cycle(0, 1)
+    do_cycle(0, 0)
+    do_cycle(0, 0)
+
+    do_shift(numbits, value, capturetdo, options[:suppresscomments], options[:tdocompare])
+
+    # Return to run test idle
+    do_cycle(0, 1)
+    do_cycle(0, 0)
+  end
+
+  def do_dr(numbits, value, options = {})
+    defaults = {
+      capturetdo:	      true,
+      suppresscomments:	false,
+      tdocompare:	      ''
+    }
+    options = defaults.merge(options)
+    if !(options[:suppresscomments]) && @verbose_enable
+      puts "	shift DR, #{numbits} bits, value = 0x" + value.to_s(16)
+    end
+
+    if options[:tdocompare] != ''
+      capturetdo = true
+    else
+      capturetdo = options[:tdocompare]
+    end
+
+    # Assume starting from run test idle
+    # Advance to shift DR
+    do_cycle(0, 1)
+    do_cycle(0, 0)
+    do_cycle(0, 0)
+
+    do_shift(numbits, value, capturetdo, options[:suppresscomments], options[:tdocompare])
+
+    # Return to run test idle
+    do_cycle(0, 1)
+    do_cycle(0, 0)
+  end
+
+  def pause_dr
+    do_cycle(0, 1)
+    do_cycle(0, 0)
+    do_cycle(0, 0)
+    do_cycle(0, 1)
+    do_cycle(0, 0)
+    do_cycle(0, 1)
+    do_cycle(0, 1)
+    do_cycle(0, 0)
+  end
+
+  def pause_ir
+    do_cycle(0, 1)
+    pause_dr
+  end
+end

data/lib/origen_link_server/pin_interface.rb

@@ -0,0 +1,134 @@
+# OrigenLinkPin class manipulate input/output pins of the Udoo
+# using exported file objects.  If the pin is not exported, it
+# will be exported when a pin is initialized
+#
+# initialize:
+#  description - This method will execute system command
+#                "sudo echo ionumber > /sys/class/gpio/export"
+#                to create the IO file interface.  It will
+#                set the direction, initial pin state and initialize
+#                instance variables
+#  ionumber - required, value indicating the pin number (BCM IO number,
+#             not the header pin number)
+#  direction - optional, specifies the pin direction.  A pin is
+#              initialized as an input if a direction isn't specified.
+#
+#
+#  out:
+#    description - Sets the output state of the pin.  If the pin
+#                  is setup as an input, the direction will first
+#                  be changed to output.
+#
+#
+#  in:
+#    description - Reads and returns state of the pin.  If the pin
+#                  is setup as an output, the direction will first
+#                  be changed to input.
+#
+#
+#  update_direction:
+#    description - Sets the pin direction
+#
+#  direction - specifies the pin direction.  A pin is
+#              initialized as an input if a direction isn't specified.
+#
+#  Valid direction values:
+#    :in	-	input
+#    :out	-	output
+#    :out_high	-	output, initialized high
+#    :out_low	-	output, initialized low
+class OrigenLinkPin
+  @@pin_setup = {
+    in:			    'in',
+    out:		    'out',
+    out_high:	'high',
+    out_low:		'low'
+  }
+
+  attr_reader :gpio_valid
+
+  def initialize(ionumber, direction = :in)
+    @ionumber = Integer(ionumber)
+    @pin_dir_name = "/sys/class/gpio/gpio#{@ionumber}/direction"
+    @pin_val_name = "/sys/class/gpio/gpio#{@ionumber}/value"
+    if notFile.exist?(@pin_dir_name)
+      system("echo #{@ionumber} > /sys/class/gpio/export")
+      sleep 0.05
+      if $CHILD_STATUS == 0
+        @gpio_valid = true
+      else
+        @gpio_valid = false
+      end
+    else
+      @gpio_valid = true
+    end
+    if @gpio_valid
+      if File.writable?(@pin_dir_name)
+        @pin_dir_obj = File.open(@pin_dir_name, 'w')
+        update_direction(direction)
+      else
+        @gpio_valid = false
+        puts "#{@pin_dir_name} is not writable. Fix permissions or run as super user."
+      end
+      @pin_val_obj = File.open(@pin_val_name, 'r+') if @gpio_valid
+    end
+  end
+
+  def destroy
+    if @gpio_valid
+      @pin_dir_obj.close
+      @pin_val_obj.close
+      system("echo #{@ionumber} > /sys/class/gpio/unexport")
+      puts "pin #{@ionumber} is no longer exported"
+    end
+  end
+
+  def out(value)
+    if @gpio_valid
+      if @direction == :in
+        if value == 1
+          update_direction(:out_high)
+        else
+          update_direction(:out_low)
+        end
+      end
+      @pin_val_obj.write(value)
+      @pin_val_obj.flush
+    end
+  end
+
+  # rubocop:disable Style/EmptyElse: Redundant else-clause.
+  def in
+    if @gpio_valid
+      if @direction == :out
+        update_direction(:in)
+      end
+      # below is original read - slow to reopen every time
+      # File.open(@pin_val_name, 'r') do |file|
+      #  file.read#.chomp
+      # end
+      # end original read
+      @pin_val_obj.pos = 0
+      @pin_val_obj.getc
+    else
+      nil
+    end
+  end
+
+  def update_direction(direction)
+    if @gpio_valid
+      @pin_dir_obj.pos = 0
+      @pin_dir_obj.write(@@pin_setup[direction])
+      @pin_dir_obj.flush
+      if direction == :in
+        @direction = direction
+      else
+        @direction = :out
+      end
+    end
+  end
+
+  def to_s
+    'OrigenLinkPin' + @ionumber.to_s
+  end
+end

data/lib/origen_link_server/test/test_Sequencer.rb

@@ -0,0 +1,51 @@
+# rubocop:disable Style/FileName: Use snake_case for source file names.
+require_relative '../LinkSequencer'
+require 'test/unit'
+
+class TestLinkSequencer < Test::Unit::TestCase
+  def test_pinmap
+    test_obj = OrigenLinkSequencer.new
+    assert_equal('P:', test_obj.processmessage('pin_assign:tck,23'))
+    assert_equal('OrigenLinkPin23', test_obj.pinmap['tck'].to_s)
+    assert_equal('F:pin tdo gpio1900 is invalid', test_obj.processmessage('pin_assign:tdo,1900'))
+    assert_equal('P:', test_obj.processmessage('pin_assign:tck,23'))
+    assert_equal('OrigenLinkPin23', test_obj.pinmap['tck'].to_s)
+    assert_equal(-1, test_obj.pinmap['tdo'])
+  end
+
+  def test_pinorder
+    test_obj2 = OrigenLinkSequencer.new
+    assert_equal('P:', test_obj2.processmessage('pin_patternorder:tdi,tdo,tms'))
+    assert_equal(%w(tdi tdo tms), test_obj2.patternorder)
+    assert_equal({ 'tdi' => 0, 'tdo' => 1, 'tms' => 2 }, test_obj2.patternpinindex)
+    assert_equal([%w(tdi tdo tms), [], []], test_obj2.cycletiming[0]['timing'])
+  end
+
+  def test_clear
+  end
+
+  def test_pinformat_timing
+    test_obj3 = OrigenLinkSequencer.new
+    assert_equal('P:', test_obj3.processmessage('pin_format:1,tck,rl'))
+    assert_equal(['tck'], test_obj3.cycletiming[1]['rl'])
+    assert_equal(nil, test_obj3.cycletiming[1]['rh'])
+
+    assert_equal('P:', test_obj3.processmessage('pin_format:1,xtal,rh'))
+    assert_equal(nil, test_obj3.cycletiming[1]['rl'])
+    assert_equal(['xtal'], test_obj3.cycletiming[1]['rh'])
+
+    assert_equal('P:', test_obj3.processmessage('pin_format:2,tck,rl'))
+    assert_equal(['tck'], test_obj3.cycletiming[2]['rl'])
+    assert_equal(nil, test_obj3.cycletiming[2]['rh'])
+    assert_equal(nil, test_obj3.cycletiming[1]['rl'])
+    assert_equal(['xtal'], test_obj3.cycletiming[1]['rh'])
+
+    assert_equal('P:', test_obj3.processmessage('pin_timing:1,tdi,0,tms,1,tdo,2'))
+    assert_equal(['tck'], test_obj3.cycletiming[2]['rl'])
+    assert_equal(nil, test_obj3.cycletiming[2]['rh'])
+    assert_equal(nil, test_obj3.cycletiming[1]['rl'])
+    assert_equal(['xtal'], test_obj3.cycletiming[1]['rh'])
+    assert_equal([['tdi'], ['tms'], ['tdo']], test_obj3.cycletiming[1]['timing'])
+    assert_equal([[], [], []], test_obj3.cycletiming[2]['timing'])
+  end
+end

data/lib/tasks/origen_link.rake

@@ -0,0 +1,6 @@
+# You can define any Rake tasks to support your application here (or in any file
+# ending in .rake in this directory).
+#
+# Rake (Ruby Make) is very useful for creating build scripts, see this short video
+# for a quick introduction:
+# http://railscasts.com/episodes/66-custom-rake-tasks

data/pattern/example.rb

@@ -0,0 +1,4 @@
+Pattern.create do
+  # Call controller methods from here...
+  # $dut.atd.convert
+end

data/pattern/jtag_100_operations.rb

@@ -0,0 +1,14 @@
+Pattern.create(options={:name => "JTAG_Test"})do
+  $dut.jtag.reset
+  $dut.jtag.idle
+  1.upto(50) do
+    ss "reading Halo debugger ID"
+    $dut.jtag.write_ir 0xe, size: 4
+    $dut.reg(:testreg).read(0x5ba00477)
+    $dut.jtag.read_dr $dut.reg(:testreg), size: 32
+    $dut.jtag.write_ir 0, size: 4
+    ss "reading Halo JTAG ID"
+    $dut.reg(:testreg).read(0x1984101d)
+    $dut.jtag.read_dr $dut.reg(:testreg), size: 32
+  end
+end

data/pattern/jtag_comm_fail_test.rb

@@ -0,0 +1,13 @@
+Pattern.create(options={:name => "JTAG_Test_Force_Fail"})do
+  $dut.jtag.reset
+  $dut.jtag.idle
+  ss "reading Halo debugger ID - setting wrong compare value"
+ #$dut.reg(:testreg).read(0x5ba00477)
+  $dut.reg(:testreg).read(0x5bd00477)
+  $dut.jtag.read_dr $dut.reg(:testreg), size: 32
+  $dut.jtag.write_ir 0, size: 4
+  ss "reading Halo JTAG ID - setting wrong compare value"
+ #$dut.reg(:testreg).read(0x1984101d)
+  $dut.reg(:testreg).read(0x1984101a)
+  $dut.jtag.read_dr $dut.reg(:testreg), size: 32
+end

data/pattern/jtag_comm_test.rb

@@ -0,0 +1,11 @@
+Pattern.create(options={:name => "JTAG_Test"})do
+  $dut.jtag.reset
+  $dut.jtag.idle
+  ss "reading Halo debugger ID"
+  $dut.reg(:testreg).read(0x5ba00477)
+  $dut.jtag.read_dr $dut.reg(:testreg), size: 32
+  $dut.jtag.write_ir 0, size: 4
+  ss "reading Halo JTAG ID"
+  $dut.reg(:testreg).read(0x1984101d)
+  $dut.jtag.read_dr $dut.reg(:testreg), size: 32
+end

data/templates/web/index.md.erb

@@ -0,0 +1,19 @@
+% 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.app.namespace %> <span style="font-size: 14px">(<%= Origen.app.version %>)</span></h1>
+
+### Purpose
+
+This application...
+
+### How To Use
+
+Add quickstart documentation here...
+
+### How To Setup the Application Environment
+
+Describe how a user would setup a new workspace for this application...
+
+% end

data/templates/web/layouts/_basic.html.erb

@@ -0,0 +1,13 @@
+---
+title: <%= options[:title] || Origen.config.name %>
+---
+<%= render "partials/navbar.html", tab: options[:tab] %>
+
+<div class="row">
+%# The markdown attribute is important if you are going to include content written
+%# in markdown, without this is will be included verbatim
+  <div class="span12" markdown="1">
+<%= yield %>    
+
+</div>
+</div>

data/templates/web/partials/_navbar.html.erb

@@ -0,0 +1,20 @@
+<nav class="navbar navbar-inverse navbar-fixed-top">
+  <div class="container">
+    <div class="navbar-header">
+      <button type="button" class="navbar-toggle collapsed" data-toggle="collapse" data-target="#navbar" aria-expanded="false" aria-controls="navbar">
+        <span class="sr-only">Toggle navigation</span>
+        <span class="icon-bar"></span>
+        <span class="icon-bar"></span>
+        <span class="icon-bar"></span>
+      </button>
+      <a class="navbar-brand" href="<%= path "/" %>">Home</a>
+    </div>
+    <div id="navbar" class="collapse navbar-collapse">
+      <ul class="nav navbar-nav">
+        <li class="<%= options[:tab] == :api ? 'active' : '' %>"><a href="<%= path "/api/" %>">API</a></li>
+        <li class="<%= options[:tab] == :release ? 'active' : '' %>"><a href="<%= path "/release_notes" %>">Release Notes</a></li>
+      </ul>
+      <%= import "origen/web/logo.html" %>
+    </div><!--/.nav-collapse -->
+  </div>
+</nav>

data/templates/web/release_notes.md.erb

@@ -0,0 +1,5 @@
+% render "layouts/basic.html", tab: :release do
+
+<%= render "#{Origen.root}/doc/history" %>
+
+% end

metadata

@@ -0,0 +1,125 @@
+--- !ruby/object:Gem::Specification
+name: origen_link
+version: !ruby/object:Gem::Version
+  version: 0.1.0.pre0
+platform: ruby
+authors:
+- Paul Derouen
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2016-03-22 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: origen
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.6.6
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.6.6
+- !ruby/object:Gem::Dependency
+  name: origen_testers
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: origen_jtag
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.12.0
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.12.0
+- !ruby/object:Gem::Dependency
+  name: origen_doc_helpers
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+description: 
+email:
+- paul.derouen@nxp.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- config/application.rb
+- config/boot.rb
+- config/commands.rb
+- config/version.rb
+- lib/origen_link.rb
+- lib/origen_link/includes_vector_based.rb
+- lib/origen_link/test/regression_tests.rb
+- lib/origen_link/test/test_dut.rb
+- lib/origen_link/test/test_dut_controller.rb
+- lib/origen_link/test/vector_based_redefs.rb
+- lib/origen_link/vector_based.rb
+- lib/origen_link_server/LinkSequencer.rb
+- lib/origen_link_server/LinkTCPServer.rb
+- lib/origen_link_server/jtag_interface.rb
+- lib/origen_link_server/pin_interface.rb
+- lib/origen_link_server/test/test_Sequencer.rb
+- lib/tasks/origen_link.rake
+- pattern/example.rb
+- pattern/jtag_100_operations.rb
+- pattern/jtag_comm_fail_test.rb
+- pattern/jtag_comm_test.rb
+- templates/web/index.md.erb
+- templates/web/layouts/_basic.html.erb
+- templates/web/partials/_navbar.html.erb
+- templates/web/release_notes.md.erb
+homepage: http://origen-sdk.org/OrigenLink
+licenses: []
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 1.9.3
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 1.8.11
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.2.2
+signing_key: 
+specification_version: 4
+summary: Origen interface to a live DUT tester
+test_files: []
+has_rdoc: