https://github.com/amamory/hermes-router-axis-ip
A Vivado IP of Hermes network-on-chip router with AXI streaming interfaces
https://github.com/amamory/hermes-router-axis-ip
axis network-on-chip vhdl vivado xilinx
Last synced: 4 months ago
JSON representation
A Vivado IP of Hermes network-on-chip router with AXI streaming interfaces
- Host: GitHub
- URL: https://github.com/amamory/hermes-router-axis-ip
- Owner: amamory
- Created: 2020-06-21T22:28:32.000Z (over 5 years ago)
- Default Branch: master
- Last Pushed: 2020-11-15T16:47:12.000Z (almost 5 years ago)
- Last Synced: 2025-01-22T07:33:22.900Z (9 months ago)
- Topics: axis, network-on-chip, vhdl, vivado, xilinx
- Language: VHDL
- Homepage:
- Size: 85.9 KB
- Stars: 2
- Watchers: 2
- Forks: 1
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Vivado Hermes NoC router IP
This repo contains scripts to recreate the [Hermes network-on-chip router](https://www.sciencedirect.com/science/article/abs/pii/S0167926004000185) as a Vivado IP block with AXI streaming interfaces. The project is setup for Zedboard, although it would be easy to change to other boards assuming you have some basic TCL skills.
The scripts are quite reusable if you keep the same dir structure. It should be useful for other Vivado/SDK projects with minor efforts.
# Module/IP design
The router has five slave AXI streaming interfaces (named E_s, N_s, W_s, S_s, and L_s) and
five master AXI streaming interfaces (named E_m, N_m, W_m, S_m, and L_m). The L_m port is different from the other ports because it implements the LAST signal of the AXI streaming protocol. This signal is required, for instance, to use this router with the AXI's DMA module.
# How to download it
This repository might have custom IPs included as git submodules. Thus, the following command is required to download all its dependencies.
```
git clone --recursive https://github.com/amamory/.git
```
If you already cloned the repository without `--recursive`, then run the following command to download all the submodules.
```
git submodule update --init --recursive
```
Refer to this [tutorial](https://www.vogella.com/tutorials/GitSubmodules/article.html) to learn how to manage submodules.
# How to run it
These scripts are assuming Linux operation system (Ubuntu 18.04) and Vivado 2018.2.
Follow these instructions to recreate the Vivado and SDK projects:
- Open the **build.sh** script and edit the first two lines to setup the environment variables:
- **VIVADO**: path to the Vivado install dir;
- **VIVADO_DESIGN_NAME**: mandatory name of the design
- **XIL_APP_NAME**: used only in projects with software. Not used in this design;
- **VIVADO_TOP_NAME**: set the top name (optional).
- run *build.sh*
These scripts will recreate the entire Vivado project, compile the design, generate the bitstream, export the hardware to SDK, create the SDK projects, import the source files, build all projects, and finally download both the bitstream and the elf application. Hopefully, all these steps will be executed automatically.
# How to update the scripts
These scripts come from a template repository and they get updated and improved over time. If you wish to get the latest script version, then follow these steps:
```
git remote add template https://github.com/amamory/vivado-base-project.git
git fetch --all
git merge --no-commit --no-ff template/master --allow-unrelated-histories
```
Solve any conflict manually and then commit.
# Future work
- update the scripts to Vitis
- support or test with Windows (help required !!! :D )
# Credits
The scripts are based on the excellent scripts from [fpgadesigner](https://github.com/fpgadeveloper/zedboard-axi-dma) plus few increments from my own such as project generalization, support to SDK project creation and compilation and other minor improvements.