---
# System prepended metadata

title: Pilot Instructions
tags: [ugs]

---

---
title: Pilot Instructions
tags: ugs
robots: noindex, nofollow
---


# Pilot Instructions

[toc]

## Hardware
* BLE ultrasonic level sensor(s)
* Cloudway with LTE-M/NB-IoT and Bluetooth 5

## IoT Platform
As part of this solution, we have created the ==**"Gas Cylinder Level"**== dashboard that displays data from multiple sensors. You may use the dashboard to:

* add new sensors (tenant privilege);
* change the location of the sensors;
* configure the alarm thresholds;
* browse historical data.

The dashboard has two states. 

The ==main state== displays the list of the sensors, their location on the map as well as the list of their alarms. 

You may drill down to the sensor details state by clicking on the table row. The ==sensor details state== allows to browse **level** and **battery** history, change sensor settings and location.

We can customize the [Gas Cylinder Level](https://demo.thingsboard.io/dashboard/f588f270-017f-11ec-8e0e-d5779c4f3ddd?publicId=e763b0e0-4000-11eb-8cad-3d8873d86e51) dashboard by our dashboard development team.

![](https://i.imgur.com/BS2yROD.png)

![](https://i.imgur.com/Vngk5VP.png)

![](https://i.imgur.com/RKDSGNO.png)

### Devices

We have already created two sensors and loaded some demo data for them. See device info and credentials below:

| Device name        | Access token             | Customer name |
| ------------------ | ------------------------ | ------------- |
| 00:02:04:6d:b3:41  | **************           |               | 
| 00:02:04:6d:b3:42  | **************           | Customer A    |

Solution expects that the sensor device will upload "level" and "battery" values. The most simple example of the expected payload is in JSON format:

```json
{
   "00:02:04:6d:b3:41":[
      {
         "ts":1630142000000,
         "values":{
            "level":680,
            "battery":99
         }
      }
   ]
}
```

A workflow below is for the level sensor data upload on behalf of our cloudway hardware to our IoT platform.
:::success
++**Edge**++
Gas Cylinder(s) + ==BLE ultrasonic level sensor(s)== > Bluetooth 5 > ==Cloudway==

++**Backhaul**++
==Cloudway== > LTE-M/NB-IoT > ==IoT Platform==
:::

We uses **MQTT transport type** as one of our connectivity options.


### Alarms

Alarms are generated using two [Alarm rules](https://thingsboard.io/docs/user-guide/device-profiles/#alarm-rules) in the "Level Sensor" [device profile](https://thingsboard.cloud/deviceProfiles). User may turn alarms on and off as well as configure the alarm thresholds via the ["Gas Cyclinder Level"](https://demo.thingsboard.io/dashboard/f588f270-017f-11ec-8e0e-d5779c4f3ddd?publicId=e763b0e0-4000-11eb-8cad-3d8873d86e51) dashboard using "Edit Sensor" form.

### Customers

"UGS 000001" is assigned to a newly created customer "Customer A". You may notice that "Customer A" has two users, and the "Gas Cylinder Level" dashboard is accessible for those users. You may create more Customers and more Users via administration UI.

| Name     | Login                            | Password | Customer Name  | 
| -------- | -------------------------------- | -------- | -------------- |
| CC 001   | customer001@customer.com         | Customer | Customer A     |
| CC 002   | customer002@customer.com         | Customer | Customer A     |


### Solution entities

As part of this solution, the following entities were created:

| Name                           | Type           | Owner      |
| ------------------------------ | -------------- | ---------- |
| Read Only                      | Role           | Tenant     |
| Gas Cylinder Level Sensors     | Rule Chain     | Tenant     |
| Level Sensor                   | Device profile | Tenant     |
| Customer A                     | Customer       | Tenant     |
| 00:02:04:6d:b3:41              | Device         | Tenant     |
| 00:02:04:6d:b3:42              | Device         | Customer A |
| UGS                            | Dashboard      | Tenant     |
| customer001@customer.com       | User           | Customer A |
| customer002@customer.com       | User           | Customer A |
