04-packet-switching

AMD Vitis™ AI Engine Tutorials See Vitis™ Development Environment on amd.com See Vitis™ AI Development Environment on amd.com

Packet Switching Tutorial

Version: Vitis 2025.2

This tutorial targets AIE-ML device, but shares test cases and description files with AIE 04-packet-switching.

IMPORTANT: Before beginning the tutorial, install the AMD Vitis™ unified software platform 2025.2. This Vitis release includes all the embedded base platforms including the VCK190 base platform that this tutorial uses. Also, download the Common Images for Embedded Vitis Platforms from this link.

The ‘common image’ package contains a prebuilt Linux kernel and root file system that you can use with AMD Versal™ boards for embedded design development using Vitis tools.

Before starting this tutorial, run the following steps:

1. Go to the directory where you have unzipped the Versal Common Image package.
2. In a Bash shell, run the /**Common Images Dir**/xilinx-versal-common-v2025.2/environment-setup-cortexa72-cortexa53-amd-linux script. This script sets up the SDKTARGETSYSROOT and CXX variables. If the script is not present, you must run the /**Common Images Dir**/xilinx-versal-common-v2025.2/sdk.sh.
3. Set up your ROOTFS and IMAGE to point to the rootfs.ext4 and Image files located in the /**Common Images Dir**/xilinx-versal-common-v2025.2 directory.
4. Set up your PLATFORM_REPO_PATHS environment variable to $XILINX_VITIS/base_platforms.

This tutorial targets VEK280 board for 2025.2 version.

Objectives

After completing this tutorial, you can:

• Construct a packet switching graph
• Understand the packet format for packet switching
• Write an AI Engine kernel that handles packet stream explicitly
• Design PL kernels for packet switching
• Write a PS application for hardware and hardware emulation flows

Steps

Step 1: Copy test case from Buffer AIE.

Follow instructions in Buffer-Based AI Engine Kernels. But, run all make commands with ARCH=aie-ml. For example:

To build AIE graph, run:

make aie ARCH=aie-ml

To run aiesimulator, run:

make aiesim ARCH=aie-ml

To run HW emulation, run:

make run_hw_emu ARCH=aie-ml

After Linux has booted, run the following commands at the Linux prompt. To exit QEMU press Ctrl+A and then press x. (this is only for HW cosim):

./host.exe a.xclbin

To build system design targeting HW flow, run:

make package TARGET=hw ARCH=aie-ml

To run in hardware, run the following commands at the Linux prompt after booting Linux. Login with username:petalinux, password:petalinux, then run sudo su with password:petalinux before running following commands:

cd /run/media/mm*1
./host.exe a.xclbin

Step 2: Copy test case from Buffer AIE mix types.

Follow instructions in Buffer-Based AI Engine Kernels with Mixed Data Types. But, run all make commands with ARCH=aie-ml. See run commands in step 1.

Step 3: Copy test case from Pktstream AIE.

Follow instructions in Packet Stream-Based AI Engine Kernels. But, run all make commands with ARCH=aie-ml. See run commands in step 1.

Support

GitHub issues are used for tracking requests and bugs. For questions go to forums.

_{Copyright © 2020–2026 Advanced Micro Devices, Inc.}

^{Terms and Conditions}