# MIDI device(s) with an MA3 Desk

## 1. Know your IP addresses <a href="#id-1-add-an-onyx-element" id="id-1-add-an-onyx-element"></a>

Before you start, we need to settle up the IP addresses of both the MA3 system and ShowCockpit.

In this tutorial we will assume these IPs:

* **MA3 IP**: 2.0.0.3
* **ShowCockpit IP**: 2.0.0.2

{% hint style="info" %}
If you are setting up MA3 OnPC running in the same computer as ShowCockpit, please refer to this page: [Connecting to MA3 OnPC on the same PC](https://academy.showcockpit.com/showcockpit-for-windows/tutorials/lighting/connecting-to-ma3-onpc-on-the-same-pc)
{% endhint %}

## 2. Enable OSC In/Out in MA3 <a href="#id-1-add-an-onyx-element" id="id-1-add-an-onyx-element"></a>

In MA3, press the **gear-box button to show the Menu** and click the **In & Out** button.

Select the **OSC tab** and on the top, select the **Interface** you want to use and **enable both Input and Output**.

![](https://3766568293-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LuTyAYhvh-0rGV983Jy%2F-LwrIsfMo-eLB3fxSd-U%2F-LwrLlDl3AAlPB1GOqvZ%2Fimage.png?alt=media\&token=b215a410-7ba5-41dd-99fc-0f3f6e141bd1)

If the list is empty, add a new OSCData line and set the destination IP address to the **ShowCockpit IP**

![](https://3766568293-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LuTyAYhvh-0rGV983Jy%2F-LwrIsfMo-eLB3fxSd-U%2F-LwrMGtc4dusAiLplbv5%2Fimage.png?alt=media\&token=2b2d0cd6-400d-480a-8dbf-ef4a82200e01)

Finally enable all send and receive items by clicking on the "**ReceiveAll**", "**SendAll**", "**ReceiveCmdAll**" and "**SendCmdAll**" buttons.

![](https://3766568293-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LuTyAYhvh-0rGV983Jy%2F-LwrIsfMo-eLB3fxSd-U%2F-LwrMYIjnhtMs8a5fKYS%2Fimage.png?alt=media\&token=699a6981-0139-41bc-a3b8-648ef75e7491)

## 3. Add an MA3 - OSC element in ShowCockpit <a href="#id-1-add-an-onyx-element" id="id-1-add-an-onyx-element"></a>

On the **Elements** section, click the **Add** button to add an MA3 - OSC element to the project:

* **Lighting > MA Lighting > MA3 - OSC**

### Enable the Element <a href="#enable-the-element" id="enable-the-element"></a>

Click the toggle buttons on the element to enable it.

## 4. Add MIDI device element  <a href="#id-2-add-midi-device-element" id="id-2-add-midi-device-element"></a>

Use the **Add** button again to add your MIDI device element through **External Control > MIDI**. Currently, RD/ShowCockpit has out-of-the-box support for multiple MIDI devices - [check out the complete compatibility list here](https://showcockpit.com/site/docs/).

If your device is not listed, you will need to use the **Generic MIDI** driver and map your device controls manually.

When using a specific MIDI device driver, you can skip to Step 4.

### Set Element Options <a href="#set-element-options" id="set-element-options"></a>

&#x20;After adding the element, make sure that the correct device is selected under both Input Device and Output Device options.

### Enable the Element <a href="#enable-the-element-1" id="enable-the-element-1"></a>

Finally, click the toggle button on the MIDI device element to enable it.

## 5. Learn MIDI Controls (Generic MIDI only) <a href="#id-3-learn-midi-controls-generic-midi-only" id="id-3-learn-midi-controls-generic-midi-only"></a>

In case you selected the **Generic MIDI** driver, now you need to "teach" this driver what controls (faders, buttons and encoders) your device has. For the officially supported MIDI devices, controls are automatically mapped, so you can skip to the next step.

Double-click the **Generic MIDI** element to open its window - you will start by mapping the **Faders**. Click on **Enable Learn** on the top-right to start listening to MIDI input.

![](https://blobscdn.gitbook.com/v0/b/gitbook-28427.appspot.com/o/assets%2F-LuTyAYhvh-0rGV983Jy%2F-LuZuW5A7DF0ZeKAyR4e%2F-Lub1GCEgZ2P2gLob46Z%2Fgeneric-midi-fadbutenc.jpg?alt=media\&token=6a511fb2-4932-4a72-9b0e-9bca524df27f)

* Move, one-by-one, all **Faders** on your MIDI device. They will be added to the **Faders** list.
* To map the **Buttons**, click on **Buttons** (above the table) and repeat the procedure now for all your device buttons.
* Finally, map your **Encoders** by clicking on **Encoders** and repeat the procedure for all the encoders.

You can now close the **Generic MIDI** window by clicking **Back to Elements** or clicking on any menu button.

## 6. Mapping <a href="#id-4-mapping" id="id-4-mapping"></a>

Open the **Mapping** section on the Main Menu.

This section is divided into 3 columns, from left to right:

* Functions
* Parameters
* Controls

Select the **MA3 - OSC** element on the Functions column and select a function (for example, "Executor Fader"). When you select the function, the button will be highlighted and the second column will have the parameters for the function. In this case, you can select which playback fader you want to control.

Select the **Generic MIDI** element on the Controls column, open the Faders list and click on one of the faders to assign the function.

If you now move your fader, the mapped Executor Fader on MA3 should act accordingly.

Repeat the process for all desired controls.


---

# 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://academy.showcockpit.com/showcockpit-for-windows/tutorials/lighting/midi-device-s-with-ma3.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.
