Installing Peta-Caribou

Requirements link

• Git LFS: any
• Petalinux: 2023.2
• Docker: 29.x
• Python: 3.x

Installing PetaLinux link

Before working with Peta-Caribou, PetaLinux must be installed.

Using the PetaLinux installer link

The PetaLinux installer can be downloaded from the AMD-Xilinx downloads portal. The version 2023.2 can be found in the Archive section.

Details about the system requirements and installation instructions can be found on the Environment Setup Guide page.

Using the Docker image (Recommended) link

If installing PetaLinux 2023.2 using the PetaLinux installer is not feasible, a Docker container can be used as an alternative. The docker-petalinux2 project provides a convenient solution. Setup instructions can be found on the project page, but the process can be summarized as follows:

1. Clone the docker-petalinux2.

2. Download the PetaLinux 2023.2 installer.

3. Place it in the installers/ directory of the docker-petalinux2 repository.

   warning

   You may need to rename the installer file to petalinux-v<VERSION>-final-installer.run.

4. Run the following command, replacing <VERSION> with the downloaded version (e.g., 2023.2):

     ./docker_build.sh <VERSION>
     

5. launch an instance of the Docker container, run:

     /path/to/docker-petalinux2/etc/petalin2.sh
     

Dowloading the source code link

The latest version of Peta-Caribou can be downloaded from the CERN GitLab repository.

For production environments as well as for developers, it is recommended to always use the latest available version from the git master branch.

The software repository can be cloned as follows:

  git clone https://gitlab.cern.ch/Caribou/peta-caribou.git
cd peta-caribou