# aspeedtech-bmc/linux architecture

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

- Interactive diagram: https://gitdiagram.com/aspeedtech-bmc/linux
- Repository: https://github.com/aspeedtech-bmc/linux

## Overview

Linux is a general-purpose kernel: it exposes services to user space and coordinates hardware through subsystem APIs and device drivers. The supplied excerpts show representative paths for DMA, crypto acceleration, USB mass storage, GPU engines, camera pipelines, and ASPEED video capture—not the whole kernel. The graph preserves these distinct capabilities and central indexed modules; edges are limited to relationships visible in excerpts or the SOURCE INDEX, so several components have no asserted connections.

Main entry points: [`drivers/dma/dmaengine.h`](https://github.com/aspeedtech-bmc/linux/blob/aspeed-master-v6.18/drivers/dma/dmaengine.h) (DMA API header), [`drivers/dma/amd/ptdma/ptdma-dmaengine.c`](https://github.com/aspeedtech-bmc/linux/blob/aspeed-master-v6.18/drivers/dma/amd/ptdma/ptdma-dmaengine.c) (AMD PTDMA driver), [`drivers/crypto/ccp/ccp-dmaengine.c`](https://github.com/aspeedtech-bmc/linux/blob/aspeed-master-v6.18/drivers/crypto/ccp/ccp-dmaengine.c) (CCP DMA driver), [`drivers/usb/gadget/function/f_mass_storage.c`](https://github.com/aspeedtech-bmc/linux/blob/aspeed-master-v6.18/drivers/usb/gadget/function/f_mass_storage.c) (USB mass storage)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_dma["DMA subsystem"]
  node_dma_api["DMA core<br/>[dmaengine.c]"]
  node_dma_header["DMA API header<br/>[dmaengine.h]"]
  node_ptdma["AMD PTDMA driver<br/>[ptdma-dmaengine.c]"]
  node_ptdma_state["PTDMA state<br/>[ptdma.h]"]
end

subgraph group_crypto["Crypto acceleration"]
  node_ccp_dma["CCP DMA driver<br/>[ccp-dmaengine.c]"]
  node_ccp_device["CCP device state<br/>[ccp-dev.h]"]
  node_crypto_engine["Crypto request engine<br/>[crypto_engine.c]"]
  node_qat_engine["QAT accelerator engine<br/>[adf_accel_engine.c]"]
  node_qat_device["QAT device model"]
end

subgraph group_media["Graphics and media"]
  node_i915_engine["i915 engines<br/>[intel_engine_cs.c]"]
  node_xe_engine["Xe hardware engines<br/>[xe_hw_engine.c]"]
  node_atomisp_pipeline["AtomISP pipeline<br/>[pipeline.c]"]
  node_atomisp_api["AtomISP pipeline API<br/>[ia_css_pipeline.h]"]
end

subgraph group_usb["USB storage"]
  node_mass_storage["USB mass storage<br/>[f_mass_storage.c]"]
  node_storage_common["Storage helpers<br/>[storage_common.h]"]
  node_legacy_gadget["Legacy gadget setup<br/>[mass_storage.c]"]
end

subgraph group_rvas["ASPEED video"]
  node_rvas_video["RVAS video engine<br/>[video_engine.c]"]
  node_rvas_hardware["RVAS hardware engines<br/>[hardware_engines.c]"]
  node_rvas_hardware_api["Hardware engine API<br/>[hardware_engines.h]"]
end

node_kernel_clients(("Kernel clients"))

node_dma_api -->|"uses API"| node_dma_header
node_ccp_dma -->|"uses state"| node_ccp_device
node_ccp_dma -->|"uses API"| node_dma_header
node_ptdma -->|"uses state"| node_ptdma_state
node_ptdma -->|"uses API"| node_dma_header
node_qat_engine -->|"uses model"| node_qat_device
node_atomisp_pipeline -->|"uses interface"| node_atomisp_api
node_mass_storage -->|"uses helpers"| node_storage_common
node_legacy_gadget -->|"configures function"| node_mass_storage
node_rvas_video -->|"uses engines"| node_rvas_hardware
node_rvas_hardware -->|"implements API"| node_rvas_hardware_api

click node_dma_api "https://github.com/aspeedtech-bmc/linux/blob/aspeed-master-v6.18/drivers/dma/dmaengine.c"
click node_dma_header "https://github.com/aspeedtech-bmc/linux/blob/aspeed-master-v6.18/drivers/dma/dmaengine.h"
click node_ccp_dma "https://github.com/aspeedtech-bmc/linux/blob/aspeed-master-v6.18/drivers/crypto/ccp/ccp-dmaengine.c"
click node_ccp_device "https://github.com/aspeedtech-bmc/linux/blob/aspeed-master-v6.18/drivers/crypto/ccp/ccp-dev.h"
click node_ptdma "https://github.com/aspeedtech-bmc/linux/blob/aspeed-master-v6.18/drivers/dma/amd/ptdma/ptdma-dmaengine.c"
click node_ptdma_state "https://github.com/aspeedtech-bmc/linux/blob/aspeed-master-v6.18/drivers/dma/amd/ptdma/ptdma.h"
click node_crypto_engine "https://github.com/aspeedtech-bmc/linux/blob/aspeed-master-v6.18/crypto/crypto_engine.c"
click node_qat_engine "https://github.com/aspeedtech-bmc/linux/blob/aspeed-master-v6.18/drivers/crypto/intel/qat/qat_common/adf_accel_engine.c"
click node_qat_device "https://github.com/aspeedtech-bmc/linux/blob/aspeed-master-v6.18/drivers/crypto/intel/qat/qat_common/adf_accel_devices.h"
click node_i915_engine "https://github.com/aspeedtech-bmc/linux/blob/aspeed-master-v6.18/drivers/gpu/drm/i915/gt/intel_engine_cs.c"
click node_xe_engine "https://github.com/aspeedtech-bmc/linux/blob/aspeed-master-v6.18/drivers/gpu/drm/xe/xe_hw_engine.c"
click node_atomisp_pipeline "https://github.com/aspeedtech-bmc/linux/blob/aspeed-master-v6.18/drivers/staging/media/atomisp/pci/runtime/pipeline/src/pipeline.c"
click node_atomisp_api "https://github.com/aspeedtech-bmc/linux/blob/aspeed-master-v6.18/drivers/staging/media/atomisp/pci/runtime/pipeline/interface/ia_css_pipeline.h"
click node_mass_storage "https://github.com/aspeedtech-bmc/linux/blob/aspeed-master-v6.18/drivers/usb/gadget/function/f_mass_storage.c"
click node_storage_common "https://github.com/aspeedtech-bmc/linux/blob/aspeed-master-v6.18/drivers/usb/gadget/function/storage_common.h"
click node_legacy_gadget "https://github.com/aspeedtech-bmc/linux/blob/aspeed-master-v6.18/drivers/usb/gadget/legacy/mass_storage.c"
click node_rvas_video "https://github.com/aspeedtech-bmc/linux/blob/aspeed-master-v6.18/drivers/soc/aspeed/rvas/video_engine.c"
click node_rvas_hardware "https://github.com/aspeedtech-bmc/linux/blob/aspeed-master-v6.18/drivers/soc/aspeed/rvas/hardware_engines.c"
click node_rvas_hardware_api "https://github.com/aspeedtech-bmc/linux/blob/aspeed-master-v6.18/drivers/soc/aspeed/rvas/hardware_engines.h"

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_dma_api,node_dma_header,node_ptdma,node_ptdma_state,node_kernel_clients toneBlue
class node_ccp_dma,node_ccp_device,node_crypto_engine,node_qat_engine,node_qat_device toneAmber
class node_i915_engine,node_xe_engine,node_atomisp_pipeline,node_atomisp_api toneMint
class node_mass_storage,node_storage_common,node_legacy_gadget toneRose
class node_rvas_video,node_rvas_hardware,node_rvas_hardware_api toneIndigo
```

## Components

### DMA subsystem

- [DMA core](https://github.com/aspeedtech-bmc/linux/blob/aspeed-master-v6.18/drivers/dma/dmaengine.c): `drivers/dma/dmaengine.c`
- [DMA API header](https://github.com/aspeedtech-bmc/linux/blob/aspeed-master-v6.18/drivers/dma/dmaengine.h): `drivers/dma/dmaengine.h`
- [AMD PTDMA driver](https://github.com/aspeedtech-bmc/linux/blob/aspeed-master-v6.18/drivers/dma/amd/ptdma/ptdma-dmaengine.c): `drivers/dma/amd/ptdma/ptdma-dmaengine.c`
- [PTDMA state](https://github.com/aspeedtech-bmc/linux/blob/aspeed-master-v6.18/drivers/dma/amd/ptdma/ptdma.h): `drivers/dma/amd/ptdma/ptdma.h`

### Crypto acceleration

- [CCP DMA driver](https://github.com/aspeedtech-bmc/linux/blob/aspeed-master-v6.18/drivers/crypto/ccp/ccp-dmaengine.c): `drivers/crypto/ccp/ccp-dmaengine.c`
- [CCP device state](https://github.com/aspeedtech-bmc/linux/blob/aspeed-master-v6.18/drivers/crypto/ccp/ccp-dev.h): `drivers/crypto/ccp/ccp-dev.h`
- [Crypto request engine](https://github.com/aspeedtech-bmc/linux/blob/aspeed-master-v6.18/crypto/crypto_engine.c): `crypto/crypto_engine.c`
- [QAT accelerator engine](https://github.com/aspeedtech-bmc/linux/blob/aspeed-master-v6.18/drivers/crypto/intel/qat/qat_common/adf_accel_engine.c): `drivers/crypto/intel/qat/qat_common/adf_accel_engine.c`
- [QAT device model](https://github.com/aspeedtech-bmc/linux/blob/aspeed-master-v6.18/drivers/crypto/intel/qat/qat_common/adf_accel_devices.h): `drivers/crypto/intel/qat/qat_common/adf_accel_devices.h`

### Graphics and media

- [i915 engines](https://github.com/aspeedtech-bmc/linux/blob/aspeed-master-v6.18/drivers/gpu/drm/i915/gt/intel_engine_cs.c): `drivers/gpu/drm/i915/gt/intel_engine_cs.c`
- [Xe hardware engines](https://github.com/aspeedtech-bmc/linux/blob/aspeed-master-v6.18/drivers/gpu/drm/xe/xe_hw_engine.c): `drivers/gpu/drm/xe/xe_hw_engine.c`
- [AtomISP pipeline](https://github.com/aspeedtech-bmc/linux/blob/aspeed-master-v6.18/drivers/staging/media/atomisp/pci/runtime/pipeline/src/pipeline.c): `drivers/staging/media/atomisp/pci/runtime/pipeline/src/pipeline.c`
- [AtomISP pipeline API](https://github.com/aspeedtech-bmc/linux/blob/aspeed-master-v6.18/drivers/staging/media/atomisp/pci/runtime/pipeline/interface/ia_css_pipeline.h): `drivers/staging/media/atomisp/pci/runtime/pipeline/interface/ia_css_pipeline.h`

### USB storage

- [USB mass storage](https://github.com/aspeedtech-bmc/linux/blob/aspeed-master-v6.18/drivers/usb/gadget/function/f_mass_storage.c): `drivers/usb/gadget/function/f_mass_storage.c`
- [Storage helpers](https://github.com/aspeedtech-bmc/linux/blob/aspeed-master-v6.18/drivers/usb/gadget/function/storage_common.h): `drivers/usb/gadget/function/storage_common.h`
- [Legacy gadget setup](https://github.com/aspeedtech-bmc/linux/blob/aspeed-master-v6.18/drivers/usb/gadget/legacy/mass_storage.c): `drivers/usb/gadget/legacy/mass_storage.c`

### ASPEED video

- [RVAS video engine](https://github.com/aspeedtech-bmc/linux/blob/aspeed-master-v6.18/drivers/soc/aspeed/rvas/video_engine.c): `drivers/soc/aspeed/rvas/video_engine.c`
- [RVAS hardware engines](https://github.com/aspeedtech-bmc/linux/blob/aspeed-master-v6.18/drivers/soc/aspeed/rvas/hardware_engines.c): `drivers/soc/aspeed/rvas/hardware_engines.c`
- [Hardware engine API](https://github.com/aspeedtech-bmc/linux/blob/aspeed-master-v6.18/drivers/soc/aspeed/rvas/hardware_engines.h): `drivers/soc/aspeed/rvas/hardware_engines.h`

### Other components

- **Kernel clients**

## Connections

- DMA core → DMA API header: uses API (evidence: `drivers/dma/dmaengine.c`)
- CCP DMA driver → CCP device state: uses state (evidence: `drivers/crypto/ccp/ccp-dmaengine.c`)
- CCP DMA driver → DMA API header: uses API (evidence: `drivers/crypto/ccp/ccp-dmaengine.c`)
- AMD PTDMA driver → PTDMA state: uses state (evidence: `drivers/dma/amd/ptdma/ptdma-dmaengine.c`)
- AMD PTDMA driver → DMA API header: uses API (evidence: `drivers/dma/amd/ptdma/ptdma-dmaengine.c`)
- QAT accelerator engine → QAT device model: uses model (evidence: `drivers/crypto/intel/qat/qat_common/adf_accel_engine.c`)
- AtomISP pipeline → AtomISP pipeline API: uses interface (evidence: `drivers/staging/media/atomisp/pci/runtime/pipeline/src/pipeline.c`)
- USB mass storage → Storage helpers: uses helpers (evidence: `drivers/usb/gadget/function/f_mass_storage.c`)
- Legacy gadget setup → USB mass storage: configures function (evidence: `drivers/usb/gadget/legacy/mass_storage.c`)
- RVAS video engine → RVAS hardware engines: uses engines (evidence: `drivers/soc/aspeed/rvas/video_engine.c`)
- RVAS hardware engines → Hardware engine API: implements API (evidence: `drivers/soc/aspeed/rvas/hardware_engines.c`)
