正在连接信源…

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位方向数据,并将其作为声源相对于模块的方向。

常见问题

  • 新版 Raspberry Pi 的兼容性和依赖冲突阻碍安装设置 #3 #5
  • 错误的 I2C 调试设置导致 PiDog 示例程序无法运行 #1
  • 自定义动作的保存命令没有可见反馈 #4
  • ALSA 音频欠载使应用崩溃并断开机器人连接 #10
  • 故障的 PWM 引脚导致舵机停止工作 #11

物料

  • 树莓派自备: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 技能

文档