> For the complete documentation index, see [llms.txt](https://docs.petoi.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.petoi.com/~/changes/MnaoHQ6wOvffal3XIPZR/mobile-app/app-guide.md).

# Calibrator

## Calibrate the joints

### Nybble

![Calibration Interface](/files/0GXfFnXvrwhFPB6Utc4d)

### Bittle

![Calibration Interface](/files/-MjZW3to7df6RE8rV5V7)

{% hint style="info" %}
The above interfaces will be displayed when you calibrate for the first time. You can also click to open the upper-right menu in the control panel and select **Calibrate** to re-access.

![](/files/JK6QL4MkFti57WTk401r)
{% endhint %}

## Prepare for calibration

{% hint style="info" %}
Make sure you have uploaded the OpenCat [**Main function**](https://docs.petoi.com/desktop-app/firmware-uploader#uploading-process) firmware before calibrating.

Only the software version 2.0 is supported to calibrate the joints via this App.
{% endhint %}

You need to connect the [**Bluetooth module**](https://docs.petoi.com/communication-modules/dual-mode-bluetooth#connection-with-nyboard) (for NyBoard only) with computer, install the battery and long-press the button on the battery to power the robot.

## Enter the calibration state

After the robot is powered on, there are 2 methods to enter the calibration state:

* Click the **Start Calibration** button.<br>

  <figure><img src="/files/GwH4B1KbYFIOhQPudrrF" alt=""><figcaption></figcaption></figure>
* Click the **Calibration** button in the calibration interface.<br>

  <figure><img src="/files/FCRxFXfNFSFOIpN7HZWo" alt=""><figcaption></figcaption></figure>

### Install the head

In the calibration state, place the head as close to the central axis as possible and insert its servo shaft into the servo arm of the neck.

<figure><img src="/files/avQ8YXT0jNhmIiW2oPIy" alt=""><figcaption></figcaption></figure>

Press down on the head so it is firmly attached to the neck.

<figure><img src="/files/Ux0zFualAZghlx3qphHi" alt=""><figcaption></figcaption></figure>

### Install the legs&#x20;

Install upper leg and lower leg components to the output teeth of the servos when the Bittle is powered on and in the calibration state. Please keep the torso, upper leg, and lower leg installed vertically as much as possible, and do not install the lower leg backward, as shown in the picture.&#x20;

<figure><img src="/files/5JHkO04jxSvTH1ySJJRy" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
The pre-assembled robot should already have the legs properly installed. You can do the joint calibration for fine-tuning.&#x20;
{% endhint %}

**Use the included L-shaped tool as a reference!**

#### Nybble

![](/files/HXHygTlSauC6GsdgjoHb)

#### Bittle

![](/files/hwBOViu4Z8HHD76rSsjT)

![Align the upper leg first](/files/QpS91FEEbFx1kWR8Yofo)

![Pay attention to the reference edges for the lower leg](/files/kuwZZVGFrrkgDo4rhGiH)

When calibrating, first select the index number of the joint servo from the diagram(when adjusting the leg servo, adjust the thigh first, and then adjust the calf), and then click the "+" or "-" button to fine-tune the joint to the right angle state.&#x20;

{% hint style="info" %}
If the offset is more than +/- 9 degrees, you need to remove the corresponding part of the servo and re-install it by rotating one tooth, and then press the "+" or "-" button.

For example, if you have to use -10 as the calibration value, take the limb off, rotate by one tooth then attach it back. The new calibration value should be around 4, i.e.,  they sum up to 14. Avoid rotating the servo shaft during this adjustment.&#x20;
{% endhint %}

You can click the skill buttons to switch between **Rest**, **Stand**, and **Walk** to test the calibration effect.&#x20;

![Bittle](/files/vQv5sjbxiNJmcbZd4v2X)

If you want to continue calibrating, please click the **Calibration** button, and the robot will be in the calibration state again (all servos will move to the calibration position immediately).&#x20;

{% hint style="info" %}
Note:&#x20;

You may need a second round of calibrations to achieve optimal results.
{% endhint %}

After calibration, remember to click the "Save" button to save the calibration offset. Otherwise, click "<" in the upper left corner to abandon the calibration.

### Install the screws

After completing the joint calibration, install the center screws to fix the leg parts and servo gears.


---

# 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://docs.petoi.com/~/changes/MnaoHQ6wOvffal3XIPZR/mobile-app/app-guide.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.
