A family of boards and robots
The legacy OpenCat project uses an Arduino-style sketch to coordinate servos, gaits and an inertial sensor. In its setup instructions the builder selects the Bittle or Nybble model and the matching NyBoard revision before uploading firmware. Those preprocessor choices affect pin assignments, joint counts and the motion profile loaded at startup.
Petoi now directs Bittle X and Nybble Q users to OpenCatESP32. The legacy code remains useful for supported older hardware, but it should not be described as the current firmware for every Petoi robot.
Calibration before any gait
The published procedure separates configuration mode from the main sketch. It includes resetting joint offsets, calibrating the IMU and checking servo alignment. An offset error can leave one foot higher than another even when the gait sequence itself is unchanged.
For teaching, this gives a concrete experiment: compare the commanded gait with the same robot before and after joint-offset calibration, keeping the surface and power source fixed. That experiment is suggested here; it has not been performed by this site.
Do not confuse code availability with every product release
The repository also mentions later Petoi hardware. It says the Quaddle source had not been published in the referenced announcement. A future or proposed release should not be counted as available open-source firmware until the files and license are public.
Researchers using ROS, computer vision or learning tools need to confirm which additions are maintained in the branch matching their controller. Community integrations do not automatically ship with the base firmware.
Build Bittle or Nybble and configure NyBoard
Use matching revisions of parts, firmware and instructions. These steps summarize project documentation; no physical build was performed for this article.
Official files and manuals 5 references
Assembly sequence 5 steps
Choose Nybble or Bittle and board generation
Identify the model's DOF and NyBoard versus ESP32 controller before buying servos or downloading firmware.
Manufacturer's instructions ↗Build mechanical links from the correct kit or published CAD
Use the robot-specific hardware instructions, and confirm available design rights and STL completeness.
Manufacturer's instructions ↗Select model and board in OpenCat.ino
Set the matching BITTLE/NYBBLE definition and correct NyBoard version in the Arduino sketch.
Manufacturer's instructions ↗Upload configuration and calibrate IMU
Disable MAIN_SKETCH during setup, use Serial Monitor at 115200 baud with no line ending and place the robot level for IMU calibration.
Manufacturer's instructions ↗Reset joint offsets and test known poses
Run the documented joint calibration, then restore the MAIN_SKETCH definition and cautiously test movements using a supported controller.
Manufacturer's instructions ↗
Servo offsets, Arduino firmware and chassis files
Answers are based on published source material and project documentation. Their order does not represent search volume.
01Why does the robot move with wrong joint angles?
Run the joint calibration to set servo offsets rather than assuming factory horn positions. Use the documented serial or app calibration workflow.
Sources Official project source ↗
02Which board settings must be selected before uploading?
OpenCat.ino has separate BITTLE/NYBBLE and NyBoard revision defines. Use the model physically installed, then upload the matching sketch.
Sources Official project source ↗
03Why does the serial monitor not show setup prompts?
Use 115200 baud and no line ending and verify the USB-to-serial driver, correct COM port and configuration-mode build.
Sources Official project source ↗
04Can the original NyBoard firmware run unchanged on ESP32?
No. OpenCatESP32 has a separate repository and board-specific definitions. Follow its own installation and calibration instructions.
Sources Official project source ↗
05Where can I print my own Bittle or Nybble shell?
Petoi's public software repository covers the controller and points to hardware documentation, but does not confirm a complete ready-to-print revision-matched STL kit for every commercial robot.
Sources Official project source ↗
06What does the AUTO_INIT option do?
It skips some prompts and triggers IMU calibration in the firmware setup. Use it only after checking the manual calibration sequence.
Sources Official project source ↗
What to check before building OpenCat
Build and integration
Start by identifying your controller board. The repository describes NyBoard, an Arduino-compatible ATmega328P design for coordinating up to twelve servos, and points to a separate OpenCatESP32 generation. Match the firmware and servo configuration to your physical leg geometry before attempting walking. Optional Raspberry Pi or camera modules can handle higher-level processing.
Known constraints
OpenCat contains multiple board generations and many optional add-ons. A program compatible with the original NyBoard need not run unmodified on an ESP32 board. The MIT software license does not settle the rights to every third-party chassis image, mechanical part or purchased kit.
Original documentation
Found a changed specification? Submit a correction with its source ↗