企业官网建设流程全解析

ESP-IDF 多麦克风采集实战：4 个 GPIO 同步采 4 路麦克风（I2S TDM + ES7210）

【免费下载链接】esp-idfEspressif IoT Development Framework. Official development framework for Espressif SoCs.项目地址: https://gitcode.com/GitHub_Trending/es/esp-idf

在 ESP32 上跑多麦克风阵列，最先撞上的是引脚账：4 颗麦克风各要一路数据线，I2S 信号本身又占 4 个口，GPIO 很快就不够分了。ESP-IDF 的 I2S TDM 模式（时分复用——同一条数据线上按时间片轮流传各通道）就是来解决这件事的：4 个 GPIO 拉出 MCLK、BCLK、WS、DIN 四根线，ES7210 把 4 颗 MIC 的采样数据塞进不同的时间片，ESP32 侧按 slot 顺序拆包，硬件天然对齐，通道间误差远小于软件轮询方案。

30 秒搞懂 TDM

标准 I2S 一帧只有左、右两个 slot，想加通道就得加数据线；TDM 则是在一帧里把 slot 数量从 2 扩到 4、8、16，每个 slot 固定代表一路麦克风，所有通道共享同一条 DIN。打个比方：一条单行道，4 辆车按固定车道顺序依次通过，ESP32 侧的 I2S 外设按位时钟节拍把每片数据收进对应 slot 的缓冲，你读出来的就是一帧里整齐排好的 4 通道样本——这就是 ESP32 四麦同步的底层机制，不靠软件打时间戳，同步由时钟保证。

动手前——物料 & 接线

GPIO 分配按 Kconfig.projbuild 里 ESP32 芯片的默认值，S3 / P4 等其他芯片menuconfig时会自动换映射，以你板子的原理图为准：

接线记住一句话：I2S 四线接 ES7210 的 MCLK/SCLK/LRCK/TDMOUT，I2C 两根接它的寄存器口，SD 卡走 SPI，另外 ES7210 需要 3.3V 供电和 MIC 偏置。所有引脚都可在idf.py menuconfig的 Example Configuration → Example IO Configuration 里改，代码不用动。

五步跑通

第 1 步：环境与工程准备

git clone https://gitcode.com/GitHub_Trending/es/esp-idf cd esp-idf && ./install.sh && . ./export.sh cd examples/peripherals/i2s/i2s_codec/i2s_es7210_tdm idf.py set-target esp32s3 # 按你的芯片选，示例已内置 esp_codec_dev 依赖

✅ 你看到 set-target 正常编译通过，说明 esp_codec_dev 组件已自动拉取完成。

第 2 步：I2S TDM 模式配置

核心就在一个结构体，见 i2s_es7210_record_example.c：

i2s_tdm_config_t i2s_tdm_rx_conf = { .slot_cfg = I2S_TDM_PHILIPS_SLOT_DEFAULT_CONFIG( EXAMPLE_I2S_SAMPLE_BITS, // 16bit 位宽 I2S_SLOT_MODE_STEREO, EXAMPLE_I2S_TDM_SLOT_MASK), // slot0~3，即 4 通道 .clk_cfg = { .clk_src = I2S_CLK_SRC_DEFAULT, .sample_rate_hz = EXAMPLE_I2S_SAMPLE_RATE, // 48kHz .mclk_multiple = EXAMPLE_I2S_MCLK_MULTIPLE // 256 倍频 }, .gpio_cfg = { .mclk = 0, .bclk = 1, .ws = 10, .dout = -1, .din = 8 }, }; ESP_ERROR_CHECK(i2s_channel_init_tdm_mode(i2s_rx_chan, &i2s_tdm_rx_conf));

格式选 Philips 是因为 ES7210 驱动默认 I2S 格式；dout = -1表示纯接收。

✅ 你看到 "Configure I2S receive channel to TDM mode" 日志，说明 TDM 通道已按 4 slot 配置成功。

第 3 步：ES7210 初始化

codec 走 I2C 控制 + I2S 传数据两条接口，通道选择、时钟来源、增益三处是关键：

es7210_codec_cfg_t es7210_cfg = { .ctrl_if = ctrl_if, .master_mode = false, // ES7210 作从机 .mic_selected = ES7210_SEL_MIC1 | ES7210_SEL_MIC2 | ES7210_SEL_MIC3 | ES7210_SEL_MIC4, // 4 麦全开 .mclk_src = ES7210_MCLK_FROM_PAD, // 用 ESP32 送来的 MCLK .mclk_div = EXAMPLE_I2S_MCLK_MULTIPLE, }; const audio_codec_if_t *es7210_if = es7210_codec_new(&es7210_cfg); esp_codec_dev_set_in_gain(codec_handle, 30); // 输入增益 30dB

打开设备时.channel = 4要和 I2S 侧的 slot 数一致，这是最常见的对不上的地方。

✅ 你看到 "tdm mode enabled, sample rate: 48000Hz"，说明 ES7210 寄存器配置已生效。

第 4 步：采集与落盘

数据流向一句话讲清：i2s_channel_read把 4 通道交织的原始样本读进 16bit 缓冲 → 按采样率 × 4 通道 × 2 字节算出字节率，先写 WAV 头 → 循环读写直到录满 10 秒 → 关文件卸 SD 卡。示例里 WAV 头用 format_wav.h 的宏一次性生成，循环体不到 10 行，不用背。

✅ 你看到每秒一行 "Recording: n/10s"，说明 I2S 读与 SD 卡写在稳定交替推进。

第 5 步：烧录验证

idf.py -p /dev/ttyUSB0 flash monitor

串口关键日志（摘自示例 README）：

I example: Create I2S receive channel I example: Configure I2S receive channel to TDM mode I ES7210: format: standard i2s, bit width: 16, tdm mode enabled I ES7210: sample rate: 48000Hz, mclk frequency: 12288000Hz I example: Card size: 14772MB, speed: 20MHz I example: You can now safely remove the card

✅ 你看到 "Recording: 10/10s" 后提示安全拔卡，说明整个链路已跑通；把卡插电脑，Audacity 打开 RECORD.WAV 应能看到 4 条声道。

踩坑速查表

还能怎么玩

1. 扩到 16 通道：ES7210 的 TDMIN/TDMOUT 可以级联 4 片，一条 I2S 总线吃下 16 麦同步阵列，帧内拼接规则见示例 README 的 Application Notes。
2. 上算法：4 路样本天然时间对齐，正是做波束成形、AEC 回声消除的前提，TDM 同步省掉了你最怕的通道间对齐环节。
3. 换传输：SD 卡换成 Wi-Fi 回传，录一段推一段，把板子变成在线麦克风阵列节点，协议部分可参考 examples/protocols 下的网络示例。

资源索引

• 示例入口与级联说明：examples/peripherals/i2s/i2s_codec/i2s_es7210_tdm/
• TDM 驱动接口：components/esp_driver_i2s/include/driver/i2s_tdm.h
• I2S 外设 API 参考（含 TDM 模式章节）：docs/en/api-reference/peripherals/i2s.rst

有问题去项目 issue 区提问吧，欢迎后续交流。

【免费下载链接】esp-idfEspressif IoT Development Framework. Official development framework for Espressif SoCs.项目地址: https://gitcode.com/GitHub_Trending/es/esp-idf