# NextVision Adapter

## Description

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

**Skip unnecessary integration: Run the most popular payloads instantly.**

DroneCore Suite x NextVision Adapter is a combination of hardware and software for seamless transmission of the video stream from NextVision gimbals into the Jetson running on the DroneCore Suite.

**Box content**

* 1x NextVision Adapter for DCS, including a software driver.
* 1x Cam – FPC cable (length 10 cm / 20 cm / 25 cm)
* DroneCore x NextVision software license

***

## Dimensions

{% tabs %}
{% tab title="NextVision gimbal adapter" %}

<figure><img src="/files/GplMoGBy3B7E8ZTr0OBM" alt=""><figcaption></figcaption></figure>
{% endtab %}

{% tab title="NextVision gimbal adapter (DCS2 Payload)" %}

<figure><img src="/files/zHVJjR6LOabxyCSUzGfr" alt=""><figcaption></figcaption></figure>
{% endtab %}
{% endtabs %}

***

## Connectors and pinouts

{% tabs %}
{% tab title="NextVision gimbal adapter" %}

### Top side connectors <a href="#top-side-connectors" id="top-side-connectors"></a>

<figure><img src="https://docs.airvolute.com/~gitbook/image?url=https%3A%2F%2F341257526-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FkuuT7PXOBpck5wDlb6XM%252Fuploads%252Fgit-blob-e060be3a77ba1ce8e124c79b1bad0611a4c3627d%252FNextVision_Adapter_top_connectors.svg%3Falt%3Dmedia&#x26;width=768&#x26;dpr=3&#x26;quality=100&#x26;sign=6c74a740&#x26;sv=2" alt="" width="563"><figcaption></figcaption></figure>

<details>

<summary><strong>CAM</strong></summary>

* 501951-2210 connector type
* I2C is 3V3 logic

{% hint style="danger" %}
This connector can be connected/unconnected only when the system is powered off!
{% endhint %}

| pin | function    |
| --- | ----------- |
| 1   | 3V3         |
| 2   | I2C\_SDA    |
| 3   | I2C\_SCL    |
| 4   | GND         |
| 5   | NC          |
| 6   | NC          |
| 7   | GND         |
| 8   | NC          |
| 9   | NC          |
| 10  | GND         |
| 11  | NC          |
| 12  | NC          |
| 13  | GND         |
| 14  | CSI\_CLK\_P |
| 15  | CSI\_CLK\_N |
| 16  | GND         |
| 17  | CSI\_D1\_P  |
| 18  | CSI\_D1\_N  |
| 19  | GND         |
| 20  | CSI\_D0\_P  |
| 21  | CSI\_D0\_N  |
| 22  | NC          |

</details>

<details>

<summary><strong>USB</strong></summary>

* Matching connector JST GHR-04V-S
* USB 2.0 standard

| pin | function  |
| --- | --------- |
| 1   | VBUS      |
| 2   | USB\_D\_N |
| 3   | USB\_D\_P |
| 4   | GND       |

</details>

<details>

<summary><strong>NextVision</strong></summary>

Direct connection to Nextvision cable

</details>

***

### Bottom side connectors <a href="#bottom-side-connectors" id="bottom-side-connectors"></a>

<figure><img src="https://docs.airvolute.com/~gitbook/image?url=https%3A%2F%2F341257526-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FkuuT7PXOBpck5wDlb6XM%252Fuploads%252Fgit-blob-5629da54d3330e59c323df9e256217dd7ac357c1%252FNextVision_Adapter_bottom_connectors.svg%3Falt%3Dmedia&#x26;width=768&#x26;dpr=3&#x26;quality=100&#x26;sign=ab6cc0f9&#x26;sv=2" alt="" width="563"><figcaption></figcaption></figure>

<details>

<summary><strong>HDP emu jumper</strong></summary>

{% hint style="warning" %}
HPD emu is a workaround to support the Starling gimbal. In case another gimbal is used, please leave this bridge disconnected (remove the resistor)
{% endhint %}

</details>

<details>

<summary><strong>USB ZIF</strong></summary>

* USB 2.0 standard
* Compatible with Molex 538-15021 cable series

{% hint style="danger" %}
These connectors can be connected/unconnected only when the system is powered off!
{% endhint %}

| pin | function  |
| --- | --------- |
| 1   | VBUS      |
| 2   | VBUS      |
| 3   | VBUS      |
| 4   | VBUS      |
| 5   | GND       |
| 6   | GND       |
| 7   | USB\_D\_P |
| 8   | USB\_D\_N |
| 9   | GND       |
| 10  | NC        |
| 11  | NC        |
| 12  | GND       |
| 13  | NC        |
| 14  | NC        |
| 15  | GND       |

</details>

<details>

<summary><strong>VDD MAIN</strong></summary>

* Solder pads
* Input voltage range 18-34V

</details>
{% endtab %}

{% tab title="NextVision gimbal adapter (DCS2 Payload)" %}

### Top side connectors <a href="#top-side-connectors" id="top-side-connectors"></a>

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

<details>

<summary><strong>PAYLOAD SIGNAL</strong></summary>

* Matching connector Hirose DF36-50P-0.4SD
* I2C is 3V3 logic

{% hint style="danger" %}
This connector can be connected/unconnected only when the system is powered off!
{% endhint %}

| pin   | function    |
| ----- | ----------- |
| 1-18  | NC          |
| 19    | I2C\_SDA    |
| 20    | I2C\_SCL    |
| 21    | NC          |
| 22    | NC          |
| 23    | CSI\_CLK\_P |
| 24    | CSI\_CLK\_N |
| 25    | CSI\_D1\_P  |
| 26    | CSI\_D1\_N  |
| 27    | CSI\_D0\_P  |
| 28    | CSI\_D0\_N  |
| 29    | USB\_PWRCTL |
| 30    | USB\_OC     |
| 31    | USB\_D\_P   |
| 32    | USB\_D\_N   |
| 33-50 | NC          |

</details>

<details>

<summary><strong>PAYLOAD POWER</strong></summary>

Matching connector Molex 502578-060x

| pin | function       |
| --- | -------------- |
| 1   | GND            |
| 2   | GND            |
| 3   | GND            |
| 4   | 5V             |
| 5   | NC             |
| 6   | VDD (20-55VDC) |

</details>

<details>

<summary><strong>Gimbal</strong></summary>

Direct connection to Nextvision Gimbal cable

</details>
{% endtab %}
{% endtabs %}

***

## Software driver

This article describes the setup of the NextVision gimbal with DroneCore

### Next Vision Gimbal (NVGimbal) Library <a href="#next-vision-gimbal-nvgimbal-library" id="next-vision-gimbal-nvgimbal-library"></a>

The NVGimbal library supports camera operations as described in the `Colibri Camera Control Protocol v 3.9`.

### Trial Version <a href="#trial-version" id="trial-version"></a>

#### **Prerequisites**

1. NextVision Gimbal, adapter board, and CSI flex cable compatible with DroneCore.Suite.
2. DroneCore.Suite 1.2 or DroneCore.Suite 2.0.
3. One of the following configurations flashed: Xavier NX + DCS 1.2 + JP 5.1.2 or Orin NX + DCS 2.0 + JP 5.1.2.

To flash Nvidia Jetson with the required configuration, use [dcs-deploy](https://github.com/airvolute/dcs-deploy). Follow these steps to flash the compatible configuration:

```python
git clone -b jp_512_20_configs https://github.com/airvolute/dcs-deploy.git
cd dcs-deploy

# Put the device in force recovery mode, connect it to your host PC via USB dev, and select the appropriate version.

# For Orin NX + DCS 2.0 + JP 5.1.2:
python3 dcs_deploy.py flash orin_nx 512 2.0 nvme full 

# For Xavier NX + DCS 1.2 + JP 5.1.2:
python3 dcs_deploy.py flash xavier_nx 512 1.2 nvme full

# Note: For Xavier NX, you can also use the EMMC configuration. However, installing Jetpack may not be possible due to limited space. NVME is recommended.
python3 dcs_deploy.py flash xavier_nx 512 1.2 emmc full
```

#### **Installation of Trial Version**

To install the trial version and follow these steps:

1. Download the trial version package: `wget https://airvolute.com/download/Jetson_system/NVGimbal/trial/libnv_gimbal.tar.gz`
2. Copy the package to the device: `scp $HOME/Downloads/libnv_gimbal.tar.gz dcs_user@192.168.55.1:/home/dcs_user`
3. Log in to the device: `ssh -X dcs_user@192.168.55.1`
4. Apply the patch (with parameter `--dcs-revision` specify version 1.2 or 2.0): `mkdir -p $HOME/libnv_gimbal && tar -xvf libnv_gimbal.tar.gz -C $HOME/libnv_gimbal && bash $HOME/libnv_gimbal/install/install_nv_gimbal_lib.sh --dcs-revision x.x`
5. Reboot or turn off the device.
6. Connect the gimbal using the adapter. The CSI flex cable must be connected to CSI A port (DCS 1.2) or CAM 2/3 (DCS 2.0). USB can be connected to any USB port.
7. Start the device and log in: `ssh -X dcs_user@192.168.55.1`
8. Run the application: `$HOME/libnv_gimbal/example/nv_gimbal_test`

After completing these steps, you should see the output of the video stream. Approximately 10 seconds after startup, you will be able to control the gimbal as per the application output. The trial version is limited to a maximum of 10 minutes and has an approximate 10-second startup time.

{% hint style="info" %}
Note: If the stream is not smooth, this may be due to USB dev speed limitations. You can connect a monitor and keyboard to the DroneCore and run the demo this way.
{% endhint %}

{% hint style="info" %}
Note: If you are interested in receiving source code for a trial example, please contact us
{% 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://test-airvolute.gitbook.io/test-airvolute-docs/autopilots/dronecore-2/peripherals/payloads/nextvision-adapter.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.