# Tutorial

## Introduction

Learn everything you need to get started with Zephyr. Whether you are brand new to the simulator or an experienced operator looking for a refresher, this scenario is the best place to get started.

The Tutorial scenario consists of four modules that walk users through the basics of using Zephyr, from controlling a drone to completing module objectives. The four modules are:

1. Drone Power and Basic Control
2. Guide Drone, Flight Modes, and Control Modes
3. Camera Controls
4. Objectives

<figure><img src="/files/SfnOrpRfi2fRvcSAcIvK" alt=""><figcaption><p>Screenshot of the Module Selection Screen for the Tutorial Scenario</p></figcaption></figure>

## Drone Roster

For ease of use and simplicity, each module in the Tutorial scenario uses the DJI Phantom 4.

<figure><img src="/files/SDjp7QCBVT4NnBaTUijh" alt=""><figcaption><p>Screenshot of the Drone Selection for the Tutorial Scenario</p></figcaption></figure>

## Module Breakdowns

### Drone Power and Basic Controls

To power on the drone, move the sticks on your controller or press the corresponding keyboard keys into the positions shown on the screen and hold that position for two seconds.

<figure><img src="/files/9c531zCLKJaARlOB8DjB" alt=""><figcaption></figcaption></figure>

To increase the drone's altitude, press up on the `Left Stick` or `W` on the keyboard to throttle up.  Increase altitude until your drone reaches the purple box.

<figure><img src="/files/7rdpiSiLxRoQga48hL5W" alt=""><figcaption></figcaption></figure>

To decrease the drone's altitude, press down on the `Left Stick` or `S` on the keyboard to throttle down. Decrease altitude until your drone reaches the purple box.

<figure><img src="/files/1pE1zDS7w3NVuYw9Dgd5" alt=""><figcaption></figcaption></figure>

Rotation around the vertical axis of a drone is called "yaw". To change the yaw of the drone, hold the `Left Stick` right or left, or hold `A` or `D` on the keyboard.

Complete three full rotations to complete this objective.

<figure><img src="/files/9GHlNnUWe04L1KCotNna" alt=""><figcaption></figcaption></figure>

Rotation around the horizontal left-to-right axis is known as "pitch". To change the pitch of the drone, hold the `Right Stick` up or down, or hold the `Up` or `Down` arrow keys on the keyboard.

To complete this objective, pitch the drone forward so it moves to the purple box, and then pitch the drone backwards so it moves to the second purple box.

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

{% hint style="info" %}
In most flight modes, the drone will move relative to the direction it is facing, *not* the way the user is facing.  If the operator changes the pitch, the drone will move forward or backward relative to itself, as seen in the bottom right corner (Drone Camera).
{% endhint %}

Use a combination of yaw and pitch to pilot your drone into the purple boxes.

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

Rotation around the horizontal forward-to-backward axis is known as roll. To change the roll of the drone, hold the `Right Stick` left or right, or hold the `Right` or `Left` arrow keys on the keyboard.

Complete the objective by using roll to move your drone into both of the purple boxes.

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

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

Complete this objective by using a combination of yaw and roll to pilot your drone into the purple boxes.

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

Congratulations! You know understand the basics of piloting a drone in Zephyr. Please spend some time trying out the full range of controls.

### Guide Drone, Flight Modes, and Control Modes

#### Guide Drone

"Guide Drone" is a large overlay that shows the orientation of the drone even when far away or obscured by an object, allowing users better control of the drone. "Guide Drone" can be toggled on or off with `Left Shift` on the keyboard.

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

Use the Guide Drone to help you pilot the drone to the two purple boxes.

#### GPS Mode

{% hint style="info" %}
To switch Flight Modes, press `F1` on the keyboard
{% endhint %}

In GPS Mode, the drone will automatically adjust itself to maintain its position in space when the operator stops giving input.

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

#### Attitude Mode (ATTI)

{% hint style="info" %}
To switch Flight Modes, press `F1` on the keyboard
{% endhint %}

In ATTI mode, the drone has no positional stabilization, so it tends to drift after the operator stops giving input.

<figure><img src="/files/3v8HYG2D4HFLwH8EMa6B" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
To switch Control Modes, press `F2` on the keyboard
{% endhint %}

{% hint style="warning" %}
Not all Control Modes are available on all drones in Zephyr
{% endhint %}

#### CourseLock Mode

While a drone is in CourseLock Mode, its forward direction when it entered CourseLock will remain its forward direction while CourseLock is active. This means the same input will always move the drone in the same direction, regardless of its current yaw.

#### HomeLock Mode

When a drone enters HomeLock Mode, the geographical point the drone was located at becomes its "home point". This means horizonal input causes the drone to circle its home point.

### Camera Controls

{% hint style="warning" %}
Not all drones in Zephyr have the ability to move their cameras up and down
{% endhint %}

To switch cameras, press the corresponding button on your controller (often the left button on the rear of the controller) or `Spacebar` on the keyboard.

<figure><img src="/files/11ssQ9p1LizuxB3FU0Zj" alt=""><figcaption></figcaption></figure>

To pitch the drone camera up and down, use the corresponding inputs on your controller (often should dials) or press the `Home` and `End` keys on the keyboard.

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

### Objectives

#### Path Objective

With a Path objective, the drone must enter the objective cubes in the correct order - a "path".

Follow the path objective cubes in sequence from left to right.  A circular indicator will appear in the correct blue cube and begin to fill as the drone approaches it.

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

<figure><img src="/files/9u7zw7n79jap8dTeztxj" alt=""><figcaption></figcaption></figure>

#### Zone Objective

With a Zone objective, you must pilot the drone into the objective cube and remain within the cube until the objective completes.  For this specific objective, the drone needs to remain in the objective cube for five seconds.

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

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

Zone objectives may also appear as brackets or rings.

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

#### Target Objective

With a Target objective, you must pilot the drone into a Zone objective cube and then "capture" and object using the drone's camera.

Begin by piloting the drone into the Zone objective.

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

Once inside the Zone objective, a reticle will appear on the drone's camera. Aim the drones camera at the soccer ball in the middle of the gym.

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

Once the drone camera is correctly aimed the soccer ball, the target objective will begin to fill. Keep the target centered in the reticle until the objective completes.

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

#### Landing Objective

With a Landing objective, you must land the drone in a designated area.  For this specific objective, the drone needs to remain in the objective cube for five seconds.

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

Pilot the drone over the objective, and then lower the drone to the ground.

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

Continue to hold down on altitude (`Left Stick` down or `W` on the keyboard by default) to power down the drone.

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

{% hint style="info" %}
Not all Landing objectives require the drone to be powered off in order to be completed.
{% endhint %}


---

# 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/scenarios/tutorial.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.