ElectroPup 复刻全流程
ElectroPup 从采购、打印、组装到装软件、标定和训练的 60 个步骤,附物料表、购买链接与官方出处。
ElectroPup 是一款采用低成本无刷直流电机的四足机器人。仓库提供可打印的三维模型、CAD 设计、电路板资料以及组装和设置指南。
采购
- 开始前阅读完整指南
在开始设置前阅读整个指南,因为文档可能不是按顺序排列的。
- 安装 Git
在树莓派上使用 apt 安装 git。
- 克隆 ElectroPup 仓库
使用 git clone 从 GitHub 克隆 ElectroPup 仓库。
- 获取双通道隔离 CAN HAT
Use the Waveshare 2-Channel Isolated CAN Expansion HAT as the CAN bus controller.
打印与加工
- 在 KiCad v8 中设计 PCB
使用 KiCad v8 设计辅助板和电源载板;项目使用的自定义库可从 reubenstr/kicad-libraries 获取。
- 设计辅助板
为辅助板加入 STM32 协处理器、LCD 错误与状态显示、蜂鸣器、2 个 Neopixel 灯带、1 个 RC 舵机、1 个按钮,以及 BNO055 IMU、SBUS FrSKY 接收机输入、I2S 和 4 个接触开关或辅助 GPIO 扩展口。
- 设计电源载板
为电源载板加入执行器电源分配、执行器 CAN 总线网络、Raspberry Pi 隔离式 DC-DC、主电源开关、电池座和电源连接。
- 制造 KiCad 设计的 PCB
PCB 使用 KiCad v8 设计,并由 JLCPCB 制造。
- 使用 PolyMax Tough PLA 打印零件
Print the robot's 3D-printed parts using Polymaker PolyMax Tough PLA.
组装
- 连接电源载板
电源载板带主电源开关,并将电源分配到电机接头。它为每条腿建立一个 CAN 总线,共四个;焊接跳线可将前两条腿合并为一个网络、后两条腿合并为另一个网络。
- 安装可选辅助板
辅助板是可选的,四足机器人无需它即可运行。辅助板可通过接线端子为 RPi 供电,并提供 LCD 显示屏、可变音调蜂鸣器、NeoPixel 灯带、RC 舵机通道、I2C 扩展,以及用于控制 LCD 并在断电前关闭 Raspberry Pi 的按钮。
- 连接辅助板扩展设备
辅助板可直接连接 BNO055 IMU、4 路触点输入或 GPIO、供未来使用的 I2S 声音驱动,以及 SBUS 接收机。若 BLE 游戏手柄在射频拥塞区域失效,可使用 SBUS 连接的遥控发射器。
- 连接并使用 CAN 电机通道
每个 CAN 控制器驱动六个电机,平均电机更新速率约为 70 Hz。更新内容包括获取编码器位置、设置目标角度或速度以及获取错误状态。
- 连接 STM32 辅助板
使用 STM32F401 Black Pill 开发板运行辅助板。辅助板在 LCD 上显示电机和系统状态,并连接蜂鸣器等外设。
- 组装 6S1P 锂电池组
使用 Sanyo 品牌、额定容量为 3250mAH 的 18650 电芯制作带负载均衡 BMS 的定制 6S1P 锂离子电池组,其估算容量为 72Wh。
- 安装 HXYP-6S-CW15 BMS
电池组使用 HXYP-6S-CW15 BMS。
- 安装树莓派操作系统
Use Raspberry Pi Imager to select Raspberry Pi OS Lite, Bookworm 64-bit for the Raspberry Pi 5.
- 配置树莓派网络和账户
设置主机名为 electropup,用户名和密码为 pi,SSID 和密码使用你的 Wi-Fi 凭据。
软件与固件
- 安装 VSCode 和扩展
在开发 PC 上安装 VSCode 以及 Remote Explorer 扩展。
- 连接树莓派并安装 Python
完成树莓派设置后,使用 Remote Explorer 连接树莓派,并安装 Python 扩展。
- 选择 Python 解释器
使用 Ctrl+Shift+P 打开命令面板,运行“Python: Select Interpreter”,并选择类似 Python 3.13.5 的解释器路径。
- 重新加载窗口
使用 Ctrl+Shift+P 打开命令面板,然后运行“Reload Window”。
- 复制 SSH 密钥并登录
将开发 PC 的密钥复制到树莓派,然后使用 [email protected] 登录。
- 更新树莓派软件包
登录树莓派后运行 sudo apt update 更新软件包。
- 生成并查看 SSH 密钥
生成 SSH 密钥时按三次 Enter 使用默认设置,然后读取 ./.ssh/id_rsa.pub 公钥。
- 将公钥添加到代码托管服务
可选地将生成的公钥添加到 GitHub、GitLab 或其他类似服务。
- 安装 CAN 工具
安装 can-utils,用于检查 CAN 通信。
- 扫描并配对控制器
在 Raspberry Pi 上运行 bluetoothctl 并开始扫描,按住 PS + Share 直到闪烁。
- 配对并连接控制器
关闭扫描,使用扫描到的 MAC 地址配对、信任并连接控制器,然后列出设备。
- 启用辅助板串口
串口用于可选的辅助板。在 /boot/firmware/config.txt 中追加 enable_uart=1 和 dtoverlay=uart0。
- 启用 I2C
使用 raspi-config 启用 I2C。
- 进入 UI 源码目录
进入 ElectroPup 的 src/ui 目录。
- 启动 UI 服务器
使用 server.sh 启动 UI 服务器。
- 启动辅助板心跳程序
使用辅助板时,运行 heartbeat.sh。
- 以开发模式运行主程序
使用 --dev 参数运行主程序。
- 选择开发或实时模式
--dev 禁止启用电机并以行走步态启动;--live 允许启用电机,并以坐姿启动。
- 使用开发辅助参数
可向主服务传递 --start、--stop、--restart 和 --disable 参数。
- 安装主服务
进入 ElectroPup/src/setup,并运行 install_main.sh 安装主服务。
- 安装 UI 服务器服务
运行 install_server.sh 安装 UI 服务器服务。
- 安装心跳服务
运行 install_heartbeat.sh 安装辅助板的心跳服务。
- 检查服务状态
以 main.service 为例,使用 systemctl status 查看服务状态。
- 停止服务
以 main.service 为例,停止该服务。
- 启动服务
以 main.service 为例,启动该服务。
- 重启服务
以 main.service 为例,重启该服务。
- 实时查看服务日志
使用 journalctl 实时查看 main.service 的日志。
- 配置树莓派 WiFi 热点
在 .bashrc 中添加 WiFi SSID 和密码环境变量,以便树莓派不在 WiFi AP 附近时创建用于 SSH 和 UI 访问的热点。手柄按键绑定图显示了创建热点及重新连接 WiFi AP 的命令。
- 生成贝塞尔轨迹图
使用贝塞尔曲线、正弦弧和曲率投影生成轨迹。运行绘图脚本可输出示例控制点配置。
- 绘制曲率投影图
通过将线性轨迹投影到曲线上实现旋转。脚本输出示例投影计算的图表。
- 启动 MuJoCo 仿真
运行仿真脚本,在 MuJoCo 中启动 ElectroPup。当前仅提供游戏手柄输入;由于 ElectroPup.xml 没有近似质量和惯性参数,仿真四足机器人会较为弹跳。
- 配置机器人游戏手柄
ElectroPup 以 PS4 控制器为默认手柄。使用 xBox、PS5 或 Logitech 手柄时,需要进行少量软件修改。
- 准备 PC 开发环境
准备运行 Ubuntu Desktop 或其他 Linux 发行版的台式机或笔记本电脑。软件包括 VSCode(Remote SSH 和 PlatformIO 扩展)、Drawio、LibreOffice、KiCad、OrcaSlicer 和 Chrome 或 Firefox。
- 准备 Raspberry Pi 运行环境
Use a Raspberry Pi 5 for the quadruped hardware driver. Install Raspberry Pi OS Lite Bookworm 64-bit and perform all development through remote SSH.
- 配置 STM32 开发工具
在 PC 或笔记本电脑上使用带有 PlatformIO 的 VSCode 开发 STM32 辅助板。
标定与测试
- 配置 CAN 接口
启用 can0 和 can1 接口,并将位速率设置为 1000000。
- 检查 CAN 接口
运行 ifconfig 检查接口。
- 运行 CAN 回环测试
可选:连接 can0 和 can1 后,在终端 1 运行 candump,在终端 2 运行三条 cansend 命令。
- 重置游戏控制器
先为控制器上电,然后按下控制器背面右侧孔内的按钮进行重置。
- 重新启动并测试游戏手柄
重新启动控制器。可选安装 joystick,并使用 jstest /dev/input/js0 进行测试。
- 扫描连接的 I2C 硬件
安装 i2c-tools,列出 /dev/i2c-* 并运行 i2cdetect -y 1,也可使用 scanner 脚本。
- 运行电机归零脚本
运行 zero-motors.py,验证电机配置是否正确并将电机归零。