[wiki:Component SocLib Components General Index] 

= !VciVgmn Functional Description =

This hardware component is a generic micro-network respecting the
VCI advanced protocol. It supports several
simultaneous transaction, and behaves as two fully independent packet switched
network for VCI commands and VCI responses.

When several initiators try to reach the same target, the arbitration
policy is round-robin.
It gives the system designer a generic "communication black-box" with
a parametrized number of VCI initiator ports (NB_INITIATOR), 
and a parameterized number of VCI target ports (NB_TARGET). 
It can be used to build a "flat" interconnect, where
all VCI initiators and targets are identified by a single index:
 * The VCI targets must be indexed from 0 to (NB_TARGET - 1).
 * The VCI initiators must be indexed from 0 to (NB_INITIATOR - 1).

As any VCI advanced compliant interconnect, this component uses
the MSB bits of the VCI ADDRESS field to route the command packets
to the proper target, thanks to a routing table, implemented as a ROM.
This routing table is build by the constructor from the informations stored in
the [wiki:Component/MappingTable mapping table].
It uses the VCI RSRCID field to route the response packet to the initiator.

This component has two "structural" parameters, that can be used to fit
the behaviour of a specific physical micro-network:
 * The MIN_LATENCY parameter is a number of cycles that defines the latency of an empty network.
 * The FIFO_DEPTH parameter can be increased to improve the saturation threshold.

= Component definition =

Available in source:trunk/soclib/module/network_component/vci_vgmn/caba/metadata/vci_vgmn.sd

== Usage ==

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

= !VciVgmn CABA  Implementation =

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

== Template parameters ==

{{{
template<typename vci_param>
}}}

== Constructor parameters ==

{{{
VciVgmn(
     sc_module_name name,   //  Component Name
     const soclib::common::MappingTable &mt,
     size_t nb_initiator,
     size_t nb_target,
     size_t min_latency,
     size_t fifo_depth );
}}}

== Ports ==

 * sc_in<bool> '''p_resetn''' : Global system reset
 * sc_in<bool> '''p_clk''' : Global system clock
 * soclib::caba::!VciTarget<vci_param> '''p_from_initiator[]''' : Ports from VCI initiators
 * soclib::caba::!VciInitiator<vci_param> '''p_to_target[]''' : Ports to VCI targets

== Implementation notes ==

Each micro network (the Command network and the Response network) is implemented within the same
templated code. This code is instanciated twice, once for each network.

[[Image(micro_network.png, nolink, align=right)]]

There is one !InputRouter object per input port, it handles incoming packets and
forwards them to the right !OutputPortQueue.

There is one !OutputPortQueue object per output port. Each output port j contains as many fifo[i,j] as input ports,
and one single delay line. The delay line implements the MIN_LATENCY parameter, and fifo[i,j] correspond
to the distributed fifos on the path between the input port i and the output port j.
minimal latency parameter, and the  handles putting packets on output port.