ES8389在xiaozhi-esp32中如何实现全双工音频编解码【免费下载链接】xiaozhi-esp32An MCP-based chatbot | 一个基于MCP的聊天机器人项目地址: https://gitcode.com/GitHub_Trending/xia/xiaozhi-esp32给语音助手接上扬声器和麦克风时第一步不是写驱动而是确认 I2S 时钟树ES8389 是 xiaozhi-esp32 中的音频编解码组件负责把 PCM 转成扬声器可放的模拟信号再把麦克风信号还原成数字。ES8389在链路里的位置xiaozhi-esp32 的音频数据以单声道int16_tPCM 的形式流动服务端语音经协议层到达唤醒与 AFE 处理都在内存里完成整条链路中唯一承担数字↔模拟转换的是 ES8389 的 DAC输出端与 ADC输入端。板卡对象通过GetAudioCodec()创建 codec 实例main/audio/audio_service.cc按节拍调用它读写帧因此 ES8389 只挂在链路两端不进入业务状态机。它与主模块的交互协议是双向的I2C 走配置和状态查询I2S 走采样流ESP32 担任主机ES8389 从机数据方向一进一出各占一组数据线。 ES8389能力拆解ES8389的I2S时钟同步与双工通道做什么一次性建立收发双通道让扬声器播放 TTS 的同时麦克风持续监听即全双工。怎么实现CreateDuplexChannels以I2S_ROLE_MASTER创建 tx/rx 一对通道时钟倍率I2S_MCLK_MULTIPLE_256、采样位宽I2S_DATA_BIT_WIDTH_16BIT、slot 为立体声模式DMA 队列 6 个描述符 × 240 帧并用assert强制输入输出采样率相等。对开发者的影响板卡侧必须把AUDIO_INPUT_SAMPLE_RATE与AUDIO_OUTPUT_SAMPLE_RATE设成同一值atk 板为24000否则启动即被断言拦截采样率确定后 MCLK 频率自动跟随不需要手工管时钟。ES8389功放控制与静音策略做什么按谁在说话动态切断播放通路兼顾功耗。怎么实现EnableOutput(true)时把pa_pin拉高、解除静音并打开输出设备关闭时不调用 close 而是esp_codec_dev_set_out_mute静音同时把功放引脚拉低。对开发者的影响在 ESP32-S3 上 RX 通道借用配对的 TX 作为时钟源若把 TX 关掉再重开第二次播放可能无声es8389_audio_codec.cc的注释写明了这条规避逻辑另外功放断电直接省下静态电流对电池供电设备是实打实的续航收益。ES8389的音量管理与单声道到立体声的扩展做什么提供 0~100 的软件音量与默认40dB输入增益。怎么实现SetOutputVolume写esp_codec_dev_set_out_vol并经基类AudioCodec持久化到 NVSaudio分区默认播放音量 70Write()检查output_channels_大于 1 时把单声道样本复制到 L/R 两路。对开发者的影响说白了全链路产出的是单声道 PCM双声道输出时若直接把单声道样本数写进双 slot 会 I2S 欠载并伴随杂音这段扩展在驱动内部完成上层无需感知。 ES8389接入与配置接线和初始化硬件连接要点以 ATK-DNESP32S3-BOX2 为例I2C 控制总线SDAGPIO_NUM_48、SCLGPIO_NUM_47设备地址取ES8389_CODEC_DEFAULT_ADDRI2S 音频总线MCLKGPIO_NUM_38、BCLKGPIO_NUM_40、WSGPIO_NUM_42、DOUTGPIO_NUM_41、DINGPIO_NUM_39功放使能该板经 TCA9555 IO 扩展器输出XIO_SPK_EN驱动pa_pin传GPIO_NUM_NC硬件上 PA_EN 若直接接 ESP32 则传对应 GPIO采样率输入输出同为24000在板级config.h中定义MCLK 需有稳定来源该板use_mclk为true软件初始化流程分两步板级构造函数先建立 I2C 主机总线i2c_new_master_bus随后GetAudioCodec()构造静态Es8389AudioCodec构造函数内部按序完成双通道创建、I2S 数据接口、I2C 控制接口、es8389_codec_newpa_voltage设5.0、codec_dac_voice_voltage相关参数3.3以及输入/输出设备对象的创建之后由AudioService按需调用EnableInput/EnableOutput打开通路。// main/boards/alientek/atk-dnesp32s3-box2-wifi/atk_dnesp32s3_box2.cc static Es8389AudioCodec audio_codec( i2c_bus_, I2C_NUM_0, AUDIO_INPUT_SAMPLE_RATE, AUDIO_OUTPUT_SAMPLE_RATE, AUDIO_I2S_GPIO_MCLK, AUDIO_I2S_GPIO_BCLK, AUDIO_I2S_GPIO_WS, AUDIO_I2S_GPIO_DOUT, AUDIO_I2S_GPIO_DIN, GPIO_NUM_NC, AUDIO_CODEC_ES8389_ADDR, AUDIO_CODEC_USE_MCLK);实际硬件上麦克风、扬声器功放与 codec 通常已集成在音频子板里接入时重点核对的是 I2C 地址与 PA_EN 控制链是否和板级配置一致。ES8389常见坑与排查无声但日志显示 codec 初始化正常根因是功放未使能pa_pin为GPIO_NUM_NC时扬声器使能实际由板级 IO 扩展器或独立使能脚管理。对照原理图找到 SPK_EN 的出口确认其在播放前被置高即可。一轮播放后第二次 TTS 无声ESP32-S3 上常见根因是关闭再重开 TX 通道导致 RX 双工时钟源失效。保留驱动内关闭只静音的处理复用驱动时不要自行追加 close 调用。录音出现杂音或音调偏移根因是 I2S slot 配置被改动ES8389 默认按16bit左对齐 立体声 slot 对齐改slot_mask或位宽后采样错位。恢复CreateDuplexChannels的std_cfg默认值后再逐项排查时钟与增益。双声道输出时声音断续根因是全链路为单声道 PCM直接按单声道样本数写入双声道 slot 触发 I2S 欠载。交由驱动Write()将样本展开为samples * output_channels_自行调用时注意长度换算。相关文件与扩展编解码器驱动main/audio/codecs/es8389_audio_codec.cc、main/audio/codecs/es8389_audio_codec.h基类与服务层main/audio/audio_codec.h、main/audio/audio_service.cc板级接入参考main/boards/alientek/atk-dnesp32s3-box2-wifi/atk_dnesp32s3_box2.cc及同目录config.h、main/boards/espressif/esp32-s31-korvo-1/esp32_s31_korvo_1.cc4G 版本板卡音频链路相同main/boards/alientek/atk-dnesp32s3-box2-4g/音频子系统说明文档main/audio/README.md官方适配的硬件包括 ATK-DNESP32S3-BOX2WiFi/4G与 ESP32-S31-Korvo-1。以上覆盖了从零接入到调通的最小路径更深入的寄存器级配置可参考 esp_codec_dev 驱动注释与 ES8389 数据手册。【免费下载链接】xiaozhi-esp32An MCP-based chatbot | 一个基于MCP的聊天机器人项目地址: https://gitcode.com/GitHub_Trending/xia/xiaozhi-esp32创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 ES8389在xiaozhi-esp32中如何实现全双工音频编解码
ES8389在xiaozhi-esp32中如何实现全双工音频编解码【免费下载链接】xiaozhi-esp32An MCP-based chatbot | 一个基于MCP的聊天机器人项目地址: https://gitcode.com/GitHub_Trending/xia/xiaozhi-esp32给语音助手接上扬声器和麦克风时第一步不是写驱动而是确认 I2S 时钟树ES8389 是 xiaozhi-esp32 中的音频编解码组件负责把 PCM 转成扬声器可放的模拟信号再把麦克风信号还原成数字。ES8389在链路里的位置xiaozhi-esp32 的音频数据以单声道int16_tPCM 的形式流动服务端语音经协议层到达唤醒与 AFE 处理都在内存里完成整条链路中唯一承担数字↔模拟转换的是 ES8389 的 DAC输出端与 ADC输入端。板卡对象通过GetAudioCodec()创建 codec 实例main/audio/audio_service.cc按节拍调用它读写帧因此 ES8389 只挂在链路两端不进入业务状态机。它与主模块的交互协议是双向的I2C 走配置和状态查询I2S 走采样流ESP32 担任主机ES8389 从机数据方向一进一出各占一组数据线。 ES8389能力拆解ES8389的I2S时钟同步与双工通道做什么一次性建立收发双通道让扬声器播放 TTS 的同时麦克风持续监听即全双工。怎么实现CreateDuplexChannels以I2S_ROLE_MASTER创建 tx/rx 一对通道时钟倍率I2S_MCLK_MULTIPLE_256、采样位宽I2S_DATA_BIT_WIDTH_16BIT、slot 为立体声模式DMA 队列 6 个描述符 × 240 帧并用assert强制输入输出采样率相等。对开发者的影响板卡侧必须把AUDIO_INPUT_SAMPLE_RATE与AUDIO_OUTPUT_SAMPLE_RATE设成同一值atk 板为24000否则启动即被断言拦截采样率确定后 MCLK 频率自动跟随不需要手工管时钟。ES8389功放控制与静音策略做什么按谁在说话动态切断播放通路兼顾功耗。怎么实现EnableOutput(true)时把pa_pin拉高、解除静音并打开输出设备关闭时不调用 close 而是esp_codec_dev_set_out_mute静音同时把功放引脚拉低。对开发者的影响在 ESP32-S3 上 RX 通道借用配对的 TX 作为时钟源若把 TX 关掉再重开第二次播放可能无声es8389_audio_codec.cc的注释写明了这条规避逻辑另外功放断电直接省下静态电流对电池供电设备是实打实的续航收益。ES8389的音量管理与单声道到立体声的扩展做什么提供 0~100 的软件音量与默认40dB输入增益。怎么实现SetOutputVolume写esp_codec_dev_set_out_vol并经基类AudioCodec持久化到 NVSaudio分区默认播放音量 70Write()检查output_channels_大于 1 时把单声道样本复制到 L/R 两路。对开发者的影响说白了全链路产出的是单声道 PCM双声道输出时若直接把单声道样本数写进双 slot 会 I2S 欠载并伴随杂音这段扩展在驱动内部完成上层无需感知。 ES8389接入与配置接线和初始化硬件连接要点以 ATK-DNESP32S3-BOX2 为例I2C 控制总线SDAGPIO_NUM_48、SCLGPIO_NUM_47设备地址取ES8389_CODEC_DEFAULT_ADDRI2S 音频总线MCLKGPIO_NUM_38、BCLKGPIO_NUM_40、WSGPIO_NUM_42、DOUTGPIO_NUM_41、DINGPIO_NUM_39功放使能该板经 TCA9555 IO 扩展器输出XIO_SPK_EN驱动pa_pin传GPIO_NUM_NC硬件上 PA_EN 若直接接 ESP32 则传对应 GPIO采样率输入输出同为24000在板级config.h中定义MCLK 需有稳定来源该板use_mclk为true软件初始化流程分两步板级构造函数先建立 I2C 主机总线i2c_new_master_bus随后GetAudioCodec()构造静态Es8389AudioCodec构造函数内部按序完成双通道创建、I2S 数据接口、I2C 控制接口、es8389_codec_newpa_voltage设5.0、codec_dac_voice_voltage相关参数3.3以及输入/输出设备对象的创建之后由AudioService按需调用EnableInput/EnableOutput打开通路。// main/boards/alientek/atk-dnesp32s3-box2-wifi/atk_dnesp32s3_box2.cc static Es8389AudioCodec audio_codec( i2c_bus_, I2C_NUM_0, AUDIO_INPUT_SAMPLE_RATE, AUDIO_OUTPUT_SAMPLE_RATE, AUDIO_I2S_GPIO_MCLK, AUDIO_I2S_GPIO_BCLK, AUDIO_I2S_GPIO_WS, AUDIO_I2S_GPIO_DOUT, AUDIO_I2S_GPIO_DIN, GPIO_NUM_NC, AUDIO_CODEC_ES8389_ADDR, AUDIO_CODEC_USE_MCLK);实际硬件上麦克风、扬声器功放与 codec 通常已集成在音频子板里接入时重点核对的是 I2C 地址与 PA_EN 控制链是否和板级配置一致。ES8389常见坑与排查无声但日志显示 codec 初始化正常根因是功放未使能pa_pin为GPIO_NUM_NC时扬声器使能实际由板级 IO 扩展器或独立使能脚管理。对照原理图找到 SPK_EN 的出口确认其在播放前被置高即可。一轮播放后第二次 TTS 无声ESP32-S3 上常见根因是关闭再重开 TX 通道导致 RX 双工时钟源失效。保留驱动内关闭只静音的处理复用驱动时不要自行追加 close 调用。录音出现杂音或音调偏移根因是 I2S slot 配置被改动ES8389 默认按16bit左对齐 立体声 slot 对齐改slot_mask或位宽后采样错位。恢复CreateDuplexChannels的std_cfg默认值后再逐项排查时钟与增益。双声道输出时声音断续根因是全链路为单声道 PCM直接按单声道样本数写入双声道 slot 触发 I2S 欠载。交由驱动Write()将样本展开为samples * output_channels_自行调用时注意长度换算。相关文件与扩展编解码器驱动main/audio/codecs/es8389_audio_codec.cc、main/audio/codecs/es8389_audio_codec.h基类与服务层main/audio/audio_codec.h、main/audio/audio_service.cc板级接入参考main/boards/alientek/atk-dnesp32s3-box2-wifi/atk_dnesp32s3_box2.cc及同目录config.h、main/boards/espressif/esp32-s31-korvo-1/esp32_s31_korvo_1.cc4G 版本板卡音频链路相同main/boards/alientek/atk-dnesp32s3-box2-4g/音频子系统说明文档main/audio/README.md官方适配的硬件包括 ATK-DNESP32S3-BOX2WiFi/4G与 ESP32-S31-Korvo-1。以上覆盖了从零接入到调通的最小路径更深入的寄存器级配置可参考 esp_codec_dev 驱动注释与 ES8389 数据手册。【免费下载链接】xiaozhi-esp32An MCP-based chatbot | 一个基于MCP的聊天机器人项目地址: https://gitcode.com/GitHub_Trending/xia/xiaozhi-esp32创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考