【嵌入式人工智能产品开发实战】（二十二）—— 政安晨：改造小智AI开发智能体硬件（案例：移植PowerManager后麦克风不工作）
政安晨的个人主页：政安晨
欢迎 👍点赞✍评论⭐收藏
希望政安晨的博客能够对您有所裨益，如有不足之处，欢迎在评论区提出指正！
目录
确定你硬件的关键点
案例分析
🔍 一、关键代码分析
✅ 1. power_save_timer_->WakeUp(); 的作用
📌 相关逻辑：
✅ 2. 麦克风是否被关闭？
🧨 二、可能导致麦克风失效的原因
🛠️ 三、调试建议与修复方法
✅ 1. 添加日志确认当前状态
A. WakeUp() 函数内：
B. OnEnterSleepMode / OnExitSleepMode：
C. InitializePowerManager() 的回调：
✅ 2. 强制恢复音频输入
✅ 3. 检查 GetAudioCodec() 是否有效
✅ 4. 手动触发一次唤醒
✅ 5. 检查硬件连接
🧪 四、建议临时修复方案
五、总结
小智AI推出已经很久了，新鲜感过去之后，我们不禁要思考：我们可以利用这套框架干点什么呢？
为自己打个基础吧，先从给自己做块硬件开始。
接下来，我将列出当你拿到一块全新的嵌入式硬件主板后，如何将小智AI在这块板上运行起来。
确定你硬件的关键点
当你要集成小智AI时，为避免踩坑，你最好确认以下关键点：
1. 你的硬件芯片是ESP32的C3还是S3，或者其它型号？
2. 你的硬件是否有外部PSRAM，它的大小是多少？
3. 你的屏幕器件是什么型号？分辨率多少？
4. 你的麦克风是单/双麦克风？
5. 你硬件上的CODEC芯片是什么型号？I2C口多少，地址多少？
6. 你最好能拿到这个硬件的IO口映射表。
案例分析
在自己的硬件配置中增加powermanager功能后，发现唤醒不工作（初步判断为麦克风功能受到影响）
🔍 一、关键代码分析
✅ 1. power_save_timer_->WakeUp(); 的作用
main_button_.OnClick([this]() {ESP_LOGI(TAG, "main_button_ OnClick volume");power_save_timer_->WakeUp();...
});- 调用
power_save_timer_->WakeUp()是用于唤醒设备，退出休眠模式。 - 如果当前设备处于睡眠状态，这个调用会触发 OnExitSleepMode 回调。
📌 相关逻辑：
void PowerSaveTimer::WakeUp() {ticks_ = 0;if (in_sleep_mode_) {in_sleep_mode_ = false;// 恢复性能配置（如CPU频率）...// 触发退出休眠回调if (on_exit_sleep_mode_) {on_exit_sleep_mode_();}}
}✅ 2. 麦克风是否被关闭？
在 InitializePowerSaveTimer() 中有如下逻辑：
power_save_timer_->OnEnterSleepMode([this]() {auto display = GetDisplay();display->SetChatMessage("system", "");display->SetEmotion("sleepy");auto codec = GetAudioCodec();codec->EnableInput(false); // 关闭音频输入
});power_save_timer_->OnExitSleepMode([this]() {auto codec = GetAudioCodec();codec->EnableInput(true); // 恢复音频输入auto display = GetDisplay();display->SetChatMessage("system", "");display->SetEmotion("neutral");
});- 如果设备进入休眠模式，会执行
codec->EnableInput(false)，这会导致麦克风被关闭。 - 如果没有正确触发
OnExitSleepMode，或者WakeUp()没有恢复音频输入，麦克风就无法再次启用。
🧨 二、可能导致麦克风失效的原因
原因 分析 1. 设备长时间处于休眠状态 如果没有外部唤醒事件（比如按钮按下），设备一直处在休眠状态， EnableInput(false)就不会被恢复。2. WakeUp() 未成功触发 OnExitSleepMode 可能由于某些条件判断或错误处理跳过了 OnExitSleepMode 的执行，导致麦克风未重新启用。 3. GetAudioCodec() 返回空指针或无效对象 如果 GetAudioCodec() 初始化失败或返回了无效对象，后续操作将无效，也无法恢复音频输入。 4. InitializePowerManager()影响了电源管理如果设备检测到充电状态变化并频繁触发 SetEnabled(true/false)，可能会导致休眠/唤醒机制紊乱。 5. 音频驱动问题（硬件级） 如果底层音频驱动存在 bug 或初始化失败，也可能导致麦克风始终无法工作。
🛠️ 三、调试建议与修复方法
✅ 1. 添加日志确认当前状态
在以下关键位置添加日志输出，便于定位问题：
A. WakeUp() 函数内：
void PowerSaveTimer::WakeUp() {ESP_LOGI(TAG, "WakeUp() called, in_sleep_mode: %d", in_sleep_mode_);...
}B. OnEnterSleepMode / OnExitSleepMode：
power_save_timer_->OnEnterSleepMode([this]() {ESP_LOGI(TAG, "Entering sleep mode, disabling mic");auto codec = GetAudioCodec();codec->EnableInput(false);
});power_save_timer_->OnExitSleepMode([this]() {ESP_LOGI(TAG, "Exiting sleep mode, enabling mic");auto codec = GetAudioCodec();codec->EnableInput(true);
});C. InitializePowerManager() 的回调：
power_manager_->OnChargingStatusChanged([this](bool is_charging) {ESP_LOGI(TAG, "OnChargingStatusChanged: %d", is_charging);if (is_charging) {power_save_timer_->SetEnabled(false);} else {power_save_timer_->SetEnabled(true);}
});✅ 2. 强制恢复音频输入
你可以手动调用一次恢复麦克风的接口：
auto codec = GetAudioCodec();
if (codec != nullptr) {codec->EnableInput(true);ESP_LOGI(TAG, "Forced enable audio input.");
} else {ESP_LOGE(TAG, "Failed to get audio codec.");
}放在以下任意一个地方进行测试：
- 在
Application::GetInstance().StartListening()前； - 在
boot_button_.OnClick()或main_button_.OnClick()中； - 在
Initialize()构造函数最后；
✅ 3. 检查 GetAudioCodec() 是否有效
确保 GetAudioCodec() 正确初始化且返回非空指针：
virtual AudioCodec* GetAudioCodec() override {static BoxAudioCodec audio_codec(...);return &audio_codec;
}可以加日志验证：
auto codec = GetAudioCodec();
ESP_LOGI(TAG, "GetAudioCodec address: %p", codec);✅ 4. 手动触发一次唤醒
你可以通过按键模拟触发一次 power_save_timer_->WakeUp()，看是否能恢复麦克风功能。
✅ 5. 检查硬件连接
- 确认麦克风是否插拔良好；
- 检查 I2C 总线是否正常通信；
- 查看是否有硬件中断或 GPIO 设置冲突。
🧪 四、建议临时修复方案
你可以先尝试在启动时强制开启音频输入：
ZasmartHeadBoard() : boot_button_(BOOT_BUTTON_GPIO), main_button_(POWER_BUTTON_GPIO) {...InitializePowerSaveTimer();InitializePowerManager();// 强制恢复音频输入auto codec = GetAudioCodec();if (codec) {codec->EnableInput(true);}
}五、总结
| 问题点 | 排查建议 |
|---|---|
| 麦克风未恢复 | 检查 OnExitSleepMode 是否执行 |
WakeUp() 失效 | 添加日志，确认是否真正唤醒 |
GetAudioCodec() 失败 | 检查是否为空 |
InitializePowerManager() 干扰 | 检查是否频繁切换状态 |
| 音频驱动问题 | 检查硬件连接、I2C 通信等 |
如果你能提供以下信息，我可以进一步协助你精准定位问题：
- 串口打印的日志内容（尤其是 WakeUp、Sleep Mode、Audio Enable）
- 你目前麦克风失灵的具体场景（例如：刚开机、使用一段时间后、断电再开、按某个键之后等）
- 是否曾修改过
InitializePowerManager()或InitializePowerSaveTimer()的逻辑？
以笔者二十年智能硬件的开发经验，调试问题就是一个积累经验，所谓见多识广、假设验证，就是精华，小伙伴们共勉。