Connecting to sources…

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

Documents