unmap_single

unmap_single是Linux内核中的一个函数，用于解除单个已映射的DMA内存区域。DMA（Direct Memory Access）是一种数据传输方式，允许外设直接访问系统内存而不需要CPU的干预。

unmap_single函数的原型如下：

void unmap_single(struct device *dev, dma_addr_t dma_addr, size_t size, enum dma_data_direction dir);

参数说明：
- dev：指向设备结构体的指针，表示进行DMA操作的设备。
- dma_addr：表示已映射的DMA内存区域的起始物理地址。
- size：表示已映射的DMA内存区域的大小。
- dir：表示数据传输的方向，可以是DMA_TO_DEVICE（从内存到设备）或DMA_FROM_DEVICE（从设备到内存）。

unmap_single函数的作用是解除之前使用map_single函数映射的DMA内存区域，释放对该内存区域的占用。这样可以确保DMA操作完成后，该内存区域可以被其他设备或者应用程序使用。

相关问题

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 函数来解除映射，以便内存区域可以被正常释放。

DMA_Mode_Single

DMA_Mode_Single，即单次 DMA 映射，通常用于当 DMA 发生器（DMA Engine）能够处理连续的数据块时。在这种情况下，驱动程序不需要预先创建一个聚合描述符列表（scatter gather list），而是可以直接使用`dma_map_single()`函数来映射一块内存到 DMA 设备。

`dma_map_single()`的工作原理如下[^1]:

dma_addr_t dma_map_single(struct device *dev, void *cpu_addr, size_t len,
                         enum dma_data_direction direction);

参数说明：
- `dev`: 目标设备结构体。
- `cpu_addr`: CPU 内存地址。
- `len`: 需要传输的数据长度。
- `direction`: 数据传输方向，可能是`DMA_TO_DEVICE`（从CPU到设备）、`DMA_FROM_DEVICE`（从设备到CPU）或其他方向。

使用该函数后，会返回一个设备地址，可以由 DMA 控制器访问。完成传输后，应通过`dma_unmap_single()`来解除映射，释放内存资源：

void dma_unmap_single(struct device *dev, dma_addr_t dev_addr, size_t len,
                      enum dma_data_direction direction);