做第一台小智 / 麦克风排错发布 2026-10-15内容更新 2026-10-18

小智听不到你？麦克风、唤醒词与按键输入排查

“你好，小智”没有反应时，先分清没有唤醒与没有采到声音。按固件支持、按键对照、麦克风丝印、I2S 输入线和声道选择逐步缩小问题。

入门ESP32-S3小智现成固件现成固件与排错

读完能做什么: 判断故障偏向唤醒配置、音频输入还是服务请求，并完成麦克风连接核对。
开始之前: 设备能启动，最好已确认喇叭能播放提示；知道当前固件和麦克风型号。
版本组合: 小智参考固件：v2.5.2；源码 49b4380b3faa0ceadd28a3e78aaf0f311c46c57e硬件范围：官方历史 S3 / N16R8 面包板参考方案；具体适用条件见正文

适用范围

引脚示例仅针对 v2.5.2 bread-compact-wifi 的默认 Simplex 配置；不适用于所有 S3 或集成音频板。

这篇验证到了哪一步

资料核对已通过: 2026-10-18 对照文末官方资料与 v2.5.2 固定源码；复核范围和访问限制见 docs/esp32-evidence/originals-review.md。版本：小智 v2.5.2 / 49b4380验证日期：2026-10-18
构建 / 配置不适用: 本文使用上游发布的现成固件或解释方案，未提供本站固件构建。
仿真不适用: 无线和音频行为不以仿真代替实物测试。
本站实板待验证: 尚未完成本站实板验证。

构建通过只说明指定环境中的代码或配置通过检查；实物功能、功耗和稳定性以对应的实板记录为准。

01 / 麦克风排错

没有唤醒，不等于麦克风已经坏了

先确认自己的固件支持什么唤醒方式。语音唤醒依赖相应配置和支持的硬件，修改智能体的角色名称也不等于修改设备的唤醒词。如果这个方案要求按键开始，反复喊“你好，小智”并不是有效测试。

还要先确认自己能观察到输入状态。设备可能没有听见，也可能已经进入请求但没有播放回复；如果喇叭本来就无声，只靠耳朵很难分辨这两种情况。

先排除完全无声的输出问题

参考：[1] 官方百科链接的常见问题 Q&A（历史资料）[2] 官方教程：面包板硬件与接线

02 / 麦克风排错

第 1 步：用已支持的按键方式做对照

按设备说明进入聆听状态，说一句简短问题，然后观察屏幕、状态提示或请求结果。按键开始后能正常问答、只有唤醒词无效时，优先检查唤醒支持和所用词句。按键也没有进入预期状态，则先回到程序与按键说明。

一次只测试一个现象。先让这句固定问题稳定通过，再尝试自定义唤醒词、打断或更复杂的交互，避免把多个新功能同时作为验收条件。

对照结果	更值得先查什么
按键开始后能正常识别并回复	语音唤醒能力、配置和实际唤醒词。
进入聆听，但始终没有有效语音结果	麦克风输入；也要区分网络或识别服务错误。
没有进入聆听状态	固件是否运行、按钮用途与触发条件。

做到这里，你应该看到: 能描述按键与语音两种尝试分别停在哪个状态。

参考：[1] 官方百科链接的常见问题 Q&A（历史资料）

03 / 麦克风排错

第 2 步：断电后，按丝印核对六个接点

INMP441 模块常见的几个标识包括 VDD、GND、SCK、WS、SD、L/R。核对时逐根读出标识，特别注意排针焊在正面还是背面。模块翻转后，照片里从左到右的顺序会反过来，丝印对应关系才是依据。

按照所选方案检查供电、地线、信号和 L/R 声道选择。不要省略看起来像附加线的连接，也不要把电源和地反接。原图用来辨认部件，不代表每个商家模块的排针方向都相同。

圆形 INMP441 麦克风模块与待焊排针。 — 实物图官方教程中的 INMP441 数字麦克风实物示例。采购时还应核对厂家的型号状态、模块排针及固件支持。官方教程原图

做到这里，你应该看到: 模块的供电、地、音频信号和声道选择都能与本方案对上。
如果卡住了: 自行焊接的排针先检查是否虚焊或连锡；不确定时使用已焊好的模块核对。

参考：[1] 官方百科链接的常见问题 Q&A（历史资料）[2] 官方教程：面包板硬件与接线

04 / 麦克风排错

第 3 步：确认输入线与这个固件一致

本篇版本的默认配置将麦克风 WS、SCK、SD 分别对应 GPIO4、GPIO5、GPIO6。SD 在这里是麦克风输出的数据，进入开发板输入端；不要把它与存储卡接口或功放上的 SD 标识混为一谈。

同样叫 SD 的端子，在不同模块上可能含义不同。先确认你正在读的是哪块模块的丝印，再看它连接到开发板哪个信号。换成其他固件或其他音频方案时，重新从该方案的配置文件核对。

乐鑫标准 44 引脚 ESP32-S3 开发板的官方参考接线图，含麦克风、功放、屏幕、按键与 ML307 扩展。 — 接线图官方 44 引脚参考图，原图包含 OLED、按键与 ML307 4G 扩展。Wi-Fi 基础方案跳过 4G 模块；先核对所用固件和图中 GPIO，不凭孔位套接其他版本。官方教程原图

做到这里，你应该看到: 实际连接与目标固件的输入配置一致，没有把其他模块的同名端子套进来。

参考：[2] 官方教程：面包板硬件与接线 [3] v2.5.2 面包板 Wi-Fi 引脚与 I2S 配置

05 / 麦克风排错

保留同一句测试，再决定是否替换模块

接线核对后，保持测试问题、距离和音量尽量一致。若需要换备用麦克风，只更换这一项；恢复识别说明原模块或其连接值得继续查，仍不识别则不能直接断言两个模块都坏了。

INMP441 是原教程的识别示例，TDK 当前标为新设计非推荐。购买替代模块时确认接口、引脚和固件，而不是只凭“数字麦克风”这几个字选择。测试记录尽量保留版本、接线图和具体状态，求助时更容易复查。

参考：[1] 官方百科链接的常见问题 Q&A（历史资料）[2] 官方教程：面包板硬件与接线 [3] v2.5.2 面包板 Wi-Fi 引脚与 I2S 配置 [4] TDK：INMP441 型号状态与器件资料

BACK TO THE SOURCE

资料来源与版本说明

本文属于小智现成固件路线，按文末官方资料与固定源码复核。历史 Q&A 与旧界面仅用于其所注明的版本情境，具体动作再按固定源码与板型核对；当前控制台的登录后界面和实物操作尚未验证。资料核对日期：2026-10-18。资料核对、程序构建与实板测试分别记录，不互相替代。

飞书原文请在浏览器打开；如跳转到登录页，按飞书提示访问。历史截图的原图出处与当前工具入口分别标明。