Test Necessary Files Template

Zynq

Necessary files

Note

The SD card includes several folders in the root directory of the BOOT partition. In order to configure the SD card to work with a specific FPGA board and ADI hardware, several files must be copied onto the root directory. Using the host PC, drag and drop the required files onto the BOOT partition, and use the EJECT function when removing the SD card from the reader.

The following files are needed for the system to boot:

• HDL boot image: BOOT.bin

• Linux Kernel image: uImage

• Linux device tree: devicetree.dtb

They can either be taken from the SD card – already generated by us, or you can build them manually:

• Instructions on how to choose the boot files from the SD card can be found in the Platform-Specific Manual Steps section from here Hardware Configuration.

• Instructions on how to manually build the boot files from source can be found here:

  • Build Zynq Linux kernel and devicetree

  • ADRV9009 HDL reference design build documentation. More HDL build details at Build an HDL project.

Important

Some projects provide multiple devicetree files in the SD card’s boot folders. Make sure you select the devicetree that matches your specific use case.

ZynqMP

Necessary files

Note

The SD card includes several folders in the root directory of the BOOT partition. In order to configure the SD card to work with a specific FPGA board and ADI hardware, several files must be copied onto the root directory. Using the host PC, drag and drop the required files onto the BOOT partition, and use the EJECT function when removing the SD card from the reader.

The following files are needed for the system to boot:

• HDL boot image: BOOT.BIN

• Linux Kernel image: Image

• Linux device tree: system.dtb

They can either be taken from the SD card – already generated by us, or you can build them manually:

• Instructions on how to choose the boot files from the SD card can be found in the Platform-Specific Manual Steps section from here: Hardware Configuration.

• Instructions on how to manually build the boot files from source can be found here:

  • Build ZynqMP / MPSoC Linux kernel and devicetree

  • ADRV9009 HDL reference design build documentation. More HDL build details at Build an HDL project.

Important

Some projects provide multiple devicetree files in the SD card’s boot folders. Make sure you select the devicetree that matches your specific use case.

Versal

Necessary files

Note

The SD card includes several folders in the root directory of the BOOT partition. In order to configure the SD card to work with a specific FPGA board and ADI hardware, several files must be copied onto the root directory. Using the host PC, drag and drop the required files onto the BOOT partition, and use the EJECT function when removing the SD card from the reader.

The following files are needed for the system to boot:

• HDL boot image: BOOT.BIN

• Linux Kernel image: Image

• Linux device tree: system.dtb

• boot.scr

They can either be taken from the SD card – already generated by us, or you can build them manually:

• Instructions on how to choose the boot files from the SD card can be found in the Platform-Specific Manual Steps section from here: Hardware Configuration.

• Instructions on how to manually build the boot files from source can be found here:

  • Build ZynqMP / MPSoC Linux kernel and devicetree (the only difference compared to the ZynqMP is that instead of running make adi_zynqmp_defconfig, you must run make adi_versal_defconfig)

  • ADRV9009 HDL reference design build documentation. More HDL build details at Build an HDL project.

Important

Some projects provide multiple devicetree files in the SD card’s boot folders. Make sure you select the devicetree that matches your specific use case.

Versal (VCK190)

Necessary files

Note

The SD card includes several folders in the root directory of the BOOT partition. In order to configure the SD card to work with a specific FPGA board and ADI hardware, several files must be copied onto the root directory. Using the host PC, drag and drop the required files onto the BOOT partition, and use the EJECT function when removing the SD card from the reader.

The following files are needed for the system to boot:

• For ACAP:

  • HDL boot image: BOOT.BIN

  • Linux Kernel image: Image

  • Linux device tree: system.dtb

  • boot.scr

  They can either be taken from the SD card – already generated by us, or you can build them manually:

  • Instructions on how to choose the boot files from the SD card can be found in the Platform-Specific Manual Steps section from here: Hardware Configuration.

  • Instructions on how to manually build the boot files from source can be found here:

    • Build ZynqMP / MPSoC Linux kernel and devicetree (the only difference compared to the ZynqMP is that instead of running make adi_zynqmp_defconfig, you must run make adi_versal_defconfig)

    • ADRV9009 HDL reference design build documentation. More HDL build details at Build an HDL project.

  Important

  Some projects provide multiple devicetree files in the SD card’s boot folders. Make sure you select the devicetree that matches your specific use case.

• For System Controller:

  Important

  This board also requires a second SD card for the System Controller. The System Controller card usually comes pre-written from the factory and only needs to be rewritten if the card is replaced or you want to update the system controller.

  • System controller Image (to be flashed on the System Controller SD card only if the card needs to be replaced or updated)

Microblaze

Necessary files

Note

This carrier only has programming logic (PL) and, thus, a Microblaze soft core is necessary to run Linux. As such, the files required for running Linux need to be manually built.

The following files are needed for the system to boot:

• HDL bitstream file: system_top.bit

• Linux Kernel image: simpleImage.strip

Instructions on how to manually build the boot files from source can be found here:

• Build MicroBlaze Linux kernel

• ADRV9009 HDL reference design build documentation. More HDL build details at Build an HDL project

Important

Some projects provide multiple devicetree files. Make sure you select the devicetree that matches your specific use case when building the simpleImage.

Agilex 7 SoC

Necessary files

Note

Intel Agilex 7 SoC is not supported on the Kuiper Linux image, so all boot files must be manually built.

The following files are needed for the system to boot:

• FPGA bitstream: agilex.core.rbf

• Linux Kernel image: Image

• Linux device tree: socfpga_agilex_socdk.dtb

• U-Boot image: u-boot.itb

• Flash the .jic file to QSPI via JTAG using the Quartus Programmer.

Instructions on how to manually build the boot files from source can be found here:

• Building the Intel SoC-FPGA kernel and devicetrees from source

• ADRV9009 HDL reference design build documentation. More HDL build details at Build an HDL project.

Stratix 10 SoC

Necessary files

Note

Intel Stratix 10 SoC is not supported on the Kuiper Linux image, so all boot files must be manually built.

The following files are needed for the system to boot:

• Linux Kernel image: Image

• Linux device tree: socfpga_stratix10_socdk.dtb

• U-Boot image: u-boot.itb

• Program the FPGA with the .sof file via JTAG using the Quartus Programmer.

Instructions on how to manually build the boot files from source can be found here:

• Building the Intel SoC-FPGA kernel and devicetrees from source

• ADRV9009 HDL reference design build documentation. More HDL build details at Build an HDL project.

Arria 10 SoC

Necessary files

Note

The SD card includes several folders in the root directory of the BOOT partition. In order to configure the SD card to work with a specific FPGA board and ADI hardware, several files must be copied onto the root directory.

The following files are needed for the system to boot:

• HDL boot image: fit_spl_fpga.itb

• Linux Kernel image: zImage

• Linux device tree: socfpga_arria10_socdk_sdmmc.dtb

• U-Boot image: u-boot.img

• Boot configuration file: extlinux.conf in the extlinux folder from SD Card

• Secondary program loader: u-boot-splx4.sfp on third SD Card partition.

Important

For Intel SoC-FPGA boards, the secondary program loader must be written to the third SD card partition, which is not accessible from Windows. You will need either a native Linux system or WSL to properly configure the SD card. For detailed file placement instructions, refer to Using Kuiper Linux pre-built images.

They can either be taken from the SD card – already generated by us, or you can build them manually:

• Instructions on how to choose the boot files from the SD card can be found in the Platform-Specific Manual Steps section from here: Hardware Configuration.

• Instructions on how to manually build the boot files from source can be found here:

  • Building the Intel SoC-FPGA kernel and devicetrees from source

  • ADRV9009 HDL reference design build documentation. More HDL build details at Build an HDL project.

Important

Some projects provide multiple devicetree files in the SD card’s boot folders. Make sure you select the devicetree that matches your specific use case.

Cyclone 5 SoC

Necessary files

Note

The SD card includes several folders in the root directory of the BOOT partition. In order to configure the SD card to work with a specific FPGA board and ADI hardware, several files must be copied onto the root directory.

The following files are needed for the system to boot:

• HDL boot image: soc_system.rbf

• Linux Kernel image: zImage

• Linux device tree: socfpga.dtb

• U-Boot script: u-boot.scr

• Boot configuration file: extlinux.conf in the extlinux folder from SD Card

• Secondary program loader: u-boot-with-spl.sfp on third SD Card partition.

Important

For Intel SoC-FPGA boards, the secondary program loader must be written to the third SD card partition, which is not accessible from Windows. You will need either a native Linux system or WSL to properly configure the SD card. For detailed file placement instructions, refer to Using Kuiper Linux pre-built images.

They can either be taken from the SD card – already generated by us, or you can build them manually:

• Instructions on how to choose the boot files from the SD card can be found in the Platform-Specific Manual Steps section from here: Hardware Configuration.

• Instructions on how to manually build the boot files from source can be found here:

  • Building the Intel SoC-FPGA kernel and devicetrees from source

  • CN0540 HDL project build documentation. More HDL build details at Build an HDL project.

Important

Some projects provide multiple devicetree files in the SD card’s boot folders. Make sure you select the devicetree that matches your specific use case.

Zynq (not in Kuiper)

Necessary files

Important

This project is not part of the release and, as such, the boot files need to be manually built using this HDL branch and this Linux branch.

The following files are needed for the system to boot:

• HDL boot image: BOOT.bin

• Linux Kernel image: uImage

• Linux device tree: devicetree.dtb

Instructions on how to manually build the boot files from source can be found here:

• Build Zynq Linux kernel and devicetree

• ADRV9009 HDL reference design build documentation. More HDL build details at Build an HDL project.