Devices
Device is the link between your external things and the data in your account. To allow anything to send or receive data from TagoIO, you need to create a device. The communication between external devices and TagoIO is done via HTTP or MQTT methods using JSON format. To facilitate this communication, a device must be created within the platform. This process involves specifying the type of device and configuring it to send and receive data correctly.
Devices are managed through your Admin’s interface, where users can access detailed information about each device, including its ID and other settings.
Our TagoIO API documentation offers comprehensive instructions on how to interface with devices, ensuring developers can effectively integrate their hardware with the platform.
Adding devices
Devices are connected to TagoIO using Connectors, which act as a bridge between TagoIO and networks to transmit and receive data. To follow a tutorial on how to add a device, go to the Getting Started article.
Learn more about Connectors here.
Device type and data storage
Once you create a device, it will store all the data sent by your sensors. During the creation process, you will be prompted to select the type of data storage to be used. There are two types of data storage you can choose from, each associated with a different type of database.
Device Optimized Data [Immutable database]
By selecting the immutable device, you can store up to 36 million data points per device. This device is highly optimized for short and long retention periods; the query responses are faster, which means less latency for the devices and a cost reduction when running an Analysis. Also, as the data is immutable, no one can change or delete individual sets of data – this being ideal for compliances.
Managed Data Optimized [Mutable database]
By using the mutable device, you can easily edit or delete data. Some notes about this device type:
- It doesn’t have data retention.
- The amount of data is limited to 50k data registers
- It is optimized to be used for the storage and manipulation of configurable variables coming from sensors, web services, and forms.
Check out the list of sensors integrated into TagoIO; there are hundreds of them.
Managing and customizing your device
By clicking on any device under your list of devices, you can find several sections with detailed information about it and other resourceful features. To see the list of devices, go to your Admin, and select the Device module.
In the topics below, you will find the options available for managing and customizing your device.
General Information
When you open the page of any of your devices, you will first see the 'General Information' tab that contains your device’s name, the network it’s using to send data, and the connector used to decode the data.
On this page, you can manage your Device Token and Serial number by generating or deleting them. Additionally, you can also view the usage history statistics for the specific device, which is great to give you more visibility and control over your Data Input and Output. This feature is unlocked once you activate the Control Tower add-on.
Data
Manage the data received from sensors by viewing, filtering, exporting, and much more. Learn more Device data management.
Deactivating devices
You can easily define how TagoIO will respond to any request from the device. In the right upper corner of your device page, you will find a switch to activate or deactivate it. If deactivated, the system will deny access to any command coming from the device.
Hiding devices from Widgets
You can hide a specific device from showing in the device selection option for your Widgets. It may be helpful when creating a Dashboard and using the Input Form Widget that has a field type called 'Device'. Access your device’s page and navigate to the tab 'More' to make your device visible or hidden.
Inspecting your connection
To debug if your device is sending data, you can use the Live Inspector tool by accessing its respective tab on your device’s page. It’s useful for debugging parser scripts and monitoring traffic to and from your device.
Customize your payload parser
Sometimes you may need to customize the payload parser of your device to adjust to your use case. In such scenarios, you can run your own parser by activating the script console in the 'Payload Parser' tab inside your device’s page.
You can also create your own connector if you need to use the same payload parser for several devices. Read more about creating a Connector.
Emulating data sending
Inside your device’s page, you will find a tab named 'Emulator', here you can send data to your device as if it was sent by a real sensor.
Customizing the behavior of your device
You can customize the behavior of your device in different scenarios by setting device parameters in the tab 'Configuration Parameters'. For example, you can use them to specify how to decode data or send downlink messages, filter your devices on Widgets, or interact with API & Analysis scripts.
Setting Rate Limits for your devices
When sending data to TagoIO, you will have a limit on the number of requests that can be made during a certain time period, we call it Rate Limits (Hard Limits).
You can set custom request rate limits for your device, which is great to protect it from malfunctioning and using too much Data Input or Output, or to avoid a single device from sending too many requests and reaching the hard limit for requests of your account, which would block other devices from sending or receiving data for a whole minute. This feature is unlocked once you activate the Control Tower add-on.
Deleting devices
To delete a device, simply go to 'More' on the device page and click on 'Delete Device'. Once deleted, all data will also be excluded. There is no way to recover it once deleted. Be certain before proceeding.
Related Articles
Blueprint Devices
Blueprint Devices are dynamic Devices available on Blueprint Dashboards. They can be changed by the user in realtime, and by doing so, the Dashboard will reload the data for the Widgets that use them. You can change the Blueprint Devices by selecting ...RadioBridge Devices
TagoIO is fully integrated with RadioBridge devices, that are connected over Sigfox or LoRaWAN, by providing the perfect integration with the Radio Bridge backend. Read more about Radio Bridge. All data sent by your device will be readily available ...Managing Devices
Using the account-token, you can manage your devices through API requests. It’s possible to create, edit, delete, and get info of it. Create Create a device through POST method. POST - https://api.tago.io/device Request { "name": "My first device", ...Configuration Parameters for Devices
Configuration Parameters are key-value pairs that enable you to customize the behavior of your Devices in different scenarios. For example, you can use them to specify how to decode data or send downlink messages, filter your devices on Widgets, or ...Adding devices with connectors
Connectors enables you to create a device with built-in behaviors that allow it to communicate with a Network very easily. When creating devices at TagoIO, it is important to know that there are different ways to allow them to send & receive data ...