AI-01开发板编译、烧录与双配网模式说明
AI-01开发板编译、烧录与双配网模式说明
本文基于《四博智联AI开发宝典》中 AI-C2 / AI-01 开发板章节整理，重点保留硬件连接、ESP-IDF 编译、固件烧录和 SoftAP / BluFi 两种配网模式的实际开发步骤，适合做语音终端或轻量联网 AI 设备的前期验证。
AI-01 开发板的核心思路不是堆高配硬件，而是把ESP32-C2联网能力和离线语音能力组合在一块低门槛板卡上。对于需要先完成语音唤醒、联网对话、配网闭环，再逐步扩展到后端服务或 MCP 控制的项目，这类板卡更适合作为第一块验证样板。
硬件定位与适用场景
AI-01 对应的是ESP32-C2 + 定制离线语音模组方案，重点在于：
- 成本和硬件复杂度相对可控，适合先验证语音入口
- 支持离线语音指令，弱网或无网环境下仍可完成基础交互
- 可以对接四博维护的
DOIT_AI分支，接入小智体系的联网能力 - 适合做桌面语音助手、控制面板、入门型 AI 终端原型
如果项目目标是先做稳定的语音入口和配网流程，而不是一开始就追求屏幕、多模态或 4G 扩展，AI-01 会比更复杂的板卡更容易跑通第一版。
接线与下载准备
AI-01 开发板没有板载 USB 转串口功能，烧录和日志查看需要外接USB 转串口工具。开发时至少要确认三件事：
TX/RX交叉连接3V3和GND连接正确- Type-C 只负责给开发板供电，不替代串口下载
接好线以后，先在系统设备管理器里确认串口是否正常枚举，再进入编译与烧录流程。因为板上没有独立RESET按钮，后续很多步骤都依赖重新插拔 Type-C 让设备重新上电。
工程配置与编译
AI-01 使用的是四博维护的DOIT_AI工程分支。基础步骤可以整理为：
gitclone https://github.com/SmartArduino/DOIT_AI.git idf.py set-target esp32c2 idf.py menuconfig idf.py build编译前最关键的不是命令本身，而是menuconfig中的板型和配网方式：
Board Type设为Doit-AI-01-Kit- 如果走热点配网，保持默认
SoftAP - 如果走小程序蓝牙配网，切换
Net Configuration Mode为Blufi
在实际项目里，建议先用SoftAP跑通一版，确认语音、联网、日志都正常，再切到BluFi做面向终端用户的交付版本。
烧录流程与启动验证
AI-01 进入下载模式的关键动作是：
- 断开 Type-C 供电
- 按住板载按键不放
- 重新插上 Type-C
- 松开按键后开始烧录
烧录完成后，重新上电，串口里应该能看到小智固件启动日志；首次启动通常会进入配网模式，并给出对应提示音或日志提示。
如果烧录时报错，优先排查这几项：
- 串口是否被其他终端占用
TX/RX/GND是否接反或虚接- 是否真的进入了下载模式
- 芯片目标是否误配成了别的型号
SoftAP 与 BluFi 两种配网模式怎么选
AI-01 在开发宝典里给了两条配网路线，它们适合的阶段并不一样。
SoftAP 热点配网
- 优点是依赖少，联调直接
- 更适合研发阶段、串口盯日志阶段
- 遇到蓝牙栈问题时更容易快速定位
BluFi 小程序配网
- 更适合最终交付体验
- 用户不用切热点，流程更接近消费级设备
- 需要在
menuconfig中补足蓝牙相关开关
如果你准备切到BluFi，开发宝典里给出的重点是启用相关蓝牙能力，并关闭不必要的 NimBLE 角色和安全项，尽量把资源集中在配网链路本身。这个阶段最容易出问题的不是业务代码，而是menuconfig配置不完整。
适合怎样的项目
AI-01 更适合下面这类需求：
- 想先验证“小智设备端 + 自有后端”链路
- 需要低门槛语音入口，而不是复杂显示交互
- 希望在成本可控前提下做小批量样机
- 需要后续接 OTA、MCP 或私有化服务
如果项目下一阶段要加屏幕、摄像头或更复杂的人机交互，可以再迁移到 S3/C5 一类板卡；但如果目标是先把语音入口、联网稳定性和配网体验跑通，AI-01 仍然是很合适的起点。
开发建议
建议按下面顺序推进：
- 先完成串口接线与
hello world级别的环境验证 - 再编译
DOIT_AI并确认Board Type=Doit-AI-01-Kit - 先跑通
SoftAP配网和基础语音对话 - 最后切到
BluFi，再决定是否继续接 OTA、MCP 或私有后端
这样可以把“环境问题”“板型配置问题”和“配网体验问题”分开排查，避免一开始就把所有变量混在一起。