dma_map_single

dma_map_single 函数是Linux内核中用于将单个内存页映射到设备可访问的DMA区域的函数。它的声明如下：

dma_addr_t dma_map_single(struct device *dev, void *ptr, size_t size, enum dma_data_direction dir);

参数说明：

- dev：指向设备结构体的指针。
- ptr：指向要映射的内存区域的指针。
- size：要映射的内存区域的大小。
- dir：数据传输方向，可以是 DMA_TO_DEVICE（从内存到设备）或 DMA_FROM_DEVICE（从设备到内存）。

返回值是一个 dma_addr_t 类型的值，它代表映射后的 DMA 物理地址。这个地址可以被设备用来访问内存。

需要注意的是，dma_map_single 函数只能映射一页内存（一页大小通常是 4KB），如果要映射多页内存，需要调用 dma_map_page 函数。此外，还应该调用 dma_unmap_single 函数和 dma_unmap_page 函数来解除映射，以便内存区域可以被正常释放。