Introduction
📱🤖
Thanks for choosing Petoi's robot. This guide will help you set up your robot buddy and provide a simpler UI to calibrate the joints, control the robot, and program it. For advanced users, we recommend you keep the robot updated with the OpenCat(for NyBoard) / OpenCatEsp32(for BiBoard) firmware on GitHub for the best compatibility and the newest features.
Download and installation
The app works on both Android and iOS devices.
APK
For Android, you can also download the APK and install it on your phone.
The universal version(try this one first) v1.4.1-40-2-20251022-app-release.apk
The v8a version of the app mainly supports most of the current new mobile phone models v1.4.1-40-2-20251022-app-arm64-v8a-release.apk
The v7a version of the app is compatible with older mobile phone models v1.4.1-40-2-20251022-app-armeabi-v7a-release.apk
The x86_64 version of the app indicates that the APK is designed for Android devices using Intel or AMD 64-bit processors. This means the APK contains native code libraries optimized for the x86_64 architecture, designed to improve performance and compatibility. v1.4.1-40-2-20251022-app-x86_64-release.apk
If the connection panel in the App shows a blank Bluetooth connection list, first check whether you have granted the App Bluetooth and location permissions. If it still shows a blank list, try to install the previous stable version. v1.4.0-37-1-app-release-20251006.apk

Connect to the robot
For the robot's mainboard, you need to set it up according to the related subpage instructions.
The app will send a greeting to the Bluetooth device and expect a response from the robot. You must upload the OpenCat (for NyBoard) / OpenCatEsp32 (for BiBoard) firmware to your robot before connecting to the app. Otherwise, the app will consider it "not a Petoi device". A pre-assembled robot should already have the firmware installed. Otherwise, you'll need to upload firmware using the Petoi Desktop app.
For BiBoard, please ensure the program enters the regular startup mode.
Open the app and scan available Bluetooth devices. Don't connect the robot with the phone's system-wide Bluetooth settings! Connect the device with the name Bittle, Petoi, or OpenCat.
Please remember to enable Bluetooth and give the app access to it. On some devices, you may also need to allow the app's location service, though we are not using any of that information.
On some Android OS, you need to activate the location service as follows:

The app will open the Control Panel interface when Bluetooth is connected. If the robot doesn't respond or malfunctions later, press the reset button on the mainboard to restart the robot.
The app should automatically detect the supported robot type based on the latest firmware. Otherwise, it will show the selections for the robot type. The above interface can also be revisited by selecting the option "Select a robot" in the control panel.

Last updated