Freenove 树莓派机器狗套件(FNK0050) 的做法
Freenove 树莓派机器狗套件(FNK0050) 的 220 个步骤,附出处文档。
FNK0050 129.99 美元(Freenove 官方商店,美元,2026‑10‑31,标有货,免标准运费,可能需付关税与增值税);不含树莓派、两节 18650 电池与充电器,这些官方未给参考价
采购
- 核对树莓派机器人扩展板
核对机器人扩展板的顶部和底部。
- 核对机械零件和螺钉
核对机械零件。随附的塑料袋内含 M1.2*7 螺钉;若找不到自攻螺钉包装,可能装在舵机包装内。
- 核对十二个 ES08MA 舵机
核对 ES08MA Ⅱ 舵机包装,数量为 x12。
- 核对一个 S90 舵机
核对 S90 舵机包装,数量为 x1。
- 核对亚克力零件
核对清单中所示的亚克力零件。
- 核对 LED 模块
核对清单中的 LED 模块。
- 核对摄像头
核对摄像头,数量为 x1。
- 核对超声波模块
核对 HC-SR04 超声波模块,数量为 x1。
- 核对 V1.0 连接板
核对 PCB_V1.0 连接板。连接板有两种型号,需记住其版本号。
- 核对 V2.0 连接板
核对 PCB_V2.0 连接板。连接板有两种型号,需记住其版本号。
- 核对超声波模块跳线
核对超声波模块用的 F/F 跳线,数量为 4。
- 核对 LED 排线
核对 10cm、3Pin、同一方向的 LED 排线。
- 核对摄像头排线
核对 25cm、15Pin、反向的摄像头排线。
- 核对 FPC 软线
核对 FPC 软线,数量为 x1;该线仅随树莓派 5 版本提供。
- 核对两把十字螺丝刀
核对 3mm 十字螺丝刀 x1 和 2mm 十字螺丝刀 x1。
- 核对理线扣
核对长度 80cm 的理线扣。
- 核对红球
核对清单中的红球。
- 购买两块18650锂电池
购买两块不带保护板的3.7V 18650锂电池,持续放电电流应大于10A。
- 购买一台树莓派
购买一台树莓派,推荐型号为Raspberry 5、4B或3B+。
- 选择 Raspberry Pi 3 Model B
此产品支持 Raspberry Pi 3 Model B,文档提供实物图和 CAD 图。
- 选择 Raspberry Pi 2 Model B
此产品支持 Raspberry Pi 2 Model B,文档提供实物图和 CAD 图。
- 选择 Raspberry Pi 1 Model B+
此产品支持 Raspberry Pi 1 Model B+,文档提供两张实物图。
- 选择 Raspberry Pi 3 Model A+
此产品支持 Raspberry Pi 3 Model A+,文档提供实物图和 CAD 图。
- 选择 Raspberry Pi 1 Model A+
此产品支持 Raspberry Pi 1 Model A+,文档提供两张实物图。
- 选择 Raspberry Pi Zero W
此产品支持 Raspberry Pi Zero W,文档提供实物图和 CAD 图。
- 选择 Raspberry Pi Zero
此产品支持 Raspberry Pi Zero,文档提供实物图和 CAD 图。
- 选择适配树莓派的可选组件
根据所用的 Raspberry Pi 型号选择可选组件。
- 准备显示器所需附件
如果使用独立显示器、鼠标和键盘,请准备表中列出的所需附件。Pi Zero 和 Pi Zero W 还需要其对应的附加附件。
- 准备远程桌面所需附件
根据所用的 Raspberry Pi 型号,准备远程桌面连接所需的附件。
- 准备两节 18650 锂电池
准备两节不带保护板的 18650 锂电池,持续放电电流应大于 10A。
- 准备 Raspberry Pi
准备一台 Raspberry Pi,推荐型号为 Raspberry 5、4B 或 3B+。
- 按型号匹配电源
根据树莓派型号选择推荐电源:Pi 5 使用 5.0A,Pi 4B 和 Pi 400 使用 3.0A,Pi 3 系列使用 2.5A,Pi 2B 使用 1.8A,Zero W 使用 1.2A,Zero 2 W 使用 2A。Pi 5 连接可输出 5A、+5V(25W)的电源时,可向下游 USB 外设提供 1.6A;使用其他兼容电源时限制为 600mA。
- 阅读电池说明
先解压下载的项目文件,然后阅读解压文件夹中的 About_Battery.pdf。
- 下载并解压项目文件
如果尚未下载项目 ZIP 文件,请通过页面提供的 GitHub 链接下载并解压。
- 购买机器人套件
访问 Freenove 商店页面购买机器人套件。
组装
- 保持电池极性正确
组装和使用机器人时不要反接电池,否则主板可能损坏。
- 取出12个舵机圆盘臂
从舵机包装中取出12个圆盘舵机臂。
- 选择间距较长的孔位
圆盘舵机臂上有4对相对孔,各孔对的间距不同。请使用间距较长的2对孔。
- 准备M1.2*7自攻螺丝
M1.2*7螺丝装在随附的塑料袋中。如果找不到该规格的螺丝包,它可能装在舵机包装内。
- 准备接下来的4个零件
取出图中所示的4个零件。
- 安装机身支架
按照图示安装机身支架。
- 安装屏蔽罩
按照图示安装屏蔽罩。
- 安装 MPU6050
插件板有两排排针,将 MPU6050 插入外侧一排。
- 安装顶部支架
安装顶部支架。
- 连接 LED 模块
将扩展板与 LED 模块连接。此连接结构会便于后续组装。
- 安装 Raspberry Pi
使用四颗 M2.5x8 螺钉将 Raspberry Pi 固定在机器狗上。
- 安装连接器
安装连接器,用于连接 Raspberry Pi 和扩展板。
- 安装连接板
连接板有 PCB_V1.0 和 PCB_V2.0 两种类型,但安装方式相同。
- 完成主体现组装
至此主体现已组装完成,腿部零件将在之后组装。
- 将舵机安装到亚克力板
将舵机安装到亚克力板上。
- 区分四种不同零件
共有四种零件,它们彼此不同。
- 组装两套零件
组装其中两套零件。
- 将零件组装到顶部
将零件组装到顶部。
- 得到两套关节零件
完成组装后得到两套关节零件。
- 组装另外两个零件
组装另外两个零件,它们与前面的零件不同。
- 再组装两个零件
再组装两个零件,它们与前面的零件不同。
- 组装这些零件
将前面组装好的零件组合在一起。
- 完成四个不同零件
完成后会得到图示的四个零件,它们彼此不同。
- 连接舵机并安装电池
将12个黑色舵机和1个蓝色舵机随机连接到舵机端口。安装电池,并将电池推向“+”端。
- 为树莓派供电并打开开关
仍可使用电缆为树莓派供电。按下S1和S2,两个指示灯将点亮。
- 完成第一章的前置步骤
打开树莓派,确认第一章的三个步骤均已正确完成。如果尚未完成,应先执行第一章的步骤。
- 将舵机连接到盘形臂
将舵机连接到盘形臂。组装期间保持供电并连接所有舵机,不要断开舵机。
- 以90度连接舵机臂
保持电源开启、所有舵机连接到扩展板,不要断开接线。连接舵机臂时将舵机保持在90°,尽量接近90°安装,可接受范围为65~115。
- 组装一侧的腿
组装一侧的腿,尽量以90°安装。角度允许在65~115范围内。
- 组装另一侧的腿
组装另一侧的腿。
- 安装后腿和舵机螺丝
从不同侧选择两条腿作为后腿,按图示安装,然后安装舵机螺丝。
- 安装螺丝时关闭负载开关
如果安装前未用胶带覆盖孔,可关闭Load S1以安装螺丝。螺丝安装完成后,重新打开Load S1。
- 安装前腿和舵机螺丝
组装前腿并安装舵机螺丝。
- 完成前腿组装
完成前腿的组装。
- 安装后恢复负载开关
安装螺丝后打开Load S1。
- 组装机器人头部
使用蓝色舵机包中包含的舵机臂和螺钉组装头部。
- 将头部安装到机身
安装舵机臂时保持电源开启且舵机保持连接。随后关闭树莓派,在第3章之前不要再次开启。
- 连接舵机和超声波模块
按照编号连接舵机,舵机端口0、1和14未连接,属于备用端口。连接超声波模块时不要接错,尤其不要将5V连接到GND,否则可能损坏模块。
- 连接Pi3或Pi4摄像头
插拔摄像头排线时必须关闭树莓派电源,否则摄像头模块可能烧坏。连接时注意排线的蓝色侧。
- 连接Pi5摄像头排线
此排线仅随购买Raspberry Pi 5版本的套件提供。将排线一端连接到树莓派,并注意排线正面和背面的方向。
软件与固件
- 在 Raspberry Pi 5 上使用 SPI MOSI
在 Raspberry Pi 5 上,rpi-ws281x-python 无法正常工作,LED 改用 SPI MOSI 引脚通信,因此 SCK 和 MISO 引脚不能再用于其他用途。
- 安装树莓派系统
先为树莓派安装系统。推荐使用 Raspberry Pi 5、4B 或 3B+,并准备 5V/3A 电源适配器、Micro USB 电缆、Micro SD 卡和读卡器。
- 选择树莓派设备
根据树莓派版本选择设备,使系统筛选器显示适合该版本的镜像。
- 选择下载的系统镜像
打开“Operating System”,在“Use custom”中选择刚下载的系统。
- 选择 SD 卡并继续
选择要写入系统的SD卡,然后单击“Next”。
- 配置树莓派
根据实际需要配置树莓派。
- 启用 SSH 并配置 WiFi
在“GENERAL”页面填写实际信息,并在“SERVICES”页面启用SSH。
- 保存并写入系统
单击“Save”,在新屏幕中单击“Yes”,等待系统写入SD卡。
- 连接显示器和输入设备
通过HDMI连接显示器,通过USB连接鼠标和键盘,并通过网口连接网络电缆,最后连接符合树莓派模块版本规格的电源。
- 登录 Raspberry Pi OS
启动树莓派并输入默认用户名“pi”和密码“raspberry”登录。
- 连接 WiFi
Raspberry Pi 5、4B、3B+/3B可使用内置WiFi适配器连接无线网络;其他型号可使用外置USB无线网卡。
- 设置 VNC 缩放
在 VNC Viewer 控制面板中右键单击,选择 Properties→Options→Scaling,然后设置适当的缩放。
- 连接树莓派 Wi-Fi
树莓派 5/4B/3B+/3B 集成有 Wi-Fi 适配器;如果尚未连接 Wi-Fi,可连接后无线控制机器人。
- 选择远程桌面访问方式
如果已通过显示器登录树莓派,可直接跳到 VNC Viewer;如果没有备用显示器、鼠标和键盘,可使用远程桌面与电脑共享显示、键盘和鼠标。
- 通过 SSH 登录树莓派
打开终端并运行命令;如果本地主机名连接无效,可继续使用下一页中的 IP 地址方式。
- 输入树莓派登录凭据
默认密码为 raspberry,并且区分大小写;连接过程中可能需要输入 yes。
- 使用 IP 地址登录
可以在路由器客户端中查找名为 raspberry pi 的设备 IP 地址,然后使用该地址登录。
- 确认 SSH 登录成功
看到 pi@raspberrypi:~ $ 提示符即表示已成功登录树莓派,然后可以进入下一节。
- 在 Windows 查询树莓派 IP
在 Windows 10 中按 Win+R,输入 cmd,然后使用指定命令检查树莓派 IP 地址。
- 从路由器查询 IP 地址
也可以在路由器客户端中查找名为 raspberrypi 的设备;文档中的示例 IP 地址是 192.168.1.95。
- 通过 SSH 连接到树莓派
输入树莓派的实际 IP 地址进行 SSH 登录。
- 启用树莓派 VNC
运行 sudo raspi-config,然后依次选择 Interface Options→P5 VNC→Enter→Yes→OK。
- 重启并打开 VNC
树莓派可能需要重启;重启时选择 ok,然后打开 VNC 界面。
- 下载安装 VNC Viewer
根据电脑操作系统,通过文档给出的链接下载并安装 VNC Viewer。
- 创建 VNC 连接
安装完成后打开 VNC Viewer,点击 File→New Connection。
- 填写树莓派连接信息
输入树莓派的 IP 地址并填写连接名称,然后点击 OK。
- 使用 VNC Viewer 登录树莓派
在 VNC Viewer 面板中双击新建的连接,输入用户名 pi 和密码 raspberry,然后单击 OK。
- 启动树莓派并安装必要库
使用带桌面环境的 Raspberry Pi OS 启动树莓派并安装必要的库;安装过程中可通过电源线供电。
- 打开终端获取代码并设置 Python3
先通过电源线或 S1 电源开关为树莓派供电,然后打开树莓派桌面和终端,以下载代码并将 python3 设为默认版本。
- 打开 Raspberry Pi 终端
在桌面按下“CTRL + ALT + T”打开终端。
- 下载机器人狗代码
进入用户主目录,依次执行命令,从 GitHub 克隆机器人狗项目代码。下载可能需要较长时间。
- 检查默认 Python 版本
运行`python`检查 Raspberry Pi 当前默认的 Python 版本,完成后按 Ctrl-Z 退出。如果已经是 python3,则跳过后续的默认 Python 设置步骤。
- 进入 Python 链接目录
如果默认版本是 python2,进入`/usr/bin`目录。
- 删除原来的 Python 链接
使用管理员权限删除原来的`python`链接。
- 创建新的 Python 链接
创建一个名为`python`的新链接,使其指向`python3`。
- 使用终端快捷键
使用上下方向键浏览命令历史;使用 Tab 自动补全命令或路径,存在多个匹配项时可再次按 Tab 列出候选项。
- 启用 I2C、SPI 和 VNC
在 Raspberry Pi 配置中启用 I2C、SPI 和 VNC。I2C 接口默认禁用,需要手动打开。
- 按连接板版本配置 SPI
连接板版本为 V2.0 时启用 SPI 功能;连接板版本为 V1.0 时关闭 SPI 功能。
- 打开树莓派配置文件
在终端中打开 /boot/firmware/config.txt。
- 将 I2C 波特率设为 400000
找到 dtparam=i2c_arm=on,并添加 i2c_arm_baudrate=400000。按 CTRL+O、Enter 保存,再按 CTRL+X 退出。
标定与测试
- 配置 Raspberry Pi
根据实际需要配置 Raspberry Pi。
- 填写常规设置
在 GENERAL 页面根据实际情况填写信息。
- 启用 SSH 服务
在 SERVICES 页面启用 SSH。
- 保存并写入系统
点击 Save,在新页面点击 Yes,然后等待系统写入 SD 卡。
- 登录 Raspberry Pi
系统启动并完成设置后,使用默认用户名 pi 和密码 raspberry 登录。
- 确认系统安装成功
登录后查看 Raspberry Pi OS 桌面,确认操作系统已成功安装。
- 连接 Wi-Fi
Raspberry Pi 5、4B、3B+/3B 内置 Wi-Fi 适配器,可用它连接 Wi-Fi,以便使用无线远程桌面。
- 其他型号使用 USB 无线卡
其他型号的 Raspberry Pi 可以使用外接 USB 无线卡进行无线远程桌面连接。
- 确认远程桌面设置
确认已通过 VNC Viewer 成功登录 Raspberry Pi,并完成适当的显示设置。
- 设置显示分辨率
如果出现黑色窗口,请设置分辨率;不知道合适设置时可尝试 1920x1080。
- 调整 VNC 缩放比例
在 VNC Viewer 控制面板中右键单击,选择 Properties->Options->Scaling,然后设置合适的缩放比例。
- 将所有舵机保持在90度
程序运行后,所有舵机将保持在90°。
- 检查连接器连接
如果程序报告“Remote I/O error”,检查连接器是否连接良好。
- 检查两个负载开关
如果程序报告“Remote I/O error”,确认S1和S2均已打开。
- 检查电池盒接触
如果程序报告“Remote I/O error”,检查电池与电池盒是否接触良好。
- 开启两个开关并运行校验命令
打开两个开关,进入 Server 目录并运行 Servo.py 脚本。
- 姿势不符时拆装舵机螺钉
机器人应呈现图示姿势;若不符合,需要拆下错误舵机的螺钉并重新装配该舵机,使机器人呈现上述姿势。
- 将树莓派连接到广域网
使用以太网网络电缆将树莓派连接到广域网(WAN)。
- 设置显示分辨率
设置需要的显示分辨率;不确定时可尝试1920x1080。
- 调整 VNC 缩放
如果VNC Viewer窗口对树莓派桌面进行了缩放,可更改该缩放设置。
- 验证新的默认 Python
再次运行`python`检查链接,完成后按 Ctrl-Z 退出。
- 检查 I2C 模块是否启用
运行 lsmod | grep i2c;如果 I2C 模块已启用,终端会显示相关内容。设备上的数字可能不同。
- 打开电源并检查指示灯
打开 Raspberry Pi。断开电源线后,电池会为 Raspberry Pi 供电;按下 S1 和 S2 后,两个指示灯会亮起。
- 启用 I2C 和 VNC
Raspberry Pi 的 I2C 接口默认处于禁用状态。需要手动将其打开。
- 检查 I2C 模块状态
运行 lsmod 并筛选 i2c,检查 I2C 模块是否已启用。模块启用后会显示相应内容,设备上的编号可能不同。
- 测试 I2C 通信
智能小车板包含 PCF8591 和 PCA9685 两个芯片,其 I2C 地址分别为 0X48 和 0X40。运行 i2cdetect 检测开发板是否已成功连接到 Raspberry Pi,连接的设备会显示其 I2C 地址。
- 禁用 Raspberry Pi 音频模块
除 Raspberry Pi 5、4B 和 400 之外的型号需要禁用音频模块,否则 LED 将无法正常工作。编辑 snd-blacklist.conf,添加 blacklist snd_bcm2835,然后按 Ctrl+O、Enter、Ctrl+Z 保存。
- 查看 GPIO 编号对应关系
运行该命令,查看 BCM、物理位置和 WiringPi GPIO 编号之间的对应关系。
常见问题
物料
- Robot Shield 扩展板:PCA9685 16 路舵机驱动(精度 0.09°)、ADS7830、蜂鸣器、4 灯电量指示、超声波与 MPU6050 接口;连接板有 V1.0 与 V2.0 两版(V2 的 LED 控制脚由 GPIO18 改到 GPIO10,以适配树莓派 5)
- 舵机:ES08MA II ×12(腿)、S90 ×1(头)
- 树莓派摄像头、HC‑SR04 超声波、MPU6050、RGB LED 模块;树莓派 5 版另附 FPC 摄像头排线
- 亚克力机身与机械件、红色追踪小球、3 mm 与 2 mm 十字螺丝刀、80 cm 理线带
- 需另购:树莓派(推荐 5 / 4B / 3B+ / 3B / 3A+)、两节无保护板高倍率 18650(持续放电大于 10 A)及充电器
工具
- 套件附十字螺丝刀,教程中无焊接步骤
- 树莓派所需的 microSD 卡、读卡器与电源,显示器或 SSH/VNC 远程桌面
- 18650 充电器;校准纸用仓库里的 Calibration_Graph.pdf
技能
- 树莓派系统烧录、SSH/VNC 与命令行
- Python 3:树莓派服务端与 PyQt5 + OpenCV 客户端
- 舵机归中后装腿,再按校准纸调四条腿
软件
- Code/Server:树莓派端 Python 服务端(舵机、IMU 平衡、超声波、LED、摄像头),2025‑12 仍有更新
- Code/Client:PyQt5 + OpenCV 电脑客户端(人脸识别、追球、校准),另附 Windows 与 macOS 可执行版
- Freenove App(Android 5.0+、iOS 10+)
- GitHub Release V1.0 / V1.1(2024‑12):分别对应 bullseye 与树莓派 5 的 bookworm 系统