欢迎使用鱼易科技服务支持平台。本文档将帮助您快速掌握 esp-sparkbot 项目的使用方法，包括硬件资料获取、配网烧录流程、功能操作及注意事项，确保您顺利体验基于 ESP32-S3 的 AI 桌面机器人功能。
项目概述
ESP-SparkBot 是一款基于 ESP32-S3 芯片的开源 AI 桌面机器人，融合 语音交互、图像识别与多媒体娱乐 功能。其核心特性包括：
- 支持多固件切换（坦克控制、AI 对话、本地娱乐等场景）；
- 兼容 2.4G WiFi 网络，支持手机/电脑远程控制与配置；
- 开源硬件设计与软件例程，适配 ESP-IDF 开发环境，适合二次开发与教学实践。
资料链接汇总
2.1 官方核心资源
- 硬件开源平台：ESP-SparkBot - 立创开源硬件平台（含设计文档、物料清单、装配图）
- 软件仓库：esp_sparkbot（Gitee）（例程、3D 建模文件及开发指南）
- B站教程合集：
2.2 第三方支持资源
- 小智 AI 聊天机器人：小智控制台（配网与固件管理）
- 小智固件开源：GitHub - iotsystem/xiaozhi-esp32
- 技术文档：开源项目ESP-SparkBot（CSDN博客）
1、 配网流程（基于小智固件）
适用场景：首次使用或更换网络环境时配置 WiFi 连接。
- 准备工作：确保设备电量 ≥ 50%，手机连接 2.4G WiFi（不支持 5G）。
- 访问控制台：打开浏览器访问 小智控制台，点击“添加设备”。
- 设备配网：
- 长按设备电源键 3 秒开机，待指示灯闪烁进入配网模式；
- 在控制台输入当前 WiFi 名称（SSID）和密码，点击“开始配网”；
- 设备提示“配网成功”后，指示灯变为常亮，完成连接。
2、 固件烧录（Web 工具）
适用场景：更新固件或切换功能模式（如从坦克控制切换到 AI 对话）。
- 工具准备：
- 操作步骤：
- 在烧录页面选择固件类型（如“xiaozhi-v1-3”“tan-control”）；
- 点击“连接设备”，选择对应串口（如“COM3”）；
- 点击“开始烧录”，等待进度条完成（约 2-3 分钟），设备自动重启。
详细功能操作
1、 固件功能对比
| 固件类型 | 核心功能 | 唤醒词 | 网络依赖 | 典型应用场景 |
|---|---|---|---|---|
| 官方离线坦克固件（tan-control） | 语音控制坦克、手机遥控 | “hi 乐鑫” | 无需联网 | 课堂演示、离线互动 |
| Factory 官方固件（factory） | 2048 游戏、敲木鱼、摄像头、AI 对话 | 无默认唤醒词 | 需配网（AI 功能） | 本地娱乐、图像采集 |
| 小智固件（xiaozhi-v1-3） | AI 对话、坦克控制、图像识别 | “你好小智” | 需联网 | 智能对话、远程控制 |
2、 分固件操作指南
▶ 官方离线坦克固件（tan-control）
- 语音控制：
- 喊 “hi 乐鑫” 唤醒设备（指示灯变为蓝色）；
- 下达指令：“向前冲”（前进）、“向后退”（后退）、“跳个舞”（随机动作）、“灯光秀”（LED 灯效）。
- 手机遥控：
- 设备开机后，手机连接热点“ESP-SparkBot-XXX”；
- 打开 Chrome 浏览器，输入 192.168.4.1，通过屏幕摇杆控制移动方向。
▶ Factory 官方固件（factory）
- 本地功能：
- 喊 “打开 2048” 启动游戏，通过语音“上/下/左/右”控制方块移动；
- 喊 “敲木鱼” 触发音效，敲击设备顶部传感器模拟敲木鱼动作。
- AI 对话配置：
- 配网后访问设备 IP 地址（如 192.168.1.100）；
- 在“API 设置”中填入百度豆包 API 密钥，保存后即可通过语音“开始对话”调用 AI 功能。
▶ 小智固件（xiaozhi-v1-3）
- AI 对话：
- 喊 “你好小智” 唤醒（支持连续对话，超时 10 秒自动休眠）；
- 可直接提问（如“今天天气如何？”）或指令（如“讲个故事”“修改音色为儿童音”）。
- 坦克控制模式：
- 唤醒后喊 “坦克控制” 进入模式（指示灯变为绿色）；
- 指令包括：“向左转”（90°转向）、“向右转”（90°转向）、“停止”（紧急制动）。
安全警告
- 电池安全：警告：本产品包含 3.7V 小容量锂电池，严禁拆卸、挤压、刺穿或焚烧电池，避免高温（＞60℃）或潮湿环境。废旧电池需按当地法规分类回收。
- 使用年龄：不建议 12 岁以下儿童单独操作，需成人陪同指导。
常见问题处理
- 无声音响应：
- 若设备屏幕显示“正在说话中”，需等待语音播放完毕（状态跳转至“聆听中”）再下达指令；
- 服务器拥挤时可能延迟，可尝试重启设备或切换网络。
- 配网失败：
- 确认 WiFi 为 2.4G 频段（不支持 5G）；
- 重启路由器或使用手机热点重试（密码不含特殊字符）。
- 固件烧录失败：
- 检查 USB 接触是否良好，尝试更换数据线或电脑端口；
- 烧录前需按住设备“BOOT”键，再按“RST”键进入下载模式。