|
qualcomm/qbox
|

Directories | |
| include | |
| src | |
The SystemC router maps address ranges from initiator sockets to target sockets. It provides b_transport, debug transport, and DMI forwarding. The router adds regions from CCI socket parameters or through add_target.
The default type is gs::router<BUSWIDTH> and uses AddrMapNoCache. Address ranges can overlap. The target with the lowest numeric priority wins. If priorities are equal, the mapping added most recently wins in the overlap. The default priority is 0. Targets can receive either relative addresses (the default) or absolute addresses.
The router's add_target convenience function accepts a target socket, base address, size, a relative-address flag, and an optional priority. Initiators bind to target_socket; the router's initiator_socket connects to target sockets.
For CCI-based mapping, set the target socket's required address and size parameters. The other parameters are:
| Parameter | Default | Description |
|---|---|---|
| relative_addresses | true | Pass the target an offset from the mapped base address |
| priority | 0 | Lower numeric values have higher priority |
| chained | false | Suppress debug output for this target when true |
The default AddrMapNoCache does not cache address lookups. router.h exposes a cache policy template parameter, and addrmap_cache_examples.h contains the optional LRUCache, RegionFIFOCache, and RegionLRUCache examples. This documentation makes no performance claim for these choices.
The router CMake file registers these CTest names:
List the router tests other than router-cache-bench-enhanced without running them:
To run those tests from a configured build:
The test registration is in tests/components/router/CMakeLists.txt. No test results or performance measurements are reported here.