theThings.iO platform provides you a device monitoring and App management Global Panel. Manage all your IoT products and applications in one beautiful Panel. Also provides powerful analytical tools that are fully customizable to deliver the information that you need to make decisions.
The Panel dashboard will show you metrics of your apps and devices, and their activity. The metrics and data on the Panel dashboard are fully customizable on demand for Enterprise accounts. The next images are customized examples of our Panel dashboard.
As you can see at the previous images, there is a sidebar on the left, that sidebar contains the navigation links that provides you access to the main Panel areas:
- Dashboard: presents you an overview of the status of your devices and your main products metrics.
- Things Manager: gives you access to your IoT Products and device monitoring features.
- Apps Manager: is where you manage the official Apps for your IoT Products.
- Developers: gives you access to the documentation for developers and tools such as de Developer console.
The main screen of the things manager display a list of your IoT products. If you only have created one product, we skip the main screen and show to you the product details screen.
An IoT product is the blueprint that represents your physical devices. And it's where you define how your devices operates with thethings.iO Platform.
Things and Resources
The Things are the virtual representations of your Internet-connected devices.
We can see a Thing connected to the Internet as a collection of Resources. And each Resource can be seen as a timeline.
The thing is going to publish or consume this resources. For example, a thing with a temperature sensor is going to publish temperature and a thing that is an on-off switch is going to consume a resource called turn which can take values on or off.
Everything can be a resource
The value of a resource has not only to be a string or a number. It can be an array, a json object or even a binary.
Planning the Thing
Before creating your IoT product, you'll need to think about what data do you need to store, visualize and query. For example, if you are prototyping a thermostat, you can think on this types of values (resources):
- outdoor temperature
- target temperature
- outdoor humidity
We associate the data that your device generates to what we call 'Resources'. You can think a resource as a timeline of a data value type.
Create a new IoT Product
First you have to create an IoT Product at theThings.io. Go to the Things Manager section, and click on the 'Create new IoT product'.
Now, you can introduce the Product's name and the resources that your product will make public to Apps. You'll be able to edit this inputs later if you need.
Once you have created your product, you can access to the the product details. Initially is empty, because no devices has been associated to this product. At this screen, all the devices are listed. Here, you can:
- Modify your product settings. If you want to change the product's name or add/remove resources, you have to click at the 'Product settings' button.
- Get the tokens to activate devices. Click at the 'Get activation codes' button if you want to activate new devices.
- Access to the things details. Once you have activated some devices, the product's devices are shown at this screen. You can access to the device details clicking at the stats icon.
- Export your own data. With this feature you have the ability to get your product data out of thethings.iO for off-line analysis and processing. You can find more information here.
- Firmware upgrade on the air (OTA). It permits you to upload and manage the firmware associated to your product. You can find more information here.
Activate a thing
Click on the 'Get activation codes' button to open the Activation codes screen.
Activation Codes are needed to activate your things at thethings.iO. When you activate them, you will get a token ('thingToken'). This Token will enable you to make API calls to thethings.iO from your thing. Enterprise accounts dispose of unlimited activation codes.
At this screen you can find the 'Generate Activation codes' button. This button lets you create new activations codes. As many as you want.
Same as the freemium accounts, you can activate codes from this panel clicking at the plus icon. But the final use of the activations codes is to store them at the devices firmware, so the thing could activate itself throught the API once configured by the device customer.
You can activate a device clicking at the plus icon. If everything went well, now you have your thing activated.
You can access to the device details clicking at the stats icon of a device at the Product details screen.
For every resource that you have stored data, you'll get a chart when possible (depends of the data type that you stored). You can see past stored data at the historical tab, and incoming data at the real-time tab.
The main screen of the Apps manager display a list of your official Apps for your IoT products. Official Apps don't have to ask to the device customer for authorization to access to their device data. Once the user is registered, the app gains automatically access to the user's devices stored data on thethings.iO Platform.
An IoT Application is the virtual representation at thethings.iO of an App. And it's where you define how your App operates with thethings.iO Platform and your IoT products.
Create a new IoT App
To enable an App to work with thethings.iO, first you have to create an IoT App at thethings.iO Platform. Once your IoT App is created, you get an app Id that identifies your app at our system.
Now, you can introduce the App name and the resources that your App will use. You'll be able to edit the resources later if you need, but the App name couldn't be changed, so make sure the App's name is correct.
You can access to the App details clicking at the stats icon of an App at the App details screen. At this screen you can get the App users details and manage them.
To edit your App resources, click at the 'App settings' button.
From here you can access de developers documentation. Also there is a tool, the Developers console, that lets you to visualize the messages that you send to thethings.iO APIs.