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 工程分支。基础步骤可以整理为：

git clone 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 进入下载模式的关键动作是：

1. 断开 Type-C 供电
2. 按住板载按键不放
3. 重新插上 Type-C
4. 松开按键后开始烧录

烧录完成后，重新上电，串口里应该能看到小智固件启动日志；首次启动通常会进入配网模式，并给出对应提示音或日志提示。

如果烧录时报错，优先排查这几项：

• 串口是否被其他终端占用
• TX/RX/GND 是否接反或虚接
• 是否真的进入了下载模式
• 芯片目标是否误配成了别的型号

SoftAP 与 BluFi 两种配网模式怎么选

AI-01 在开发宝典里给了两条配网路线，它们适合的阶段并不一样。

SoftAP 热点配网

• 优点是依赖少，联调直接
• 更适合研发阶段、串口盯日志阶段
• 遇到蓝牙栈问题时更容易快速定位

BluFi 小程序配网

• 更适合最终交付体验
• 用户不用切热点，流程更接近消费级设备
• 需要在 menuconfig 中补足蓝牙相关开关

如果你准备切到 BluFi，开发宝典里给出的重点是启用相关蓝牙能力，并关闭不必要的 NimBLE 角色和安全项，尽量把资源集中在配网链路本身。这个阶段最容易出问题的不是业务代码，而是 menuconfig 配置不完整。

适合怎样的项目

AI-01 更适合下面这类需求：

• 想先验证“小智设备端 + 自有后端”链路
• 需要低门槛语音入口，而不是复杂显示交互
• 希望在成本可控前提下做小批量样机
• 需要后续接 OTA、MCP 或私有化服务

如果项目下一阶段要加屏幕、摄像头或更复杂的人机交互，可以再迁移到 S3/C5 一类板卡；但如果目标是先把语音入口、联网稳定性和配网体验跑通，AI-01 仍然是很合适的起点。

开发建议

建议按下面顺序推进：

1. 先完成串口接线与 hello world 级别的环境验证
2. 再编译 DOIT_AI 并确认 Board Type=Doit-AI-01-Kit
3. 先跑通 SoftAP 配网和基础语音对话
4. 最后切到 BluFi，再决定是否继续接 OTA、MCP 或私有后端

这样可以把“环境问题”“板型配置问题”和“配网体验问题”分开排查，避免一开始就把所有变量混在一起。