fabric-fpga

Instructions

When invoked, generate code to provision FPGA nodes on FABRIC and flash bitstreams. There are three main workflows:

1. ESnet — Docker-based SmartNIC firmware using esnet-smartnic-fw
2. NEU — Vivado Lab Tools CLI-based flashing
3. XDMA — Alveo shell-based flashing with xbflash2

Help the user choose the right workflow and generate setup code including slice creation, tool installation, flashing, PCI rescan, and verification.

API Reference

FPGA Component

# Only available FPGA model
node.add_component(model='FPGA_Xilinx_U280', name='fpga1')

Finding Sites with FPGAs

site = fablib.get_random_site(
    filter_function=lambda x: x['fpga_u280_available'] > 0
)

PCI Rescan (After Flashing)

# FABlib method (preferred)
node.rescan_pci(component_name="fpga1")

# Verify devices
stdout, _ = node.execute("lspci | grep Xilinx")

Patterns

FPGA Slice Creation

from fabrictestbed_extensions.fablib.fablib import FablibManager

fablib = FablibManager()

site = fablib.get_random_site(
    filter_function=lambda x: x['fpga_u280_available'] > 0
)

slice = fablib.new_slice(name="fpga-experiment")

node = slice.add_node(
    name="fpga-node",
    site=site,
    cores=8,
    ram=32,
    disk=200,
    image="docker_ubuntu_20",
)
node.add_component(model="FPGA_Xilinx_U280", name="fpga1")
node.add_fabnet()

slice.submit()

ESnet Workflow (Docker-Based)

node = slice.get_node(name="fpga-node")

# Download Docker images and firmware from FABRIC storage
nginx_user = "fpga_tools"
nginx_password = "secret-password"
tools_location = "/home/ubuntu"

downloads = [
    "smartnic-docker-images/smartnic-dpdk-docker.tar.gz",
    "smartnic-docker-images/xilinx-labtools-docker-2023.2_1013_2256.tar.gz",
    "esnet-smartnic-fw/esnet-smartnic-fw.tar.gz",
]

for file in downloads:
    node.execute(
        f"curl -k -u {nginx_user}:{nginx_password} "
        f"https://resources.fabric-testbed.net/fpga-tools/{file} "
        f"> {tools_location}/{file.split('/')[-1]}"
    )