# Controller Configuration

## Navigating to Controller Settings

To navigate to the Controller Settings menu, click "Controller" on the main menu screen.

<figure><img src="https://1836517361-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fb4gMJ8PjT5QccaZNi3oB%2Fuploads%2Fsx42R3vAcHgzi7FgId8H%2Fimage.png?alt=media&#x26;token=c684e012-8a4b-4081-aba7-4c0ea8f42e97" alt=""><figcaption></figcaption></figure>

This will bring you to the Controller Settings menu.

<figure><img src="https://1836517361-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fb4gMJ8PjT5QccaZNi3oB%2Fuploads%2FG8RWao3ZSnwadn2eR06W%2Fimage.png?alt=media&#x26;token=df3e41d7-2d83-4737-a69a-919d1ed049d8" alt=""><figcaption></figcaption></figure>

Alternatively, if you are already in a different settings menu or the scenario selection menu, you can navigate to the Controller Settings menu by clicking the Controller Settings tab (represented by an image of a drone controller).

<figure><img src="https://1836517361-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fb4gMJ8PjT5QccaZNi3oB%2Fuploads%2FSI7SS6bj2lplhagyrNaf%2Fimage.png?alt=media&#x26;token=10c82f32-9a50-4078-ba07-c81383bbec2e" alt=""><figcaption></figcaption></figure>

## Understanding the Controller Settings Menu

<figure><img src="https://1836517361-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fb4gMJ8PjT5QccaZNi3oB%2Fuploads%2F5qMNxL97o62XEzOt77up%2Fimage.png?alt=media&#x26;token=3233bdac-24a1-4857-a1d0-2953f03af378" alt=""><figcaption></figcaption></figure>

1. Calibration
   1. Selecting this tab takes the user to the Calibration page, where they can adjust their controller's calibration and stick deadzones.
2. Mapping
   1. Selecting this tab takes the user to the Mapping page, where they remap key inputs for their keyboard and controller.
3. Mobile Controller
   1. Selecting this tab takes the user to the Mobile Controller page. This is deprecated functionality and is no longer officially supported.
4. Quick Calibration
   1. Selecting this option brings up the Quick Calibration user interface, allowing the user to quickly adjust their controller's calibration.
5. In-depth Calibration
   1. Selecting this option brings up the In-depth Calibration user interface, allowing users a more advanced process for calibrating their controller.
6. Clear Calibration
   1. Clears the controller calibration data stored in Zephyr, returning it to default.
7. Stick Input Display
   1. Stick input on the users controller will be reflected by the two crosshairs, allowing the user to see how Zephyr is reading their controller's stick input.
8. Stick Deadzone Adjustment
   1. This is the Stick Deadzone Adjustment user interface. The user can enter a custom stick deadzone value or clear the value to return it to default.

## Calibration

### Quick Calibration

If you need to perform a quick calibration of your controller, begin by selecting the "Quick Calibration" button.

<figure><img src="https://1836517361-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fb4gMJ8PjT5QccaZNi3oB%2Fuploads%2FCVP8hR5iq1jKhkVobUqM%2Fimage.png?alt=media&#x26;token=1bddede0-3c88-4e69-ae53-3800d3cdace6" alt=""><figcaption></figcaption></figure>

Next, follow the on-screen prompts with the sticks on your controller.

You will first move both sticks up and to the left and then hold them in that position until the on-screen prompt changes.

<figure><img src="https://1836517361-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fb4gMJ8PjT5QccaZNi3oB%2Fuploads%2F8TGggAmx8PoKLzj5Sgpw%2Fimage.png?alt=media&#x26;token=273a1b6d-498d-4363-9809-8d56cad683d4" alt=""><figcaption></figcaption></figure>

You will then move both sticks down and to the right and then hold them in that position until the on-screen prompt changes.

<figure><img src="https://1836517361-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fb4gMJ8PjT5QccaZNi3oB%2Fuploads%2FKop5W37aaEfjUu4KwJ2J%2Fimage.png?alt=media&#x26;token=dfd1b0c3-fe9b-4ed9-9a32-117cf24bb8f1" alt=""><figcaption></figcaption></figure>

Your controller should now be calibrated.

### In-depth Calibration

If you wish to perform a more advanced calibration of your controller, begin by selecting the "In-depth Calibration" button.

<figure><img src="https://1836517361-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fb4gMJ8PjT5QccaZNi3oB%2Fuploads%2FU7hDcRP8T55yux75Ufpb%2Fimage.png?alt=media&#x26;token=7495112f-ccbd-4daa-9802-15f70f63dd00" alt=""><figcaption></figcaption></figure>

Next, follow the on-screen prompts with the sticks on your controller.

Begin by moving both sticks straight up and then holding them in that position until the on-screen prompt changes.

<figure><img src="https://1836517361-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fb4gMJ8PjT5QccaZNi3oB%2Fuploads%2FlQPzWj3nCeBG930jNsfx%2Fimage.png?alt=media&#x26;token=1e58e08b-409b-4999-9aca-1db0a8b0afdb" alt=""><figcaption></figcaption></figure>

Next, move both sticks straight down and then hold them in that position until the on-screen prompt changes.

<figure><img src="https://1836517361-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fb4gMJ8PjT5QccaZNi3oB%2Fuploads%2FtVB3c05tM7eGJxpGnY8f%2Fimage.png?alt=media&#x26;token=d2289f84-1176-4bef-a0b9-aa6e02eda1cd" alt=""><figcaption></figcaption></figure>

Next, move both sticks to the left and then hold them in that position until the on-screen prompt changes.

<figure><img src="https://1836517361-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fb4gMJ8PjT5QccaZNi3oB%2Fuploads%2FFS71VU2VIM0dtM3umIEv%2Fimage.png?alt=media&#x26;token=f68d58af-ee54-4281-af36-1ad72f43d854" alt=""><figcaption></figcaption></figure>

Next, move both sticks to the right and then hold them in that position until the on-screen prompt changes.

<figure><img src="https://1836517361-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fb4gMJ8PjT5QccaZNi3oB%2Fuploads%2FBcE8s8T2B2Vgr4RgDIVR%2Fimage.png?alt=media&#x26;token=c749b75b-11ee-4b92-b372-5b7975f9ea39" alt=""><figcaption></figcaption></figure>

Your controller should now be calibrated.

### Clear Calibration

If you encounter odd behavior with your controller after calibration, clearing your calibration data is a good place to start.

Clicking "Clear Calibration" will delete your calibration data.

<figure><img src="https://1836517361-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fb4gMJ8PjT5QccaZNi3oB%2Fuploads%2FYsWiZm4tq1cCbctepVuO%2Fimage.png?alt=media&#x26;token=788a2d6b-4925-4d12-bcdc-319ba36f2f06" alt=""><figcaption></figcaption></figure>

{% hint style="warning" %}
There will not be a popup after you click the button.
{% endhint %}

## Deadzones

A stick's center deadzone value is the radius around the center of the stick where input is not registered - a "dead zone".

To adjust your controller's stick center deadzone, begin by clicking on the white text field, as shown below.

<figure><img src="https://1836517361-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fb4gMJ8PjT5QccaZNi3oB%2Fuploads%2FiSUmDdUse7AGJstMPIJy%2Fimage.png?alt=media&#x26;token=9e0c0a0c-4ffb-4e99-bb45-3753098f0465" alt=""><figcaption></figcaption></figure>

Next, enter your desired value between 0 and 1.

<figure><img src="https://1836517361-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fb4gMJ8PjT5QccaZNi3oB%2Fuploads%2FyacRjYIOsw3G5DQ99g0R%2Fimage.png?alt=media&#x26;token=9c55c609-26f8-4360-aa79-e1c766519565" alt=""><figcaption></figcaption></figure>

Finally, click "Set" to save the new deadzone setting.

{% hint style="warning" %}
The deadzone setting is not saved until you click "Set".
{% endhint %}

<figure><img src="https://1836517361-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fb4gMJ8PjT5QccaZNi3oB%2Fuploads%2FQuQtUBCRzHSbIMzfyD2s%2Fimage.png?alt=media&#x26;token=575a6457-b5c5-4a73-9ffb-9ed37179ca0b" alt=""><figcaption></figcaption></figure>

If you wish to return your deadzone settings to default, simply click "Clear" for both stick settings.

<figure><img src="https://1836517361-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fb4gMJ8PjT5QccaZNi3oB%2Fuploads%2FXRywXkgiN3zjeUgm0yG0%2Fimage.png?alt=media&#x26;token=450cc7fd-18a2-4fe0-bc51-9862564d45bb" alt=""><figcaption></figcaption></figure>

## Mapping

The Mapping page allows users to custom map inputs to suit their individual preferences.

<figure><img src="https://1836517361-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fb4gMJ8PjT5QccaZNi3oB%2Fuploads%2Fp8eeV0sTSKCITsoZy85I%2Fimage.png?alt=media&#x26;token=8c45f517-8c32-4540-96d5-cdc0ad558ba6" alt=""><figcaption></figcaption></figure>

### Custom Input Mapping

To add or change the mapping of a function to an input, begin by selecting the function you wish to map an input to.

<figure><img src="https://1836517361-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fb4gMJ8PjT5QccaZNi3oB%2Fuploads%2FWXa6hDojblsczCiTCQV6%2Fimage.png?alt=media&#x26;token=aa233ad1-56ff-409f-b1ce-2b8ce6ac74c9" alt=""><figcaption></figcaption></figure>

After selecting the function you wish to map an input to, a user interface will appear with three options:

<figure><img src="https://1836517361-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fb4gMJ8PjT5QccaZNi3oB%2Fuploads%2FoEBFIWSUZEZqixFhiJn6%2Fimage.png?alt=media&#x26;token=7c3adb28-31fe-41b4-b635-1609ee6c40e9" alt=""><figcaption></figcaption></figure>

1. Activate the control you with to map for \[Function]

   1. Maps the entered input to the function

   <figure><img src="https://1836517361-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fb4gMJ8PjT5QccaZNi3oB%2Fuploads%2FfeC0BOWvrBdWdb7OuME6%2Fimage.png?alt=media&#x26;token=3f7117d8-1100-49d9-b8b1-3fa098d9dc57" alt=""><figcaption></figcaption></figure>
2. Backspace to Clear

   1. Clears all inputs currently mapped to the indicated function

   <figure><img src="https://1836517361-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fb4gMJ8PjT5QccaZNi3oB%2Fuploads%2FyNFktrXn0z7Ekx23PA0r%2Fimage.png?alt=media&#x26;token=a26392c6-a0ec-4908-8621-b3cb40dfcd8d" alt=""><figcaption></figcaption></figure>
3. Esc to Cancel
   1. Closes the function mapping user interface without making any changes

### Restoring Default Mapping

If you wish to restore input mapping to default, simply click the "Restore Defaults" button.

<figure><img src="https://1836517361-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fb4gMJ8PjT5QccaZNi3oB%2Fuploads%2FdyA4z033Q6sJEp3FDiUq%2Fimage.png?alt=media&#x26;token=21bab91e-8c42-4dff-a8d7-6999c3cf12d1" alt=""><figcaption></figcaption></figure>


---

# Agent Instructions: 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:

```
GET https://wiki.zephyr-sim.com/getting-started/controller-configuration.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.
