# Cloud Studio

> Cloud Studio is an IoT software company that developed an IoT platform which enables monitoring, control and automation of facilities. This platform is …

Source: https://www.thethingsindustries.com/docs/integrations/cloud-integrations/cloudstudio/


[Cloud Studio](https://cloudstudioiot.com/) is an IoT software company that developed an IoT platform which enables monitoring, control and automation of facilities. This platform is code-less and highly customizable, allowing enterprise and government entities to easily manage it in their unique way.

Under Cloud Studio, you can find three IoT application [sub-platforms](https://cloudstudioiot.com/iot-platform): Gear Studio, Beam Studio and Bespoke Projects. For integrating The Things Stack with Cloud Studio, we use [Gear Studio](https://cloudstudioiot.com/iot-platform).

## Prerequisites

1. A [user account on Gear Studio](https://gear.cloud.studio/gear/common/sign-up).

## Setup Gear Studio

When you log in to the Gear Studio, you first go through the procedure of creating a **Facility** and then you are presented with the dashboard in the **Monitoring** mode. 

To be able to make changes to the Gear Studio setup, you first need to switch to the **Settings** mode by clicking on the nut icon in the upper left, as shown on the image below.

![Cloud Studio dashboard](https://www.thethingsindustries.com/docs/integrations/cloud-integrations/cloudstudio/dashboard.png)


### Create a Custom Device Model

When adding a new device in Gear Studio, you need to provide your device's **Model**. Some device models are predefined in Gear Studio, but there is also a possibility of creating a custom model. [See Cloud Studio documentation on creating custom device models](https://cloudstudioiot.com/docs/configuracion-del-cliente/dispositivos-y-endpoints/dispositivos/modelos-de-dispositivo)

In this guide, we show how to create a custom **Seeeduino LoRaWAN** model. If your device's model is already defined in Gear Studio, you can skip this subsection and go directly to [Add a New Device](https://www.thethingsindustries.com/docs/integrations/cloud-integrations/cloudstudio/#add-a-new-device) subsection below.

To create a new device model, in the **Settings** mode, navigate to **Devices → Device models** and click **Add**.

In the **Details** tab, provide a **Description** of your model, and an arbitrary **Device model code**. Finish with **Save**.

![Creating a custom device model](https://www.thethingsindustries.com/docs/integrations/cloud-integrations/cloudstudio/creating-device-model.png)


![Custom device model](https://www.thethingsindustries.com/docs/integrations/cloud-integrations/cloudstudio/device-model.png)


Next, you need to edit this model. Click on three dots next to your newly created model in the device models list and select **Edit**, as shown on the image below.

![Editing a newly created device model](https://www.thethingsindustries.com/docs/integrations/cloud-integrations/cloudstudio/edit-device-model.png)


Switch to the **Scripts** tab.

Next, you need to define a device configuration script for your upcoming Gear Studio device. 

![Add configuration script](https://www.thethingsindustries.com/docs/integrations/cloud-integrations/cloudstudio/scripts-configuration.png)


Click the **Edit** button next to the **Configuration** window and paste the following content:

```js
function getConfiguration(config)
{
  config.addressLabel = {en: "DevEUI", es: "DevEUI"};
}

function getEndpoints(deviceAddress, endpoints)
{
  endpoints.addEndpoint("1", "Temperature sensor", endpointType.temperatureSensor);
  endpoints.addEndpoint("2", "humidity sensor", endpointType.humiditySensor);
}
```

![Configuration script](https://www.thethingsindustries.com/docs/integrations/cloud-integrations/cloudstudio/configuration.png)


The example configuration script above shows how to define device's address label, and how to define endpoints that will receive sensor values. [See Cloud Studio documentation for more info about device configuration scripts](https://cloudstudioiot.com/docs/configuracion-del-cliente/dispositivos-y-endpoints/dispositivos/modelos-de-dispositivo/configuracion)

You also need to define a payload parser script, in order for Gear Studio to be able to properly parse the data coming from your end device on The Things Stack. 

![Add payload parser script](https://www.thethingsindustries.com/docs/integrations/cloud-integrations/cloudstudio/scripts-payload-parser.png)


Click on the **Edit** button next to the **Payload parser** window and paste the following content:

```js
function parseUplink(device, payload)
{
    var parsed = payload.asParsedObject();
    env.log(parsed);

    var temperatureSensor = device.endpoints.byType(endpointType.temperatureSensor);
    if (temperatureSensor != null){
        temperatureSensor.updateTemperatureSensorStatus(parsed.temperature);
    }

    var humiditySensor = device.endpoints.byType(endpointType.humiditySensor);
    if (temperatureSensor != null){
        humiditySensor.updateHumiditySensorStatus(parsed.humidity);   
    }
}
```

Gear Studio allows parsing data coming from The Things Stack as bytes, strings and JSON objects, but it also allows reading data that is already parsed and decoded on The Things Stack using [Payload Formatters](https://www.thethingsindustries.com/docs/integrations/payload-formatters/).

The example payload parser script above shows how to extract temperature and humidity values from the `decoded_payload` JSON object nested in The Things Stack uplink data message, i.e. from a message that already contains decoded sensor data, and how to send the extracted data to the endpoints defined in the device configuration script. [See Cloud Studio documentation for more info about payload parsing scripts](https://cloudstudioiot.com/docs/configuracion-del-cliente/dispositivos-y-endpoints/dispositivos/modelos-de-dispositivo/procesamiento-de-datos)

Finish by clicking **Save**.

### Add a New Device

To add a new device, navigate to **Devices → Devices** on the left hand menu and select the **Add** button.

Enter a **Description**, select the device **Model** (predefined or the one you created following the [Create a Custom Device Model](https://www.thethingsindustries.com/docs/integrations/cloud-integrations/cloudstudio/#create-a-custom-device-model) subsection), select **The Things Network (TTN) interface** as a **Communication interface** and provide the **DevEUI** of your end device. Finish with **Save**.

![Adding a new device](https://www.thethingsindustries.com/docs/integrations/cloud-integrations/cloudstudio/add-device.png)


### Create an Access Token

To complete the integration on The Things Stack, in the next step you will need an access token. You can create an access token by navigating to **Security → Access tokens** and clicking on the **Add** button.

Provide a **Description** for your token, enter your **E-mail** and set your **Password**. Finish with **Save**, copy the token and store it in a safe place.

![Creating an access token](https://www.thethingsindustries.com/docs/integrations/cloud-integrations/cloudstudio/access-token.png)


![Copy the access token](https://www.thethingsindustries.com/docs/integrations/cloud-integrations/cloudstudio/copy-token.png)


## Configure The Things Stack

After finishing Gear Studio setup, use the **Cloud Studio** [Webhook template](https://www.thethingsindustries.com/docs/integrations/webhooks/webhook-templates/) to create a Webhook integration on The Things Stack.

First, fill in the **Webhook ID**.

Then you need to provide a Gear Studio **Server instance** that is hosting your Gear Studio IoT platform. This depends on your Gear Studio subscription. The default value is `gear.cloud.studio` that is commonly used for free subscriptions. See [Cloud Studio documentation](https://cloudstudioiot.com/docs/configuracion-del-cliente/dispositivos-y-endpoints/dispositivos/integracion-de-dispositivos/lorawan-network-servers-lns/the-things-stack-ttn-tts) for detailed information on other server instances, depending on your subscription plan.

As the last step, paste the access token you copied from Gear Studio in the **Access token** field.

![Cloud Studio Webhook template](https://www.thethingsindustries.com/docs/integrations/cloud-integrations/cloudstudio/cloud-studio-template.png)


To see the values of all parameters of the Cloud Studio integration, click on the integration after you created it with the Webhook template.

## Monitor Your Data

To create a dashboard in Gear Studio, in **Settings** mode, navigate to **Dashboards → Dahboards** on the left hand menu. Click the **Add** button. 

Add a **Description** and **Comments**, and select **Add Group**. Under group settings, add a **Title** and select **Add widget**.

![Adjusting widget settings](https://www.thethingsindustries.com/docs/integrations/cloud-integrations/cloudstudio/widget-settings.png)


![Select widget](https://www.thethingsindustries.com/docs/integrations/cloud-integrations/cloudstudio/select-widget.png)


Choose the desired widget type, adjust **Minimum** and **Maximum** values according to your data values range, choose the **Variable** you wish to monitor, and select a **Device** you want to monitor it from.

![Adding a dashboard](https://www.thethingsindustries.com/docs/integrations/cloud-integrations/cloudstudio/add-dashboard.png)


Now, go back to the **Monitoring** mode in Gear Studio, navigate to **Dashboards** on the left hand menu and start monitoring your sensor data!

To read about available Cloud Studio features, cool ways to customize your devices, dashboards and much more, check the [official Gear Studio documentation site](https://cloudstudioiot.com/docs).