Nybble User Manual
πŸ‡ΊπŸ‡ΈEnglish Version
πŸ‡ΊπŸ‡ΈEnglish Version
  • Nybble User Manual 😼
  • 1 πŸ§˜β€β™‚οΈ Tools and Preparation
  • 2 🧩 Open the Box
  • 3 πŸ— Assemble the Frame
  • 4 πŸ”Œ Connect Wires
  • 5 ⌨️ NyBoard Configuration
  • 6 πŸ“ Calibration
  • 7 πŸ•Ή Play with Nybble
  • 8 πŸ‘¨β€πŸ« Teach Nybble New Skills
  • 9 πŸ‘¨β€πŸŽ“ Understand OpenCat.h
  • 10 πŸ”© Extensible Modules
  • 11 πŸ›  Do more with Nybble
  • Useful Links πŸ•Έ
    • πŸ™‹β€β™‚οΈFAQ
    • πŸ“šPetoi Doc Center
    • πŸ”­Home of Petoi Robots
    • πŸ’ΏGitHub of OpenCat
    • πŸ“²Smartphone App
    • πŸ’»Desktop App
    • πŸŽͺPetoiCamp (Forum)
    • 🎁Shop Coding Robots
    • πŸ“½οΈTutorial Playlist
    • πŸ–²οΈWeb API Interface
Powered by GitBook
On this page
  • 3.1 Head and neck
  • 3.1.1 Part list
  • 3.1.2 Prepare ultrasonic sensor
  • 3.1.3 Trim the servo arms for attaching servos.
  • 3.1.4 Assemble the head group.
  • 3.2 Body
  • 3.2.1 Part list
  • 3.2.2 Install the adjustable battery holder to the belly
  • 3.2.3 Assemble the body group
  • 3.3 Shank
  • 3.3.1 Part list
  • 3.3.2 Attach the rubber to the tip of the shank.
  • 3.3.3 Insert the servo into the slot on the shank.
  • 3.4 Thigh
  • 3.4.1 Part list
  • 3.4.2 Trim the servo arms for attaching servos.
  • 3.4.3 Assemble the thigh.
  • 3.5 Tail
  • 3.5.1 Part list
  • 3.5.2 Assemble the tail.

Was this helpful?

Export as PDF

3 πŸ— Assemble the Frame

"The whole is more than the sum of its parts." πŸ”©

Previous2 🧩 Open the BoxNext4 πŸ”Œ Connect Wires

Last updated 8 months ago

Was this helpful?

We highly recommend you watch the overall assembling process before starting. Some updated components are noted in the following paragraphs.

3.1 Head and neck

3.1.1 Part list

3.1.2 Prepare ultrasonic sensor

The obstacle avoidance algorithm using the ultrasound sensor has not yet been integrated into the released code. The following setup provides a starting point but is not mandatory.

BelowT is a tutorial video:

With the basic distance detection and some proportional reactions, you can achieve the following demo:

Before Jan 2021, we used a standard ultrasonic sensor. The sensor is connected to the NyBoard via a 4-pin cable.

  • Solder on the optional LED to the ultrasonic sensor

  • Solder 4-pin ultrasonic sensor header to NyBoard

3.1.3 Trim the servo arms for attaching servos.

Most of the servo arms on the model are trimmed from the cross-shaped arm I. Since there will be more unused straight arms, you can practice trimming with them first.

An alternative method to trimming is using a half-burned knife to cut the plastic parts off. Leave a little bit longer because melted plastic will have a rounded edge.

Pay attention to the width difference between servo arm I’s two long sides, as well as the trimming location (using screw holes as references).

As we switched servo suppliers, the servo arms also changed a little bit (as shown below). To reduce confusion, the servo arm I can be used for most of the joints, just trim it accordingly. Servo arm K is used for the tail. Servo J can be omitted.

In kits after January 2021, we included the new servo arms that require minimal effort to cut. You only need to cut the cross-shaped servo arm to make the L-shaped connector for the neck joint.

3.1.4 Assemble the head group.

Notice how the servo wire is organized in the head.

Note that the base should only be partially assembled for later calibration. Otherwise, it will be difficult to insert the servo between neckpieces.

3.2 Body

3.2.1 Part list

  • NyBoard only

Note that without the Raspberry Pi, the NyBoard is mounted to the underside of y1 with the servo connections facing downward. In later versions, the y1 piece is designed to be symmetric so that both ends have two screw holes.

  • NyBoard with Raspberry Pi

Use y1Pi to replace y1, and add Pi Stand. Pay attention to the location of the pink pieces. Note that with the Raspberry Pi, the NyBoard is mounted on top of y1Pi.

  • Other controllers

I also included 5 x 1”/4 nuts for mounting other circuit boards.

3.2.2 Install the adjustable battery holder to the belly

If you get the battery holder version:

Bend the hinge L of the battery holder to 90 degrees, close to the wall. It functions as a switch. Insert the long screw E through the rivet so that you can better handle the rivet. Insert and push the rivet into the hole on the bottom of the battery holder. Pay attention to the holes’ locations.

The spring attached structure of the battery holder is used for shifting the center of mass when fine-tuning gaits.

The battery holder is generic for AA (1.5V) batteries. But Nybble uses 3.7V Li-ion batteries.

3.2.3 Assemble the body group

The spine piece may be thicker than the slot on the shoulder. You can insert it from the outside first to compress the tip and widen the slot, then insert it into the inside of the shoulder.

3.3 Shank

3.3.1 Part list

3.3.2 Attach the rubber to the tip of the shank.

The serrated structure on the tip of the shank is already good for walking. The rubber toe is optional to increase friction and soften each step.

3.3.3 Insert the servo into the slot on the shank.

DO NOT install the servo screw A yet.

3.4 Thigh

3.4.1 Part list

In later versions, we will use plastic pieces for thigh2.

3.4.2 Trim the servo arms for attaching servos.

3.4.3 Assemble the thigh.

Before closing thigh1 and thigh2, put the wire of the shank through the slot in the middle of the thigh. Think about the symmetry of the four legs.

When installing the screws, pay attention to the directions you insert them.

The servo arm should be able to slide in the track on thigh2 with subtle friction after thigh1 and thigh2 are screwed together. You can tune the tightness of screw C to achieve proper friction. If you need more control over the tightness:

  • Scratch the track using a flat screwdriver to reduce friction.

  • Apply a little paper glue to the track and let it dry to increase friction.

DO NOT screw the neck and legs to the body’s servos yet.

3.5 Tail

3.5.1 Part list

3.5.2 Assemble the tail.

The screw D is installed in the third hole counted from the center of the servo arm K. Pay attention to the order that every piece is stacked. The wheel (tail2) should be able to rotate with little friction, and the whole tail should be able to tilt by a small degree.

In kits after January, we included a special servo arm to simplify the installation of the tail joint.

DO NOT connect the tail to the body yet.

We include an ODMed in the Nybble kit. It doesn't require soldering, but you need to trim off the plastic clip residue of the connection wire on the head's end.

You can download the demo code at

The optional RGB LED can be soldered to the four pins of the ultrasound sensor () to indicate its working status or can be programmed as decorative light. Bend the pins of the ultrasonic sensor for later installation.​Write a caption​

The ultrasonic module is connected to the exposed GPIO pins located in the opposite corner of the board from the TTL connector. You can customize the pin definitions in OpenCat.h. By default definitions, solder the ultrasonic module connection header in the holes labeled β€œD8 D9 D10 GND” as pictured below.​Write a caption

Watch the to understand the assembling process, but don't assemble them all at once. Every part that connects to the servo's output shaft should not be fixed before calibration.

On earlier batches of NyBoards, the manufacturer used taller jumper pins than expected, so it will be necessary to bend pins or otherwise modify the NyBoard to fit a Pi on top and use the Pi Stand. There is a list of suggested solutions in the forum by this link:

After June 2022, we start to equip Nybble with a rechargeable Li-ion battery pack. It's also available at our if you get an earlier version of Nybble with a battery holder. Please add a note if you need the as well.

Pay attention to the long pins of the infrared receiver and FTDI port. They are designed to be bent in favorable directions. Don’t bend the pins too often or it will lead to metal fatigue. Observe the if you want to mount a Pi.

Assemble the body group as shown in the .

Pay attention to the direction that the wire is twisted. The small dent on the long edge is designed to let the wire go through. Think about the symmetry of the four legs. Assemble the shank as shown in the .

The location has been shown in the section. The trimmed narrower servo arm is designed to be inserted into spring F.

Assemble the thigh as shown in the .

Assemble the tail as shown in the .

ultrasonic sensor with RGB LED
https://github.com/PetoiCamp/OpenCat/tree/main/ModuleTests/testRGBLedUlrasonic
head animation
https://www.petoi.com/forum/clinic/placement-of-raspberry-pi-3b
online store
3D-printed belly
adjusted configuration
body animation
shank animation
Head and Neck
thigh animation
tail animation
instructions
Simply match and slide the battery