Subversion Repositories soc_maker

#     This class represents a core definition.

#     It is one of the central classes and holds data,

#     which is used to describe and instanciate this core.

#     In general, instances of this class desribe a core,

#     it's interface and parameters as well as the files,

#     which are required for synthesis/simulation.

#

#     In addition to this core, there exist CoreInst,

#     which represents a concret instanciation of a definition

#     (see core_inst.rb).

#     This class adds two fields to SOCMaker::Component:

#         - hdlfiles           : hash of SOCMaker::HDLFile (mandatory,

#                                at least one file)

#  TODO: this was removed because we want to

#        support cores, which have a config-file only

#        (where config and implementation is in one file)

#   serr_if( coder[ 'hdlfiles' ] == nil,

#     'No hdlfiles field found',

#     instance: @name,

#     fiel:     'hdlfiles' )

#   serr_if( @hdlfiles.size  == 0,

#     'No HDL files are given',

#     instance: @name,

#     field:    'hdlfiles' )

  #

  # TODO  this also exists in component.rb

  #       might this be removed?

  #       If yes, make sure, that the 'default' stuff

  #       is also done in component.rb!!!

  #

  # Iterates over interface list.

  # For each interface, all ports are processed.

  # For each port within each interface, we lookup the port defn

  # and yield the call block with

  #   - port-name

  #   - port-definition

  #   - info if last

  # as argument

  #

  #

  #

  #def ports( *args )

    #if args.size == 0

      #@interfaces.values.each_with_index do | ifc, i_ifc; ifc_def|

        ## get interface definition

        #ifc_def = SOCMaker::lib.get_ifc( ifc.name, ifc.version )

        ## loop over ports in this interface

        #ifc.ports.each_with_index do |(port_name, port_def), i_port; port_dir|

          ## the reference to the port in the definition

          #defn_ref      = port_def.defn

          #port_dir      = ifc_def.ports[ defn_ref.to_sym ][ :dir      ]

          #port_default  = ifc_def.ports[ defn_ref.to_sym ][ :default  ]

          #perr_if( port_dir == nil,

                #"Can't find #{defn_ref} in interface " +

                #"definition #{ifc_def.name} version "  +

                #ifc_def.version + "==>>" + ifc_def.to_yaml )

          ## An xor mechanism between port_dir and ifc=>dir is used

          ## to determine the direction of a port, for example:

          ##  If the interface is declared as input (1) and a port is declared as input (1)

          ##  the resulting direction will be an output 1^1 = 0.

          ##  But if the overall interface direction is an output (0) and a port is declared

          ##  as input, the resulting direction will an input 0^1 = 1.

          ## This allows to define a port-direction in the interface definition,

          ## and toggle the directions on core-definition level.

          ##  (name, direction, length, is_last)

          #yield(  port_name.to_s,

                  #port_dir ^ ifc.dir,

                  #port_def.len,

                  #port_default,

                  #( (i_port == ifc.ports.size-1 ) and (i_ifc == @interfaces.size-1 ) ) )

        #end

      #end

##    elsif args.size == 1

##      # get interface (input is the name as string  )

##      ifc = @interfaces[ args.first.to_sym  ]

##      ifc_def = SOCMaker::lib.get_ifc( ifc.name, ifc.version )

##      ifc.ports.each do |port_name, port_def; port_dir|

##        port_def = port_def.defn

##        port_dir = ifc_def.ports[ port_def.to_sym ]

##        if port_dir == nil

##          perr_if( port_dir==nil,

##              "Can't find #{port_def} in" +

##              "interface definition #{ifc_def.name} " +

##              "version #{ifc_def.version}" )

##        end

##        yield(  port_def.to_s,

##                port_name.to_s,

##                port_dir ^ ifc.dir )

##     end

    #else

    #end

  #end