origen 0.34.3 → 0.35.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: fb9589bd8d0179a20919b1adf594cd400fa7f882
-  data.tar.gz: e898d8031d277cc479d1c84ebc36c775f15b419e
+  metadata.gz: a2952f9e16ab5a67591228b85f5a29c8f7ed78b8
+  data.tar.gz: cd860b639b95180e82d8696575cc236032404ddc
 SHA512:
-  metadata.gz: 54571cf52125b281cd1613800dde84b6c8ddb639076b7dd89328ebaed4c32e6d3e45c27723b4fb7b179c72ca59d278f986ff7b8b3da721542e27d06483fb7fa8
-  data.tar.gz: fefb815678df5803d5f9f6b76de81ce52254455c3b7fd2a1e7d47e475bf99c98ac41611abbcd8a48fc1bffc765b76c8fdd7d4d4a63015a55dffcb9254631ac7a
+  metadata.gz: 1d5ab28b916cfeffe7dbdff873940b06e768ebd2a8fd617d78ee746f3b8a244220c0d429d8a89d1b51d8b4e849698702f6f30223720899afff3a636121821dd4
+  data.tar.gz: 4323ad68a74301cc311a808cb749d402fd5ce821601fa8570bd525bee903816d168afbdb00f361b69c291c59a7916631d34f2298ee324263e7e815a78a654106

data/config/version.rb

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

data/lib/origen.rb

@@ -660,6 +660,10 @@ unless defined? RGen::ORIGENTRANSITION
         @running_remotely = val
       end
 
+      def running_simulation?
+        !!(defined?(OrigenSim) && Origen.tester && Origen.tester.sim?)
+      end
+
       # Returns true if Origen is running interactively. That is, the command was 'origen i'
       def running_interactively?
         !!@running_interactively

data/lib/origen/commands.rb

@@ -32,7 +32,7 @@ Origen.send :current_command=, @command
 # Don't log to file during the save command since we need to preserve the last log,
 # this is done as early in the process as possible so any deprecation warnings during
 # load don't trigger a new log
-Origen::Log.console_only = (%w(save target environment version).include?(@command) || ARGV.include?('--exec_remote'))
+Origen::Log.console_only = %w(save target environment version).include?(@command)
 
 if ARGV.delete('--coverage') ||
    ((@command == 'specs' || @command == 'examples' || @command == 'test') && (ARGV.delete('-c') || ARGV.delete('--coverage')))

data/lib/origen/core_ext/numeric.rb

@@ -187,4 +187,24 @@ class Numeric
       self / 1_000_000_000_000.0
     end
   end
+
+  # Shorthand for tester.wait(time_in_ns: 100), e.g. 100.ns!
+  def ns!
+    Origen.app.tester.wait time_in_ns: self
+  end
+
+  # Shorthand for tester.wait(time_in_us: 100), e.g. 100.us!
+  def us!
+    Origen.app.tester.wait time_in_us: self
+  end
+
+  # Shorthand for tester.wait(time_in_ms: 100), e.g. 100.ms!
+  def ms!
+    Origen.app.tester.wait time_in_ms: self
+  end
+
+  # Shorthand for tester.wait(time_in_s: 100), e.g. 100.s!
+  def s!
+    Origen.app.tester.wait time_in_s: self
+  end
 end

data/lib/origen/generator/job.rb

@@ -121,18 +121,34 @@ module Origen
         end
       end
 
+      def strip_dir_and_ext(name)
+        Pathname.new(name).basename('.*').basename('.*').to_s
+      end
+
       def run
         Origen.app.current_jobs << self
         begin
           if @options[:compile]
+            Origen.log.start_job(strip_dir_and_ext(@requested_pattern), :compiler)
             Origen.generator.compiler.compile(@requested_pattern, @options)
           elsif @options[:job_type] == :merge
+            Origen.log.start_job(strip_dir_and_ext(@requested_pattern), :merger)
             Origen.generator.compiler.merge(@requested_pattern)
           elsif @options[:action] == :program
+            if Origen.running_simulation?
+              Origen.log.start_job(strip_dir_and_ext(@requested_pattern), :simulator)
+            else
+              Origen.log.start_job(strip_dir_and_ext(@requested_pattern), :program_generator)
+            end
             Origen.flow.reset
             Origen.resources.reset
             OrigenTesters::Generator.execute_source(@pattern)
           else
+            if Origen.running_simulation?
+              Origen.log.start_job(strip_dir_and_ext(@requested_pattern), :simulator)
+            else
+              Origen.log.start_job(strip_dir_and_ext(@requested_pattern), :pattern_generator)
+            end
             Origen.generator.pattern.reset      # Resets the pattern controller ready for a new pattern
             # Give the app a chance to handle pattern dispatch
             skip = false
@@ -164,6 +180,7 @@ module Origen
             raise
           end
         end
+        Origen.log.stop_job
         Origen.app.current_jobs.pop
       end
     end

data/lib/origen/log.rb

@@ -9,33 +9,23 @@ module Origen
   #   log.deprecate "Blah" # Deprecate message, always shown
   class Log
     require 'colored'
-    require 'log4r'
-    require 'log4r/outputter/fileoutputter'
-
-    attr_accessor :msg_hash
-    alias_method :messages, :msg_hash
+    require 'logger'
 
     LEVELS = [:normal, :verbose, :silent]
 
     def initialize
       @log_time_0 = @t0 = Time.new
       self.level = :normal
-      @msg_hash = init_msg_hash
+      @custom_logs = {}
     end
 
-    def init_msg_hash
-      msg_types = [:info, :warn, :error, :deprecate, :debug, :success]
-      msg_hash = {}
-      msg_types.each do |m|
-        msg_hash[m] = Hash.new do |h, k|
-          h[k] = []
-        end
+    def console_only?(options = {})
+      if options.key?(:console_only)
+        option = options[:console_only]
+      else
+        option = self.class.console_only?
       end
-      msg_hash
-    end
-
-    def console_only?
-      self.class.console_only? || !Origen.app || Origen.running_globally?
+      option || !Origen.app || Origen.running_globally?
     end
 
     # Anything executed within the given block will log to the console only
@@ -69,16 +59,16 @@ module Origen
       case val
       when :normal
         # Output everything except debug statements
-        console.level = Log4r::INFO
+        console.level = Logger::INFO
         # Output everything
-        log_files.level = Log4r::DEBUG unless console_only?
+        log_files(:level=, Logger::DEBUG) unless console_only?
       when :verbose
-        console.level = Log4r::DEBUG
-        log_files.level = Log4r::DEBUG unless console_only?
+        console.level = Logger::DEBUG
+        log_files(:level=, Logger::DEBUG) unless console_only?
       when :silent
         # We don't use any fatal messages, so this is effectively OFF
-        console.level = Log4r::FATAL
-        log_files.level = Log4r::DEBUG unless console_only?
+        console.level = Logger::FATAL
+        log_files(:level=, Logger::DEBUG) unless console_only?
       end
 
       @level = val
@@ -89,26 +79,19 @@ module Origen
       @level
     end
 
-    def validate_args(string, msg_type)
-      return string, msg_type unless string.is_a? Symbol
-      ['', string]
-    end
-
-    def debug(string = '', msg_type = nil)
-      string, msg_type = validate_args(string, msg_type)
+    def debug(string = '', options = {})
+      string, options = sanitize_args(string, options)
       msg = format_msg('DEBUG', string)
-      log_files.debug msg unless console_only?
+      log_files(:debug, msg) unless console_only?(options)
       console.debug msg
-      @msg_hash[:debug][msg_type] << msg
       nil
     end
 
     def info(string = '', msg_type = nil)
-      string, msg_type = validate_args(string, msg_type)
+      string, options = sanitize_args(string, options)
       msg = format_msg('INFO', string)
-      log_files.info msg unless console_only?
+      log_files(:info, msg) unless console_only?(options)
       console.info msg
-      @msg_hash[:info][msg_type] << msg
       nil
     end
     # Legacy methods
@@ -116,51 +99,43 @@ module Origen
     alias_method :lprint, :info
 
     def success(string = '', msg_type = nil)
-      string, msg_type = validate_args(string, msg_type)
+      string, options = sanitize_args(string, options)
       msg = format_msg('SUCCESS', string)
-      log_files.info msg unless console_only?
-      console.info msg.green
-      @msg_hash[:success][msg_type] << msg
+      log_files(:info, msg) unless console_only?(options)
+      console.info color_unless_remote(msg, :green)
       nil
     end
 
     def deprecate(string = '', msg_type = nil)
-      string, msg_type = validate_args(string, msg_type)
+      string, options = sanitize_args(string, options)
       msg = format_msg('DEPRECATED', string)
-      log_files.warn msg unless console_only?
-      console.warn msg.yellow
-      @msg_hash[:deprecate][msg_type] << msg
+      log_files(:warn, msg) unless console_only?(options)
+      console.warn color_unless_remote(msg, :yellow)
       nil
     end
     alias_method :deprecated, :deprecate
 
     def warn(string = '', msg_type = nil)
-      string, msg_type = validate_args(string, msg_type)
+      string, options = sanitize_args(string, options)
       msg = format_msg('WARNING', string)
-      log_files.warn msg unless console_only?
-      console.warn msg.yellow
-      @msg_hash[:warn][msg_type] << msg
+      log_files(:warn, msg) unless console_only?(options)
+      console.warn color_unless_remote(msg, :yellow)
       nil
     end
     alias_method :warning, :warn
 
     def error(string = '', msg_type = nil)
-      string, msg_type = validate_args(string, msg_type)
+      string, options = sanitize_args(string, options)
       msg = format_msg('ERROR', string)
-      log_files.error msg unless console_only?
-      console.error msg.red
-      @msg_hash[:error][msg_type] << msg
+      log_files(:error, msg) unless console_only?(options)
+      console.error color_unless_remote(msg, :red)
       nil
     end
 
     # Made these all class methods so that they can be read without
     # instantiating a new logger (mainly for use by the origen save command)
     def self.log_file
-      "#{log_file_directory}/last.txt"
-    end
-
-    def self.rolling_log_file
-      "#{log_file_directory}/rolling.txt"
+      File.join(log_file_directory, 'last.txt')
     end
 
     def self.log_file_directory
@@ -179,43 +154,123 @@ module Origen
       level == :verbose
     end
 
-    # Force logger to write any buffered output
+    # Used to force logger to write any buffered output under an earlier implementation, now does nothing
     def flush
-      if Origen.app
-        log_files.outputters.each(&:flush)
+      # No such API provided by the underlying logger, method kept around for compatibility with application
+      # code which was built for a previous version of this logger where flushing was required
+    end
+
+    # Mainly intended for testing the logger, this will return the log level to the default (:normal)
+    # and close all log files, such that any further logging will be done to a new file(s)
+    def reset
+      self.level = :normal
+      @last_file.close if @last_file
+      @last_file = nil
+      @job_file.close if @job_file
+      @job_file = nil
+      @custom_logs.each do |name, log|
+        log.close
       end
-      console.outputters.each(&:flush)
+      @custom_logs = {}
     end
 
-    private
+    # @api private
+    def start_job(name, type)
+      dir = File.join(Origen.config.log_directory, type.to_s)
+      if target = Origen.try(:target).try(:name)
+        dir = File.join(dir, target)
+      end
+      if env = Origen.try(:environment).try(:name)
+        dir = File.join(dir, env)
+      end
+      FileUtils.mkdir_p dir unless File.exist?(dir)
+      @job_file_path = File.join(dir, "#{name}.txt")
+      FileUtils.rm_f(@job_file_path) if File.exist?(@job_file_path)
+      @job_file = open_log(@job_file_path)
+    end
 
-    # Returns a Log4r instance that will send to the console
-    def console
-      @console ||= begin
-        console = Log4r::Logger.new 'console'
-        # console.level = QUIET
-        out = Log4r::Outputter.stdout
-        out.formatter = format
-        console.outputters << out
-        console
+    # @api private
+    def stop_job
+      if @job_file
+        Origen.log.info "Log file written to: #{@job_file_path}"
+        @job_file.close
+        @job_file = nil
       end
     end
 
-    # Returns a Log4r instance that will send to the log files
-    def log_files
-      @log_files ||= begin
-        log_files = Log4r::Logger.new 'log_files'
-        # log_files.level = QUIET
-        file = Log4r::FileOutputter.new('fileOutputter', filename: self.class.log_file, trunc: true)
-        file.formatter = format
-        log_files.outputters << file
+    def method_missing(method, *args, &block)
+      @custom_logs[method.to_sym] ||= begin
+        log_file = File.join(Log.log_file_directory, "#{method}.txt")
         unless Origen.running_remotely?
-          rolling_file = Log4r::RollingFileOutputter.new('rollingfileOutputter', filename: self.class.rolling_log_file, trunc: false, maxsize: 5_242_880, max_backups: 10)
-          rolling_file.formatter = format
-          log_files.outputters << rolling_file
+          FileUtils.mv log_file, "#{log_file}.old" if File.exist?(log_file)
+        end
+        open_log(log_file)
+      end
+      msg = args.shift
+      options = args.shift || {}
+      if options.key?(:format) && !options[:format]
+        msg = "#{msg}\n"
+      else
+        msg = format_msg(method.to_s.upcase, msg)
+      end
+      @custom_logs[method.to_sym].info(msg)
+    end
+
+    private
+
+    def sanitize_args(*args)
+      message = ''
+      options = {}
+      args.each do |arg|
+        if arg.is_a?(String)
+          message = arg
+        elsif arg.is_a?(Hash)
+          options = arg
         end
-        log_files
       end
+      [message, options]
+    end
+
+    # When running on an LSF client, the console log output is captured to a file. Color codings in files just
+    # add noise, so inhibit them in this case since it is not providing any visual benefit to the user
+    def color_unless_remote(msg, color)
+      if Origen.running_remotely?
+        msg
+      else
+        msg.send(color)
+      end
+    end
+
+    # Returns a logger instance that will send to the console
+    def console
+      @console ||= open_log(STDOUT)
+    end
+
+    # Returns a logger instance that will send to the log/last.txt file
+    def last_file
+      @last_file ||= begin
+        # Preserve one prior version of the log file
+        FileUtils.mv Log.log_file, "#{Log.log_file}.old" if File.exist?(Log.log_file)
+        open_log(Log.log_file)
+      end
+    end
+
+    # Sends the given method and arguments to all file logger instances
+    def log_files(method, *args)
+      # When running remotely on an LSF client, the LSF manager will capture STDOUT (i.e. the console log output)
+      # and save it to a log file.
+      # Don't write to the last log file in that case because we would have multiple processes all vying to
+      # write to it at the same time.
+      last_file.send(method, *args) unless Origen.running_remotely?
+      @job_file.send(method, *args) if @job_file
+    end
+
+    def open_log(file)
+      l = Logger.new(file)
+      l.formatter = proc do |severity, dateime, progname, msg|
+        msg
+      end
+      l
     end
 
     def relog(msg)
@@ -237,13 +292,9 @@ module Origen
       delta_t = '%0.3f' % delta_t
       delta_t0 = (log_time_1.to_f - @t0.to_f).round(6)
       delta_t0 = '%0.3f' % delta_t0
-      msg = "[#{type}]".ljust(13) + "#{delta_t0}[#{delta_t}]".ljust(16) + "|| #{msg}"
+      msg = "[#{type}]".ljust(13) + "#{delta_t0}[#{delta_t}]".ljust(16) + "|| #{msg}\n"
       @log_time_0 = log_time_1
       msg
     end
-
-    def format
-      Log4r::PatternFormatter.new(pattern: '%m')
-    end
   end
 end

data/lib/origen/registers.rb

@@ -140,6 +140,11 @@ module Origen
         @name = name
         @attributes = attributes
         @feature = attributes[:_feature] if attributes.key?(:_feature)
+
+        # Give reg.new a way to tell if coming from Placeholder
+        if attributes[:bit_info].is_a? Hash
+          attributes[:bit_info][:from_placeholder] = true
+        end
       end
 
       # Make this appear like a reg to any application code

data/lib/origen/registers/reg.rb

@@ -68,13 +68,14 @@ module Origen
         @name = name
         @init_as_writable = options.delete(:init_as_writable)
         @define_file = options.delete(:define_file)
+        @from_placeholder = options.delete(:from_placeholder) || false
         REG_LEVEL_ATTRIBUTES.each do |attribute, _meta|
-          if options[attribute[1..-1].to_sym]
+          if @from_placeholder
+            instance_variable_set("@#{attribute[1..-1]}", options.delete(attribute))
+          else
             # If register creation is coming directly from Reg.new, instead of Placeholder,
             #   it may not have attributes with '_' prefix
             instance_variable_set("@#{attribute[1..-1]}", options.delete(attribute[1..-1].to_sym))
-          else
-            instance_variable_set("@#{attribute[1..-1]}", options.delete(attribute))
           end
         end
         @description_from_api = {}

data/lib/origen/revision_control/git.rb

@@ -330,7 +330,7 @@ module Origen
           Origen.log.debug "Initializing Git workspace at #{local}"
           git 'init'
           git 'remote remove origin', verbose: false, check_errors: false
-          git "remote add origin #{remote}"
+          git "remote add origin #{remote}", check_errors: false
         end
       end
 

data/lib/origen/version_string.rb

@@ -32,7 +32,12 @@ module Origen
     alias_method :orig_equal?, :==
 
     def equal?(version)
-      condition_met?("== #{version}")
+      # If not a valid version string, compare using regular string comparison
+      if valid?
+        condition_met?("== #{version}")
+      else
+        orig_equal?(version)
+      end
     end
     alias_method :eq?, :equal?
     alias_method :==, :equal?

data/vendor/lib/models/origen/export1.rb

@@ -0,0 +1,77 @@
+# This file was generated by Origen, any hand edits will likely get overwritten
+# rubocop:disable all
+module Origen
+  module Export1
+    def self.extended(model)
+      model.add_package :bga
+      model.add_package :pcs
+      model.add_pin :pinx
+      model.add_pin :piny, reset: :drive_hi, direction: :output, meta: { a: '1', b: 2 }
+      model.add_pin :tdo, packages: { bga: { location: 'BF32', dib_assignment: [10104] }, pcs: { location: 'BF30', dib_assignment: [31808] } }
+      model.add_pin :porta31
+      model.add_pin :porta30
+      model.add_pin :porta29
+      model.add_pin :porta28
+      model.add_pin :porta27
+      model.add_pin :porta26
+      model.add_pin :porta25
+      model.add_pin :porta24
+      model.add_pin :porta23
+      model.add_pin :porta22
+      model.add_pin :porta21
+      model.add_pin :porta20
+      model.add_pin :porta19
+      model.add_pin :porta18
+      model.add_pin :porta17
+      model.add_pin :porta16
+      model.add_pin :porta15
+      model.add_pin :porta14
+      model.add_pin :porta13
+      model.add_pin :porta12
+      model.add_pin :porta11
+      model.add_pin :porta10
+      model.add_pin :porta9
+      model.add_pin :porta8
+      model.add_pin :porta7
+      model.add_pin :porta6
+      model.add_pin :porta5
+      model.add_pin :porta4
+      model.add_pin :porta3
+      model.add_pin :porta2
+      model.add_pin :porta1
+      model.add_pin :porta0
+      model.add_pin :portb0
+      model.add_pin :portb1
+      model.add_pin :portb2
+      model.add_pin :portb3
+      model.add_pin :portb4
+      model.add_pin :portb5
+      model.add_pin :portb6
+      model.add_pin :portb7
+      model.add_pin :portb8
+      model.add_pin :portb9
+      model.add_pin :portb10
+      model.add_pin :portb11
+      model.add_pin :portb12
+      model.add_pin :portb13
+      model.add_pin :portb14
+      model.add_pin :portb15
+      model.add_pin_group :porta, :porta31, :porta30, :porta29, :porta28, :porta27, :porta26, :porta25, :porta24, :porta23, :porta22, :porta21, :porta20, :porta19, :porta18, :porta17, :porta16, :porta15, :porta14, :porta13, :porta12, :porta11, :porta10, :porta9, :porta8, :porta7, :porta6, :porta5, :porta4, :porta3, :porta2, :porta1, :porta0
+      model.add_pin_group :portb, :portb15, :portb14, :portb13, :portb12, :portb11, :portb10, :portb9, :portb8, :portb7, :portb6, :portb5, :portb4, :portb3, :portb2, :portb1, :portb0
+      model.pins(:portb).endian = :little
+      model.add_power_pin :vdd1, voltage: 3, current_limit: 0.05, meta: { min_voltage: 1.5 }
+      model.add_power_pin :vdd2
+      model.add_power_pin_group :vdd, :vdd1, :vdd2
+      model.add_ground_pin :gnd1
+      model.add_ground_pin :gnd2
+      model.add_ground_pin :gnd3
+      model.add_ground_pin_group :gnd, :gnd1, :gnd2, :gnd3
+      model.add_virtual_pin :relay1
+      model.add_virtual_pin :relay2, packages: { bga: {} }
+
+      model.sub_block :block1, file: 'origen/export1/block1.rb', dir: '/home/stephen/Code/github/origen/vendor/lib/models', lazy: true
+
+    end
+  end
+end
+# rubocop:enable all

data/vendor/lib/models/origen/export1/block1.rb

@@ -0,0 +1,13 @@
+# This file was generated by Origen, any hand edits will likely get overwritten
+# rubocop:disable all
+module Origen
+  module Export1
+    module Block1
+      def self.extended(model)
+        model.sub_block :x, file: 'origen/export1/block1/x.rb', dir: '/home/stephen/Code/github/origen/vendor/lib/models', lazy: true, base_address: 0x40000000
+
+      end
+    end
+  end
+end
+# rubocop:enable all

data/vendor/lib/models/origen/export1/block1/x.rb

@@ -0,0 +1,27 @@
+# This file was generated by Origen, any hand edits will likely get overwritten
+# rubocop:disable all
+module Origen
+  module Export1
+    module Block1
+      module X
+        def self.extended(model)
+          # ** Some Control Register **
+          # Blah, blah,
+          # and some more blah
+          model.add_reg :ctrl, 0x24, size: 16 do |reg|
+            reg.bit 7, :coco, access: :ro
+            reg.bit 6, :aien
+            # **Some Diff Bit** - This is a...
+            # blah, blah
+            # 
+            # 0 | It's off
+            # 1 | It's on
+            reg.bit 5, :diff
+            reg.bit 4..0, :adch, reset: 0x1F
+          end
+        end
+      end
+    end
+  end
+end
+# rubocop:enable all

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: origen
 version: !ruby/object:Gem::Version
-  version: 0.34.3
+  version: 0.35.0
 platform: ruby
 authors:
 - Stephen McGinty
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2018-08-17 00:00:00.000000000 Z
+date: 2018-08-24 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activesupport
@@ -234,26 +234,6 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '0.9'
-- !ruby/object:Gem::Dependency
-  name: log4r
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '1.1'
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: 1.1.10
-  type: :runtime
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '1.1'
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: 1.1.10
 - !ruby/object:Gem::Dependency
   name: scrub_rb
   requirement: !ruby/object:Gem::Requirement
@@ -635,6 +615,9 @@ files:
 - templates/shared/web/_logo.html
 - templates/time/filter.rb.erb
 - templates/time/rules.rb.erb
+- vendor/lib/models/origen/export1.rb
+- vendor/lib/models/origen/export1/block1.rb
+- vendor/lib/models/origen/export1/block1/x.rb
 homepage: http://origen-sdk.org
 licenses:
 - MIT
@@ -655,7 +638,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: 1.8.11
 requirements: []
 rubyforge_project: 
-rubygems_version: 2.6.13
+rubygems_version: 2.6.14.1
 signing_key: 
 specification_version: 4
 summary: The Semiconductor Developer's Kit