3. 内存池初始化与配置：内存池大小计算、对齐要求、DMA缓冲区配置参数

DMA内存池的初始化是嵌入式系统稳定运行的基础。错误的池大小、忽略对齐约束或遗漏DMA缓冲区配置参数，会导致数据损坏、总线错误或性能骤降。本节从三个核心维度展开：内存池大小计算、对齐要求、DMA缓冲区配置参数，并给出可落地的工程配置清单。

3.1 内存池大小计算：从需求到精确分配

内存池大小并非简单累加，必须考虑元数据开销、对齐填充和碎片预留。以下公式适用于静态DMA内存池：

总池大小 = (每个缓冲区大小 + 元数据开销) × 缓冲区数量 + 对齐填充 + 池头部元数据

其中：

• 每个缓冲区大小：由DMA传输最大载荷决定，通常为2的幂次（如512B、1KB、4KB）。
• 元数据开销：每个缓冲区对应的描述符、状态字、回滚指针，典型值为8~16字节。
• 对齐填充：保证每个缓冲区起始地址满足DMA硬件对齐要求（如32字节、64字节、128字节）。
• 池头部元数据：记录池基址、空闲链表头、互斥锁等，通常为32~64字节。

3.1.1 典型场景计算示例

假设一个以太网DMA驱动需要管理64个接收缓冲区，每个缓冲区最大1536字节（含帧头），元数据开销12字节，对齐要求32字节：

每个缓冲区实际占用 = 1536 + 12 = 1548 字节
对齐后占用 = (1548 + 31) & ~31 = 1568 字节
池头部元数据 = 48 字节
总池大小 = 1568 × 64 + 48 = 100,352 + 48 = 100,400 字节

若硬件DMA要求缓冲区起始地址对齐到64字节，则对齐后占用变为：

对齐后占用 = (1548 + 63) & ~63 = 1600 字节
总池大小 = 1600 × 64 + 48 = 102,400 + 48 = 102,448 字节

可见，对齐粒度从32字节提升到64字节，总池大小增加了约2%。

3.2 对齐要求：硬件约束与软件适配

DMA控制器对内存地址有严格的对齐约束，违反对齐会导致：

• 总线错误：ARM Cortex-M系列在非对齐访问时触发HardFault。
• 数据错位：DMA传输的数据被截断或移位，CRC校验失败。
• 性能下降：部分DMA引擎自动回退到字节模式，吞吐量降低50%以上。

下表列出常见DMA控制器的对齐要求：

3.2.1 对齐实现策略

在C语言中，推荐使用编译期对齐属性与运行时对齐宏结合：

/* 编译期对齐：声明缓冲区数组 */
static uint8_t dma_pool[POOL_SIZE] __attribute__((aligned(64)));

/* 运行时对齐宏：计算对齐后的地址 */
#define ALIGN_UP(addr, align)   (((uintptr_t)(addr) + (align) - 1) & ~((align) - 1))
#define ALIGN_DOWN(addr, align) ((uintptr_t)(addr) & ~((align) - 1))

/* 分配对齐缓冲区 */
uint8_t* dma_buf_alloc(DmaPool* pool, size_t size) {
    uint8_t* ptr = pool_free_list_pop(pool);
    if (ptr == NULL) return NULL;
    /* 确保返回地址满足DMA对齐 */
    return (uint8_t*)ALIGN_UP((uintptr_t)ptr, pool->align_bytes);
}

3.3 DMA缓冲区配置参数：关键字段与调试要点

每个DMA缓冲区在内存池中不仅包含数据区域，还关联一组配置参数。这些参数决定了DMA传输的行为、安全边界和调试能力。

3.3.1 核心配置参数清单

3.3.2 配置参数初始化流程

以下代码展示一个DMA缓冲区描述符的完整初始化：

typedef struct {
    uint32_t    buf_addr;       /* 缓冲区物理地址 */
    uint16_t    buf_size;       /* 缓冲区容量 */
    uint16_t    data_len;       /* 实际数据长度 */
    uint8_t     flags;          /* 状态标志 */
    uint8_t     owner;          /* 所有者 */
    uint16_t    reserved;
    uint32_t    next_desc;      /* 链表下一描述符 */
    uint32_t    debug_magic;    /* 调试魔数 */
} DmaBufDesc_t;

void dma_buf_desc_init(DmaBufDesc_t* desc, uint32_t addr, uint16_t size) {
    desc->buf_addr   = addr;
    desc->buf_size   = size;
    desc->data_len   = 0;
    desc->flags      = BUF_FLAG_FREE;
    desc->owner      = OWNER_CPU;
    desc->next_desc  = (uint32_t)NULL;
    desc->debug_magic = 0xDEADBEEF;
}

3.4 内存池初始化与配置流程总览

下图展示了从内存池大小计算到DMA缓冲区配置完成的完整初始化流程：

3.5 常见配置错误与避坑指南

• 大小计算遗漏元数据：只计算了数据区，忽略了每个缓冲区的描述符开销，导致实际可用缓冲区数量少于预期。
• 对齐假设错误：认为CPU缓存行对齐（32字节）即可满足DMA要求，但部分DMA引擎需要64字节或128字节对齐。
• 描述符链表未对齐：描述符数组未使用对齐属性，DMA引擎读取描述符时发生非对齐访问错误。
• 调试魔数未初始化：在释放时检查魔数，但分配时忘记写入，导致误报越界。
• owner字段未正确切换：DMA传输完成后未将owner交还给CPU，导致缓冲区被DMA持续占用，内存池耗尽。

3.6 初始化配置检查清单

以下清单可用于代码审查或自检：