简介STM32录音机工程源码包围绕官方实验45整理面向嵌入式初学者和进阶开发者用于解决单片机音频采集、编码存储与回放控制的完整实现问题。资源共160个文件以68个h头文件和65个c源文件为主体覆盖ADC采样、PCM数据处理、FatFS文件系统移植、LCD界面显示等核心环节另含12张png图片便于查看接线与运行效果4个txt说明辅助环境配置以及Keil工程配置文件与hex烧录文件压缩包整体仅845KB轻量易用、便于快速下载与移植。已有1860人学习下载代码可用性得到实际验证。开发者可借助源码与文档掌握底层ADC参数配置、内存缓冲管理、SD卡读写流程和按键交互逻辑理解从麦克风输入到文件落盘的完整链路工程模块划分清晰、层次分明便于直接烧录验证也可在现有基础上扩展录音时长、音频格式等功能是STM32音频方向值得对照学习的实操范例。1. 为什么STM32录音机程序值得亲自烧一遍从能跑通到能出声音的距离把STM32录音机程序烧到开发板上第一次按下录音键电平指示跳得很欢回放却全是杂音——这类“亲测可用”的项目往往不是不能跑而是工程里藏着几个没写进文档的坑。这份资源解决的是录音机从采集到落盘的全链路问题定时器触发ADC采样、DMA搬运、FatFs写文件、播放回读代码完整可编译按键、LED、SD卡和耳机插座都被用上了。适合刚接触嵌入式音频的开发者也适合需要快速搭一个声音采集Demo的工程师。我把它从编译到录音完整走了一遍以下记录的是实际能复现的路径尤其适合手上正好有一块带SD卡槽的STM32开发板的情况。先说结论这份程序能用的关键是ADC、DMA和文件系统三条线没有互相干扰而三个坑基本都在配置上不在硬件上。2. 硬件基础与工程框架先搞懂声音从哪里来、往哪里去很多同学拿到工程不看原理图直接按默认引脚连接结果烧录后ADC读到的全是电源噪声。声音链路在电路上必须理顺否则后面写多少软件都白费。这一章先把硬件连接和工程目录摊开让你在第一次编译前就知道每根线的作用。2.1 录音链路的核心器件麦克风、运放、ADC与I2S在这个平台上录音流程常见有两种方案。一种是用芯片内部ADC配合定时器触发把麦克风放大后的模拟电压转成数值另一种是用I2S接口外接音频编解码芯片由编解码芯片完成采样量化MCU通过I2S总线读回PCM数据。这份工程采用的是第一种方案原因很实际内部ADC不依赖额外芯片任何带ADC的STM32都能跑只要算准采样时序即可得到一个可玩的录音机。内部ADC的输入范围通常为0到参考电压Vref默认3.3V。驻极体麦克风输出的是交流小信号幅度在几十到几百毫伏之间必须先经运放偏置并放大才能送到ADC引脚。如果直接把话筒线接到PA0你会发现采集到的波形只在几十毫伏间跳录出来的声音非常小。选型时要注意麦克风模块自带增益放大输出直流偏置在VCC/2左右能匹配ADC输入如果是从网上随意找的咪头需要自行添加偏置电路。建议的硬件连接如下功能引脚说明麦克风模块输出PA0ADC1_IN0采样保持电路要稳定录音按键任意GPIO输入按下启动录音再按停止回放按键任意GPIO输入按下播放最近保存的文件SD卡CS若用SPI模式则是CS引脚本文按SDIO模式描述CS不需要电路上建议在麦克风输出端并联一个0.1uF电容滤除射频干扰在PA0到地放一个10uF电容稳定直流偏置。如果板上已经有音频功放输出推动耳机没问题如果没有只靠DAC直推耳机会很吃力这个第3章会讲到。工程里的ADC初始化代码基于HAL库配置如下// adc.c - 基于HAL库的ADCDMA录音配置 ADC_HandleTypeDef hadc1; DMA_HandleTypeDef hdma_adc1; TIM_HandleTypeDef htim3; void MX_ADC1_Init(void) { __HAL_RCC_ADC1_CLK_ENABLE(); hadc1.Instance ADC1; hadc1.Init.ClockPrescaler ADC_CLOCK_SYNC_PCLK_DIV4; hadc1.Init.Resolution ADC_RESOLUTION_12B; hadc1.Init.ScanConvMode DISABLE; hadc1.Init.ContinuousConvMode DISABLE; hadc1.Init.DiscontinuousConvMode DISABLE; hadc1.Init.ExternalTrigConv ADC_EXTERNALTRIGCONV_T3_TRGO; hadc1.Init.ExternalTrigConvEdge ADC_EXTERNALTRIGCONVEDGE_RISING; hadc1.Init.DataAlign ADC_DATAALIGN_RIGHT; hadc1.Init.NbrOfConversion 1; HAL_ADC_Init(hadc1); }这个配置里有几个参数必须强调。ContinuousConvMode必须是DISABLE否则ADC会以最快速度连续采样DMA缓冲区被瞬间填满定时器触发失去意义。ExternalTrigConv选择T3_TRGO即TIM3的更新事件作为触发源。ExternalTrigConvEdge选上升沿。Resolution用12位存储为16位半字既能保证动态范围DMA对齐也方便。DataAlign用右对齐这样读出来的数值范围是0到4095后续做WAV转换时只需左移几位补足16位。对应定时器配置// tim.c - 用TIM3产生约16kHz的采样触发脉冲 void MX_TIM3_Init(void) { TIM_ClockConfigTypeDef sClockSourceCfg {0}; TIM_MasterConfigTypeDef sMasterCfg {0}; htim3.Instance TIM3; htim3.Init.Prescaler 84 - 1; htim3.Init.Period 62; htim3.Init.CounterMode TIM_COUNTERMODE_UP; htim3.Init.AutoReloadPreload TIM_AUTORELOAD_PRELOAD_ENABLE; HAL_TIM_Base_Init(htim3); sMasterCfg.MasterOutputTrigger TIM_TRGO_UPDATE; HAL_TIMEx_MasterConfigSynchronization(htim3, sMasterCfg); }这里的计算是基于系统时钟84MHz分频器设为83也就是84分频计数频率变成1MHz。Period设为62更新事件频率为1MHz/(621)约15.87kHz。这个采样率覆盖语音的频段足够数据率为32kB/s对SD卡压力很小。如果想把采样率提高到20kHz把Period改为49即可但要注意后续的低通滤波也要同步调整。DMA配置// dma.c - 将ADC转换结果自动搬运到内存缓冲区 static void MX_DMA_Init(void) { __HAL_RCC_DMA2_CLK_ENABLE(); hdma_adc1.Instance DMA2_Stream0; hdma_adc1.Init.Channel DMA_CHANNEL_0; hdma_adc1.Init.Direction DMA_PERIPH_TO_MEMORY; hdma_adc1.Init.PeriphInc DMA_PINC_DISABLE; hdma_adc1.Init.MemInc DMA_MINC_ENABLE; hdma_adc1.Init.PeriphDataAlignment DMA_PDATAALIGN_HALFWORD; hdma_adc1.Init.MemDataAlignment DMA_MDATAALIGN_HALFWORD; hdma_adc1.Init.Mode DMA_CIRCULAR; hdma_adc1.Init.Priority DMA_PRIORITY_HIGH; HAL_DMA_Init(hdma_adc1); __HAL_LINKDMA(hadc1, DMA_Handle, hdma_adc1); }DMA方向是外设到内存数据宽度都是半字因为ADC是12位输出存成两个字节。Mode必须是DMA_CIRCULAR这样缓冲区分成两半写满一半触发半传输中断再写另一半触发完成中断。Priority设成高是为了避免在录音同时有别的DMA传输抢走总线。最关键的是最后一行__HAL_LINKDMA它把DMA通道关联到ADC句柄没有这一步启动ADC后数据不会自动搬。提示如果你用的开发板已经通过CubeMX生成工程这些代码往往被分散在adc.c、tim.c、dma.c里不用手动拼。改引脚映射后必须检查DMA Stream是否跟随变化。2.2 工程目录结构与配置文件先别急着编译看懂这三层拿到这份工程后不要直接点Run。先打开顶层的.ioc文件STM32CubeIDE会图形化显示引脚和外设配置。重点关注ADC1、TIM3、SDMMC1三块。如果工程里没有.ioc文件说明作者用的是标准外设库或纯寄存器方式那你需要看Src目录下的main.c和中断服务文件。典型目录结构/your_project /Core /Inc /Src main.c stm32f4xx_it.c recorder.c wav_stream.c /Startup /Drivers /BSP /FatFs /Middlewares /Third_Party /FatFs /SDcardSrc目录是灵魂。main.c只做外设初始化recorder.c实现录音状态机wav_stream.c负责WAV格式和文件流操作。很多工程习惯把所有逻辑堆在main.c里这份工程拆开了好处是录音逻辑你只改recorder.c存储只改wav_stream.c互不干扰。看代码入口建议从recorder.c开始因为录音切换按键在那里定义。在编译前可以用一段串口调试代码打印外设状态确认配置真的生效了// debug_check.c - 串口打印外设时钟状态示意 void Debug_PrintPeripheralState(void) { printf(ADC1 clk: %d\r\n, __HAL_RCC_ADC1_IS_CLK_ENABLED()); printf(DMA2 clk: %d\r\n, __HAL_RCC_DMA2_IS_CLK_ENABLED()); printf(TIM3 clk: %d\r\n, __HAL_RCC_TIM3_IS_CLK_ENABLED()); printf(SDMMC1 clk: %d\r\n, __HAL_RCC_SDMMC1_IS_CLK_ENABLED()); }这段代码不需要初始化任何外设只要调用了HAL库的时钟宏即可。输出全为1说明配置初始化和时钟开没问题如果SDMMC1为0那后续文件系统必然挂不上。把那几行printf放在main函数最后串口输出比用万用表量引脚快得多。确认完状态再编译烧录这样打开程序时第一轮就能跑通。这套准备是最容易被忽略的“地基”。硬件接对工程目录理清后面看录音和播放代码就不容易晕。3. 录音与播放的代码实现从定时器触发到DMA搬运的四个关键点录音和播放是这个工程的核心。所谓“亲测可用”就是这两条链路都能在同一个时钟域里正常切换。这一章把录音状态机、DMA中断、播放路径展开你会看到HAL库封装背后的数据流。3.1 录音主流程ADC校准、DMA启动与定时器触发按下录音键状态机进入RECORDING。第一步是清空环形缓冲区第二步校准ADC第三步启动DMA第四步启动定时器。为什么顺序不能乱因为如果先启动定时器再校准ADC校准过程会占用ADC产生错误转换结果录音开头会有一小段爆音。// recorder.c - 启动录音函数 void Recorder_Start(uint8_t *buffer, uint32_t bufSize) { memset(buffer, 0, bufSize); if (HAL_ADCEx_Calibration_Start(hadc1) ! HAL_OK) { Error_Handler(); } HAL_ADC_Start_DMA(hadc1, (uint32_t *)buffer, bufSize / 2); HAL_TIM_Base_Start(htim3); }buffer大小必须满足半字对齐因为ADC数据为16位。bufSize/2是转换次数也就是DMA要搬运的半字个数。HAL_ADC_Start_DMA内部会先把DMA的状态复位再启动通道。定时器启动之后ADC每逢T3_TRGO上升沿就触发一次转换。转换完成后DMA把结果写入缓冲区写满半段触发中断。这里必须理解DMA_CIRCULAR模式的含义缓冲区不停止地循环写入。如果用户代码没有在中断里及时取走数据新数据会覆盖旧数据录音听起来像卡带。因此DMA半传输和全传输中断是两个最关键的钩子// stm32f4xx_it.c - DMA搬运完毕回调 void HAL_ADC_ConvHalfCpltCallback(ADC_HandleTypeDef *hadc) { Recorder_StoreData(0, AUDIO_BUFFER_SIZE / 2); } void HAL_ADC_ConvCpltCallback(ADC_HandleTypeDef *hadc) { Recorder_StoreData(AUDIO_BUFFER_SIZE / 2, AUDIO_BUFFER_SIZE / 2); }Recorder_StoreData负责把半段数据写入当前WAV文件。它要做两件事先把16位采样值原样搬给FatFs再更新文件内偏移。如果不做任何格式转换这就是最简的PCM转储。但有个隐蔽问题ADC是12位存储在16位变量里实际只用了低12位。在WAV文件里如果直接保存播放时声音音量偏小因为动态范围不足。常见做法是先把数据左移4位把12位映射到16位范围。同时采集到的是单极性0-3.3V带直流偏置播放时会有“嗡嗡”声。所以要在软件上做直流偏移消除// wav_stream.c - 对一段PCM做直流偏移修正 static int32_t dc_offset 0; void Recorder_StoreData(uint32_t offset, uint32_t len) { uint16_t *p (uint16_t *)(audioBuffer offset); for (uint32_t i 0; i len / 2; i) { int32_t v (p[i] 4) - dc_offset; /* 先移回12位再减直流分量 */ if (v 32767) v 32767; if (v -32768) v -32768; p[i] (uint16_t)(v 0xFFFF); } f_write(file, p, len, written); }这里的dc_offset在录音开始时通过前50个采样点的平均值计算得到。代码中p[i]原本是12位ADC值右移4位变成16位但因为ADC值是0-4095减去2048左右相当于去掉直流偏置。此逻辑处理后WAV里的PCM数据是标准的带符号16位整数播放器能直接识别。如果省略这一步录音听起来是“直流偏置声音”响度不一致且低频浑浊。3.2 播放路径与DAC配置不要绕过输出缓冲播放是把WAV文件中的PCM数据反向发到DAC。这个工程使用内部DAC输出引脚为PA4需要外接一个1uF电容隔直后到耳机座。直接接耳机没有声音的问题在避坑章会详述这里只看代码。DAC初始化需要选择触发源以便和录音的定时器体系共用一套时钟// dac.c - 播放用DAC初始化 void MX_DAC_Init(void) { DAC_ChannelConfTypeDef sConfig {0}; hadac.Instance DAC; sConfig.DAC_SampleAndHold DAC_SAMPLEANDHOLD_DISABLE; sConfig.DAC_Trigger DAC_TRIGGER_T6_TRGO; sConfig.DAC_OutputBuffer DAC_OUTPUTBUFFER_ENABLE; sConfig.DAC_ConnectOnChipPeripheral DAC_CHIPCONNECT_DISABLE; HAL_DAC_ConfigChannel(hadac, sConfig, DAC_CHANNEL_1); }DAC_OutputBuffer必须打开否则输出阻抗太高带不动耳机。DAC_Trigger选T6_TRGO即TIM6更新事件触发这样DAC转换频率由TIM6控制和录音的TIM3相互独立。用T6的好处是播放时不需要占用TIM3两者可以同时运行至少可以同时初始化。播放文件的核心循环// player.c - 从SD卡读数据并发送到DAC void Player_PlayFile(FIL *fp) { uint16_t pcmBuf[1024]; /* 2kB缓冲区 */ while (1) { UINT bytesRead; if (f_read(fp, pcmBuf, sizeof(pcmBuf), bytesRead) ! FR_OK) break; if (bytesRead 0) break; HAL_DAC_Start_DMA(hadac, DAC_CHANNEL_1, (uint32_t *)pcmBuf, bytesRead / 2); /* 等待当前DMA播放完成再读下一块 */ while (HAL_DAC_GetState(hadac) ! HAL_DAC_STATE_BUSY) { } } }这个循环用了一个阻塞等待代码简单但效果一般如果f_read从SD卡读取数据耗时超过DAC播放当前块的时间就会卡顿。真正可用的工程通常使用双缓冲一块正在被DAC读取播放另一块同时被f_read填充并在DMA完成中断中交换指针。第6章会讲这个优化。但这里要指出一个常见误区HAL_DAC_Start_DMA启动后DMA会持续搬运pcmBuf的数据到DAC直到count为0。如果pcmBuf是局部变量DMA完成前函数不能返回所以要么把pcmBuf改成static要么阻塞等待否则数据会被栈覆盖。这份工程用的是static缓冲区所以循环安全。另外DAC的DMA请求通道不要和录音的DMA通道冲突。用CubeMX检查DAC1的DMA请求多数开发板允许使用DMA1或DMA2不同Stream。冲突现象是播放启动后录音数据全为0因为两个外设同时争夺同一个Stream。遇到这种问题把录音DMA换到DMA2_Stream1或DMA2_Stream3重新生成代码即可。3.3 用逻辑分析仪验证采样率软件参数很容易自欺欺人这一节补充一个验证方法。很多人改TIM3的Period后想当然认为采样率变了实际却没有。因为DMA在循环模式下只有确认触发事件才能再启动转换。用逻辑分析仪抓PA0前的方波没用建议用串口打印两个相邻采样点的时间戳// debug - 打印两次录音采样的间隔 void Debug_PrintSampleInterval(void) { uint32_t t1 DWT-CYCCNT; HAL_ADC_Start(hadc1); while (HAL_ADC_GetState(hadc1) ! HAL_ADC_STATE_BUSY) {} uint32_t t2 DWT-CYCCNT; printf(interval%lu\r\n, t2 - t1); }DWT_CYCCNT需要使能在调试环境下可以方便地测周期。如果测出的间隔对应84MHz主频远大于设定的16kHz说明ADC不是由定时器触发而是在软件里反复调用HAL_ADC_Start。这是移植工程最常见的“假采样”。4. 存储与文件系统把声音落盘才叫录音机如果没有存储录音机只能是“回声探测仪”。这一章讲SD卡初始化、FatFs挂载、WAV文件头的写入以及为什么这些参数必须这样配。4.1 选择存储介质SDIO模式比SPI模式好在哪STM32连接SD卡有两种常见接口。SPI模式引脚少但单字节协议开销大SDIO模式引脚多但4位并行传输快。16kHz、16bit、单声道的数据率约32kB/sSPI模式勉强够用但它每次操作都要锁存片选频繁写扇区时会浪费CPU时间。工程选用SDIO配合DMA传输让SD卡写入不占用主循环。SDIO初始化配置如下// sdmmc.c - SDIO初始化 void MX_SDMMC1_SD_Init(void) { hsd1.Instance SDMMC1; hsd1.Init.ClockEdge SDMMC_CLOCK_EDGE_RISING; hsd1.Init.ClockBypass SDMMC_CLOCK_BYPASS_DISABLE; hsd1.Init.ClockPowerSave SDMMC_CLOCK_POWER_SAVE_DISABLE; hsd1.Init.BusWide SDMMC_BUS_WIDE_4B; hsd1.Init.HardwareFlowControl SDMMC_HARDWARE_FLOW_CONTROL_DISABLE; hsd1.Init.ClockDiv 2; HAL_SD_Init(hsd1); }ClockDiv影响SD卡时钟频率。开发板主控时钟通常为48MHzClockDiv2得到约12MHz。如果初始化失败很多工程的妥协做法是先把ClockDiv调大到4让时钟降到6MHz等f_mount成功后再把ClockDiv改小重新初始化总线速度。SD卡通电后有一个上电稳定期代码里最好加HAL_Delay(500)否则第一张卡容易挂载失败。FatFs挂载代码// fs.c - 挂载SD卡失败时自动格式化 void FatFs_Mount(void) { FATFS fs; FRESULT res f_mount(fs, , 1); if (res FR_NO_FILESYSTEM) { printf(Formatting...\r\n); res f_mkfs(, FM_FAT | FM_SFD, 0, NULL, 0); if (res FR_OK) { f_mount(NULL, , 1); res f_mount(fs, , 1); } } if (res ! FR_OK) { printf(Mount error: %d\r\n, res); } }f_mount第三个参数传1表示立即挂载。传0表示延迟挂载首次访问时再挂载。立即挂载的好处是启动时就能发现卡异常。这里有个“后悔药”如果卡从未格式化f_mkfs会把它格式化为FatFs默认的FAT分区。调用f_mount(NULL, , 1)的作用是注销旧挂载点再重新挂载避免重复挂载返回FR_MOUNTED。运行到这里如果串口打印“Mount error: 3”说明卡是exFAT或损坏。FAT32通常是这种工程最常见的可用格式。4.2 WAV文件头44字节不能写错WAV文件头包含两个必须正确的区间RIFF头前12字节和fmt块后24字节。一个字节能节都不能错错了播放器会报错。工程里用结构体来拼// wav_stream.c - 写WAV文件头 typedef struct { char chunkID[4]; /* RIFF */ uint32_t chunkSize; char format[4]; /* WAVE */ char subchunk1ID[4]; /* fmt */ uint32_t subchunk1Size; uint16_t audioFormat; uint16_t numChannels; uint32_t sampleRate; uint32_t byteRate; uint16_t blockAlign; uint16_t bitsPerSample; char subchunk2ID[4]; /* data */ uint32_t subchunk2Size; } WAVHeader; void WAV_WriteHeader(uint8_t *buf, uint32_t dataSize) { WAVHeader *w (WAVHeader *)buf; memcpy(w-chunkID, RIFF, 4); w-chunkSize 36 dataSize; memcpy(w-format, WAVE, 4); memcpy(w-subchunk1ID, fmt , 4); w-subchunk1Size 16; w-audioFormat 1; /* PCM */ w-numChannels 1; w-sampleRate 16000; w-byteRate 16000 * 2 * 1; w-blockAlign 2; w-bitsPerSample 16; memcpy(w-subchunk2ID, data, 4); w-subchunk2Size dataSize; }关键参数audioFormat1表示PCM不能是0。numChannels1单声道blockAlign2因为单声道16位。byteRatesampleRate * blockAlign有些人直接写了1600021位对齐正确。subchunk1Size固定为16因为fmt块里不包含扩展信息。chunkSize36dataSize是文件总大小减8字节。计算时dataSize如果是奇数要按偶数处理因为WAV数据区按2字节对齐。录音过程中dataSize未知所以通常先写入44字节固定头停止录音后再f_lseek回文件头回填实际数据大小。// wav_stream.c - 停止录音回填文件头 void WAV_CloseFile(FIL *fp, uint32_t dataSize) { uint8_t headerBuf[44]; WAV_WriteHeader(headerBuf, dataSize); f_lseek(fp, 0); f_write(fp, headerBuf, 44, NULL); f_truncate(fp); f_close(fp); }f_truncate很关键预留的header空间后面可能残留旧数据如果不截断文件末尾会多出无意义的字节播放器仍然能播放但时长信息不对。4.3 参数对比与配置建议参数推荐值影响注意采样率16kHz数据率32kB/s语音够用音乐偏弱位深16bit信噪比更好12bit原始数据需左移4位处理声道数1文件减半双声道需要两路ADC成本翻倍缓冲区4096字节16kHz下128ms过小写入频繁过大会卡内存SD模式SDIO 4位约12MHz时钟低速卡可先降速初始化文件系统FAT32兼容性好exFAT需额外使能如果你想要更长的录音时间可以把采样率降到8kHz数据率变为16kB/s一张2GB的卡可以录34小时。但声音会“闷”。比较现实的选择是保持16kHz把SD卡换成高速卡。卡速在录音中体现为写入速度建议选Class 10或以上的卡。注意FatFs的f_open打开文件后每次f_write的数据量最好对齐到512字节扇区边界。如果一次只写几十字节FatFs内部会反复读写扇区性能骤降。所以recorder.c里把DMA缓冲区凑到4096字节正好是8个扇区这样每个f_write都能整块落盘大大减少文件系统的磨损和浪费。5. 避坑与常见问题五条亲测踩过的错误每条都有解决下面这些坑是我实打实踩过的现象、原因、解决都列全。你在复现这个工程时如果遇到直接对照这里。5.1 有采集数据但播放没声音问题不一定在ADC现象用串口打印ADC值波形正常但按回放键后耳机里几乎没有声音。原因播放路径上有三个常见问题。一是DAC输出没有隔直电容耳机线圈把DAC引脚直流电平拉低二是DAC输出缓冲关闭引脚带不动耳机三是耳机座根本就没接到PA4接错引脚了。解决先用万用表量PA4在播放时的直流电压。正常播放大约在1.65V左右上下波动。如果一直为0V说明DAC没启动。若电压正常但没声音检查PA4到耳机座之间是否串联一个1uF到10uF的电容。没有电容时耳机直流阻抗只有几十欧会把DAC输出电压拉低。加上电容后在耳机端对地再接一个1k电阻做偏置声音立刻清楚。5.2 SD卡挂载失败卡类型、初始化顺序和电平转换现象程序串口打印“Mount error: 3”换了张卡还是一样。原因三个候选卡格式化为exFATFatFs未启用exFAT开发板卡槽电平是5V与MCU引脚不匹配初始化时钟太快卡不认。解决先把卡用上位机格式化为FAT32。如果还是不行把SDIO的ClockDiv从2改成4时钟降到约6MHz初始化成功率会高很多。对于电平问题用示波器看卡槽供电引脚如果VDD是5V需要外接电平转换板否则长期使用还可能烧毁IO。这是硬件玄学但频率高到无法忽视。在f_mount之后调用HAL_SD_GetCardState()并打印返回值能进一步区分物理层和文件系统层的问题。// debug_sd.c - 查看SD卡状态 void Debug_CheckSD(void) { uint32_t state HAL_SD_GetCardState(hsd1); printf(SD State: %lu\r\n, state); }5.3 录音有爆音和杂音参考电压与电容布线现象录音波形像毛刺回放有“滋滋”声。原因ADC参考电源不稳麦克风偏置纹波大或PA0走线经过时钟线附近。另一个原因是12位ADC直接映射到16位负半周的部分丢失听起来发闷。解决在Vref引脚和PA0附近各加0.1uF陶瓷电容电容尽量接近引脚放置。软件上录音开始后先采集前50个点求平均当作直流分量后续采样值减掉这个量再写文件。如果板子空间实在改善不了可以使用多次采样取平均一次采集4次取均值副作用是采样率降到原来的四分之一但杂音明显减少。// recorder.c - 计算录音起始直流偏移 static int16_t ComputeDcOffset(uint16_t *buf, uint32_t len) { uint32_t sum 0; for (uint32_t i 0; i len; i) sum buf[i] 4; return (int16_t)(sum / len) - 2048; }5.4 DMA中断冲突录音、播放频繁使用同一DMA通道现象录音时正常播放时程序进入HardFault或者播放后录音数据全为0。原因ADC和DAC的DMA请求被分配到了同一个DMA Stream。HAL库在同一个Stream上重新初始化时会把它之前已配置好的通道重置导致另一个外设停止。解决打开CubeMX在DMA请求列表里把ADC和DAC分配到不同的Stream。分配好之后重新生成代码检查NVIC是否同时开启两个DMA中断。如果中断优先级相同不会死锁但最好把录音DMA中断优先级设为比播放高一级避免开始录音瞬间卡顿。调试时还可以临时关闭录音中断验证冲突是否解除// 播放前临时关闭录音DMA中断 HAL_NVIC_DisableIRQ(DMA2_Stream0_IRQn); HAL_DAC_Start_DMA(hadac, DAC_CHANNEL_1, (uint32_t *)buf, 1024); HAL_NVIC_EnableIRQ(DMA2_Stream0_IRQn);5.5 文件播放卡顿缓冲区大小和读写速度不匹配现象播放时每隔几百毫秒声音卡一下像打嗝。原因FatFs每次f_read默认按扇区512字节读取如果DAC DMA缓冲区只有128字节一次读取数据太少循环等待DAC播放完造成空拍。频繁调用f_read还会卡在文件系统内部锁。解决把播放DMA缓冲区调到2048字节f_read每次读满缓冲区后一次性启动DMA。如果想进一步提升实施双缓冲一块数据在DAC播放时预读下一块到另一块缓冲区。由于FatFs本身有扇区对齐限制缓冲区大小尽量取512的倍数2048、4096都可。// player.c - 双缓冲播放示意 uint16_t pcmBuf[2][1024]; UINT read[2]; for (int i 0; i 2; i) { f_read(fp, pcmBuf[i], sizeof(pcmBuf[i]), read[i]); } HAL_DAC_Start_DMA(hadac, DAC_CHANNEL_1, (uint32_t *)pcmBuf[0], 1024);播放卡顿的问题在这份工程里改到这里就基本解决了。6. 进阶验证音质与优化的四个方向走到这一步录音机已经能跑能存但距离“能用”还有一段距离。最后分享我在调试完这个工程后做的四件事每件都能明显提升听感。第一验证音质不能只靠耳朵。把录音文件从SD卡拷贝到电脑用Python读取WAV并计算频谱import wave import numpy as np f wave.open(rec.wav, rb) data np.frombuffer(f.readframes(-1), dtypenp.int16) fft np.fft.rfft(data) print(最高频点:, np.argmax(np.abs(fft[1:])), Hz)不用复杂工具只看高频噪声是否集中在8kHz以上。如果是在recorder.c里加一个简单的滑动平均滤波依次累加当前值和前三个值输出均值。这个滤波会降低高频噪声但对语音没有明显损失。第二AGC自动增益控制。麦克风模块输出增益固定说话声音靠近时削波离远时太小。我当时的处理是每128个采样判断一次当前峰值如果超过3000把ADC结果右移一位如果低于1000左移一位。这个逻辑写在一个几十行的函数里放在DMA中断回调中注意不要阻塞太久。第三循环录音覆盖。给SD卡留出固定容量比如1GB录到1GB后从文件头重新写。做法是录音前用f_stat查询文件大小超过上限时先f_delete再重新创建。这个功能在演示时很实用不会因为换卡打断流程。第四从工程角度录音开始前强制写一个“占位头”停止后再回填大小而不是录音中频繁f_lseek。这个技巧已经写在这一章的代码里很多“能用”的工程靠它避免文件损坏。我后来再拿到任何“亲测可用”的STM32录音工程都会强制先走一遍硬件连接、再查DMA Stream、最后用频谱看噪音。这个习惯帮我避开了一大半隐藏问题。希望这四招也能帮到你。本文还有配套的精品资源点击获取
