# altera-fpga/linux-socfpga architecture

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

- Interactive diagram: https://gitdiagram.com/altera-fpga/linux-socfpga
- Repository: https://github.com/altera-fpga/linux-socfpga

## Overview

Linux is a general-purpose operating-system kernel: it provides shared services and hardware-specific drivers to user processes and other kernel subsystems. The excerpts show selected DMA, crypto, graphics, camera-pipeline, and USB-storage components, not the kernel’s complete boot-to-user workflow. The graph therefore emphasizes these evidenced product areas and their internal boundaries; several components remain unconnected where the excerpts establish no runtime relationship.

Main entry points: [`drivers/crypto/intel/qat/qat_common/adf_accel_engine.c`](https://github.com/altera-fpga/linux-socfpga/blob/socfpga-6.18.20-lts/drivers/crypto/intel/qat/qat_common/adf_accel_engine.c) (QAT accelerator engine), [`drivers/dma/amd/ptdma/ptdma-dmaengine.c`](https://github.com/altera-fpga/linux-socfpga/blob/socfpga-6.18.20-lts/drivers/dma/amd/ptdma/ptdma-dmaengine.c) (PTDMA driver), [`drivers/crypto/ccp/ccp-dmaengine.c`](https://github.com/altera-fpga/linux-socfpga/blob/socfpga-6.18.20-lts/drivers/crypto/ccp/ccp-dmaengine.c) (CCP DMA driver), [`drivers/staging/media/atomisp/pci/runtime/pipeline/src/pipeline.c`](https://github.com/altera-fpga/linux-socfpga/blob/socfpga-6.18.20-lts/drivers/staging/media/atomisp/pci/runtime/pipeline/src/pipeline.c) (AtomISP pipeline)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_dma["DMA services"]
  node_dma_core["DMA framework<br/>[dmaengine.c]"]
  node_dma_api["DMA API<br/>[dmaengine.h]"]
  node_ptdma_driver["PTDMA driver<br/>[ptdma-dmaengine.c]"]
  node_ptdma_state["PTDMA state<br/>[ptdma.h]"]
  node_virt_dma["Virtual DMA<br/>[virt-dma.h]"]
end

subgraph group_crypto["Cryptography drivers"]
  node_ccp_driver["CCP DMA driver<br/>[ccp-dmaengine.c]"]
  node_ccp_state["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"]
  node_qat_config["QAT configuration<br/>[adf_cfg.h]"]
  node_qat_firmware["QAT firmware loader<br/>[icp_qat_uclo.h]"]
end

subgraph group_graphics["Graphics drivers"]
  node_i915_engine["i915 command engines<br/>[intel_engine_cs.c]"]
  node_i915_context["i915 GEM contexts<br/>[i915_gem_context.h]"]
  node_xe_engine["Xe hardware engines<br/>[xe_hw_engine.c]"]
end

subgraph group_camera["Camera pipeline"]
  node_atomisp_pipeline["AtomISP pipeline<br/>[pipeline.c]"]
  node_atomisp_interface["Pipeline interface<br/>[ia_css_pipeline.h]"]
  node_isp_runtime["ISP runtime"]
end

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

node_firmware_service["Kernel firmware service"]

node_ccp_driver -->|"uses state"| node_ccp_state
node_ccp_driver -->|"uses DMA API"| node_dma_api
node_ptdma_driver -->|"uses state"| node_ptdma_state
node_ptdma_driver -->|"uses DMA API"| node_dma_api
node_ptdma_driver -->|"uses virtual DMA"| node_virt_dma
node_qat_engine -->|"accesses state"| node_qat_device
node_qat_engine -->|"uses configuration"| node_qat_config
node_qat_engine -->|"loads firmware"| node_qat_firmware
node_qat_engine -->|"requests firmware"| node_firmware_service
node_atomisp_pipeline -->|"implements interface"| node_atomisp_interface
node_atomisp_pipeline -->|"starts pipeline"| node_isp_runtime
node_mass_storage -->|"uses definitions"| node_storage_common
node_legacy_gadget -->|"configures function"| node_mass_storage
node_i915_engine -->|"uses contexts"| node_i915_context

click node_dma_core "https://github.com/altera-fpga/linux-socfpga/blob/socfpga-6.18.20-lts/drivers/dma/dmaengine.c"
click node_dma_api "https://github.com/altera-fpga/linux-socfpga/blob/socfpga-6.18.20-lts/drivers/dma/dmaengine.h"
click node_ccp_driver "https://github.com/altera-fpga/linux-socfpga/blob/socfpga-6.18.20-lts/drivers/crypto/ccp/ccp-dmaengine.c"
click node_ccp_state "https://github.com/altera-fpga/linux-socfpga/blob/socfpga-6.18.20-lts/drivers/crypto/ccp/ccp-dev.h"
click node_ptdma_driver "https://github.com/altera-fpga/linux-socfpga/blob/socfpga-6.18.20-lts/drivers/dma/amd/ptdma/ptdma-dmaengine.c"
click node_ptdma_state "https://github.com/altera-fpga/linux-socfpga/blob/socfpga-6.18.20-lts/drivers/dma/amd/ptdma/ptdma.h"
click node_virt_dma "https://github.com/altera-fpga/linux-socfpga/blob/socfpga-6.18.20-lts/drivers/dma/virt-dma.h"
click node_crypto_engine "https://github.com/altera-fpga/linux-socfpga/blob/socfpga-6.18.20-lts/crypto/crypto_engine.c"
click node_qat_engine "https://github.com/altera-fpga/linux-socfpga/blob/socfpga-6.18.20-lts/drivers/crypto/intel/qat/qat_common/adf_accel_engine.c"
click node_qat_device "https://github.com/altera-fpga/linux-socfpga/blob/socfpga-6.18.20-lts/drivers/crypto/intel/qat/qat_common/adf_accel_devices.h"
click node_qat_config "https://github.com/altera-fpga/linux-socfpga/blob/socfpga-6.18.20-lts/drivers/crypto/intel/qat/qat_common/adf_cfg.h"
click node_qat_firmware "https://github.com/altera-fpga/linux-socfpga/blob/socfpga-6.18.20-lts/drivers/crypto/intel/qat/qat_common/icp_qat_uclo.h"
click node_i915_engine "https://github.com/altera-fpga/linux-socfpga/blob/socfpga-6.18.20-lts/drivers/gpu/drm/i915/gt/intel_engine_cs.c"
click node_i915_context "https://github.com/altera-fpga/linux-socfpga/blob/socfpga-6.18.20-lts/drivers/gpu/drm/i915/gem/i915_gem_context.h"
click node_xe_engine "https://github.com/altera-fpga/linux-socfpga/blob/socfpga-6.18.20-lts/drivers/gpu/drm/xe/xe_hw_engine.c"
click node_atomisp_pipeline "https://github.com/altera-fpga/linux-socfpga/blob/socfpga-6.18.20-lts/drivers/staging/media/atomisp/pci/runtime/pipeline/src/pipeline.c"
click node_atomisp_interface "https://github.com/altera-fpga/linux-socfpga/blob/socfpga-6.18.20-lts/drivers/staging/media/atomisp/pci/runtime/pipeline/interface/ia_css_pipeline.h"
click node_isp_runtime "https://github.com/altera-fpga/linux-socfpga/tree/socfpga-6.18.20-lts/drivers/staging/media/atomisp/pci"
click node_mass_storage "https://github.com/altera-fpga/linux-socfpga/blob/socfpga-6.18.20-lts/drivers/usb/gadget/function/f_mass_storage.c"
click node_storage_common "https://github.com/altera-fpga/linux-socfpga/blob/socfpga-6.18.20-lts/drivers/usb/gadget/function/storage_common.h"
click node_legacy_gadget "https://github.com/altera-fpga/linux-socfpga/blob/socfpga-6.18.20-lts/drivers/usb/gadget/legacy/mass_storage.c"

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_core,node_dma_api,node_ptdma_driver,node_ptdma_state,node_virt_dma toneBlue
class node_ccp_driver,node_ccp_state,node_crypto_engine,node_qat_engine,node_qat_device,node_qat_config,node_qat_firmware toneAmber
class node_i915_engine,node_i915_context,node_xe_engine toneMint
class node_atomisp_pipeline,node_atomisp_interface,node_isp_runtime toneRose
class node_mass_storage,node_storage_common,node_legacy_gadget,node_firmware_service toneIndigo
```

## Components

### DMA services

- [DMA framework](https://github.com/altera-fpga/linux-socfpga/blob/socfpga-6.18.20-lts/drivers/dma/dmaengine.c): `drivers/dma/dmaengine.c`
- [DMA API](https://github.com/altera-fpga/linux-socfpga/blob/socfpga-6.18.20-lts/drivers/dma/dmaengine.h): `drivers/dma/dmaengine.h`
- [PTDMA driver](https://github.com/altera-fpga/linux-socfpga/blob/socfpga-6.18.20-lts/drivers/dma/amd/ptdma/ptdma-dmaengine.c): `drivers/dma/amd/ptdma/ptdma-dmaengine.c`
- [PTDMA state](https://github.com/altera-fpga/linux-socfpga/blob/socfpga-6.18.20-lts/drivers/dma/amd/ptdma/ptdma.h): `drivers/dma/amd/ptdma/ptdma.h`
- [Virtual DMA](https://github.com/altera-fpga/linux-socfpga/blob/socfpga-6.18.20-lts/drivers/dma/virt-dma.h): `drivers/dma/virt-dma.h`

### Cryptography drivers

- [CCP DMA driver](https://github.com/altera-fpga/linux-socfpga/blob/socfpga-6.18.20-lts/drivers/crypto/ccp/ccp-dmaengine.c): `drivers/crypto/ccp/ccp-dmaengine.c`
- [CCP device state](https://github.com/altera-fpga/linux-socfpga/blob/socfpga-6.18.20-lts/drivers/crypto/ccp/ccp-dev.h): `drivers/crypto/ccp/ccp-dev.h`
- [Crypto request engine](https://github.com/altera-fpga/linux-socfpga/blob/socfpga-6.18.20-lts/crypto/crypto_engine.c): `crypto/crypto_engine.c`
- [QAT accelerator engine](https://github.com/altera-fpga/linux-socfpga/blob/socfpga-6.18.20-lts/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/altera-fpga/linux-socfpga/blob/socfpga-6.18.20-lts/drivers/crypto/intel/qat/qat_common/adf_accel_devices.h): `drivers/crypto/intel/qat/qat_common/adf_accel_devices.h`
- [QAT configuration](https://github.com/altera-fpga/linux-socfpga/blob/socfpga-6.18.20-lts/drivers/crypto/intel/qat/qat_common/adf_cfg.h): `drivers/crypto/intel/qat/qat_common/adf_cfg.h`
- [QAT firmware loader](https://github.com/altera-fpga/linux-socfpga/blob/socfpga-6.18.20-lts/drivers/crypto/intel/qat/qat_common/icp_qat_uclo.h): `drivers/crypto/intel/qat/qat_common/icp_qat_uclo.h`

### Graphics drivers

- [i915 command engines](https://github.com/altera-fpga/linux-socfpga/blob/socfpga-6.18.20-lts/drivers/gpu/drm/i915/gt/intel_engine_cs.c): `drivers/gpu/drm/i915/gt/intel_engine_cs.c`
- [i915 GEM contexts](https://github.com/altera-fpga/linux-socfpga/blob/socfpga-6.18.20-lts/drivers/gpu/drm/i915/gem/i915_gem_context.h): `drivers/gpu/drm/i915/gem/i915_gem_context.h`
- [Xe hardware engines](https://github.com/altera-fpga/linux-socfpga/blob/socfpga-6.18.20-lts/drivers/gpu/drm/xe/xe_hw_engine.c): `drivers/gpu/drm/xe/xe_hw_engine.c`

### Camera pipeline

- [AtomISP pipeline](https://github.com/altera-fpga/linux-socfpga/blob/socfpga-6.18.20-lts/drivers/staging/media/atomisp/pci/runtime/pipeline/src/pipeline.c): `drivers/staging/media/atomisp/pci/runtime/pipeline/src/pipeline.c`
- [Pipeline interface](https://github.com/altera-fpga/linux-socfpga/blob/socfpga-6.18.20-lts/drivers/staging/media/atomisp/pci/runtime/pipeline/interface/ia_css_pipeline.h): `drivers/staging/media/atomisp/pci/runtime/pipeline/interface/ia_css_pipeline.h`
- [ISP runtime](https://github.com/altera-fpga/linux-socfpga/tree/socfpga-6.18.20-lts/drivers/staging/media/atomisp/pci): `drivers/staging/media/atomisp/pci`

### USB storage

- [USB mass storage](https://github.com/altera-fpga/linux-socfpga/blob/socfpga-6.18.20-lts/drivers/usb/gadget/function/f_mass_storage.c): `drivers/usb/gadget/function/f_mass_storage.c`
- [Storage common types](https://github.com/altera-fpga/linux-socfpga/blob/socfpga-6.18.20-lts/drivers/usb/gadget/function/storage_common.h): `drivers/usb/gadget/function/storage_common.h`
- [Legacy gadget setup](https://github.com/altera-fpga/linux-socfpga/blob/socfpga-6.18.20-lts/drivers/usb/gadget/legacy/mass_storage.c): `drivers/usb/gadget/legacy/mass_storage.c`

### Other components

- **Kernel firmware service**

## Connections

- CCP DMA driver → CCP device state: uses state (evidence: `drivers/crypto/ccp/ccp-dmaengine.c`)
- CCP DMA driver → DMA API: uses DMA API (evidence: `drivers/crypto/ccp/ccp-dmaengine.c`)
- PTDMA driver → PTDMA state: uses state (evidence: `drivers/dma/amd/ptdma/ptdma-dmaengine.c`)
- PTDMA driver → DMA API: uses DMA API (evidence: `drivers/dma/amd/ptdma/ptdma-dmaengine.c`)
- PTDMA driver → Virtual DMA: uses virtual DMA
- QAT accelerator engine → QAT device model: accesses state (evidence: `drivers/crypto/intel/qat/qat_common/adf_accel_engine.c`)
- QAT accelerator engine → QAT configuration: uses configuration (evidence: `drivers/crypto/intel/qat/qat_common/adf_accel_engine.c`)
- QAT accelerator engine → QAT firmware loader: loads firmware (evidence: `drivers/crypto/intel/qat/qat_common/adf_accel_engine.c`)
- QAT accelerator engine → Kernel firmware service: requests firmware (evidence: `drivers/crypto/intel/qat/qat_common/adf_accel_engine.c`)
- AtomISP pipeline → Pipeline interface: implements interface (evidence: `drivers/staging/media/atomisp/pci/runtime/pipeline/src/pipeline.c`)
- AtomISP pipeline → ISP runtime: starts pipeline (evidence: `drivers/staging/media/atomisp/pci/runtime/pipeline/src/pipeline.c`)
- USB mass storage → Storage common types: uses definitions (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`)
- i915 command engines → i915 GEM contexts: uses contexts (evidence: `drivers/gpu/drm/i915/gt/intel_engine_cs.c`)
