ASSET TYPES & GROUPS

This section allows you to define sets of IoT devices, in order to group those that have common characteristics or purposes, so we will distinguish types of devices for those that are units with the same purpose and Groups to associate devices for OTHER REASONS. Note that a device can be of one type and belong to a group at the same time.

These groupings improve the organization of projects, but also support the following functionalities:

• Hereditary Properties. It is possible to define group properties and properties of a type, which will be inherited by the devices that have associated.

• Geofencing: Within the types and groups it is possible to define areas to monitor the location of devices and generate alerts without one of them entering or leaving the established area.

• Data processing (Geofencing, alerts, data transformation).

The assets section has the overview tool that allows us to visualize on the map all the devices created in the selected project, allows us to quickly check the location and connection status of each device. The green circle will be drowned if the device is connected and the red one if the device is disconnected.

This tool allows several display options to show only the connected or disconnected devices or, selecting the "clustering" option, the possible grouping by nearby locations. In the following sections, the use of asset types and groups will be explained in more detail.

Asset types

They are devices deployed with the same objective, which perform the same function so they match the same configuration parameters. For example, we can create a device type "Temperature sensors", "freezers", "Smart Cars".

Creating Asset Types

To create a new device type go to the Assets > Types tab, displaying the list of previously created asset types if any. Then clicking on the green "Add Asset Type" button, will open the "new Asset Type" form, in which the identifiers must be filled in:

Once the form filled properly, clicking again on the "Add Asset Type" button will create the new Type and displays its configuration panel, in which the de overview devices map will be shown as well as Properties and Geofencing configuration tabs that can be used to define the properties and geofences for all the devices included into this Asset Type.

Note that no devices will be shown until anyone begins attached to this specific device Type.

Attaching devices to an Asset Type

To start adding devices to the new Asset Type you must access the devices section of the main menu and display the Devices List. Note that each device can be selected by means of a checkbox on the left side of the list.

Selecting one or several devices will display new buttons in the upper area of the list. Pressing the green "Set Type" button a new context will be displayed where the asset type can be selected by means of a drop-down list.

All the devices that were checked up will be associated with the selected Type, from then on they will inherit their properties and the alert and geofences configuration, so let's explain how to configure those features.

Deleting an Asset Type

Any resource can be deleted from the asset type by reassigning them to an empty type in the list or by accessing the settings section of the resource and checking off the box, after this, the properties and geofences inherited from your asset type will be deleted.

It is also possible to completely delete an asset type by selecting its profile in the Types list and clicking on the "Delete Type" button but note that none of the assigned resources will be deleted, they will only cease to be associated with this category.

Groups

They are different devices with a common semantic characteristic for example the devices installed in the kitchen of a smart home can be grouped under the name "kitchen devices".

Creating a new Asset Group

To create a new assets group go to the Assets > Group tab of the main menu, this will display the list of previously created Groups if any. Then, clicking on the green "Add Asset Type" button will open the "new Group" form, in which the data must be introduced:

Once the form is completed, clicking again on the "Add Group" button will create a new Group profile and display its configuration panel in which the de devices overview map will be shown as well as Properties and Geofencing configuration tabs, that can be used to define the behavior of this features for all the devices included into this Assets Group.

Note that no devices will be shown until anyone begins attached to this specific device Group profile.

Grouping devices

Start adding devices to the new Assets Group just require to get access to the devices section of the main menu and display the Devices List. Note that each device can be selected by means of a checkbox on the left side of the list. When doing this, new buttons appear on the top side of the menu, allowing to manage the device association into a specific Group, Asset or Project.

Selecting one or several devices will display new buttons in the upper area of the list. Pressing the desired button allows to aggregate those devices to any of the previously created aggrupations. A new context will be displayed in order to select the Group from a drop-down list.

Since the moment of the association, all the devices will inherit the properties and geofences configuration.

Deleting Devices Group

Any resource can be deleted from the Asset Group by reassigning them to an empty type in the list or by accessing the settings section of the resource and checking off the box, after this, the properties and geofences inherited from the Asset Group will be deleted.

It is also possible to completely delete an asset type by selecting its profile in the Groups list and clicking on the "Delete Group" button but note that none of the assigned resources will be deleted, they will only cease to be associated with this category.

Asset Type Properties

Properties created in an Asset Type will be inherited by every associated device. This establishes a scalable way to configure large networks of devices in a short time and easily. The properties allow you to enter configuration parameters or any other context information you want to make available to the devices or other resources of the platform.

To create a new property on an Asset Type, go to Asset > Types section of the main menú, then acess the Type profile to be modified and select the properties tab on the right-side menu of the configuration panel. Then, creating a property only requires to press on +Add button and implement a Json file format to structure the data that wants to be included on the property.

Note that, on the device properties section, each property source will be identified on the "source" column.

Geofencing

Geofencing is a technique that allows defining a virtual perimeter over geographical areas, it can be defined as a radius around a point or tracing polygons. This is a very useful functionality to monitor automatically and in real-time a fleet of devices, allowing to create customized alerts based on geolocation.

Thinger.io server will compare the location of the device, create alerts according to the custom configuration that can be managed below. To start creating Geofence areas, the edition switch on the right-top-side of the map must be clicked ON. Then a new menu allows selecting the geofence shape that can be drown circular, square or free.

Each defined geofence will create in the lower panel a profile that will allow to configure its behavior. The next image shows the configuration options for the geofences created above for each situation in which any device can be located:

• name: Identification of the geofence area

• On Enter: Allows selecting an endpoint that will be called automatically when the devices just entered the area, I.e. when the last position was out of the border and the new position is into the border.

• On Exit: Allows selecting an endpoint that will be automatically called when the devices are just leaving the area, i.e when the last position was into the geofence area and the new position is out.

• While Inside: This endpoint will be always called when the device is within the area. So it is preferable not to use this option if the device sampling interval is short

• While Outside: This endpoint will be always called when the device is out of the area. So it is preferable not to use this option if the device sampling interval is short

• Color: To select the color of the representation on the geofences map.

• Enabled: Each geofence can be disabled/enabled using the right-side switch.