# xilinx/meta-petalinux architecture

> Architecture diagram of the GitHub repository xilinx/meta-petalinux, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-03). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/xilinx/meta-petalinux
- Repository: https://github.com/xilinx/meta-petalinux

## Overview

meta-petalinux is a Yocto/OpenEmbedded distro layer for MicroBlaze, Zynq, ZynqMP, and Versal. Its product workflow is to select distro and image metadata, combine board-support customizations and packages, and use BitBake to build a target image or standalone toolchain. The tree also shows developer utilities for root-filesystem Kconfig generation, recipe configuration, and extensible-SDK updates. The README documents the distro and toolchain roles; sampled utility code shows its direct BitBake and SDK-update interactions. Other recipe relationships are not asserted because their wiring was not excerpted.

Main entry points: [`lib/devtool/gen-plnx-kconfig.py`](https://github.com/xilinx/meta-petalinux/blob/rel-v2026.1/lib/devtool/gen-plnx-kconfig.py) (Rootfs Kconfig Generator), [`lib/devtool/plnx-sdk-update.py`](https://github.com/xilinx/meta-petalinux/blob/rel-v2026.1/lib/devtool/plnx-sdk-update.py) (SDK Update), [`dynamic-layers/xilinx-standalone-sdt`](https://github.com/xilinx/meta-petalinux/tree/rel-v2026.1/dynamic-layers/xilinx-standalone-sdt) (Standalone Toolchain), [`lib/devtool/configure.py`](https://github.com/xilinx/meta-petalinux/blob/rel-v2026.1/lib/devtool/configure.py) (Recipe Configure)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_distro["Distro Configuration"]
  node_distrometa["PetaLinux Distro<br/>[petalinux.conf]"]
  node_layerconfig["Layer Metadata<br/>[layer.conf]"]
  node_features["Distro Features"]
  node_standalone["Standalone Toolchain"]
end

subgraph group_images["Images and Packages"]
  node_minimal["Minimal Image"]
  node_full["Full Image"]
  node_everything["Everything Image"]
  node_commonimage["Image Common Metadata"]
  node_initramfs["Initramfs Image"]
  node_packages["Package Groups"]
end

subgraph group_platform["Platform Customization"]
  node_kernel["Kernel Customization"]
  node_devicetree["Device Tree"]
  node_uboot["U-Boot Platform<br/>[platform-top.h]"]
  node_apps["Board Applications"]
end

subgraph group_devtools["Developer Utilities"]
  node_kconfig["Rootfs Kconfig Generator"]
  node_configure["Recipe Configure<br/>[configure.py]"]
  node_sdkupdate["SDK Update<br/>[plnx-sdk-update.py]"]
end

node_engineer(("Layer User"))
node_bitbake["BitBake"]
node_updateserver[("SDK Update Source")]

node_engineer -->|"selects machine"| node_standalone
node_standalone -->|"builds toolchain"| node_bitbake
node_configure -->|"runs configure"| node_bitbake
node_kconfig -->|"queries recipes"| node_bitbake
node_kconfig -->|"sanity-builds"| node_bitbake
node_sdkupdate -->|"reads manifest"| node_updateserver
node_sdkupdate -->|"installs SDK data"| node_updateserver

click node_distrometa "https://github.com/xilinx/meta-petalinux/blob/rel-v2026.1/conf/distro/petalinux.conf"
click node_layerconfig "https://github.com/xilinx/meta-petalinux/blob/rel-v2026.1/conf/layer.conf"
click node_features "https://github.com/xilinx/meta-petalinux/blob/rel-v2026.1/conf/distro/include/petalinux-features.conf"
click node_standalone "https://github.com/xilinx/meta-petalinux/tree/rel-v2026.1/dynamic-layers/xilinx-standalone-sdt"
click node_minimal "https://github.com/xilinx/meta-petalinux/blob/rel-v2026.1/recipes-core/images/petalinux-image-minimal.bb"
click node_full "https://github.com/xilinx/meta-petalinux/blob/rel-v2026.1/recipes-core/images/petalinux-image-full.bb"
click node_everything "https://github.com/xilinx/meta-petalinux/blob/rel-v2026.1/recipes-core/images/petalinux-image-everything.bb"
click node_commonimage "https://github.com/xilinx/meta-petalinux/blob/rel-v2026.1/recipes-core/images/petalinux-image-common.inc"
click node_initramfs "https://github.com/xilinx/meta-petalinux/blob/rel-v2026.1/recipes-core/images/petalinux-initramfs-image.bb"
click node_packages "https://github.com/xilinx/meta-petalinux/tree/rel-v2026.1/recipes-core/packagegroups"
click node_kernel "https://github.com/xilinx/meta-petalinux/blob/rel-v2026.1/recipes-kernel/linux-xlnx/linux-xlnx_%25.bbappend"
click node_devicetree "https://github.com/xilinx/meta-petalinux/blob/rel-v2026.1/dynamic-layers/xilinx-core/recipes-bsp/device-tree/device-tree.bbappend"
click node_uboot "https://github.com/xilinx/meta-petalinux/blob/rel-v2026.1/dynamic-layers/xilinx-core/recipes-bsp/u-boot/u-boot-xlnx/platform-top.h"
click node_apps "https://github.com/xilinx/meta-petalinux/tree/rel-v2026.1/recipes-apps"
click node_kconfig "https://github.com/xilinx/meta-petalinux/blob/rel-v2026.1/lib/devtool/gen-plnx-kconfig.py"
click node_configure "https://github.com/xilinx/meta-petalinux/blob/rel-v2026.1/lib/devtool/configure.py"
click node_sdkupdate "https://github.com/xilinx/meta-petalinux/blob/rel-v2026.1/lib/devtool/plnx-sdk-update.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_distrometa,node_layerconfig,node_features,node_standalone,node_engineer toneBlue
class node_minimal,node_full,node_everything,node_commonimage,node_initramfs,node_packages,node_updateserver toneAmber
class node_kernel,node_devicetree,node_uboot,node_apps toneMint
class node_kconfig,node_configure,node_sdkupdate toneRose
class node_bitbake toneIndigo
```

## Components

### Distro Configuration

- [PetaLinux Distro](https://github.com/xilinx/meta-petalinux/blob/rel-v2026.1/conf/distro/petalinux.conf): `conf/distro/petalinux.conf`
- [Layer Metadata](https://github.com/xilinx/meta-petalinux/blob/rel-v2026.1/conf/layer.conf): `conf/layer.conf`
- [Distro Features](https://github.com/xilinx/meta-petalinux/blob/rel-v2026.1/conf/distro/include/petalinux-features.conf): `conf/distro/include/petalinux-features.conf`
- [Standalone Toolchain](https://github.com/xilinx/meta-petalinux/tree/rel-v2026.1/dynamic-layers/xilinx-standalone-sdt): `dynamic-layers/xilinx-standalone-sdt`

### Images and Packages

- [Minimal Image](https://github.com/xilinx/meta-petalinux/blob/rel-v2026.1/recipes-core/images/petalinux-image-minimal.bb): `recipes-core/images/petalinux-image-minimal.bb`
- [Full Image](https://github.com/xilinx/meta-petalinux/blob/rel-v2026.1/recipes-core/images/petalinux-image-full.bb): `recipes-core/images/petalinux-image-full.bb`
- [Everything Image](https://github.com/xilinx/meta-petalinux/blob/rel-v2026.1/recipes-core/images/petalinux-image-everything.bb): `recipes-core/images/petalinux-image-everything.bb`
- [Image Common Metadata](https://github.com/xilinx/meta-petalinux/blob/rel-v2026.1/recipes-core/images/petalinux-image-common.inc): `recipes-core/images/petalinux-image-common.inc`
- [Initramfs Image](https://github.com/xilinx/meta-petalinux/blob/rel-v2026.1/recipes-core/images/petalinux-initramfs-image.bb): `recipes-core/images/petalinux-initramfs-image.bb`
- [Package Groups](https://github.com/xilinx/meta-petalinux/tree/rel-v2026.1/recipes-core/packagegroups): `recipes-core/packagegroups`

### Platform Customization

- [Kernel Customization](https://github.com/xilinx/meta-petalinux/blob/rel-v2026.1/recipes-kernel/linux-xlnx/linux-xlnx_%25.bbappend): `recipes-kernel/linux-xlnx/linux-xlnx_%.bbappend`
- [Device Tree](https://github.com/xilinx/meta-petalinux/blob/rel-v2026.1/dynamic-layers/xilinx-core/recipes-bsp/device-tree/device-tree.bbappend): `dynamic-layers/xilinx-core/recipes-bsp/device-tree/device-tree.bbappend`
- [U-Boot Platform](https://github.com/xilinx/meta-petalinux/blob/rel-v2026.1/dynamic-layers/xilinx-core/recipes-bsp/u-boot/u-boot-xlnx/platform-top.h): `dynamic-layers/xilinx-core/recipes-bsp/u-boot/u-boot-xlnx/platform-top.h`
- [Board Applications](https://github.com/xilinx/meta-petalinux/tree/rel-v2026.1/recipes-apps): `recipes-apps`

### Developer Utilities

- [Rootfs Kconfig Generator](https://github.com/xilinx/meta-petalinux/blob/rel-v2026.1/lib/devtool/gen-plnx-kconfig.py): `lib/devtool/gen-plnx-kconfig.py`
- [Recipe Configure](https://github.com/xilinx/meta-petalinux/blob/rel-v2026.1/lib/devtool/configure.py): `lib/devtool/configure.py`
- [SDK Update](https://github.com/xilinx/meta-petalinux/blob/rel-v2026.1/lib/devtool/plnx-sdk-update.py): `lib/devtool/plnx-sdk-update.py`

### Other components

- **Layer User**
- **BitBake**
- **SDK Update Source**

## Connections

- Layer User → Standalone Toolchain: selects machine (evidence: `README.md`)
- Standalone Toolchain → BitBake: builds toolchain (evidence: `README.md`)
- Recipe Configure → BitBake: runs configure (evidence: `lib/devtool/configure.py`)
- Rootfs Kconfig Generator → BitBake: queries recipes (evidence: `lib/devtool/gen-plnx-kconfig.py`)
- Rootfs Kconfig Generator → BitBake: sanity-builds (evidence: `lib/devtool/gen-plnx-kconfig.py`)
- SDK Update → SDK Update Source: reads manifest (evidence: `lib/devtool/plnx-sdk-update.py`)
- SDK Update → SDK Update Source: installs SDK data (evidence: `lib/devtool/plnx-sdk-update.py`)
