06_Quick_Start.md

06 — 快速上手指南

⭐ 使用本教程前，请先支持一下这个开源项目：

1. Star ⭐ — 点击 GitHub 仓库右上角 ⭐ Star，收藏本项目，方便以后找到
2. Fork 🍴 — 点击 Fork，把项目复制到你的 GitHub 账号下，可以自由修改
3. Download 📥 — 点击绿色 Code 按钮 → Download ZIP，下载到本地开始复刻

📸 操作示意图：

---

5 分钟体验 MindPaw

拿到烧录好的硬件后，按以下步骤快速体验：

Step 1：开机

1. 插入 MicroUSB 线（手机充电器、充电宝、电脑 USB 口都可以）
2. ESP12F 上电，OLED 亮起显示 Logo
3. 舵机自动回到 90 度初始位置
4. 听到扬声器播放开机音效
5. OLED 显示 WiFi 信息：

WIFI_AP
MindPaw
192.168.4.1
WIFI CTRL

Step 2：连接 WiFi

1. 打开手机/电脑的 WiFi 列表
2. 找到 MindPaw 热点
3. 输入密码：mindpaw1234
4. 连接成功

Step 3：打开控制页面

1. 浏览器访问 http://192.168.4.1
2. 看到 MindPaw 控制中心 首页

Step 4：快速测试

操作	期望结果
点击 前进	舵机交替运动，机器狗向前走
点击 开心	OLED 显示开心表情
点击 坐下	舵机运动到坐姿
点击 AI 聊天	弹出聊天界面

Step 5：语音控制

对着 HLK-V20 说出预设命令，例如 "你好"、"前进"、"开心"。

首次使用需要配置 HLK-V20（详见下文）。

Step 6：AI 对话

1. 打开 http://192.168.4.1/aiconfig.html
2. 输入豆包 API 的 API Key 和 推理端点 ID
3. 点击保存
4. 打开 http://192.168.4.1/aichat.html
5. 输入消息发送，机器狗通过动作+表情+旋律回复

---

硬件一键测试清单

#	测试项	期望结果	排查方法
1	上电	OLED 显示 Logo，舵机归中	检查 3.3V/5V 供电
2	WiFi	手机搜到 MindPaw 热点	检查 ESP12F 是否启动
3	网页	访问 192.168.4.1 显示控制页	检查 Web 页面
4	舵机	握手动画	检查舵机供电 5V
5	OLED	表情切换	检查 I2C 接线
6	语音	说"你好"→机器狗回应	HLK-V20 是否已配置
7	扬声器	有旋律播放	检查三极管驱动
8	AI	聊天有回复	API Key 是否配置
9	摄像头	手势识别有输出	检查 SPI 共享 1KΩ
10	USB 供电	舵机能正常运动	检查 MicroUSB 线是否插紧，换 2A 以上充电器

---

配置 HLK-V20 语音模块

HLK-V20 是离线语音识别模块，首次使用需要配置。

准备工作

1. 下载 Hi-Link 语音配置工具（百度搜索 "SU-03T 配置工具"）
2. 准备一个 USB-TTL 模块

配置步骤

1. 用 USB-TTL 连接 HLK-V20：

   • USB-TTL TX → HLK-V20 RX
   • USB-TTL RX → HLK-V20 TX
   • GND → GND
   • 3.3V → VCC

2. 打开配置工具，设置：

   • 波特率：9600（默认）
   • 唤醒词：例如 "小狗小狗"
   • 命令列表：添加 22 条命令，每条的输出字符串设为 CMD1~CMD22

3. 命令对应关系：

触发词	输出	功能
前进	CMD1	前进
后退	CMD2	后退
左转	CMD3	左转
右转	CMD4	右转
停下	CMD5	停止
坐下	CMD6	坐下
趴下	CMD7	趴下
开心	CMD8	开心表情
生气	CMD9	生气表情
难受	CMD10	难过表情
好奇	CMD11	好奇表情
喜欢	CMD12	喜爱表情
睡觉	CMD13	睡觉
自由	CMD14	自由模式开关
抬左手	CMD15	抬左手
抬右手	CMD16	抬右手
时间	CMD17	显示时间
天气	CMD18	显示天气
标志	CMD19	显示 Logo
你好	CMD20	打招呼
再见	CMD21	告别
(其他)	CMD22	无效命令

4. 点击烧录
5. 完成后断电，按接线图接到 ESP12F

---

配置 AI Agent

MindPaw 通过火山引擎方舟 API 调用豆包大模型。

配置步骤

1. 访问 火山引擎方舟平台
2. 注册并登录账号
3. 创建一个推理接入点 (Endpoint)
4. 获取 API Key
5. 打开 http://192.168.4.1/aiconfig.html
6. 输入 API Key 和 Endpoint ID
7. 点击保存配置

---

项目文件参考

要做什么	看哪个文件
看整体接线	PIN_WIRING.md
导入 PCB 文件	Docs/01_Hardware_Guide.md
免费打样	Docs/02_PCB_Fabrication.md
改表情	Docs/03_Image_Conversion.md
烧录固件	Docs/04_Firmware_Flashing.md
组装接线	Docs/05_Assembly_Guide.md
快速体验（本文）	Docs/06_Quick_Start.md