NetFPGA SUME FAQ

NetFPGA-SUME Frequently Asked Questions

Part 1 - Operating Systems and Xilinx Tools

• Q1: Are there any particular OS and Xilinx packages I should have installed before I get started?

A: Yes. We have adopted Ubuntu 14.04,16.04,20.04 (x86_64) and Xilinx Vivado 2014.4, 2016.04, 2020.1. Also, see the Getting Started Guide for a list of other packages that should be installed.

• Q2: What about Xilinx licenses?

A: In short, you'll need to have a Xilinx Vivado license. The Virtex-7 FPGA device is not one of the supported parts in the freely available Xilinx webpack. For more details see the Licensing page.

• Q3: Are there any other things I should do before I begin?

A: A good first step is to familiarize yourself with the board by going through the Reference Manual. When you're ready to begin checkout the Getting Started Guide.

• Q4: Can I use NetFPGA-SUME with ISE?

A: While ISE supports Virtex-7 devices, code can not be seamlessly ported between the two. You can not use the NetFPGA-SUME codebase with the ISE toolchain, and much effort is require to convert between the two.

• Q5: mb-gcc: error while loading shared libraries: libstdc++.so.6: wrong ELF class: ELFCLASS64

A: sudo apt-get install libstdc++6:i386 libgtk2.0-0:i386 dpkg-dev:i386

SDK needs gmake, but Ubuntu contains only make (same binary, different filename). gmake needs to be created as link:
sudo ln -s /usr/bin/make /usr/bin/gmake

Note: source

• Q5: lib/libstdc++.so.6: version `GLIBCXX_3.4.20' not found (required by /usr/lib/x86_64-linux-gnu/libproxy.so.1) Failed to load module: /usr/lib/x86_64-linux-gnu/gio/modules/libgiolibproxy.so

A: This workaround applies for Vivado v2016.04 on Ubuntu 2016.04.2 LTS

mv /opt/Xilinx/Vivado/2016.4/lib/lnx64.o/libstdc++.so.6 /opt/Xilinx/Vivado/2016.4/lib/lnx64.o/libstdc++.so.6.orig
mv /opt/Xilinx/SDK/2016.4/lib/lnx64.o/libstdc++.so.6 /opt/Xilinx/SDK/2016.4/lib/lnx64.o/libstdc++.so.6.orig
ln -s /usr/lib/x86_64-linux-gnu/libstdc++.so.6.0.21 /opt/Xilinx/Vivado/2016.4/lib/lnx64.o/libstdc++.so.6
ln -s /usr/lib/x86_64-linux-gnu/libstdc++.so.6.0.21 /opt/Xilinx/SDK/2016.4/lib/lnx64.o/libstdc++.so.6

---

Part 2 - NetFPGA-SUME Codebase

• Q1: NetFPGA-SUME Acceptance Test fails, What should I do?

A: The acceptance test can fail due to various reasons (missing packages, wrong setup, board failure :( etc ). So the first step is to make sure that you are working on the same platform with the same tools as suggested in the Getting Started Guide. In that way, we can reproduce the issues, share results and work towards solving them.

First check if the board is working fine. Run the following commands and see if the board is successfully programmed.

$ djtgcfg init -d NetSUME

$ dsumecfg reconfig -d NetSUME -s 0

You shouldn't get any errors.

If you get any errors (like ERROR: FPGA is NOT configured) then it is possible that it is a board failure. Try to run the above command multiple times (3 or 4 times) and see if it succeeds. If it doesn't succeed then you should contact your local distributor regarding your board issue and start a RMA process.

If it is not a board issue, then we can see if its due to some missing packages or different installation procedure. So in order for us to be helpful in solving issues. Could you please provide us with the following items:

1. Could you please download and run this script and provide us with the resulting log (murugan.log). (Please note that it requires aptitude package.)

2. The following command gives us details about your hardware on which the tools are running. It will be very useful if you can run the following on your command line and provide us with the log file (system.log). This command requires root privileges.

   user@your-machine: sudo -i

   root@your-machine:~# for i in {1..39}; do dmidecode -t $i >> system.log; done

3. Finally, could you please provide us with the version of Vivado you are running.

   root@your-machine:~# vivado -version

Note : I have a working machine. All my machine logs can be found here.

• Q2: Have all previous NetFPGA-10G projects been ported to the NetFPGA-SUME Project?

A: We are currently in the process of porting all projects. The following projects are being ported: acceptance_test, reference_nic, reference_switch, reference_switch_lite and reference_router.

• Q3: WARNING: [IP_Flow 19-2162] IP 'output_port_lookup_ip' is locked
  IP definition relies on the following subcore(s) that were not found in the IP Catalog: xilinx:xilinx:cam:1.00 or xilinx:xilinx:tcam:1.00

A: The reference_switch and reference_router project make use of the IP CAMs. You will need to create these IPs before starting the synthesis of the particular projects. Refer to the TCAM IPs guide.

---

Part 3 - NetFPGA-SUME Hardware

• Q1: Does the NetFPGA-SUME have to be installed into a host's PCIe socket for development?

A: No. The NetFPGA-SUME can be used in either a stand-alone mode or installed into a host PCIe slot. See the Reference Manual for further information regarding usage.

• Q2: Does the PCIe mode require a specific PCIe driver?

A: Yes. The specific Linux driver to access the card while in PCIe mode is located at lib/sw/std/driver/sume_riffa_v1_0_0/. Compile the driver while in that directory by running make. The Makefile will create a sume_riffa.ko file. The sume_riffa.ko can be loaded by running the following command sudo insmod ./sume_riffa.ko or installed using sudo make install and then loaded using sudo modprobe sume_riffa.

Note : The NetFPGA card must be loaded with correct bit stream to operate in PCIe mode.