This repository is to build and run P4 codes with or without FPGA hardware. It builds on P4, Xilinx OpenNIC, and makes use of network attached FPGAs.
There are four pieces of this repository:
-
Running P4 on BMV2 For running P4 examples on the NERC on BMV2 with NO FPGA hardware:
OCT-P4-BMV2. These use the standard P4 tutorials (https://github.com/p4lang/tutorials) and follow the P4 model (bmv2). -
Building P4 on FPGA You can use
P4Frameworkto build your FPGA bitstream and run on the AMD FPGAs. This is the core of this project. It provides a skeleton for building an FPGA-based NIC that instantiates a P4 function on the OpenNIC shell. It also provides three examples where you can directly try to build and depoly on our testbed. It can also be tested on the FABRIC cloud FPGAs link. -
Running P4 on FPGA There are two instrcutions available for testing after you generating the bitstream through our
P4Framework. To test it on the OCT FPGAs, refer toOCT-P4-FPGA. To test it on FABRIC FPGAs, refer toFABRIC-P4-FPGA. -
The Xiinx OpenNIC framework If you are not familiar with working with FPGAs and generating and downloading bitstreams, follow the instructions for deploying and testing Xilinx's OpenNIC
OpenNIC-Getting-Started. IMPORTANT: These instructions are for deploying OpenNIC on FPGAs at Northeastern's Reconfigurable Computing Laboratory. You will need your own FPGA hardware to run through this tutorial.OpenNIC-Getting-Started
If you are not familiar with NERC follow these directions to create an account and setup an instance from here.
- Clone this repo by
git clone https://github.com/OCT-FPGA/P4OpenNIC_Public.giton your NERC instance.
For FPGA bitstream build:
- set the Xilinx Vivado installation path to 'VIVADO_ROOT'. On NERC:
export VIVADO_ROOT=/tools/Xilinx/Vivado/2021.2
To build OpenNIC, CMAC license is required. For deploying P4 codes onto FPGAs, certain licenses for VitisNetP4 are also required. All those licenses have already been setup on NERC.
To set the license path on NERC:
export [email protected]