# Devices

A **device** can be added to the Widgelix using its corresponding device type template.&#x20;

{% hint style="info" %}
Before adding a device, its corresponding device type must be added to the Widgelix.&#x20;
{% endhint %}

The device type template provides all the general settings for the device, such as basic information, uplink payload formatter and data fields, downlink payload formatter and data fields, radio and battery parameters, as well as widgets.

A device inherits from a device type, and you can configure individual devices with more specific settings such as network connectivity (network server), public address, time zone, online threshold, geolocation, and downlinks.

By correctly configuring the device type template, you can easily add new devices to Widgelix.

<figure><img src="https://2494440469-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fggsr9Xlsze5cwVr4WMof%2Fuploads%2FZgvXJAcTozNVtVFymvRr%2Fdevice-4.png?alt=media&#x26;token=7ce3f13f-ee17-4a19-825c-d21e3165ed69" alt=""><figcaption></figcaption></figure>

To add a new device or view existing devices, click on **Devices** in the left menu.

If no device has been created within your organization yet, the **Devices - Create your first device** page will be displayed.

<figure><img src="https://2494440469-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fggsr9Xlsze5cwVr4WMof%2Fuploads%2Fy1Ihi6rmNnPj1p3mfvfw%2Fdevice-42.png?alt=media&#x26;token=d0026391-368c-4a51-a1da-3408e6199107" alt=""><figcaption></figcaption></figure>

Otherwise, the **Devices** page will be displayed, showing the list of previously created devices.

<figure><img src="https://2494440469-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fggsr9Xlsze5cwVr4WMof%2Fuploads%2Fvayw51KzUZRohHaIe46V%2Fdevice-1.png?alt=media&#x26;token=98aff887-047f-468a-a5f6-bb018b3bbde8" alt=""><figcaption></figcaption></figure>

## Adding a Device

Within the Widgelix IoT cloud platform, you can either individually add new devices using the **Add Device** option or import them in bulk through the **Bulk Import** option.

### Using Add Device Option

Click on the **+Add Device** button.

<figure><img src="https://2494440469-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fggsr9Xlsze5cwVr4WMof%2Fuploads%2FJfL3DpRq6BP6Fly4YTVL%2Fdevice-2.png?alt=media&#x26;token=211d4853-1377-461f-aa8f-28e7519f4656" alt=""><figcaption></figcaption></figure>

The **Add Device** page will be displayed.

In the **Name** text box, enter the **name** of your device.

In the **Device id (DevEUI)** text box, enter the **DevEUI** of your device.&#x20;

{% hint style="info" %}
Device id or devEUI is a HEX string, for example, "0004A310001AB115"
{% endhint %}

Select the **device type** from the **Device Type** drop-down. The selected device type works as a template for your device.

To add geolocation information about your device, turn on the **Has coordinates** button switch. A new section will appear.

In the **Latitude** and **Longitude** text boxes, enter the **latitude** and **longitude** of your device, respectively.

<figure><img src="https://2494440469-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fggsr9Xlsze5cwVr4WMof%2Fuploads%2FZ03f09UDD0XqRpszUBsV%2Fdevice-1.png?alt=media&#x26;token=ce509eb9-888b-4aa2-a4aa-4d7cc308d724" alt=""><figcaption></figcaption></figure>

Alternatively, you can select the **geolocation** from the map:

Click on the **Pick From Map** button.

<figure><img src="https://2494440469-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fggsr9Xlsze5cwVr4WMof%2Fuploads%2FJ52dZXhfMsGIQN7KXlFw%2Fdevice-2.png?alt=media&#x26;token=d00551d1-563b-4fe8-8ebd-5d0540e78b5e" alt=""><figcaption></figcaption></figure>

The **map** opens in a modal box.&#x20;

<figure><img src="https://2494440469-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fggsr9Xlsze5cwVr4WMof%2Fuploads%2FjraPTy4C01Gv51hiDclo%2Fdevice-4.png?alt=media&#x26;token=48fb7999-bd8f-47b9-b303-269b9f3c9d69" alt=""><figcaption></figcaption></figure>

Use `Ctrl + Scroll` to zoom the map and click on the location where the device is physically positioned or going to be positioned.

<figure><img src="https://2494440469-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fggsr9Xlsze5cwVr4WMof%2Fuploads%2FYFo8H9fR5Yr7ImbmtP9h%2Fdevice-5.png?alt=media&#x26;token=d8176a6a-5f67-4a15-804f-33af330df758" alt=""><figcaption></figcaption></figure>

Alternatively, you can type the full or a part of the **address** in the **Enter address** text box and choose it from the drop-down list if it appears in the list.

If the location is correct click on the **Save** button to add the coordinates to the device form and close the map modal box.

In the **Add Device** page, click on the **Save** button to add the device to your organization.

<figure><img src="https://2494440469-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fggsr9Xlsze5cwVr4WMof%2Fuploads%2FJdVz5PYvPdhmITxEptdD%2Fdevice-3.png?alt=media&#x26;token=e1dde66a-f72c-4269-81f2-66b3c305a3e6" alt=""><figcaption></figcaption></figure>

Your new device is now listed on the **Devices** page.<br>

<figure><img src="https://2494440469-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fggsr9Xlsze5cwVr4WMof%2Fuploads%2FQjJiFDpvDIk4ByZ0J6WN%2Fdevice-7.png?alt=media&#x26;token=b28b3026-8ce4-4826-aee9-6c3ef453f997" alt=""><figcaption></figcaption></figure>

### Configuring a Device

After adding a new device to your organization, you can further **configure** it.

On the **Devices** page, click on the **name** of the device from the devices list.

<figure><img src="https://2494440469-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fggsr9Xlsze5cwVr4WMof%2Fuploads%2FPNOk1HvQZoTSEUpXg5o5%2Fdevice-5.png?alt=media&#x26;token=2cd3e7ce-c6a6-4e66-9d4e-437f0b35dace" alt=""><figcaption></figcaption></figure>

The device page (for example, RCNM-Atrium) will be displayed and allows you to configure various parameters and settings.

<figure><img src="https://2494440469-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fggsr9Xlsze5cwVr4WMof%2Fuploads%2FprZEr2ne9UWFtuBRU0GW%2Fdevice-27.png?alt=media&#x26;token=386ff13d-661d-4be5-a546-30f4a776be96" alt=""><figcaption></figcaption></figure>

You can configure the device The page consists of the following tabs:

* [Dashboard](https://docs.widgelix.com/get-started/devices/dashboard)
* [History](https://docs.widgelix.com/get-started/devices/history)
* [Downlinks](https://docs.widgelix.com/get-started/devices/downlinks)
* [Events](https://docs.widgelix.com/get-started/devices/events)
* [Settings](https://docs.widgelix.com/get-started/devices/settings)

<figure><img src="https://2494440469-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fggsr9Xlsze5cwVr4WMof%2Fuploads%2FMRBmWzoPjIFNFcmq8tXO%2Fdevice-35.png?alt=media&#x26;token=b07df08a-c38b-41f3-8051-185147ffe611" alt=""><figcaption></figcaption></figure>

## Deleting a Device

A **device** can be deleted from the organization, and cannot be undone.

To delete a device, click on the **Settings** tab and then click on the **Delete** button.&#x20;

<figure><img src="https://2494440469-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fggsr9Xlsze5cwVr4WMof%2Fuploads%2FfDo3gKEZsqZ3bb9dOacF%2Fdevice-36.png?alt=media&#x26;token=52a2da2c-6e78-4359-aa88-a1339ed6c9d6" alt="" width="563"><figcaption></figcaption></figure>

Alternatively, you can click on the respective **delete (bin)** icon in the **device list**.

<figure><img src="https://2494440469-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fggsr9Xlsze5cwVr4WMof%2Fuploads%2FxHczq9Tdr2yyD4qhNT33%2Fdevice-41.png?alt=media&#x26;token=59c0cf9a-c627-4ef2-b2de-672735500f60" alt="" width="563"><figcaption></figcaption></figure>

The **Delete device** model will be displayed.

In the **text box**, type in the exact **name** of the **device**.

Click on the **Delete** button.

<figure><img src="https://2494440469-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fggsr9Xlsze5cwVr4WMof%2Fuploads%2FduKAcYEca7NSUQW74Bn2%2Fdevice-40.png?alt=media&#x26;token=4e3457fd-d01b-4367-9594-51f0d91e7075" alt="" width="375"><figcaption></figcaption></figure>

The **device** will be removed from your organization.

{% hint style="info" %}
The **Delete** operation can't be undone.
{% endhint %}
