MatchLib
Public Types | Public Member Functions | Public Attributes | Static Public Attributes | List of all members
AxiSplitter< axiCfg, numSlaves, numAddrBitsToInspect, default_output, translate_addr > Class Template Reference

An n-way splitter that connects a single AXI master port to a multiple AXI slave ports. More...

#include <AxiSplitter.h>

Inheritance diagram for AxiSplitter< axiCfg, numSlaves, numAddrBitsToInspect, default_output, translate_addr >:

Public Types

typedef axi::axi4< axiCfg > axi4_
 
typedef axi4_::read::template master::ARPort axi_rd_master_ar
 
typedef axi4_::read::template master::RPort axi_rd_master_r
 
typedef axi4_::write::template master::AWPort axi_wr_master_aw
 
typedef axi4_::write::template master::WPort axi_wr_master_w
 
typedef axi4_::write::template master::BPort axi_wr_master_b
 

Public Member Functions

 SC_HAS_PROCESS (AxiSplitter)
 
 AxiSplitter (sc_module_name name)
 
void run_r ()
 
void run_w ()
 

Public Attributes

sc_in< bool > clk
 
sc_in< bool > reset_bar
 
nvhls::nv_array< axi_rd_master_ar, numSlaves > axi_rd_s_ar
 
nvhls::nv_array< axi_rd_master_r, numSlaves > axi_rd_s_r
 
nvhls::nv_array< axi_wr_master_aw, numSlaves > axi_wr_s_aw
 
nvhls::nv_array< axi_wr_master_w, numSlaves > axi_wr_s_w
 
nvhls::nv_array< axi_wr_master_b, numSlaves > axi_wr_s_b
 
axi4_::read::template slave axi_rd_m
 
axi4_::write::template slave axi_wr_m
 
sc_in< NVUINTW(numAddrBitsToInspect)> addrBound [numSlaves][2]
 

Static Public Attributes

static const int kDebugLevel = 5
 
static const unsigned int log_numSlaves = nvhls::log2_ceil<numSlaves>::val + 1
 

Detailed Description

template<typename axiCfg, int numSlaves, int numAddrBitsToInspect = axiCfg::addrWidth, bool default_output = false, bool translate_addr = false>
class AxiSplitter< axiCfg, numSlaves, numAddrBitsToInspect, default_output, translate_addr >

An n-way splitter that connects a single AXI master port to a multiple AXI slave ports.

Template Parameters
axiCfgA valid AXI config.
numSlavesThe number of slaves to send traffic to.
numAddrBitsToInspectThe number of address bits to inspect when determining which slave to direct traffic to. If this is less than the full address width, the routing determination will be made based on the number of address LSBs specified. (Default: axiCfg::addrWidth)
default_outputIf true, requests with addresses that do not fall in any of the specified address ranges will be directed to the highest-indexed slave port. (Default: false)
translate_addrIf true, requests are re-addressed relative to the base address of the receiving slave when they are passed through the splitter. (Default: false)
Overview
AxiSplitter connects one or more AXI slaves to a single AXI master. Requests from the master are routed by address to the appropriate slave.
  • The address ranges for each slave must be contiguous (except for the highest-indexed slave if default_output is true). Address bounds for each slave are set by writing to a (numSlaves x 2) array of sc_in.
  • Only a single outstanding request to all slaves is allowed; AxiSplitter blocks further requests until the response has been returned.
  • As implemented, the splitter directs all writes from a burst to the destination indicated by the base address of the burst. Guards against crossing address boundaries are not implemented.
  • The AXI configs of all ports must be the same.
Usage Guidelines

This module sets the stall mode to flush by default to mitigate possible RTL bugs that can occur in the default stall mode. If you are confident that this class of bugs will not occur in your use case, you can change the stall mode via TCL directive:

directive set /path/to/AxiSplitter/run_r/while -PIPELINE_STALL_MODE stall

This may reduce area/power.

Definition at line 62 of file AxiSplitter.h.


The documentation for this class was generated from the following file: