# yoctoproject/meta-yocto architecture

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

- Interactive diagram: https://gitdiagram.com/yoctoproject/meta-yocto
- Repository: https://github.com/yoctoproject/meta-yocto

## Overview

This repository is the Poky distribution layer and Yocto BSP metadata: it configures distro policies, board-specific machine and image details, and package customizations used to produce embedded Linux systems. The principal workflow is a build tool consuming layer configuration and recipes to produce a configured image; the supplied excerpts do not show that orchestration, so that relationship is marked unverified. Hardware test controllers and a distro self-test are also represented. The README content and most recipe/configuration implementations were not supplied, limiting verified connections.

Main entry points: [`meta-poky/lib/oeqa/selftest/cases/pokybleeding.py`](https://github.com/yoctoproject/meta-yocto/blob/master/meta-poky/lib/oeqa/selftest/cases/pokybleeding.py) (Revision self-test), [`meta-yocto-bsp/lib/oeqa/controllers/beaglebonetarget.py`](https://github.com/yoctoproject/meta-yocto/blob/master/meta-yocto-bsp/lib/oeqa/controllers/beaglebonetarget.py) (Hardware targets), [`meta-yocto-bsp/lib/oeqa/controllers/grubtarget.py`](https://github.com/yoctoproject/meta-yocto/blob/master/meta-yocto-bsp/lib/oeqa/controllers/grubtarget.py) (GRUB target), [`meta-yocto-bsp/lib/oeqa/selftest/cases/systemd_boot.py`](https://github.com/yoctoproject/meta-yocto/blob/master/meta-yocto-bsp/lib/oeqa/selftest/cases/systemd_boot.py) (Boot self-test)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_layers["Layer Configuration"]
  node_poky_layer["Poky layer<br/>[layer.conf]"]
  node_bsp_layer["BSP layer<br/>[layer.conf]"]
end

subgraph group_distro["Distribution Policy"]
  node_poky_distro["Poky distro<br/>[poky.conf]"]
  node_tiny_distro["Tiny distro<br/>[poky-tiny.conf]"]
  node_bleeding_policy["Bleeding revisions"]
  node_alt_distro["Alternate distros<br/>[poky-altcfg.conf]"]
  node_bleeding_test["Revision self-test<br/>[pokybleeding.py]"]
end

subgraph group_bsp["Board Support"]
  node_board_configs["Machine configs"]
  node_wic_layouts["Disk layouts"]
  node_hardware_targets["Hardware targets"]
  node_grub_target["GRUB target<br/>[grubtarget.py]"]
  node_bsp_selftest["Boot self-test<br/>[systemd_boot.py]"]
end

subgraph group_custom["Image Customization"]
  node_machine_formfactor["Form factor"]
  node_xorg_config["X server config"]
  node_kernel_overrides["Kernel overrides"]
  node_tiny_init["Tiny init<br/>[tiny-init.bb]"]
  node_busybox_config["BusyBox config<br/>[busybox_%.bbappend]"]
  node_splash_asset["Splash image<br/>[psplash-poky-img.h]"]
end

node_builder(("BitBake build"))
node_oeqa["OEQA framework"]

node_builder -.->|"consumes layer"| node_poky_layer
node_builder -.->|"consumes layer"| node_bsp_layer
node_hardware_targets -->|"extends target"| node_oeqa
node_grub_target -->|"extends target"| node_oeqa
node_bleeding_test -->|"uses test APIs"| node_oeqa
node_bsp_selftest -->|"uses test APIs"| node_oeqa

click node_poky_layer "https://github.com/yoctoproject/meta-yocto/blob/master/meta-poky/conf/layer.conf"
click node_bsp_layer "https://github.com/yoctoproject/meta-yocto/blob/master/meta-yocto-bsp/conf/layer.conf"
click node_poky_distro "https://github.com/yoctoproject/meta-yocto/blob/master/meta-poky/conf/distro/poky.conf"
click node_tiny_distro "https://github.com/yoctoproject/meta-yocto/blob/master/meta-poky/conf/distro/poky-tiny.conf"
click node_bleeding_policy "https://github.com/yoctoproject/meta-yocto/blob/master/meta-poky/classes/poky-bleeding.bbclass"
click node_alt_distro "https://github.com/yoctoproject/meta-yocto/blob/master/meta-poky/conf/distro/poky-altcfg.conf"
click node_board_configs "https://github.com/yoctoproject/meta-yocto/tree/master/meta-yocto-bsp/conf/machine"
click node_wic_layouts "https://github.com/yoctoproject/meta-yocto/tree/master/meta-yocto-bsp/files/wic"
click node_hardware_targets "https://github.com/yoctoproject/meta-yocto/blob/master/meta-yocto-bsp/lib/oeqa/controllers/beaglebonetarget.py"
click node_grub_target "https://github.com/yoctoproject/meta-yocto/blob/master/meta-yocto-bsp/lib/oeqa/controllers/grubtarget.py"
click node_machine_formfactor "https://github.com/yoctoproject/meta-yocto/blob/master/meta-yocto-bsp/recipes-bsp/formfactor/formfactor_0.0.bbappend"
click node_xorg_config "https://github.com/yoctoproject/meta-yocto/blob/master/meta-yocto-bsp/recipes-graphics/xorg-xserver/xserver-xf86-config_0.1.bbappend"
click node_kernel_overrides "https://github.com/yoctoproject/meta-yocto/blob/master/meta-yocto-bsp/recipes-kernel/linux/linux-yocto_6.18.bbappend"
click node_tiny_init "https://github.com/yoctoproject/meta-yocto/blob/master/meta-poky/recipes-core/tiny-init/tiny-init.bb"
click node_busybox_config "https://github.com/yoctoproject/meta-yocto/blob/master/meta-poky/recipes-core/busybox/busybox_%25.bbappend"
click node_splash_asset "https://github.com/yoctoproject/meta-yocto/blob/master/meta-poky/recipes-core/psplash/files/psplash-poky-img.h"
click node_bleeding_test "https://github.com/yoctoproject/meta-yocto/blob/master/meta-poky/lib/oeqa/selftest/cases/pokybleeding.py"
click node_bsp_selftest "https://github.com/yoctoproject/meta-yocto/blob/master/meta-yocto-bsp/lib/oeqa/selftest/cases/systemd_boot.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_poky_layer,node_bsp_layer toneBlue
class node_poky_distro,node_tiny_distro,node_bleeding_policy,node_alt_distro,node_bleeding_test toneAmber
class node_board_configs,node_wic_layouts,node_hardware_targets,node_grub_target,node_bsp_selftest toneMint
class node_machine_formfactor,node_xorg_config,node_kernel_overrides,node_tiny_init,node_busybox_config,node_splash_asset toneRose
class node_builder,node_oeqa toneIndigo
```

## Components

### Layer Configuration

- [Poky layer](https://github.com/yoctoproject/meta-yocto/blob/master/meta-poky/conf/layer.conf): `meta-poky/conf/layer.conf`
- [BSP layer](https://github.com/yoctoproject/meta-yocto/blob/master/meta-yocto-bsp/conf/layer.conf): `meta-yocto-bsp/conf/layer.conf`

### Distribution Policy

- [Poky distro](https://github.com/yoctoproject/meta-yocto/blob/master/meta-poky/conf/distro/poky.conf): `meta-poky/conf/distro/poky.conf`
- [Tiny distro](https://github.com/yoctoproject/meta-yocto/blob/master/meta-poky/conf/distro/poky-tiny.conf): `meta-poky/conf/distro/poky-tiny.conf`
- [Bleeding revisions](https://github.com/yoctoproject/meta-yocto/blob/master/meta-poky/classes/poky-bleeding.bbclass): `meta-poky/classes/poky-bleeding.bbclass`
- [Alternate distros](https://github.com/yoctoproject/meta-yocto/blob/master/meta-poky/conf/distro/poky-altcfg.conf): `meta-poky/conf/distro/poky-altcfg.conf`
- [Revision self-test](https://github.com/yoctoproject/meta-yocto/blob/master/meta-poky/lib/oeqa/selftest/cases/pokybleeding.py): `meta-poky/lib/oeqa/selftest/cases/pokybleeding.py`

### Board Support

- [Machine configs](https://github.com/yoctoproject/meta-yocto/tree/master/meta-yocto-bsp/conf/machine): `meta-yocto-bsp/conf/machine`
- [Disk layouts](https://github.com/yoctoproject/meta-yocto/tree/master/meta-yocto-bsp/files/wic): `meta-yocto-bsp/files/wic`
- [Hardware targets](https://github.com/yoctoproject/meta-yocto/blob/master/meta-yocto-bsp/lib/oeqa/controllers/beaglebonetarget.py): `meta-yocto-bsp/lib/oeqa/controllers/beaglebonetarget.py`
- [GRUB target](https://github.com/yoctoproject/meta-yocto/blob/master/meta-yocto-bsp/lib/oeqa/controllers/grubtarget.py): `meta-yocto-bsp/lib/oeqa/controllers/grubtarget.py`
- [Boot self-test](https://github.com/yoctoproject/meta-yocto/blob/master/meta-yocto-bsp/lib/oeqa/selftest/cases/systemd_boot.py): `meta-yocto-bsp/lib/oeqa/selftest/cases/systemd_boot.py`

### Image Customization

- [Form factor](https://github.com/yoctoproject/meta-yocto/blob/master/meta-yocto-bsp/recipes-bsp/formfactor/formfactor_0.0.bbappend): `meta-yocto-bsp/recipes-bsp/formfactor/formfactor_0.0.bbappend`
- [X server config](https://github.com/yoctoproject/meta-yocto/blob/master/meta-yocto-bsp/recipes-graphics/xorg-xserver/xserver-xf86-config_0.1.bbappend): `meta-yocto-bsp/recipes-graphics/xorg-xserver/xserver-xf86-config_0.1.bbappend`
- [Kernel overrides](https://github.com/yoctoproject/meta-yocto/blob/master/meta-yocto-bsp/recipes-kernel/linux/linux-yocto_6.18.bbappend): `meta-yocto-bsp/recipes-kernel/linux/linux-yocto_6.18.bbappend`
- [Tiny init](https://github.com/yoctoproject/meta-yocto/blob/master/meta-poky/recipes-core/tiny-init/tiny-init.bb): `meta-poky/recipes-core/tiny-init/tiny-init.bb`
- [BusyBox config](https://github.com/yoctoproject/meta-yocto/blob/master/meta-poky/recipes-core/busybox/busybox_%25.bbappend): `meta-poky/recipes-core/busybox/busybox_%.bbappend`
- [Splash image](https://github.com/yoctoproject/meta-yocto/blob/master/meta-poky/recipes-core/psplash/files/psplash-poky-img.h): `meta-poky/recipes-core/psplash/files/psplash-poky-img.h`

### Other components

- **BitBake build**
- **OEQA framework**

## Connections

- BitBake build → Poky layer: consumes layer
- BitBake build → BSP layer: consumes layer
- Hardware targets → OEQA framework: extends target (evidence: `meta-yocto-bsp/lib/oeqa/controllers/beaglebonetarget.py`)
- GRUB target → OEQA framework: extends target (evidence: `meta-yocto-bsp/lib/oeqa/controllers/grubtarget.py`)
- Revision self-test → OEQA framework: uses test APIs (evidence: `meta-poky/lib/oeqa/selftest/cases/pokybleeding.py`)
- Boot self-test → OEQA framework: uses test APIs (evidence: `meta-yocto-bsp/lib/oeqa/selftest/cases/systemd_boot.py`)
