origen 0.53.0 → 0.53.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 7d603663235ae26d0c6fba0822ca9c9576501fe541c67f297bb3a80e2482fb96
-  data.tar.gz: a14ad36e2a97a10135d0e3caacc8dbc1f1f0d35c5fe3c9ba4c4616fc77778f58
+  metadata.gz: bfd569a25fe01194aa87a0e7d35c2aca0ed5663b45622a085dce5c397ccb4cf7
+  data.tar.gz: b820cb13bd6565d581c9507a26800ae363f75674443f628aac5868a93fc055dc
 SHA512:
-  metadata.gz: 2cbba1ed23f15f9c00d31cddbd9190d25c0c25add9ef48cdd8165467e0a5d5bd90b2ed6d20202d4914ff19520eba810d680ed72f1507dd0134cc27fd6a3dfc93
-  data.tar.gz: 3810548860a6b00572efc5b7d9cff8ff4ec7ee56996718d7a399c4574cc45e3cd06f2d57bc4db332504e4c7981b73c21e5c6a82490b30a3485339d6e7d785f66
+  metadata.gz: 3269cc10dd0868bcde87e641defb89917e4d63ebca8ebd23afcc95224c37dde85551c2e21a3a8acd191539c2619b9b6a541678f86c2d51f3fd5702ad86965294
+  data.tar.gz: d427a339ff99a83e2c6dafb31229ebdd35a8f44a62dbe54fe6793109f66b8135e70e33427e4b9d6ad385be7dd4c4578634001250aea3cfb5356ca5cdf3e62e7f

data/config/version.rb

@@ -1,7 +1,7 @@
 module Origen
   MAJOR = 0
   MINOR = 53
-  BUGFIX = 0
+  BUGFIX = 1
   DEV = nil
   VERSION = [MAJOR, MINOR, BUGFIX].join(".") + (DEV ? ".pre#{DEV}" : '')
 end

data/lib/origen/application/configuration.rb

@@ -19,7 +19,8 @@ module Origen
                     :web_domain,
                     :strict_errors, :unmanaged_dirs, :unmanaged_files, :remotes,
                     :external_app_dirs, :lint_test, :shared, :yammer_group, :rc_url, :rc_workflow,
-                    :user_aliases, :release_externally, :gem_name, :disqus_shortname
+                    :user_aliases, :release_externally, :gem_name, :disqus_shortname,
+                    :default_plugin
 
       # Mark any attributes that are likely to depend on properties of the target here,
       # this will raise an error if they are ever accessed before the target has been

data/lib/origen/application/plugins.rb

@@ -38,16 +38,24 @@ module Origen
       def current
         return nil if @temporary == :none
         return nil if @disabled
-        name = @temporary || @current ||= Origen.app.session.origen_core[:default_plugin]
+        name = @temporary || @current ||= begin
+          if Origen.app.session.origen_core[:default_plugin]
+            Origen.app.session.origen_core[:default_plugin]
+          elsif Origen.app.config.default_plugin && !Origen.app.session.origen_core[:default_plugin_cleared_by_user]
+            Origen.app.config.default_plugin
+          end
+        end
         find { |p| p.name.to_sym == name } if name
       end
 
       def current=(name)
         name = name.to_sym if name
-        Origen.app.session.origen_core[:default_plugin] = name
-        if name == :none
+        if name == :none || name.nil?
           @current = nil
+          Origen.app.session.origen_core[:default_plugin] = nil
+          Origen.app.session.origen_core[:default_plugin_cleared_by_user] = true
         else
+          Origen.app.session.origen_core[:default_plugin] = name
           @current = name
         end
       end

data/lib/origen/core_ext/integer.rb

@@ -22,6 +22,11 @@ module Origen
 end
 
 class Integer
+  class << self
+    attr_accessor :width
+  end
+  @width = 32
+
   if RUBY_VERSION >= '2.4.0'
     prepend Origen::IntegerExtension
   end
@@ -72,6 +77,19 @@ class Integer
   alias_method :to_xls_col, :to_spreadsheet_column
   alias_method :to_xlsx_col, :to_spreadsheet_column
   alias_method :to_spreadsheet_col, :to_spreadsheet_column
+
+  def twos_complement(width = nil)
+    _width = width || Integer.width
+    if self > 2**(_width - 1) - 1
+      fail(RangeError, "Integer #{self} cannot fit into #{_width} bits with 2s complement encoding")
+    elsif self < -1 * (2**(_width - 1))
+      fail(RangeError, "Integer #{self} cannot fit into #{_width} bits with 2s complement encoding")
+    end
+
+    self < 0 ? ((-1 * self) ^ (2**_width - 1)) + 1 : self
+  end
+  alias_method :twos_comp, :twos_complement
+  alias_method :twos_compliment, :twos_complement
 end
 
 if RUBY_VERSION <= '2.4.0'

data/lib/origen/core_ext/object.rb

@@ -10,4 +10,18 @@ class Object
     end
     nil
   end
+
+  # Indicates whether the object is or can be used as an Origen subblock, where
+  # being an Origen subblock is defined as inheriting from either {Origen::Model} or
+  # {Origen::Controller}.
+  # @return [True/False]
+  # @example Subblock NVM (from the Origen guides)
+  #   dut.nvm.origen_subblock? #=> true
+  # @example Non-subblocks
+  #   'hi'.origen_subblock? #=> false
+  # @see https://origen-sdk.org/origen/guides/models/defining/#Adding_Sub_Blocks
+  def origen_subblock?
+    self.is_a?(Origen::Model) || self.is_a?(Origen::Controller) || self.is_a?(Origen::SubBlocks::Placeholder)
+  end
+  alias_method :origen_sub_block?, :origen_subblock?
 end

data/lib/origen/pins.rb

@@ -693,27 +693,78 @@ If you meant to define the virtual_pin_group then use the add_virtual_pin_group
     end
     alias_method :virtual_pin_group, :virtual_pin_groups
 
+    def all_pin_ids(type: nil, **options)
+      case type
+      when :power_pin, :power_pins
+        dut.pins(power_pin: true).map { |n, p| [n, *p.aliases.keys] }.flatten.map { |n| [n, dut.power_pin(n)] }.to_h
+      when :ground_pin, :ground_pins
+        dut.pins(ground_pin: true).map { |n, p| [n, *p.aliases.keys] }.flatten.map { |n| [n, dut.ground_pin(n)] }.to_h
+      when :virtual_pin, :virtual_pins
+        dut.pins(virtual_pin: true).map { |n, p| [n, *p.aliases.keys] }.flatten.map { |n| [n, dut.virtual_pin(n)] }.to_h
+      when :other_pin, :other_pins
+        dut.pins(other_pin: true).map { |n, p| [n, *p.aliases.keys] }.flatten.map { |n| [n, dut.other_pin(n)] }.to_h
+      else
+        # Maintain the legacy lookup of power_pin: true, ground_pin: true, etc.
+        if options[:power_pin]
+          all_pin_ids(type: :power_pin)
+        elsif options[:ground_pin]
+          all_pin_ids(type: :ground_pin)
+        elsif options[:virtual_pin]
+          all_pin_ids(type: :virtual_pin)
+        elsif options[:other_pin]
+          all_pin_ids(type: :other_pin)
+        else
+          dut.pins.map { |n, p| [n, *p.aliases.keys] }.flatten.map { |n| [n, dut.pin(n)] }.to_h
+        end
+      end
+    end
+
     # Permits access via object.pin(x), returns a hash of all pins if no id
     # is specified.
     # ==== Examples
     #   $top.pin(:done)
     #   $soc.pin(:port_a1)
     #   pin(:fail)          # Access directly from within the module
-    def pins(id = nil, options = {}, &_block)
-      id, options = nil, id if id.is_a?(Hash)
-      if id
-        pin = Origen.pin_bank.find(id, options)
-        unless pin
-          puts <<-END
+    def pins(*ids, &_block)
+      options = (ids.pop if ids.last.is_a?(Hash)) || {}
+
+      # Methods may give an ID of nil, which would previously gloss over
+      # the pin lookup. To maintain backwards compability, reject any nils in the input,
+      # then proceed as normal.
+      ids.reject!(&:nil?)
+      if !ids.empty? || block_given?
+        pins = []
+
+        if block_given?
+          pins += all_pin_ids(options).select { |n, p| yield(n, p) }.values.uniq
+        end
+
+        ids.each do |id|
+          if id.is_a?(Regexp)
+            pins += all_pin_ids(options).select { |n, p| n.to_s =~ id }.values.uniq
+          else
+            pin = Origen.pin_bank.find(id, options)
+            unless pin
+              puts <<-END
 You have tried to reference pin :#{id} within #{self.class} but it does not exist, this could be
 because the pin has not been defined yet or it is an alias that is not available in the current context.
 
 If you meant to define the pin then use the add_pin method instead.
 
-          END
-          fail 'Pin not found'
+              END
+              fail 'Pin not found'
+            end
+            pins << pin
+          end
+        end
+
+        # Maintain return value of a single pin object if only given a single identifier
+        if ids.size == 1 && !ids.first.is_a?(Regexp)
+          pins.first
+        else
+          options[:keep_duplicates] ? pins : pins.uniq!
+          PinCollection.new(self, *pins, options)
         end
-        pin
       else
         if options[:power_pin]
           Origen.pin_bank.power_pins
@@ -741,12 +792,13 @@ If you meant to define the pin then use the add_pin method instead.
     alias_method :power_pin, :power_pins
 
     # Equivalent to the pins method but considers ground pins rather than regular pins
-    def ground_pins(id = nil, options = {}, &block)
-      id, options = nil, id if id.is_a?(Hash)
+    def ground_pins(*ids, &block)
+      options = (ids.pop if ids.last.is_a?(Hash)) || {}
+
       options = {
         ground_pin: true
       }.merge(options)
-      pins(id, options, &block)
+      pins(*ids, options, &block)
     end
     alias_method :ground_pin, :ground_pins
 

data/lib/origen/pins/pin.rb

@@ -1072,6 +1072,85 @@ module Origen
         end
       end
 
+      def index?(context: nil)
+        !!index(context: context).nil?
+      end
+
+      def index(context: nil)
+        if context.is_a?(Symbol)
+          # Context pin group provided
+          group = groups[context].instance_variable_get(:@store)
+          if group
+            group.index(self)
+          end
+        elsif context.is_a?(Array)
+          # Anonymous pin group given
+          context.map { |p| p.is_a?(Symbol) ? owner.pin(p) : p }.index(self)
+        else
+          # Try an index based off of the pin name.
+          # Only works if the pin ends in a decimal. Otherwise, returns nil.
+          i = name.to_s.index(/\d+$/)
+          if i
+            name.to_s[i..-1].to_i
+          end
+        end
+      end
+
+      def mask(context: nil)
+        index = context.is_a?(Integer) ? context : self.index(context: context)
+
+        if index.nil? && context.nil?
+          # If the index is nil and no context was given, no implicit index could be resolved
+          fail("Could not discern pin :#{name}'s implicit index!")
+        elsif index.nil?
+          # If the index is nil and some context was given, then the pin is not in the given context
+          fail("Pin :#{name} is not a member of the given context!")
+        end
+
+        2**index
+      end
+      alias_method :set_mask, :mask
+      alias_method :smask, :mask
+
+      def clear_mask(context: nil, size: nil)
+        index = context.is_a?(Integer) ? context : self.index(context: context)
+
+        if index.nil? && context.nil?
+          # If the index is nil and no context was given, no implicit index could be resolved
+          fail("Could not discern pin :#{name}'s implicit index!")
+        elsif index.nil?
+          # If the index is nil and some context was given, then the pin is not in the given context
+          fail("Pin :#{name} is not a member of the given context!")
+        end
+
+        if size && context && !context.is_a?(Integer)
+          # A context was given, that was not just an Integer, and size was given
+          # Raise an exception as these two conflict.
+          fail('Both a sized context (e.g. pin group) and a :size option cannot be used simultaneously!')
+        elsif size
+          # A size option was given. Use that.
+          ((2**size) - 1) ^ (1 << index)
+        elsif context.is_a?(Symbol)
+          ((2**groups[context].instance_variable_get(:@store).size) - 1) ^ (1 << index)
+        elsif context.respond_to?(:size) && !context.is_a?(Integer)
+          # PinCollection or Array
+          ((2**context.size) - 1) ^ (1 << index)
+        else
+          # No size option was given. Use the implicit index instead.
+          (2**index) - 1
+        end
+      end
+      alias_method :clr_mask, :clear_mask
+      alias_method :cmask, :clear_mask
+
+      def named?(n)
+        if n.is_a?(Regexp)
+          [name.to_s, *aliases.keys].any? { |na| na =~ n }
+        else
+          [name.to_s, *aliases.keys.map(&:to_s)].include?(n.to_s)
+        end
+      end
+
       def method_missing(m, *args, &block)
         if meta.include? m
           meta[m]

data/lib/origen/registers/reg.rb

@@ -476,6 +476,9 @@ module Origen
       # @api private
       def parse_descriptions
         desc = []
+        unless File.exist?(define_file)
+          return desc
+        end
         File.readlines(define_file).each do |line|
           if line =~ /^\s*#(.*)/
             desc << Regexp.last_match[1].strip

data/lib/origen/sub_blocks.rb

@@ -274,6 +274,13 @@ module Origen
     def sub_block(name = nil, options = {})
       name, options = nil, name if name.is_a?(Hash)
       return sub_blocks unless name
+
+      if name.is_a?(Class)
+        return sub_blocks.select { |n, s| s.is_a?(name) }
+      elsif name.origen_sub_block?
+        return sub_block(name.class)
+      end
+
       if i = options.delete(:instances)
         # permit creating multiple instances of a particular sub_block class
         # can pass array for base_address, which will be processed above

data/origen_app_generators/origen_app_generators.gemspec

@@ -8,16 +8,16 @@ Gem::Specification.new do |s|
   s.required_rubygems_version = Gem::Requirement.new(">= 1.8.11".freeze) if s.respond_to? :required_rubygems_version=
   s.require_paths = ["lib".freeze]
   s.authors = ["Stephen McGinty".freeze]
-  s.date = "2019-08-15"
+  s.date = "2019-09-02"
   s.email = ["stephen.f.mcginty@gmail.com".freeze]
   s.files = ["bin/boot.rb".freeze, "config/application.rb".freeze, "config/boot.rb".freeze, "config/commands.rb".freeze, "config/shared_commands.rb".freeze, "config/version.rb".freeze, "lib/origen_app_generators.rb".freeze, "lib/origen_app_generators/application.rb".freeze, "lib/origen_app_generators/base.rb".freeze, "lib/origen_app_generators/empty_application.rb".freeze, "lib/origen_app_generators/empty_plugin.rb".freeze, "lib/origen_app_generators/new.rb".freeze, "lib/origen_app_generators/new_app_tests.rb".freeze, "lib/origen_app_generators/origen_infrastructure/app_generator_plugin.rb".freeze, "lib/origen_app_generators/plugin.rb".freeze, "lib/origen_app_generators/test_engineering/common.rb".freeze, "lib/origen_app_generators/test_engineering/stand_alone_application.rb".freeze, "lib/origen_app_generators/test_engineering/test_block.rb".freeze, "templates/app_generators".freeze, "templates/app_generators/application".freeze, "templates/app_generators/application/.gitignore".freeze, "templates/app_generators/application/.irbrc".freeze, "templates/app_generators/application/.rspec".freeze, "templates/app_generators/application/.travis.yml".freeze, "templates/app_generators/application/Gemfile".freeze, "templates/app_generators/application/Rakefile".freeze, "templates/app_generators/application/app".freeze, "templates/app_generators/application/app/blocks".freeze, "templates/app_generators/application/app/blocks/top_level.rb".freeze, "templates/app_generators/application/app/lib".freeze, "templates/app_generators/application/app/lib/module.rb".freeze, "templates/app_generators/application/app/templates".freeze, "templates/app_generators/application/app/templates/web".freeze, "templates/app_generators/application/app/templates/web/index.md.erb".freeze, "templates/app_generators/application/app/templates/web/layouts".freeze, "templates/app_generators/application/app/templates/web/layouts/_basic.html.erb".freeze, "templates/app_generators/application/app/templates/web/partials".freeze, "templates/app_generators/application/app/templates/web/partials/_navbar.html.erb".freeze, "templates/app_generators/application/app/templates/web/release_notes.md.erb".freeze, "templates/app_generators/application/config".freeze, "templates/app_generators/application/config/application.rb".freeze, "templates/app_generators/application/config/boot.rb".freeze, "templates/app_generators/application/config/commands.rb".freeze, "templates/app_generators/application/config/maillist_dev.txt".freeze, "templates/app_generators/application/config/maillist_prod.txt".freeze, "templates/app_generators/application/config/version.rb".freeze, "templates/app_generators/application/doc".freeze, "templates/app_generators/application/doc/history".freeze, "templates/app_generators/application/dot_keep".freeze, "templates/app_generators/application/origen_core_session".freeze, "templates/app_generators/application/spec".freeze, "templates/app_generators/application/spec/spec_helper.rb".freeze, "templates/app_generators/application/target".freeze, "templates/app_generators/application/target/debug.rb".freeze, "templates/app_generators/application/target/default.rb".freeze, "templates/app_generators/application/target/production.rb".freeze, "templates/app_generators/new".freeze, "templates/app_generators/new/generator.rb".freeze, "templates/app_generators/new/info.md.erb".freeze, "templates/app_generators/origen_infrastructure".freeze, "templates/app_generators/origen_infrastructure/app_generator_plugin".freeze, "templates/app_generators/origen_infrastructure/app_generator_plugin/app".freeze, "templates/app_generators/origen_infrastructure/app_generator_plugin/app/lib".freeze, "templates/app_generators/origen_infrastructure/app_generator_plugin/app/lib/application.rb".freeze, "templates/app_generators/origen_infrastructure/app_generator_plugin/app/lib/base.rb".freeze, "templates/app_generators/origen_infrastructure/app_generator_plugin/app/lib/module.rb".freeze, "templates/app_generators/origen_infrastructure/app_generator_plugin/app/lib/plugin.rb".freeze, "templates/app_generators/origen_infrastructure/app_generator_plugin/config".freeze, "templates/app_generators/origen_infrastructure/app_generator_plugin/config/load_generators.rb".freeze, "templates/app_generators/plugin".freeze, "templates/app_generators/plugin/Gemfile".freeze, "templates/app_generators/plugin/Rakefile".freeze, "templates/app_generators/plugin/app".freeze, "templates/app_generators/plugin/app/templates".freeze, "templates/app_generators/plugin/app/templates/web".freeze, "templates/app_generators/plugin/app/templates/web/index.md.erb".freeze, "templates/app_generators/plugin/app/templates/web/partials".freeze, "templates/app_generators/plugin/app/templates/web/partials/_navbar_external.html.erb".freeze, "templates/app_generators/plugin/app/templates/web/partials/_navbar_internal.html.erb".freeze, "templates/app_generators/plugin/config".freeze, "templates/app_generators/plugin/config/boot.rb".freeze, "templates/app_generators/plugin/gemspec.rb".freeze, "templates/app_generators/test_engineering".freeze, "templates/app_generators/test_engineering/environment".freeze, "templates/app_generators/test_engineering/environment/j750.rb".freeze, "templates/app_generators/test_engineering/environment/uflex.rb".freeze, "templates/app_generators/test_engineering/environment/v93k.rb".freeze, "templates/app_generators/test_engineering/stand_alone_application".freeze, "templates/app_generators/test_engineering/stand_alone_application/.keep".freeze, "templates/app_generators/test_engineering/test_block".freeze, "templates/app_generators/test_engineering/test_block/.keep".freeze]
   s.homepage = "http://origen-sdk.org/origen_app_generators".freeze
   s.licenses = ["MIT".freeze]
   s.required_ruby_version = Gem::Requirement.new(">= 1.9.3".freeze)
-  s.rubygems_version = "3.0.4".freeze
+  s.rubygems_version = "2.7.7".freeze
   s.summary = "Origen application generators".freeze
 
-  s.installed_by_version = "3.0.4" if s.respond_to? :installed_by_version
+  s.installed_by_version = "2.7.7" if s.respond_to? :installed_by_version
 
   if s.respond_to? :specification_version then
     s.specification_version = 4

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: origen
 version: !ruby/object:Gem::Version
-  version: 0.53.0
+  version: 0.53.1
 platform: ruby
 authors:
 - Stephen McGinty
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2019-08-21 00:00:00.000000000 Z
+date: 2019-09-11 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activesupport
@@ -735,7 +735,8 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: 1.8.11
 requirements: []
-rubygems_version: 3.0.4
+rubyforge_project: 
+rubygems_version: 2.7.7
 signing_key: 
 specification_version: 4
 summary: The Semiconductor Developer's Kit