Thanks for choosing Petoi's robot Bittle or Nybble. This guide will help you set up your robot buddy and provide a simpler UI to calibrate, control, and program it. For advanced users, we recommend you keep the robot updated with the OpenCat firmware on Github for the best compatibility and newest features.
The app works on both Android and iOS devices.
You need to plug the Bluetooth dongle into the 6-pin socket on the NyBoard. Pay attention to the Bluetooth dongle's pin order. Long-press the button on the battery to turn on the robot's power.
The LED on the Bluetooth dongle should blink waiting for a connection. Open the app and scan to connect the device with the name Bittle, Petoi, or OpenCat. Remember to open the Bluetooth service and grant the app access to the service.
If the Bluetooth is connected, its LED will light steady. The robot will play a three-tone melody. If the robot doesn't respond or malfunction later, press the reset button on the NyBoard to restart the program on the NyBoard.
The App should automatically detect Nybble or Bittle with the latest OpenCat firmware. Otherwise, it will show the selections for Nybble or Bittle. The option can be re-visited in the control panel.
The following screen will be calibration for first-time users. It can also be re-visited in the control panel.
Select the joint index in the image on the calibration page, then click + or - to fine-tune the joints to right angles. Use the included L-shape tool as a reference. If the offset exceeds +/- 9 degrees, you need to take off the servo and reinstall it by one tooth. For example, what used to be +9 (out of bound) should become -3 or something.
You can switch between rest, stand, walk to test the effect of calibration. If it's good, remember to click "save" to save the calibration offsets. Otherwise, click return on the top-left corner to abandon the calibration.
In the control panel, you can use the pe-set buttons to control the robot.
The left panel sets both the robot's gaits and directions and send combined command, such as "walk left" and "trot forward". The robot will only move if an initial gait and direction are selected. The "step" has no direction, and "backward" has left and right directions. The pause button "||" will pause the robot's motion and turn off the servos, so that you can rotate the joints to any angles. The "Balancer" button turns on/off the gyro, a sensor to detect the robot's body orientation. Turning it on will make the robot keep adjusting to body angles, and will know when it's upside down. Turning it off will reduce calculation and make it walk faster and more stable.
The built-in postures and behaviors can be triggered by pressing the buttons. Don't press the button too frequently and repeatedly. Allow some time for the robot to finish its current tasks.
You can also define customized commands by pressing the "+" button. Long-press a custom command button to edit it. There's a lite serial console to test the command and even configure the robot.
Custom commands to try:
m0 -70 0 70
m 0 -70 0 70 8 -30 8 45
M 0 -45 8 -30 12 -60
b14 90 14 90 21 90 21 90 23 90 23 90 21 180
A more detailed table can be found in the user manual: https://bittle.petoi.com/7-play-with-bittle
We keep improving the app and will inform you of the updates when available. Please write to [email protected] if you have any questions about the app.