of_dma_xlate_by_chan_id(9)

💅 of_dma_xlate_by_chan_id(9) 💅

okay bestie, this is the of_dma_xlate_by_chan_id(9) page from the Kernel API Manual, and it's lowkey iconic. stay with me.

🌸 NAME 🌸

of_dma_xlate_by_chan_id — Translate dt property to DMA channel by channel id. periodt.

🦋 SYNOPSIS 🦋

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

🎀 ARGUMENTS 🎀

• dma_spec — pointer to DMA specifier as found in the device tree. That's the main character input, fr fr.
• ofdma — pointer to DMA controller data. Also essential, no cap.

💅 DESCRIPTION 💅

This function can be used as the of xlate callback for a DMA driver that wants to match the channel based on the channel id. it's giving "match by id" energy.

When using this xlate function, the #dma-cells property of the DMA controller dt node needs to be set to 1. not 2, not vibes — literally 1. 🙈

The data parameter of of_dma_controller_register must be a pointer to the dma_device struct the function should match upon. highkey important, bestie.

Returns pointer to appropriate dma channel on success or NULL on error. slay on success, NULL when it's not giving. 😭

🔥 SEE ALSO 🔥

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

• 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_simple_xlate(9)

made with 💖 from ./drivers/dma, October 2026 — periodt.