# linaro/meta-qcom architecture

> Architecture diagram of the GitHub repository linaro/meta-qcom, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-01-16). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/linaro/meta-qcom
- Repository: https://github.com/linaro/meta-qcom

## Overview

Key Components to Include:

##### Layer Structure and Dependencies
- Core Components:
- OpenEmbedded Core (meta) [Required Dependency]
- Meta-OpenEmbedded (meta-oe) [Optional Dependency]
- Meta-QCOM Layer

##### Recipe Categories (Main Functional Blocks)
- BSP Components:
- Firmware (/recipes-bsp/firmware)
- U-Boot (/recipes-bsp/u-boot)
- Package Groups (/recipes-bsp/packagegroups)
- Kernel Components:
- Linux Kernel Recipes (/recipes-kernel/linux)
- Device Trees
- Kernel Configurations
- Development Tools:
- Debug Tools (/recipes-devtools)
- QC Image Tools
- Android Tools
- Support Components:
- FastRPC
- Remote File System
- Platform Drivers

##### Machine Configurations
- Primary Machine: qcom-armv8a
- Board-specific Includes
- Platform-specific Configurations

##### Use a Layered Architecture Approach
- [Top Layer: Machine Configurations]
- ↓
- [Middle Layer: BSP Components]
- ↓
- [Bottom Layer: Core Dependencies]

##### Special Elements
- Dynamic Layers (dynamic-layers folder)
- Configuration Flow
- Build System Integration

##### Clear separation between
- Hardware-specific components
- Generic support functions
- Development tools
- Build system integration

## Diagram (Mermaid)

```mermaid
flowchart TB
    %% Styles and Classes
    classDef core fill:#b3d9ff,stroke:#333
    classDef bsp fill:#90EE90,stroke:#333
    classDef dev fill:#FFB366,stroke:#333
    classDef support fill:#FFFF99,stroke:#333
    classDef machine fill:#DDA0DD,stroke:#333
    classDef config fill:#E6E6E6,stroke:#333

    %% Legend
    subgraph Legend
        L1[Core Dependencies]:::core
        L2[BSP Components]:::bsp
        L3[Development Tools]:::dev
        L4[Support Components]:::support
        L5[Machine Configurations]:::machine
    end

    %% Core Dependencies Layer
    subgraph CoreDeps
        OE[OpenEmbedded Core]:::core
        MetaOE[Meta-OpenEmbedded]:::core
        MetaQCOM[Meta-QCOM Layer]:::core
    end

    %% Machine Configurations Layer
    subgraph MachineConfig
        MC["Machine Config"]:::machine
        click MC "https://github.com/linaro/meta-qcom/blob/master/conf/machine/qcom-armv8a.conf"
        BSPInc["Board-specific Includes"]:::machine
        click BSPInc "https://github.com/linaro/meta-qcom/tree/master/conf/machine/include/"
        LayerConf["Layer Configuration"]:::config
        click LayerConf "https://github.com/linaro/meta-qcom/blob/master/conf/layer.conf"
    end

    %% BSP Components Layer
    subgraph BSPComponents
        Firmware["Firmware"]:::bsp
        click Firmware "https://github.com/linaro/meta-qcom/tree/master/recipes-bsp/firmware/"
        UBoot["U-Boot"]:::bsp
        click UBoot "https://github.com/linaro/meta-qcom/tree/master/recipes-bsp/u-boot/"
        PackageGroups["Package Groups"]:::bsp
        click PackageGroups "https://github.com/linaro/meta-qcom/tree/master/recipes-bsp/packagegroups/"
    end

    %% Kernel Components Layer
    subgraph KernelComponents
        Linux["Linux Kernel"]:::bsp
        click Linux "https://github.com/linaro/meta-qcom/tree/master/recipes-kernel/linux/"
        DeviceTrees["Device Trees"]:::bsp
        click DeviceTrees "https://github.com/linaro/meta-qcom/tree/master/recipes-kernel/linux/linux-yocto/bsp/"
        KernelConfig["Kernel Configurations"]:::bsp
        click KernelConfig "https://github.com/linaro/meta-qcom/tree/master/recipes-kernel/linux/linux-yocto/bsp/"
        PlatformDrivers["Platform Drivers"]:::bsp
        click PlatformDrivers "https://github.com/linaro/meta-qcom/tree/master/recipes-kernel/linux/linux-yocto/generic-drivers/"
    end

    %% Development Tools Layer
    subgraph DevTools
        DebugTools["Debug Tools"]:::dev
        click DebugTools "https://github.com/linaro/meta-qcom/tree/master/recipes-devtools/debugcc/"
        QCImageTools["QC Image Tools"]:::dev
        click QCImageTools "https://github.com/linaro/meta-qcom/tree/master/recipes-devtools/qc-image-unpacker/"
        AndroidTools["Android Tools"]:::dev
        click AndroidTools "https://github.com/linaro/meta-qcom/tree/master/dynamic-layers/openembedded-layer/recipes-devtools/android-tools/"
    end

    %% Support Components Layer
    subgraph SupportComponents
        FastRPC["FastRPC"]:::support
        click FastRPC "https://github.com/linaro/meta-qcom/tree/master/recipes-support/fastrpc/"
        RemoteFS["Remote File System"]:::support
        click RemoteFS "https://github.com/linaro/meta-qcom/tree/master/recipes-support/rmtfs/"
    end

    %% Build System Integration
    subgraph BuildSystem
        BuildTemplates["Build Templates"]:::config
        click BuildTemplates "https://github.com/linaro/meta-qcom/blob/master/.github/workflows/build-template.yml"
        BuildScripts["Build Scripts"]:::config
        click BuildScripts "https://github.com/linaro/meta-qcom/tree/master/.github/workflows/"
    end

    %% Relationships
    OE --> MetaQCOM
    MetaOE -.-> MetaQCOM
    MetaQCOM --> MC
    MC --> BSPComponents
    MC --> KernelComponents
    LayerConf --> MC
    BSPInc --> MC
    BSPComponents --> DevTools
    KernelComponents --> DevTools
    BSPComponents --> SupportComponents
    KernelComponents --> SupportComponents
    BuildSystem --> MC
```
