# FlooNoC: A Fast, Low-Overhead On-chip Network

This repository provides modules for the FlooNoC, a Network-on-Chip (NoC) which is part of the PULP (Parallel Ultra-Low Power) Platform. The repository includes Network Interface IPs (named chimneys), Routers and further NoC components to build a complete NoC. FlooNoC mainly supports AXI4+ATOPs, but can be easily extended to other On-Chip protocols. Arbitrary topologies are supported with several routing algorithms. FlooNoC is designed to be scalable and modular, and can be easily extended with new components. Additionally, FlooNoC provides a generation framework for creating customized NoC configurations.

💡 Design Principles

Our NoC design is grounded in the following key principles:

1. Full AXI4 Support: Our design fully supports AXI4+ATOPs from AXI5 as outlined here, particularly multiple outstanding burst transactions. It utilizes low-complexity routers and a decoupled link-level protocol to ensure scalability, thereby enabling tolerance to high-latency off-chip accesses.
2. Decoupled Links and Networks: We use a link-level protocol that is decoupled from the network-level protocol. This allows us to move the complexity of the network-level protocol into the network interfaces, while deploying low-complexity routers in the network, that enable better scalability.
3. Wide Physical Channels: We incorporate wide physical channels in order to meet the high-bandwidth requirements at network endpoints without being constrained by the operating frequency. This is in contrast to the traditional narrow link approach. Further, the NoC avoids any kind of serialization and sends entire messages in a single flit including header and tail information.
4. Separation of traffic: Our design acknowledges the diversity in traffic patterns, as it decouples links and networks to handle wide, high-bandwidth, burst-based traffic and narrow, latency-sensitive traffic with separate physical channels.
5. Modularity: Our design principles also emphasize modularity. We have developed a set of IPs that can be instantiated together to build a NoC. This approach not only promotes reusability but also facilitates flexibility in designing custom NoCs to cater to a variety of specific system requirements.

🔮 Origin of the name

The names of the IPs are inspired by the Harry Potter universe, where the Floo Network is a magical transportation system. The Network interfaces are named after the fireplaces and chimneys used to access the Floo Network.

In use for centuries, the Floo Network, while somewhat uncomfortable, has many advantages. Firstly, unlike broomsticks, the Network can be used without fear of breaking the International Statute of Secrecy. Secondly, unlike Apparition, there is little to no danger of serious injury. Thirdly, it can be used to transport children, the elderly and the infirm."

🔐 License

All code checked into this repository is made available under a permissive license. All software sources are licensed under the Apache License 2.0 (see LICENSE-APACHE), and all hardware sources in the hw folder are licensed under the Solderpad Hardware License 0.51 (see LICENSE-SHL).

📚 Publication

If you use FlooNoC in your research, please cite the following paper:

⭐ Getting Started

Pre-requisites

FlooNoC uses bender to manage its dependencies and to automatically generate compilation scripts. Further Python >= 3.10 is required to install the generation framework.

Simulation

Currently, we do not provide any open-source simulation setup. Internally, the FlooNoC was tested using QuestaSim, which can be launched with the following command:

```sh

Compile the sources

make compile-sim

Run the simulation

make run-sim-batch TBDUT=tbfloo_dut ```

or in the GUI, with prepared waveforms:

```sh

Compile the sources

make compile-sim

Run the simulation

make run-sim TBDUT=tbfloodut `` By replacingtbfloo_dut` with the name of the testbench you want to simulate.

🧰 List of IPs

This repository includes the following NoC IPs:

1. Routers: A collection of different NoC router designs with varying features such as virtual channels, input/output buffering, and adaptive routing algorithms.
2. Network Interfaces (NIs): A set of NoC network interfaces for connecting IPs to the NoC.
3. Common IPs A set of IPs used by the NoC IPs, such as FIFOs, Cuts and arbiters.
4. Verification IPs (VIPs): A set of VIPs to verify the correct functionality of the NoC IPs.
5. Testbenches: A set of testbenches to evaluate the performance of the NoC IPs, including throughput, latency.

Routers

| Name | Description | Doc | | --- | --- | --- | | floo_router | A simple router with configurable number of ports, physical and virtual channels, and input/output buffers | | | floonwrouter | Wrapper of a multi-link router for narrow and wide links | |

Network Interfaces

| Name | Description | Doc | | --- | --- | --- | | flooaxichimney | A bidirectional network interface for connecting AXI4 Buses to the NoC | | | floonwchimney | A bidirectional network interface for connecting narrow & wide AXI Buses to the multi-link NoC | |

Common IPs

| Name | Description | Doc | | --- | --- | --- | | floo_fifo | A FIFO buffer with configurable depth | | | floo_cut | Elastic buffers for cuting timing paths | | | floo_cdc | A Clock-Domain-Crossing (CDC) module implemented with a gray-counter based FIFO. | | | floowormholearbiter | A wormhole arbiter | | | floovcarbiter | A virtual channel arbiter | | | flooroutecomp | A helper module to compute the packet destination | | | floo_rob | A table-based Reorder Buffer | | | floosimplerob | A simplistic low-complexity Reorder Buffer | | | floorobwrapper | A wrapper of all available types of RoBs including RoB-less version | | | floonwjoin | A mux for joining a narrow and wide AXI bus a single wide bus | |

Verification IPs

| Name | Description | Doc | | --- | --- | --- | | axibwmonitor | A AXI4 Bus Monitor for measuring the throughput and latency of the AXI4 Bus | | | axireordercompare | A AXI4 Bus Monitor for verifying the order of AXI transactions with the same ID | | | flooaxirand_slave | A AXI4 Bus Multi-Slave generating random AXI respones with configurable response time | | | flooaxitest_node | A AXI4 Bus Master-Slave Node for generating random AXI transactions | | | floodmatest_node | An endpoint node with a DMA master port and a Simulation Memory Slave port | | | floohbmmodel | A very simple model of the HBM memory controller with configurable delay | |

🛠️ Generation

FlooNoC comes with a generation framework called floogen. It allows to create complex network configurations with a simple configuration file.

Capabilities

floogen has a graph-based internal representation of the network configuration. This allows to easily add new features and capabilities to the generation framework. The following list shows the a couple of the current capabilities of floogen:

• Validation: The configuration is validated before the generation to ensure that the configuration is valid. For instance, the configuration is checked for invalid user input, overlapping address ranges
• Routing: XY-Routing and ID-Table routing are supported. floogen automatically generates the routing tables for the routers, as well as the address map for the network interfaces.
• Package Generation: floogen automatically generates a SystemVerilog package with all the needed types and constants for the network configuration.
• Top Module Generation: floogen automatically generates a top module that contains all router and network interfaces. The interfaces of the top module are AXI4 interfaces for all the enpdoints specified in the configuration.

Example

The following example shows the configuration for a simple mesh topology with 4x4 routers and 4x4 chimneys with XY-Routing.

```yaml name: example_system description: "Example of a configuration file"

routing: routealgo: "XY" useid_table: true

protocols: - name: "axiin" type: "AXI4" datawidth: 64 addrwidth: 32 idwidth: 3 userwidth: 1 - name: "axiout" type: "AXI4" datawidth: 64 addrwidth: 32 idwidth: 3 userwidth: 1

endpoints: - name: "cluster" array: [4, 4] addrrange: base: 0x10000000 size: 0x00040000 mgrportprotocol: - "axiin" sbrportprotocol: - "axi_out"

routers: - name: "router" array: [4, 4]

connections: - src: "cluster" dst: "router" srcrange: - [0, 3] - [0, 3] dstrange: - [0, 3] - [0, 3] bidirectional: true ```

Usage

To install floogen run the following command:

sh pip install .

which allows you to use floogen with the following command:

sh floogen -c <config_file> -o <output_dir>

Configuration

The example configuration above shows the basic structure of a configuration file. A more detailed description of the configuration file can be found in the documentation.