> For the complete documentation index, see [llms.txt](https://guide.petoi.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://guide.petoi.com/product/bittle-x-v2/control-and-programming/mobile-app.md).

# Mobile App

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)](https://github.com/PetoiCamp/OpenCat) / [OpenCatEsp32(for BiBoard)](https://github.com/PetoiCamp/OpenCatEsp32) firmware on GitHub for the best compatibility and the newest features.&#x20;

## Download and installation

The app works on both Android and iOS devices.

* [iOS 11+](https://apps.apple.com/us/app/petoi/id1581548095)
* [Android 4.4+](https://play.google.com/store/apps/details?id=com.petoi.petoiapp)

#### APK

For Android, you can also download the APK and install it on your phone.&#x20;

* The universal version(try this one first)\
  [v1.4.1-40-2-20251022-app-release.apk](https://github.com/PetoiCamp/MobileApp/releases/download/1.4.1/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](https://github.com/PetoiCamp/MobileApp/releases/download/1.4.1/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](https://github.com/PetoiCamp/MobileApp/releases/download/1.4.1/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](https://github.com/PetoiCamp/MobileApp/releases/download/1.4.1/v1.4.1-40-2-20251022-app-x86_64-release.apk)

{% hint style="info" %}
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](https://github.com/PetoiCamp/MobileApp/releases/download/1.4.0/v1.4.0-37-1-app-release-20251006.apk)
{% endhint %}

![](/files/G1cSapHMlJK9sDQ53TMN)

## Connect to the robot

For the mainboard BiBoard, the Bluetooth module is already built into the ESP32 module; you just need to power on the robot by long-pressing the button on the battery.

{% hint style="warning" %}
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](https://guide.petoi.com/desktop-app/firmware-uploader).&#x20;
{% endhint %}

{% hint style="warning" %}
For BiBoard, please ensure the program enters the [**regular startup mode**](https://guide.petoi.com/arduino-ide/upload-sketch-for-biboard#id-2.8-program-initialization)**.**
{% endhint %}

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.&#x20;

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.

{% hint style="info" %}
On some Android OS, you need to activate the location service as follows:![](/files/tu2Vwheh7gELyuRGt2ZJ)
{% endhint %}

![](/files/-MjZWU2EpJOmFcBOEKGH)

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.

![](/files/FG3i4k9cmd0KgFjfCaYH)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://guide.petoi.com/product/bittle-x-v2/control-and-programming/mobile-app.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
