It is required to configure the PetaLinux project to support Linux application debug. Run the following commands for each step listed below. You can use the BSP for their board. However, the steps below uses ZynqMP template, and the MACHINE_NAME is updated. This would be a more generic flow
Create the PetaLinux project:
petalinux-create project --template zynqMP -n ./xilinx-zcu102-v2025.1 --tmpdir /tmp/${USER}/zcu102/petalinuxConfigure the hardware description:
cd xilinx-zcu102-2025.1 petalinux-config --get-hw-description <path to XSA>
Configure the DTG Options
Select
DTG Options:(zcu102-rev1.0) MACHINE_NAME
Configure the root file system to enable TCF agent:
petalinux-config -c rootfs
Select
Filesystem Packages:Filesystem Packages --->
Scroll down to select
misc.misc --->
Scroll down to select
tcf-agent. Ensure that thetcf-agentis enabled.[*] tcf-agent [ ] tcf-agent-dev [ ] tcf-agent-dbg
Go back to the
Filesystem Packagesmenu and click console.console --->
Navigate to
network.network --->
Click into the
dropbearsubmenu and make sure thatdropbearis enabled:[*] dropbear
Go back to the previous menu to select OpenSSH and ensure that
openssh-sftp-serveris enabled.[ ] openssh [ ] openssh-ssh [ ] openssh-sftp [*] openssh-sftp-server [ ] openssh-keygen [ ] openssh-dbg [ ] openssh-dev [ ] openssh-misc [ ] openssh-sshd [ ] openssh-scp
Save the configuration and exit.
Build:
petalinux-build
Sysroot:
petalinux-package --boot --u-boot petalinux-build --sdk petalinux-package --sysroot
Note: You can skip all the above steps by using the make sysroots script to build the Linux images.
Copyright © 2020–2025 Advanced Micro Devices, Inc.