# 11.11.3 - WITS

This section of the Slide Sheet menu ribbon contains the three WITS data readers available in Well Seeker X. By receiving WITS data from the rig, the user can automate the Slide Sheet via the Rig States and Auto-Populate functions. WITS data can also be forwarded to your organisation’s server database to power the EDR feature in Vantage.

The data reader that you should use depends on the connection type:

* **Serial or Ethernet Cable:** Use the Serial/TCP WITS reader.
* **WITSML:** Use the WITSML reader.
* **Digidrill or KLX Wireless WITS:** Use MQTT WITS.

**Note: The reader must be left open to continue receiving WITS data, do not close it.**

For a step-by-step guide to setting up WITS to record slide information, see the [**Well Seeker X: WITS Setup Guide.**](https://docs.innova-drilling.com/introduction/innova-engineering-how-to-guides/well-seeker-x-guides/well-seeker-x-wits-setup-guide)

## **1.1.1.1 - Serial/TCP**

Opens the Serial / TCP WITS Comms dialog. This option is used to configure Well Seeker to receive WITS data via a comm port (serial cable) or ethernet cable. For this process to work correctly, it is important that the WITS mapping in Well Seeker matches the WITS mapping of the rig. See [**WITS Mapping**](https://docs.innova-drilling.com/introduction/innova-engineering-manual/8.0-menu-ribbons/8.4-settings#id-8.4.6-wits-mapping) for more information on editing Well Seeker’s WITS mapping.

<figure><img src="https://100379801-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-McEwHTOM_v4MexTVGSe%2Fuploads%2FFIdLs6wEAwPyk1nyinDM%2Fimage.png?alt=media&#x26;token=b2e56bfd-b2c3-4558-b149-0c5ddc1008fb" alt=""><figcaption><p>Figure 313: Serial / TCP WITS Comms dialog</p></figcaption></figure>

#### **Options**

This section contains options that are only relevant to specific WITS transmission systems:

**Send Data Handshake (Pason): This should be toggled ON unless you are running a Noralis MWD systema and receiving data from a Noralis WITS system.**

**Use SoloBox Mapping:** Toggle this on if you are receiving data from a SoloBox system. It will override the settings that you entered into the Serial WITS Settings or Ethernet WITS Settings sections.

**Use RigSense Mapping:** Toggle this on if you are receiving data from a RigSense system. It will override the settings that you entered into the Serial WITS Settings or Ethernet WITS Settings sections.

#### **Serial/Ethernet WITS Settings**

The user should only set up **ONE** of these sections:

**Serial:** Fill in this section if you are receiving data via a Serial cable. Make sure that the cable is connected and then select the **Comm Port** from the dropdown box in the **Serial WITS Settings** section. Leave the **Baud Rate** as 9600 unless specified by the WITS provider.

**Ethernet:** If you are receiving data via an **Ethernet** cable, select either **UDP WITS** or **TCP WITS** in the **Ethernet WITS Settings** section. Enter the IP address provided by the WITS provider in the **IP** box. If you are using TCP WITS, you will also need a Port number. You may also need to toggle on **Client Mode** – try toggling this on if you have issues receiving the data after you start reading.

#### **Server Data Sync**

Toggle on **Send Data** to forward received WITS data on to your organization’s server database. This data can then be used in various pages in Vantage, such as the EDR. The **IP** and **Port** cells should be greyed out and not editable, and should already be filled with your company’s details. If not, you are likely using the incorrect license, and should contact your company administrator. The **WITS Status** section will indicate if the last push to the server was successful.

#### **WITS Status & Data Stream**

Click on **Start Reading** in the bottom left to begin receiving WITS data. The **WITS Status** will display green if data is being received without any issues. If there is a problem, the WITS Status will turn red.

**The reader must be left open to continue receiving WITS data, do not close it.**

Whilst the WITS feed is running, you can see incoming data and any error messages in the **WITS Data Stream** section. Pause the data stream by checking the **Pause Messages** checkbox – the WITS feed will continue in the background. This allows the user to scroll through and read any messages. Once unchecked, all messages which were received during the paused interval will appear.

#### **WITS Out**

The **WITS Out** section allows the user to transmit the WITS data that you are receiving to other computers at the rig site via a null serial cable. Toggle **Send WITS Out** to activate the feature. Choose the mnemonics that you want to send by checking the **Send** checkbox and entering a channel value beside each one. Note that this feature is only available to select when a serial cable has been connected to the computer and a Comm Port has been selected in the Serial Wits Settings section.

&#x20;

## **1.1.1.2 - WITSML**

The WITSML Comms dialog is used to receive data by accessing a WITSML Server via an internet connection. To use the WITSML reader, the user needs valid login credentials for a WITSML server, provided by the server host.

<figure><img src="https://100379801-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-McEwHTOM_v4MexTVGSe%2Fuploads%2F3K1hoxbOr7ihwgJnxj46%2Fimage.png?alt=media&#x26;token=c7651141-e119-48a3-8b25-4502077d3cb0" alt=""><figcaption><p>Figure 314: WITSML Comms dialog</p></figcaption></figure>

#### **WITSML Server**

To use the WITSML Reader, the user needs valid login credential for the WITSML server. They should enter these into the **Server URL, Username** and **Password** boxes in the WITSML Server section. The user also needs to know the version of the server – either **1.3.1** or **1.4.1** – and select it from the dropdown box.

The **Show/Hide** checkbox will display or hide the password, while the **Save password** checkbox will remember the password so that it does not need to be entered every time the WITSML Reader is opened.

The user can check their credentials by selecting the **Test Connection** button. A message will display in the Messages section indicating if the connection was successful or not.

Once the user is happy with their connection, the user can click on the **Load Wells** button to get a list of wells and logs stored on the data. The user can now select a log and a trajectory that they want to receive by clicking on them in the list. **Note:** Well Seeker uses time-based logs for its slide data, and trajectory logs for surveys.

The user can also click on the **Pull to file** button to download all stored data from a selected well. **WARNING:** this will pull all of the data for the selected well from the WITSML store and may take a very long time to complete. The user will not be able to access any other Well Seeker features whilst this process is running.

#### **Curve Mapping**

Once the user has selected their desired feeds, they need to map the WITSML mnemonics to the Well Seeker mnemonics in the **Curve Mapping** section. There is no industry standard set of WITSML mnemonics, so the user must set them manually. If using SoloBox select **Use SoloBox Mapping** to automatically map the mnemonics. The Well Seeker internal mnemonics are listed on the right, with a column for the WITSML mnemonics on the left. Well Seeker will attempt to automatically match mnemonics that have the same name. The user should set the WITSML mnemonic by clicking on a row and selecting from the dropdown box.

#### **Start Reading & Selected Data**

Once the user has finished their mapping, they can start receiving data by clicking on the **Start Reading** button. The **Selected Data** section will update to display the selected well, wellbore, log, and trajectory. Whilst the WITS feed is running, the user will see values in the new Value column in the Curve Mapping section.

**The reader must be left open to continue receiving WITS data, do not close it.**

The **Stop Reading** button will stop the WITS feed.

#### **Messages**

The user will receive status and error messages in the Messages section. They can pause the data stream by checking the **Pause Messages** checkbox – the WITS feed will continue in the background. This allows the user to scroll through and read any messages. Once unchecked, all messages which were received during the paused interval will appear.

#### **Send Data to Server**

As with the Serial/TCP WITS Reader, the user can forward WITSML data to their organization’s server database by checking the **Send Data to Server** checkbox. The ICDS IP and ICDS Port should already be greyed out and filled with your company’s details. If not, you are likely using the incorrect license, and should contact your company administrator.

&#x20;

## **11.11.3.3 - MQTT**

MQTT or Wireless WITS is used to receive wireless WITS data from two specific providers – **Digidrill** and **KLX Wireless WITS**. The user will need valid login credentials, provided by the service provider. **Note:** All other WITS dialogs must be closed when the Wireless WITS is running.

<figure><img src="https://100379801-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-McEwHTOM_v4MexTVGSe%2Fuploads%2FCI5ZbEhdeNj6B4PxWkue%2Fimage.png?alt=media&#x26;token=191f087f-0d55-4d02-b18f-c27f0fde62bc" alt="" width="388"><figcaption><p>Figure 315: Wireless WITS dialog</p></figcaption></figure>

#### **Setup**

The user should select a data source type from the **Source** drop-down box and then enter the URL of the data source in the **Server URL** box. The user will be provided with credentials for the server which they should enter into the **Username** and **Password** boxes. They can check if their credentials are correct by clicking on the **Test Connection** button. The message box below will display a response from the server.

When the user clicks on **Start Reading**, Well Seeker will begin receiving data. Acknowledgement of incoming data packets will be displayed in the message box, and the Rig States dialog will begin populating with drilling parameters. The user can stop receiving data by clicking on the **Stop Reading** button.

**The reader must be left open to continue receiving WITS data, do not close it.**

#### **Messages**

The **Pause Messages** button will prevent the dialog from receiving any new messages, but the data feed will continue in the background. **Clear Messages** will delete all messages in the message box and **Write to File** will create a text file containing all messages in the message box.

#### **Remote Server**

The user can forward WITS data to their organizations server database by checking the **Send Data to Server** checkbox. The ICDS IP and ICDS Port should already be greyed out and filled with your company’s details. If not, you are likely using the incorrect license, and should contact your company administrator.
