[wiki:Component SocLib Components General Index] 

= !VciRam Functional Description =

This VCI target is an embedded SRAM controller. This hardware component handles
independent memory segments. Each segment is defined by a base address and a size (number of bytes).
Both the base and the size parameters must be multiple of 4.
The segments allocated to a given instance of this component are defined in the [wiki:Component/MappingTable Mapping Table].

Each segment is implemented as a dynamically allocated array in the constructor.

A !MultiRam will initialize its segments from a binary if an
[wiki:Component/ElfLoader ElfLoader] is attached to it.

= Component definition =

Available in source:trunk/soclib/module/internal_component/vci_ram/caba/metadata/vci_ram.sd

== Usage ==

!VciMultiRam has no other parameter than VCI ones, it may be used like others, see [wiki:SoclibCc/VciParameters SoclibCc/VciParameters]
{{{
Uses( 'vci_multi_ram', **vci_parameters )
}}}

= !VciMultiRam CABA Implementation =

The caba implementation is in 
 * source:trunk/soclib/module/internal_component/vci_ram/caba/source/include/vci_ram.h
 * source:trunk/soclib/module/internal_component/vci_ram/caba/source/src/vci_ram.cpp

== Template parameters: ==
 * The VCI parameters

== Constructor parameters ==

 * Uninitialized !MultiRam
{{{
VciMultiRam(
     sc_module_name name,                     // Instance name
     const soclib::common::IntTab &index,     //  Target index
     const soclib::common::MappingTable &mt)  // Mapping Table
}}}

 * Elf-Initialized !MultiRam
You may load a binary file, by creating a loader:
{{{
soclib::common::ElfLoader loader( "a.out" );
VciMultiRam(
     sc_module_name name,                     // Instance name
     const soclib::common::IntTab &index,     //  Target index
     const soclib::common::MappingTable &mt,  // Mapping Table
     soclib::common::ElfLoader &loader);
}}}
On reset, any loadable segment in ELF file will be reloaded
.
== Ports ==

 * sc_in<bool> '''p_resetn''' : hardware reset
 * sc_in<bool> '''p_clk''' :  clock
 * soclib::common::!VciTarget<vci_param> '''p_vci''' : The VCI port