🙋‍♂️FAQ(Frequently Asked Questions)

Bittle vs Bittle X

The doc seems to refer to Bittle and Bittle X interchangeably. Why is that?

Bittle and Bittle X are from the same familyarrow-up-right and share a lot of common things. But Bittle X uses BiBoard, and Bittle uses NyBoard. So we just refer to Bittle most of the time without specifically mentioning Bittle X.

The difference in mainboards

The differences in specifications of different mainboards are shown in the figure below:

Sound

What do different melodies from the board mean?

Please refer to the Buzzer beep meaningarrow-up-right.

How to adjust the buzzer volume?

Software

When using the mobile app, I found that my Petoi robot was walking very slowly.

Try turning off the Gyro in the mobile apparrow-up-right, as shown in the following picture:

When using the mobile app, my Petoi robot can't self-right after it's upside down.

Try turning on the Gyro in the mobile apparrow-up-right, as shown in the following picture:

My Petoi robot doesn't walk very stably.

  • Make sure you calibratearrow-up-right the joints with the included L-shaped tuner and understand the references

  • Remove the rubber toe covers

  • Turning off the Gyro will make slow gaits more stable

  • You may need to use the Petoi Desktop App -> Tools -> calibrate gyroscope to reset the gyroscope.

When I use the play dead command with the mobile app, my Petoi robot seems to be stuck in a forever loop trying to play dead again and again.

There's a known bug in one of the older firmware. Please upgrade to the latest firmware.

The robot servos don't seem to be working. How to debug the servos?

NyBoard can't upload firmware

The error that occurs when uploading the sketch is shown below:

circle-info

[1]. Do the simple checks as follows:

  • Make sure there's no other program using the serial port, If you have opened the Arduino IDE and its serial monitor, it may occupy the serial port.

  • Make sure the uploader is connected to the NyBoard in the right wayarrow-up-right.

  • Make sure you're using the USB cable that comes with the kit, some USB cables may only have two wires for powering, but no data wires.

[2]. For this operation, you can use a simple test sketch for convenience.

  • With the Petoi Desktop App, select the microcontroller type: NyBoard_V1_*, then you can upgrade the Standard firmware.

  • With Arduino IDE, select the microcontroller type: Board-> Arduino AVR Boards-> Arduino Uno, then you can upload the sketch: File-> Examples->04.Communication->ASCIITable.

[3]. Install the USB uploader driverarrow-up-right.

[4]. Reset the bootloaderarrow-up-right.

Why are there two calibration stages?

There are two calibration steps for different components.

Because the controller board has limited resources, we divide the program into two stages.

In the first stage, we upload the program and large data to the onboard EEPROM (hard disk) and use the remaining programming space to calibrate the IMU, a sensor that measures the body orientation. The board should be leveled and untouched during the (IMU) calibration.

In the second stage, we upload the standard functional code. For the first-time configuration, we need to enter the (joint) calibration state and attach the legs in the right direction.

If you use the Arduino IDE to set up the board, you will handle those stages explicitly. The Petoi Desktop App can finish the two-stage uploading in the background. The mobile app can work only with an already configured board. Its (joint) calibration is only for attaching the legs.

If I buy the pre-assembled Bittle, does it still need to be calibrated?

If your robot doesn't walk very stably, you may need to use the Petoi Desktop App/Petoi Mobile app/Arduino IDE to fine-tune the jointsarrow-up-right .

If I buy a microcontroller such as NyBoard or BiBoard alone, do I have to buy a separate software program to make it work?

Our microcontrollers are specifically designed for our robots. The open source code is free to use and can be downloaded on GitHubarrow-up-right.

Could Python be used to control any Petoi robot?

You can use Python to control any Petoi robotarrow-up-right. The scripts can send commands from your computer to your robot via a wired or Bluetooth connection.

Can your robot (Bittle / Nybble) function on its own? Or does it only work with the commands I give it? Also, can it learn?

It follows your instructions via the mobile app, or desktop app. It can also perform random behaviors if you enable the random modearrow-up-right. Best of all, the program is open source on GitHub, and you can refer to the relevant programming sections in your robot guide to create new skills for your robot.

When running the Petoi Desktop App in MacOS14.1 (Sonoma), the buttons are not responsive. How to solve this problem?

This is due to the incompatibility of the Python Tk library with MacOS. The temporary solution is that you can press the button and drag the mouse slightly at the same time.

How to set up Arduino IDE on ChromeOS (for Chromebook)

Please check this page.

Unable to find the OpenCat library

If you have downloaded and unzipped the OpenCat folder but see the following error:

You should rename the unzipped OpenCat-main folder to OpenCat so that the OpenCat.ino matches the root name.

For more information, please refer to:

https://guide.petoi.com/arduino-ide/upload-sketch-for-nyboard#setup-processarrow-up-right

BTW, you can upload the firmware via the Petoi Desktop App.

I'm on Windows 11 and cannot find the robot in the Bluetooth device list

Try to set "Bluetooth devices discovery" to "Advanced" as follows:

How to install the CP210x driver on Windows for BiBoard V0?

In the Device Manager, if you open the Other devices list, you may see a CP210X device with a triangle exclamation sign. Right-click it to find the "update driver" option, then select the enclosing folder of your downloaded driver to installarrow-up-right.

When I use the mobile App to connect to the robot, it indicates "The device doesn't seem to be a Petoi robot".

When connecting, the app will send handshake signals to the robot, and the robot should be running the firmware in standard mode to respond correctly. If the app returns a "not Petoi robot" error, it's probably due to a firmware issue. Please follow this debugging process:

[1]. Please check the version of the app as follows:

  • App Store

  • Google Play

[2]. For the startup melody in normal mode, please refer to the 00:13 in the video below:

For how to open the serial monitor and input the serial command, please refer to:

[3]. You can upgrade the firmware via the Petoi Desktop Apparrow-up-right.

For NyBoard, if the firmware can not be upgraded, please refer to NyBoard can't upload firmwarearrow-up-right.

Hardware

How can I easily install the springs into the upper legs of Bittle?

Please check out the forumarrow-up-right post discussing installing springs with various tools. Or you can requestarrow-up-right Bittle upper legs with pre-installed springs

I can't find the toe covers. What are the toe covers for?

The toe covers are for special experiments that require more friction. They are not required for regular walking and performance. We have removed them from the standard kit recently, and you may order them as optional accessories.

Some frame structures are broken. Where can I get replacement parts?

You may contact usarrow-up-right. Show the picture of the broken pieces and explain how they broke. You may find the 3D-printable filesarrow-up-right or get a replacement directly from us.

Bittle's neck is loose and may fall accidentally. How can I reinforce the connection?

Please refer to Bittle's instructions in Final Assembly.arrow-up-right

Where can I get the bone shown in Bittle's picture?

The little bone is included in the Intelligent Camera Modulearrow-up-right box, and it is not being sold separately. You may download its 3D-printable filearrow-up-right to print one.

Does it come with a battery, or do you have to buy a lithium battery?

Both Bittle construction kit and pre-assembled Bittle include one Lithium battery with a built-in charging circuit. You may get more spare batteriesarrow-up-right.

Does Raspberry Pi require any additional components?

You can solder the 2x5 socket on the NyBoard and then mount the Raspberry Pi on the NyBoard.

Read more at:

https://guide.petoi.com/apis/raspberry-pi-serial-port-as-an-interfacearrow-up-right

Quick fix of the servo motor engagement

In some cases, the motor's output gear may disengage from the gear. It will result in an abnormal buzzing sound inside the servo. You can take off the bottom of the servo and push the motor inward very hard until you hear a clicking sound.

The camera module can't work after being connected to the BiBoard extension hat.

Please refer to the FAQ section on the MU camera.

The serial port can't be found when I use a USB type-C data cable to connect the BiBoard to the computer.

Turn off the battery's power to see if the serial port can appear. Please refer to Connect to BiBoard via USB type-C data cablearrow-up-right.

Driver for CH340 USB uploader

Can I use block-based coding with any Petoi robot? Do I need to purchase add-on components/modules?

You can use Petoi Coding blocksarrow-up-right to do Scratch-like block-based programming with all of Petoi robots.

There's nothing else to purchase.

Last updated