Subversion Repositories soc_maker

###############################################################

#

#  File:      soc_def_spec.rb

#

#  Author:    Christian Hättich

#

#  Project:   System-On-Chip Maker

#

#  Target:    Linux / Windows / Mac

#

#  Language:  ruby

#

#

###############################################################

#

#

#   Copyright (C) 2014  Christian Hättich  - feddischson [ at ] opencores.org

#

#   This program is free software: you can redistribute it and/or modify

#   it under the terms of the GNU General Public License as published by

#   the Free Software Foundation, either version 3 of the License, or

#   (at your option) any later version.

#

#   This program is distributed in the hope that it will be useful,

#   but WITHOUT ANY WARRANTY; without even the implied warranty of

#   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the

#   GNU General Public License for more details.

#

#   You should have received a copy of the GNU General Public License

#   along with this program.  If not, see .

#

#

###############################################################

#

#   Description:

#     Test spec. for SOCMaker::SOCDef

#

#

#

###############################################################

require_relative( 'spec_helper' )

describe SOCMaker::SOCDef, "structure verification for loading a core-definition" do

  # not implemented at the moment

  # test for invalid path

  # it "should raise an error if a non-existing path is given" do

  #   expect { SOCMaker::from_f( 'blabla.txt' ) }.

  #       to raise_error( IOError )

  # end

  #

  # A yaml example, which contains

  #   - a full definition

  #   - an interface with one port

  #   - one hdl file

  #   - one instance parameter

  #   - one static parameter

  #

  FULL_SOC_YAML = '''SOCM_SOC

name: my_soc

description: A test SOC

id: my_soc,rel2

date: 1.1.2014

license: LGPL

licensefile:

toplevel: soc_top

author: Christian Haettich

authormail: feddischson@opencores.org

repocmd: svn co http://some-address/

'''

SOC_YAML_WITH_CORE = '''SOCM_SOC

name: my_soc

description: A test SOC

id: my_soc,rel2

date: 1.1.2014

license: LGPL

licensefile:

author: Christian Haettich

authormail: feddischson@opencores.org

repocmd: svn co http://some-address/

toplevel: soc_top

cores:

  :inst1: SOCM_INST

    type: mycorerel1

'''

  # process all valid YAMLs

  #  each should result in a CoreDef

  it 'should return a class of type SOCDef when loading a full soc-def' do

    SOCMaker::from_s( FULL_SOC_YAML ).class.should == SOCMaker::SOCDef

  end

  it "should rise an error if soc is loaded with a core, which is not in our library" do

    SOCMaker::lib.clear

    expect { SOCMaker::from_s( SOC_YAML_WITH_CORE ).consistency_check }.

      to raise_error( SOCMaker::ERR::LibError )

  end

  it "should return an SOC-object if soc is loaded with a core, which is in our library" do

    file = { "file.vhd".to_sym => SOCMaker::HDLFile.new( "./file.vhd" ) }

    core = SOCMaker::CoreDef.new( "mycore", "rel1", file, "top" )

    SOCMaker::lib.add_core( core )

    soc = SOCMaker::from_s( SOC_YAML_WITH_CORE )

    soc.class.should be SOCMaker::SOCDef

  end

end

describe SOCMaker::SOCDef, "processing verification" do

    before( :each )do

      file = { "file.vhd".to_sym => SOCMaker::HDLFile.new( "./file.vhd" ) }

      core = SOCMaker::CoreDef.new( "My Core", "mycore,rel1", file, "top" )

      SOCMaker::lib.add_core( core )

      @soc = SOCMaker::SOCDef.new( "Test SOC", "test-soc,v1", "my_soc_top" )

    end

    describe "adding/removing cores, connections etc." do

      it "inst_in_use should return true, if there is already an core instance with that name" do

        @soc.cores[ :core_inst ] = SOCMaker::CoreInst.new( "mycorerel1" )

        @soc.inst_in_use?( "core_inst" ).should be == true

      end

      it "inst_in_use should return false, if there is no core instance with that name" do

        @soc.inst_in_use?( "core_inst" ).should be == false

      end

      it "inst_in_use should return true, if there is already an connection instance with that name" do

        @soc.cons[ :a_con ] = { rule: "or", mapping: [ { :core_a => :ifc_a }, { :core_b => :ifc_b } ] }

        @soc.inst_in_use?( "a_con" ).should be == true

      end

      it "removing a core instance should be possible" do

        @soc.cores[ :core_inst ] = SOCMaker::CoreInst.new( "mycorerel1" )

        @soc.inst_in_use?( "core_inst" ).should be == true

        @soc.rm( "core_inst" ).should be == true

        @soc.inst_in_use?( "core_inst" ).should be == false

      end

      it "removing a connection instance should be possible" do

        @soc.cons[ :a_con ] = { rule: "or", mapping: [ { :core_a => :ifc_a }, { :core_b => :ifc_b } ] }

        @soc.inst_in_use?( "a_con" ).should be == true

        @soc.rm( "a_con" ).should be == true

        @soc.inst_in_use?( "a_con" ).should be == false

      end

      it "should return false, when removing a non-existance instance" do

        @soc.rm( "a_con" ).should be == false

      end

      it "should return nil if a instance is added twice" do

        @soc.cores[ :core_inst ] = SOCMaker::CoreInst.new( "mycorerel1" )

        @soc.add_core(  "mycore,rel1", "core_inst" ).should be == false

      end

      it "should return non-nil value, if a instance is added once" do

        @soc.add_core(  "mycore,rel1", "core_inst" ).should_not be == false

      end

      # in one of the first version, we returned nil, but now this is

      # used to extend a interface

      it "should not return nil if a connection is added twice" do

        @soc.cons[ :a_con ] = { rule: "or", mapping: [ { :core_a => :ifc_a }, { :core_b => :ifc_b } ] }

        @soc.add_connection(  "core_a", "ifc_a", "core_c", "ifc_b", "a_con" ).should_not be == nil

      end

      it "should raise a library error when adding an unknown core" do

        expect{ @soc.add_core( "some_unknown_core,v_xyz", "test" ) }.

          to raise_error( SOCMaker::ERR::LibError )

      end

      it "should create a dir and return the absolute path for a core inside the build/hdl dir" do

        SOCMaker::conf[ :build_dir ] = "./spec/tmp_build"

        SOCMaker::conf[ :hdl_dir   ] = "hdl"

        path = File.expand_path "./spec/tmp_build/hdl/a_core"

        FileUtils.rmdir( path ) if File.directory?( path )

        res = SOCMaker::Component::get_and_ensure_dst_dir!( "a_core" )

        File.directory?( path ).should be == true

        res.should be == path

      end

      it "should return false, when an interface is not used" do

        # setup interface ifc_b and ifc_c, test for ifc_a

        a_con = { rule: "or", mapping: [ { :core_a => :ifc_b }, { :core_b => :ifc_c } ] }

        @soc.cons[ :my_con ] = a_con

        @soc.ifc_in_use?( "core_a", "ifc_a" ).should be == false

      end

      it "should return true, if an interface is used" do

        a_con = { rule: "or", mapping: [ { :core_a => :ifc_a }, { :core_b => :ifc_b } ] }

        @soc.cons[ :my_con ] = a_con

        @soc.ifc_in_use?( "core_a", "ifc_a" ).should be == true

      end

      it "should raise an SOCMaker::ERR::ProcessingError add_connection tries to add a interface, wich is already used" do

        a_con = { rule: "or", mapping: [ { :core_a => :ifc_a }, { :core_b => :ifc_b } ] }

        @soc.cons[ :my_con ] = a_con

        expect{ @soc.add_connection(  "core_a", "ifc_a", "core_b", "ifc_c", "a_new_con" ) }.

          to raise_error( SOCMaker::ERR::ProcessingError )

        expect{ @soc.add_connection(  "core_a", "ifc_a", "core_c", "ifc_b", "a_new_con" ) }.

          to raise_error( SOCMaker::ERR::ProcessingError )

      end

      it "should raise an SOCMaker::ERR::ProcessingError if a connection is added from a non-existing core instance" do

        expect{ @soc.add_connection(  "core_a", "ifc_a", "core_c", "ifc_b", "a_new_con" ) }.

          to raise_error( SOCMaker::ERR::ProcessingError )

      end

      it "should raise an ProcessingError if a interface doesn't exist" do

        @soc.cores[ :core_a ] = SOCMaker::CoreInst.new( "mycore,rel1" )

        @soc.cores[ :core_b ] = SOCMaker::CoreInst.new( "mycore,rel1" )

        expect{ @soc.add_connection(  "core_a", "ifc_a", "core_b", "ifc_c", "a_new_con" ) }.

          to raise_error( SOCMaker::ERR::ProcessingError )

      end

      it "should raise an ProcessingError if the ifc.-version is wrong" do

        ifc_spc1 = SOCMaker::IfcSpc.new( "myifc", "myifc,v1", 'ports' => { port_a: {dir:1}, port_b: {dir:0} } )

        ifc_spc2 = SOCMaker::IfcSpc.new( "myifc", "myifc,v2", 'ports' => { port_a: {dir:1}, port_b: {dir:0} } )

        ifc_def_1 = SOCMaker::IfcDef.new( "myifc", "myifc,v1", 0, { a: SOCMaker::IfcPort.new( "port_a", 1 ) } )

        ifc_def_0 = SOCMaker::IfcDef.new( "myifc", "myifc,v2", 1, { b: SOCMaker::IfcPort.new( "port_b", 1 ) } )

        file = { "file.vhd".to_sym => SOCMaker::HDLFile.new( "./file.vhd" ) }

        core_a = SOCMaker::CoreDef.new( "core_a", "core_a,v1", file, "top" )

        core_b = SOCMaker::CoreDef.new( "core_b", "core_a,v1", file, "top" )

        core_a.interfaces[ :ifc_a ] = ifc_def_0

        core_a.interfaces[ :ifc_b ] = ifc_def_1

        core_b.interfaces[ :ifc_a ] = ifc_def_0

        core_b.interfaces[ :ifc_b ] = ifc_def_1

        SOCMaker::lib.add_ifc( ifc_spc1 )

        SOCMaker::lib.add_ifc( ifc_spc2 )

        SOCMaker::lib.add_core( core_a )

        SOCMaker::lib.add_core( core_b )

        @soc.cores[ :core_a ] = SOCMaker::CoreInst.new( "core_a,v1" )

        @soc.cores[ :core_b ] = SOCMaker::CoreInst.new( "core_b,v1" )

        expect { @soc.add_connection(  "inst_a", "ifc_a", "inst_b", "ifc_b", "a_new_con" ) }.

          to raise_error( SOCMaker::ERR::ProcessingError )

      end

      it "should add a connection entry" do

        ifc_spc = SOCMaker::IfcSpc.new( "myifc", "myifc,v1", 'ports' => { port_a: {dir:1}, port_b: {dir:0} } )

        ifc_def_1 = SOCMaker::IfcDef.new( "myifc", "myifc,v1", 0, { a: SOCMaker::IfcPort.new( "port_a", 1 ),

                                                                    b: SOCMaker::IfcPort.new( "port_b", 1 ) } )

        ifc_def_0 = SOCMaker::IfcDef.new( "myifc", "myifc,v1", 1, { a: SOCMaker::IfcPort.new( "port_a", 1 ),

                                                                    b: SOCMaker::IfcPort.new( "port_b", 1 ) } )

        file = { "file.vhd".to_sym => SOCMaker::HDLFile.new( "./file.vhd" ) }

        core_a = SOCMaker::CoreDef.new( "core_a", "core_a,v1", file, "top" )

        core_b = SOCMaker::CoreDef.new( "core_b", "core_b,v1", file, "top" )

        core_a.interfaces[ :ifc_a ] = ifc_def_0

        core_a.interfaces[ :ifc_b ] = ifc_def_1

        core_b.interfaces[ :ifc_a ] = ifc_def_0

        core_b.interfaces[ :ifc_b ] = ifc_def_1

        SOCMaker::lib.add_ifc( ifc_spc )

        SOCMaker::lib.add_core( core_a )

        SOCMaker::lib.add_core( core_b )

        @soc.cores[ :inst_a ] = SOCMaker::CoreInst.new( "core_a,v1" )

        @soc.cores[ :inst_b ] = SOCMaker::CoreInst.new( "core_b,v1" )

        @soc.consistency_check

        @soc.add_connection(  "inst_a", "ifc_a", "inst_b", "ifc_b", "a_new_con" )

        @soc.cons[ :a_new_con ].should be == { rule:'or', mapping: [ {inst_a: :ifc_a},{inst_b: :ifc_b} ] }

      end

      it "should add a connection entry, which connects the toplevel's port" do

        ifc_spc = SOCMaker::IfcSpc.new( "myifc", "v1", 'ports' => { port_a: {dir:1}, port_b: {dir:0} } )

        ifc_def_1 = SOCMaker::IfcDef.new( "myifc", "v1", 0, { a: SOCMaker::IfcPort.new( "port_a", 1 ),

                                                              b: SOCMaker::IfcPort.new( "port_b", 1 ) } )

        ifc_def_0 = SOCMaker::IfcDef.new( "myifc", "v1", 1, { a: SOCMaker::IfcPort.new( "port_a", 1 ),

                                                              b: SOCMaker::IfcPort.new( "port_b", 1 ) } )

        file = { "file.vhd".to_sym => SOCMaker::HDLFile.new( "./file.vhd" ) }

        core_a = SOCMaker::CoreDef.new( "core_a", "core_a,v1", file, "top" )

        core_a.interfaces[ :ifc_a ] = ifc_def_0

        core_a.interfaces[ :ifc_b ] = ifc_def_1

        SOCMaker::lib.add_ifc( ifc_spc )

        SOCMaker::lib.add_core( core_a )

       SOCMaker::lib.add_core( @soc )

       @soc.interfaces[ :t1 ] = ifc_def_1

       @soc.cores[ :inst_a ] = SOCMaker::CoreInst.new( "core_a,v1" )

       @soc.consistency_check

       @soc.add_connection(  "inst_a", "ifc_a", @soc.id, "t1", "a_new_con" )

       @soc.cons[ :a_new_con ].should be == { rule:'or', mapping: [ {inst_a: :ifc_a},{ @soc.id.to_sym => :t1} ] }

     end

      it "should raise an error, if a parameter of unkonwn core is set" do

        expect{ @soc.set_param( "a_unknown_core", "p1", 1234 ) }.

          to raise_error( SOCMaker::ERR::ProcessingError )

      end

      it "should raise an error, if a parameter of unkonwn core is requested" do

        expect{ @soc.get_param( "a_unknown_core", "p1" ) }.

          to raise_error( SOCMaker::ERR::ProcessingError )

      end

      it "should raise an error, if a unknown parameter is set and requested" do

        file = { "file.vhd".to_sym => SOCMaker::HDLFile.new( "./file.vhd" ) }

        core_a = SOCMaker::CoreDef.new( "core_a", "v1", file, "top" )

        parameter = SOCMaker::Parameter.new( "integer" )

        core_a.inst_parameters[ :p1 ] = parameter

        SOCMaker::lib.add_core( core_a )

        @soc.cores[ :inst_a ] = SOCMaker::CoreInst.new( "core_a,v1" )

        expect{ @soc.set_param( "inst_a", "px", 1234 ) }.

          to raise_error( SOCMaker::ERR::ProcessingError )

        expect{ @soc.get_param( "inst_a", "px" ) }.

          to raise_error( SOCMaker::ERR::ProcessingError )

      end

      it "should set a parameter and provide a parameter" do

        file = { "file.vhd".to_sym => SOCMaker::HDLFile.new( "./file.vhd" ) }

        core_a = SOCMaker::CoreDef.new( "core_a", "core_a,v1", file, "top" )

        parameter = SOCMaker::Parameter.new( "integer" )

        core_a.inst_parameters[ :p1 ] = parameter

        SOCMaker::lib.add_core( core_a )

        @soc.cores[ :inst_a ] = SOCMaker::CoreInst.new( "core_a,v1" )

        @soc.set_param( "inst_a", "p1", 1234 )

        @soc.cores[ :inst_a ].params[ :p1 ].should be == 1234

        @soc.get_param( "inst_a", "p1" ).should be == 1234

      end

      it "should raise an error, if a static-parameter of unkonwn core is set" do

        expect{ @soc.set_sparam( "a_unknown_core", "p1", 1234 ) }.

          to raise_error( SOCMaker::ERR::ProcessingError )

      end

      it "should raise an error, if a statoc-parameter of unkonwn core is requested" do

        expect{ @soc.get_sparam( "a_unknown_core", "p1" ) }.

          to raise_error( SOCMaker::ERR::ProcessingError )

      end

      it "should an error, a static parameter doesn't exist" do

        file = { "file.vhd".to_sym => SOCMaker::HDLFile.new( "./file.vhd" ) }

        core_a = SOCMaker::CoreDef.new( "core_a", "core_a,v1", file, "top" )

        SOCMaker::lib.add_core( core_a )

        @soc.cores[ :inst_a ] = SOCMaker::CoreInst.new( "core_a,v1" )

        expect{ @soc.set_sparam( "core_a,v1", "p1", 1234 ) }.

          to raise_error( SOCMaker::ERR::ProcessingError )

        expect{ @soc.get_sparam( "core_a,v1", "p1" ) }.

          to raise_error( SOCMaker::ERR::ProcessingError )

      end

      it "should set a static-parameter and provide this static parameter" do

        file = { "file.vhd".to_sym => SOCMaker::HDLFile.new( "./file.vhd" ) }

        core_a = SOCMaker::CoreDef.new( "core_a", "core_a,v1", file, "top" )

        pentry = SOCMaker::SParameterEntry.new( "integer", "TOK" )

        parameter = SOCMaker::SParameter.new( "file/path.vhd.src",

                                              "file/path.vhd",

                                              'parameters' => { p1: pentry } )

        core_a.static_parameters[ :p1 ] = parameter

        SOCMaker::lib.add_core( core_a )

        @soc.cores[ :inst_a ] = SOCMaker::CoreInst.new( "core_a,v1" )

        @soc.set_sparam( "core_a,v1", "p1", 1234 )

        @soc.static[ "core_a,v1".to_sym ][ :p1 ].should be == 1234

        @soc.get_sparam( "core_a,v1", "p1" ).should be == 1234

      end

    end

  describe SOCMaker::SOCDef, "object handling, en-decoding:" do

    it "should be possible to encode and decode a core instance" do

      yaml_str = @soc.to_yaml

      o2 = YAML::load( yaml_str )

      @soc.should be == o2

    end

    it "should return false for two non-equal objects" do

      o2 = Marshal::load(Marshal.dump(@soc))

      o2.name << "X"

      ( o2 == @soc ).should be == false

    end

  end

end

# vim: noai:ts=2:sw=2