cross_origen 1.1.0 → 1.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
-SHA1:
-  metadata.gz: 5562897c79ebf49e9fb75bbb83787437c0ed8d3f
-  data.tar.gz: 4e47b1a017700d51a7dd34be36120a46cf4d245a
+SHA256:
+  metadata.gz: 9cbda922846a3192f534c1eeca9e5986e9d8ccbbffb0ecc40c3d1b4ab78ab199
+  data.tar.gz: 6fe704ff82b2a145cdcb53ace6c3f505f85778f45c76276f45d80bf8efb96a72
 SHA512:
-  metadata.gz: 29cc7e80165331b890f6ee18b3a9e63b686ee022ec167891a065ef1ee80c89b5ae7316a55657d3f756c48fef1615dac52bae2f6dbe7026f5232aabf128d8f998
-  data.tar.gz: a39363d28a53c3d9cd11869c15b0e7b2f7722bf8e0165b3227caebdc1352cc81a12e8838da87f0fdef1632ef96cdec8c8b1fb6c65e75be46604ca80fcd2c4ff8
+  metadata.gz: 5dc7ade444c8d342e87fadbb265a0756a703fa6043a4139692dac5b0cf93b0c27583f79d405b932597df8d81735b9e969c49404ce072acae7e3a854a7a83319c
+  data.tar.gz: f7e12c505f30f7ae7fdecd9e5e1bb9446c43659b9413972288b0c7ff244eec80cbe10bda6cf70d757112ed698c2f7e8b8d35d93482a248192c84673966c3af15

data/config/version.rb

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

data/lib/cross_origen/ip_xact.rb

@@ -6,6 +6,9 @@ module CrossOrigen
 
     AddressBlock = Struct.new(:name, :base_address, :range, :width)
 
+    # Create a shorthand way to reference Origen Core's Bit ACCESS_CODES
+    @@access_hash = Origen::Registers::Bit.const_get(:ACCESS_CODES)
+
     # Import/reader that currently only supports creating registers and bit fields
     def import(file, options = {}) # rubocop:disable CyclomaticComplexity
       require 'kramdown'
@@ -57,24 +60,65 @@ module CrossOrigen
               size = fetch register.at_xpath('spirit:size'), get_text: true, to_i: true
               addr_offset = fetch register.at_xpath('spirit:addressOffset'), get_text: true, to_dec: true
               access = fetch register.at_xpath('spirit:access'), get_text: true
-              reset_value = fetch register.at_xpath('spirit:reset/spirit:value'), get_text: true, to_dec: true
-              reset_mask = fetch register.at_xpath('spirit:reset/spirit:mask'), get_text: true, to_dec: true
-              if [reset_value, reset_mask].include? nil
-                # Set default values for some register attributes
-                reset_value, reset_mask = 0, 0
+              # Determine if a reset is defined for the register
+              if register.at_xpath('spirit:reset').nil?
+                # If a reset does not exist, need to set the reset_value to 0, as Origen does not (yet) have a concept
+                # of a register without a reset.
+                reset_value = 0
               else
-                # Do a logical bitwise AND with the reset value and mask
-                reset_value = reset_value & reset_mask
+                # If a reset exists, determine the reset_value (required) and reset_mask (if defined)
+                reset_value = fetch register.at_xpath('spirit:reset/spirit:value'), get_text: true, to_dec: true
+                reset_mask = fetch register.at_xpath('spirit:reset/spirit:mask'), get_text: true, to_dec: true
+                # Issue #8 fix - reset_mask is optional, keep reset value as imported when a mask is not defined.
+                # Only perform AND-ing if mask is defined.  Only zero-out the reset_value if reset_value was nil.
+                if reset_value.nil?
+                  # Set default for reset_value attribute if none was provided and issue a warning.
+                  reset_value = 0
+                  Origen.log.warning "Register #{name.upcase} was defined as having a reset, but did not have a defined reset value.  This is not compliant with IP-XACT standard."
+                  Origen.log.warning "The reset value for #{name.upcase} has been defined as 0x0 as a result."
+                elsif reset_mask.nil?
+                  # If mask is undefined, leave reset_value alone.
+                else
+                  # Do a logical bitwise AND with the reset value and mask
+                  reset_value = reset_value & reset_mask
+                end
               end
+              # Future expansion: pull in HDL path as abs_path in Origen.
               addr_block_obj.reg name, addr_offset, size: size, access: access, description: reg_description(register) do |reg|
                 register.xpath('spirit:field').each do |field|
                   name = fetch field.at_xpath('spirit:name'), downcase: true, to_sym: true, get_text: true
                   bit_offset = fetch field.at_xpath('spirit:bitOffset'), get_text: true, to_i: true
                   bit_width = fetch field.at_xpath('spirit:bitWidth'), get_text: true, to_i: true
-                  access = fetch field.at_xpath('spirit:access'), get_text: true
-                  if access =~ /\S+\-\S+/
-                    access = access[/^(\S)/, 1] + access[/\-(\S)\S+$/, 1]
-                    access = access.downcase.to_sym
+                  xml_access = fetch field.at_xpath('spirit:access'), get_text: true
+                  # Newer IP-XACT standards list access as < read or write>-< descriptor >, such as
+                  # "read-write", "read-only", or "read-writeOnce"
+                  if xml_access =~ /\S+\-\S+/ || xml_access == 'writeOnce'
+                    # This filter alone is not capable of interpreting the 1685-2009 (and 2014).  Therefore
+                    # must reverse-interpret the content of access_hash (see top of file).
+                    #
+                    # First get the base access type, ie: read-write, read-only, etc.
+                    # base_access = fetch field.at_xpath('spirit:access'), get_text: true
+                    base_access = xml_access
+                    # Next grab any modified write values or read actions
+                    mod_write = fetch field.at_xpath('spirit:modifiedWriteValue'), get_text: true
+                    read_action = fetch field.at_xpath('spirit:readAction'), get_text: true
+                    # Using base_access, mod_write, and read_action, look up the corresponding access
+                    # acronym from access_hash, noting it is not possible to differentiate write-only
+                    # from write-only, read zero and read-write from dc.
+                    #
+                    # Matched needs to be tracked, as there is no way to differentiate :rw and :dc in IP-XACT.
+                    # Everything imported will default to :rw, never :dc.
+                    matched = false
+                    @@access_hash.each_key do |key|
+                      if @@access_hash[key][:base] == base_access && @@access_hash[key][:write] == mod_write && @@access_hash[key][:read] == read_action && !matched
+                        access = key.to_sym
+                        matched = true
+                      end
+                    end
+                  # Older IP-XACT standards appear to also accept short acronyms like "ro", "w1c", "rw",
+                  # etc.
+                  elsif xml_access =~ /\S+/
+                    access = xml_access.downcase.to_sym
                   else
                     # default to read-write if access is not specified
                     access = :rw
@@ -93,7 +137,7 @@ module CrossOrigen
         end
       end
       model.export(filename, include_timestamp: CrossOrigen.include_timestamp?)
-      owner.import(filename)
+      owner.import(filename, options)
     end
 
     def doc(path, options = {})
@@ -117,6 +161,14 @@ xsi:schemaLocation="$REGMEM_HOME/builder/ipxact/schema/ipxact
     end
 
     # Returns a string representing the owner object in IP-XACT XML
+    # Usable / Available options:
+    #   :vendor             = Company name/web address, ex: 'nxp.com'
+    #   :library            = IP Library
+    #   :schema             = '1685-2009' or default of Spirit 1.4 (when no :schema option passed)
+    #   :bus_interface      = only 'AMBA3' supported at this time
+    #   :mmap_name          = Optionally set the memoryMap name to something other than the module name
+    #   :mmap_ref           = memoryMapRef name, ex: 'UserMap'
+    #   :addr_block_name    = addressBlock -> Name, ex: 'ATX'
     def owner_to_xml(options = {})
       require 'nokogiri'
 
@@ -126,21 +178,43 @@ xsi:schemaLocation="$REGMEM_HOME/builder/ipxact/schema/ipxact
 
       @format = options[:format]
 
-      schemas = [
-        'http://www.spiritconsortium.org/XMLSchema/SPIRIT/1.4',
-        'http://www.spiritconsortium.org/XMLSchema/SPIRIT/1.4/index.xsd'
-      ]
-      if uvm?
+      # Compatible schemas: Spirit 1.4, 1685-2009
+      # Assume Spirit 1.4 if no schema provided
+      if options[:schema] == '1685-2009' # Magillem tool uses alternate schema
+        schemas = [
+          'http://www.spiritconsortium.org/XMLSchema/SPIRIT/1685-2009',
+          'http://www.spiritconsortium.org/XMLSchema/SPIRIT/1685-2009/index.xsd'
+        ]
+      else # Assume Spirit 1.4 if not
+        schemas = [
+          'http://www.spiritconsortium.org/XMLSchema/SPIRIT/1.4',
+          'http://www.spiritconsortium.org/XMLSchema/SPIRIT/1.4/index.xsd'
+        ]
+      end
+
+      if uvm? && !(options[:schema] == '1685-2009')
         schemas << '$IREG_GEN/XMLSchema/SPIRIT/VendorExtensions.xsd'
       end
 
-      headers = {
-        'xmlns:spirit'       => 'http://www.spiritconsortium.org/XMLSchema/SPIRIT/1.4',
-        'xmlns:xsi'          => 'http://www.w3.org/2001/XMLSchema-instance',
-        'xsi:schemaLocation' => schemas.join(' ')
-      }
-      if uvm?
+      if options[:schema] == '1685-2009' # Magillem tool uses alternate schema
+        headers = {
+          'xmlns:spirit'       => 'http://www.spiritconsortium.org/XMLSchema/SPIRIT/1685-2009',
+          'xmlns:xsi'          => 'http://www.w3.org/2001/XMLSchema-instance',
+          'xsi:schemaLocation' => schemas.join(' ')
+        }
+      else # Assume Spirit 1.4 if not
+        headers = {
+          'xmlns:spirit'       => 'http://www.spiritconsortium.org/XMLSchema/SPIRIT/1.4',
+          'xmlns:xsi'          => 'http://www.w3.org/2001/XMLSchema-instance',
+          'xsi:schemaLocation' => schemas.join(' ')
+        }
+      end
+
+      if uvm? && !(options[:schema] == '1685-2009')
         headers['xmlns:vendorExtensions'] = '$IREG_GEN/XMLSchema/SPIRIT'
+        # Else:
+        # Do nothing ?
+        # headers['xmlns:vendorExtensions'] = '$UVM_RGM_HOME/builder/ipxact/schema'
       end
 
       builder = Nokogiri::XML::Builder.new(encoding: 'UTF-8') do |xml|
@@ -151,19 +225,48 @@ xsi:schemaLocation="$REGMEM_HOME/builder/ipxact/schema/ipxact
           # I guess this should really be the register owner's owner's name?
           spirit.name try(:ip_name) || owner.class.to_s.split('::').last
           spirit.version try(:ip_version, :version, :revision)
+          # The 1685-2009 schema allows for a bus interface.  AMBA3 (slave) supported so far.
+          if options[:schema] == '1685-2009'
+            if options[:bus_interface] == 'AMBA3'
+              spirit.busInterfaces do
+                spirit.busInterface do
+                  spirit.name 'Slave'
+                  bustype_header = {
+                    'spirit:vendor'  => options[:vendor] || 'Origen',
+                    'spirit:library' => 'amba3',
+                    'spirit:name'    => 'APB3',
+                    'spirit:version' => '1.0'
+                  }
+                  xml['spirit'].busType bustype_header
+                  spirit.slave do
+                    mmapref_header = {
+                      'spirit:memoryMapRef' => options[:mmap_ref] || 'APB'
+                    }
+                    xml['spirit'].memoryMapRef mmapref_header
+                  end
+                end
+              end
+            end
+          end
           spirit.memoryMaps do
             memory_maps.each do |map_name, _map|
               spirit.memoryMap do
-                spirit.name map_name
+                # Optionally assign memory map name to something other than the module name in Ruby,
+                # default to 'RegisterMap'
+                spirit.name options[:mmap_name] || 'RegisterMap'
                 address_blocks do |domain_name, _domain, sub_block|
                   spirit.addressBlock do
+                    # When registers reside at the top level, do not assign an address block name
                     if sub_block == owner
-                      spirit.name nil
-                      spirit.baseAddress 0.to_hex
+                      if options[:addr_block_name].nil?
+                        spirit.name nil
+                      else
+                        spirit.name options[:addr_block_name]
+                      end
                     else
                       spirit.name address_block_name(domain_name, sub_block)
-                      spirit.baseAddress sub_block.base_address.to_hex
                     end
+                    spirit.baseAddress sub_block.base_address.to_hex
                     spirit.range range(sub_block)
                     spirit.width width(sub_block)
                     sub_block.regs.each do |name, reg|
@@ -189,7 +292,94 @@ xsi:schemaLocation="$REGMEM_HOME/builder/ipxact/schema/ipxact
                             spirit.description try(bits, :brief_description, :name_full, :full_name)
                             spirit.bitOffset bits.position
                             spirit.bitWidth bits.size
-                            spirit.access bits.access
+                            # When exporting to 1685-2009 schema, need to handle special cases (writeOnce),
+                            # modifiedWriteValue, and readAction fields.
+                            if options[:schema] == '1685-2009'
+                              if bits.writable? && bits.readable?
+                                if bits.access == :w1
+                                  spirit.access 'read-writeOnce'
+                                else
+                                  spirit.access 'read-write'
+                                end
+                              elsif bits.writable?
+                                if bits.access == :wo1
+                                  spirit.access 'writeOnce'
+                                else
+                                  spirit.access 'write-only'
+                                end
+                              elsif bits.readable?
+                                spirit.access 'read-only'
+                              end
+                              if bits.readable?
+                                unless @@access_hash[bits.access][:read].nil?
+                                  spirit.readAction @@access_hash[bits.access][:read]
+                                end
+                              end
+                              if bits.writable?
+                                unless @@access_hash[bits.access][:write].nil?
+                                  spirit.modifiedWriteValue @@access_hash[bits.access][:write]
+                                end
+                              end
+                            else # Assume Spirit 1.4 if not
+                              spirit.access bits.access
+                            end
+                            # HDL paths provide hooks for a testbench to directly manipulate the
+                            # registers without having to go through a bus interface or read/write
+                            # protocol.  Because the hierarchical path to a register block can vary
+                            # greatly between devices, allow the user to provide an abs_path value
+                            # and define "full_reg_path" to assist.
+                            #
+                            # When registers reside at the top level without a specified path, use 'top'.
+                            if reg.owner.path.nil? || reg.owner.path.empty?
+                              regpath = 'top'
+                            else
+                              regpath = reg.owner.path
+                            end
+                            # If :full_reg_path is defined, the :abs_path metadata for a register will
+                            # be used for regpath.  This can be assigned at an address block (sub-block)
+                            # level.
+                            unless options[:full_reg_path].nil? == true
+                              regpath = reg.path
+                            end
+                            if options[:schema] == '1685-2009'
+                              spirit.parameters do
+                                spirit.parameter do
+                                  spirit.name '_hdlPath_'
+                                  # HDL path needs to be to the declared bit field name, NOT to the bus slice
+                                  # that Origen's "abs_path" will yield.  Ex:
+                                  #
+                                  # ~~~ ruby
+                                  # reg :myreg, 0x0, size: 32 do |reg|
+                                  #   bits 7..4, :bits_high
+                                  #   bits 3..0, :bits_low
+                                  # end
+                                  # ~~~
+                                  #
+                                  # The abs_path to ...regs(:myreg).bits(:bits_low).abs_path will yield
+                                  # "myreg.myreg[3:0]", not "myreg.bits_low".  This is not an understood path
+                                  # in Origen (myreg[3:0] does not exist in either myreg's RegCollection or BitCollection),
+                                  # and does not sync with how RTL would create bits_low[3:0].
+                                  # Therefore, use the path to "myreg"'s owner appended with bits.name (bits_low here).
+                                  #
+                                  # This can be done in a register or sub_blocks definition by defining register
+                                  # metadata for "abs_path".  If the reg owner's path weren't used, but instead the
+                                  # reg's path, that would imply each register was a separate hierarchical path in
+                                  # RTL (ex: "top.myblock.regblock.myreg.myreg_bits"), which is normally not the case.
+                                  # The most likely path would be "top.myblock.regblock.myreg_bits.
+                                  spirit.value "#{regpath}.#{bits.name}"
+                                end
+                              end
+                            end
+                            # C. Hume - Unclear which vendorExtensions should be included by default, if any.
+                            # Future improvment: Allow passing of vendorExtensions enable & value hash/string
+                            # if options[:schema] == '1685-2009'
+                            #   spirit.vendorExtensions do
+                            #     vendorext = { 'xmlns:vendorExtensions' => '$UVM_RGM_HOME/builder/ipxact/schema' }
+                            #     xml['vendorExtensions'].hdl_path vendorext, "#{reg.path}.#{bits.name}"
+                            #   end
+                            # end
+
+                            # Allow optional inclusion of bit field values and descriptions
                             if options[:include_bit_field_values]
                               if bits.bit_value_descriptions[0]
                                 bits.bit_value_descriptions.each do |val, desc|
@@ -201,28 +391,46 @@ xsi:schemaLocation="$REGMEM_HOME/builder/ipxact/schema/ipxact
                                 end
                               end
                             end
-                            if uvm?
+                            if uvm? && !(options[:schema] == '1685-2009')
                               spirit.vendorExtensions do
-                                xml['vendorExtensions'].hdl_path bits.path(relative_to: sub_block)
+                                xml['vendorExtensions'].hdl_path "#{regpath}.#{bits.name}"
                               end
                             end
                           end
                         end
                       end
                     end
-                    if uvm?
-                      spirit.vendorExtensions do
-                        xml['vendorExtensions'].hdl_path sub_block.path(relative_to: owner)
-                      end
-                    end
+                    # Unclear whether addressBlock vendor extensions are supported in Spirit 1.4
+                    # if uvm?
+                    #  spirit.vendorExtensions do
+                    #    xml['vendorExtensions'].hdl_path sub_block.path(relative_to: owner)
+                    #  end
+                    # end
+                  end
+                end
+                # Assume byte addressing if not specified
+                if owner.methods.include?(:lau) == false
+                  if methods.include?(:lau) == true
+                    spirit.addressUnitBits lau
+                  else
+                    spirit.addressUnitBits 8
                   end
+                else
+                  spirit.addressUnitBits owner.lau
                 end
               end
             end
           end
         end
       end
-      builder.to_xml
+      # When testing with 'origen examples', travis_ci (bash) will end up with empty tags -
+      # '<spirit:description/>' that do not appear on some user's tshell environments.  To
+      # prevent false errors for this issue, force Nokogiri to use self-closing tags
+      # ('<spirit:description></spirit:description>'), but keep the XML formatted for readability.
+      # All tags with no content will appear as '<spirit:tag_name></spirit:tag_name>'.
+      #
+      builder.to_xml(save_with: Nokogiri::XML::Node::SaveOptions::NO_EMPTY_TAGS |
+                                Nokogiri::XML::Node::SaveOptions::FORMAT)
     end
 
     private

data/lib/cross_origen_dev/dut.rb

@@ -22,6 +22,7 @@ module CrossOrigenDev
       cr_import(path: "#{Origen.root}/imports/ipxact.xml")
     end
 
+    # Import Spirit 1.4 version of ATX
     def add_atx2
       sub_block :atx2, class_name: 'ATX2', base_address: 0x6000_0000
     end
@@ -31,7 +32,21 @@ module CrossOrigenDev
       include CrossOrigen
 
       def initialize
-        cr_import(path: "#{Origen.root}/approved/ip_xact_sub_block.xml")
+        cr_import(path: "#{Origen.root}/approved/ip_xact_sub_block.xml", refresh: true)
+      end
+    end
+
+    # Import 1685-2009 version of ATX
+    def add_atx3
+      sub_block :atx3, class_name: 'ATX3', base_address: 0x7000_0000
+    end
+
+    class ATX3
+      include Origen::Model
+      include CrossOrigen
+
+      def initialize
+        cr_import(path: "#{Origen.root}/approved/ip_xact_sub_block_1685.xml", refresh: true)
       end
     end
 
@@ -40,21 +55,65 @@ module CrossOrigenDev
       include CrossOrigen
 
       def initialize
-        # A manually defined register for testing the conversion of any specific attributes
+        # A manually defined set of registers for testing the conversion of any specific attributes
 
-        # ** MGATE Clock Divider Register **
-        # The MCLKDIV register is used to divide down the frequency of the HBOSCCLK input. If the MCLKDIV
+        # ** MPU Clock Divider Register **
+        #
+        # The MCLKDIV register is used to divide down the frequency of the OSCCLK input. If the MCLKDIV
         # register is set to value "N", then the output (beat) frequency of the clock divider is OSCCLK / (N+1). The
-        # resulting beats are, in turn, counted by the PTIMER module to control the duration of Flash high-voltage
-        # operations.
+        # resulting beats are, in turn, counted by the TIMER module to control the duration of operations.
         # This is a test of potentially problematic characters ' " \' \" < >
         reg :mclkdiv, 0x0, size: 16, bit_order: 'decrement' do
-          # **Oscillator (Hi)** - Firmware FMU clk source selection. (Note that in addition to this firmware-controlled bit, the
-          # FMU clock source is also dependent on test and power control discretes).
+          # **Oscillator (Hi)** - Clock source selection. (Note that in addition to this firmware-controlled bit, the
+          # clock source is also dependent on test and power control discretes).
           #
-          # 0 | FMU clock is the externally supplied bus clock ipg_clk
-          # 1 | FMU clock is the internal oscillator from the TFS hardblock
+          # 0 | Clock is the externally supplied bus clock bus_clk
+          # 1 | Clock is the internal oscillator from the hardblock
           bit 15, :osch, reset: 1, access: :rw
+          # **Divider Value**
+          #
+          # Used to set clock divider value and test multi-bit import in CrossOrigen
+          bits 3..0, :div
+        end
+
+        # **Access Type Test Register**
+        #
+        # This register tests the IP-XACT export of various bit access types, such as write-one-to-clear,
+        # read-only, etc.
+        reg :access_types, 0x4, size: 32 do
+          # Test read-only access.
+          bit 31, :readonly, access: :ro
+          # Test read-write access.
+          bit 30, :readwrite, access: :rw
+          # Test read-clear access, where a read clears the value afterwards.
+          bit 29, :readclear, access: :rc
+          # Test read-set access, where a read sets the bit afterwards.
+          bit 28, :readset, access: :rs
+          # Test writable, clear-on-read access, etc...
+          bit 27, :writablereadclear, access: :wrc
+          bit 26, :writablereadset, access: :wrs
+          bit 25, :writeclear, access: :wc
+          bit 24, :writeset, access: :ws
+          bit 23, :writesetreadclear, access: :wsrc
+          bit 22, :writeclearreadset, access: :wcrs
+          bit 21, :write1toclear, access: :w1c
+          bit 20, :write1toset, access: :w1s
+          bit 19, :write1totoggle, access: :w1t
+          bit 18, :write0toclear, access: :w0c
+          bit 17, :write0toset, access: :w0s
+          bit 16, :write0totoggle, access: :w0t
+          bit 15, :write1tosetreadclear, access: :w1src
+          bit 14, :write1toclearreadset, access: :w1crs
+          bit 13, :write0tosetreadclear, access: :w0src
+          bit 12, :write0toclearreadset, access: :w0crs
+          bit 11, :writeonly, access: :wo
+          bit 10, :writeonlyclear, access: :woc
+          bit 9, :writeonlyreadzero, access: :worz
+          bit 8, :writeonlyset, access: :wos
+          bit 7, :writeonce, access: :w1
+          bit 6, :writeonlyonce, access: :wo1
+          bit 5, :readwritenocheck, access: :dc
+          bit 4, :readonlyclearafter, access: :rowz
         end
       end
     end

data/templates/test/ip_xact_1685-2009.xml.erb

@@ -0,0 +1 @@
+<%= $dut.to_ip_xact :format => :uvm, :schema=> '1685-2009', :mmap_name => 'RegisterMap', :vendor => 'origen-sdk.org', :library => 'id', :name => 'ipxact',  :mmap_ref => 'test', :bus_interface => 'AMBA3' %>

data/templates/test/ip_xact_sub_block_1685.xml.erb

@@ -0,0 +1 @@
+<%= $dut.atx.to_ip_xact :format => :uvm, :schema=> '1685-2009', :mmap_name => 'RegisterMap', :vendor => 'origen-sdk.org', :library => 'id', :name => 'ipxact_1685_2009' %>

data/templates/web/examples.md.erb

@@ -6,7 +6,8 @@ The following examples are available which are used for testing but
 also provide some code examples of how to use the plugin for the various
 supported formats:
 
-* [IP-XACT Export](<%= path "examples/ip_xact_export" %>)
+* [Spirit 1.4 IP-XACT Export](<%= path "examples/ip_xact_export" %>)
+* [IEEE 1685-2009 IP-XACT Export](<%= path "examples/ip_xact_export_1685_2009" %>)
 * [RALF Export](<%= path "examples/ralf_export" %>)
 * [Origen Export](<%= path "examples/origen_export" %>)
 

data/templates/web/examples/ip_xact_export.md.erb

@@ -1,6 +1,6 @@
 % render "layouts/basic.html", tab: :examples do
 
-## IP-XACT Export
+## IP-XACT Export (Spirit 1.4)
 
 This page shows IP-XACT formatted XML that has been generated from an Origen
 representation of a module.

data/templates/web/examples/ip_xact_export_1685_2009.md.erb

@@ -0,0 +1,32 @@
+% render "layouts/basic.html", tab: :examples do
+
+## IP-XACT Export (IEEE 1685-2009)
+
+This page shows IEEE 1685-2009 IP-XACT formatted XML that has been generated from an Origen
+representation of a module.
+
+The exporter has the following options:
+
+* **:format** - nil by default, can be set to :uvm to include the associated vendor
+  extentions
+* **:include_bit_field_values** - true by default, when false the bit field values 
+  fields will not be output
+* **:schema** - nil by default, which assumes a Spirit 1.4 format. '1685-2009' is also supported.
+* **:mmap_name** - nil by default, can be set to any string name for the memory map name.
+* **:mmap_ref** - nil by default, can be set to any string name for the memory map reference used by a downstream tool.
+* **:vendor** - nil by default, can be set to any string name for the company name.
+* **:library** - nil by default, can be set to any string name for the library used by a downstream tool (ex: Magillem XML -> UVM conversion)
+%#* **:name** - nil by default, can be set to any string name for the an overall device/model name.
+%#* **:bus_interface** - nil by default, can be set to 'AMBA3' for an AMBA3 bus interface.
+
+For this example, targeting CrossOrigen's target/debug.rb, the code to generate this page is:
+
+~~~eruby
+<%= "<" + "%= $dut.to_ip_xact :format => :uvm, :schema=> '1685-2009', :mmap_name => 'RegisterMap', :vendor => 'origen-sdk.org', :library => 'id', :mmap_ref => 'test' %" + ">" %>
+~~~
+
+~~~xml
+<%= $dut.to_ip_xact :format => :uvm, :schema=> '1685-2009', :mmap_name => 'RegisterMap', :vendor => 'origen-sdk.org', :library => 'id', :mmap_ref => 'test' %>
+~~~
+
+% end

data/templates/web/index.md.erb

@@ -35,7 +35,7 @@ Currently the following formats are supported:
 * CMSIS-SVD - Import registers and hierarchy
 * RALF (Synopsys format) - Export registers
 
-See the [examples](<%= path "examples" %>) for format specific documentation, but
+See the [Examples](<%= path "examples" %>) for format specific documentation, but
 most formats should follow this basic structure...
 
 #### Data Import  
@@ -100,7 +100,9 @@ and then compiled through Origen:
 <%= "<" + "%= $dut.to_ip_xact %" + ">" %>
 ~~~
 
-In future support may be added to export directly to a 3rd party tool if
+Please explore the [Examples](<%= path "examples" %>) page to see the differences between Spirit 1.4 and IEEE 1685-2009 IP-XACT export settings.
+
+In the future, support may be added to export directly to a 3rd party tool if
 it provides such an API.
 
 ### How To Setup a Development Environment

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: cross_origen
 version: !ruby/object:Gem::Version
-  version: 1.1.0
+  version: 1.3.0
 platform: ruby
 authors:
 - Stephen McGinty
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2018-05-11 00:00:00.000000000 Z
+date: 2021-05-25 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: origen
@@ -16,14 +16,14 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '0.32'
+        version: 0.59.7
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '0.32'
+        version: 0.59.7
 - !ruby/object:Gem::Dependency
   name: sanitize
   requirement: !ruby/object:Gem::Requirement
@@ -45,7 +45,6 @@ executables: []
 extensions: []
 extra_rdoc_files: []
 files:
-- bin/fix_my_workspace
 - config/application.rb
 - config/boot.rb
 - config/commands.rb
@@ -65,11 +64,14 @@ files:
 - templates/test/default.ralf.erb
 - templates/test/headers_default.h.erb
 - templates/test/ip_xact.xml.erb
+- templates/test/ip_xact_1685-2009.xml.erb
 - templates/test/ip_xact_sub_block.xml.erb
+- templates/test/ip_xact_sub_block_1685.xml.erb
 - templates/web/_history.md
 - templates/web/example.md.erb
 - templates/web/examples.md.erb
 - templates/web/examples/ip_xact_export.md.erb
+- templates/web/examples/ip_xact_export_1685_2009.md.erb
 - templates/web/examples/origen_export.md.erb
 - templates/web/examples/ralf_export.md.erb
 - templates/web/index.md.erb
@@ -94,8 +96,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: 1.8.11
 requirements: []
-rubyforge_project: 
-rubygems_version: 2.6.7
+rubygems_version: 3.1.4
 signing_key: 
 specification_version: 4
 summary: Translators for importing and exporting Origen data to/from 3rd party formats

data/bin/fix_my_workspace

@@ -1,100 +0,0 @@
-#!/usr/bin/env ruby
-$VERBOSE = nil  # Don't care about world writable dir warnings and the like
-
-if $_fix_my_workspace_version_check
-  $_fix_my_workspace_version = '0.7.0'
-else
-  if File.exist?(File.expand_path('../../lib/origen.rb', __FILE__))
-    # If this script is being run from within an origen-core workspace, use that Origen-core,
-    # not the system-installed origen-core version.
-    $LOAD_PATH.unshift(File.expand_path('../../lib', __FILE__))
-    require 'origen'
-  else
-    # Use system-installed Origen (the gem in system Ruby)
-    require 'origen'
-  end
-
-  if !Origen.site_config.gem_manage_bundler
-    puts 'Sorry but you have opted to manage Bundler yourself via your Origen site config, and this means'
-    puts 'that I cannot make certain assumptions about how your workspace is configured.'
-    puts 'You will need to either resolve this problem yourself, or else change the value of'
-    puts 'gem_mange_bundler to true.'
-    puts 'See here for more details on how to do that: http://origen-sdk.org/origen/guides/starting/company/'
-
-  else
-    ENV['BUNDLE_GEMFILE'] = File.join(Origen.root, 'Gemfile')
-    ENV['BUNDLE_PATH'] = File.expand_path(Origen.site_config.gem_install_dir)
-    ENV['BUNDLE_BIN'] = File.join(Origen.root, 'lbin')
-
-    # Force copy system gems to local gems
-    if Origen.site_config.gem_use_from_system
-      local_gem_dir = "#{ENV['BUNDLE_PATH']}/ruby/#{Pathname.new(Gem.dir).basename}"
-      gem_dir = Pathname.new(Gem.dir)
-
-      Origen.site_config.gem_use_from_system.each do |gem, version|
-        begin
-          # This will raise an error if the system doesn't have this gem installed, that
-          # will be rescued below
-          spec = Gem::Specification.find_by_name(gem, version)
-
-          local_dir = File.join(local_gem_dir, Pathname.new(spec.gem_dir).relative_path_from(gem_dir))
-          FileUtils.mkdir_p local_dir
-          FileUtils.cp_r("#{spec.gem_dir}/.", local_dir)
-
-          local_file = Pathname.new(File.join(local_gem_dir, Pathname.new(spec.cache_file).relative_path_from(gem_dir)))
-          FileUtils.mkdir_p local_file.dirname
-          FileUtils.cp(spec.cache_file, local_file)
-
-          if spec.extension_dir && File.exist?(spec.extension_dir)
-            local_dir = File.join(local_gem_dir, Pathname.new(spec.extension_dir).relative_path_from(gem_dir))
-            FileUtils.mkdir_p local_dir
-            FileUtils.cp_r("#{spec.extension_dir}/.", local_dir)
-          end
-
-          local_file = Pathname.new(File.join(local_gem_dir, Pathname.new(spec.spec_file).relative_path_from(gem_dir)))
-          FileUtils.mkdir_p local_file.dirname
-          FileUtils.cp(spec.spec_file, local_file)
-
-        rescue Gem::LoadError
-          # This just means that one of the gems that should be copied from the system
-          # was not actually installed in the system, so nothing we can do about that here
-        end
-      end
-    end
-
-    # Delete lbin
-    FileUtils.rm_rf(ENV['BUNDLE_BIN']) if File.exist?(ENV['BUNDLE_BIN'])
-
-    # Run bundler with correct switches
-    cmd = "bundle install --gemfile #{ENV['BUNDLE_GEMFILE']} --binstubs #{ENV['BUNDLE_BIN']} --path #{ENV['BUNDLE_PATH']}"
-    `chmod o-w #{Origen.root}` # Stops some annoying world writable warnings during install
-    `chmod o-w #{Origen.root}/bin` if File.exist?("#{Origen.root}/bin")
-    `chmod o-w #{Origen.root}/.bin` if File.exist?("#{Origen.root}/.bin")
-
-    # Try again, this time updating the bundle
-    if system(cmd)
-      fixed = true
-    elsif system 'bundle update'
-      fixed = true
-    end
-
-    if File.exist?(ENV['BUNDLE_BIN'])
-      `chmod o-w #{ENV['BUNDLE_BIN']}`
-
-      # Make .bat versions of all executables, Bundler should really be doing this when running
-      # on windows
-      if Origen.os.windows?
-        Dir.glob("#{ENV['BUNDLE_BIN']}/*").each do |bin|
-          unless bin =~ /.bat$/
-            bat = "#{bin}.bat"
-            unless File.exist?(bat)
-              File.open(bat, 'w') { |f| f.write('@"ruby.exe" "%~dpn0" %*') }
-            end
-          end
-        end
-      end
-    end
-
-    system 'origen -v' if fixed
-  end
-end