一、固件与烧录
▫️1. 如何烧录 UART-MCP 固件？
- 问题详情：首次使用板子，如何烧录固件？
- 解答：
▫️2. 无法烧录？
- 可能原因：
- 未正确进入下载模式
- 固件版本不匹配
- CH343P 驱动未安装
- 解决方法：
- 重新按住 BOOT 键上电，确保进入下载模式
- 检查端口选择是否正确
- 安装 CH343P 驱动程序
▫️3. 如何使用 emMCP 库开发？
- 解答：焊好的第一步就是烧录 UART-MCP 固件，否则无法控制。安信可为 UART-MCP 开发了专门的适配库：emMCP，只需要非常简单的移植就能使用。
- 相关资源：
- 源码地址（emMCP）：Gitee - emMCP
- UART-MCP 固件下载：点击下载
- MCP 参考资料：MCP 协议文档
- emMCP 编程指南：emMCP 入门指南
二、供电与电源
▫️1. PD 诱骗无法输出高电压？
- 排查步骤：
- 确认使用的充电器支持 PD 协议
- 检查 PD 诱骗芯片配置是否正确
- 使用万用表测量输出电压
- 确认负载功率不超过充电器额定功率
三、语音与 AI
▫️1. 如何自定义唤醒词？
- 解答：当前默认唤醒词为「你好小安」，暂不支持替换唤醒词。
▫️2. 唤醒成功率低怎么办？
- 优化建议：
- 确保麦克风没有被遮挡
- 在相对安静的环境中使用
- 说话时距离麦克风 0.5-1 米为宜
- 使用标准普通话，语速适中
- 模组小板预留MIC接线端子，可自行扩展质量更佳的咪头
▫️3. 打断对话困难？
- 问题详情：设备在说话的时候，打断成功率低或不能打断的问题
- 原因：喇叭声音太大影响了 MIC 的拾音
- 解决方法：
- 喇叭声音大时，尽量靠近 MIC 进行唤醒打断
- 适当降低喇叭声音，例如：说"把声音调到 50"
四、联网与配网
▫️1. 配网搜寻不到设备？
- 可能原因：
- 蓝牙未开启
- 位置信息没授权
- 部分型号手机的"允许附近设备连接"功能没启用
- 解决方法：开启蓝牙并启动位置信息授权，如果还未解决，请启用"允许附近设备连接"功能。
五、STM32 开发常见问题
▫️1. ST-LINK 连接不上？
- 可能原因：驱动未安装、接线错误、BOOT0 未拉低
- 解决方法：
- 安装 ST-Link 驱动（STSW-LINK009）
- 检查接线：SWDIO→PA13, SWCLK→PA14, GND→GND, 3.3V→VDD
- 确认 BOOT0 跳线帽拉低（接 GND）
- 如果仍连接不上，尝试按住复位键再点击下载
▫️2. 编译报错 "undefined reference to ..."
- 可能原因：缺少 emMCP 库源文件
- 解决方法：确认以下文件已加入编译：
- port/uartPort.c
- uart-mcp/emMCP.c
- uart-mcp/cJSON/cJSON.c
▫️3. 串口收不到 AI 模组的数据
- 可能原因：开发板未插好、波特率不匹配、模组未配网
- 解决方法：
- 确认 Ai-WV01-32S-Kit 开发板已正确插入底板排母座
- 确认串口波特率为 1500000（STM32 调试口）或 115200（AI 模组）
- 先确认 Ai-WV01-32S-Kit 已配网成功（能正常语音对话）
▫️4. 工具注册后 AI 无法调用
- 可能原因：工具名含特殊字符、未调用 RegistrationTools
- 解决方法：
- 工具名仅用
[a-z0-9_]或中文 - 确认已调用
emMCP_AddToolToToolList()和emMCP_RegistrationTools() - 使用串口日志观察注册过程
- 工具名仅用
▫️5. OLED 不显示或显示异常
- 可能原因：SPI 引脚接触不良、初始化顺序不对、字库芯片异常
- 解决方法：
- 检查 OLED 模块 SPI 引脚（CS/DC/SCLK/MOSI）是否插紧
- 先在 OLED 初始化后调用 OLED_Test() 确认硬件正常
- 如显示乱码，确认字库芯片 GT20L61S 驱动正常
▫️6. PD 诱骗无法输出高压
- （已在现有 FAQ 中，保留并链接到现有条目）