SunFounder PiDog 树莓派机器狗(V1 / V2) 复刻全流程
SunFounder PiDog 树莓派机器狗(V1 / V2) 从采购、打印、组装到装软件、标定和训练的 55 个步骤,附物料表、购买链接与官方出处。
179.99 美元(SunFounder 官方商店,2026‑10‑31,美元标价,未打折);页面称免运费(部分地区另收)、从中国发货,进口关税由买家承担,未写是否含税。树莓派、microSD 卡与充电器需自备
采购
- 选择并购买兼容的 PiDog 套件
标准版兼容大多数 Raspberry Pi 型号,但伺服电机和 Robot HAT 不兼容 Raspberry Pi 5。V2 版兼容 Raspberry Pi 3/4/5 和 Zero 2W。
- 准备工具和零件
在开始组装前,准备好所需的所有工具和零件。
- 获取声源方向识别模块
模块配备3个麦克风,可检测各个方向的声音;TR16F064B负责处理声音信号并计算声源方向。
组装
- 检查所有零件和组件
组装前确认所有零件和组件齐全。若有缺失或损坏,请立即联系 [email protected]。
- 按照 PDF 组装说明操作
从文档提供的链接下载并阅读 PiDog 零件清单及组装说明,按照其中的步骤完成组装。
- 观看 PiDog V2 完整组装视频
观看适用于 Raspberry Pi 4 和 Raspberry Pi 5 的 PiDog V2 完整组装视频。视频步骤与印刷说明略有差异时,应优先遵循印刷说明;有不清楚之处可参考视频。
- 观看 PiDog V1 组装视频
观看从头组装 PiDog V1 的教程视频,该版本适用于 Raspberry Pi 4、3 和 1。视频与印刷说明不同时,以印刷说明为准。
- 组装机身和四条腿
按照视频 2 组装 Pidog 的机身和四条腿。
- 组装头部并进行校准
按照视频 3 组装 Pidog 的头部并进行校准。
- 优先遵循印刷说明
视频中的组装步骤可能与印刷说明略有不同,应优先遵循印刷说明;步骤不清楚时可查看视频。
- 安装 Raspberry Pi Zero 2W
如果主板是 Raspberry Pi Zero 2W,按照视频 4 将其安装到 PiDog 上。
- 从 2:28 继续组装
完成安装后,从视频 4 的 2:28 处继续按照说明完成组装。
- 重新组装 V1 腿部
如果装配后 PiDog V1 的腿部位置错误,重新运行归零脚本,将所有舵机重置为 0°,然后正确重新组装腿部。
- 检查 GPIO 焊接
问题经常由 GPIO 连接任一侧的焊接不良引起。
- 按引脚图连接模块
按照媒体1所示的引脚图连接声源方向模块与主控制器,并将模块的BUSY引脚连接至主控制器。
软件与固件
- 安装系统依赖
安装 git、python3-pip、python3-setuptools 和 python3-smbus 等系统依赖。
- 克隆并安装 robot-hat
克隆并安装 robot-hat。
- 克隆并安装 vilib
克隆并安装 vilib。
- 克隆并安装 pidog
克隆并安装 pidog。
- 按需运行音频设置脚本
如果需要,运行音频设置脚本。
- 安装工具
通过 apt 安装 git、python3-pip、python3-setuptools 和 python3-smbus。
- 安装 robot-hat 库
克隆 robot-hat 的 2.5.x 分支,进入目录并运行安装脚本。
- 安装 vilib 库
克隆 vilib 仓库,进入目录并运行安装脚本。
- 安装 pidog 库
克隆 pidog 仓库,然后使用 pip3 从 ~/pidog 安装该库。
- 运行 i2samp 脚本
进入 ~/pidog 目录,并使用 sudo 运行 i2samp.sh。
- 安装 Robot HAT
克隆 Robot HAT 2.5.x 分支并运行安装脚本。
- 安装 Vilib
克隆 Vilib 仓库并运行安装脚本。
- 安装 PiDog
克隆 PiDog 仓库,并使用 pip3 安装当前目录中的软件包。
- 使用 64 位 Raspberry Pi OS
出现 piper-tts 安装错误表示正在使用 32 位 Raspberry Pi OS。重新安装 64 位 Raspberry Pi OS 后,安装即可成功。
- 准备舵机零点归零环境
先安装 Raspberry Pi OS,再安装所需模块,然后运行脚本,将所有 PWM 引脚的角度设置为 0。
- 安装 Raspberry Pi OS
先安装 Raspberry Pi OS,以便执行舵机归零步骤。
- 安装所需模块
安装舵机归零脚本所需的模块。
- 实现BUSY握手和方向读取
先将BUSY置高以启动方向监测;BUSY变低后,按MSB优先发送16位任意数据并接收16位方向数据,最后再次将BUSY置高。
标定与测试
- 修复无声问题
如果没有声音,进入 robot-hat 目录并运行 i2samp.sh;如有需要可多次运行。
- 运行首个演示
进入 examples 目录并运行 1_wake_up.py。PiDog 将醒来、坐下并摇尾巴。
- 校准 PiDog 舵机
V1 和 V2 版本都必须进行舵机校准,以确保运动稳定并防止损坏。
- 使用 V2 归零按钮
按下 V2 Robot HAT 上的归零按钮,自动将所有舵机设置为 0°,无需运行脚本。
- 用按钮修正 V2 腿部
如果装配后 PiDog V2 的腿部位置不正确,例如舵机角度异常或机器人无法站立,可使用归零按钮修正。
- 运行 V1 舵机归零脚本
V1 版本使用脚本将所有舵机归零。运行给定命令后,所有舵机会设置为 0°。
- 安装前完成 V1 归零
应在安装前执行归零,确保每个舵机从正确的零位开始。
- 检查树莓派与 HAT 连接
如果归零按钮正常移动所有舵机,但校准脚本无法控制舵机,问题可能是树莓派与 Robot HAT 之间的硬件连接。
- 识别校准尺
PiDog 套装包含 90° 或 60° 校准尺。视频使用的是 90° 校准尺,60° 校准流程与之非常相似。
- 观看校准教程
参阅完整的校准教程视频,它会逐步演示如何准确校准 PiDog。
- 运行 PiDog 校准
按照图示放置 PiDog,进入示例目录并运行校准脚本。
- 使用 60° 校准尺进行校准
如果使用 60° 校准尺,请按照 60° 校准图示完成校准。
- 使用 90° 校准尺进行校准
如果使用 90° 校准尺,请按照 90° 校准图示完成校准。
- 保存校准后的舵机设置
完成校准后,记录舵机角度或导出配置文件,以避免将来再次校准并便于快速恢复设置。
- 连接舵机线并执行归零
完成上述准备后插入舵机线,使舵机归零,然后才能固定舵机。
- 运行舵机归零脚本
运行脚本,将所有 PWM 引脚的角度设置为 0。
- 连接舵机并归零
然后插入舵机线缆,使舵机归零;固定每个舵机前都要先完成此步骤。
- 确认示例目录位置
如果遵循文档操作,示例通常位于 ~/pidog/examples/。
- 根据本地环境调整假设
使用默认的系统 Python,并确认 pip3 install . 已使 import pidog 正常工作;如果实际路径或导入名称不同,应先确认本地布局。
- 验证方向数据范围
记录模块返回的方向值,确认其范围为0~360,最小识别单位为20度。
用起来
- 体验内置动作和声音
运行功能演示脚本,然后输入数字触发相应的动作。
- 使用返回角度判断声源
运行时读取模块返回的16位方向数据,并将其作为声源相对于模块的方向。
常见问题
物料
- 树莓派自备:5、4、3B+/3 或 Zero 2W(V1 不支持树莓派 5);microSD 卡至少 16 GB、建议 32 GB
- 12 个金属齿轮舵机,铝合金机身
- Robot HAT:V2 为 V5 版(12 路 PWM、I2S 音频与 2030 腔体扬声器、MEMS 麦克风、6.0–8.4V 电源输入、Type‑C 充电、舵机归零按键);V1 为 V4 版(7–12V 输入)
- OV5647 摄像头、超声波模块、TTP223 双路触摸、SH3001 六轴 IMU、TR16F064B 声源方向传感器、SLED1735 驱动的 11 颗 RGB 灯板
- 电池经 Robot HAT 的 Type‑C 口充电,建议 5V 3A 充电器(自备),可边充边用
工具
- 按纸质说明书组装(文档称以纸质说明书为准,组装视频作补充)
- 电脑经 SSH 远程登录树莓派(文档附 OpenSSH、FileZilla 与远程桌面教程)
- 用 Zero 2W 时需自行焊接 40 针排针(FAQ)
技能
- 安装树莓派 OS(选 64 位,piper-tts 只提供 64 位预编译包)与命令行
- 舵机归零与校准:V2 按 Robot HAT 归零键,V1 运行 servo_zeroing.py
- Python 示例与 OpenCV / MediaPipe 视觉
- 大模型 API Key 配置与 Ollama 本地模型
软件
- pidog Python 库 1.4.0(2026‑09 加入 SH3001 IMU 校准;LICENSE 为 GPL‑2.0,pyproject 分类写 GPLv3)
- robot-hat(GPL‑3.0,2.5.x 分支)与 vilib 视觉库(GPL‑2.0)
- 示例:唤醒、巡逻、人脸追踪、俯卧撑、嚎叫、平衡、小球追踪、键盘与 App 控制
- AI:Espeak、Pico2Wave、Piper、OpenAI TTS,Vosk 离线识别,Ollama 与在线大模型,OpenClaw 技能