# Settings

The **Settings** tab allows you to configure connectivity, add public links, load debugging data, generate reports, set time zone, and set geo-location.

**Connectivity:**

To receive or send data from or to the device, you need to add and configure the network server to which the device belongs.

<figure><img src="https://2494440469-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fggsr9Xlsze5cwVr4WMof%2Fuploads%2FaHsp8ncYVrqBALdcnKez%2Fdevice-8.png?alt=media&#x26;token=d5afb43b-7ec2-4595-b9c4-b1a43dc2b127" alt=""><figcaption></figcaption></figure>

In the **Connectivity** section, click on the light blue area displaying a **disconnected adapter** icon and the text '**Not Configured**'.

<figure><img src="https://2494440469-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fggsr9Xlsze5cwVr4WMof%2Fuploads%2FzTYVYSReWaMOsnXkZFkM%2Fdevice-9.png?alt=media&#x26;token=ef0742e5-9ecd-4277-82d0-ab9d3ff59d13" alt=""><figcaption></figcaption></figure>

The **Network Server** modal box opens. Select the network server from the list where your device is registered.

In the **Uplink** section, toggle the **Secure** button switch to turn it on.&#x20;

{% hint style="info" %}
The **API Key** text box is initially empty but it will be generated for your device after you click on the **Save** button.
{% endhint %}

Click on the **Save** button.

<figure><img src="https://2494440469-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fggsr9Xlsze5cwVr4WMof%2Fuploads%2FrJcs9mJXh9crmdFNkMbq%2Fdevice-10.png?alt=media&#x26;token=af4e1f61-1f79-4ee8-9273-55de5d8f71e2" alt=""><figcaption></figcaption></figure>

Your network server is now shown in the **Connectivity** section.

<figure><img src="https://2494440469-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fggsr9Xlsze5cwVr4WMof%2Fuploads%2F1ACdpEFKY2KJ9SAvfbPI%2Fdevice-11.png?alt=media&#x26;token=b0f07c78-66b1-44ed-984d-df7a04c4bc25" alt=""><figcaption></figcaption></figure>

To view the API key, simply click on the network server listed under the **Connectivity** section.&#x20;

The **Network Server** modal box opens, and you can now see the API key associated with your device in the API Key text box.&#x20;

<figure><img src="https://2494440469-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fggsr9Xlsze5cwVr4WMof%2Fuploads%2F3UV1L7cFmnRrTKIIoxf6%2Fdevice-12.png?alt=media&#x26;token=5c9152a6-3d9c-4cb4-a68c-8a41142f23c5" alt=""><figcaption></figcaption></figure>

Copy the **API key** by clicking on the **Copy** button. You will need it when configuring the connectivity for Widgelix on your network server.

**Report:**

You can download the recorded values for the preferred data fields as a **CSV** (Comma Separated Values) file.&#x20;

To add data fields, click on the **Fields** text box and select each field one by one.&#x20;

<figure><img src="https://2494440469-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fggsr9Xlsze5cwVr4WMof%2Fuploads%2FKlaQcTSdXeGsZpZpMjHX%2Fdevice-20.png?alt=media&#x26;token=db7ef5ed-d1d0-42d0-b7dc-b685937b6d61" alt=""><figcaption></figcaption></figure>

For data filtering, choose the desired timeframe using one of the following options:

* Click on the **Range** text box and select a predefined timeframe from the list. If the desired timeframe is not available, you can manually type a range, such as '3 days' for example.

<figure><img src="https://2494440469-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fggsr9Xlsze5cwVr4WMof%2Fuploads%2Fffr1EiEtGJOzdq4QGhEa%2Fdevice-21.png?alt=media&#x26;token=cc480b05-c91e-43ce-88db-3f46ceb5d564" alt=""><figcaption></figcaption></figure>

* Define a custom date range by selecting the **start date** and **end date** from the date pickers.

<figure><img src="https://2494440469-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fggsr9Xlsze5cwVr4WMof%2Fuploads%2FQhi7F72XBgAvT8l6eyNd%2Fdevice-22.png?alt=media&#x26;token=2d4111fe-3810-4658-bf97-1472d26087c8" alt=""><figcaption></figcaption></figure>

Click on the **Get Report** button.

<figure><img src="https://2494440469-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fggsr9Xlsze5cwVr4WMof%2Fuploads%2FG8E8WL7EqabmnOiFz3bL%2Fdevice-23.png?alt=media&#x26;token=821adf51-bd7d-40e0-8e70-dbda0cc1502c" alt=""><figcaption></figcaption></figure>

The report will be downloaded as a CSV file.

<figure><img src="https://2494440469-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fggsr9Xlsze5cwVr4WMof%2Fuploads%2FUIiEMIs5JjHBE89m95XO%2Fdevice-24.png?alt=media&#x26;token=e53ee2b0-2f82-47bd-8313-f145b13d95c9" alt=""><figcaption></figcaption></figure>

**Time zone:**

Click on the drop-down and select a time zone from the list that is applicable to the geolocation of your device.

<figure><img src="https://2494440469-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fggsr9Xlsze5cwVr4WMof%2Fuploads%2FBxIhzuOXtBdhvDNuWEsx%2Fdevice-25.png?alt=media&#x26;token=205c3185-43f3-4654-b0d4-988f31ad678a" alt=""><figcaption></figcaption></figure>

The time zone automatically updates and applies to all devices of that device type.

**Online Threshold:**

The device status (online/offline) can be determined based on whether an uplink is received from the device within the defined time period.

If an uplink is received within the defined time period, a **green dot** will display alongside the device image, and the **elapsed time** between the last uplink time and the current time will be shown, for example, `Last Seen: 5 minutes ago`.

<figure><img src="https://2494440469-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fggsr9Xlsze5cwVr4WMof%2Fuploads%2FV946ek3jgZDvGw9Ri890%2Fdevice-38.png?alt=media&#x26;token=821f6b52-568f-4f9c-9b90-d060703efcf2" alt=""><figcaption></figcaption></figure>

If there is no uplink received within the defined time period, a **red dot** will display alongside the device image, and the device status will be displayed as `Last Seen: never`

<figure><img src="https://2494440469-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fggsr9Xlsze5cwVr4WMof%2Fuploads%2FyvkfECkVHgheLQikyyuQ%2Fdevice-39.png?alt=media&#x26;token=85ef1aff-698c-4ff4-9c30-3efd048e1ba8" alt=""><figcaption></figcaption></figure>

Select one of the following predefined timeframes from the **dropdown text box** under the **Online Threshold**.

* `1 minute`
* `1 hour`
* `1 day` - this is the default timeframe.
* `1 week`
* `1 month`

You can also type a custom time frame in the dropdown text box, for example, `2 minutes`.

<figure><img src="https://2494440469-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fggsr9Xlsze5cwVr4WMof%2Fuploads%2FyxQ342TbloLa3jJ00TFF%2Fdevice-37.png?alt=media&#x26;token=58d0d86a-0ce5-4b99-b5ed-0e03181653ac" alt=""><figcaption></figcaption></figure>

**Coordinates:**

The **Coordinates** section is only visible if you have enabled and set the geolocation of your device during its creation. To view the Coordinates section if it is not visible, toggle the **Enable** button.

You can add or update the existing coordinates by either directly typing them in the **Latitude** and **Longitude** text boxes or choosing them from the map by clicking the **Pick From Map** button.

Click on the **Save** button to apply the changes to the device.

{% hint style="info" %}
When you update the coordinates, they will be applied only to the particular device, not to the device type.
{% endhint %}

<figure><img src="https://2494440469-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fggsr9Xlsze5cwVr4WMof%2Fuploads%2FfSK3UDozfLjIJbIQfNyP%2Fdevice-26.png?alt=media&#x26;token=86502d3c-3c42-46ca-b26a-816bcf50986d" alt=""><figcaption></figcaption></figure>
