To build a custom PetaLinux 2020.2.2 image for the Kria KV260, install the matching PetaLinux release, create a project from the Kria K26 Starter Kit 2020.2.2 BSP, configure and build it, then package the result using the KV260-specific SD/WIC flow. The BSP and tool release must match; a prebuilt starter Linux image is a faster route for evaluating the board, but it is not a custom PetaLinux build.
Choose the right KV260 setup path
AMD’s current KV260 software onboarding guide starts with a prebuilt SOM Starter Linux image written to microSD. That is useful when the goal is to bring up the board and try its supplied applications. For a customized Linux image, use the version-matched Kria BSP and PetaLinux toolchain instead.
| Path | Goal | Main artifact | Customization |
|---|---|---|---|
| Prebuilt starter image | Bring up the board and evaluate available applications | Vendor-provided Linux image written to microSD | Low; the supplied OS and application image is used |
| PetaLinux BSP build | Build or customize the KV260 Linux image | Version-matched K26 BSP project and KV260-packaged WIC/image outputs | Higher; project configuration and root filesystem can be changed |
Which BSP do you need for the KV260?
Use the Kria K26 Starter Kit BSP for PetaLinux 2020.2.2, identified in the AMD/Xilinx Kria BSP documentation. A Xilinx-hosted example uses the BSP filename xilinx-k26-starterkit-v2020.2.2-final.bsp. Confirm the exact archived installer and BSP filenames on the official AMD/Xilinx download source before following commands: availability and naming can vary by archive.
Do not substitute standard PetaLinux 2020.2 or a BSP for a different release. The Kria enablement release is version-specific, and the Kria guidance stresses matching the installed PetaLinux release to the BSP. See the Kria SOMs and Starter Kits documentation and the Xilinx-hosted Greengrass integration guide for the versioned examples. Greengrass and meta-aws setup in that example is specific to its AWS integration; it is not required for a base KV260 image.
The Tool Desk
Outbyte Driver Updater FREEScan for outdated or missing drivers - takes under a minuteDriver Scan →Outbyte PC Repair FREEClear out junk files and repair common Windows errorsFree Scan →#1 Best Overall
- Designed for students and beginners looking to understand Digital Logic, fundamentals of FPGAs
- Features the Xilinx Artix 7 FPGA compatible with Vivado Design Suite WebPACK Edition (free download available from Xilinx)
- On board user interfaces include 16 user switches, 16 LEDs, 5 user pushbuttons, and a
- Expansion opportunities with four Pmod ports including 3 standard 12-pin Pmod ports and 1 dual
- Does NOT ship with micro USB cable
What you need before building
- A Linux host that meets the archived PetaLinux 2020.2.2 installation requirements. The sources cited here do not establish the complete host-distribution support matrix or all dependency packages; check the version-specific installation documentation rather than assuming a present-day distribution is supported.
- The PetaLinux 2020.2.2 installer and the Kria K26 Starter Kit 2020.2.2 BSP, obtained from the official AMD/Xilinx source and verified to match.
- A KV260 and microSD card for the resulting system image. AMD’s current UG1089 board setup guide recommends an SDHC standard microSD card. It does not specify a universal capacity, speed class, brand, or individual model.
Build a custom PetaLinux 2020.2.2 image
1. Install and initialize PetaLinux
Install the 2020.2.2 tool release according to its archived installation guide. In each shell used for the build, source the settings script from that installation so commands such as petalinux-create and petalinux-build are available. Check the installed release and paths against the installer you actually downloaded; do not copy host dependency instructions from an unrelated release.
2. Create a project from the matching BSP
Use the 2020.2.2 Kria K26 Starter Kit BSP as the project template. The Xilinx-hosted guide gives this example form:
Rank #2
- Arty A7 comes in two FPGA variants: Arty A7-35T features Xilinx XC7A35TICSG324-1L. Arty A7-100T features the larger Xilinx XC7A100TCSG324-1.
- Internal clock speeds exceeding 450MHz, On-chip analog-to-digital converter (XADC), Programmable over JTAG and Quad-SPI Flash
- 256MB DDR3L with a 16-bit bus @ 667MHz, 16MB Quad-SPI Flash, USB-JTAG Programming circuitry, Powered from USB or any 7V-15V source
- 10/100 Mbps Ethernet, USB-UART Bridge
- 4 Switches, 4 Buttons, 1 Reset Button, 4 LEDs, 4 RGB LEDs, 4 Pmod connectors, shield connector
petalinux-create -t project -s xilinx-k26-starterkit-v2020.2.2-final.bspRun it in a directory where you want the project created, and replace the filename only if the official archive provides a different exact filename for the same release and board. The BSP supplies board-specific configuration; it is not interchangeable with a generic Zynq UltraScale+ project template.
3. Configure the project and root filesystem
Review the BSP’s configuration before building, including the selected root filesystem and boot arguments. AMD’s PetaLinux 2020.2 reference guide, UG1144, documents the general configuration and build process. For an SD-backed root filesystem, its example selects EXT4 (SD/eMMC/SATA/USB); the boot-argument device path must agree with the storage device actually selected. Follow the KV260 BSP’s release-specific settings for the concrete values rather than treating a generic example as the board configuration.
Rank #3
- [FPGA Chip] GW2AR-18 QN88 FPGA Chip containing 20736 LUT4 logic cells and 15552 Filp-Flops.There are 2 PLL in this FPGA chip, and many DSP units supporting 18 bit x 18 bit multiplication
- [Onboard Debugger ] Sipeed Tang Nano 20K Development Board support JTAG for FPGA, USB to UART for FPGA,USB to SPI for FPGA communication, Control MS5351 generate frequency
- [USB2.0 HS interface] The 27MHz crystal generates the clock for HDMI display, onboard MS5351 clock generating chip also provides mutiple clocks.Support Serial communication, high-speed SPI reception.
- [Application scenarios] Tang Nano 20K Open source Development Board supports game console emulators, drives RGB screens, multiple display outputs, 20K LUT4, RISC-V soft-core experiments.
- [Wiki] "dl.sipeed.com/shareURL/TANG/Nano_20K/1_Datasheet";Any after-Sales Privems, Please Contact us by click "Waypondev" store and ask a question or leave the message in our forum by "forum.youyeetoo .com/".
4. Build the image
Build the project with:
petalinux-buildThe command builds the project’s configured components. Check the build output and generated artifacts for this BSP and release before packaging; the precise files available can depend on the configuration.
5. Package for KV260’s staged boot design
KV260 packaging is board-specific. AMD’s current UG1089 (revision 1.4, released 2025-06-25) describes QSPI on the SOM as the primary boot device. It holds board-specific boot firmware packaged as BOOT.BIN; U-Boot then hands off to a secondary boot device and gives priority to SD. The SD card contains the operating-system image and associated application files.
Rank #4
- The best way to get started with FPGAs: Using a simple board with projects that build on eachother, now anyone can get started with FPGA development!
- Fun peripherals available: With 4 LEDs, 4 push-buttons, 7-segment display, USB connector, a VGA connector, and a PMOD (for expansion) you can have dozens of fun projects available to you out of the box!
- Works with Verilog and VHDL: No matter which programming language you want to get started with, the Go Board will work for you!
- No extra device required: Simply plug the Go Board into a USB port and go! Getting started with FPGAs has never been easier.
- Works with all operating systems: Windows, Mac, Linux
That staged arrangement is why a generic single-stage SD boot recipe is not a safe substitute for the Kria instructions. The Kria BSP guidance lists a KV260 WIC packaging form using petalinux-package --wic and boot files including ramdisk.cpio.gz.u-boot, boot.scr, Image, and system.dtb. Use the syntax and files specified for the matching BSP release; confirm them on the Kria BSP documentation before copying a command, since the listed form covers 2020.2/2021.1 and exact output names can be release-dependent.
Write the image to microSD and boot
Once you have the generated KV260 image, write it to the microSD card using the image-writing method documented for that artifact, then insert the card and boot the board according to AMD’s board setup instructions. Do not assume that instructions for writing the prebuilt starter Linux image produce or configure a custom PetaLinux image: they describe a separate evaluation path. For physical setup and the prebuilt-image route, consult UG1089 Software Install and Setup.
Recommended Free Tools
Best Value
- Digilent Basys 3 Artix-7 FPGA Trainer Board: Recommended for Introductory Users
Documentation vintage and troubleshooting checks
The guidance combines documentation from different eras: UG1144’s cited configuration and build material is for PetaLinux 2020.2 (released 2020-11-24), while UG1089 is the current KV260 board guide, revision 1.4, released 2025-06-25. Use the archived 2020.2.2 installation and BSP pages for tool-specific commands, and the current board guide for hardware context. If project creation or packaging fails, first check these common mismatches:
Quick Recap
- Project creation rejects the BSP: verify that the BSP is the Kria K26 Starter Kit release for 2020.2.2, not a similarly named package for another release or board.
- PetaLinux commands are unavailable: check that the 2020.2.2 settings script was sourced in the current shell and that the installation path is correct.
- Build completes but the image does not boot: verify that the selected root filesystem and boot-argument device path match the intended SD storage, and that packaging followed the KV260 staged-boot guidance.
- Expected packaging files are missing: check the project configuration and the exact matching-release instructions before reusing a WIC command or filenames from a different release.
Product prices and availability are accurate as of the date/time indicated and are subject to change. Any price and availability information displayed on Amazon at the time of purchase will apply.
