# Gremsy Gimbals

<div align="left"><figure><img src="https://3329189600-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FFW1Ge1p1f6WHyiYCb146%2Fuploads%2Fgit-blob-4d3f9c813ef1f2b54b9ee5416aba7a05273b5b90%2Fimage.png?alt=media" alt="" width="270"><figcaption></figcaption></figure></div>

## Supported Gimbals

Currently, we support the following Gimbals from Gremsy

* [Pixy U](https://gremsy.com/products/pixy-u)
* [S1V3](https://gremsy.com/products/gremsy-s1v3)
* [T3V3](https://gremsy.com/products/gremsy-t3v3)
* [Pixy PE](https://gremsy.com/pixy-pe-spec)
* [T3 PE](https://gremsy.com/gremsy-t3-pe-spec)

{% hint style="warning" %}
The supported way to interface with these gimbals is using the MAVLink gimbal protocol v2. We discourage the use of legacy control modes such as PWM or S.BUS or the MAVLink gimbal v1 protocol.
{% endhint %}

## Software configuration

* Download and install the gTune 1.4.7.2 for Windows from [here](https://github.com/Gremsy/gTuneDesktop/releases/latest), along with the Windows USB drivers available [here](https://www.silabs.com/documents/public/software/CP210x_Universal_Windows_Driver.zip)
* Download the latest Gremsy gimbal firmware for your specific model [here](https://github.com/Gremsy/MAVLink-Protocol-V2-Firmware/releases) and use gTune to flash it onto your gimbal

<figure><img src="https://3329189600-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FFW1Ge1p1f6WHyiYCb146%2Fuploads%2Fgit-blob-888e01d9791917e4ef147fbb9fdcf09213e94049%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

* Power on the Gimbal, attach it to your computer using a micro-USB cable and then connect to it with gTune.
* Select "Controls" and then "Herelink". Do **not** enable Herelink, but use this tab to set the tilt deadzone to zero

![](https://3329189600-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FFW1Ge1p1f6WHyiYCb146%2Fuploads%2Fgit-blob-56b0dd65da94a6a27ec444e6443c7a17573e6863%2Fcap2.PNG.png?alt=media)

* Still under "Controls", select "Mavlink", this time select YES when prompted to enable MAVLink input

![](https://3329189600-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FFW1Ge1p1f6WHyiYCb146%2Fuploads%2Fgit-blob-e57337c95652243d8020f208b9dffe4e48d6ea8d%2Fcap3.PNG.png?alt=media)

{% hint style="info" %}
You may need to configure and tune your gimbal further for your specific payload depending on it's weight, center of gravity and desired behavior
{% endhint %}

* Power on Skynode, connect to it via USB-C and change the following parameters using [Auterion Mission Control's Advanced mode](https://docs.auterion.com/hardware-integration/flight-controller-customization/amcs-advanced-mode)
  1. `MAV_2_CONFIG` = 401 (PPB)
  2. `MAV_2_MODE` = 10 (Gimbal)
  3. `SER_PPB_BAUD` = 115200
  4. `MAV_2_FORWARD` = 1
  5. `MAV_S_FORWARD` = 1
  6. `MNT_MODE_IN` = 4 (MAVLink Gimbal v2)
  7. reboot
  8. refresh parameters or restart AMC
  9. `MNT_MODE_OUT` = 2 (MAVLink Gimbal v2)

## Hardware setup

* On the payload side, the AUX channels of the gimbal can be leveraged to route the required signals such as USB, Ethernet and power through the gimbal. A custom cable will typically need to be made to match your payload. An example for the [Workswell Wiris Pro](https://docs.auterion.com/hardware-integration/skynode/payloads/workswell-wiris-pro-and-wiris-security) is shown below

![](https://3329189600-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FFW1Ge1p1f6WHyiYCb146%2Fuploads%2Fgit-blob-b0f5107783662ef9080fe96f29899804efe4637c%2FPXL_20211118_100007472.jpg?alt=media) ![](https://3329189600-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FFW1Ge1p1f6WHyiYCb146%2Fuploads%2Fgit-blob-4facb0048fac0e60ee2f7decfecb0dd7c84bf51c%2FPXL_20211118_100138983.jpg?alt=media)

{% hint style="warning" %}
Note that the first two pins of the gimbal's AUX port are connected to the 12V supply rail and ground. These can be used to power a payload, but they are not suitable to carry data signals through the gimbal. Applying 12V to a data line could seriously damage a camera!
{% endhint %}

* Use Gremsy's Pixhawk UART cable to connect the gimbal's **COM2** to the Pixhawk Payload Bus UART port labelled **GPS2** and use your custom cable to grab the payload data signals from the gimbal's AUX channels and feed them into the Pixhawk Payload bus. Don't forget to supply the Gimbal with power using Gremsy's UBEC module.

![Wiring Pixy U to the Pixhawk Payload Bus](https://3329189600-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FFW1Ge1p1f6WHyiYCb146%2Fuploads%2Fgit-blob-b233f1081f42063304563f1842482445d1899104%2FPXL_20211118_101200651.jpg?alt=media)

* A finalized bench setup could look something like this

![Pixy U with Workswell Wiris Pro connected to Skynode via the Pixhawk Payload Bus](https://3329189600-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FFW1Ge1p1f6WHyiYCb146%2Fuploads%2Fgit-blob-1b65e24f6bcb6a8262662f0888fa1c7a3063ac18%2FPXL_20211118_102819510.jpg?alt=media)
