> For the complete documentation index, see [llms.txt](https://docs.ceruleansonar.com/c/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.ceruleansonar.com/c/sonarview/session-configurations/surveyor-+-mavlink2rest-position-heading.md).

# Surveyor + MAVLink2Rest Position/Heading

These instructions set up using the Surveyor with position and heading from a mavlink2rest vehicle (e.g. Blueboat, BlueROV). 

Step 0: Go to Session Configurations in SonarView

Step 1. Click 'Add Device' and add your Surveyor with correct IP address and mounting/roll offsets and hit 'Save':

<figure><img src="/files/X7t3DQff9EgAHsc2Uz5F" alt="" width="251"><figcaption></figcaption></figure>

Surveyor Specific Options:

1. Mounting Angle:

   Roll: Sets the roll of the Surveyor relative to the vehicle. Since the Surveyor has an IMU to calculate the roll of the device, this just affects how the boat is displayed, not where the data ends up

   Pitch and yaw offsets must be 0
2. Mounting Offset (relative to center of Mavlink Vehicle):

   X: Positive if Surveyor is in front of the center of the vehicle

   Y: Positive if the Surveyor is starboard of the center of the vehicle

   Z: Positive if the Surveyor is below the center of the vehicle&#x20;

Click [here](/c/surveyor-240-16/coordinate-frame.md) for Surveyor coordinate frame definition

{% hint style="info" %}
Surveyor Specifc Options overwrite any offsets set up during a single device session
{% endhint %}

Step 2: Click 'Add Vehicle' and add your mavlink vehicle with correct IP address, the 'mavlink2rest' protocol, and the correct System ID. Hit Save:

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

Step 3: Click 'Add Session', add the Surveyor and Vehicle to the session, and hit 'Save'. Your Session Configurations page should now have something like this:<br>

<figure><img src="/files/28H9fsWdbIXiCOPtvfLX" alt=""><figcaption></figcaption></figure>

With that completed and your Surveyor and vehicle connected to SonarLink, you can now find this session in discovery and connect to it.


---

# 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.ceruleansonar.com/c/sonarview/session-configurations/surveyor-+-mavlink2rest-position-heading.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.