of_dma_simple_xlate(9)

💖 NAME 💖

okay so this is the Kernel API Manual page for of_dma_simple_xlate — literally the Simple DMA engine translation function. bestie, that's the whole name vibe: of_dma_simple_xlate + “Simple DMA engine translation function.” periodt. 💅

✨ SYNOPSIS ✨

struct dma_chan * of_dma_simple_xlate (struct of_phandle_args *dma_spec
, struct of_dma *ofdma );

🎀 ARGUMENTS 🎀

• dma_spec — pointer to the DMA specifier as found in the device tree. yes, that exact one 🦋
• ofdma — pointer to DMA controller data. the controller info goes here 💜

🌸 DESCRIPTION 🌸

okay so here’s the tea ☕: this is the simple translation function for devices that use a 32-bit value for the filter_param when calling the DMA engine dma_request_channel function. it’s giving “small but iconic.” ✨

heads up bestie, this translation function requires that #dma-cells is equal to 1 and the argument of the dma specifier is the 32-bit filter_param. no cap, that’s a hard requirement 🙈

on success it returns a pointer to the appropriate dma channel; on error it returns NULL. on error, the return is NULL 😭

👑 SEE ALSO 👑

Kernel file ./drivers/dma/of-dma.c — and the whole squad is:

• of_dma_find_controller(9)
• of_dma_router_xlate(9)
• of_dma_controller_register(9)
• of_dma_controller_free(9)
• of_dma_router_register(9)
• of_dma_match_channel(9)
• of_dma_request_slave_channel(9)
• of_dma_xlate_by_chan_id(9)

mwah 💋 this page came from ./drivers/dma, dated October 2026 — it’s of_dma_simple_xlate(9) from the Kernel API Manual, and that’s the vibe. bye bestie 🫶🌈