📚 课程目录第3章 QNX DMA子系统架构

3. QNX DMA 子系统架构：io-pkt 与 DMA 引擎、资源管理器、DMA API 分层

在 QNX BSP 移植中，DMA 子系统是连接网络协议栈与硬件 DMA 引擎的关键桥梁。理解其分层架构对于定位 DMA 映射失败、描述符环配置错误以及中断路由异常至关重要。本章节深入剖析 QNX DMA 子系统的核心组件：io-pkt、DMA 引擎、资源管理器以及 DMA API 分层（libdma、devd-*）。

核心要点： QNX 的 DMA 架构采用“资源管理器 + 共享库”模式，将硬件特定的 DMA 操作封装在 devd-* 驱动中，而上层 io-pkt 和应用程序通过统一的 libdma API 访问，实现了硬件无关性。

3.1 整体架构分层

QNX DMA 子系统从上到下分为四层，每一层职责明确，层间通过标准接口通信。下图展示了各层之间的依赖与数据流关系。

3.2 io-pkt 与 DMA 引擎的交互

io-pkt 是 QNX 的网络协议栈进程，负责处理网络数据包的收发。当网卡驱动需要发送或接收数据时，io-pkt 通过 libdma 接口向 DMA 引擎提交传输请求。交互流程如下：

描述符环初始化： io-pkt 在启动时调用 dma_channel_alloc() 分配 DMA 通道，并创建发送/接收描述符环。
数据提交： 上层协议栈将待发送数据缓冲区地址传递给 libdma，libdma 将其映射为物理地址并填入描述符。
硬件触发： libdma 通过资源管理器写入 DMA 通道的“启动”寄存器，硬件开始搬运数据。
完成通知： DMA 传输完成后，硬件触发中断，资源管理器中的中断服务例程（ISR）更新描述符状态，并通过 pulse 或 signal 通知 io-pkt。

移植注意： 在 BSP 移植中，io-pkt 与 DMA 引擎的交互失败通常表现为“描述符环地址错误”或“中断未正确路由到 io-pkt 的等待通道”。务必检查 dma_mem_alloc() 返回的物理地址是否在 DMA 引擎的可寻址范围内。

3.3 资源管理器（devd-*）的角色

资源管理器是 QNX DMA 子系统的核心，它作为一个特权进程运行，直接操作硬件寄存器。每个 SoC 平台都有对应的 devd-* 驱动，例如：

资源管理器	目标平台	关键特性
devd-rcar	Renesas R-Car	支持 8 通道，硬件描述符回写
devd-imx	NXP i.MX	支持 SDMA 与 EDMA 引擎
devd-ti	TI Sitara / Keystone	支持 3PCC 与 PKTDMA
devd-intel	Intel / x86	基于 IOMMU 的 DMA 重映射

资源管理器对外暴露的路径通常为 /dev/dma/chan0、/dev/dma/chan1 等。libdma 通过 open()、devctl()、mmap() 等标准 POSIX 接口与资源管理器通信。

/* 典型资源管理器路径操作示例 */
int fd = open("/dev/dma/chan0", O_RDWR);
if (fd == -1) {
    perror("Failed to open DMA channel");
    return -1;
}

/* 分配 DMA 内存 */
dma_mem_alloc_t alloc;
alloc.size = 2048;
alloc.phys_addr = 0;  /* 输出参数 */
if (devctl(fd, DMD_DMA_MEM_ALLOC, &alloc, sizeof(alloc), NULL) != EOK) {
    perror("DMA mem alloc failed");
    close(fd);
    return -1;
}

/* 启动 DMA 传输 */
dma_start_t start;
start.src_phys = alloc.phys_addr;
start.dst_phys = dst_phys;
start.length = 2048;
devctl(fd, DMD_DMA_START, &start, sizeof(start), NULL);

3.4 DMA API 分层详解

QNX 的 DMA API 分为三层，每一层提供不同粒度的控制能力：

libdma (用户态共享库)： 提供最高层抽象，如 dma_channel_alloc()、dma_mem_alloc()、dma_start()、dma_wait()。适用于 io-pkt 和普通用户态驱动。
devd-* 内部 API： 资源管理器内部使用的硬件抽象层（HAL），直接操作寄存器。包含 dma_hw_init()、dma_hw_start()、dma_hw_isr() 等函数。
内核态 DMA 接口： 用于内核态驱动（如 devd-* 本身），通过 DMA_* 宏或 kernel_callout 访问。

3.5 关键数据结构与故障点

在 BSP 移植中，以下数据结构是 DMA 映射与中断路由故障的高发区域：

数据结构	所属层	常见故障
`dma_channel_t`	libdma	通道号超出硬件支持范围；中断向量号绑定错误
`dma_mem_handle_t`	libdma	物理地址未对齐（如 32 字节对齐要求）；内存区域被 cache 污染
`dma_desc_t`	devd-* / 硬件	描述符链断裂；next 指针指向无效地址；控制标志位设置错误
`dma_isr_entry_t`	devd-*	中断号冲突；ISR 未正确注册到 io-pkt 的 event 通道

故障定位提示： 当遇到 DMA 传输超时或数据损坏时，优先检查 dma_mem_alloc() 返回的物理地址是否在 DMA 引擎的地址窗口内（例如某些 SoC 的 DMA 只能访问 0x40000000-0x7FFFFFFF 范围）。其次检查描述符环的 next 指针是否形成闭环。

3.6 中断路由与 DMA 完成通知

DMA 传输完成后，硬件触发中断，中断路由路径如下：

DMA 控制器产生中断信号（如 IRQ 线）。
中断控制器（GIC / INTC）将中断分发给 CPU。
QNX 内核调用注册在 InterruptAttach() 上的 ISR（位于 devd-* 中）。
devd-* 的 ISR 读取 DMA 状态寄存器，确认传输完成，然后通过 MsgSendPulse() 或 SIGEV_PULSE 通知等待的 io-pkt 线程。

/* devd-* 中典型的中断注册与通知代码片段 */
#include <sys/neutrino.h>

const struct sigevent *dma_isr_handler(void *area, int id) {
    dma_channel_t *ch = (dma_channel_t *)area;

    /* 读取硬件状态寄存器，确认中断源 */
    uint32_t status = in32(ch->reg_base + DMA_STATUS);
    if (status & (1 << ch->index)) {
        /* 清除中断标志 */
        out32(ch->reg_base + DMA_STATUS_CLEAR, (1 << ch->index));

        /* 发送脉冲通知等待线程 */
        MsgSendPulse(ch->coid, SIGEV_PULSE_PRIO, DMA_DONE_PULSE, ch->index);
    }

    return NULL;  /* 使用 pulse 通知，不返回 sigevent */
}

/* 在初始化时注册 ISR */
int dma_attach_isr(dma_channel_t *ch) {
    ch->coid = ConnectAttach(0, 0, ch->chid, _NTO_SIDE_CHANNEL, 0);
    InterruptAttach(ch->irq, dma_isr_handler, ch, sizeof(ch), 0);
    return EOK;
}

中断路由故障排查： 如果 io-pkt 收不到 DMA 完成通知，请检查：1) InterruptAttach() 的 irq 号是否与硬件手册一致；2) devd-* 的 chid 与 io-pkt 的 coid 是否通过 ConnectAttach() 正确连接；3) 中断控制器是否配置为 level-triggered 而非 edge-triggered（某些 DMA 控制器只支持电平触发）。

3.7 本章小结

QNX DMA 子系统的分层设计实现了硬件无关性与可移植性。io-pkt 通过 libdma 发起传输，libdma 通过资源管理器 devd-* 操作硬件。在 BSP 移植中，需要重点关注：

资源管理器 devd-* 的硬件初始化序列（时钟使能、复位释放）。
描述符环的物理地址对齐与连续性。
中断路由路径的正确性（IRQ 号、中断类型、脉冲连接）。
libdma 与 devd-* 之间的 devctl 命令码匹配（如 DMD_DMA_MEM_ALLOC 必须在两端定义一致）。