MacOS自定义USB麦克风音频驱动无法处理硬件音频流求助

问题背景 #

基于Apple SimpleAudioDriver示例开发USB麦克风自定义驱动，目标是实现EQ等音频处理（类似Windows APO）。驱动已成功替换系统原有驱动，但存在核心问题：

• 从ivars->m_input_memory_map获取的输入缓冲区未填充麦克风音频数据
• 输出缓冲区填充正弦波数据后，设备无音频输出

官方文档仅提及：

AudioDriverKit将这些流的内存映射到Core Audio HAL。在实际硬件驱动中，此内存需与系统用于硬件DMA的I/O内存一致。

缺少具体实现细节，需明确如何访问并绑定系统DMA的I/O内存以实现硬件流传输。

具体解决方案 #

1. 关联USB端点与DMA内存 #

USB音频设备的数据流依赖端点传输，驱动需将内存映射与对应端点的DMA命令绑定：

• 在设备初始化或流启动阶段，通过IOUSBHostInterface定位输入/输出端点
• 使用IOUSBHostPipe创建DMA命令，将驱动的内存映射（m_input_memory_map/m_output_memory_map）关联到DMA传输

代码示例：

// 假设已获取USB接口实例ivars->m_usb_interface
// 定位输入端点（替换为实际的端点地址，如0x81）
auto inputPipe = ivars->m_usb_interface->FindPipe(0x81);
if (inputPipe) {
    IOUSBDMACommand* inputDmaCmd = inputPipe->CreateDMACommand();
    if (inputDmaCmd) {
        // 将输入内存映射的描述符绑定到DMA命令
        inputDmaCmd->SetMemoryDescriptor(ivars->m_input_memory_map->GetMemoryDescriptor());
        inputDmaCmd->SetDirection(kIOUSBDMACommandDirectionIn);
        // 提交DMA命令启动输入传输
        inputDmaCmd->Submit(nullptr);
        ivars->m_input_dma_cmd = inputDmaCmd;
    }
}

// 定位输出端点（替换为实际的端点地址，如0x01）
auto outputPipe = ivars->m_usb_interface->FindPipe(0x01);
if (outputPipe) {
    IOUSBDMACommand* outputDmaCmd = outputPipe->CreateDMACommand();
    if (outputDmaCmd) {
        outputDmaCmd->SetMemoryDescriptor(ivars->m_output_memory_map->GetMemoryDescriptor());
        outputDmaCmd->SetDirection(kIOUSBDMACommandDirectionOut);
        outputDmaCmd->Submit(nullptr);
        ivars->m_output_dma_cmd = outputDmaCmd;
    }
}

2. 基于DMA完成事件处理音频流 #

SimpleAudioDriver的正弦波生成是模拟逻辑，实际驱动需依赖DMA传输完成事件来处理数据：

• 重写IOAudioStream的PerformIO方法，在DMA传输完成后读取输入数据、处理后写入输出缓冲区
• 为DMA命令设置完成回调，触发后续的音频处理与下一轮传输

代码示例：

IOReturn SimpleAudioStream::PerformIO() {
    // 处理输入数据
    if (ivars->m_input_dma_cmd && ivars->m_input_dma_cmd->IsCompleted()) {
        auto inputBuffer = reinterpret_cast<int16_t*>(ivars->m_input_memory_map->GetAddress() + ivars->m_input_memory_map->GetOffset());
        // 执行EQ等自定义音频处理
        ApplyEQ(inputBuffer, ivars->m_frame_count);
        
        // 重置并提交下一次输入DMA传输
        ivars->m_input_dma_cmd->Reuse();
        ivars->m_input_dma_cmd->Submit(nullptr);
    }

    // 处理输出数据
    if (ivars->m_output_dma_cmd && ivars->m_output_dma_cmd->IsCompleted()) {
        auto outputBuffer = reinterpret_cast<int16_t*>(ivars->m_output_memory_map->GetAddress() + ivars->m_output_memory_map->GetOffset());
        // 将处理后的输入数据（或其他音频数据）写入输出缓冲区
        CopyProcessedAudioToOutput(inputBuffer, outputBuffer, ivars->m_frame_count);
        
        ivars->m_output_dma_cmd->Reuse();
        ivars->m_output_dma_cmd->Submit(nullptr);
    }

    return kIOReturnSuccess;
}

3. 确保内存映射的有效性 #

• 创建内存映射时，明确设置读写权限：输入映射设为只读，输出映射设为可写
• 在调用IOAudioStream::Start前完成DMA绑定，避免流启动时内存未就绪

4. 调试验证 #

• 使用IORegistryExplorer查看驱动节点下的内存映射与USB端点关联状态
• 在DMA完成回调中添加日志，确认传输状态与缓冲区数据是否有效

内容的提问来源于stack exchange，提问作者kinaar