Mirrors/esp-idf
1
0
Fork 0
mirror of https://github.com/espressif/esp-idf.git synced 2026-09-22 13:01:16 +03:00
Code Issues Packages Projects Releases Wiki Activity

Merge branch 'feat/mic_recorder' into 'master'

Browse Source 
feat(i2s): extend the mic recorder example to support both DMIC and AMIC

See merge request espressif/esp-idf!51415
This commit is contained in:
morris
2026-08-12 15:47:23 +08:00
parent b418d72bb0 66c2ce88b3
commit fee5db7d25
24 changed files with 630 additions and 404 deletions
Download Patch File Download Diff File Expand all files Collapse all files

3
docs/en/api-reference/peripherals/i2s.rst
View File

@@ -445,6 +445,7 @@ Standard TX/RX Usage
- :example:`peripherals/i2s/i2s_codec/i2s_es8311` demonstrates how to use the I2S ES8311 audio codec with {IDF_TARGET_NAME} to play music or echo sounds, featuring high performance and low power multi-bit delta-sigma audio ADC and DAC, with options to customize music and adjust mic gain and volume.
- :example:`peripherals/i2s/i2s_basic/i2s_std` demonstrates how to use the I2S standard mode in either simplex or full-duplex mode on {IDF_TARGET_NAME}.
- :example:`peripherals/i2s/mic_recorder` demonstrates how to record audio from an analog microphone connected to an ES8389 codec through the I2S STD interface.
Different slot communication formats can be generated by the following helper macros for standard mode. As described above, there are three formats in standard mode, and their helper macros are:
@@ -804,7 +805,7 @@ Here is the table of the data received in the buffer with different :cpp:member:
PDM RX Usage
^^^^^^^^^^^^
- :example:`peripherals/i2s/i2s_recorder` demonstrates how to record audio from a digital MEMS microphone using the I2S peripheral in PDM data format and save it to an SD card in ``.wav`` file format on {IDF_TARGET_NAME} development boards.
- :example:`peripherals/i2s/mic_recorder` demonstrates how to record audio from either PDM digital MEMS microphones (using the I2S PDM RX mode) or an analog microphone through an ES8389 codec, and streams the recorded PCM data over the console so that the ``.wav`` file can be reconstructed on the host PC.
- :example:`peripherals/i2s/i2s_basic/i2s_pdm` demonstrates how to use the PDM RX mode on {IDF_TARGET_NAME}, including the necessary hardware setup and configuration.
For PDM mode in RX channel, the slot configuration helper macro are:

3
docs/zh_CN/api-reference/peripherals/i2s.rst
View File

@@ -445,6 +445,7 @@ I2S 驱动例程请参考 :example:`peripherals/i2s` 目录。以下为每种模
- :example:`peripherals/i2s/i2s_codec/i2s_es8311` 演示了如何在 {IDF_TARGET_NAME} 上使用 I2S ES8311 音频编解码器来播放音乐或回声，具有高性能和低功耗的多位 delta-sigma 音频 ADC 和 DAC，提供自定义音乐、调整麦克风增益和音量的选项。
- :example:`peripherals/i2s/i2s_basic/i2s_std` 演示了如何在 {IDF_TARGET_NAME} 上以单工或全双工模式使用 I2S 标准模式。
- :example:`peripherals/i2s/mic_recorder` 演示了如何通过 I2S STD 接口，使用 ES8389 音频编解码器录制模拟麦克风的音频。
不同声道的通信格式可通过以下标准模式的辅助宏来生成。如上所述，在标准模式下有三种格式，辅助宏分别为：
@@ -804,7 +805,7 @@ STD RX 模式
PDM RX 模式的应用
^^^^^^^^^^^^^^^^^^
- :example:`peripherals/i2s/i2s_recorder` 演示了如何通过 I2S 外设以 PDM 数据格式用数字 MEMS 麦克风录制音频，并将其以 ``.wav`` 文件格式保存到 {IDF_TARGET_NAME} 开发板上的 SD 卡中。
- :example:`peripherals/i2s/mic_recorder` 演示了如何录制音频：既可以使用 PDM 数字 MEMS 麦克风（通过 I2S PDM RX 模式），也可以使用连接 ES8389 编解码器的模拟麦克风，并将采集到的 PCM 数据通过控制台串流输出，以便在主机 PC 上重建 ``.wav`` 文件。
- :example:`peripherals/i2s/i2s_basic/i2s_pdm` 演示了如何在 {IDF_TARGET_NAME} 上使用 PDM RX 模式，包括必要的硬件设置和配置。
针对 RX 通道的 PDM 模式，声道配置的辅助宏为：