# at1600/android_kernel_xiaomi_common architecture

> Architecture diagram of the GitHub repository at1600/android_kernel_xiaomi_common, 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/at1600/android_kernel_xiaomi_common
- Repository: https://github.com/at1600/android_kernel_xiaomi_common

## Overview

This repository is an Android Common Kernel: a Linux kernel tree with architecture support and many largely independent drivers and subsystems, not a single application pipeline. The sample highlights DMA, GPU engines, camera processing, USB mass storage, and a few other kernel facilities. The principal workflow is a workload or device request entering the relevant kernel subsystem and reaching hardware or stored data; the subsystems shown here do not form one end-to-end path. Some relationships are omitted because their wiring was not shown in the excerpts or source index.

Main entry points: [`drivers/dma/dmaengine.c`](https://github.com/at1600/android_kernel_xiaomi_common/blob/6.12/drivers/dma/dmaengine.c) (DMA framework), [`drivers/crypto/ccp/ccp-dmaengine.c`](https://github.com/at1600/android_kernel_xiaomi_common/blob/6.12/drivers/crypto/ccp/ccp-dmaengine.c) (CCP DMA driver), [`drivers/staging/media/atomisp/pci/runtime/pipeline/src/pipeline.c`](https://github.com/at1600/android_kernel_xiaomi_common/blob/6.12/drivers/staging/media/atomisp/pci/runtime/pipeline/src/pipeline.c) (AtomISP pipeline), [`fs/romfs/storage.c`](https://github.com/at1600/android_kernel_xiaomi_common/blob/6.12/fs/romfs/storage.c) (RomFS storage)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_dma["DMA services"]
  node_dma_api["DMA framework<br/>[dmaengine.c]"]
  node_dma_contract["DMA internals<br/>[dmaengine.h]"]
  node_ccp_dma["CCP DMA driver<br/>[ccp-dmaengine.c]"]
  node_iio_dma["IIO DMA buffer"]
end

subgraph group_gpu["Graphics engines"]
  node_i915_engine["i915 engines<br/>[intel_engine_cs.c]"]
  node_i915_context["i915 contexts<br/>[intel_context.h]"]
  node_xe_engine["Xe hardware engines<br/>[xe_hw_engine.c]"]
end

subgraph group_media["Media and storage"]
  node_atomisp_pipeline["AtomISP pipeline<br/>[pipeline.c]"]
  node_atomisp_api["AtomISP pipeline API<br/>[ia_css_pipeline.h]"]
  node_usb_legacy["Mass storage setup<br/>[mass_storage.c]"]
  node_usb_function["USB storage function<br/>[f_mass_storage.c]"]
  node_romfs["RomFS storage<br/>[storage.c]"]
end

subgraph group_kernel["Kernel facilities"]
  node_dsp_pipeline["mISDN DSP pipeline<br/>[dsp_pipeline.c]"]
  node_dsp_elements["DSP elements<br/>[dsp_pipeline.c]"]
  node_crypto_engine["Crypto engine<br/>[crypto_engine.c]"]
  node_qat_device["QAT accelerator model"]
end

node_workload(("Kernel workload"))
node_block_device[("Block device")]
node_mtd_device[("MTD device")]

node_dma_api -->|"uses helpers"| node_dma_contract
node_ccp_dma -->|"registers transfers"| node_dma_api
node_ccp_dma -->|"uses cookies"| node_dma_contract
node_workload -.->|"requests channels"| node_dma_api
node_i915_engine -->|"uses contexts"| node_i915_context
node_workload -.->|"submits work"| node_i915_engine
node_workload -.->|"submits work"| node_xe_engine
node_atomisp_pipeline -->|"implements API"| node_atomisp_api
node_atomisp_pipeline -.->|"starts pipeline"| node_workload
node_usb_legacy -->|"configures function"| node_usb_function
node_usb_function -.->|"serves USB requests"| node_workload
node_romfs -->|"reads blocks"| node_block_device
node_romfs -->|"reads image"| node_mtd_device
node_dsp_pipeline -->|"builds from elements"| node_dsp_elements
node_crypto_engine -.->|"queues requests"| node_workload

click node_dma_api "https://github.com/at1600/android_kernel_xiaomi_common/blob/6.12/drivers/dma/dmaengine.c"
click node_dma_contract "https://github.com/at1600/android_kernel_xiaomi_common/blob/6.12/drivers/dma/dmaengine.h"
click node_ccp_dma "https://github.com/at1600/android_kernel_xiaomi_common/blob/6.12/drivers/crypto/ccp/ccp-dmaengine.c"
click node_iio_dma "https://github.com/at1600/android_kernel_xiaomi_common/blob/6.12/drivers/iio/buffer/industrialio-buffer-dmaengine.c"
click node_i915_engine "https://github.com/at1600/android_kernel_xiaomi_common/blob/6.12/drivers/gpu/drm/i915/gt/intel_engine_cs.c"
click node_i915_context "https://github.com/at1600/android_kernel_xiaomi_common/blob/6.12/drivers/gpu/drm/i915/gt/intel_context.h"
click node_xe_engine "https://github.com/at1600/android_kernel_xiaomi_common/blob/6.12/drivers/gpu/drm/xe/xe_hw_engine.c"
click node_atomisp_pipeline "https://github.com/at1600/android_kernel_xiaomi_common/blob/6.12/drivers/staging/media/atomisp/pci/runtime/pipeline/src/pipeline.c"
click node_atomisp_api "https://github.com/at1600/android_kernel_xiaomi_common/blob/6.12/drivers/staging/media/atomisp/pci/runtime/pipeline/interface/ia_css_pipeline.h"
click node_usb_legacy "https://github.com/at1600/android_kernel_xiaomi_common/blob/6.12/drivers/usb/gadget/legacy/mass_storage.c"
click node_usb_function "https://github.com/at1600/android_kernel_xiaomi_common/blob/6.12/drivers/usb/gadget/function/f_mass_storage.c"
click node_romfs "https://github.com/at1600/android_kernel_xiaomi_common/blob/6.12/fs/romfs/storage.c"
click node_dsp_pipeline "https://github.com/at1600/android_kernel_xiaomi_common/blob/6.12/drivers/isdn/mISDN/dsp_pipeline.c"
click node_dsp_elements "https://github.com/at1600/android_kernel_xiaomi_common/blob/6.12/drivers/isdn/mISDN/dsp_pipeline.c"
click node_crypto_engine "https://github.com/at1600/android_kernel_xiaomi_common/blob/6.12/crypto/crypto_engine.c"
click node_qat_device "https://github.com/at1600/android_kernel_xiaomi_common/blob/6.12/drivers/crypto/intel/qat/qat_common/adf_accel_devices.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_contract,node_ccp_dma,node_iio_dma toneBlue
class node_i915_engine,node_i915_context,node_xe_engine,node_block_device,node_mtd_device toneAmber
class node_atomisp_pipeline,node_atomisp_api,node_usb_legacy,node_usb_function,node_romfs toneMint
class node_dsp_pipeline,node_dsp_elements,node_crypto_engine,node_qat_device toneRose
class node_workload toneIndigo
```

## Components

### DMA services

- [DMA framework](https://github.com/at1600/android_kernel_xiaomi_common/blob/6.12/drivers/dma/dmaengine.c): `drivers/dma/dmaengine.c`
- [DMA internals](https://github.com/at1600/android_kernel_xiaomi_common/blob/6.12/drivers/dma/dmaengine.h): `drivers/dma/dmaengine.h`
- [CCP DMA driver](https://github.com/at1600/android_kernel_xiaomi_common/blob/6.12/drivers/crypto/ccp/ccp-dmaengine.c): `drivers/crypto/ccp/ccp-dmaengine.c`
- [IIO DMA buffer](https://github.com/at1600/android_kernel_xiaomi_common/blob/6.12/drivers/iio/buffer/industrialio-buffer-dmaengine.c): `drivers/iio/buffer/industrialio-buffer-dmaengine.c`

### Graphics engines

- [i915 engines](https://github.com/at1600/android_kernel_xiaomi_common/blob/6.12/drivers/gpu/drm/i915/gt/intel_engine_cs.c): `drivers/gpu/drm/i915/gt/intel_engine_cs.c`
- [i915 contexts](https://github.com/at1600/android_kernel_xiaomi_common/blob/6.12/drivers/gpu/drm/i915/gt/intel_context.h): `drivers/gpu/drm/i915/gt/intel_context.h`
- [Xe hardware engines](https://github.com/at1600/android_kernel_xiaomi_common/blob/6.12/drivers/gpu/drm/xe/xe_hw_engine.c): `drivers/gpu/drm/xe/xe_hw_engine.c`

### Media and storage

- [AtomISP pipeline](https://github.com/at1600/android_kernel_xiaomi_common/blob/6.12/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/at1600/android_kernel_xiaomi_common/blob/6.12/drivers/staging/media/atomisp/pci/runtime/pipeline/interface/ia_css_pipeline.h): `drivers/staging/media/atomisp/pci/runtime/pipeline/interface/ia_css_pipeline.h`
- [Mass storage setup](https://github.com/at1600/android_kernel_xiaomi_common/blob/6.12/drivers/usb/gadget/legacy/mass_storage.c): `drivers/usb/gadget/legacy/mass_storage.c`
- [USB storage function](https://github.com/at1600/android_kernel_xiaomi_common/blob/6.12/drivers/usb/gadget/function/f_mass_storage.c): `drivers/usb/gadget/function/f_mass_storage.c`
- [RomFS storage](https://github.com/at1600/android_kernel_xiaomi_common/blob/6.12/fs/romfs/storage.c): `fs/romfs/storage.c`

### Kernel facilities

- [mISDN DSP pipeline](https://github.com/at1600/android_kernel_xiaomi_common/blob/6.12/drivers/isdn/mISDN/dsp_pipeline.c): `drivers/isdn/mISDN/dsp_pipeline.c`
- [DSP elements](https://github.com/at1600/android_kernel_xiaomi_common/blob/6.12/drivers/isdn/mISDN/dsp_pipeline.c): `drivers/isdn/mISDN/dsp_pipeline.c`
- [Crypto engine](https://github.com/at1600/android_kernel_xiaomi_common/blob/6.12/crypto/crypto_engine.c): `crypto/crypto_engine.c`
- [QAT accelerator model](https://github.com/at1600/android_kernel_xiaomi_common/blob/6.12/drivers/crypto/intel/qat/qat_common/adf_accel_devices.h): `drivers/crypto/intel/qat/qat_common/adf_accel_devices.h`

### Other components

- **Kernel workload**
- **Block device**
- **MTD device**

## Connections

- DMA framework → DMA internals: uses helpers (evidence: `drivers/dma/dmaengine.c`)
- CCP DMA driver → DMA framework: registers transfers (evidence: `drivers/crypto/ccp/ccp-dmaengine.c`)
- CCP DMA driver → DMA internals: uses cookies (evidence: `drivers/crypto/ccp/ccp-dmaengine.c`)
- Kernel workload → DMA framework: requests channels
- i915 engines → i915 contexts: uses contexts (evidence: `drivers/gpu/drm/i915/gt/intel_engine_cs.c`)
- Kernel workload → i915 engines: submits work
- Kernel workload → Xe hardware engines: submits work
- AtomISP pipeline → AtomISP pipeline API: implements API (evidence: `drivers/staging/media/atomisp/pci/runtime/pipeline/src/pipeline.c`)
- AtomISP pipeline → Kernel workload: starts pipeline
- Mass storage setup → USB storage function: configures function (evidence: `drivers/usb/gadget/legacy/mass_storage.c`)
- USB storage function → Kernel workload: serves USB requests
- RomFS storage → Block device: reads blocks (evidence: `fs/romfs/storage.c`)
- RomFS storage → MTD device: reads image (evidence: `fs/romfs/storage.c`)
- mISDN DSP pipeline → DSP elements: builds from elements (evidence: `drivers/isdn/mISDN/dsp_pipeline.c`)
- Crypto engine → Kernel workload: queues requests
