dspxfr_one_seg(9)

📦 version 7.3.1, in nixpkgs unstable

💅 dspxfr_one_seg

okay so bestie, welcome to the Kernel API Manual — this one lives in dspxfr_one_seg(9) and it's literally the girlie that writes a whole block of data into DSP code or data RAM, and she does it using a pre-allocated DMA engine. no cap, that's the whole vibe. 🎀

✨ SYNOPSIS ✨

int dspxfr_one_seg (struct hda_codec *codec , const struct dsp_image_seg
*fls , unsigned int reloc , struct dma_engine *dma_engine , unsigned int
dma_chan , unsigned int port_map_mask , bool ovly );

🫶 ARGUMENTS 🫶

like, here's who's who at the function call, no gatekeeping:

  • codec — the HDA codec. that's her. the main character. 👑
  • fls — pointer to a fast load image. yes it's literally called fls, we don't make the rules. 🌸
  • reloc — the relocation address, and it's only for loading single-segment overlays. if you're not doing relocation, just pass 0 and move on. simple as. ✨
  • dma_engine — pointer to the DMA engine that's gonna be used for the DSP download. she's already allocated, we're just borrowing her. 💅
  • dma_chan — the number of DMA channels used for DSP download.
  • port_map_mask — port mapping. that's it, that's the whole description, periodt. 🦋
  • ovly — TRUE if overlay format is required. it's a bool, so be honest with it. 🙈

💖 DESCRIPTION 💖

okay so the whole entire job here is: write a block of data into DSP code or data RAM using a pre-allocated DMA engine. iconic behaviour honestly.

and what does she give you back? zero or a negative error code. that's it. that's the return. zero means slay, negative means 😭.

🌈 SEE ALSO 🌈

go read these next, iykyk, they're all in the kernel file ./sound/hda/codecs/ca0132.c:

fr fr bestie, that's the whole page. no filler, no fluff, just DMA and vibes. 🧚

okay bye ily!! this one shipped from ./sound/hda/codecs back in October 2026 and it's still out here doing the most. 🍓 💜

📦 where this page comes from