How xilinx/xup_vitis_network_example works
VNx is an FPGA networking example platform: it provides reusable 100-Gbit Ethernet and UDP network-layer IP, plus basic data-transfer and benchmark designs and host-side control tools. The principal workflow is to configure an FPGA from a notebook or host application, move or generate traffic through the application kernels and shared network infrastructure, then inspect configuration or measurements. The README documents the subsystem capabilities and connections; some implementation paths are unsampled, so those links are cited to the README rather than inferred from filenames.
Main entry points: networklayer.v UDP Network Layer · Notebooks PYNQ Notebooks · networklayer.cpp XRT Host API · template_top.v 100G CMAC
Components 17
Host Control
- PYNQ Notebooks
Notebooks - Network Utilities
Notebooks/vnx_utils.py - Dask Device
Notebooks/dask_pynq.py - XRT Host API
xrt_host_api/src/networklayer.cpp - CMAC Controls
xrt_host_api/src/cmac.cpp - MAC Lookup
xrt_host_api/src/mac.cpp
Shared Network IP
- 100G CMAC
Ethernet/src/template_top.v - UDP Network Layer
NetLayers/src/networklayer.v - Traffic Counters
Basic_kernels/src/krnl_counters.cpp
Basic Transfer
- Memory to Stream
Basic_kernels/src/krnl_mm2s.cpp - Stream to Memory
Basic_kernels/src/krnl_s2mm.cpp - Transfer Data
Basic_kernels
Benchmarking
- Traffic Generator
Benchmark_kernel/src/traffic_generator.v - Latency Collector
Benchmark_kernel/src/collector.cpp - Benchmark Results
Benchmark_kernel
Other components
- Engineer
- Ethernet Network
Connections 19
- Engineer → PYNQ Notebooks: runs examples
README.md - PYNQ Notebooks → Network Utilities: uses helpers
README.md - PYNQ Notebooks → Dask Device: schedules workers
- PYNQ Notebooks → XRT Host API: configures network
- XRT Host API → UDP Network Layer: configures tables
README.md - CMAC Controls → 100G CMAC: reads registers
- MAC Lookup → XRT Host API: provides MAC
- 100G CMAC → Ethernet Network: sends and receives
README.md - UDP Network Layer → 100G CMAC: uses Ethernet
README.md - Memory to Stream → UDP Network Layer: sends UDP stream
README.md - UDP Network Layer → Stream to Memory: delivers UDP stream
README.md - Memory to Stream → Transfer Data: reads payload
README.md - Stream to Memory → Transfer Data: writes payload
README.md - Traffic Generator → UDP Network Layer: generates traffic
README.md - UDP Network Layer → Latency Collector: returns summaries
- Latency Collector → Benchmark Results: records latency
Benchmark_kernel/src/collector.cpp - PYNQ Notebooks → Benchmark Results: measures throughput
README.md - PYNQ Notebooks → Benchmark Results: measures latency
README.md - UDP Network Layer → Traffic Counters: exposes statistics