正在连接信源…

Petoi Nybble Q 机器猫(Nybble 系列) 的做法

Petoi Nybble Q 机器猫(Nybble 系列) 的 31 个步骤,附出处文档。

Nybble Q 预装版:浅米色 Lite 舵机 435.00 美元、浅米色合金舵机 515.00 美元(有货),白色 Lite 舵机 435.00 美元(缺货)(Petoi 官方商店,美元,2026‑10‑31)。页面未写是否含税;美国订单满 200 美元免运费,国际订单满 500 美元免运费、否则 15 美元起,关税自付

采购

  • 购买 PCA9685 PWM 舵机驱动器

    从 Adafruit 商店购买 16 通道 PWM 与舵机驱动器、扩展板或 FeatherWing。该器件使用 I2C 通信,接口需要 2 个引脚。

软件与固件

  • 手动安装 NeoPixel 库

    下载 Adafruit_NeoPixel 库后,将文件夹重命名为 'Adafruit_NeoPixel',并放入 Arduino 的库文件夹。

  • 打开库管理器

    在 Arduino IDE 中选择 Sketch > Include Library > Manage Libraries,打开库管理器,其中会列出已安装或可安装的库列表。

  • 搜索 Neopixel 库

    在搜索栏中搜索 “Neopixel strip” 以找到该库。

  • 选择版本并安装

    点击文本区域,选择所需的特定版本,然后点击安装。

  • 打开发布页面

    在浏览器中打开 Adafruit_NeoPixel 的发布页面。

  • 下载最新版本

    从发布页面下载最新的发布版本。

  • 解压 ZIP 文件

    解压下载的 ZIP 压缩文件。

  • 通过 Arduino IDE 添加库

    在 Arduino IDE 中依次选择 Sketch、Include Library 和 Add .ZIP Library。

  • 初始化 NeoPixel 灯带

    包含 Adafruit_NeoPixel.h,将引脚设为 6,像素数量设为 16,并创建使用 NEO_GRB + NEO_KHZ800 的 NeoPixel 对象。在 setup() 中调用 pixels.begin()。

  • 运行 NeoPixel 灯光循环

    在 loop() 中先清除像素,然后遍历 16 个像素,将每个像素设置为绿色 RGB(0, 150, 0),调用 show() 显示,并延迟 500 毫秒。

  • 创建 IMU 设备变量

    在应用程序代码中创建 `inv_imu_device_t imu_dev;` 和 `inv_imu_serif_t imu_serif;`。

  • 配置寄存器读写函数

    实现 `read_reg` 和 `write_reg` 函数,并初始化 `imu_serif` 中对应的指针。

  • 设置单次传输字节上限

    将 `max_read` 和 `max_write` 设置为每次事务允许的最大字节数。示例中两者均为 `32768`。

  • 配置串行接口类型

    将 `serif_type` 设置为使用的串行接口类型,可用选项列在 `inv_imu_transport.h` 中,并将 `context` 设置为 `0`。

  • 初始化传感器事件回调

    在 `inv_imu_adv_var_t` 结构中初始化传感器事件回调指针;新传感器数据可用时将调用该函数。

  • 初始化 IMU 设备

    调用初始化函数,传入设备和串行接口对象,以及新样本到达时执行的回调。

  • 通过库管理器安装 MPU6050

    在 Arduino Library Manager 中搜索“mpu6050”,然后安装该库。

  • 使用库管理器手动安装

    在 Arduino IDE 中打开“Sketch”→“Include Library”→“Manage Libraries...”,然后安装该库。

  • 通过 ZIP 文件手动安装

    使用 GitHub 的“Download ZIP”按钮下载 ZIP 文件,然后在 Arduino IDE 中打开“Sketch”→“Include Library”→“Add .ZIP Library...”并安装。

  • 克隆仓库到 Arduino 库目录

    将此 Git 仓库克隆到 sketchbook/libraries 文件夹中。

  • 为 NyBoard 上传代码

    将 src/PetoiESP32Servo 文件夹移到 temp/,在 Arduino IDE 中选择 NyBoard,然后上传。

  • 为 BiBoard 上传代码

    将 PetoiESP32Servo 文件夹移回 src/,在 Arduino IDE 中选择 BiBoard,然后上传。

标定与测试

  • 移动关节至校准姿势

    在串口监视器中输入 c,使关节移动到校准姿势。

  • 关闭舵机并使关节休息

    在串口监视器中输入 d,使关节移动到休息姿势并关闭所有舵机。

  • 使关节站立

    在串口监视器中输入 t,使关节移动到站立姿势。

  • 围绕零位旋转所有舵机

    在串口监视器中输入 a,使所有舵机围绕零位旋转。

  • 调节简单行走参数

    在串口监视器中输入 k offset amplitude,调节简单行走的偏移量和步幅。

  • 示例:前倾五度并增大步幅

    例如输入 k 5 8,机器人会向前倾斜 5 度,并将步幅增大到 8 度。

  • 运行 strandtest 草图测试

    重启 Arduino IDE,然后打开 File->Sketchbook->Library->Adafruit_NeoPixel->strandtest 草图,用于测试 LED 像素条。

用起来

  • 让机器人简单行走

    在串口监视器中输入 k,使机器人执行简单行走。此代码只生成类似行走的模式,不会有效向前移动。

常见问题

  • 无效的 C++ 字符串类型导致草图编译失败 #17 #29 #10
  • 缺少库或项目头文件导致编译致命错误 #28 #23
  • 缺少 #ifdef 守卫导致禁用传感器时编译错误 #24
  • 过时的 ESP32 核心版本 2.0.12 与 IDE 更新冲突 #22
  • ESP32 需要手动修改 IMU 库 #1
  • 刷写固件后机器在初始化 MPU 时卡住 #2
  • 连接 WiFi 时出现 1006 错误并反复重连 #42
  • 刷入自定义固件后手机应用与电脑蓝牙连接失败 #8 #9

物料

  • BiBoard V1:ESP32(ESP32‑U4WDH,4 MB Flash,Wi‑Fi 与蓝牙)、MPU6050 陀螺仪、语音识别模块、扬声器、12 路 PWM 舵机口、Grove 扩展口、树莓派接口(BiBoard V1 指南)
  • 11 个舵机(腿 8、头 2、尾 1),分 Lite 与合金两档,商品页称为反馈舵机,可手掰示教新动作
  • 背部 4 区触摸 FPC、超声波模块(接第一个 Grove 口)
  • 可拆卸锂电池,Type‑C 充电,2P 2.54 mm 端子供电;商品页称约 1 小时游玩
  • FDM 3D 打印机身,手册提醒 Z 轴强度有限、别从桌边摔落

工具

  • 出厂已装好,开箱只需装尾巴与校准架;随附自攻螺丝刀、USB 线、备用舵机与树莓派支架(手册)
  • 编程用 Windows/Mac/Linux 电脑(Petoi Desktop App,可选 Arduino IDE、Mind+)与 5V 1A USB 充电口
  • 可选:3D 打印 MakerWorld 上的官方校准支架

技能

  • Petoi Coding Blocks(Mind+ 积木)与 Skill Composer 无代码动作编排
  • Python 串口 API 与 Arduino C++(OpenCatEsp32)
  • 进阶:接树莓派或 Jetson 做 ROS 2、强化学习与自主导航(商品页)

软件

  • OpenCatEsp32 固件(MIT,2026‑10 仍有提交,无 Release)
  • Petoi Desktop App:固件上传、关节校准、Skill Composer(最新正式版 1.2.5,2025‑06)
  • Petoi 手机 App(1.4.1,2025‑10)、Mind+ Petoi Coding Blocks 与网页积木
  • ros_opencat(ROS)与 opencat-gemma(端侧 Gemma 语音对话,2026‑10 新建),均为 MIT

文档