Step 1. Setting up the SD Card Image (PetaLinux)

The Starter Kit has a primary and secondary boot device, isolating the boot firmware from the run-time OS and application. This allows you to focus on developing and updating your application code within the application image on the secondary boot device, without having to touch the boot firmware. The primary boot device is a QSPI memory located on the SOM, which is pre-programmed (pre-loaded QSPI image) at the factory.  The secondary boot device is a microSD card interface on the carrier card.

For setting up the microSD card, you’ll need to download the latest SD card image and then write it using an Image Flashing tool.

  1. Download the Kria™ KV260 Vision AI Starter Kit Image and save it on your computer.
  2. Download the Balena Etcher (recommended; available for Window, Linux, and macOS). Find additional OS specific tool options below.
  3. Follow the instructions in the tool and select the downloaded image to flash onto your microSD card.

Once your microSD card is flashed with the image, proceed to the next step.

Looking for OS specific tools to write the image to the SD card?

For Windows users, you can also use the Win32 Disk Imager tool instead of Balena Etcher. Ensure that your SD card is correctly formatted before using the tool.  Also, ensure that the compressed SD card image for Kria KV260 Vision AI Starter Kit has been extracted using an archive decompression tool.

  1. Browse to the location of the image in the tool using the Blue folder icon.
  2. From the device drop-down menu, select the correct microSD card.
  3. Click on ‘Write’ and then ‘Yes’ at the prompt to continue the write process and wait till the process is completed.

For macOS users, refer to the below instructions.
To unzip the tar file, you can use the following command:

    gunzip petalinux-sdimage.wic.gz

As soon as you plug in the microSD card to your computer, check for what device it is assigned to. Use the following command to identify the target microSD card, which can be verified based on the type, name, and size of the disk:

    gunzip petalinux-sdimage.wic.gz
  • This example usage indicates “disk3” as the microSD card.

If the microSD card has an existing partition, you may need to unmount it with the following command:

    diskutil unmount /dev/disk3s1

You can use the following command to write the image file to the microSD card.

    sudo dd if=petalinux-sdimage.wic of=/dev/rdisk3 bs=1m
  • Use Ctrl+T to see the status of SD card write.

To eject the microSD card safely, use the following command:

    diskutil eject /dev/disk3

For Linux users, refer to the below command line instructions. Ensure that the microSD card is formatted correctly before proceeding.

As soon as you plug in the microSD card to your computer, check for which device it is assigned.

In the example below, the 16GB microSD card appears at device “sdb”.  For the rest of the instructions, we’ll use “sd<x>” and you can replace <x> with the correct device letter for your system such as “sdb” or “sdc” depending upon your system configuration.

Please use caution when entering commands and selecting disks, you don’t want to accidentally overwrite your hard disk!


Extract the compressed image, here we assume the WIC image is hosted as petalinux-sdimage.wic.gz, but your filename may vary with the latest regular updates.

    gunzip petalinux-sdimage.wic.gz​
    dd if=petalinux-sdimage.wic of=/dev/sd<?> conv=fsync​
    sudo eject /dev/sd<?>