Configuration

⚙️ General

No matter what type of device, each device created can be configured under its general configuration tab.

When navigating through the configuration of a device, the first item displayed is the summary of its general settings.

Basic Details

Inside of this section you will find the basic details of your device, like its name and the device location description. You can always go back and modify those. Please remember click "Save" at the end of the page.

Visual Appearance

You will also find some visual appearance configuration. You can assign an Icon, which will be shown inside of the Map widget, if there is no Marker selected ("None").

You can also upload an image, which will be shown next to the name of the device, at the top of the screen.

Organization & Tags

Here you can assign your own tags to your devices. These help you sort your devices better, as well as to configure map widgets and reports.

To setup a tag, just type in the name of the tag on the "Add Tag" field. Click Enter and don't forget to Save the changes at the end!

Metadata

You can use metadata to add your own information to your devices, which does not necessarily have to be stored in a field of the database.

You can also use metadata in some widgets on the dashboard, e.g. to create an overview of measured values in a table and colorise this table based on metadata.

You first assign a Key name. Click "+Add" to add the metadata field. Now you can enter a value. Again, don't forget saving the changes at the end!

Device Management

In there you will find an Offline Notifications checkbox. When you click on that, you (and only you) will receive email notifications if the device goes offline. The online timeout defines when devices go offline (if they haven't sent an X amount of time). Email gets sent to the email address you are logged in with.

You will also find Device Claiming, which allows you to enable the Pincode Claiming functionality. You can also allow multiple claims, if that is what you want. Add a claim code and click on save. Now you can add your device to other workspaces using the Serial Number and the Claim Code.

🛠️ Product & Hardware

Product Configuration

You can now establish Product-wide configurations. Remember that Products may contain several devices, so be mindful.

Icon

You can select an Icon for all devices of a specific product (that will save you time, in case you want to have the same icon for all devices).

Product Slug

This gets created the first time your product gets created. It cannot be changed!

Online Timeout

If no further measured values or other messages are transmitted from a device within the time specified here, the device is displayed as offline in the listing and in other places.

LoRaWAN/API Configuration

The next section depends on the type of device you have added to the platform.

Please visit our documentation about how to create a connection to your Network Server for LoRaWAN devices here.

If you want to know more about the Serial Number for API devices, you will find it here.

Payload Decoder

LoRaWAN devices

API devices

You will find a detailed guide on how to decode your device's payloads in the next article:

You will be able to see the incoming messages on the right side button "Show logs".

MQTT Configuration

On API devices after Payload decoders you will see the MQTT configuration section. To learn more about it visit:

🗓️ Fields

The fields are the measured values of your devices, which get stored in our time-series database. Depending on your subscription plan, a certain number of fields can be created per device. This are also the so-called "datapoints". To learn more about fields visit:

To learn more about datapoints and data retention times in our time-series database visit:

Suggested Fields

If your devices are receiving data, which gets processed by the payload decoder, but there are still no fields defined in the database, they will appear under Suggested Fields. You can add them to the platform by pressing "Create field", or you can remove them.

Configuration Fields

Configuration Fields allow you to create static variables that exist as a product-wide default and can be overwritten per device. To read more about how to use them visit the next link:

⛓Integrations

You will find all about our internal MQTT broker under Integrations.

⚠️ Danger Zone

Lastly, you will find the Danger Zone. Be careful with those configurations, since they are critical.

You can change the plan or subscription in which your devices are, as as see how many datapoints they have consumed in the past 24 hours.

You can purge selected field's data in a specific time range.

To completely delete your device from the platform, select Delete Device. But be mindful, as this is irreversible!