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,使机器人执行简单行走。此代码只生成类似行走的模式,不会有效向前移动。
常见问题
物料
- 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