您好，是否可以出一个ES8311单麦克风使用ESP SR的例程，我尝试修改双麦克风为单麦克风失败了。Hello, is it possible to provide an example routine for using the ES8311 single microphone with ESP SR? I attempted to modify the dual microphone setup to a single microphone but failed.

[caidamao]

Related area

Driver

Hardware specification

ESP32S3

Is your feature request related to a problem?

期望可以出一个使用ES8311+单麦克风的使用ESP SR进行语音识别例程，我在esp-sr的仓库里提了这个请求，让我来这个仓库提请求。

这个诉求的核心原因在于，没有一个参考，我没办法分清楚到底是我代码哪里写的不正确。

I hope an example routine for voice recognition using ES8311 with a single microphone and ESP SR can be provided. I raised this request in the esp-sr repository and was directed to make the request here.

The core reason for this request is that without a reference, I am unable to identify where my code is incorrect.

Describe the solution you'd like

我现在期望使用的是ESP S3+ES8311 挂载一个麦克风跟喇叭，由于成本问题，并不希望使用ES7210。
我尝试使用的环境ESP IDF V5.5.1 + ESP SR v2.0.0.
我现在根据查到的资料进行了一些尝试，但是不知道为什么一直没办法成功，并且找不到可以对照的例子，现在被困住了。我买了一块BOX3 但是这个是使用ES7210+双麦克风的，没有办法对照我问题出在哪里。
我现在的硬件使用ES8311里的i2s_echo是可以正常录音跟播放的。

I currently intend to use ESP S3 + ES8311 with a single microphone and a speaker. Due to cost constraints, I prefer not to use ES7210.

The environment I am trying to use is ESP IDF V5.5.1 + ESP SR v2.0.0.

Based on the information I found, I have made some attempts, but for some reason, I have not been able to succeed and cannot find any examples for reference. Now I am stuck. I purchased a BOX3, but it uses ES7210 with dual microphones, so it cannot help me identify where the issue lies in my setup.

Currently, with my hardware, I can successfully record and playback using the i2s_echofunction in ES8311.

Describe alternatives you've considered

No response

Additional context

i2s_es8311_example.zip附上我尝试修改的demo。

I have checked existing list of Feature requests and the Contribution Guide

• I confirm I have checked existing list of Feature requests and Contribution Guide.

[github-actions]

Hi @caidamao! Please be aware that (1) the following suggestions are generated by a bot and haven't been fact-checked by Espressif Systems, (2) burning eFuses and enabling security features are irreversible operations and can damage your ESP32 device. We hope that this message will help you until an Espressif Engineer looks at your issue.

---

下面给出用“ESP32‑S3 + ES8311 + 单麦克风”跑 ESP‑SR v2 的可行思路与可对照的最小参考路径。您已验证 i2s_es8311 的录放回声正常，说明硬件与底层 I2S/I2C链路是通的，接下来关键是把“单麦输入”正确喂给 AFE v2，并选用合适的 input_format、采样参数与通道数。

建议步骤

1. 先用官方 ES8311 I2S 示例验证采样参数

• 在 ESP‑IDF 的 i2s_es8311 示例里确认 MIC 采样速率、位宽、I2S 引脚等配置与您的硬件一致（示例支持 S3，含默认引脚与 PA 控制说明）。确保能稳定录音且噪声/幅度正常。[I2S ES8311]
• 该例依赖 esp_codec_dev 组件；您自有工程也应以相同方式创建 ES8311 的 control/data 接口，并用 esp_codec_dev_open/read 写入音频流。[How to Use; Codec usage]

2. 用 esp_codec_dev 按单麦初始化 ES8311

• 按组件文档：新建 I2S data_if + I2C ctrl_if，创建 es8311_codec_new，最后用 esp_codec_dev_new 得到句柄，设置输入增益与采样参数（如 16 kHz/16 bit/1 ch）。示例代码片段如下，来自组件文档：[Codec usage]

audio_codec_i2s_cfg_t i2s_cfg = { /* 按您的 I2S 句柄填充 */ };
const audio_codec_data_if_t *data_if = audio_codec_new_i2s_data(&i2s_cfg);

audio_codec_i2c_cfg_t i2c_cfg = { .addr = ES8311_CODEC_DEFAULT_ADDR };
const audio_codec_ctrl_if_t *ctrl_if = audio_codec_new_i2c_ctrl(&i2c_cfg);

const audio_codec_gpio_if_t *gpio_if = audio_codec_new_gpio();

es8311_codec_cfg_t es8311_cfg = {
    .codec_mode = ESP_CODEC_DEV_WORK_MODE_BOTH,
    .ctrl_if = ctrl_if,
    .gpio_if = gpio_if,
    .pa_pin = YOUR_PA_GPIO,
    .use_mclk = true,
};
const audio_codec_if_t *codec_if = es8311_codec_new(&es8311_cfg);

esp_codec_dev_cfg_t dev_cfg = {
    .codec_if = codec_if,
    .data_if = data_if,
    .dev_type = ESP_CODEC_DEV_TYPE_IN_OUT,
};
esp_codec_dev_handle_t codec = esp_codec_dev_new(&dev_cfg);

esp_codec_dev_set_in_gain(codec, 30.0f);
esp_codec_dev_sample_info_t fs = { .sample_rate = 16000, .channel = 1, .bits_per_sample = 16 };
esp_codec_dev_open(codec, &fs);

3. 将 I2S 采到的“单声道 MIC 流”喂给 ESP‑SR AFE v2

• AFE v2 用 input_format 描述通道排列。单麦场景建议用 "M"（仅 1 路麦克风）。通过 afe_config_init 传入："M"、模型、类型与模式，然后用 esp_afe_handle_from_config 获取句柄。[AFE migration; AFE index]
  示意（关键 API 出自迁移文档）：

afe_config_t *afe_cfg = afe_config_init("M", models, AFE_TYPE_SR, AFE_MODE_HIGH_PERF);
esp_afe_sr_iface_t *afe = esp_afe_handle_from_config(afe_cfg);

• 您需要按 AFE 的输入要求（常见为 16 kHz 单声道、定帧长度）将从 esp_codec_dev_read 取到的 PCM 帧送入 AFE 处理，然后将 AFE 输出交给 WakeNet/MultiNet 进行唤醒与指令识别。可参考 ESP‑SR “Getting Started”与示例工程的整体流程（使用 ESP‑Skainet 包含的示例）。[SR Getting Started S3; SR Getting Started ESP32; ESP-SR component]

4. 关键对照点（从“双麦/带参考”改为“单麦/无参考”常见错误）

• input_format 必须与输入通道一致：单麦仅用 "M"。把双麦 "MM…" 或含参考 "R" 的配置保留会导致通道错位或缓冲大小不匹配。[AFE migration]
• 采样率与位宽对齐：AFE 常用 16 kHz/16-bit，若 ES8311/I2S 端配置为 48 kHz或立体声，需在采集端改成 16 kHz/单声道，或做下采样/通道选取后再送 AFE。[I2S recorder]
• 缓冲帧长与对齐：确保每次喂 AFE 的帧长与 AFE 要求一致（参照 ESP‑SR 示例的帧推送节奏）。[SR Getting Started S3]
• 硬件麦克风品质与布线：单麦的拾音门限更依赖麦克风 SNR、灵敏度与结构；请对照麦克风设计指引，避免泄漏与啸叫，远离喇叭，提高密封性。[Mic guidelines]

5. 若需要可复用的“单麦 + ES8311”参考

• 目前资料里没有现成“ESP‑SR + ES8311 单麦”的完整示例工程，但可以将以下两者对接形成最小参考：
  • 音频采集/回放与 ES8311 初始化：IDF i2s_es8311 示例 + esp_codec_dev 用法。[How to Use; Codec usage]
  • 语音唤醒与指令识别流程：ESP‑Skainet 的英文命令示例（将其输入端替换为您从 ES8311 读取的单通道 PCM，并把 AFE input_format 设为 "M"）。[SR Getting Started S3; ESP-SR component]

6. 选型与单麦可行性

• 官方方案对比中，ES8311 + 模拟麦是推荐的“均衡选择”，支持回声消除，成本与效果平衡，适合单麦场景。[LLM audio table]

如果您愿意，我们可以基于 i2s_es8311 示例骨架，指引您把 PCM 拉流对接到 AFE v2（"M"）并跑 WakeNet/MultiNet 的关键改动点。当前知识源中未包含现成的“ES8311 单麦 + ESP‑SR”整包示例工程下载链接，但上述步骤可直接落地；若卡在具体 API/帧长或配置处，请贴出您的 input_format、采样率/通道配置与喂 AFE 的代码片段，我们再做逐行对照。[AFE migration; ESP-SR component]