How to build Petoi Nybble Q robot cat (Nybble line)
31 steps to build Petoi Nybble Q robot cat (Nybble line), with the source documents.
Nybble Q pre-assembled: cream with Lite servos $435.00, cream with alloy servos $515.00 (in stock), white with Lite servos $435.00 (sold out) (Petoi store, USD, 2026‑10‑31). The page does not say whether tax is included; US orders ship free from $200, international orders free from $500 or from $15 otherwise, customs charges paid by the buyer
Buy parts
- Buy a PCA9685 PWM Servo Driver
Buy the 16-channel PWM and servo driver, shield, or FeatherWing from the Adafruit shop. It communicates over I2C and requires 2 pins for interfacing.
Software
- Install NeoPixel Library Manually
After downloading the Adafruit_NeoPixel library, rename the folder to 'Adafruit_NeoPixel' and place it in the Arduino Libraries folder.
- Open the Library Manager
In the Arduino IDE choose Sketch > Include Library > Manage Libraries; the Library Manager opens and shows a list of libraries already installed or ready for installation.
- Search for the Neopixel Library
Use the search bar to search for “Neopixel strip”.
- Select a Version and Install
Click on the text area, select the specific version, and install it.
- Open the Releases Page
Open the Adafruit_NeoPixel releases page in a browser.
- Download the Latest Release
Download the latest release from the releases page.
- Extract the ZIP File
Extract the downloaded ZIP archive.
- Add the Library in Arduino IDE
In the Arduino IDE, select Sketch > Include Library > Add .ZIP Library.
- Initialize the NeoPixel strip
Include Adafruit_NeoPixel.h, set the pin to 6 and the number of pixels to 16, then create a NeoPixel object using NEO_GRB + NEO_KHZ800. Call pixels.begin() in setup().
- Run the NeoPixel lighting loop
In loop(), clear the pixels first, then iterate through the 16 pixels, set each one to green RGB(0, 150, 0), call show() to display it, and delay for 500 milliseconds.
- Create IMU device variables
In the application code, create `inv_imu_device_t imu_dev;` and `inv_imu_serif_t imu_serif;`.
- Configure register functions
Implement the `read_reg` and `write_reg` functions and initialize the corresponding pointers in `imu_serif`.
- Set transaction byte limits
Set `max_read` and `max_write` to the maximum numbers of bytes allowed per transaction. In the example, both are `32768`.
- Configure serial interface
Set `serif_type` to the serial interface used; available options are listed in `inv_imu_transport.h`. Set `context` to `0`.
- Initialize sensor callback
Initialize the sensor event callback pointer in the `inv_imu_adv_var_t` structure. The function is called when new sensor data is available.
- Initialize the IMU device
Call the initialization function with the device and serial interface objects and a callback that executes when a new sample is received.
- Install MPU6050 With Library Manager
Search for "mpu6050" in the Arduino Library Manager, then install the library.
- Install Manually With Library Manager
In the Arduino IDE, open "Sketch" -> "Include Library" -> "Manage Libraries...", then install the library.
- Install Manually From a ZIP File
Download a ZIP file from GitHub with the "Download ZIP" button, then open "Sketch" -> "Include Library" -> "Add .ZIP Library..." in the Arduino IDE and install it.
- Clone Repository Into Arduino Libraries
Clone this Git repository into the sketchbook/libraries folder.
- Upload code for NyBoard
Move the src/PetoiESP32Servo folder to temp/, select NyBoard in Arduino IDE, and upload.
- Upload code for BiBoard
Move the PetoiESP32Servo folder back to src/, select BiBoard in Arduino IDE, and upload.
Calibrate and test
- Move joints to calibration posture
Enter c in the serial monitor to move the joints to the calibration posture.
- Turn off servos and rest joints
Enter d in the serial monitor to move the joints to the rest posture and turn off all the servos.
- Move joints to stand posture
Enter t in the serial monitor to move the joints to the stand posture.
- Rotate all servos around zero
Enter a in the serial monitor to rotate all the servos around the zero position.
- Tune simple walking parameters
Enter k offset amplitude in the serial monitor to tune the offset and amplitude of the simple walking.
- Example: lean and enlarge steps
For example, k 5 8 makes the robot lean forward by 5 degrees and increases the step amplitude to 8 degrees.
- Run the strandtest Sketch
Restart the Arduino IDE, then open File->Sketchbook->Library->Adafruit_NeoPixel->strandtest to test the LED pixel strip.
Use it
- Make the robot walk simply
Enter k in the serial monitor to make the robot perform a simple walk. This code only generates walking-like patterns and will not effectively move forward.
Common problems
- Invalid C++ string types cause sketch compilation failures #17 #29 #10
- Missing library or project headers cause fatal compile errors #28 #23
- Missing ifdef guard breaks compile when sensor is disabled #24
- Obsolete ESP32 core 2.0.12 conflicts with IDE update prompts #22
- IMU library requires manual modification for ESP32 #1
- Robot hangs at Initialize MPU after flashing firmware #2
- WiFi connection fails with error 1006 and repeated reconnects #42
- Custom firmware breaks phone app and desktop Bluetooth connections #8 #9
Parts
- BiBoard V1: ESP32 (ESP32‑U4WDH, 4 MB flash, Wi‑Fi and Bluetooth), MPU6050 IMU, voice recognition module, speaker, 12 PWM servo ports, Grove sockets, a Raspberry Pi port (BiBoard V1 guide)
- 11 servos (8 legs, 2 head, 1 tail) in Lite or alloy versions; the store page calls them feedback servos that let you teach moves by hand
- Four-zone back touch FPC and an ultrasonic module (on the first Grove socket)
- Removable Li-ion battery, Type‑C charging, 2P 2.54 mm power terminal; the store page says about an hour of play
- FDM 3D-printed body; the manual warns that Z-axis strength is limited, so keep it away from table edges
Tools
- Ships assembled; you fit only the tail and the calibration stand. A self-tapping screwdriver, USB cable, spare servo and Raspberry Pi mount are included (manual)
- A Windows/Mac/Linux computer for coding (Petoi Desktop App, optionally Arduino IDE and Mind+) and a 5V 1A USB charger
- Optional: 3D-print the official calibration stand from MakerWorld
Skills
- Petoi Coding Blocks (Mind+) and no-code move design in Skill Composer
- The Python serial API and Arduino C++ (OpenCatEsp32)
- Advanced: add a Raspberry Pi or Jetson for ROS 2, reinforcement learning and autonomous navigation (store page)
Software
- OpenCatEsp32 firmware (MIT, commits through 2026‑10, no releases)
- Petoi Desktop App: firmware upload, joint calibration, Skill Composer (latest stable 1.2.5, 2025‑06)
- Petoi mobile app (1.4.1, 2025‑10), Mind+ Petoi Coding Blocks and web blocks
- ros_opencat (ROS) and opencat-gemma (on-device Gemma voice chat, new in 2026‑10), both MIT