# Reality Hub MOS Configuration for iNEWS

{% hint style="warning" %}
Before you begin, please remember that; every MOS Device Settings in the Reality Hub must match the iNEWS Settings.
{% endhint %}

<div align="left"><figure><img src="https://content.gitbook.com/content/F00UfwVmrAMlFEsYUV8N/blobs/JdrmeVV8eOQoTfku6rLE/MOS-Module-Configuration-UI.png" alt=""><figcaption><p>MOS Module Configuration UI</p></figcaption></figure></div>

The image above shows the default MOS Module Configuration interface.

### Adding MOS Device <a href="#mosmoduleconfiguration-addingamosdevice" id="mosmoduleconfiguration-addingamosdevice"></a>

<div align="left"><figure><img src="https://content.gitbook.com/content/F00UfwVmrAMlFEsYUV8N/blobs/1JzTLLGYfDr8K9XN1gBu/New-NCS-Device.png" alt=""><figcaption><p>New NCS Device</p></figcaption></figure></div>

* Go to the **Main Menu** > **Configuration** > **MOS Module** and select **Configuration**.
* Click on the **+ (Plus)** icon to **Add** a new NCS Device.

As soon as you click on the **Add** button, Reality Hub adds a default NCS Device.

### MOS Device Settings in Reality Hub <a href="#mosmoduleconfiguration-mosdevicesettingsinrealityhub" id="mosmoduleconfiguration-mosdevicesettingsinrealityhub"></a>

<div align="left"><figure><img src="https://content.gitbook.com/content/F00UfwVmrAMlFEsYUV8N/blobs/DZflgr1PAHftb60EY1US/image.png" alt=""><figcaption><p>MOS Device Settings Button</p></figcaption></figure></div>

* **Select** the device from the **NCS Devices** area.
* Click on the **MOS Device Settings** button as shown above.

<div align="left"><figure><img src="https://content.gitbook.com/content/F00UfwVmrAMlFEsYUV8N/blobs/yVslUxIv2kQqNFFPYwVX/image.png" alt=""><figcaption><p>Example MOS Device Settings</p></figcaption></figure></div>

* **MOS ID**: Define a MOS installation name. REALITYHUBMOS is the default MOS ID. You can change it depending on your setup or leave it as a default, but you must define the same **mosID** in your NCS settings.
* **MOS Version**: Select the MOS Version matching your NCS.

{% hint style="info" %}
Reality Hub 1.4.2 supports MOS 2.6, 2.8, and 2.8.5.
{% endhint %}

* **Heartbeat Interval**: The area you can define the frequency of the heartbeat.
* **Encoding**: Choose an encoding (UTF-8, UCS-2BE, UTF-16LE, UTF-16BE) matching your workflow.
* **Hostname / IP Address**: NCS MOS Gateway IP Address.
* **MOM Port (Lower Port) \[NCS] & \[MOS]**: Define a port number that matches the **iNEWS Media Port**.
* **RO Port (Upper Port) \[NCS] & \[MOS]**: Define a port number that matches the **iNEWS Rundown Port**.

{% hint style="info" %}
MOS Lower Port (10540) refers to Media Object Metadata and MOS Upper Port (10541) is related to the Running Order.
{% endhint %}

{% hint style="info" %}
The abovementioned two ports are selected MOS Protocol ports to communicate with the NCS automation.
{% endhint %}

{% hint style="info" %}
Reality Hub uses **Port 10540** and **Port 10541** for communicating with your NCS device using MOS Protocol as a default setup. You can change it depending on your setup.
{% endhint %}

{% hint style="info" %}
There is a third port some systems use which is called **Query Port**, and its default value is 10542.
{% endhint %}

{% hint style="warning" %}
MOM & RO Ports must be accessible and not filtered or blocked.
{% endhint %}

### Connection Indicators

<div align="left"><figure><img src="https://content.gitbook.com/content/F00UfwVmrAMlFEsYUV8N/blobs/dAyqnaQLtcaZrv6ijknB/image.png" alt=""><figcaption><p>NCS Devices Connection Status</p></figcaption></figure></div>

As soon as you click on the **Add NCS Devices Button** (plus icon), the default configuration shows **Outgoing** and **Incoming** connections for **Upper Port** and **Lower Port**, as shown above. &#x20;

<div align="left"><figure><img src="https://content.gitbook.com/content/F00UfwVmrAMlFEsYUV8N/blobs/84rj1vJqCUjvunjK3GtA/image.png" alt=""><figcaption><p>Connection Status Indicators</p></figcaption></figure></div>

### Plugin URL

The Plugin URL needs to be set in the iNEWS to connect the plugin to the Reality Hub. &#x20;

The URL also contains parameters to make sure that your system is ready to function within the intended system environment.

<div align="left"><figure><img src="https://content.gitbook.com/content/F00UfwVmrAMlFEsYUV8N/blobs/u8IqZ5L2rotWLzOYMcT9/image.png" alt=""><figcaption><p>Implementation</p></figcaption></figure></div>

To copy the generic Plugin URL:

* Go to **Main Menu** > **Configuration** > **MOS Module** > **Configuration**.
* Click on the **Copy MOS Plug-in URL** button as illustrated above.&#x20;

You may need to add or change various parameters in the URL depending on your NCS installation. &#x20;

| Parameter Name | Parameter Value   | Description                               |
| -------------- | ----------------- | ----------------------------------------- |
| modules        | hub.mos\_gateway  | Fixed value                               |
| mode           | mosplugin         | Fixed value                               |
| ncsID          |                   | The NCS ID set in the configuration.      |
| progid         |                   | The Program ID set in the configuration.  |
| mosID          |                   | The MOS ID set in the configuration.      |
| version        | 2.6, 2.8 or 2.8.5 | The MOS version set in the configuration. |
| ncstype        | inews             | Fixed value.                              |

The final URL will be like this:&#x20;

`http://172.16.0.12/?modules=hub.mos_gateway&mode=mosplugin&ncsID=INEWSTST&progid=zdmosdev&mosID=zdmosdev&version=2.8&ncstype=inews`