> For the complete documentation index, see [llms.txt](https://docs.gremsy.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.gremsy.com/gimbals/pixy-lr-sp/installation/viozio-control-cable/control-gimbal-and-camera.md).

# CONTROL GIMBAL & CAMERA

### **INSTALLATION OF MAVCAM FOR HERELINK** <a href="#bkmrk-installation-of-mavc" id="bkmrk-installation-of-mavc"></a>

1\)  [***Download***](https://share.airpixel.cz/MavCamHL.zip?9&_gl=1*yjrkxs*_ga*NTIxMzI4NDYwLjE3NTA3NDE4MjI.*_ga_GRL2Y7G52R*czE3NzIxNzU5NzgkbzM5JGcxJHQxNzcyMTc2OTA0JGo2MCRsMCRoMA..) and Unzip file MavCamHL.apk\
2\)  Copy file to microSD card\
3\)  Insert SD card to your Herelink\
4\)  Click to notification – “New SD card detected”\
5\)  Select “USE as portable storage” and confirm NEXT and DONE\
6\)  Re-open notification area, click to “SD Card for transferring photos and media”\
7\)  Click to MavCamHL.apk\
8\)  Allow external sources if necessary\
9\)  Install\
10\)  Open app\
11\)  Confirm “drawing over other apps” (this needs to be done only first time)\
12\)  Click home button\
13\)  In right bottom corner open list of installed applications\
14\)  Run MavCam

### **Tips and Tricks**

***Swipe shortcuts***

Main handle is used as shortcut to other menus via Swiping:\
1\)   **SWIPE RIGHT** – MavCam configuration\
2\)    **SWIPE UP** – Camera configuration (Shutterspeed / Aperture / etc.)\
&#x20;     • Camera configuration panel has small handle at right edge, which will expand panel with information about Entire status, and Entire configuration\
3\)    **SWIPE LEFT** – hide MavCam\
&#x20;     • This is handy when you need to use software keyboard, where sometimes MavCam interfere with ENTER key. Swipe up in the middle of bottom screen to re-open MavCam

***Control via C & D buttons***

You can enable capturing of C & D buttons on the HereLink by MavCam. Then you can use C & D buttons to control exposure or zoom.

**1)    LONG PRESS D** – will open popup window, where you can select function to be controlled

**2)    SHORT PRESS C or D** – will execute selected function (Button C increases the value, Button D decreases the value.)

Last used function for CD tool is saved, so after reboot will be set automatically. If you lastly used ZOOM, after reboot will CD buttons control ZOOM again

{% hint style="warning" %}
***Warning*** : C & D buttons must be disabled in other applications, otherwise will execute also other configured functions under QGC or Solex, or HereLink settings
{% endhint %}

## **CONTROL GIMBAL** <a href="#bkmrk-control-gimbal" id="bkmrk-control-gimbal"></a>

#### Configure the Herelink Buttons

Assign the following functions on the Herelink remote controller:

* **CAM Short Press** → **Channel 9**
* **Scroll Wheel** → **Channel 10**

Refer to [**the section**](/gimbals/pixy-lr-sp/installation/viozio-control-cable/setup-with-the-ardupilot-system.md#enable-sbus-output-on-pixhawk-optional-feature) for instructions on enabling **SBUS Output** on the Pixhawk.

#### Operation

After rebooting the system:

* Press **CAM Short Press** to switch the control axis between **PAN** and **TILT**.
* Use the **Scroll Wheel** to control the selected axis:
  * **PAN:** Rotate left/right
  * **TILT:** Move up/down

You can also use the **MAVCAM** application to switch between controlling the gimbal with the **Herelink buttons** or the **on-screen joystick**.

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

{% hint style="info" %}
**Note:** When the **on-screen joystick** is active, control via the Herelink buttons is automatically disabled. To re-enable Herelink button control, tap the button highlighted in the red box in the reference image.
{% endhint %}

**Quick Tilt Position Control:** To quickly move the gimbal's **Tilt** axis to **90°** or return it to the **Home position (0°)**, tap the button highlighted in the red box, as shown in the figure below.

<figure><img src="/files/yTXipbwDvwwEE1aB7ivF" alt="" width="563"><figcaption></figcaption></figure>

ON/OFF Gimbal

<figure><img src="/files/lZc22FSehqdiCjtmfKv3" alt="" width="563"><figcaption></figcaption></figure>

## **CONTROL CAMERA** <a href="#bkmrk-c2-a0-3" id="bkmrk-c2-a0-3"></a>

### Recording & Capture

**Recording:**

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

**Capture**

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

### **Geotagging**

Press the "GTG" button to open the geotag popup

* **Start**: Press this button to activate the GPS coordinate recording system. When you press Start, the status in the "***STATUS***" box will change to active recording.
* **Stop**: Press this button when you want to stop recording coordinates or when the mission is finished
* **GTG:** When the entire system successfully checks all necessary conditions, the "GTG" icon will turn green. (The camera will take a picture to verify the system).
* **Running**: Displays the operating status (Running).
* **The number in parentheses (0)**: This is usually the number of files (images/locations) that have been successfully geotagged. As you start capturing, this number will increase

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

### **Takeoff detection**:&#x20;

{% hint style="info" %}
**Note:** This feature should only be **enabled** when the system is used for **mapping missions**.
{% endhint %}

This function automates tagging based on the device's status.

* **ENABLED**: The system automatically starts geotagging when the device takes off from the ground and automatically stops when it lands. (This helps filter out noisy data or test images taken while the device is still on the ground during the mapping mission.)
* **DISABLED**: Use the "Start" and "Stop" buttons for manual setup.

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

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

### Camera Setting

The **C** and **D** buttons on the Herelink remote controller can be used to adjust the following camera settings:

* ISO
* Shutter Speed
* Iris
* Zoom
* Exposure Compensation (EXP C)
* White Balance (WB)

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

#### Step 1: Connect the Camera to the Entire Wi-Fi Network

If the camera is already connected to the **Entire** module's Wi-Fi, proceed to **Step 2**.

> **Note:**\
> After the connection is established successfully, the **"PC"** indicator changes from **CAM** to **white**, as shown in the figure above.

For detailed instructions, refer to: <https://airpixel.cz/docs/lr1-control-geotagging/>

#### Step 2: Enable CD Tools

Open the **MAVCAM** application, swipe the toolbar to the right, locate the **CD Tools** icon, and enable it.

#### Step 3: Adjust Camera Settings

Press and hold the **D** button until the settings menu appears, then select the camera parameter you want to configure.

Button functions:

* **C Button** – Increase the selected value
* **D Button** – Decrease the selected value

## SETUP MAPPING MISSION

### Configure an Automatic Mapping Mission

#### Step 1: Verify the SD Card

Ensure that an SD card is installed in the camera and that sufficient free storage is available.

#### Step 2: Create a Mapping Mission

Create the mapping mission using **Mission Planner** or **QGroundControl** as usual.

For detailed instructions, refer to: <https://docs.qgroundcontrol.com/master/en/qgc-user-guide/plan_view/pattern_survey.html>

#### Step 3: Upload the Mission

Upload the generated mission to the Pixhawk flight controller.

#### Step 4: Modify the Mission Command in Mission Planner

For detailed instructions, refer to:&#x20;

In **Mission Planner**:

1. Go to the **Plan** tab.
2. Click **Read** in the upper-right corner to load the mission previously uploaded to the Pixhawk in **Step 3**.
3. Locate the **DO\_MOUNT\_CONTROL** mission command.
4. Change the command to **DO\_DIGICAM\_CONFIG**, as shown in the figure below.

> **Note:** This modification ensures that the camera is triggered correctly during the mapping mission.

<figure><img src="/files/26edEoQKF2Zud4Kl6FuW" alt=""><figcaption></figcaption></figure>

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

When modifying the mission commands, use the following settings:

* **Mode** = `250`
* **CommandID** = The target gimbal angle (always enter a **positive** value).

**Example**

For the mission shown above:

* **After takeoff**, if you want the gimbal to **tilt down to -90°**:
  * **Mode** = `250`
  * **CommandID** = `90`
  * **Direction** = `2`
* **Before RTL (Return to Launch)**, if you want the gimbal to **return to the Home position (0°)**:
  * **Mode** = `250`
  * **CommandID** = `0`
  * **Direction** = `1`

#### Step 5: Upload the Updated Mission

After modifying the mission commands, upload the updated mission back to the Pixhawk.

#### Step 6: Perform a Test Flight

Execute a test flight to verify that the gimbal moves to the expected positions and that the camera operates correctly throughout the mission.


---

# 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.gremsy.com/gimbals/pixy-lr-sp/installation/viozio-control-cable/control-gimbal-and-camera.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.
