> 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/mobile-app/petoi-portal.md).

# Petoi Portal

We designed a new mobile App—**Petoi Portal**. The app lets you connect the robot via Bluetooth or WiFi. It includes a block-based coding interface and a simulated UI for Quaddle’s physical controller.&#x20;

<div><figure><img src="https://4130507397-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXLpFdG7mubqEHWylLK3w%2Fuploads%2F8EmjgXt2LiRZ1aZ5GNRV%2FIMG_4865.PNG?alt=media&amp;token=334810c0-6974-417a-9d41-e96900302859" alt=""><figcaption><p>Blocks interface</p></figcaption></figure> <figure><img src="https://4130507397-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXLpFdG7mubqEHWylLK3w%2Fuploads%2FOMG2WOJOBMAtBdcOH376%2FIMG_4866.PNG?alt=media&amp;token=d22fd213-e037-4c27-9921-3f03358cb97f" alt=""><figcaption><p>Quaddle's controller</p></figcaption></figure></div>

* Android version\
  The Android version is under review for public listing. You may try this Android APK.

{% file src="/files/WjWHePRntizuVjtT6YMR" %}

* [iOS version](https://apps.apple.com/us/app/petoi-portal/id6760995941)

## Connect to the main board

For Quaddle, pinch Quaddle's body and quickly flip it upward (so the front display faces up). Hold it in this position for about 1 second, and the screen will display Quaddle’s IP address (it will show **0.0.0.0** if **no IP address** has been assigned), its Bluetooth name, and its battery status.

### Bluetooth

Enable Bluetooth and location services in your phone’s system settings. And allow the app to use Location, though we don't use that information. Open the app and scan for available Bluetooth devices.

{% hint style="warning" %}
&#x20;**Don't connect the robot with the phone's system-wide Bluetooth settings!**
{% endhint %}

For Quaddle's motion core board, the Bluetooth module is built into the ESP32S3 module; just power on the robot by short-pressing the power button on the underside of Quaddle's body.

{% hint style="info" %}
For the BiBoard and NyBoard Petoi products, please refer to [the connection method](https://guide.petoi.com/mobile-app/petoi/connect-to-the-mainboard.md) in the Petoi app.
{% endhint %}

### Wi-Fi

For Quaddle **with** [the AI Core module,](https://guide.petoi.com/product/quaddle-under-construction/control-and-program/ai-conversation.md) once the Tuya network configuration is complete, the Motion Core board will be automatically assigned an IP address. You can view this IP address at any time by quickly flipping Quaddle’s body, as described above.

For Quaddle **without** the AI Core module, [connect the Motion Core board](https://guide.petoi.com/product/quaddle-under-construction/quick-start-guide/update-firmwares/update-firmware-for-motion-core.md#connect-to-the-motion-core-board) to a computer via a USB cable, open a [serial monitor](https://guide.petoi.com/desktop-app/tools.md#the-serial-monitor), and send the serial command: "***w%ssid%password***" to configure the network and retrieve the IP address.

{% hint style="info" %}
For the BiBoard products, connect the board to a computer using a USB cable; the process is the same as that for Quaddle without an AI Core module.
{% endhint %}

{% hint style="info" %}
For the NyBoard products, you will need a Wi-Fi module that has already been configured for the network. Note the IP address it has been assigned, then plug it into the NyBoard and power on the robot.
{% endhint %}


---

# 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://guide.petoi.com/mobile-app/petoi-portal.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
