ipxact-ruby 0.11.1

data/spec/test_data/spiritconsortium.org/Leon2TLM/uart_tac/1.0/tlmsrc/src/user_specific_Leon2_uart.cc

@@ -0,0 +1,146 @@
+// 
+// Revision:    $Revision: 1506 $
+// Date:        $Date: 2009-04-26 01:51:56 -0500 (Sun, 26 Apr 2009) $
+// 
+// Copyright (c) 2005, 2006, 2007, 2008, 2009 The SPIRIT Consortium.
+// 
+// This work forms part of a deliverable of The SPIRIT Consortium.
+// 
+// Use of these materials are governed by the legal terms and conditions
+// outlined in the disclaimer available from www.spiritconsortium.org.
+// 
+// This source file is provided on an AS IS basis.  The SPIRIT
+// Consortium disclaims any warranty express or implied including
+// any warranty of merchantability and fitness for use for a
+// particular purpose.
+// 
+// The user of the source file shall indemnify and hold The SPIRIT
+// Consortium and its members harmless from any damages or liability.
+// Users are requested to provide feedback to The SPIRIT Consortium
+// using either mailto:feedback@lists.spiritconsortium.org or the forms at 
+// http://www.spiritconsortium.org/about/contact_us/
+// 
+// This file may be copied, and distributed, with or without
+// modifications; this notice must be included on any copy.
+
+/* -----------------------------------------------------------------------
+ * Includes
+ * ----------------------------------------------------------------------- */
+
+#include "systemc.h"                              /* SystemC include file */
+#include "Leon2_uart.h"
+
+#include "def_Leon2_uart.h"
+
+namespace Leon2 {
+
+  /* -----------------------------------------------------------------------
+   * define the method and thread sensitivity and the end of the constructor
+   * ----------------------------------------------------------------------- */
+
+  void uart::method_and_thread_sensitivity()
+  {
+  }
+
+
+  /***************************************************************************
+   * \brief   Slave read_block Interface
+   **************************************************************************/
+
+  
+  prt_tlm_tac::tac_status uart::read_block(const tlm_uint32_t & address_tlmske,
+                                                 tlm_uint32_t * block_data_tlmske,
+                                                 const unsigned int number,
+                                                 prt_tlm_tac::tac_error_reason& error_reason,
+                                                 unsigned int * block_byte_enable,
+                                                 const unsigned int block_byte_enable_period,
+                                                 const prt_tlm_tac::tac_mode mode,
+                                                 const unsigned int target_port_id
+                                                 ) {
+    prt_tlm_tac::tac_status status_tlmske;
+
+    switch(target_port_id)
+    {
+
+      case Leon2_uart_ambaAPB_ID:
+        DEBUG_REPORT(3,"\ttarget_port_id = Leon2_uart_ambaAPB_ID\n");
+        break;
+
+      default:
+        status_tlmske.set_error();
+        error_reason.set_reason("Error,  no businterface at that ID ");
+        string msg_tlmske = "Error, can not write at address ";
+        ERROR_REPORT(2,"\t%s: %s 0x%X T:%9.9f\n",
+                     name(),msg_tlmske.c_str(),(unsigned int)address_tlmske,(float)(sc_time_stamp().to_seconds()));
+        break;
+    }
+  }
+
+  /***************************************************************************
+   * \brief   Slave write_block Interface
+   **************************************************************************/
+
+  
+  prt_tlm_tac::tac_status uart::write_block(const tlm_uint32_t& address_tlmske,
+                                                  const tlm_uint32_t * block_data_tlmske,
+                                                  const unsigned int number,
+                                                  prt_tlm_tac::tac_error_reason& error_reason,
+                                                  unsigned int * block_byte_enable,
+                                                  const unsigned int block_byte_enable_period,
+                                                  const prt_tlm_tac::tac_mode mode,
+                                                  const unsigned int target_port_id
+                                                  ) {
+    prt_tlm_tac::tac_status status_tlmske;
+
+    switch(target_port_id)
+    {
+
+      case Leon2_uart_ambaAPB_ID:
+        DEBUG_REPORT(3,"\ttarget_port_id = Leon2_uart_ambaAPB_ID\n");
+        break;
+
+      default:
+        status_tlmske.set_error();
+        error_reason.set_reason("Error, no businterface at that ID ");
+        string msg_tlmske = "Error, can not write at address ";
+        ERROR_REPORT(2,"\t%s: %s 0x%X T:%9.9f\n",
+                     name(),msg_tlmske.c_str(),(unsigned int)address_tlmske,(float)(sc_time_stamp().to_seconds()));
+        break;
+    }
+  };
+
+  /***************************************************************************
+   * \brief   Slave set_target_info Interface
+   **************************************************************************/
+
+  
+  prt_tlm_tac::tac_status uart::set_target_info(const tlm_uint32_t& address_tlmske,
+                                                      const prt_tlm_tac::tac_metadata& metadata,
+                                                      prt_tlm_tac::tac_error_reason& error_reason,
+                                                      const unsigned int target_port_id
+                                                      ) {
+    prt_tlm_tac::tac_status status_tlmske;
+
+    switch(target_port_id)
+    {
+
+      case Leon2_uart_ambaAPB_ID:
+        error_reason.set_reason("set info for port ID : Leon2_uart_ambaAPB_ID using metadata not supported");
+        ERROR_REPORT(2,"\t%s: %s T:%9.9f\n",
+                     name(),error_reason.get_reason().c_str(),
+                     (float)(sc_time_stamp().to_seconds()));
+        status_tlmske.set_error();
+        break;
+
+      default:
+        status_tlmske.set_error();
+        break;
+    }
+
+    DEBUG_REPORT(3,"\t%s: set_target_info at 0x%X T:%9.9f\n", 
+                 name(),(unsigned int)address_tlmske,(float)(sc_time_stamp().to_seconds()));
+
+    return(status_tlmske);
+  }
+
+}                                                 // end namespace Leon2

data/spec/test_data/spiritconsortium.org/Leon2TLM/uart_tac/1.0/uart_tac.xml

@@ -0,0 +1,222 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+// 
+// Revision:    $Revision: 1506 $
+// Date:        $Date: 2009-04-26 01:51:56 -0500 (Sun, 26 Apr 2009) $
+// 
+// Copyright (c) 2005, 2006, 2007, 2008, 2009 The SPIRIT Consortium.
+// 
+// This work forms part of a deliverable of The SPIRIT Consortium.
+// 
+// Use of these materials are governed by the legal terms and conditions
+// outlined in the disclaimer available from www.spiritconsortium.org.
+// 
+// This source file is provided on an AS IS basis.  The SPIRIT
+// Consortium disclaims any warranty express or implied including
+// any warranty of merchantability and fitness for use for a
+// particular purpose.
+// 
+// The user of the source file shall indemnify and hold The SPIRIT
+// Consortium and its members harmless from any damages or liability.
+// Users are requested to provide feedback to The SPIRIT Consortium
+// using either mailto:feedback@lists.spiritconsortium.org or the forms at 
+// http://www.spiritconsortium.org/about/contact_us/
+// 
+// This file may be copied, and distributed, with or without
+// modifications; but this notice must be included on any copy.
+-->
+<spirit:component xmlns:spirit="http://www.spiritconsortium.org/XMLSchema/SPIRIT/1.5" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.spiritconsortium.org/XMLSchema/SPIRIT/1.5 http://www.spiritconsortium.org/XMLSchema/SPIRIT/1.5/index.xsd">
+  <spirit:vendor>spiritconsortium.org</spirit:vendor>
+  <spirit:library>Leon2TLM</spirit:library>
+  <spirit:name>uart_tac</spirit:name>
+  <spirit:version>1.0</spirit:version>
+  <spirit:busInterfaces>
+    <spirit:busInterface>
+      <spirit:name>ambaAPB</spirit:name>
+      <spirit:busType spirit:library="AMBA2" spirit:name="APB" spirit:vendor="amba.com" spirit:version="r2p0_4"/>
+      <spirit:abstractionType spirit:library="SPG" spirit:name="tlm_tac" spirit:vendor="st.com" spirit:version="2.0"/>
+      <spirit:slave>
+        <spirit:memoryMapRef spirit:memoryMapRef="ambaAPB"/>
+      </spirit:slave>
+      <spirit:portMaps>
+        <spirit:portMap>
+          <spirit:logicalPort>
+            <spirit:name>tac_if</spirit:name>
+          </spirit:logicalPort>
+          <spirit:physicalPort>
+            <spirit:name>ambaAPB</spirit:name>
+          </spirit:physicalPort>
+        </spirit:portMap>
+      </spirit:portMaps>
+    </spirit:busInterface>
+  </spirit:busInterfaces>
+  <spirit:memoryMaps>
+    <spirit:memoryMap>
+      <spirit:name>ambaAPB</spirit:name>
+      <spirit:addressBlock>
+        <spirit:name>ambaAPB</spirit:name>
+        <spirit:baseAddress>0</spirit:baseAddress>
+        <spirit:range>24</spirit:range>
+        <spirit:width>32</spirit:width>
+        <spirit:usage>register</spirit:usage>
+        <spirit:register>
+          <spirit:name>data</spirit:name>
+          <spirit:description>Data read/write register</spirit:description>
+          <spirit:addressOffset>0x0</spirit:addressOffset>
+          <spirit:size>32</spirit:size>
+          <spirit:access>read-write</spirit:access>
+          <spirit:reset>
+            <spirit:value>0x0</spirit:value>
+          </spirit:reset>
+        </spirit:register>
+        <spirit:register>
+          <spirit:name>status</spirit:name>
+          <spirit:description>Status register</spirit:description>
+          <spirit:addressOffset>0x4</spirit:addressOffset>
+          <spirit:size>32</spirit:size>
+          <spirit:access>read-only</spirit:access>
+          <spirit:reset>
+            <spirit:value>0x6</spirit:value>
+          </spirit:reset>
+        </spirit:register>
+        <spirit:register>
+          <spirit:name>control</spirit:name>
+          <spirit:description>Control register</spirit:description>
+          <spirit:addressOffset>0x8</spirit:addressOffset>
+          <spirit:size>32</spirit:size>
+          <spirit:access>read-write</spirit:access>
+          <spirit:reset>
+            <spirit:value>0x0</spirit:value>
+          </spirit:reset>
+        </spirit:register>
+        <spirit:register>
+          <spirit:name>scalarReload</spirit:name>
+          <spirit:description>Scalar reload register</spirit:description>
+          <spirit:addressOffset>0xC</spirit:addressOffset>
+          <spirit:size>32</spirit:size>
+          <spirit:access>read-write</spirit:access>
+          <spirit:reset>
+            <spirit:value>0x0</spirit:value>
+          </spirit:reset>
+        </spirit:register>
+      </spirit:addressBlock>
+    </spirit:memoryMap>
+  </spirit:memoryMaps>
+  <spirit:model>
+    <spirit:views>
+      <spirit:view>
+        <spirit:name>PV</spirit:name>
+        <spirit:envIdentifier>systemCSource::</spirit:envIdentifier>
+        <spirit:language>systemCSource</spirit:language>
+        <spirit:modelName>Leon2::uart</spirit:modelName>
+        <spirit:fileSetRef>
+          <spirit:localName>fs-scSource</spirit:localName>
+        </spirit:fileSetRef>
+      </spirit:view>
+    </spirit:views>
+    <spirit:ports>
+      <spirit:port>
+        <spirit:name>ambaAPB</spirit:name>
+        <spirit:transactional>
+          <spirit:transTypeDef>
+            <spirit:typeName>prt_tlm_tac::tac_target_port</spirit:typeName>
+            <spirit:typeDefinition>tac_target_port.h</spirit:typeDefinition>
+          </spirit:transTypeDef>
+          <spirit:service>
+            <spirit:initiative>provides</spirit:initiative>
+            <spirit:serviceTypeDefs>
+              <spirit:serviceTypeDef>
+                <spirit:typeName spirit:implicit="true">TAC</spirit:typeName>
+                <spirit:parameters>
+                  <spirit:parameter>
+                    <spirit:name>BFM_ADDRESS_TYPE</spirit:name>
+                    <spirit:value spirit:resolve="immediate">tlm_uint32_t</spirit:value>
+                  </spirit:parameter>
+                  <spirit:parameter>
+                    <spirit:name>BFM_DATA_TYPE</spirit:name>
+                    <spirit:value spirit:resolve="immediate">tlm_uint32_t</spirit:value>
+                  </spirit:parameter>
+                </spirit:parameters>
+              </spirit:serviceTypeDef>
+            </spirit:serviceTypeDefs>
+          </spirit:service>
+        </spirit:transactional>
+        <spirit:access>
+          <spirit:portAccessType>ref</spirit:portAccessType>
+          <spirit:portAccessHandle>ambaAPB</spirit:portAccessHandle>
+        </spirit:access>
+      </spirit:port>
+    </spirit:ports>
+    <spirit:modelParameters>
+      <spirit:modelParameter spirit:dataType="sc_module_name" spirit:usageType="nontyped">
+        <spirit:name>module_name</spirit:name>
+        <spirit:value spirit:id="moduleName_id" spirit:resolve="generated" spirit:configGroups="requiredConfig" spirit:format="string" spirit:prompt="module name"/>
+      </spirit:modelParameter>
+      <spirit:modelParameter spirit:dataType="bool" spirit:usageType="nontyped">
+        <spirit:name>resetOnInitialize</spirit:name>
+        <spirit:value spirit:id="resetOnInitialize_id" spirit:resolve="user" spirit:configGroups="requiredConfig" spirit:format="bool" spirit:prompt="whether reset() should be invoked at startup time">true</spirit:value>
+      </spirit:modelParameter>
+      <spirit:modelParameter spirit:dataType="unsigned int" spirit:usageType="nontyped">
+        <spirit:name>debug_level</spirit:name>
+        <spirit:value spirit:id="debug_level_id" spirit:resolve="user" spirit:configGroups="requiredConfig" spirit:format="long" spirit:prompt="debug level">0</spirit:value>
+      </spirit:modelParameter>
+      <spirit:modelParameter spirit:dataType="tlm_endianness endianness" spirit:usageType="nontyped">
+        <spirit:name>endianness</spirit:name>
+        <spirit:value spirit:id="endianness_id" spirit:resolve="user" spirit:choiceRef="endianness" spirit:configGroups="requiredConfig" spirit:prompt="use specific endianness">TLM_BIG_ENDIAN</spirit:value>
+      </spirit:modelParameter>
+    </spirit:modelParameters>
+  </spirit:model>
+  <spirit:choices>
+    <spirit:choice>
+      <spirit:name>endianness</spirit:name>
+      <spirit:enumeration spirit:text="TLM_BIG_ENDIAN">TLM_BIG_ENDIAN</spirit:enumeration>
+      <spirit:enumeration spirit:text="TLM_LITTLE_ENDIAN">TLM_LITTLE_ENDIAN</spirit:enumeration>
+      <spirit:enumeration spirit:text="TLM_HOST_ENDIAN">TLM_HOST_ENDIAN</spirit:enumeration>
+    </spirit:choice>
+  </spirit:choices>
+  <spirit:fileSets>
+    <spirit:fileSet>
+      <spirit:name>fs-scSource</spirit:name>
+      <spirit:file>
+        <spirit:name>./tlmsrc/src/Leon2_uart.cpp</spirit:name>
+        <spirit:fileType>systemCSource</spirit:fileType>
+        <spirit:dependency>./include</spirit:dependency>
+      </spirit:file>
+      <spirit:file>
+        <spirit:name>./tlmsrc/src/tlmreg_Leon2_uart.cpp</spirit:name>
+        <spirit:fileType>systemCSource</spirit:fileType>
+        <spirit:dependency>./include</spirit:dependency>
+      </spirit:file>
+      <spirit:file>
+        <spirit:name>./tlmsrc/src/user_specific_Leon2_uart.cpp</spirit:name>
+        <spirit:fileType>systemCSource</spirit:fileType>
+        <spirit:dependency>./include</spirit:dependency>
+      </spirit:file>
+      <spirit:file>
+        <spirit:name>./tlmsrc/include/Leon2_uart.h</spirit:name>
+        <spirit:fileType>systemCSource</spirit:fileType>
+        <spirit:isIncludeFile spirit:externalDeclarations="true">true</spirit:isIncludeFile>
+      </spirit:file>
+      <spirit:file>
+        <spirit:name>./tlmsrc/include/def_Leon2_uart.h</spirit:name>
+        <spirit:fileType>systemCSource</spirit:fileType>
+        <spirit:isIncludeFile>true</spirit:isIncludeFile>
+      </spirit:file>
+      <spirit:file>
+        <spirit:name>./tlmsrc/include/tlmreg_Leon2_uart.h</spirit:name>
+        <spirit:fileType>systemCSource</spirit:fileType>
+        <spirit:isIncludeFile>true</spirit:isIncludeFile>
+      </spirit:file>
+      <spirit:file>
+        <spirit:name>./tlmsrc/include/tlm_field.h</spirit:name>
+        <spirit:fileType>systemCSource</spirit:fileType>
+        <spirit:isIncludeFile>true</spirit:isIncludeFile>
+      </spirit:file>
+      <spirit:file>
+        <spirit:name>./tlmsrc/include/tlm_register.h</spirit:name>
+        <spirit:fileType>systemCSource</spirit:fileType>
+        <spirit:isIncludeFile>true</spirit:isIncludeFile>
+      </spirit:file>
+    </spirit:fileSet>
+  </spirit:fileSets>
+</spirit:component>

data/spec/unit/component_spec.rb

@@ -0,0 +1,98 @@
+# Copyright (C) 2010 TIMA Laboratory
+#
+# 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 <http://www.gnu.org/licenses/>.
+#
+
+require File.join File.dirname(__FILE__), '../../lib/ipxact'
+
+describe IPXACT::Component do
+ 
+  it "should create new components without subcomponents, interconnections or ports" do
+    component = IPXACT::Component.new("instance_name",  "component_name", "component_vendor", "0.0")
+    component.should have(0).subcomponents
+    component.should have(0).interconnections
+    component.should have(0).ports
+    component[:name].should == "component_name"
+    component[:vendor].should == "component_vendor"
+    component[:version].should == "0.0"
+    component[:instance_name].should == "instance_name"
+  end
+
+  it "should be able to get the register map of a given dma device" do
+    components = IPXACT::load_components(PLATFORM_PATH)
+    designs = IPXACT::load_designs(PLATFORM_PATH)
+    platform = IPXACT::Parser::PlatformData.parse_platform(["Leon2Platform", "1.1"], components, designs)
+
+    dma_component = platform.components['i_dma']
+
+    registers = dma_component.register_map
+    registers.should include(
+      {
+        :name => 'sourceAddress',
+        :offset => '0x0',
+        :size => '32',
+        :access => 'read-write'
+      }
+    )
+    registers.should include(
+      {
+        :name => 'destinationAddress',
+        :offset => '0x4',
+        :size => '32',
+        :access => 'read-write'
+      }
+    )
+  end
+
+  it "should be able to get the register map of a given cgu device" do
+    components = IPXACT::load_components(PLATFORM_PATH)
+    designs = IPXACT::load_designs(PLATFORM_PATH)
+    platform = IPXACT::Parser::PlatformData.parse_platform(["Leon2Platform", "1.2"], components, designs)
+
+    cgu_component = platform.components['i_cgu']
+    cgu_component.should_not be_nil
+
+    registers = cgu_component.register_map
+    registers.should include(
+      {
+        :name => 'clock0Divide',
+        :offset => '0x0',
+        :size => '32',
+        :access => 'read-write'
+      }
+    )
+    
+  end
+
+  it "should raise an exception if the component has no register map" do
+    components = IPXACT::load_components(PLATFORM_PATH)
+    designs = IPXACT::load_designs(PLATFORM_PATH)
+    platform = IPXACT::Parser::PlatformData.parse_platform(["Leon2Platform", "1.1"], components, designs)
+
+    ahb_component = platform.components['i_ahb']
+    lambda {
+      ahb_component.register_map
+    }.should raise_exception
+  end
+
+  it "should enable the description of a valid devfs suffix for the dma" do
+    components = IPXACT::load_components(PLATFORM_PATH)
+    designs = IPXACT::load_designs(PLATFORM_PATH)
+    platform = IPXACT::Parser::PlatformData.parse_platform(["Leon2Platform", "1.1"], components, designs)
+
+    dma = platform.components['i_dma']
+    (dma[:name] + '/' + dma[:vendor] + '/x/y').should == 'dma/spiritconsortium.org/x/y'
+    
+  end
+end