PetoiCamp/OpenCatEsp32-Quadruped-Robot

OpenCatESP32 – 面向 ESP32/BiBoard 的开源四足机器人框架

是什么 – 一个在 BiBoard ESP32 开发板上运行 OpenCat 机器人狗软件的固件仓库。它驱动 Petoi 当代四足机器人套件（Bittle X、Nybble Q）以及即将推出的 Quaddle 小型机器人狗。

为何重要 – 从旧的 ATmega 基础的 NyBoard 迁移到双核 ESP32 后，该平台可在单块板子上同时处理实时腿部协调 和 感知（视觉、Wi‑Fi/蓝牙流媒体）。这使得机器人成为以下实验的实用测试平台：

• 步态研究与强化学习实验
• 连接 Raspberry Pi 的 ROS / SLAM 演示
• 本地 AI 推理（例如，简单视觉或语音控制）

主要硬件规格

• ESP32‑S3，240 MHz 双核
• 内置 Wi‑Fi 与蓝牙
• 最多支持 12 个舵机（套件使用 4–8 个）
• 兼容 Arduino IDE，README 中提供预配置的板卡设置表。

主要软件组件

• OpenCat 核心 – 低级舵机定时、步态生成器，以及通过手动引导腿部来记录动作的“木偶模式”
• 示例与演示 – 步行、奔跑、平衡，以及用于添加感知流水线的钩子
• 模拟器链接 – Bittle X 和 Quaddle 的基于网页的模拟器，可在硬件到达前进行原型设计

典型使用场景

受众	他们如何使用该仓库
研究人员 / 学生	在廉价的实体四足机器人上运行强化学习或基于模型的控制循环；通过 Wi‑Fi 收集传感器数据。
制作人 / 教育者	从 Arduino IDE 中刷写固件，编程自定义步态，或使用“木偶模式”无需编写代码即可创建舞蹈动作。
爱好者 AI 开发者	连接 Raspberry Pi 或 Jetson Nano，通过 Wi‑Fi 传输视频，并在本地运行轻量级视觉模型。

快速入门

1. 安装 Arduino IDE 并添加 ESP32 板卡包。
2. 选择 ESP32 Dev Module，并按照 README 中的设置（240 MHz，4 MB 闪存等）进行配置。
3. 连接 BiBoard，接入最多 12 个舵机，上传 OpenCatESP32 草图。
4. 使用提供的示例草图或网页模拟器测试行走步态。
5. 加入社区（Reddit、Discord、Facebook）获取接线图、自定义步态教程和 RL 实验脚本。

社区与支持

• Reddit: r/OpenCat（固件破解）和 r/Petoi（硬件与项目）
• Discord: 实时聊天，用于故障排查和分享研究成果
• GitHub Issues: 报告错误或请求功能；仓库由 Petoi 工程师积极维护。
• 教育资源: Petoi 指南、YouTube 播放列表和博客文章，涵盖 AI 强化学习、ROS 集成和 SLAM 演示。

路线图 / 未来计划

• 即将推出的 Quaddle 机器人将在 Kickstarter 发布前（2026年9月2日）开源更新的 ESP32‑S3 代码库。
• 持续改进模拟器，增加更多感知示例，并扩展强化学习训练流程。

---

以上所有信息均直接取自仓库的 README；未推断任何额外功能。