# Petalinux Build Infrastructure

Go to the below page and download the below
https://www.xilinx.com/support/download/index.html/content/xilinx/en/downloadNav/embedded-design-tools.html

Download the 2023.1 petalinux installer tool
Download the 2023.1 sstate and downloads.
Download the bsps if you want to use the bsp flow from lounge link.

Install the tool.
follow the steps in UG1144 "Setting Up Your Environment" section.
https://docs.xilinx.com/r/en-US/ug1144-petalinux-tools-reference-guide

# Setting Up the System Devicetree

Before proceeding be sure to place the system devicetree files provided by the hardware developer
persona in a location accessible by the user which will be running the Petalinux builds.

Generate the system device-tree files using the steps mentioned in
System Device Tree generation page below and the prerequisite for this is xsa.
https://github.com/Xilinx/system-device-tree-xlnx 


# Build the project using template flow

1.source the installed petalinux tool

source /opt/petalinux/settings.sh

2.create the project

petalinux-create -t project -n <myproj>  --template <versal/zynqMP>

3.Go to the petalinux project

cd myproj

4.Configure the project with the above generated system device tree


petalinux-config --get-hw-description xilinx-zcu102-2022.1/dts/system-top.dts

5. build the project

petalinux-build

6. Do qemu boot/hardware boot

petalinux-boot --qemu/--jtag 

# Building the project using BSP flow

1. source the installed petalinux tool

source /opt/petalinux/settings.sh

2. Create the petalinux project using below command

petalinux-create -t project -s xilinx-vmk180-sdt-v2023.1-final.bsp(downloaded .bsp path)

3. Go to the project

cd xilinx-vmk180-sdt-2023.1/

4. Build the project

petalinux-build

5. Do qemu/hw boot

petalinux-boot --qemu/--jtag

# Limitations with EA release tool

1. When you issue petalinux-config for the first time it will take some to run the decoupling script.
This is expected behavior in system device tree flow. As this will configure for multiple targets.
2. Petalinux-config→ subsystem Auto hardware settings -> System Processor
							 Memory Settings
							 SD/SDIO Settings
							 RTC Settings
above configurations not yet working in EA release
3. If you want to do any dts customizations with respective to device-tree 
do it in <proj>/project-spec/decoupling-dtsi/system-user.dtsi.
4. xen flow will not be supported
5. DFX flow will not be supported
6. FPGA manager flow not tested.
7. openamp flow will not be supported
8. petalinux-config -> Yocto settings -> BB_NO_NETWORK option is not working in this release.
9. To work ethernet ping test for zynqmp sdt bsps while qemu boot we need to use qemu-args like below:
            petalinux-boot --qemu --prebuilt 3 --qemu-args "-net nic -net nic -net nic -net nic,netdev=eth0 -netdev user,id=eth0"

# You can find more details about petalinux tool and command usage in UG1144
https://docs.xilinx.com/r/en-US/ug1144-petalinux-tools-reference-guide