4、STM32音频采集软件：使用CubeMX配置I2S/PDM、DMA传输、环形缓冲区、中断与回调机制，实现连续音频流采集

在STM32上实现关键词识别（KWS）的第一步，是稳定、低延迟、无丢失地获取连续的音频数据流。与单次触发采集不同，连续音频流采集要求软件架构具备“边采边处理”的能力：DMA在后台将麦克风数据搬运至内存，CPU在前台执行MFCC特征提取或神经网络推理。本章将围绕CubeMX的配置流程、DMA与中断的协同机制、环形缓冲区的设计要点以及回调函数的工程实现展开，帮助读者构建一套可复用的音频采集子系统。

4.1 核心原理：从麦克风到内存的数据通路

连续音频采集的本质是“外设数据搬运”与“CPU处理”的流水线并行。STM32的I2S外设负责与数字麦克风进行时钟同步和数据帧接收，PDM接口则用于与PDM输出型麦克风对接。无论使用哪种接口，数据最终都会进入外设的数据寄存器（如I2S_DR），如果由CPU逐字读取，将占用大量中断资源且极易丢失数据。因此，工程上普遍采用DMA（直接内存访问）方式，让外设与内存之间直接传输数据，仅在缓冲区半满或全满时触发中断通知CPU。

以16kHz采样率、16位单声道为例，每秒产生32KB数据。若使用32字节的DMA缓冲区，则每秒产生1000次中断，CPU负担过重；若使用4096字节的缓冲区，则每秒仅约8次中断，但实时性下降。实际设计中，通常将缓冲区划分为两个半区（半传输中断和传输完成中断），形成“双缓冲”机制，使CPU在处理一个半区数据的同时，DMA正在填充另一个半区，从而实现无缝采集。

4.2 操作流程：CubeMX配置与代码生成

使用STM32CubeMX进行图形化配置，可以大幅减少底层寄存器操作的工作量。以下以STM32L4系列搭配I2S数字麦克风（如INMP441）为例，说明完整配置步骤。

1. 时钟树配置：将系统时钟配置为80MHz或更高，确保I2S外设时钟源（PLLI2S）能够精确生成所需的采样频率。在CubeMX的Clock Configuration页面中，设置PLLI2S的倍频系数，使I2S时钟频率满足：采样率 = I2S时钟 / (分频系数 × 32)。
2. I2S外设配置：选择I2S2或I2S3，模式设为Master Receive，标准选择Philips，数据格式16位，帧格式16位，时钟极性低电平。启用DMA接收请求，并添加DMA通道，方向为Peripheral-to-Memory，模式为Circular，数据宽度Half Word（16位）。
3. DMA中断配置：在NVIC设置中，使能DMA中断的全局中断。CubeMX会自动生成HAL_I2S_RxHalfCpltCallback和HAL_I2S_RxCpltCallback两个弱定义回调函数，供用户在应用层重写。
4. PDM配置（如使用PDM麦克风）：选择SAI或DFSDM外设，配置PDM参数（如抽取率、增益），同样启用DMA循环模式。PDM接口内部会完成1-bit PDM流到16-bit PCM数据的转换。
5. 生成代码：在Project Manager中设置工具链（如MDK-ARM或STM32CubeIDE），生成初始化代码。用户需在main.c中调用HAL_I2S_Receive_DMA(&hi2s2, (uint16_t*)audio_buffer, BUFFER_SIZE)启动采集。

4.3 环形缓冲区与双缓冲机制设计

虽然DMA循环模式本身已经实现了硬件层面的环形传输，但CPU侧仍需一个逻辑上的环形缓冲区来管理数据的读写位置。推荐采用“双半区”策略：将DMA缓冲区视为两个连续的半区，当半传输中断触发时，CPU处理前半区；当传输完成中断触发时，CPU处理后半区。这种方式无需复杂的读写指针运算，只需在回调中切换一个标志位即可。

对于更灵活的采集需求（如可变帧长），可以设计软件环形缓冲区。核心结构包含读指针（read_index）、写指针（write_index）和缓冲区大小（buffer_size）。写指针由DMA回调更新，读指针由应用任务更新。当两者相等时表示缓冲区为空；当写指针追上读指针时表示溢出，此时应丢弃最旧的数据或暂停采集。

// 环形缓冲区结构体定义
typedef struct {
    int16_t *buffer;      // 缓冲区基地址
    uint32_t size;        // 缓冲区大小（样本数）
    volatile uint32_t write_index;  // 写指针（由DMA回调更新）
    volatile uint32_t read_index;   // 读指针（由应用任务更新）
} ring_buffer_t;

// DMA半传输完成回调：更新写指针到前半区末尾
void HAL_I2S_RxHalfCpltCallback(I2S_HandleTypeDef *hi2s) {
    if (hi2s->Instance == I2S2) {
        audio_rb.write_index = (audio_rb.write_index + HALF_SIZE) % audio_rb.size;
        process_audio_block(&audio_rb.buffer[0], HALF_SIZE); // 处理前半区
    }
}

// DMA传输完成回调：更新写指针到后半区末尾
void HAL_I2S_RxCpltCallback(I2S_HandleTypeDef *hi2s) {
    if (hi2s->Instance == I2S2) {
        audio_rb.write_index = (audio_rb.write_index + HALF_SIZE) % audio_rb.size;
        process_audio_block(&audio_rb.buffer[HALF_SIZE], HALF_SIZE); // 处理后半区
    }
}

4.4 案例拆解：16kHz/16bit双缓冲采集系统实现

本案例基于STM32L496G-Discovery板卡，使用I2S2接口连接INMP441数字麦克风，实现16kHz采样率、16位单声道的连续音频采集。系统目标是将采集到的音频数据以20ms为帧长（320个样本）送入MFCC特征提取模块。

初始现象与目标：直接使用轮询方式读取I2S数据时，CPU占用率超过60%，且在高负载时出现数据丢失。目标是将CPU占用率降至10%以下，并保证连续采集无丢帧。

关键参数设置：

• 采样率：16000 Hz
• 位深：16位
• DMA缓冲区大小：640字节（320个int16样本），对应20ms音频
• DMA模式：Circular，Half-Word传输
• 系统时钟：80MHz，PLLI2S配置为精确生成1.024MHz I2S时钟

实施步骤：

1. 在CubeMX中完成I2S2、DMA1 Channel4、NVIC配置，生成初始化代码。
2. 定义全局缓冲区int16_t audio_buffer[320]，并声明环形缓冲区结构体。
3. 在main()中调用HAL_I2S_Receive_DMA(&hi2s2, (uint16_t*)audio_buffer, 320)启动采集。
4. 重写两个DMA回调函数，在回调中调用process_audio_block()函数，该函数内部执行MFCC特征提取。
5. 在主循环中，通过信号量或标志位等待音频数据就绪，执行关键词识别推理。

结果对比：采用双缓冲DMA方案后，CPU占用率从62%降至8%，音频数据零丢失。系统能够连续运行24小时以上，无缓冲区溢出或数据错位现象。

风险与代价：双缓冲方案牺牲了约20ms的延迟（一个缓冲区时长），但对于关键词识别这类非实时性要求极高的应用，20ms延迟完全可接受。此外，DMA中断优先级需设置为高于应用任务，但低于系统节拍中断，以避免优先级反转。

4.5 常见误区与总结复盘

误区一：DMA缓冲区越大越好。虽然大缓冲区可以减少中断频率，但会增加数据延迟，且对内存占用较大。对于语音识别，20-30ms的缓冲区是延迟与性能的最佳平衡点。

误区二：在回调中直接处理数据。回调函数运行在中断上下文中，应遵循“快进快出”原则。若在回调中执行MFCC计算，将阻塞其他中断，严重时导致系统崩溃。

误区三：忽略DMA传输的数据宽度。I2S数据寄存器为16位，DMA数据宽度必须设置为Half Word。若误设为Word，将导致数据错位，音频信号完全失真。

误区四：未处理缓冲区溢出。当应用处理速度跟不上DMA填充速度时，新数据会覆盖未处理的数据。应在环形缓冲区中增加溢出检测机制，当写指针追上读指针时，丢弃旧数据或暂停DMA。

总结：连续音频采集是STM32音频应用的基础工程，其核心在于DMA循环模式与双缓冲机制的配合。通过CubeMX的图形化配置，开发者可以快速搭建稳定的采集链路。在实际项目中，应根据具体麦克风类型（I2S或PDM）、采样率要求和处理能力，灵活调整缓冲区大小与中断优先级。掌握本章内容后，读者可以在此基础上进一步集成MFCC特征提取和神经网络推理，构建完整的嵌入式关键词识别系统。