项目预览
项目数据
项目介绍
Star 增长趋势
本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整
数据来源:GitHub API 逐日快照 · 收录于 2026-10-07 · 当前星标 ★ 5572
技术标签
使用教程
环境要求
- 支持 Arduino IDE 的电脑(Windows/macOS/Linux)
- NyBoard 主控板(本仓库对应 NyBoard_V1_0 等旧版平台)
- Bittle 或 Nybble 四足机器人套件与舵机
- USB 上传器及对应驱动(电脑无法识别串口时需安装)
- 可选:Petoi 蓝牙模块与手机 App 用于图形化校准
安装与启动步骤
-
1克隆仓库
从 GitHub 拉取 OpenCat 源码。若用网页下载 ZIP,解压后要把文件夹名里的 -main 后缀去掉。
git clone https://github.com/PetoiCamp/OpenCat-Quadruped-Robot.git -
2选择机型与主板
用 Arduino IDE 打开 OpenCat.ino,在开头宏定义里取消注释你的机器人型号和 NyBoard 版本,其余保持注释。
#define BITTLE #define NyBoard_V1_0 -
3进入配置模式
注释掉 #define MAIN_SKETCH,然后上传程序。上传成功后打开串口,按提示一步步完成初始化配置。
// #define MAIN_SKETCH -
4可选自动初始化
开启 AUTO_INIT 可跳过串口提问并自动校准 IMU,适合需要反复烧录的场景。首次调试建议先手动模式。
#define AUTO_INIT -
5上传固件
把 USB 上传器插到 NyBoard,装好驱动后点击 Arduino IDE 的上传按钮(→)等待烧录完成。
-
6设置串口监视器
串口监视器的行结束符选 no line ending,波特率设为 115200,否则交互提示不会正常响应。
-
7复位关节偏移并校准 IMU
按提示对 Reset joint offsets 和 Calibrate the IMU 回答 Y,把机器人平放在桌上,听到 6 声长鸣后等待校准写入。
Reset joint offsets? (Y/n) Y Calibrate the IMU? (Y/n): Y -
8切回主程序并校准关节
取消注释 #define MAIN_SKETCH 后重新上传。让机器人一侧朝上开机进入关节校准模式,或直接通过串口监视器校准。
#define MAIN_SKETCH
关键配置
| 配置项 | 必填 | 说明 | 示例 |
|---|---|---|---|
BITTLE / NYBBLE | 是 | 选择机器人型号,Bittle 为 9 自由度狗,Nybble 为 11 自由度猫。 | #define BITTLE |
NyBoard_V1_0 | 是 | 选择主板硬件版本,需与实际手上的 NyBoard 版本一致。 | #define NyBoard_V1_0 |
MAIN_SKETCH | 是 | 正常运行动作程序时开启;注释掉则进入串口配置模式。 | #define MAIN_SKETCH |
AUTO_INIT | 否 | 开启后跳过串口提问并自动校准 IMU,便于反复烧录。 | #define AUTO_INIT |
串口波特率 | 是 | 串口监视器通信速率,需与固件一致才能看到提示。 | 115200 |
行结束符 | 是 | 串口监视器需设为 no line ending,否则交互提示不响应。 | no line ending |
如何确认成功
串口监视器出现 Ready! 提示,且机器人能响应红外遥控或 Petoi App 指令完成动作。
常见问题
Q:我买的是 Bittle X 或 Nybble Q,能用这个仓库吗?
A:不能。本仓库对应旧版 NyBoard 平台,新一代硬件请改用 OpenCatESP32 仓库,那边才是当前活跃开发分支。
Q:串口监视器没有任何提示怎么办?
A:检查波特率是否为 115200、行结束符是否为 no line ending,并确认 USB 驱动已安装、串口未被其他软件占用。
Q:IMU 校准一直不成功?
A:校准期间必须把机器人平放在桌面上保持静止,等到 6 声长鸣后读取数据、保存偏移并在结束时鸣叫提示才表示完成。
Q:每次烧录都要重新配置吗?
A:可以定义 AUTO_INIT 跳过串口提问并自动校准 IMU,适合需要反复刷固件的调试阶段。
Q:手机 App 怎么用?
A:插入 Petoi 蓝牙模块后,用 iOS App Store 或 Google Play 上的 Petoi App 连接,可获得更直观的校准界面。
注意事项
- 下载 ZIP 包后务必删除文件夹名中的 -main 或分支名后缀,否则 Arduino 可能无法正常编译。
- 切换到 MAIN_SKETCH 前要先完成关节偏移复位和 IMU 校准,否则机器人动作会不准确。
- 关节校准需要让机器人一侧朝上开机进入校准模式,具体细节见官方校准指南。
- 本仓库为 legacy NyBoard 平台,新项目建议直接使用 OpenCatESP32 仓库。
核心亮点
- 提供现成四足步态与运动控制代码,省去从零推导逆运动学和调参的时间
- 软硬件生态完整,兼容 Arduino、树莓派等主控,并有配套套件与教程
- 支持积木编程和代码两种方式,兼顾教育入门与进阶开发
不足之处
- 硬件依赖较强,没有对应套件时移植和调试成本较高
- 高级 AI 与强化学习示例相对偏少,更多是基础运动控制
适用场景
- STEM 课堂或创客空间里搭建和编程四足机器人
- DIY 爱好者基于开源框架制作机器宠物
- 研究人员用其作为四足运动控制和物理 AI 的实验平台
替代项目
SpotMiniMini、Stanford Pupper
上一篇:OpenCat-Old
下一篇:UZonMail
同类项目推荐
Streamer-Sales
开源
输入商品,自动生成卖货话术并驱动数字人直播
Streamer-Sales 销冠 —— 卖货主播 LLM 大模型,一个能够根据给定的商品特点从激发用户购···
cx-core
开源
用大白话管 Linux,说人话就干活
CX Linux — AI-powered Linux OS. Natural language system administration for Ubuntu &···
naps2
开源
一键扫描成PDF,跨平台免费还带OCR
Scan documents to PDF and more, as simply as possible.
OpenCat-Quadruped-Robot
开源
用开源框架快速造一只会走会玩的机器狗
An open source quadruped robot pet framework for developing Boston Dynamics-style fo···
awesome-virtual-try-on
开源
虚拟试穿论文代码数据集一站找齐,省去全网翻找
A curated list of awesome research papers, projects, code, dataset, workshops etc. r···
sunnypilot
开源
让350款车的辅助驾驶按你的习惯来
sunnypilot is an open source driver assistance system. sunnypilot offers the user a ···
a-stock-data
开源
一站式获取 A 股全维度数据,让 AI 投研更稳更快
A股全栈数据工具包:行情K线·当日逐笔·研报·信号·资金面·新闻·财务·公告·打板·ET···
recruitops-agent
开源
本地跑招聘智能体,自动筛简历、匹配岗位、跟投递
Local-first recruitment intelligence and application operations agent
mod-llm-chatter
开源
给魔兽私服机器人装上大模型嘴,陪聊陪演更自然
AI-powered bot conversations for AzerothCore WotLK 3.3.5a - for mod-playerbots