FPGA/corundum
1
0
Fork 0
mirror of https://github.com/corundum/corundum.git synced 2025-01-16 08:12:53 +08:00
Code Issues Projects Releases Wiki Activity
corundum/fpga/mqnic/ZCU106/fpga_zynqmp/README.md
Alex Forencich 51b9eb251b fpga/mqnic/ZCU106: Add notes for boot mode selection on ZCU106 
Signed-off-by: Alex Forencich <alex@alexforencich.com>
2023-11-23 00:51:38 -08:00

2.4 KiB
Raw Blame History

Corundum mqnic for ZCU106 (Zynq MPSoC PS host)

Introduction

This design targets the Xilinx ZCU106 FPGA board. The host system of the NIC is the Zynq US+ MPSoC.

  • FPGA: xczu7ev-ffvc1156-2-e
  • PHY: 10G BASE-R PHY IP core and internal GTH transceiver
  • RAM: 2 GB DDR4 2400 (256M x64)

Quick start for Ubuntu

Build FPGA bitstream

Run make app in the fpga subdirectory to build the bitstream, .xsa file, and device tree overlay. Ensure that the Xilinx Vivado toolchain components are in PATH (source settings64.sh in Vivado installation directory).

Installation

Download an Ubuntu image for the ZCU106 here: https://ubuntu.com/download/amd-xilinx. Write the image to an SD card with dd, for example:

xzcat ubuntu.img.xz | dd of=/dev/sdX

Copy files in fpga/app to /lib/firmware/xilinx/mqnic on the ZCU106. Also make a copy of the source repo on the ZCU106 from which the kernel module and userspace tools can be built.

Build driver and userspace tools

On the ZCU106, run make in modules/mqnic to build the driver. Ensure the headers for the running kernel are installed, otherwise the driver cannot be compiled. Then run make in utils to build the userspace tools.

Testing

On the ZCU106, run sudo xmutil unloadapp to unload the FPGA, then sudo xmutil loadapp mqnic to load the configuration. Then, build the kernel module and userspace tools by running make in modules/mqnic and utils. Finally, load the kernel module with insmod mqnic.ko. Check dmesg for output from driver initialization. Run mqnic-dump -d /dev/mqnic0 to dump the internal state.

Quick start for PetaLinux

Build FPGA bitstream

Run make in the fpga subdirectory to build the bitstream and the .xsa file. Ensure that the Xilinx Vivado toolchain components are in PATH (source settings64.sh in Vivado installation directory).

Build PetaLinux image

Then change into sub-directory ps/petalinux/ and build the PetaLinux project. Ensure that the Xilinx PetaLinux toolchain components are in PATH.

make -C ps/petalinux/ build-boot

Testing

Configure DIP switches:

  • SW6 4-1: off, off, off, on (mode 0b1110, SD boot)

Copy the following, resulting files of building the PetaLinux project onto an SDcard suitable for then booting the ZCU106 in SDcard boot mode.

ps/petalinux/images/linux/:
	BOOT.BIN
	boot.scr
	Image
	system.dtb
	rootfs.cpio.gz.u-boot