API Documentation#

The Sound Open Firmware (SOF) C application programming interface (API) documentation is generated directly from the firmware source code comments and header files using Doxygen. This ensures that the documentation is always synchronized with the actual implementation across all supported audio components, pipeline infrastructure, hardware abstraction layers, and IPC protocols.

Sound Open Firmware Doxygen API Documentation

Browse the complete, interactive C API reference generated directly from the SOF firmware codebase, including data structures, function declarations, macros, enumerations, file hierarchies, and dependency call graphs.

Open Doxygen API Reference →

Overview of Documented Modules#

The Doxygen documentation covers the entire public firmware and host-shared interface:

  • Audio Components & Pipelines: Core component driver lifecycle (component.h), component extensions and buffer helpers (component_ext.h), and PCM stream buffer utilities (audio_stream.h).

  • Hardware Drivers & Interfaces: Direct Memory Access (dma.h), Digital Audio Interfaces for I2S/SSP, SoundWire/ALH, DMIC/PDM, and HDA (dai.h), Power Management runtime (pm_runtime.h), and platform hardware timers and interrupt controllers (platform.h).

  • Core RTOS & System Services: Real-time task scheduling (EDF, LL-Timer, LL-DMA, Zephyr DataProcessing threads in schedule.h), memory allocation heaps (alloc.h), and component/pipeline UUID declarations (uuid.h).

  • IPC & Host Interfaces: User/Kernel IPC ABI protocols and messaging envelopes (ipc/header.h, ipc/control.h), and SRAM Window 0 firmware status registers and telemetry offsets (kernel/mailbox.h).

  • Source Code Graphs & File Browsing: Full source file tree, header include dependency graphs, and function call/caller graphs.

Building API Documentation Locally#

To build or refresh the Doxygen documentation alongside the Sphinx documentation:

# From the sof-docs repository root
make apidocs   # Generates Doxygen XML and HTML
make html      # Generates Sphinx site and stages Doxygen at _build/html/doxygen/

Alternatively, Doxygen can be built directly inside the SOF firmware repository:

# From the sof firmware repository root
cmake -GNinja -S doc -B build_doxygen
ninja -C build_doxygen doc