正在连接信源…

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,验证电机配置是否正确并将电机归零。

文档