Custom OS Build for Kria KR260 FPGA (PetaLinux 2024.2)

Overview

This guide walks you through the process of building a custom OS for the Kria KR260 FPGA Robotics Kit using PetaLinux and BSP (Board Support Package) files. The steps include downloading necessary files, setting up the environment, applying workarounds, and successfully generating a PetaLinux system image.

1. Official Guide from AMD

Refer to the AMD Official Guide for custom OS build instructions.

2. Download PetaLinux Installer and BSP Files

Download the PetaLinux installer and BSP files for the Kria KR260 Robotics Kit from the AMD website.

Important:

• Ensure that the PetaLinux Tools and BSP files are of the same version to avoid compatibility issues (In my case its version 2024.2)

3. Workarounds for a Successful Build

Some additional steps are required to ensure a smooth PetaLinux build process.

a. Installation Requirements for the Host Machine

Ensure that your host machine meets all the installation requirements as specified in the official guide.

b. Pre-Installation Steps for PetaLinux Tools

Before installing PetaLinux Tools, execute the following commands in your Linux terminal:

i. Enable 32-bit Architecture

sudo dpkg --add-architecture i386

ii. Switch from bash to dash

sudo dpkg-reconfigure dash

iii. Set Up a TFTP Server

sudo apt install tftpd-hpa tftp
sudo nano /etc/default/tftpd-hpa

Modify the configuration as follows:

TFTP_USERNAME="tftp"
TFTP_DIRECTORY="/var/lib/tftpboot"
TFTP_ADDRESS="0.0.0.0:69"
TFTP_OPTIONS="--secure"

Create the TFTP boot directory and set permissions:

sudo mkdir -p /var/lib/tftpboot
sudo chown -R tftp:tftp /var/lib/tftpboot
sudo chmod -R 777 /var/lib/tftpboot

Restart and enable the service:

sudo systemctl restart tftpd-hpa
sudo systemctl enable tftpd-hpa

iv. Add User to dialout Group

sudo adduser $USER dialout

4. Install PetaLinux

Use the instruction Here to install the Petalinux tools.

If installation fails due to missing libraries, install the required packages using package installer for the host OS. The missing dependencies will be listed in the console error log during installation.

5. Set Up PetaLinux Working Environment

Follow the official documentation to configure your PetaLinux workspace.

6. Create a Project Using BSP

Use the BSP files to initialize your project environment. Create Project.

7. Customizing the Project

Customize various components of the PetaLinux project, such as:

• Root File System
• Kernel Configuration
• Firmware Versions

8. Building the PetaLinux System Image

Use the instruction Here to build the project.

Important Considerations:

• Ensure a stable internet connection and sufficient disk space in the output directory.
• The build process may take over an hour, depending on system performance.
• If the build fails due to timeouts, retry multiple times to complete successfully.

9. Build Sysroot (SDK) for the Project

Once the project build is complete, generate the SDK to obtain the sysroot for Vitis.

petalinux-build --sdk

10. Generate the Boot Image

Follow the AMD documentation to generate a bootable image for deployment.

11. Booting PetaLinux on Target Hardware

Transfer the generated image to an SD card and boot the Kria KR260 FPGA board with the PetaLinux OS.

Conclusion

By following these steps, you can successfully build and deploy a custom OS using PetaLinux for the Kria KR260 FPGA Robotics Kit. This setup allows for further customization and application development using Vitis acceleration tools.