Skip to content

Latest commit

 

History

History
130 lines (91 loc) · 6.88 KB

quick-start.md

File metadata and controls

130 lines (91 loc) · 6.88 KB
description
Connecting IoT devices in minutes

QUICK START

Quick Start Guide

To start working with Thinger.io just create a free account in our cloud platform and follow the next steps to configure and connect your first IoT device.

1. Create Device

Using Devices menu tab, just click in Add Devicebutton. We recommend starting with a compatible Arduino Framework device (ESP2666, ESP32, MKR1010, etc), so, chose Generic Device in Device Typeand fill the form with the Device Id, Name, Description and Credentials you prefer.

2. Connect Device

After provisioning the device at Thinger.io cloud, it is the moment to configure it in the Hardware device. there are many different hardware supports and communication technologies but Thinger.io allows using all of them:

{% tabs %} {% tab title="Arduino Compatible Devices" %} The most suitable devices to start working with Thinger.io are the ESP8266 or ESP32. Our Thinger.io library for the Arduino framework allows programing the first device in two minutes just following the next steps:

  1. Install Thinger.io libraries into your Arduino IDE
  2. Going to "File>Examples>Thinger.io", open the example code that fits better with your board, i.e., ESP8266
  3. Edit the example code to include your USERNAME, DEVICE_ID and DEVICE_CREDENTIALSstablished in previous step.

The basic example contains two simple resources to send and retrieve to your device, i.e., controlling a digital pin, or reading a value from the device. It can be modified with many different functionalities that we have explained at the Coding Guide section. After modifying the source code, just flash your device again and wait for the device connection.

{% hint style="success" %} Find additional information about Thinger.io devices in the next sections:

  1. Compatible Arduino and Linux devices
  2. Zero to Hero Thinger.io Firmware Coding Guide
  3. Connection Troubleshooting Guide {% endhint %} {% endtab %}

{% tab title="HTTP Devices" %} 1) Create an HTTP device profile by selecting it in the "Device Type" when creating the device
2) Going to the device dashboard, create an HTTP device Callback
3) Create a device Access Token to authorize the device sending data to the platform
4) Introduce the HTTP request (API+TOKEN) into your device code or third party platform and start sending data to Thinger.io

{% content-ref url="http-devices.md" %} http-devices.md {% endcontent-ref %} {% endtab %}

{% tab title="LPWAN Devices" %} Any individual Sigfox or LoraWAN device can be integrated using our API as HTTP devices, just setting an HTTP device callback into their callback managers, but if a big network is going to be created using these technologies, it is better to use our integration plugins:

{% content-ref url="lpwan/sigfox.md" %} sigfox.md {% endcontent-ref %}

{% content-ref url="broken-reference" %} Broken link {% endcontent-ref %} {% endtab %}

{% tab title="MQTT Devices" %} 1) Create a new device profile and select "MQTT" device type
2) Configure device credentials a secret password
3) Configure the MQTT client to send data to the embedded broker

{% content-ref url="mqtt.md" %} mqtt.md {% endcontent-ref %} {% endtab %} {% endtabs %}

3. Devices & Data management

Each device can be managed through the "Device Dashboard". This interface shows connection data and also allows checking the "device API" with raw device data representation.

Thinger.io provides bidirectional communication, so it is possible to retrieve data into the server using "devices output resources" and also sending messages from server to the "devices input resources". Both kind of resources are represented in the device APIsection. For example, the default Thinger.io example provides a resource input for digital pin control, and a resource output for reading current device millis(). Those user-defined resources are automatically represented in the API section, and the user can use it for interacting with them in real-time.

4. Store, Show & Share Data

Thinger.io provides three essential tools to work with devices data that are the basis for creating any IoT project, next tabs shows each tool introduction:

{% tabs %} {% tab title="Data Buckets" %} To store device data in a scalable way, programming different sampling intervals or recording events raised by devices.

{% content-ref url="features/buckets.md" %} buckets.md {% endcontent-ref %} {% endtab %}

{% tab title="Dashboards" %} Panels with customizable widgets that can be created within minutes using drag'n drop technology, to show real-time and stored data.

{% content-ref url="features/dashboards.md" %} dashboards.md {% endcontent-ref %} {% endtab %}

{% tab title="Endpoints" %} Extend the devices interoperatibility by using endpoints to interact with other services like IFTTT, custom Web Services, emails, or call other devices.

{% content-ref url="features/endpoints-1.md" %} endpoints-1.md {% endcontent-ref %} {% endtab %}

{% tab title="Access Tokens" %} Dashboards, Data buckets or Device resources can be easily shared with third parties using Access Tokens and our API.

{% content-ref url="features/access-tokens.md" %} access-tokens.md {% endcontent-ref %} {% endtab %} {% endtabs %}

5. Extend Thinger.io

Thinger.io platform can be complemented with many different Internet services using Plugins that can be found and deployed within seconds Just going to our marketplace and selecting it.

{% content-ref url="broken-reference" %} Broken link {% endcontent-ref %}