Changes between Version 2 and Version 3 of Component/Vci Local Crossbar

Timestamp:

Feb 9, 2008, 11:36:38 PM (16 years ago)

Author:

alain

Comment:

--

Component/Vci Local Crossbar

@@ -1 +1 @@
 [wiki:Component SocLib Components General Index] 
 
-= !VciLocalCrossbar Functional Description =
+= !VciLocalCrossbar =
 
-This hardware component is a generic VCI crossbar, it contains two
-independant crossbars for VCI commands and VCI responses.
+== 1) Functional Description ==
+
+This hardware component is a VCI compliant full crossbar, it contains two
+independant crossbars for VCI commands and VCI responses. It must only
+be used in clusterized architecture, to interconnect a limited number of
+VCI initiators and targets in a local sub-system. The associated sub-system
+is identified by a global index.
+
+ * The number of VCI initiators is a parameter that should not be larger than 4.
+ * The number of VCI targets is a parameter that should not be larger than 4.
+  
+The !VciLocalCrossbar component has a dedicated VCI interface (both initiator and target)
+to connect the local subsystem to the global VCI interconnect. 
 
 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). 
 
 As any VCI advanced compliant interconnect, this component uses
@@ -19 +27 @@
 It uses the VCI RSRCID field to route the response packet to the initiator.
 
-= Component definition =
+== 2) Component definition & usage ==
 
-Available in source:trunk/soclib/module/network_component/vci_local_crossbar/caba/metadata/vci_local_crossbar.sd
+source:trunk/soclib/module/network_component/vci_local_crossbar/caba/metadata/vci_local_crossbar.sd
 
-== Usage ==
-
-!VciLocalCrossbar has no other parameter than VCI ones, it may be used like others,
-see [wiki:SoclibCc/VciParameters SoclibCc/VciParameters]
+See [wiki:SoclibCc/VciParameters SoclibCc/VciParameters]
 {{{
 Uses( 'vci_local_crossbar', **vci_parameters )
 }}}
 
-= !VciLocalCrossbar CABA  Implementation =
+== 3) CABA  Implementation ==
 
-The caba implementation is in 
- * source:trunk/soclib/module/network_component/vci_local_crossbar/caba/source/include/vci_local_crossbar.h
- * source:trunk/soclib/module/network_component/vci_local_crossbar/caba/source/src/vci_local_crossbar.cpp
-It wraps a [wiki:Component/VciSimpleCrossbar VciSimpleCrossbar].
+=== CABA sources ===
 
-== Template parameters ==
+ * interface : source:trunk/soclib/soclib/module/network_component/vci_local_crossbar/caba/source/include/vci_local_crossbar.h
+ * implementation : source:trunk/soclib/soclib/module/network_component/vci_local_crossbar/caba/source/src/vci_local_crossbar.cpp
 
-{{{
-template<typename vci_param>
-}}}
-
-== Constructor parameters ==
+=== CABA Constructor parameters ===
 
 {{{
 VciLocalCrossbar(
-     sc_module_name name,
-     const soclib::common::MappingTable &mt,
-     const soclib::common::IntTab &index,
-     size_t nb_initiator,
-     size_t nb_target );
+     sc_module_name name,  //  instance name
+     const soclib::common::MappingTable &mt,  // mapping table
+     const soclib::common::IntTab &index,  //  global sub-system index
+     size_t nb_initiator,  //  number of VCI initiators
+     size_t nb_target ); // number of VCI targets
 }}}
 
-== Ports ==
+=== CABA Ports ===
 
  * sc_in<bool> '''p_resetn''' : Global system reset