Arduino如何将模拟信号存储为WAV文件数据块实现SD卡录音

三个核心问题的明确答案 #

• analogRead()本身就是完整的单次ADC采样流程：在通用AVR架构Arduino（Uno/Nano等）上执行该函数时，会等待ADC转换完成再返回0~1023范围的10位无符号采样值，不存在“采样未完成”的问题。注意该函数默认采样率约9.6kHz，且受代码执行延迟干扰，采样间隔不稳定时会导致播放器计算时长出现偏差。
• 原始ADC读取值绝对不能直接写入WAV数据块：通用16位PCM格式WAV要求数据块存储小端序排列的16位有符号整数，直接写入0~1023的原始值、或字节序错误，都会导致播放器无法解析有效音频。
• 零中心化、数值映射是必须操作：麦克风模块输出带1/2供电电压的直流偏置，静态输出电压对应ADC值约512，正确的映射逻辑为int16_t pcmSample = (rawAdcValue - 512) * 64：减512即为零中心化操作，乘64是将10位采样的动态范围拉伸到16位有符号整数要求的-32768~32767区间，无需额外做复杂信号处理。

「文件可打开、有字节写入但时长为0、无声音」的根因 #

这类问题90%以上与音频采样值无关，问题出在WAV文件头填写逻辑和数据写入字节序上：

• 首先检查WAV头长度字段是否回填：WAV头的ChunkSize（文件总长度减8）、Subchunk2Size（音频数据总字节数）两个字段是播放器计算时长的核心依据。多数WAV创建模板会在新建文件时给这两个字段填0，等录音结束后再跳转到对应位置回填实际长度，如果录音结束后没有执行seek操作回填数值，播放器读到长度标记为0，自然显示时长为0，哪怕后续有实际数据写入。
• 检查采样值写入的字节序：Arduino为8位架构，写入16位采样值时必须按小端序先写低8位、再写高8位，如果直接将16位变量整块写入，会出现字节序颠倒，播放器解析出的幅值全为无效值，就会出现无声音的问题。
• 检查静音测试的写入逻辑：你传入0调用写入函数时，如果函数内部没有把0拆为两个0x00字节按顺序写入，或者写入时没有累计数据字节计数，哪怕写了全0的静音数据，文件头的长度字段依然为0，无法生成有效时长的静音文件。

可直接复用的正确写入逻辑参考 #

// 全局变量记录已写入的音频数据总字节数
uint32_t dataByteCount = 0;
File wavFile;

// 单声道16位PCM采样点写入函数
void writePcmSample(int16_t sample) {
  // 小端序拆分写入两个字节
  wavFile.write((uint8_t)(sample & 0xFF));
  wavFile.write((uint8_t)((sample >> 8) & 0xFF));
  dataByteCount += 2; // 每个16位采样占2字节
}

// 录音结束后必须调用，回填WAV头长度字段
void closeWavFile() {
  // 回填ChunkSize字段（文件偏移位置4）
  wavFile.seek(4);
  uint32_t chunkSize = 36 + dataByteCount;
  wavFile.write((uint8_t)(chunkSize & 0xFF));
  wavFile.write((uint8_t)((chunkSize >> 8) & 0xFF));
  wavFile.write((uint8_t)((chunkSize >> 16) & 0xFF));
  wavFile.write((uint8_t)((chunkSize >> 24) & 0xFF));

  // 回填Subchunk2Size字段（文件偏移位置40）
  wavFile.seek(40);
  wavFile.write((uint8_t)(dataByteCount & 0xFF));
  wavFile.write((uint8_t)((dataByteCount >> 8) & 0xFF));
  wavFile.write((uint8_t)((dataByteCount >> 16) & 0xFF));
  wavFile.write((uint8_t)((dataByteCount >> 24) & 0xFF));

  wavFile.close();
}

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