Petoi Doc Center
🇺🇸English
🇺🇸English
  • Welcome to Petoi Doc Center
  • Getting Started Guide
  • 🙋‍♂️FAQ(Frequently Asked Questions)
  • Petoi robot joint index
    • Joint Pins on NyBoard
      • Nybble
      • Bittle
    • Joint Pins on BiBoard V0
      • Bittle X
      • Bittle X+Arm
    • Joint Pins on BiBoard V1
      • Bittle X
      • Bittle X+Arm
      • Nybble Q
  • Bluetooth Connection
    • BiBoard
    • NyBoard
  • Upload Firmware
    • NyBoard
    • BiBoard V0
    • BiBoard V1
  • Joint Calibration
  • Infrared Remote
    • Remote Controller
  • Mobile App
    • Introduction
    • Calibrator
      • Nybble
      • Bittle
    • Controller
  • Desktop APP
    • Introduction
    • Firmware Uploader
      • NyBoard
      • BiBoard V0
      • BiBoard V1
    • Joint Calibrator
      • NyBoard Preparation
      • BiBoard Preparation
      • Nybble
      • Bittle / Bittle X
        • Bittle (NyBoard)
        • Bittle X (BiBoard V0)
        • Bittle X (BiBoard V1)
      • Bittle X+Arm
        • BiBoard V1
        • BiBoard V0
    • Skill Composer
      • NyBoard Connection
      • BiBoard Connection
      • Interface
        • Nybble
        • Bittle / Bittle X
        • Bittle X+Arm
    • Tools
  • Block-based programming
    • Petoi Coding Blocks
      • NyBoard Preparation
      • BiBoard Preparation
    • Block-based Coding Curriculum - Learn Quadruped Robotics for Beginners
    • Python coding mode in Mind+
    • Generic Arduino Uno Blocks
    • Install Mind+ on Chromebook
  • Arduino IDE
    • Upload Sketch for NyBoard
    • Upload Sketch for BiBoard
    • Calibrate the joints with Arduino IDE
    • Serial Monitor
    • C++ Curriculum: Learn Quadruped Robotics for Beginners
    • Install Arduino IDE on Chromebook
  • Free Curriculum
    • 📚Download
  • APIs
    • 🖇️Serial Protocol
      • Feedback servos
      • Nested task queue and signal generator
    • 🐍Python API
    • 🐛8266 MicroPython controller
      • Run MicroPython on ESP8266
      • Setup WebREPL
      • Using the ESP-NOW protocol
    • 🦎8266 Arduino C Controller
    • ©️C++ API
    • 🍓Raspberry Pi serial port as an interface
      • For BiBoard V1
    • 💻Set up Development Environment on Chromebook
    • 🤖ROS
  • Nyboard
    • Overview
    • NyBoard V1_0
    • NyBoard V1_1 & NyBoard V1_2
  • BIBOARD
    • BiBoard V0 Guide
    • BiBoard Extension Hat
    • Demo Applications
      • 1.GPIO port
      • 2.Serial port
      • 3.Analog-digital converter
      • 4.Digital-Analog Converter
      • 5.EEPROM (Electrically Erasable Programmable read only memory)
      • 6.Gyro IMU(MPU6050)
      • 7.Infrared remote control
      • 8.PWM(Pulse Width Modulation)
      • 9.Servo(under construction)
      • 10.Classic Bluetooth serial port SPP
      • 11.Bluetooth low energy (BLE) serial port pass-through
      • 12.File system SPIFFS
      • 13.Add hardware partition configuration option in Arduino IDE
      • 14.Play MP3
      • 15.The usage of Wi-Fi OTA(Over-The-Air)
    • BiBoard V1 Guide
  • Communication Modules
    • Introduction (For NyBoard)
    • USB Uploader (CH340C or CH343G)
    • Dual Mode Bluetooth
    • WiFi module ESP8266
      • ESP8266 + Python Scripts Implement wireless crowd control
  • Extensible Modules
    • Introduction
    • MU Camera
    • Ultrasonic Sensor
    • Light Sensor
    • Touch Sensor
    • Gesture Sensor
    • PIR Motion Sensor
    • IR Distance Sensor
    • Voice Command Module
    • Petoi AI Vision Module
    • Advanced development and application of AI vision modules
      • Model Training
      • Model quantification
      • Model deployment
      • Training on the COCO DIY dataset
    • Robot Arm
      • Upgrade your older Bittle/Bittle X for the robotics arm gripper
    • 🎮Joystick with Micro:Bit
  • Applications
    • Melody Creation
    • Skill Creation
    • OpenCat Imitation Tutorial
    • Programmable Puppet Character
    • Tutorial for simulating Bittle In Isaac Sim
  • History
    • Upload Sketch For NyBoard (software 1.0)
  • Technical Support
    • 💾Supporting Application and Software
    • 🔧Burn Bootloader for NyBoard
    • 🛠️Useful Tools
    • 🔋Battery
  • Useful Links 🕸
    • 🔭Home of Petoi Robots
    • 🛒Shop Coding Robots
    • 💿GitHub of OpenCat
    • 🎪PetoiCamp (Forum)
    • 📽️Petoi Robot Videos
    • 📬Users' repositories
Powered by GitBook
On this page
  • Bittle vs Bittle X
  • The doc seems to refer to Bittle and Bittle X interchangeably. Why is that?
  • The difference of mainboards
  • Sound
  • What do different melodies from the board mean?
  • How to adjust the buzzer volume?
  • Software
  • When using the mobile app, I found that my Petoi robot(Bittle or Nybble) was walking very slowly.
  • When using the mobile app, Bittle cannot turn back up now.
  • Bittle doesn't walk very stable.
  • When I use the play dead command with the mobile app, Bittle seems to be stuck in a forever loop trying to play dead again and again.
  • NyBoard can't upload firmware
  • Why there are two calibration stages?
  • If I buy the pre-assembled Bittle, does it still need to be calibrated?
  • If I buy a microcontroller such as NyBoard or BiBoard alone, do I have to buy a separate software program to make it work?
  • Could Python be used to control any Petoi robot?
  • Can your robot (Bittle / Nybble) function on its own? Or does it only work with the commands I give it? Also, can it learn?
  • When running the Petoi Desktop App in MacOS14.1 (Sonoma), the buttons are not responsive. How to solve this problem?
  • How to set up Arduino IDE on ChromeOS (for Chromebook)
  • Unable to find the OpenCat library
  • I'm on Windows 11 and cannot find the robot in the Bluetooth device list
  • How to install the CP210x driver on Windows
  • When use mobile App connects to the robot, it indicates "The device doesn't seem to be a Petoi robot."
  • Hardware
  • How can I easily install the springs into the upper legs of Bittle?
  • I can't find the toe covers. What are the toe covers for?
  • Some frame structures are broken. Where can I get replacement parts?
  • Bittle's neck is loose and may fall accidentally. How can I reinforce the connection?
  • Where can I get the bone shown in Bittle's picture?
  • Does it come with a battery, or do you have to buy a lithium battery?
  • Does Rasberry Pi require any additional components?
  • The robot servos don't seem to be working. How to debug the servos?
  • Quick fix the servo motor engagement
  • The camera module can't work after being connected to the BiBoard extension hat.
  • The serial port can't be found when using a USB type-C data cable to connect the BiBoard to the computer.
  • Resources and links
  • Driver for CH340 USB uploader
  • Can I use block-based coding with any Petoi robot? Do I need to purchase add-on components/modules?

Was this helpful?

Export as PDF

FAQ(Frequently Asked Questions)

PreviousGetting Started GuideNextPetoi robot joint index

Last updated 2 months ago

Was this helpful?

Bittle vs Bittle X

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

Bittle and Bittle X are and share a lot of common things, except for the microcontroller difference where 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 of mainboards

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

Sound

What do different melodies from the board mean?

How to adjust the buzzer volume?

Software

When using the mobile app, I found that my Petoi robot(Bittle or Nybble) was walking very slowly.

When using the mobile app, Bittle cannot turn back up now.

Bittle doesn't walk very stable.

  • Remove the rubber toe covers

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

NyBoard can't upload firmware

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

[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 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.

Why there are 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 I buy a microcontroller such as NyBoard or BiBoard alone, do I have to buy a separate software program to make it work?

Could Python be used to control any Petoi robot?

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

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)

  1. Plug the USB adapter with a USB data cable (for NyBoard) or USB type-C data cable (for BiBoard) into the robot's microcontroller and the Chromebook.

  2. Set the Chromebook Linux VM to recognize the USB port

Settings => Advanced => Developers => Linux development environment => Manage USB devices => USB Serial (turn on)

NOTE: Step 4 must be repeated every time the USB connection is reconnected/powered on.

Unable to find the OpenCat library

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

OpenCat:82:10: fatal error: src/OpenCat.h: No such file or directory 
#include "src/OpenCat.h" 
        ^~~~~~~~~~~~~~~
compilation terminated.

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

BTW, you also 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

When use mobile App connects 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 the instructions in the Petoi Doc Center.

Hardware

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

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?

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

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

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

Does Rasberry Pi require any additional components?

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

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

Quick fix the servo motor engagement

In some cases, the motor's output gear may disengage with the following 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.

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

Resources and links

Driver for CH340 USB uploader

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

There's nothing else to purchase.

Please refer to the .

For NyBoard, please refer to .

For BiBoard, please refer to .

Try turning off the Gyro in the , as shown in the following picture:

Try turning on the Gyro in the , as shown in the following picture:

Make sure you the joints with the included L-shaped tuner and understand the references

will make slow gaits more stable

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

Make sure the uploader is connected to the NyBoard .

[3]. Install .

[4]. .

Yes, you still need to use the desktop app/mobile app/Arduino IDE if your robot doesn't walk very stable.

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

You can . The scripts can work either on your computer and connect to the robot wired or wirelessly.

It follows your instructions via the infrared remote, mobile app, or desktop app. It can also do random behaviors if you . Best of all, the program is open source on GitHub, and you can refer to to create new skills for your robot.

Download the Arduino IDE(e.g. 1.8.19) for Linux from

Install it on the Chromebook. Please refer to the video at

For more information, please refer to:

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 .

[3]. You can upgrade the firmware via the .

For NyBoard, if the firmware can not be upgraded, please refer to

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

You may . Show the picture of the broken pieces and explain how they broke. You may find the or get a replacement directly from us.

Please refer to Bittle's instruction in

The little bone is included in the box, and it is not being sold separately. You may download its 3D-printable file at:

Both Bittle kit and pre-assembled Bittle include one Lithium battery with a built-in charging circuit. You may add more .

Read more at

[1].

[2].

[3].

Please refer to the on the MU camera.

Turn off the battery's power to see if the serial port can appear. Please refer to .

Mac:

Windows:

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

🙋‍♂️
Buzzer beep meaning
mobile app
mobile app
calibrate
upgrade to the latest firmware
in the right way
the USB uploader driver
Reset the bootloader
to fine-tune the joints
GitHub
use Python to control any Petoi robot
enable the random mode
the relevant technical documents
https://github.com/arduino/Arduino/releases/download/1.8.19/arduino-1.8.19.tar.xz
https://www.youtube.com/watch?v=2cve6n4LZqI
https://docs.petoi.com/arduino-ide/upload-sketch-for-nyboard#setup-process
https://docs.petoi.com/upload-firmware
https://docs.petoi.com/desktop-app/firmware-uploader
downloaded driver to install
BiBoard
NyBoard
Petoi Desktop App
NyBoard can't upload firmware
the forum
request
contact us
3D-printable files
Final Assembly.
Intelligent Camera Module
https://github.com/PetoiCamp/NonCodeFiles/blob/master/stl/Bittle_bone.stl
spare batteries
https://docs.petoi.com/api/raspberry-pi-serial-port-as-an-interface
Re-upload the firmware
Calibrate the PWM signal
Swap the pin definitions
Connect to BiBoard via USB type-C data cable
http://www.wch-ic.com/download/CH341SER_MAC_ZIP.html
http://www.wch-ic.com/downloads/CH341SER_EXE.html
Petoi Coding blocks
Turning off the Gyro
from the same family
FAQ
Mute/Unmute the buzzer beep
Adjust the buzzer volume