硬件 v1.0 · 使用说明
使用说明
上电与按键
操作 | 行为 |
|---|---|
开机 | 初始化屏、舵机 Home、灯、ADC |
**单击 BOOT** | 启动阶段：进入 Wi‑Fi 配网；正常后：切换聊天/聆听 |
**双击 BOOT** | 入队前摆动作 `Front()`，然后 Home |
RST | 硬件复位 |
Wi‑Fi / 小智配网
1. 首次或单击进入配网模式（屏上一般有提示）
2. 手机连接设备热点或按产品说明用蓝牙/BluFi（以当前小智版本为准）
3. 填入家里 Wi‑Fi；设备连上服务器后即可语音对话
具体后台与激活流程见仓库主文档 / 小智官方说明。
语音与动作
连上云端且角色启用 MCP 后，可说例如：
- 「向前走」「后退」「左转」「右转」
- 「坐下」「站起来」「伸展一下」「摇摆」
- 「跳舞」「趴下」
- 「抬左前腿」等
云端通过工具名调用设备侧接口。
MCP 工具一览
机器狗 `self.dog.*`
工具 | 说明 | 主要参数 |
|---|---|---|
`walk` | 直线进退 | `steps`, `speed`, `direction`(1 前 / -1 后) |
`turn` | 原地转向 | `steps`, `speed`, `direction`(1 左 / -1 右) |
`sit` / `stand` | 坐下 / 站立 | `speed` |
`stretch` | 伸展 | `speed` |
`lay_down` | 趴下 | `speed` |
`shake` | 摇摆 | `speed` |
`dance` | 跳舞组合 | `speed` |
`lift_*_leg` | 抬单腿 | `speed`, `height` |
`set_trim` / `get_trims` | 舵机微调 | 见组装文档 |
`stop` | 清空队列并 Home | — |
`get_status` | `moving` / `idle` | — |
`speed` 多为周期毫秒：**数值越大越慢**（约 500～2000）。
灯带 `self.led_strip.*`
工具 | 说明 |
|---|---|
`set_all_color` | 整段同色 RGB |
`set_pixel` | 单像素 |
`clear` | 全灭 |
`blink` | 同色闪烁 |
`chase` | 跑马灯 |
灯珠数由 `BUILTIN_LED_STRIP_PIXELS`（默认 8）决定。
电量显示
- GPIO38 + 10k/4.7k 分压
- 舵机大动作时采样可能跳过（避免压降误判）
- 低电阈值见 `config.h`：`BAT_ADC_LOW_WARN_*`、`BAT_ADC_SOC_*`
- 换电池规格后务必重新标定 EMPTY/FULL 引脚电压
角色提示词（可选）
可在小智后台为设备配置身份，例如：
> 你是一只可爱的四足机器狗，有四条舵机腿。用户让你走动或做动作时，先调用对应的 `self.dog.*` 工具再口头回应。高兴时可顺便用灯带换颜色。
日常注意
- 电量低时减少剧烈步态，先充电
- 地毯/光滑地面步态表现不同，可改 `ST7789V3_DOG_WALK_SWING_DEG` 等宏重新编译
- OTA 后若行为异常，串口确认 `board_type=dog_dance` 是否仍为本板固件
评论
1 条评论加载登录状态…
创客阿强
登录后评论测试