QUICK START

Connecting IoT devices in minutes

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:

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.

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

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

HTTP DEVICES

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:

SIGFOX

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

MQTT CLIENTS

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:

Data Buckets

To store device data in a scalable way, programming different sampling intervals or recording events raised by devices.

DATA BUCKETS

Dashboards

Panels with customizable widgets that can be created within minutes using drag'n drop technology, to show real-time and stored data.

DASHBOARDS

Endpoints

Extend the devices interoperatibility by using endpoints to interact with other services like IFTTT, custom Web Services, emails, or call other devices.

ENDPOINTS

Access Tokens

Dashboards, Data buckets or Device resources can be easily shared with third parties using Access Tokens and our API.

ACCESS TOKENS

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.